@farming-labs/theme 0.1.141 → 0.1.143

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

@@ -28,7 +28,7 @@ interface DocsPageClientProps {
   openDocsTarget?: "markdown" | "page" | "source" | "github";
   openDocsPrompt?: string;
   /** Where to render page actions relative to the title */
-  pageActionsPosition?: "above-title" | "below-title";
+  pageActionsPosition?: "above-title" | "below-title" | "toc";
   /** Horizontal alignment of page action buttons */
   pageActionsAlignment?: "left" | "right";
   /** GitHub repository URL (e.g. "https://github.com/user/repo") */

package/dist/docs-page-client.mjs

@@ -6,7 +6,7 @@ import { useWindowSearchParams } from "./client-location.mjs";
 import { DocsFeedback } from "./docs-feedback.mjs";
 import { resolveClientLocale, withLangInUrl } from "./i18n.mjs";
 import { escapeJsonLdForScript } from "./json-ld.mjs";
-import { Children, Fragment, cloneElement, isValidElement, useEffect, useState } from "react";
+import { Children, Fragment, useEffect, useState } from "react";
 import { DocsBody, DocsPage, EditOnGitHub } from "fumadocs-ui/layouts/docs/page";
 import { createPortal } from "react-dom";
 import { usePathname, useRouter } from "fumadocs-core/framework";
@@ -53,7 +53,7 @@ function PathBreadcrumb({ pathname, publicPath, locale }) {
 				},
 				children: parentLabel
 			})
-		}), /* @__PURE__ */ jsxs("span", {
+		}, "parent"), /* @__PURE__ */ jsxs("span", {
 			className: "fd-breadcrumb-item",
 			children: [/* @__PURE__ */ jsx("span", {
 				className: "fd-breadcrumb-sep",
@@ -62,7 +62,7 @@ function PathBreadcrumb({ pathname, publicPath, locale }) {
 				className: "fd-breadcrumb-current",
 				children: currentLabel
 			})]
-		})]
+		}, "current")]
 	});
 }
 /**
@@ -214,59 +214,52 @@ function scrollToHashTarget(hash) {
 	target.scrollIntoView({ block: "start" });
 	return true;
 }
-function injectTitleDecorations(node, { description, belowTitle }) {
-	if (!description && !belowTitle) return {
-		node,
-		inserted: false
-	};
-	let inserted = false;
-	const extras = Children.toArray([description, belowTitle].filter(Boolean));
-	if (extras.length === 0) return {
-		node,
-		inserted: false
-	};
-	const insertedExtras = extras.map((extra, index) => /* @__PURE__ */ jsx(Fragment, { children: extra }, `fd-title-decoration-${index}`));
-	function visit(current) {
-		if (current == null || typeof current === "boolean") return current;
-		if (inserted) return current;
-		if (Array.isArray(current)) return current.flatMap((child) => {
-			const next = visit(child);
-			return Array.isArray(next) ? next : [next];
-		});
-		if (!isValidElement(current)) return current;
-		if (typeof current.type === "string" && current.type === "h1") {
-			inserted = true;
-			return /* @__PURE__ */ jsxs(Fragment, { children: [current, insertedExtras] }, "fd-title-decoration-block");
-		}
-		const childProps = current.props ?? null;
-		if (childProps?.children === void 0) return current;
-		const nextChildren = Children.toArray(childProps.children).flatMap((child) => {
-			const next = visit(child);
-			return Array.isArray(next) ? next : [next];
-		});
-		if (!inserted) return current;
-		return cloneElement(current, void 0, nextChildren);
-	}
-	if (Array.isArray(node)) return {
-		node: node.flatMap((child) => {
-			const next = visit(child);
-			return Array.isArray(next) ? next : [next];
-		}),
-		inserted
-	};
-	return {
-		node: visit(node),
-		inserted
-	};
-}
 function TitleDecorations({ description, belowTitle }) {
 	if (!description && !belowTitle) return null;
-	return /* @__PURE__ */ jsx(Fragment$1, { children: Children.toArray([description, belowTitle].filter(Boolean)) });
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [description && /* @__PURE__ */ jsx(Fragment, { children: description }, "description"), belowTitle && /* @__PURE__ */ jsx(Fragment, { children: belowTitle }, "below-title")] });
+}
+function ThreadlinePageControls() {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "fd-threadline-doc-controls not-prose",
+		"aria-label": "Page controls",
+		children: [/* @__PURE__ */ jsx("button", {
+			type: "button",
+			"aria-label": "Go back",
+			onClick: () => window.history.back(),
+			children: /* @__PURE__ */ jsx("span", {
+				"aria-hidden": "true",
+				children: "<"
+			})
+		}, "back"), /* @__PURE__ */ jsx("button", {
+			type: "button",
+			"aria-label": "Go forward",
+			onClick: () => window.history.forward(),
+			children: /* @__PURE__ */ jsx("span", {
+				"aria-hidden": "true",
+				children: ">"
+			})
+		}, "forward")]
+	});
+}
+function findThreadlineTocActionsContainer() {
+	const toc = document.getElementById("nd-toc") ?? document.querySelector(".fd-toc, [data-toc]");
+	if (!toc) return null;
+	const stickyChild = toc.querySelector(":scope > .sticky, :scope > [class*='sticky']");
+	if (stickyChild) return stickyChild;
+	if ((typeof toc.className === "string" ? toc.className : "").includes("grid-area:toc")) return toc;
+	let node = toc.parentElement;
+	while (node && node.id !== "nd-docs-layout") {
+		if ((typeof node.className === "string" ? node.className : "").includes("grid-area:toc") || window.getComputedStyle(node).position === "sticky") return node;
+		node = node.parentElement;
+	}
+	return toc.parentElement ?? toc;
 }
 function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", publicPath, locale, copyMarkdown = false, openDocs = false, openDocsProviders, openDocsTarget, openDocsPrompt, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackOnFeedback, analytics = false, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const [titlePortalHost, setTitlePortalHost] = useState(null);
