@farming-labs/theme 0.0.51 → 0.0.52

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

@@ -0,0 +1,14 @@
+import { CodeBlockCopyData, DocsFeedbackData } from "@farming-labs/docs";
+
+//#region src/docs-client-hooks.d.ts
+type CopyHandler = (data: CodeBlockCopyData) => void;
+type FeedbackHandler = (data: DocsFeedbackData) => void | Promise<void>;
+declare function DocsClientHooks({
+  onCopyClick,
+  onFeedback
+}: {
+  onCopyClick?: CopyHandler;
+  onFeedback?: FeedbackHandler;
+}): null;
+//#endregion
+export { DocsClientHooks };

package/dist/docs-client-hooks.mjs

@@ -0,0 +1,26 @@
+"use client";
+
+import { useEffect } from "react";
+
+//#region src/docs-client-hooks.tsx
+function useWindowHook(key, handler) {
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		if (typeof handler !== "function") return;
+		const target = window;
+		const previous = target[key];
+		target[key] = handler;
+		return () => {
+			if (target[key] === handler) if (typeof previous === "function") target[key] = previous;
+			else delete target[key];
+		};
+	}, [handler, key]);
+}
+function DocsClientHooks({ onCopyClick, onFeedback }) {
+	useWindowHook("__fdOnCopyClick__", onCopyClick);
+	useWindowHook("__fdOnFeedback__", onFeedback);
+	return null;
+}
+
+//#endregion
+export { DocsClientHooks };

package/dist/docs-feedback.d.mts

@@ -0,0 +1,28 @@
+import { DocsFeedbackData } from "@farming-labs/docs";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/docs-feedback.d.ts
+interface DocsFeedbackProps {
+  pathname: string;
+  entry: string;
+  locale?: string;
+  question?: string;
+  placeholder?: string;
+  positiveLabel?: string;
+  negativeLabel?: string;
+  submitLabel?: string;
+  onFeedback?: (data: DocsFeedbackData) => void | Promise<void>;
+}
+declare function DocsFeedback({
+  pathname,
+  entry,
+  locale,
+  question,
+  placeholder,
+  positiveLabel,
+  negativeLabel,
+  submitLabel,
+  onFeedback
+}: DocsFeedbackProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DocsFeedback, DocsFeedbackProps };

package/dist/docs-feedback.mjs

