@farming-labs/theme 0.2.98 → 0.2.101

package/dist/browser.d.mts

@@ -0,0 +1,28 @@
+import { TanstackDocsLayoutProps } from "./tanstack-layout.mjs";
+import { ComponentPropsWithoutRef } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { RootProvider } from "fumadocs-ui/provider/base";
+
+//#region src/browser.d.ts
+type BrowserDocsLayoutProps = Omit<TanstackDocsLayoutProps, "browserRuntime">;
+/** Docs layout for framework-neutral browser adapters such as Farm.js. */
+declare function BrowserDocsLayout(props: BrowserDocsLayoutProps): react_jsx_runtime0.JSX.Element;
+type FumadocsProviderProps = ComponentPropsWithoutRef<typeof RootProvider>;
+declare global {
+  interface Window {
+    __fdBrowserHistoryPatched?: boolean;
+  }
+}
+interface BrowserRootProviderProps extends FumadocsProviderProps {
+  /** Path rendered by the server, used to keep hydration deterministic. */
+  initialPathname?: string;
+}
+/** Framework-neutral provider for server-rendered React documentation adapters. */
+declare function BrowserRootProvider({
+  children,
+  search,
+  initialPathname,
+  ...props
+}: BrowserRootProviderProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { BrowserDocsLayout, BrowserDocsLayoutProps, BrowserRootProvider, BrowserRootProviderProps };

package/dist/browser.mjs

@@ -0,0 +1,81 @@
+"use client";
+
+import { TanstackDocsLayout } from "./tanstack-layout.mjs";
+import { useMemo, useSyncExternalStore } from "react";
+import { FrameworkProvider } from "fumadocs-core/framework";
+import { jsx } from "react/jsx-runtime";
+import { RootProvider } from "fumadocs-ui/provider/base";
+
+//#region src/browser.tsx
+/** Docs layout for framework-neutral browser adapters such as Farm.js. */
+function BrowserDocsLayout(props) {
+	return /* @__PURE__ */ jsx(TanstackDocsLayout, {
+		...props,
+		browserRuntime: true
+	});
+}
+function patchHistoryEvents() {
+	if (typeof window === "undefined" || window.__fdBrowserHistoryPatched) return;
+	for (const method of ["pushState", "replaceState"]) {
+		const original = window.history[method];
+		window.history[method] = function patchedHistoryMethod(...args) {
+			const result = original.apply(this, args);
+			window.dispatchEvent(new Event("fd-location-change"));
+			return result;
+		};
+	}
+	window.__fdBrowserHistoryPatched = true;
+}
+function subscribeToLocation(onStoreChange) {
+	if (typeof window === "undefined") return () => {};
+	patchHistoryEvents();
+	window.addEventListener("popstate", onStoreChange);
+	window.addEventListener("fd-location-change", onStoreChange);
+	return () => {
+		window.removeEventListener("popstate", onStoreChange);
+		window.removeEventListener("fd-location-change", onStoreChange);
+	};
+}
+function getBrowserPathname() {
+	return typeof window === "undefined" ? "/" : window.location.pathname;
+}
+function useBrowserRouter() {
+	return useMemo(() => ({
+		push(url) {
+			window.location.assign(url);
+		},
+		refresh() {
+			window.location.reload();
+		}
+	}), []);
+}
+function useBrowserParams() {
+	return useMemo(() => ({}), []);
+}
+function BrowserLink({ prefetch: _prefetch, ...props }) {
+	return /* @__PURE__ */ jsx("a", { ...props });
+}
+/** Framework-neutral provider for server-rendered React documentation adapters. */
+function BrowserRootProvider({ children, search, initialPathname = "/", ...props }) {
+	const useBrowserPathname = () => useSyncExternalStore(subscribeToLocation, getBrowserPathname, () => initialPathname);
+	return /* @__PURE__ */ jsx(FrameworkProvider, {
+		Link: BrowserLink,
+		usePathname: useBrowserPathname,
+		useParams: useBrowserParams,
+		useRouter: useBrowserRouter,
+		children: /* @__PURE__ */ jsx(RootProvider, {
+			search: {
+				...search,
+				options: {
+					api: "/api/docs",
+					...search?.options
+				}
+			},
+			...props,
+			children
+		})
+	});
+}
+
+//#endregion
+export { BrowserDocsLayout, BrowserRootProvider };

package/dist/docs-client-hooks.mjs

@@ -2,7 +2,7 @@
 
 import { emitClientAnalyticsEvent } from "./client-analytics.mjs";
 import { useEffect } from "react";
-import { emitDocsAnalyticsEvent, resolveDocsAnalyticsConfig } from "@farming-labs/docs";
+import { emitDocsAnalyticsEvent, resolveDocsAnalyticsConfig } from "@farming-labs/docs/browser";
 
 //#region src/docs-client-hooks.tsx
 function useWindowHook(key, handler) {

package/dist/docs-command-search.mjs

@@ -256,6 +256,7 @@ function DocsCommandSearch({ api = "/api/docs", locale, analytics = false }) {
 	const searchApi = useMemo(() => withLangInUrl(api, activeLocale), [activeLocale, api]);
 	const inputRef = useRef(null);
 	const listRef = useRef(null);
+	const restoreFocusRef = useRef(null);
 	const searchCacheRef = useRef(/* @__PURE__ */ new Map());
 	const setOpenWithAnalytics = useCallback((nextOpen, trigger) => {
 		setOpen(nextOpen);
@@ -404,13 +405,23 @@ function DocsCommandSearch({ api = "/api/docs", locale, analytics = false }) {
 		searchApi
 	]);
 	useEffect(() => {
-		if (open) setTimeout(() => inputRef.current?.focus(), 10);
-		else {
+		if (open) {
+			const activeElement = document.activeElement;
+			restoreFocusRef.current = activeElement instanceof HTMLElement ? activeElement : null;
+			const focusTimer = window.setTimeout(() => inputRef.current?.focus(), 10);
+			return () => window.clearTimeout(focusTimer);
+		} else {
 			setQuery("");
 			setResults([]);
 			setFilter("all");
 			setFilterOpen(false);
 			setActiveIndex(0);
+			const restoreTarget = restoreFocusRef.current;
+			restoreFocusRef.current = null;
+			if (restoreTarget?.isConnected) {
+				const focusFrame = window.requestAnimationFrame(() => restoreTarget.focus({ preventScroll: true }));
+				return () => window.cancelAnimationFrame(focusFrame);
+			}
 		}
 	}, [open]);
 	useEffect(() => {

package/dist/docs-layout.mjs

@@ -1,11 +1,12 @@
 import { serializeIcon } from "./serialize-icon.mjs";
+import { resolveOpenDocsProviders } from "./open-docs-providers.mjs";
 import { withLangInUrl } from "./i18n.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { DocsAIFeatures } from "./docs-ai-features.mjs";
 import { resolveDocsCloudAIClientRequest } from "./docs-cloud-ai-client.mjs";
 import { DocsCommandSearch } from "./docs-command-search.mjs";
-import { resolveOpenDocsProviders } from "./open-docs-providers.mjs";
-import { resolvePageReadingTime, resolveReadingTimeOptions } from "./reading-time.mjs";
+import { resolveReadingTimeOptions } from "./reading-time-options.mjs";
+import { resolvePageReadingTime } from "./reading-time.mjs";
 import { SidebarSearchWithAI } from "./sidebar-search-ai.mjs";
 import { LocaleThemeControl } from "./locale-theme-control.mjs";
 import fs from "node:fs";
@@ -405,7 +406,10 @@ function buildDescriptionMap(config, ctx) {
 	scan(docsDir, []);
 	return map;
 }
-/** Build titles only for pages whose MDX body does not already author an h1. */
+/**
+* Build titles only for pages whose MDX body does not already author an h1.
+* This lets the page frame render the frontmatter title exactly once.
+*/
 function buildGeneratedTitleMap(config, ctx) {
 	const docsDir = ctx.docsDir;
 	const map = {};

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

@@ -17,6 +17,8 @@ interface SerializedProvider {
 }
 interface DocsPageClientProps {
   tocEnabled: boolean;
+  /** Expose the llms.txt action in a runtime-owned header slot. */
+  showLlmsInHeader?: boolean;
   tocStyle?: "default" | "directional";
   breadcrumbEnabled?: boolean;
   changelogBasePath?: string;
@@ -84,6 +86,8 @@ interface DocsPageClientProps {
   descriptionMap?: Record<string, string>;
   /** Frontmatter description to display below the page title (overrides descriptionMap) */
   description?: string;
+  /** The first authored paragraph already contains the frontmatter description. */
+  descriptionInBody?: boolean;
   /** Built-in page feedback prompt configuration */
   feedbackEnabled?: boolean;
   feedbackQuestion?: string;
@@ -100,6 +104,7 @@ interface DocsPageClientProps {
 }
 declare function DocsPageClient({
   tocEnabled,
+  showLlmsInHeader,
   tocStyle,
   breadcrumbEnabled,
   changelogBasePath,
@@ -139,6 +144,7 @@ declare function DocsPageClient({
   generatedTitleMap,
   descriptionMap,
   description,
+  descriptionInBody,
   feedbackEnabled,
   feedbackQuestion,
   feedbackPlaceholder,

package/dist/docs-page-client.mjs

@@ -255,7 +255,7 @@ function findThreadlineTocActionsContainer() {
 	}
 	return toc.parentElement ?? toc;
 }
-function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", publicPath, locale, copyMarkdown = false, copyMarkdownFormat, copyMarkdownIncludeTitle, copyMarkdownLabel, copyMarkdownCopiedLabel, openDocs = false, openDocsProviders, openDocsTarget, openDocsPrompt, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, readingTimeFormat = "long", previousPage, nextPage, structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedLabel = "Last updated", lastUpdatedPosition = "footer", llmsTxtEnabled = false, generatedTitleMap, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackRequireComment, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackSuccessMessage, feedbackErrorMessage, feedbackOnFeedback, analytics = false, children }) {
+function DocsPageClient({ tocEnabled, showLlmsInHeader = false, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", publicPath, locale, copyMarkdown = false, copyMarkdownFormat, copyMarkdownIncludeTitle, copyMarkdownLabel, copyMarkdownCopiedLabel, openDocs = false, openDocsProviders, openDocsTarget, openDocsPrompt, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, readingTimeFormat = "long", previousPage, nextPage, structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedLabel = "Last updated", lastUpdatedPosition = "footer", llmsTxtEnabled = false, generatedTitleMap, descriptionMap, description, descriptionInBody = false, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackRequireComment, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackSuccessMessage, feedbackErrorMessage, feedbackOnFeedback, analytics = false, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const [titlePortalHost, setTitlePortalHost] = useState(null);
@@ -268,6 +268,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 	const activeLocale = resolveClientLocale(searchParams, locale);
 	const resolvedPublicPath = normalizePublicDocsPath(publicPath, entry);
 	const llmsLangQuery = activeLocale ? `?lang=${encodeURIComponent(activeLocale)}` : "";
+	const shouldShowLlmsInHeader = llmsTxtEnabled && showLlmsInHeader;
 	const normalizedPath = (browserPathname || pathname).replace(/\/$/, "") || "/";
 	const pageTitle = generatedTitleMap?.[normalizedPath];
 	const pageDescription = description ?? descriptionMap?.[normalizedPath];
@@ -509,13 +510,38 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		}
 		const host = document.createElement("div");
 		host.className = "fd-title-decorations-host";
+		const placeHost = () => {
+			let anchor = title;
+			if (descriptionInBody) {
+				let sibling = title.nextElementSibling;
+				while (sibling) {
+					if (sibling === host || sibling.matches(".not-prose, .fd-title-decorations-host")) {
+						sibling = sibling.nextElementSibling;
+						continue;
+					}
+					if (sibling.matches("p")) anchor = sibling;
+					break;
+				}
+			}
+			if (anchor.nextElementSibling !== host) anchor.insertAdjacentElement("afterend", host);
+		};
 		title.insertAdjacentElement("afterend", host);
+		placeHost();
+		const observer = new MutationObserver(placeHost);
+		observer.observe(title.parentElement ?? title, { childList: true });
+		const animationFrame = window.requestAnimationFrame(placeHost);
 		setTitlePortalHost(host);
 		return () => {
+			window.cancelAnimationFrame(animationFrame);
+			observer.disconnect();
 			host.remove();
 			setTitlePortalHost(null);
 		};
-	}, [needsTitleDecorationsPortal, pathname]);
+	}, [
+		descriptionInBody,
+		needsTitleDecorationsPortal,
+		pathname
+	]);
 	const titleDecorations = needsTitleDecorationsPortal ? /* @__PURE__ */ jsx(TitleDecorations, {
 		description: titleDescription,
 		belowTitle: belowTitleBlock
@@ -560,10 +586,11 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		llmsTxtEnabled && /* @__PURE__ */ jsx("a", {
 			href: `/llms.txt${llmsLangQuery}`,
 			className: "fd-agent-llms-directive",
-			style: agentLlmsDirectiveStyle,
-			tabIndex: -1,
-			"aria-hidden": "true",
-			children: "llms.txt"
+			"data-visible-in-header": shouldShowLlmsInHeader ? "true" : void 0,
+			style: shouldShowLlmsInHeader ? void 0 : agentLlmsDirectiveStyle,
+			tabIndex: shouldShowLlmsInHeader ? void 0 : -1,
+			"aria-hidden": shouldShowLlmsInHeader ? void 0 : true,
+			children: shouldShowLlmsInHeader ? "LLMS.TXT" : "llms.txt"
 		}, "llms-txt"),
 		titleControlsPortal,
 		tocActionsPortal,

package/dist/mdx.mjs

@@ -5,7 +5,7 @@ import { HoverLink } from "./hover-link.mjs";
 import { extractPromptText } from "./prompt-text.mjs";
 import { Prompt } from "./prompt.mjs";
 import React from "react";
-import { resolveDocsAudienceExposure } from "@farming-labs/docs";
+import { resolveDocsAudienceExposure } from "@farming-labs/docs/browser";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import { CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger } from "fumadocs-ui/components/codeblock";
 import defaultMdxComponents from "fumadocs-ui/mdx";

package/dist/open-docs-provider-icons.mjs

@@ -0,0 +1,14 @@
+//#region src/open-docs-provider-icons.ts
+/** Monochrome provider marks used by the built-in Open in… presets. */
+const OPEN_DOCS_PROVIDER_ICONS = {
+	chatgpt: "<svg viewBox=\"0 0 20 20\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M11.248 18.25q-.825 0-1.568-.314a4.3 4.3 0 0 1-1.32-.874 4 4 0 0 1-1.304.214 4 4 0 0 1-2.046-.544 4.27 4.27 0 0 1-1.518-1.485 4 4 0 0 1-.56-2.095q0-.48.131-1.04A4.4 4.4 0 0 1 2.04 10.71a4.07 4.07 0 0 1 .017-3.4 4.2 4.2 0 0 1 1.056-1.418 3.8 3.8 0 0 1 1.6-.842 3.9 3.9 0 0 1 .76-1.683q.593-.759 1.451-1.188a4.04 4.04 0 0 1 1.832-.429q.825 0 1.567.313.742.314 1.32.875a4 4 0 0 1 1.304-.215q1.106 0 2.046.545a4.14 4.14 0 0 1 1.501 1.485q.578.941.578 2.095 0 .48-.132 1.04.66.61 1.023 1.419.363.792.363 1.666 0 .892-.38 1.717a4.3 4.3 0 0 1-1.072 1.435 3.8 3.8 0 0 1-1.584.825 3.8 3.8 0 0 1-.775 1.683 4.06 4.06 0 0 1-1.436 1.188 4.04 4.04 0 0 1-1.832.429m-4.076-2.062q.825 0 1.435-.347l3.103-1.782a.36.36 0 0 0 .164-.313v-1.42L7.881 14.62a.67.67 0 0 1-.726 0l-3.118-1.798a.5.5 0 0 1-.017.115v.198q0 .841.396 1.551.413.693 1.139 1.089a3.2 3.2 0 0 0 1.617.412m.165-2.69a.4.4 0 0 0 .181.05q.083 0 .165-.05l1.238-.71-3.977-2.31a.7.7 0 0 1-.363-.643v-3.58q-.825.362-1.32 1.122a2.9 2.9 0 0 0-.495 1.65q0 .809.413 1.55.412.743 1.072 1.123zm3.91 3.663q.875 0 1.585-.396a2.96 2.96 0 0 0 1.534-2.64v-3.564a.32.32 0 0 0-.165-.297l-1.254-.726v4.604a.7.7 0 0 1-.363.643l-3.119 1.799a3 3 0 0 0 1.783.577m.627-6.039V8.878L10.01 7.822 8.129 8.878v2.244l1.881 1.056zM7.057 5.859a.7.7 0 0 1 .363-.644l3.119-1.798a3 3 0 0 0-1.782-.578q-.874 0-1.584.396A2.96 2.96 0 0 0 6.05 4.324a3.07 3.07 0 0 0-.396 1.551v3.547q0 .199.165.314l1.237.726zm8.383 7.887q.825-.364 1.303-1.123.495-.758.495-1.65a3.15 3.15 0 0 0-.412-1.55q-.413-.743-1.073-1.123l-3.086-1.782q-.099-.065-.181-.049a.3.3 0 0 0-.165.05l-1.238.692 3.993 2.327a.6.6 0 0 1 .264.264.64.64 0 0 1 .1.363zm-3.317-8.382a.63.63 0 0 1 .726 0l3.135 1.831v-.297q0-.792-.396-1.501a2.86 2.86 0 0 0-1.105-1.155q-.71-.43-1.65-.43-.825 0-1.436.347L8.294 5.941a.36.36 0 0 0-.165.314v1.418z\"/></svg>",
+	claude: "<svg viewBox=\"0 0 24 24\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"m4.7144 15.9555 4.7174-2.6471.079-.2307-.079-.1275h-.2307l-.7893-.0486-2.6956-.0729-2.3375-.0971-2.2646-.1214-.5707-.1215-.5343-.7042.0546-.3522.4797-.3218.686.0608 1.5179.1032 2.2767.1578 1.6514.0972 2.4468.255h.3886l.0546-.1579-.1336-.0971-.1032-.0972L6.973 9.8356l-2.55-1.6879-1.3356-.9714-.7225-.4918-.3643-.4614-.1578-1.0078.6557-.7225.8803.0607.2246.0607.8925.686 1.9064 1.4754 2.4893 1.8336.3643.3035.1457-.1032.0182-.0728-.164-.2733-1.3539-2.4467-1.445-2.4893-.6435-1.032-.17-.6194c-.0607-.255-.1032-.4674-.1032-.7285L6.287.1335 6.6997 0l.9957.1336.419.3642.6192 1.4147 1.0018 2.2282 1.5543 3.0296.4553.8985.2429.8318.091.255h.1579v-.1457l.1275-1.706.2368-2.0947.2307-2.6957.0789-.7589.3764-.9107.7468-.4918.5828.2793.4797.686-.0668.4433-.2853 1.8517-.5586 2.9021-.3643 1.9429h.2125l.2429-.2429.9835-1.3053 1.6514-2.0643.7286-.8196.85-.9046.5464-.4311h1.0321l.759 1.1293-.34 1.1657-1.0625 1.3478-.8804 1.1414-1.2628 1.7-.7893 1.36.0729.1093.1882-.0183 2.8535-.607 1.5421-.2794 1.8396-.3157.8318.3886.091.3946-.3278.8075-1.967.4857-2.3072.4614-3.4364.8136-.0425.0304.0486.0607 1.5482.1457.6618.0364h1.621l3.0175.2247.7892.522.4736.6376-.079.4857-1.2142.6193-1.6393-.3886-3.825-.9107-1.3113-.3279h-.1822v.1093l1.0929 1.0686 2.0035 1.8092 2.5075 2.3314.1275.5768-.3218.4554-.34-.0486-2.2039-1.6575-.85-.7468-1.9246-1.621h-.1275v.17l.4432.6496 2.3436 3.5214.1214 1.0807-.17.3521-.6071.2125-.6679-.1214-1.3721-1.9246L14.38 17.959l-1.1414-1.9428-.1397.079-.674 7.2552-.3156.3703-.7286.2793-.6071-.4614-.3218-.7468.3218-1.4753.3886-1.9246.3157-1.53.2853-1.9004.17-.6314-.0121-.0425-.1397.0182-1.4328 1.9672-2.1796 2.9446-1.7243 1.8456-.4128.164-.7164-.3704.0667-.6618.4008-.5889 2.386-3.0357 1.4389-1.882.929-1.0868-.0062-.1579h-.0546l-6.3385 4.1164-1.1293.1457-.4857-.4554.0608-.7467.2307-.2429 1.9064-1.3114Z\"/></svg>",
+	cursor: "<svg viewBox=\"0 0 24 24\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M11.503.131 1.891 5.678a.84.84 0 0 0-.42.726v11.188c0 .3.162.575.42.724l9.609 5.55a1 1 0 0 0 .998 0l9.61-5.55a.84.84 0 0 0 .42-.724V6.404a.84.84 0 0 0-.42-.726L12.497.131a1.01 1.01 0 0 0-.996 0M2.657 6.338h18.55c.263 0 .43.287.297.515L12.23 22.918c-.062.107-.229.064-.229-.06V12.335a.59.59 0 0 0-.295-.51l-9.11-5.257c-.109-.063-.064-.23.061-.23\"/></svg>",
+	gemini: "<svg viewBox=\"0 0 24 24\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M11.04 19.32Q12 21.51 12 24q0-2.49.93-4.68.96-2.19 2.58-3.81t3.81-2.55Q21.51 12 24 12q-2.49 0-4.68-.93a12.3 12.3 0 0 1-3.81-2.58 12.3 12.3 0 0 1-2.58-3.81Q12 2.49 12 0q0 2.49-.96 4.68-.93 2.19-2.55 3.81a12.3 12.3 0 0 1-3.81 2.58Q2.49 12 0 12q2.49 0 4.68.96 2.19.93 3.81 2.55t2.55 3.81\"/></svg>",
+	copilot: "<svg viewBox=\"0 0 24 24\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M23.922 16.997C23.061 18.492 18.063 22.02 12 22.02 5.937 22.02.939 18.492.078 16.997A.641.641 0 0 1 0 16.741v-2.869a.883.883 0 0 1 .053-.22c.372-.935 1.347-2.292 2.605-2.656.167-.429.414-1.055.644-1.517a10.098 10.098 0 0 1-.052-1.086c0-1.331.282-2.499 1.132-3.368.397-.406.89-.717 1.474-.952C7.255 2.937 9.248 1.98 11.978 1.98c2.731 0 4.767.957 6.166 2.093.584.235 1.077.546 1.474.952.85.869 1.132 2.037 1.132 3.368 0 .368-.014.733-.052 1.086.23.462.477 1.088.644 1.517 1.258.364 2.233 1.721 2.605 2.656a.841.841 0 0 1 .053.22v2.869a.641.641 0 0 1-.078.256Zm-11.75-5.992h-.344a4.359 4.359 0 0 1-.355.508c-.77.947-1.918 1.492-3.508 1.492-1.725 0-2.989-.359-3.782-1.259a2.137 2.137 0 0 1-.085-.104L4 11.746v6.585c1.435.779 4.514 2.179 8 2.179 3.486 0 6.565-1.4 8-2.179v-6.585l-.098-.104s-.033.045-.085.104c-.793.9-2.057 1.259-3.782 1.259-1.59 0-2.738-.545-3.508-1.492a4.359 4.359 0 0 1-.355-.508Zm2.328 3.25c.549 0 1 .451 1 1v2c0 .549-.451 1-1 1-.549 0-1-.451-1-1v-2c0-.549.451-1 1-1Zm-5 0c.549 0 1 .451 1 1v2c0 .549-.451 1-1 1-.549 0-1-.451-1-1v-2c0-.549.451-1 1-1Zm3.313-6.185c.136 1.057.403 1.913.878 2.497.442.544 1.134.938 2.344.938 1.573 0 2.292-.337 2.657-.751.384-.435.558-1.15.558-2.361 0-1.14-.243-1.847-.705-2.319-.477-.488-1.319-.862-2.824-1.025-1.487-.161-2.192.138-2.533.529-.269.307-.437.808-.438 1.578v.021c0 .265.021.562.063.893Zm-1.626 0c.042-.331.063-.628.063-.894v-.02c-.001-.77-.169-1.271-.438-1.578-.341-.391-1.046-.69-2.533-.529-1.505.163-2.347.537-2.824 1.025-.462.472-.705 1.179-.705 2.319 0 1.211.175 1.926.558 2.361.365.414 1.084.751 2.657.751 1.21 0 1.902-.394 2.344-.938.475-.584.742-1.44.878-2.497Z\"/></svg>",
+	perplexity: "<svg viewBox=\"0 0 24 24\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M22.3977 7.0896h-2.3106V.0676l-7.5094 6.3542V.1577h-1.1554v6.1966L4.4904 0v7.0896H1.6023v10.3976h2.8882V24l6.932-6.3591v6.2005h1.1554v-6.0469l6.9318 6.1807v-6.4879h2.8882V7.0896zm-3.4657-4.531v4.531h-5.355l5.355-4.531zm-13.2862.0676 4.8691 4.4634H5.6458V2.6262zM2.7576 16.332V8.245h7.8476l-6.1149 6.1147v1.9723H2.7576zm2.8882 5.0404v-3.8852h.0001v-2.6488l5.7763-5.7764v7.0111l-5.7764 5.2993zm12.7086.0248-5.7766-5.1509V9.0618l5.7766 5.7766v6.5588zm2.8882-5.0652h-1.733v-1.9723L13.3948 8.245h7.8478v8.087z\"/></svg>",
+	github: "<svg viewBox=\"0 0 24 24\" fill=\"currentColor\" aria-hidden=\"true\"><path d=\"M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12\"/></svg>"
+};
+
+//#endregion
+export { OPEN_DOCS_PROVIDER_ICONS };

package/dist/open-docs-providers.mjs

@@ -1,3 +1,5 @@
+import { OPEN_DOCS_PROVIDER_ICONS } from "./open-docs-provider-icons.mjs";
+
 //#region src/open-docs-providers.ts
 const PROMPT_PROVIDER_TEMPLATES = {
 	chatgpt: "https://chatgpt.com/?q={prompt}",
@@ -10,36 +12,43 @@ const PROMPT_PROVIDER_TEMPLATES = {
 const OPEN_DOCS_PROVIDER_PRESETS = {
 	chatgpt: {
 		name: "ChatGPT",
+		iconHtml: OPEN_DOCS_PROVIDER_ICONS.chatgpt,
 		urlTemplate: "https://chatgpt.com/?q={prompt}",
 		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.chatgpt
 	},
 	claude: {
 		name: "Claude",
+		iconHtml: OPEN_DOCS_PROVIDER_ICONS.claude,
 		urlTemplate: "https://claude.ai/new?q={prompt}",
 		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.claude
 	},
 	cursor: {
 		name: "Cursor",
+		iconHtml: OPEN_DOCS_PROVIDER_ICONS.cursor,
 		urlTemplate: "https://cursor.com/link/prompt?text={prompt}",
 		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.cursor
 	},
 	gemini: {
 		name: "Gemini",
+		iconHtml: OPEN_DOCS_PROVIDER_ICONS.gemini,
 		urlTemplate: "https://gemini.google.com/app?q={prompt}",
 		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.gemini
 	},
 	copilot: {
 		name: "Copilot",
+		iconHtml: OPEN_DOCS_PROVIDER_ICONS.copilot,
 		urlTemplate: "https://github.com/copilot?prompt={prompt}",
 		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.copilot
 	},
 	perplexity: {
 		name: "Perplexity",
+		iconHtml: OPEN_DOCS_PROVIDER_ICONS.perplexity,
 		urlTemplate: "https://www.perplexity.ai/search/?q={prompt}",
 		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.perplexity
 	},
 	github: {
 		name: "GitHub",
+		iconHtml: OPEN_DOCS_PROVIDER_ICONS.github,
 		urlTemplate: "{githubUrl}",
 		promptUrlTemplate: "{githubUrl}",
 		target: "github"
@@ -48,6 +57,11 @@ const OPEN_DOCS_PROVIDER_PRESETS = {
 function normalizeProviderName(name) {
 	return name.trim().toLowerCase();
 }
+function resolveOpenDocsProviderIcon(name) {
+	if (!name) return void 0;
+	const normalizedName = normalizeProviderName(name);
+	return OPEN_DOCS_PROVIDER_PRESETS[normalizedName === "github copilot" ? "copilot" : normalizedName]?.iconHtml;
+}
 function resolveOpenDocsProviders(providers, options = {}) {
 	if (!providers || providers.length === 0) return void 0;
 	const serialized = providers.map((provider) => resolveOpenDocsProvider(provider, options)).filter((provider) => provider !== void 0);
@@ -60,6 +74,7 @@ function resolveOpenDocsProvider(provider, options = {}) {
 		if (!preset) return void 0;
 		return {
 			name: preset.name,
+			iconHtml: preset.iconHtml,
 			urlTemplate: preset.urlTemplate,
 			promptUrlTemplate: preset.promptUrlTemplate,
 			target: preset.target ?? options.target,
@@ -75,11 +90,11 @@ function resolveOpenDocsProvider(provider, options = {}) {
 		name,
 		urlTemplate,
 		promptUrlTemplate: provider.promptUrlTemplate ?? cursorAppTemplate ?? preset?.promptUrlTemplate,
-		iconHtml: options.serializeIcon?.(provider.icon) ?? (typeof provider.icon === "string" ? provider.icon : void 0),
+		iconHtml: options.serializeIcon?.(provider.icon) ?? (typeof provider.icon === "string" ? provider.icon : void 0) ?? preset?.iconHtml,
 		target: provider.target ?? preset?.target ?? options.target ?? (hasCustomUrlTemplate ? "page" : void 0),
 		prompt: provider.prompt ?? options.prompt
 	};
 }
 
 //#endregion
-export { resolveOpenDocsProviders };
+export { resolveOpenDocsProviderIcon, resolveOpenDocsProviders };

package/dist/page-actions.mjs

@@ -1,6 +1,7 @@
 "use client";
 
 import { emitClientAnalyticsEvent } from "./client-analytics.mjs";
+import { resolveOpenDocsProviderIcon, resolveOpenDocsProviders } from "./open-docs-providers.mjs";
 import { sanitizeIconHtml } from "./safe-icon-html.mjs";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { usePathname } from "fumadocs-core/framework";
@@ -107,13 +108,7 @@ const SparklesIcon = () => /* @__PURE__ */ jsxs("svg", {
 		/* @__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}"
-}, {
-	name: "Claude",
-	urlTemplate: "https://claude.ai/new?q={prompt}"
-}];
+const DEFAULT_PROVIDERS = resolveOpenDocsProviders(["chatgpt", "claude"]) ?? [];
 const DEFAULT_OPEN_DOCS_TARGET = "markdown";
 const DEFAULT_OPEN_DOCS_PROMPT = "Read this documentation: {url}";
 function pageUrlToMarkdownUrl(pageUrl) {
@@ -328,7 +323,7 @@ function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdo
 				className: "fd-page-action-menu",
 				role: "menu",
 				children: resolvedProviders.map((provider) => {
-					const iconHtml = sanitizeIconHtml(provider.iconHtml);
+					const iconHtml = sanitizeIconHtml(provider.iconHtml ?? resolveOpenDocsProviderIcon(provider.name));
 					return /* @__PURE__ */ jsxs("button", {
 						type: "button",
 						role: "menuitem",

package/dist/pixel-border/index.d.mts

@@ -62,6 +62,7 @@ declare const PixelBorderUIDefaults: {
     toc: {
       enabled: boolean;
       depth: number;
+      style: "directional";
     };
     header: {
       height: number;

package/dist/pixel-border/index.mjs

@@ -65,7 +65,8 @@ const PixelBorderUIDefaults = {
 		sidebarWidth: 286,
 		toc: {
 			enabled: true,
-			depth: 3
+			depth: 3,
+			style: "directional"
 		},
 		header: {
 			height: 56,

package/dist/reading-time-options.mjs

@@ -0,0 +1,27 @@
+//#region src/reading-time-options.ts
+function resolveReadingTimeOptions(readingTime) {
+	if (readingTime === true) return {
+		enabled: true,
+		format: "long",
+		includeCode: false
+	};
+	if (readingTime === false || readingTime === void 0 || readingTime === null) return {
+		enabled: false,
+		format: "long",
+		includeCode: false
+	};
+	if (typeof readingTime !== "object") return {
+		enabled: false,
+		format: "long",
+		includeCode: false
+	};
+	return {
+		enabled: readingTime.enabled !== false,
+		wordsPerMinute: typeof readingTime.wordsPerMinute === "number" && Number.isFinite(readingTime.wordsPerMinute) ? readingTime.wordsPerMinute : void 0,
+		format: readingTime.format === "short" ? "short" : "long",
+		includeCode: readingTime.includeCode === true
+	};
+}
+
+//#endregion
+export { resolveReadingTimeOptions };

package/dist/reading-time.mjs

@@ -1,3 +1,4 @@
+import { resolveReadingTimeOptions } from "./reading-time-options.mjs";
 import matter from "gray-matter";
 
 //#region src/reading-time.ts
@@ -16,29 +17,6 @@ function estimateReadingTimeMinutes(content, wordsPerMinute, options) {
 	const wordCount = stripNonReadingContent(content, options).match(/\b[\p{L}\p{N}][\p{L}\p{N}'’-]*\b/gu)?.length ?? 0;
 	return Math.max(1, Math.ceil(wordCount / normalizeWordsPerMinute(wordsPerMinute)));
 }
-function resolveReadingTimeOptions(readingTime) {
-	if (readingTime === true) return {
-		enabled: true,
-		format: "long",
-		includeCode: false
-	};
-	if (readingTime === false || readingTime === void 0 || readingTime === null) return {
-		enabled: false,
-		format: "long",
-		includeCode: false
-	};
-	if (typeof readingTime !== "object") return {
-		enabled: false,
-		format: "long",
-		includeCode: false
-	};
-	return {
-		enabled: readingTime.enabled !== false,
-		wordsPerMinute: typeof readingTime.wordsPerMinute === "number" && Number.isFinite(readingTime.wordsPerMinute) ? readingTime.wordsPerMinute : void 0,
-		format: readingTime.format === "short" ? "short" : "long",
-		includeCode: readingTime.includeCode === true
-	};
-}
 function resolveReadingTimeFromContent(frontmatter, content, wordsPerMinute, options) {
 	const pageData = frontmatter ?? {};
 	if (pageData.readingTime === false) return null;
@@ -51,4 +29,4 @@ function resolvePageReadingTime(frontmatter, content, options) {
 }
 
 //#endregion
-export { resolvePageReadingTime, resolveReadingTimeOptions };
+export { resolvePageReadingTime };

package/dist/tablet-sidebar-bridge.mjs

@@ -0,0 +1,64 @@
+"use client";
+
+import { useEffect, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { useSidebar } from "fumadocs-ui/components/sidebar/base";
+
+//#region src/tablet-sidebar-bridge.tsx
+const tabletSidebarQuery = "(min-width: 768px) and (max-width: 1023px)";
+/**
+* Extends Fumadocs' sidebar state through the tablet breakpoint without
+* intercepting its trigger or cloning the configured navigation tree.
+*/
+function TabletSidebarBridge() {
+	const { open, setOpen } = useSidebar();
+	const [isTablet, setIsTablet] = useState(false);
+	const closeButtonRef = useRef(null);
+	const returnFocusRef = useRef(null);
+	const visible = isTablet && open;
+	useEffect(() => {
+		const media = window.matchMedia(tabletSidebarQuery);
+		const update = () => setIsTablet(media.matches);
+		update();
+		media.addEventListener("change", update);
+		return () => media.removeEventListener("change", update);
+	}, []);
+	useEffect(() => {
+		if (!visible) return;
+		returnFocusRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+		closeButtonRef.current?.focus();
+		const closeOnEscape = (event) => {
+			if (event.key !== "Escape") return;
+			event.preventDefault();
+			setOpen(false);
+		};
+		window.addEventListener("keydown", closeOnEscape);
+		return () => {
+			window.removeEventListener("keydown", closeOnEscape);
+			returnFocusRef.current?.focus();
+			returnFocusRef.current = null;
+		};
+	}, [setOpen, visible]);
+	if (!isTablet) return null;
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+		hidden: true,
+		"aria-hidden": "true",
+		"data-fd-tablet-sidebar-state": visible ? "open" : "closed"
+	}), visible && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("button", {
+		type: "button",
+		tabIndex: -1,
+		"aria-hidden": "true",
+		className: "fd-tablet-sidebar-backdrop",
+		onClick: () => setOpen(false)
+	}), /* @__PURE__ */ jsx("button", {
+		ref: closeButtonRef,
+		type: "button",
+		"aria-label": "Close Sidebar",
+		className: "fd-tablet-sidebar-close",
+		onClick: () => setOpen(false),
+		children: /* @__PURE__ */ jsx("span", { "aria-hidden": "true" })
+	})] })] });
+}
+
+//#endregion
+export { TabletSidebarBridge };

package/dist/tanstack-layout.d.mts

@@ -27,8 +27,11 @@ interface TreeRoot {
 interface TanstackDocsLayoutProps {
   config: DocsConfig;
   tree: TreeRoot;
+  /** Enables browser-adapter shell affordances that are not part of a theme preset. */
+  browserRuntime?: boolean;
   locale?: string;
   description?: string;
+  descriptionInBody?: boolean;
   readingTime?: number | null;
   lastModified?: string;
   previousPage?: {
@@ -46,8 +49,10 @@ interface TanstackDocsLayoutProps {
 declare function TanstackDocsLayout({
   config,
   tree,
+  browserRuntime,
   locale,
   description,
+  descriptionInBody,
   readingTime,
   lastModified,
   previousPage,