+	const [titleControlsPortalHost, setTitleControlsPortalHost] = useState(null);
+	const [tocActionsPortalHost, setTocActionsPortalHost] = useState(null);
 	const [browserPath, setBrowserPath] = useState(null);
 	const pathname = usePathname();
 	const activeLocale = resolveClientLocale(useWindowSearchParams(), locale);
@@ -374,10 +367,69 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 			clearTimeout(timeout);
 		};
 	}, [pathname, children]);
-	const showActions = !isChangelogRoute && (copyMarkdown || openDocs);
+	const showActions = !isChangelogRoute && (copyMarkdown || openDocs || pageActionsPosition === "toc");
 	const showActionsBelowTitle = showActions && pageActionsPosition === "below-title";
 	const showActionsAboveTitle = showActions && pageActionsPosition === "above-title";
+	const showActionsInToc = showActions && pageActionsPosition === "toc";
 	const githubFileUrl = editOnGithubUrl ?? (githubUrl ? buildGithubFileUrl(githubUrl, githubBranch, pathname, entry, activeLocale, githubDirectory, contentDir) : void 0);
+	useEffect(() => {
+		if (!showActionsInToc) {
+			setTocActionsPortalHost(null);
+			return;
+		}
+		let frame = 0;
+		let attempts = 0;
+		let host = null;
+		let cancelled = false;
+		const mountActions = () => {
+			if (cancelled) return;
+			const container = findThreadlineTocActionsContainer();
+			if (!container) {
+				if (attempts < 12) {
+					attempts += 1;
+					frame = requestAnimationFrame(mountActions);
+				} else setTocActionsPortalHost(null);
+				return;
+			}
+			host = container.querySelector(":scope > .fd-actions-toc-host");
+			if (!host) {
+				host = document.createElement("div");
+				host.className = "fd-actions-toc-host";
+				container.append(host);
+			}
+			setTocActionsPortalHost(host);
+		};
+		frame = requestAnimationFrame(mountActions);
+		return () => {
+			cancelled = true;
+			cancelAnimationFrame(frame);
+			if (host?.isConnected) host.remove();
+			setTocActionsPortalHost(null);
+		};
+	}, [
+		pathname,
+		showActionsInToc,
+		toc.length
+	]);
+	useEffect(() => {
+		if (!showActionsInToc) {
+			setTitleControlsPortalHost(null);
+			return;
+		}
+		const title = document.getElementById("nd-page")?.querySelector("h1");
+		if (!title) {
+			setTitleControlsPortalHost(null);
+			return;
+		}
+		const host = document.createElement("div");
+		host.className = "fd-threadline-title-controls-host";
+		title.insertAdjacentElement("afterend", host);
+		setTitleControlsPortalHost(host);
+		return () => {
+			host.remove();
+			setTitleControlsPortalHost(null);
+		};
+	}, [pathname, showActionsInToc]);
 	const lastModified = !isChangelogRoute && lastUpdatedEnabled ? lastModifiedProp ?? lastModifiedMap?.[normalizedPath] : void 0;
 	const showLastUpdatedBelowTitle = !!lastModified && lastUpdatedPosition === "below-title";
 	const showLastUpdatedInFooter = !!lastModified && lastUpdatedPosition === "footer";