@@ -0,0 +1,210 @@
+"use client";
+
+import { useEffect, useMemo, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/docs-feedback.tsx
+function normalizePathname(pathname) {
+	return pathname.replace(/\/$/, "") || "/";
+}
+function resolveSlug(entry, pathname) {
+	const entryParts = entry.split("/").filter(Boolean);
+	const pathParts = pathname.split("/").filter(Boolean);
+	return (pathParts.slice(0, entryParts.length).join("/") === entryParts.join("/") ? pathParts.slice(entryParts.length) : pathParts).join("/");
+}
+function readTextContent(selector) {
+	if (typeof document === "undefined") return void 0;
+	const text = document.querySelector(selector)?.textContent?.trim();
+	return text && text.length > 0 ? text : void 0;
+}
+async function emitFeedback(data, onFeedback) {
+	let firstError;
+	try {
+		await onFeedback?.(data);
+	} catch (error) {
+		firstError ??= error;
+	}
+	if (typeof window === "undefined") {
+		if (firstError) throw firstError;
+		return;
+	}
+	try {
+		await window.__fdOnFeedback__?.(data);
+	} catch (error) {
+		firstError ??= error;
+	}
+	window.dispatchEvent(new CustomEvent("fd:feedback", { detail: data }));
+	if (firstError) throw firstError;
+}
+function buildFeedbackPayload(value, pathname, entry, comment, locale) {
+	const normalizedPathname = normalizePathname(pathname);
+	return {
+		value,
+		comment: comment?.trim() ? comment.trim() : void 0,
+		title: readTextContent(".fd-page-title, h1"),
+		description: readTextContent(".fd-page-description"),
+		url: typeof window !== "undefined" ? window.location.href : normalizedPathname,
+		pathname: normalizedPathname,
+		path: normalizedPathname,
+		entry,
+		slug: resolveSlug(entry, normalizedPathname),
+		locale
+	};
+}
+function ThumbUpIcon() {
+	return /* @__PURE__ */ jsx("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		"aria-hidden": "true",
+		children: /* @__PURE__ */ jsx("path", {
+			d: "M7 21H5a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2h2m0 11V10m0 11h9.28a2 2 0 0 0 1.97-1.66l1.2-7A2 2 0 0 0 17.48 10H13V6.5a2.5 2.5 0 0 0-2.5-2.5L7 10",
+			stroke: "currentColor",
+			strokeWidth: "2",
+			strokeLinecap: "round",
+			strokeLinejoin: "round"
+		})
+	});
+}
+function ThumbDownIcon() {
+	return /* @__PURE__ */ jsx("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		"aria-hidden": "true",
+		children: /* @__PURE__ */ jsx("path", {
+			d: "M17 3h2a2 2 0 0 1 2 2v7a2 2 0 0 1-2 2h-2M17 3v11m0-11H7.72a2 2 0 0 0-1.97 1.66l-1.2 7A2 2 0 0 0 6.52 14H11v3.5a2.5 2.5 0 0 0 2.5 2.5L17 14",
+			stroke: "currentColor",
+			strokeWidth: "2",
+			strokeLinecap: "round",
+			strokeLinejoin: "round"
+		})
+	});
+}
+function CheckIcon() {
+	return /* @__PURE__ */ jsx("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		"aria-hidden": "true",
+		children: /* @__PURE__ */ jsx("path", {
+			d: "M20 6 9 17l-5-5",
+			stroke: "currentColor",
+			strokeWidth: "2",
+			strokeLinecap: "round",
+			strokeLinejoin: "round"
+		})
+	});
+}
+function DocsFeedback({ pathname, entry, locale, question = "How is this guide?", placeholder = "Leave your feedback...", positiveLabel = "Good", negativeLabel = "Bad", submitLabel = "Submit", onFeedback }) {
+	const [selected, setSelected] = useState(null);
+	const [comment, setComment] = useState("");
+	const [status, setStatus] = useState("idle");
+	const normalizedPathname = useMemo(() => normalizePathname(pathname), [pathname]);
+	const showForm = selected !== null;
+	useEffect(() => {
+		setSelected(null);
+		setComment("");
+		setStatus("idle");
+	}, [normalizedPathname]);
+	function handleSelect(value) {
+		setSelected(value);
+		if (status !== "idle") setStatus("idle");
+	}
+	async function handleSubmit() {
+		if (!selected || status === "submitting") return;
+		setStatus("submitting");
+		try {
+			await emitFeedback(buildFeedbackPayload(selected, normalizedPathname, entry, comment, locale), onFeedback);
+			setStatus("submitted");
+		} catch {
+			setStatus("error");
+		}
+	}
+	return /* @__PURE__ */ jsxs("section", {
+		className: "fd-feedback not-prose",
+		"aria-label": "Page feedback",
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "fd-feedback-content",
+			children: [/* @__PURE__ */ jsx("p", {
+				className: "fd-feedback-question",
+				children: question
+			}), /* @__PURE__ */ jsxs("div", {
+				className: "fd-feedback-actions",
+				role: "group",
+				"aria-label": question,
+				children: [/* @__PURE__ */ jsxs("button", {
+					type: "button",
+					className: "fd-page-action-btn fd-feedback-choice",
+					"aria-pressed": selected === "positive",
+					"data-selected": selected === "positive" ? "true" : void 0,
+					"data-feedback-value": "positive",
+					disabled: status === "submitting",
+					onClick: () => handleSelect("positive"),
+					children: [/* @__PURE__ */ jsx(ThumbUpIcon, {}), /* @__PURE__ */ jsx("span", { children: positiveLabel })]
+				}), /* @__PURE__ */ jsxs("button", {
+					type: "button",
+					className: "fd-page-action-btn fd-feedback-choice",
+					"aria-pressed": selected === "negative",
+					"data-selected": selected === "negative" ? "true" : void 0,
+					"data-feedback-value": "negative",
+					disabled: status === "submitting",
+					onClick: () => handleSelect("negative"),
+					children: [/* @__PURE__ */ jsx(ThumbDownIcon, {}), /* @__PURE__ */ jsx("span", { children: negativeLabel })]
+				})]
+			})]
+		}), showForm && /* @__PURE__ */ jsxs("div", {
+			className: "fd-feedback-form",
+			children: [
+				/* @__PURE__ */ jsx("textarea", {
+					id: "fd-feedback-comment",
+					className: "fd-feedback-input",
+					"aria-label": "Additional feedback",
+					placeholder,
+					value: comment,
+					disabled: status === "submitting",
+					onChange: (event) => {
+						setComment(event.target.value);
+						if (status !== "idle") setStatus("idle");
+					}
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "fd-feedback-submit-row",
+					children: [/* @__PURE__ */ jsxs("button", {
+						type: "button",
+						className: "fd-page-action-btn fd-feedback-submit",
+						disabled: status === "submitting" || status === "submitted",
+						onClick: () => void handleSubmit(),
+						children: [
+							status === "submitting" && /* @__PURE__ */ jsx("span", {
+								className: "fd-feedback-spinner",
+								"aria-hidden": "true"
+							}),
+							status === "submitted" && /* @__PURE__ */ jsx(CheckIcon, {}),
+							/* @__PURE__ */ jsx("span", { children: status === "submitted" ? "Submitted" : submitLabel })
+						]
+					}), status === "submitted" && /* @__PURE__ */ jsx("p", {
+						className: "fd-feedback-status",
+						"data-status": "success",
+						role: "status",
+						"aria-live": "polite",
+						children: "Thanks for the feedback."
+					})]
+				}),
+				status === "error" && /* @__PURE__ */ jsx("p", {
+					className: "fd-feedback-status",
+					"data-status": "error",
+					role: "status",
+					"aria-live": "polite",
+					children: "Could not send feedback. Please try again."
+				})
+			]
+		})]
+	});
+}
+
+//#endregion
+export { DocsFeedback };

