@farming-labs/theme 0.2.97 → 0.2.99

package/dist/browser.d.mts

@@ -0,0 +1,25 @@
+import { TanstackDocsLayout, 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 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 { TanstackDocsLayout as BrowserDocsLayout, type TanstackDocsLayoutProps as BrowserDocsLayoutProps, BrowserRootProvider, BrowserRootProviderProps };

package/dist/browser.mjs

@@ -0,0 +1,74 @@
+"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
+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 { TanstackDocsLayout as 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,12 +1,14 @@
 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 { TabletSidebarBridge } from "./tablet-sidebar-bridge.mjs";
 import { LocaleThemeControl } from "./locale-theme-control.mjs";
 import fs from "node:fs";
 import path from "node:path";
@@ -35,6 +37,30 @@ function readFrontmatter(filePath) {
 		return {};
 	}
 }
+function hasAuthoredPageTitle(source) {
+	const { content } = matter(source);
+	const lines = content.split(/\r?\n/);
+	let fence;
+	let previousTextLine = "";
+	for (const line of lines) {
+		const fenceMatch = line.match(/^\s*(`{3,}|~{3,})/);
+		if (fenceMatch) {
+			const marker = fenceMatch[1]?.[0];
+			fence = fence === marker ? void 0 : fence ?? marker;
+			previousTextLine = "";
+			continue;
+		}
+		if (fence) continue;
+		if (/^ {0,3}#(?:\s+|$)/.test(line) || /^\s*<h1(?:\s|>)/i.test(line)) return true;
+		if (previousTextLine && /^ {0,3}=+\s*$/.test(line)) return true;
+		previousTextLine = line.trim() && !line.trimStart().startsWith("<") ? line : "";
+	}
+	return false;
+}
+function resolveSidebarFolderName(themeName, slug, pageTitle) {
+	if (themeName !== "shadcn" || pageTitle.trim().toLowerCase() !== "introduction") return pageTitle;
+	return slug.split(/[-_]/).filter(Boolean).map((part) => part[0]?.toUpperCase() + part.slice(1)).join(" ");
+}
 /** Check if a directory has any subdirectories that contain page.mdx. */
 function isWithinDir(candidate, target) {
 	const relative = path.relative(target, candidate);
@@ -194,12 +220,13 @@ function buildTree(config, ctx, flat = false) {
 		const url = publicDocsRoute(ctx, slug);
 		const icon = resolveIcon(data.icon, icons);
 		const displayName = data.title ?? name.replace(/-/g, " ");
+		const folderName = resolveSidebarFolderName(config.theme?.name, name, displayName);
 		const hasChildren = hasChildPages(full, excludedDirs);
 		if (data.hidden === true) {
 			if (!hasChildren) return null;
 			return {
 				type: "folder",
-				name: displayName,
+				name: folderName,
 				icon,
 				children: scanDir(full, slug, slugOrder),
 				...flat ? {
@@ -212,7 +239,7 @@ function buildTree(config, ctx, flat = false) {
 			const folderChildren = scanDir(full, slug, slugOrder);
 			return {
 				type: "folder",
-				name: displayName,
+				name: folderName,
 				icon,
 				index: {
 					type: "page",
@@ -380,6 +407,31 @@ function buildDescriptionMap(config, ctx) {
 	scan(docsDir, []);
 	return map;
 }
+/**
+* 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 = {};
+	const excludedDirs = getExcludedDocsDirs(config, ctx);
+	function scan(dir, slugParts) {
+		if (!fs.existsSync(dir)) return;
+		if (isExcludedDir(dir, excludedDirs)) return;
+		const pagePath = findDocsPageFile(dir);
+		if (pagePath) {
+			const source = fs.readFileSync(pagePath, "utf-8");
+			const { data } = matter(source);
+			if (typeof data.title === "string" && !hasAuthoredPageTitle(source)) map[publicDocsRoute(ctx, slugParts)] = data.title;
+		}
+		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;
+}
 function buildReadingTimeMap(config, ctx, options) {
 	const docsDir = ctx.docsDir;
 	const map = {};
@@ -702,6 +754,7 @@ function createDocsLayout(config, options) {
 	}
 	const lastModifiedMap = buildLastModifiedMap(config, localeContext);
 	const descriptionMap = buildDescriptionMap(config, localeContext);
+	const generatedTitleMap = config.theme?.name === "shadcn" ? buildGeneratedTitleMap(config, localeContext) : {};
 	const readingTimeMap = buildReadingTimeMap(config, localeContext, {
 		enabledByDefault: readingTimeEnabledByDefault,
 		wordsPerMinute: readingTimeWordsPerMinute,
@@ -756,6 +809,7 @@ function createDocsLayout(config, options) {
 				/* @__PURE__ */ jsx(TypographyStyle, { typography }),
 				/* @__PURE__ */ jsx(LayoutStyle, { layout: layoutDimensions }),
 				forcedTheme && /* @__PURE__ */ jsx(ForcedThemeScript, { theme: forcedTheme }),
+				config.theme?.name === "fumadocs-pixel-border" && /* @__PURE__ */ jsx(TabletSidebarBridge, {}),
 				!staticExport && /* @__PURE__ */ jsx(Suspense, {
 					fallback: null,
 					children: /* @__PURE__ */ jsx(DocsCommandSearch, {
@@ -790,6 +844,7 @@ function createDocsLayout(config, options) {
 					fallback: children,
 					children: /* @__PURE__ */ jsx(DocsPageClient, {
 						tocEnabled,
+						themeName: config.theme?.name,
 						tocStyle,
 						breadcrumbEnabled,
 						changelogBasePath,
@@ -820,6 +875,7 @@ function createDocsLayout(config, options) {
 						readingTimeMap,
 						structuredDataMap,
 						llmsTxtEnabled,
+						generatedTitleMap,
 						descriptionMap,
 						feedbackEnabled: feedbackConfig.enabled,
 						feedbackQuestion: feedbackConfig.question,

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

@@ -17,6 +17,8 @@ interface SerializedProvider {
 }
 interface DocsPageClientProps {
   tocEnabled: boolean;
+  /** Active theme preset name, used for theme-specific structural affordances. */
+  themeName?: string;
   tocStyle?: "default" | "directional";
   breadcrumbEnabled?: boolean;
   changelogBasePath?: string;
@@ -78,10 +80,14 @@ interface DocsPageClientProps {
   lastUpdatedPosition?: "footer" | "below-title";
   /** Whether llms.txt is enabled — shows links in footer */
   llmsTxtEnabled?: boolean;
+  /** Frontmatter titles for pages whose MDX body does not author an h1 */
+  generatedTitleMap?: Record<string, string>;
   /** Map of pathname → frontmatter description */
   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;
@@ -98,6 +104,7 @@ interface DocsPageClientProps {
 }
 declare function DocsPageClient({
   tocEnabled,
+  themeName,
   tocStyle,
   breadcrumbEnabled,
   changelogBasePath,
@@ -134,8 +141,10 @@ declare function DocsPageClient({
   lastUpdatedLabel,
   lastUpdatedPosition,
   llmsTxtEnabled,
+  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, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackRequireComment, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackSuccessMessage, feedbackErrorMessage, feedbackOnFeedback, analytics = false, children }) {
+function DocsPageClient({ tocEnabled, themeName, 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,8 +268,10 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 	const activeLocale = resolveClientLocale(searchParams, locale);
 	const resolvedPublicPath = normalizePublicDocsPath(publicPath, entry);
 	const llmsLangQuery = activeLocale ? `?lang=${encodeURIComponent(activeLocale)}` : "";
-	const pageDescription = description ?? descriptionMap?.[pathname.replace(/\/$/, "") || "/"];
+	const showLlmsInHeader = llmsTxtEnabled && themeName === "fumadocs-pixel-border";
 	const normalizedPath = (browserPathname || pathname).replace(/\/$/, "") || "/";
+	const pageTitle = generatedTitleMap?.[normalizedPath];
+	const pageDescription = description ?? descriptionMap?.[normalizedPath];
 	const isChangelogRoute = !!(changelogBasePath && (normalizedPath === changelogBasePath || normalizedPath.startsWith(`${changelogBasePath}/`)));
 	const matchedReadingTime = readingTimeMap?.[normalizedPath];
 	const structuredDataJson = !isChangelogRoute ? structuredDataProp ?? structuredDataMap?.[normalizedPath] : void 0;
@@ -495,7 +497,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		]
 	}, "below-title") : void 0;
 	const decoratedChildren = children;
-	const needsTitleDecorationsPortal = !!titleDescription || !!belowTitleBlock;
+	const needsTitleDecorationsPortal = !pageTitle && (!!titleDescription || !!belowTitleBlock);
 	useEffect(() => {
 		if (!needsTitleDecorationsPortal) {
 			setTitlePortalHost(null);
@@ -508,19 +510,54 @@ 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
 	}) : null;
 	const titleDecorationsPortal = titleDecorations && titlePortalHost ? createPortal(titleDecorations, titlePortalHost, "title-decorations") : null;
 	const titleDecorationsFallback = titleDecorations && !titlePortalHost ? titleDecorations : null;
+	const generatedPageHeader = pageTitle ? /* @__PURE__ */ jsxs("div", {
+		className: "fd-generated-page-header not-prose",
+		children: [/* @__PURE__ */ jsx("h1", {
+			className: "fd-page-title",
+			children: pageTitle
+		}), /* @__PURE__ */ jsx(TitleDecorations, {
+			description: titleDescription,
+			belowTitle: belowTitleBlock
+		})]
+	}) : 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",
@@ -549,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": showLlmsInHeader ? "true" : void 0,
+			style: showLlmsInHeader ? void 0 : agentLlmsDirectiveStyle,
+			tabIndex: showLlmsInHeader ? void 0 : -1,
+			"aria-hidden": showLlmsInHeader ? void 0 : true,
+			children: showLlmsInHeader ? "LLMS.TXT" : "llms.txt"
 		}, "llms-txt"),
 		titleControlsPortal,
 		tocActionsPortal,
@@ -568,7 +606,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 				style: fdTocStyle
 			},
 			breadcrumb: { enabled: false },
-			footer: { enabled: !isChangelogRoute },
+			footer: { enabled: false },
 			children: [
 				effectiveBreadcrumbEnabled && /* @__PURE__ */ jsx(PathBreadcrumb, {
 					pathname,
@@ -604,11 +642,12 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 						flexDirection: "column"
 					},
 					children: [
+						generatedPageHeader,
 						/* @__PURE__ */ jsx("div", {
 							style: { flex: 1 },
 							children: renderedChildren
 						}, "content"),
-						titleDecorationsFallback,
+						!generatedPageHeader && titleDecorationsFallback,
 						titleDecorationsPortal,
 						!isChangelogRoute && feedbackEnabled && /* @__PURE__ */ jsx(DocsFeedback, {
 							pathname: normalizedPath,

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

@@ -59,6 +59,7 @@ declare const PixelBorderUIDefaults: {
   layout: {
     contentWidth: number;
     sidebarWidth: number;
+    tocWidth: number;
     toc: {
       enabled: boolean;
       depth: number;

package/dist/pixel-border/index.mjs

@@ -29,30 +29,30 @@ const PixelBorderUIDefaults = {
 		},
 		h1: {
 			size: "2.25rem",
-			weight: 700,
-			lineHeight: "1.2",
+			weight: 400,
+			lineHeight: "1.14",
 			letterSpacing: "-0.02em"
 		},
 		h2: {
 			size: "1.5rem",
-			weight: 600,
-			lineHeight: "1.3",
+			weight: 400,
+			lineHeight: "1.24",
 			letterSpacing: "-0.01em"
 		},
 		h3: {
 			size: "1.25rem",
-			weight: 600,
-			lineHeight: "1.4"
+			weight: 400,
+			lineHeight: "1.3"
 		},
 		h4: {
 			size: "1.125rem",
-			weight: 600,
+			weight: 400,
 			lineHeight: "1.4"
 		},
 		body: {
-			size: "1rem",
+			size: "0.975rem",
 			weight: 400,
-			lineHeight: "1.75"
+			lineHeight: "1.8"
 		},
 		small: {
 			size: "0.875rem",
@@ -63,12 +63,13 @@ const PixelBorderUIDefaults = {
 	layout: {
 		contentWidth: 860,
 		sidebarWidth: 286,
+		tocWidth: 240,
 		toc: {
 			enabled: true,
 			depth: 3
 		},
 		header: {
-			height: 56,
+			height: 44,
 			sticky: true
 		}
 	},