@@ -392,7 +444,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 			className: "fd-page-meta-item",
 			children: formatReadingTimeLabel(resolvedReadingTime)
 		})]
-	}) : void 0;
+	}, "reading-time") : void 0;
 	const titleDescription = pageDescription ? /* @__PURE__ */ jsx("p", {
 		className: "fd-page-description",
 		children: pageDescription
@@ -405,8 +457,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 			showLastUpdatedBelowTitle && /* @__PURE__ */ jsxs("p", {
 				className: "fd-last-updated-inline",
 				children: ["Last updated ", lastModified]
-			}),
-			/* @__PURE__ */ jsx("hr", { className: "fd-title-separator" }),
+			}, "last-updated"),
+			/* @__PURE__ */ jsx("hr", { className: "fd-title-separator" }, "separator"),
 			showActionsBelowTitle && /* @__PURE__ */ jsx("div", {
 				className: "fd-actions-portal",
 				"data-actions-alignment": pageActionsAlignment,
@@ -417,18 +469,16 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 					openDocsTarget,
 					openDocsPrompt,
 					alignment: pageActionsAlignment,
+					variant: "default",
 					githubFileUrl,
 					analytics
 				})
-			}),
+			}, "actions"),
 			showReadingTimeBelowTitle && readingTimeBlock
 		]