package/dist/docs-layout.mjs

@@ -466,6 +466,7 @@ function createDocsLayout(config, options) {
 	const lastUpdatedEnabled = lastUpdatedRaw !== false && (typeof lastUpdatedRaw !== "object" || lastUpdatedRaw.enabled !== false);
 	const lastUpdatedPosition = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.position ?? "footer" : "footer";
 	const llmsTxtEnabled = resolveBool(config.llmsTxt);
+	const feedbackConfig = resolveFeedbackConfig(config.feedback);
 	const openDocsProviders = (typeof pageActions?.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((p) => ({
 		name: p.name,
 		urlTemplate: p.urlTemplate,
@@ -589,6 +590,12 @@ function createDocsLayout(config, options) {
 							lastUpdatedPosition,
 							llmsTxtEnabled,
 							descriptionMap,
+							feedbackEnabled: feedbackConfig.enabled,
+							feedbackQuestion: feedbackConfig.question,
+							feedbackPlaceholder: feedbackConfig.placeholder,
+							feedbackPositiveLabel: feedbackConfig.positiveLabel,
+							feedbackNegativeLabel: feedbackConfig.negativeLabel,
+							feedbackSubmitLabel: feedbackConfig.submitLabel,
 							children
 						})
 					})
@@ -603,6 +610,29 @@ function resolveBool(v) {
 	if (typeof v === "boolean") return v;
 	return v.enabled !== false;
 }
+function resolveFeedbackConfig(feedback) {
+	const defaults = {
+		enabled: false,
+		question: "How is this guide?",
+		placeholder: "Leave your feedback...",
+		positiveLabel: "Good",
+		negativeLabel: "Bad",
+		submitLabel: "Submit"
+	};
+	if (feedback === void 0 || feedback === false) return defaults;
+	if (feedback === true) return {
+		...defaults,
+		enabled: true
+	};
+	return {
+		enabled: feedback.enabled !== false,
+		question: feedback.question ?? defaults.question,
+		placeholder: feedback.placeholder ?? defaults.placeholder,
+		positiveLabel: feedback.positiveLabel ?? defaults.positiveLabel,
+		negativeLabel: feedback.negativeLabel ?? defaults.negativeLabel,
+		submitLabel: feedback.submitLabel ?? defaults.submitLabel
+	};
+}
 /**
 * Tiny inline script to force a theme when the toggle is hidden.
 * Sets the class on <html> before React hydrates to avoid FOUC.

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

@@ -1,4 +1,5 @@
 import { ReactNode } from "react";
+import { DocsFeedbackData } from "@farming-labs/docs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/docs-page-client.d.ts
@@ -47,6 +48,14 @@ interface DocsPageClientProps {
   descriptionMap?: Record<string, string>;
   /** Frontmatter description to display below the page title (overrides descriptionMap) */
   description?: string;
+  /** Built-in page feedback prompt configuration */
+  feedbackEnabled?: boolean;
+  feedbackQuestion?: string;
+  feedbackPlaceholder?: string;
+  feedbackPositiveLabel?: string;
+  feedbackNegativeLabel?: string;
+  feedbackSubmitLabel?: string;
+  feedbackOnFeedback?: (data: DocsFeedbackData) => void | Promise<void>;
   children: ReactNode;
 }
 declare function DocsPageClient({
@@ -72,6 +81,13 @@ declare function DocsPageClient({
   llmsTxtEnabled,
   descriptionMap,
   description,
+  feedbackEnabled,
+  feedbackQuestion,
+  feedbackPlaceholder,
+  feedbackPositiveLabel,
+  feedbackNegativeLabel,
+  feedbackSubmitLabel,
+  feedbackOnFeedback,
   children
 }: DocsPageClientProps): react_jsx_runtime0.JSX.Element;
 //#endregion

package/dist/docs-page-client.mjs

@@ -2,6 +2,7 @@
 
 import { PageActions } from "./page-actions.mjs";
 import { useWindowSearchParams } from "./client-location.mjs";
+import { DocsFeedback } from "./docs-feedback.mjs";
 import { resolveClientLocale, withLangInUrl } from "./i18n.mjs";
 import { Children, cloneElement, isValidElement, useEffect, useState } from "react";
 import { DocsBody, DocsPage, EditOnGitHub } from "fumadocs-ui/layouts/docs/page";
@@ -119,7 +120,7 @@ function injectTitleDecorations(node, { description, belowTitle }) {
 	});
 	return visit(node);
 }
-function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, entry = "docs", locale, copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, children }) {
+function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, entry = "docs", locale, copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackOnFeedback, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const pathname = usePathname();
@@ -219,35 +220,49 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 					display: "flex",
 					flexDirection: "column"
 				},