-	}) : void 0;
-	const { node: decoratedChildren, inserted: titleDecorationsInserted } = injectTitleDecorations(children, {
-		description: titleDescription,
-		belowTitle: belowTitleBlock
-	});
-	const needsTitleDecorationsPortal = !titleDecorationsInserted && (!!titleDescription || !!belowTitleBlock);
+	}, "below-title") : void 0;
+	const decoratedChildren = children;
+	const needsTitleDecorationsPortal = !!titleDescription || !!belowTitleBlock;
 	useEffect(() => {
 		if (!needsTitleDecorationsPortal) {
 			setTitlePortalHost(null);
@@ -451,13 +501,28 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 	const titleDecorationsPortal = needsTitleDecorationsPortal && titlePortalHost ? createPortal(/* @__PURE__ */ jsx(TitleDecorations, {
 		description: titleDescription,
 		belowTitle: belowTitleBlock
-	}), titlePortalHost) : null;
-	const renderedChildren = Children.toArray(decoratedChildren);
+	}), titlePortalHost, "title-decorations") : null;
+	const titleControlsPortal = showActionsInToc && titleControlsPortalHost ? createPortal(/* @__PURE__ */ jsx(ThreadlinePageControls, {}), titleControlsPortalHost, "title-controls") : null;
+	const tocActionsPortal = showActionsInToc && tocActionsPortalHost ? createPortal(/* @__PURE__ */ jsx("div", {
+		className: "fd-actions-toc-portal not-prose",
+		children: /* @__PURE__ */ jsx(PageActions, {
+			copyMarkdown,
+			openDocs,
+			providers: openDocsProviders,
+			openDocsTarget,
+			openDocsPrompt,
+			alignment: "left",
+			variant: "rail",
+			githubFileUrl,
+			analytics
+		})
+	}), tocActionsPortalHost, "toc-actions") : null;
+	const renderedChildren = Children.toArray(decoratedChildren).map((child, index) => /* @__PURE__ */ jsx(Fragment, { children: child }, `fd-rendered-child-${index}`));
 	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
 		structuredDataJson && /* @__PURE__ */ jsx("script", {
 			type: "application/ld+json",
 			dangerouslySetInnerHTML: { __html: escapeJsonLdForScript(structuredDataJson) }
-		}),
+		}, "structured-data"),
 		llmsTxtEnabled && /* @__PURE__ */ jsx("a", {
 			href: `/llms.txt${llmsLangQuery}`,
 			className: "fd-agent-llms-directive",
@@ -465,7 +530,9 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 			tabIndex: -1,
 			"aria-hidden": "true",
 			children: "llms.txt"
-		}),
+		}, "llms-txt"),
+		titleControlsPortal,
+		tocActionsPortal,
 		/* @__PURE__ */ jsxs(DocsPage, {
 			full: false,
 			toc,
@@ -484,7 +551,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 					pathname,
 					publicPath: resolvedPublicPath,
 					locale: activeLocale
-				}),
+				}, "breadcrumb"),
 				showActionsAboveTitle && /* @__PURE__ */ jsxs("div", {
 					className: "fd-below-title-block not-prose",
 					children: [/* @__PURE__ */ jsx("div", {
@@ -497,11 +564,12 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 							openDocsTarget,
 							openDocsPrompt,
 							alignment: pageActionsAlignment,
+							variant: "default",
 							githubFileUrl,
 							analytics
 						})
-					}), readingTimeBlock]
-				}),
+					}, "actions"), readingTimeBlock]
+				}, "actions-above-title"),
 				!showReadingTimeAboveTitle && !showReadingTimeBelowTitle ? readingTimeBlock : null,
 				/* @__PURE__ */ jsxs(DocsBody, {
 					style: {
@@ -512,7 +580,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 						/* @__PURE__ */ jsx("div", {
 							style: { flex: 1 },
 							children: renderedChildren
-						}),
+						}, "content"),
 						titleDecorationsPortal,
 						!isChangelogRoute && feedbackEnabled && /* @__PURE__ */ jsx(DocsFeedback, {
 							pathname: normalizedPath,
@@ -525,11 +593,11 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 							submitLabel: feedbackSubmitLabel,
 							onFeedback: feedbackOnFeedback,
 							analytics
-						}),
+						}, "feedback"),
 						showFooter && /* @__PURE__ */ jsxs("div", {
 							className: "not-prose fd-page-footer",
 							children: [
-								githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }),
+								githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }, "github"),
 								llmsTxtEnabled && /* @__PURE__ */ jsxs("span", {
 									className: "fd-llms-txt-links",
 									children: [/* @__PURE__ */ jsx("a", {
@@ -545,17 +613,17 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 										className: "fd-llms-txt-link",
 										children: "llms-full.txt"
 									})]
-								}),
+								}, "llms-links"),
 								showLastUpdatedInFooter && lastModified && /* @__PURE__ */ jsxs("span", {
 									className: "fd-last-updated-footer",
 									children: ["Last updated ", lastModified]
-								})
+								}, "last-updated")
 							]