-				children: [/* @__PURE__ */ jsx("div", {
-					style: { flex: 1 },
-					children: decoratedChildren
-				}), showFooter && /* @__PURE__ */ jsxs("div", {
-					className: "not-prose fd-page-footer",
-					children: [
-						githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }),
-						llmsTxtEnabled && /* @__PURE__ */ jsxs("span", {
-							className: "fd-llms-txt-links",
-							children: [/* @__PURE__ */ jsx("a", {
-								href: `/api/docs?format=llms${llmsLangParam}`,
-								target: "_blank",
-								rel: "noopener noreferrer",
-								className: "fd-llms-txt-link",
-								children: "llms.txt"
-							}), /* @__PURE__ */ jsx("a", {
-								href: `/api/docs?format=llms-full${llmsLangParam}`,
-								target: "_blank",
-								rel: "noopener noreferrer",
-								className: "fd-llms-txt-link",
-								children: "llms-full.txt"
-							})]
-						}),
-						showLastUpdatedInFooter && lastModified && /* @__PURE__ */ jsxs("span", {
-							className: "fd-last-updated-footer",
-							children: ["Last updated ", lastModified]
-						})
-					]
-				})]
+				children: [
+					/* @__PURE__ */ jsx("div", {
+						style: { flex: 1 },
+						children: decoratedChildren
+					}),
+					feedbackEnabled && /* @__PURE__ */ jsx(DocsFeedback, {
+						pathname: normalizedPath,
+						entry,
+						locale: activeLocale,
+						question: feedbackQuestion,
+						placeholder: feedbackPlaceholder,
+						positiveLabel: feedbackPositiveLabel,
+						negativeLabel: feedbackNegativeLabel,
+						submitLabel: feedbackSubmitLabel,
+						onFeedback: feedbackOnFeedback
+					}),
+					showFooter && /* @__PURE__ */ jsxs("div", {
+						className: "not-prose fd-page-footer",
+						children: [
+							githubFileUrl && /* @__PURE__ */ jsx(EditOnGitHub, { href: githubFileUrl }),
+							llmsTxtEnabled && /* @__PURE__ */ jsxs("span", {
+								className: "fd-llms-txt-links",
+								children: [/* @__PURE__ */ jsx("a", {
+									href: `/api/docs?format=llms${llmsLangParam}`,
+									target: "_blank",
+									rel: "noopener noreferrer",
+									className: "fd-llms-txt-link",
+									children: "llms.txt"
+								}), /* @__PURE__ */ jsx("a", {
+									href: `/api/docs?format=llms-full${llmsLangParam}`,
+									target: "_blank",
+									rel: "noopener noreferrer",
+									className: "fd-llms-txt-link",
+									children: "llms-full.txt"
+								})]
+							}),
+							showLastUpdatedInFooter && lastModified && /* @__PURE__ */ jsxs("span", {
+								className: "fd-last-updated-footer",
+								children: ["Last updated ", lastModified]
+							})
+						]
+					})
+				]
 			})
 		]
 	});

package/dist/index.d.mts

@@ -3,12 +3,14 @@ import { DocsCommandSearch } from "./docs-command-search.mjs";
 import { createDocsLayout, createDocsMetadata, createPageMetadata } from "./docs-layout.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { RootProvider } from "./provider.mjs";
+import { DocsClientHooks } from "./docs-client-hooks.mjs";
+import { DocsFeedback, DocsFeedbackProps } from "./docs-feedback.mjs";
 import { PageActions } from "./page-actions.mjs";
 import { withLangInUrl } from "./i18n.mjs";
 import { HoverLink, HoverLinkProps } from "./hover-link.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
-import { AIConfig, BreadcrumbConfig, CopyMarkdownConfig, DocsConfig, DocsMetadata, DocsNav, DocsTheme, FontStyle, OGConfig, OpenDocsConfig, OpenDocsProvider, PageActionsConfig, PageFrontmatter, SidebarConfig, ThemeToggleConfig, TypographyConfig, UIConfig, createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
+import { AIConfig, BreadcrumbConfig, CopyMarkdownConfig, DocsConfig, DocsFeedbackData, DocsFeedbackValue, DocsMetadata, DocsNav, DocsTheme, FeedbackConfig, FontStyle, OGConfig, OpenDocsConfig, OpenDocsProvider, PageActionsConfig, PageFrontmatter, SidebarConfig, ThemeToggleConfig, TypographyConfig, UIConfig, createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
 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, type BreadcrumbConfig, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, type CopyMarkdownConfig, DocsBody, DocsCommandSearch, type DocsConfig, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, HoverLink, type HoverLinkProps, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, withLangInUrl };
+export { type AIConfig, type BreadcrumbConfig, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, 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, HoverLink, type HoverLinkProps, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, withLangInUrl };

package/dist/index.mjs

@@ -1,10 +1,12 @@
 import { PageActions } from "./page-actions.mjs";
+import { DocsFeedback } from "./docs-feedback.mjs";
 import { withLangInUrl } from "./i18n.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { DocsCommandSearch } from "./docs-command-search.mjs";
 import { createDocsLayout, createDocsMetadata, createPageMetadata } from "./docs-layout.mjs";
 import { RootProvider } from "./provider.mjs";
 import { DefaultUIDefaults, fumadocs } from "./default/index.mjs";
+import { DocsClientHooks } from "./docs-client-hooks.mjs";
 import { HoverLink } from "./hover-link.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import { createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
@@ -12,4 +14,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 { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, DocsBody, DocsCommandSearch, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, HoverLink, PageActions, Pre, RootProvider, Tab, Tabs, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, withLangInUrl };
+export { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, DocsBody, DocsClientHooks, DocsCommandSearch, DocsFeedback, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, HoverLink, PageActions, Pre, RootProvider, Tab, Tabs, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, withLangInUrl };

package/dist/tanstack-layout.mjs

@@ -178,6 +178,29 @@ function resolveBool(value) {
 	if (typeof value === "boolean") return value;
 	return value.enabled !== false;
 }
+function resolveFeedbackConfig(feedback) {
+	const defaults = {
+		enabled: false,
+		question: "How is this guide?",
+		placeholder: "Leave your feedback...",
+		positiveLabel: "Good",
+		negativeLabel: "Bad",
+		submitLabel: "Submit"
+	};
+	if (feedback === void 0 || feedback === false) return defaults;
+	if (feedback === true) return {
+		...defaults,
+		enabled: true
+	};
+	return {
+		enabled: feedback.enabled !== false,
+		question: feedback.question ?? defaults.question,
+		placeholder: feedback.placeholder ?? defaults.placeholder,
+		positiveLabel: feedback.positiveLabel ?? defaults.positiveLabel,
+		negativeLabel: feedback.negativeLabel ?? defaults.negativeLabel,
+		submitLabel: feedback.submitLabel ?? defaults.submitLabel
+	};
+}
 function ForcedThemeScript({ theme }) {
 	return /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: `document.documentElement.classList.remove('light','dark');document.documentElement.classList.add('${theme === "light" || theme === "dark" ? theme : "light"}');` } });
 }