-						})
+						}, "footer")
 					]
-				})
+				}, "body")
 			]
-		})
+		}, "docs-page")
 	] });
 }
 

package/dist/index.d.mts

@@ -8,6 +8,7 @@ import { DocsPageClient } from "./docs-page-client.mjs";
 import { HardlineUIDefaults, hardline } from "./hardline/index.mjs";
 import { RootProvider } from "./provider.mjs";
 import { LedgerUIDefaults, ledger } from "./ledger/index.mjs";
+import { ThreadlineUIDefaults, threadline, threadlinePageActions } from "./threadline/index.mjs";
 import { DocsFeedback, DocsFeedbackProps } from "./docs-feedback.mjs";
 import { PageActions } from "./page-actions.mjs";
 import { withLangInUrl } from "./i18n.mjs";
@@ -19,4 +20,4 @@ import { AIConfig, BreadcrumbConfig, ChangelogConfig, ChangelogFrontmatter, Copy
 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, Agent, type BreadcrumbConfig, type ChangelogConfig, type ChangelogFrontmatter, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CodeGroup, CommandGridUIDefaults, ConcreteUIDefaults, type CopyMarkdownConfig, DocsBody, DocsClientHooks, DocsCommandSearch, type DocsConfig, DocsFeedback, type DocsFeedbackData, type DocsFeedbackProps, type DocsFeedbackValue, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FeedbackConfig, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, type HoverLinkProps, LedgerUIDefaults, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, Prompt, type PromptProps, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, ledger, withLangInUrl };
+export { type AIConfig, Agent, type BreadcrumbConfig, type ChangelogConfig, type ChangelogFrontmatter, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CodeGroup, CommandGridUIDefaults, ConcreteUIDefaults, type CopyMarkdownConfig, DocsBody, DocsClientHooks, DocsCommandSearch, type DocsConfig, DocsFeedback, type DocsFeedbackData, type DocsFeedbackProps, type DocsFeedbackValue, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FeedbackConfig, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, type HoverLinkProps, LedgerUIDefaults, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, Prompt, type PromptProps, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, ThreadlineUIDefaults, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, ledger, threadline, threadlinePageActions, withLangInUrl };

package/dist/index.mjs

@@ -10,6 +10,7 @@ import { CommandGridUIDefaults, commandGrid } from "./command-grid/index.mjs";
 import { ConcreteUIDefaults, concrete } from "./concrete/index.mjs";
 import { HardlineUIDefaults, hardline } from "./hardline/index.mjs";
 import { LedgerUIDefaults, ledger } from "./ledger/index.mjs";
+import { ThreadlineUIDefaults, threadline, threadlinePageActions } from "./threadline/index.mjs";
 import { DocsClientHooks } from "./docs-client-hooks.mjs";
 import { HoverLink } from "./hover-link.mjs";
 import { Prompt } from "./prompt.mjs";
@@ -20,4 +21,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 { Agent, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CodeGroup, CommandGridUIDefaults, ConcreteUIDefaults, DocsBody, DocsClientHooks, DocsCommandSearch, DocsFeedback, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, LedgerUIDefaults, PageActions, Pre, Prompt, RootProvider, Tab, Tabs, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, ledger, withLangInUrl };
+export { Agent, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CodeGroup, CommandGridUIDefaults, ConcreteUIDefaults, DocsBody, DocsClientHooks, DocsCommandSearch, DocsFeedback, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, LedgerUIDefaults, PageActions, Pre, Prompt, RootProvider, Tab, Tabs, ThreadlineUIDefaults, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, ledger, threadline, threadlinePageActions, withLangInUrl };

package/dist/locale-theme-control.mjs

@@ -236,6 +236,7 @@ function LocaleThemeControl({ locales, defaultLocale, locale, showThemeToggle =
 		}), showThemeToggle && (themeMode === "light-dark" ? /* @__PURE__ */ jsxs("button", {
 			type: "button",
 			"aria-label": "Toggle theme",
+			"data-theme-toggle": true,
 			onClick: () => applyTheme(resolvedTheme === "light" ? "dark" : "light"),
 			style: toggleContainerStyle,
 			children: [/* @__PURE__ */ jsx("span", {
@@ -251,6 +252,7 @@ function LocaleThemeControl({ locales, defaultLocale, locale, showThemeToggle =
 				/* @__PURE__ */ jsx("button", {
 					type: "button",
 					"aria-label": "light",
+					"data-theme-toggle": true,
 					style: getToggleItemStyle(themeValue === "light"),
 					onClick: () => applyTheme("light"),
 					children: /* @__PURE__ */ jsx(SunIcon, {})
@@ -258,6 +260,7 @@ function LocaleThemeControl({ locales, defaultLocale, locale, showThemeToggle =
 				/* @__PURE__ */ jsx("button", {
 					type: "button",
 					"aria-label": "dark",
+					"data-theme-toggle": true,
 					style: getToggleItemStyle(themeValue === "dark"),
 					onClick: () => applyTheme("dark"),
 					children: /* @__PURE__ */ jsx(MoonIcon, {})
@@ -265,6 +268,7 @@ function LocaleThemeControl({ locales, defaultLocale, locale, showThemeToggle =
 				/* @__PURE__ */ jsx("button", {
 					type: "button",
 					"aria-label": "system",
+					"data-theme-toggle": true,
 					style: getToggleItemStyle(themeValue === "system"),
 					onClick: () => applyTheme("system"),
 					children: /* @__PURE__ */ jsx("span", {

package/dist/page-actions.d.mts

@@ -16,6 +16,7 @@ interface PageActionsProps {
   openDocsTarget?: "markdown" | "page" | "source" | "github";
   openDocsPrompt?: string;
   alignment?: "left" | "right";
+  variant?: "default" | "rail";
   /** GitHub file URL (edit view) for the current page. Used when urlTemplate contains {githubUrl}. */
   githubFileUrl?: string | null;
   analytics?: boolean;
@@ -27,6 +28,7 @@ declare function PageActions({
   openDocsTarget,
   openDocsPrompt,
   alignment,
+  variant,
   githubFileUrl,
   analytics
 }: PageActionsProps): react_jsx_runtime0.JSX.Element | null;

package/dist/page-actions.mjs

@@ -67,6 +67,46 @@ const ExternalLinkIcon = () => /* @__PURE__ */ jsxs("svg", {
 		})
 	]
 });
+const FileTextIcon = () => /* @__PURE__ */ jsxs("svg", {
+	width: "14",
+	height: "14",
+	viewBox: "0 0 24 24",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: "2",
+	strokeLinecap: "round",
+	strokeLinejoin: "round",
+	children: [
+		/* @__PURE__ */ jsx("path", { d: "M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z" }),
+		/* @__PURE__ */ jsx("path", { d: "M14 2v4a2 2 0 0 0 2 2h4" }),
+		/* @__PURE__ */ jsx("path", { d: "M10 9H8" }),
+		/* @__PURE__ */ jsx("path", { d: "M16 13H8" }),
+		/* @__PURE__ */ jsx("path", { d: "M16 17H8" })
+	]
+});
+const GitHubIcon = () => /* @__PURE__ */ jsx("svg", {
+	width: "14",
+	height: "14",
+	viewBox: "0 0 24 24",
+	fill: "currentColor",
+	"aria-hidden": "true",
+	children: /* @__PURE__ */ jsx("path", { d: "M12 .5C5.65.5.5 5.65.5 12c0 5.08 3.29 9.39 7.86 10.92.58.11.79-.25.79-.56v-2.02c-3.2.7-3.88-1.37-3.88-1.37-.53-1.33-1.29-1.69-1.29-1.69-1.05-.72.08-.71.08-.71 1.16.08 1.77 1.2 1.77 1.2 1.03 1.76 2.71 1.25 3.37.96.1-.75.4-1.25.73-1.54-2.56-.29-5.26-1.28-5.26-5.7 0-1.26.45-2.29 1.19-3.1-.12-.29-.52-1.47.11-3.05 0 0 .97-.31 3.18 1.18a10.9 10.9 0 0 1 5.8 0c2.2-1.49 3.17-1.18 3.17-1.18.63 1.58.23 2.76.11 3.05.74.81 1.19 1.84 1.19 3.1 0 4.43-2.7 5.41-5.27 5.7.41.36.78 1.06.78 2.14v3.03c0 .31.21.67.8.56A11.5 11.5 0 0 0 23.5 12C23.5 5.65 18.35.5 12 .5Z" })
+});
+const SparklesIcon = () => /* @__PURE__ */ jsxs("svg", {
+	width: "14",
+	height: "14",
+	viewBox: "0 0 24 24",
+	fill: "none",
+	stroke: "currentColor",
+	strokeWidth: "2",
+	strokeLinecap: "round",
+	strokeLinejoin: "round",
+	children: [
+		/* @__PURE__ */ jsx("path", { d: "M9.94 15.5 8.5 21l-1.44-5.5L1.5 14l5.56-1.5L8.5 7l1.44 5.5L15.5 14Z" }),
+		/* @__PURE__ */ jsx("path", { d: "M17.5 3 18 5l2 .5-2 .5-.5 2-.5-2-2-.5 2-.5Z" }),
+		/* @__PURE__ */ jsx("path", { d: "M19 11.5 20 15l3.5 1-3.5 1-1 3.5-1-3.5-3.5-1 3.5-1Z" })
+	]
+});
 const DEFAULT_PROVIDERS = [{
 	name: "ChatGPT",
 	urlTemplate: "https://chatgpt.com/?q={prompt}"
@@ -92,30 +132,39 @@ function pageUrlToMarkdownUrl(pageUrl) {
 function fillPromptTemplate(template, values) {
 	return template.replace(/\{pageUrl\}/g, values.pageUrl).replace(/\{markdownUrl\}/g, values.markdownUrl).replace(/\{sourceUrl\}/g, values.sourceUrl).replace(/\{mdxUrl\}/g, values.sourceUrl).replace(/\{githubUrl\}/g, values.githubUrl).replace(/\{url\}/g, values.url);
 }
-function PageActions({ copyMarkdown, openDocs, providers, openDocsTarget = DEFAULT_OPEN_DOCS_TARGET, openDocsPrompt = DEFAULT_OPEN_DOCS_PROMPT, alignment = "left", githubFileUrl, analytics = false }) {
+function PageActions({ copyMarkdown, openDocs, providers, openDocsTarget = DEFAULT_OPEN_DOCS_TARGET, openDocsPrompt = DEFAULT_OPEN_DOCS_PROMPT, alignment = "left", variant = "default", githubFileUrl, analytics = false }) {
 	const [copied, setCopied] = useState(false);
 	const [dropdownOpen, setDropdownOpen] = useState(false);
 	const dropdownRef = useRef(null);
 	const pathname = usePathname();
 	const resolvedProviders = providers ?? DEFAULT_PROVIDERS;
+	const cleanedPathname = pathname.replace(/\/+$/, "") || "/";
+	const markdownHref = cleanedPathname === "/" ? "/index.md" : `${cleanedPathname.replace(/\.md$/, "")}.md`;
 	const handleCopyMarkdown = useCallback(async () => {
 		try {
-			const article = document.querySelector("article");
-			if (article) {
-				const content = article.innerText || "";
-				await navigator.clipboard.writeText(content);
-				if (analytics) emitClientAnalyticsEvent({
-					type: "page_action_copy_markdown",
-					properties: {
-						contentLength: content.length,
-						pathname
-					}
-				});
-				setCopied(true);
-				setTimeout(() => setCopied(false), 2e3);
-			}
+			let content = "";
+			try {
+				const response = await fetch(markdownHref, { headers: { Accept: "text/markdown" } });
+				if (response.ok) content = await response.text();
+			} catch {}
+			if (!content) content = document.querySelector("article")?.innerText || "";
+			if (!content) return;
+			await navigator.clipboard.writeText(content);
+			if (analytics) emitClientAnalyticsEvent({
+				type: "page_action_copy_markdown",
+				properties: {
+					contentLength: content.length,
+					pathname
+				}
+			});
+			setCopied(true);
+			setTimeout(() => setCopied(false), 2e3);
 		} catch {}
-	}, [analytics, pathname]);
+	}, [
+		analytics,
+		markdownHref,
+		pathname
+	]);
 	const handleOpen = useCallback((provider) => {
 		const template = provider.urlTemplate;
 		const githubUrl = githubFileUrl ?? "";
@@ -157,6 +206,15 @@ function PageActions({ copyMarkdown, openDocs, providers, openDocsTarget = DEFAU
 		openDocsPrompt,
 		openDocsTarget
 	]);
+	const handleAskAI = useCallback(() => {
+		const trigger = document.querySelector(".fd-ai-fm-trigger-btn, [data-ai-trigger], button[aria-label='Ask AI']");
+		if (!trigger) return;
+		trigger.click();
+		if (analytics) emitClientAnalyticsEvent({
+			type: "page_action_ask_ai",
+			properties: { pathname }
+		});
+	}, [analytics, pathname]);
 	useEffect(() => {
 		if (!dropdownOpen) return;
 		function handleClick(e) {
@@ -169,7 +227,41 @@ function PageActions({ copyMarkdown, openDocs, providers, openDocsTarget = DEFAU
 		setDropdownOpen(false);
 		setCopied(false);
 	}, [pathname]);
-	if (!copyMarkdown && !openDocs) return null;
+	if (variant !== "rail" && !copyMarkdown && !openDocs) return null;
+	if (variant === "rail") return /* @__PURE__ */ jsxs("div", {
+		className: "fd-page-actions fd-page-actions-rail",
+		"data-page-actions": true,
+		"data-page-actions-variant": "rail",
+		children: [
+			copyMarkdown && /* @__PURE__ */ jsxs("button", {
+				type: "button",
+				onClick: handleCopyMarkdown,
+				className: "fd-page-action-btn",
+				"data-copied": copied,
+				children: [copied ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx(CopyIcon, {}), /* @__PURE__ */ jsx("span", { children: copied ? "Copied!" : "Copy page" })]
+			}),
+			openDocs && /* @__PURE__ */ jsxs("a", {
+				className: "fd-page-action-btn",
+				href: markdownHref,
+				target: "_blank",
+				rel: "noreferrer",
+				children: [/* @__PURE__ */ jsx(FileTextIcon, {}), /* @__PURE__ */ jsx("span", { children: "View as Markdown" })]
+			}),
+			githubFileUrl && /* @__PURE__ */ jsxs("a", {
+				className: "fd-page-action-btn",
+				href: githubFileUrl,
+				target: "_blank",
+				rel: "noreferrer",
+				children: [/* @__PURE__ */ jsx(GitHubIcon, {}), /* @__PURE__ */ jsx("span", { children: "Edit on GitHub" })]
+			}),
+			/* @__PURE__ */ jsxs("button", {
+				type: "button",
+				onClick: handleAskAI,
+				className: "fd-page-action-btn",
+				children: [/* @__PURE__ */ jsx(SparklesIcon, {}), /* @__PURE__ */ jsx("span", { children: "Ask AI" })]
+			})
+		]
+	});
 	return /* @__PURE__ */ jsxs("div", {
 		className: "fd-page-actions",
 		"data-page-actions": true,