@@ -209,6 +232,7 @@ function TanstackDocsLayout({ config, tree, locale, description, lastModified, e
 	const lastUpdatedEnabled = lastUpdatedRaw !== false && (typeof lastUpdatedRaw !== "object" || lastUpdatedRaw.enabled !== false);
 	const lastUpdatedPosition = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.position ?? "footer" : "footer";
 	const llmsTxtEnabled = resolveBool(config.llmsTxt);
+	const feedbackConfig = resolveFeedbackConfig(config.feedback);
 	const staticExport = !!config.staticExport;
 	const openDocsProviders = (typeof pageActions?.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((provider) => ({
 		name: provider.name,
@@ -316,6 +340,12 @@ function TanstackDocsLayout({ config, tree, locale, description, lastModified, e
 						lastModified,
 						llmsTxtEnabled,
 						description,
+						feedbackEnabled: feedbackConfig.enabled,
+						feedbackQuestion: feedbackConfig.question,
+						feedbackPlaceholder: feedbackConfig.placeholder,
+						feedbackPositiveLabel: feedbackConfig.positiveLabel,
+						feedbackNegativeLabel: feedbackConfig.negativeLabel,
+						feedbackSubmitLabel: feedbackConfig.submitLabel,
 						children
 					})
 				})

package/dist/tanstack.d.mts

@@ -1,3 +1,4 @@
+import { DocsClientHooks } from "./docs-client-hooks.mjs";
 import { RootProvider } from "./provider-tanstack.mjs";
 import { TanstackDocsLayout } from "./tanstack-layout.mjs";
-export { RootProvider, TanstackDocsLayout };
+export { DocsClientHooks, RootProvider, TanstackDocsLayout };

package/dist/tanstack.mjs

@@ -1,4 +1,5 @@
+import { DocsClientHooks } from "./docs-client-hooks.mjs";
 import { RootProvider } from "./provider-tanstack.mjs";
 import { TanstackDocsLayout } from "./tanstack-layout.mjs";
 
-export { RootProvider, TanstackDocsLayout };
+export { DocsClientHooks, RootProvider, TanstackDocsLayout };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.0.51",
+  "version": "0.0.52",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -28,6 +28,11 @@
       "import": "./dist/mdx.mjs",
       "default": "./dist/mdx.mjs"
     },
+    "./client-hooks": {
+      "types": "./dist/docs-client-hooks.d.mts",
+      "import": "./dist/docs-client-hooks.mjs",
+      "default": "./dist/docs-client-hooks.mjs"
+    },
     "./default": {
       "types": "./dist/default/index.d.mts",
       "import": "./dist/default/index.mjs",
@@ -110,7 +115,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.0.51"
+    "@farming-labs/docs": "0.0.52"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",

package/styles/base.css

@@ -307,11 +307,20 @@ figure.shiki:has(figcaption) figcaption {
   color: var(--color-fd-foreground);
 }
 
+.fd-page-action-btn[data-selected="true"] {
+  color: var(--color-fd-accent-foreground);
+  background: var(--color-fd-accent);
+}
+
 .fd-page-action-btn svg {
   flex-shrink: 0;
   color: var(--color-fd-muted-foreground);
 }
 
+.fd-page-action-btn[data-selected="true"] svg {
+  color: currentColor;
+}
+
 /* ─── Open dropdown ─────────────────────────────────────────────────── */
 
 .fd-page-action-dropdown {
@@ -388,6 +397,125 @@ figure.shiki:has(figcaption) figcaption {
   flex: 1;
 }
 
+/* ─── Docs Feedback ────────────────────────────────────────────────── */
+
+.fd-feedback {
+  margin-top: 2rem;
+  margin-bottom: 1.25rem;
+  padding-top: 1.25rem;
+  border-top: 1px solid var(--color-fd-border, hsl(0 0% 80% / 50%));
+}
+
+.fd-feedback-content {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  flex-wrap: wrap;
+}
+
+.fd-feedback-question {
+  margin: 0;
+  font-size: 0.9375rem;
+  font-weight: 600;
+  line-height: 1.5;
+  color: var(--color-fd-foreground);
+}
+
+.fd-feedback-actions {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  flex-wrap: wrap;
+}
+
+.fd-feedback-form {
+  display: flex;
+  flex-direction: column;
+  gap: 0.75rem;
+  margin-top: 0.875rem;
+}
+
+.fd-feedback-choice[data-selected="true"] {
+  background: var(--color-fd-accent, hsl(0 0% 96%));
+  color: var(--color-fd-foreground);
+  border-color: var(--color-fd-primary, currentColor);
+}
+
+.fd-feedback-input {
+  width: 100%;
+  min-height: 4.75rem;
+  resize: vertical;
+  padding: 0.875rem 1rem;
+  border: 1px solid var(--color-fd-border, hsl(0 0% 80% / 50%));
+  background: var(--color-fd-card, transparent);
+  color: var(--color-fd-foreground);
+  font: inherit;
+  line-height: 1.55;
+  outline: none;
+  transition:
+    border-color 150ms ease,
+    box-shadow 150ms ease,
+    background-color 150ms ease;
+}
+
+.fd-feedback-input::placeholder {
+  color: var(--color-fd-muted-foreground, hsl(0 0% 45%));
+}
+
+.fd-feedback-input:focus {
+  border-color: var(--color-fd-ring, var(--color-fd-primary, currentColor));
+  box-shadow: 0 0 0 1px var(--color-fd-ring, var(--color-fd-primary, currentColor));
+}
+
+.fd-feedback-submit-row {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  flex-wrap: wrap;
+}
+
+.fd-feedback-submit {
+  min-width: 7rem;
+  justify-content: center;
+}
+
+.fd-feedback-submit:disabled {
+  cursor: not-allowed;
+  opacity: 0.65;
+}
+
+.fd-feedback-spinner {
+  width: 0.875rem;
+  height: 0.875rem;
+  border-radius: 9999px;
+  border: 2px solid currentColor;
+  border-right-color: transparent;
+  animation: fd-feedback-spin 0.8s linear infinite;
+}
+
+.fd-feedback-status {
+  margin: 0;
+  font-size: 0.8125rem;
+  color: var(--color-fd-muted-foreground, hsl(0 0% 45%));
+}
+
+.fd-feedback-status[data-status="success"] {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+}
+
+.fd-feedback-status[data-status="error"] {
+  color: var(--color-fd-foreground);
+}
+
+@keyframes fd-feedback-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
 /* ─── Page Footer (Edit on GitHub + Last Updated) ──────────────────── */
 
 .fd-page-footer {
@@ -413,6 +541,11 @@ figure.shiki:has(figcaption) figcaption {
 }
 
 @media (max-width: 640px) {
+  .fd-feedback-content {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
   .fd-last-updated-footer {
     margin-left: 0;
     width: 100%;

package/styles/colorful.css

@@ -382,3 +382,18 @@
 .omni-search-input:focus {
   caret-color: var(--color-fd-primary);
 }
+
+/* ─── Feedback (colorful theme) ──────────────────────────────────── */
+
+.fd-feedback-input,
+.fd-feedback-submit {
+  border-radius: 0.5rem;
+}
+
+.fd-feedback-choice[data-selected="true"] {
+  background: color-mix(in srgb, var(--color-fd-primary) 12%, var(--color-fd-secondary));
+}
+
+.fd-feedback-status[data-status="success"] {
+  color: var(--color-fd-primary);
+}

package/styles/darkbold.css

@@ -573,3 +573,21 @@ details > :not(summary) {
 .fd-sidebar::-webkit-scrollbar-track {
   background: transparent;
 }
+
+/* ─── Feedback (darkbold theme) ──────────────────────────────────── */
+
+.fd-feedback-input,
+.fd-feedback-submit {
+  border-radius: 6px;
+}
+
+.fd-feedback-submit,
+.fd-feedback-choice {
+  text-transform: uppercase;
+  font-family: var(--fd-font-mono, var(--font-geist-mono, ui-monospace, monospace));
+}
+
+.fd-feedback-status[data-status="success"] {
+  color: var(--color-fd-foreground);
+  font-weight: 600;
+}

package/styles/darksharp.css

@@ -464,3 +464,22 @@ article a[class*="text-fd-muted-foreground"] {
 .omni-highlight {
   background: color-mix(in srgb, var(--color-fd-primary) 30%, transparent);
 }
+
+/* ─── Feedback (darksharp theme) ─────────────────────────────────── */
+
+.fd-feedback-input,
+.fd-feedback-submit {
+  border-radius: 0.2rem;
+}
+
+.fd-feedback-input {
+  background: hsl(0 0% 4%);
+}
+
+.fd-feedback-choice[data-selected="true"] {
+  background: hsl(0 0% 8%);
+}
+
+.fd-feedback-status[data-status="success"] {
+  color: hsl(0 0% 90%);
+}

package/styles/default.css

@@ -231,3 +231,14 @@
 .omni-highlight {
   background: color-mix(in srgb, var(--color-fd-primary, #6366f1) 25%, transparent);
 }
+
+/* ─── Feedback (default theme) ───────────────────────────────────── */
+
+.fd-feedback-input,
+.fd-feedback-submit {
+  border-radius: 0.5rem;
+}
+
+.fd-feedback-status[data-status="success"] {
+  color: color-mix(in srgb, var(--color-fd-primary) 85%, var(--color-fd-foreground));
+}

package/styles/greentree.css

@@ -760,4 +760,19 @@ details > :not(summary) {
   padding: 6px 10px;
   border: none;
   border-radius: var(--radius, 8px) !important;
-}
+}
+
+/* ─── Feedback (greentree theme) ─────────────────────────────────── */
+
+.fd-feedback-input,
+.fd-feedback-submit {
+  border-radius: 0.75rem;
+}
+
+.fd-feedback-choice[data-selected="true"] {
+  background: color-mix(in srgb, var(--color-fd-primary) 12%, var(--color-fd-secondary));
+}
+
+.fd-feedback-status[data-status="success"] {
+  color: var(--color-fd-primary);
+}

package/styles/pixel-border.css

@@ -885,3 +885,20 @@ hr {
   background: color-mix(in srgb, var(--color-fd-primary, #6366f1) 25%, transparent);
   border-radius: 0 !important;
 }
+
+/* ─── Feedback (pixel-border theme) ──────────────────────────────── */
+
+.fd-feedback-input,
+.fd-feedback-submit {
+  border-radius: 0 !important;
+  box-shadow: 3px 3px 0 0 var(--color-fd-border);
+}
+
+.fd-feedback-choice[data-selected="true"] {
+  background: var(--color-fd-secondary);
+}
+
+.fd-feedback-status[data-status="success"] {
+  font-family: var(--fd-font-mono, var(--font-geist-mono, ui-monospace, monospace));
+  text-transform: uppercase;
+}

package/styles/shiny.css

@@ -624,3 +624,27 @@ details > :not(summary) {
 .fd-sidebar::-webkit-scrollbar-track {
   background: transparent;
 }
+
+/* ─── Feedback (shiny theme) ─────────────────────────────────────── */
+
+.fd-feedback-input,
+.fd-feedback-submit {
+  border-radius: 0.75rem;
+}
+
+.fd-feedback-input {
+  background: color-mix(in srgb, var(--color-fd-card) 92%, transparent);
+  box-shadow:
+    inset 0 1px 0 rgba(255, 255, 255, 0.06),
+    0 1px 2px rgba(0, 0, 0, 0.04);
+}
+
+.dark .fd-feedback-input {
+  box-shadow:
+    inset 0 1px 0 rgba(255, 255, 255, 0.04),
+    0 6px 18px rgba(0, 0, 0, 0.18);
+}
+
+.fd-feedback-status[data-status="success"] {
+  color: var(--color-fd-primary);
+}