@farming-labs/theme 0.1.58 → 0.1.60

package/dist/ai-search-dialog.mjs

@@ -2,7 +2,7 @@
 
 import { useCallback, useEffect, useRef, useState } from "react";
 import { createPortal } from "react-dom";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { highlight } from "sugar-high";
 
 //#region src/ai-search-dialog.tsx
@@ -635,7 +635,7 @@ function DocsSearchDialog({ open, onOpenChange, api = "/api/docs", suggestedQues
 	};
 	if (!open) return null;
 	const aiName = aiLabel || "AI";
-	return createPortal(/* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("div", {
+	return createPortal(/* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("div", {
 		onClick: () => onOpenChange(false),
 		className: "fd-ai-overlay"
 	}), /* @__PURE__ */ jsxs("div", {
@@ -863,7 +863,7 @@ function FloatingAIChat({ api = "/api/docs", position = "bottom-right", floating
 	const isModal = floatingStyle === "modal";
 	const containerStyles = getContainerStyles(floatingStyle, position);
 	const aiName = aiLabel || "AI";
-	return createPortal(/* @__PURE__ */ jsxs(Fragment, { children: [
+	return createPortal(/* @__PURE__ */ jsxs(Fragment$1, { children: [
 		isOpen && isModal && /* @__PURE__ */ jsx("div", {
 			onClick: () => setIsOpen(false),
 			className: "fd-ai-overlay"
@@ -1030,7 +1030,7 @@ function FullModalAIChat({ api, isOpen, setIsOpen, messages, setMessages, aiInpu
 			if (canSend) submitQuestion(aiInput);
 		}
 	};
-	return createPortal(/* @__PURE__ */ jsxs(Fragment, { children: [isOpen && /* @__PURE__ */ jsxs("div", {
+	return createPortal(/* @__PURE__ */ jsxs(Fragment$1, { children: [isOpen && /* @__PURE__ */ jsxs("div", {
 		className: "fd-ai-fm-overlay",
 		onClick: (e) => {
 			if (e.target === e.currentTarget) setIsOpen(false);
@@ -1186,7 +1186,7 @@ function AIModalDialog({ open, onOpenChange, api = "/api/docs", suggestedQuestio
 	}, [open]);
 	if (!open) return null;
 	const aiName = aiLabel || "AI";
-	return createPortal(/* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("div", {
+	return createPortal(/* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("div", {
 		onClick: () => onOpenChange(false),
 		className: "fd-ai-overlay"
 	}), /* @__PURE__ */ jsxs("div", {

package/dist/docs-ai-features.mjs

@@ -4,7 +4,7 @@ import { useWindowSearchParams } from "./client-location.mjs";
 import { resolveClientLocale, withLangInUrl } from "./i18n.mjs";
 import { AIModalDialog, DocsSearchDialog, FloatingAIChat } from "./ai-search-dialog.mjs";
 import { useEffect, useState } from "react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/docs-ai-features.tsx
 /**
@@ -124,7 +124,7 @@ function SidebarIconModeAI({ api, suggestedQuestions, aiLabel, loaderVariant, lo
 			window.removeEventListener("fd-open-ai", onAI);
 		};
 	}, []);
-	return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(DocsSearchDialog, {
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(DocsSearchDialog, {
 		open: searchOpen,
 		onOpenChange: setSearchOpen,
 		api,

package/dist/docs-command-search.mjs

@@ -4,7 +4,7 @@ import { useWindowSearchParams } from "./client-location.mjs";
 import { resolveClientLocale, withLangInUrl } from "./i18n.mjs";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/docs-command-search.tsx
 function cn(...classes) {
@@ -56,7 +56,7 @@ function fuzzyScore(query, text) {
 	};
 }
 function HighlightedLabel({ label, indices }) {
-	if (!indices.length) return /* @__PURE__ */ jsx(Fragment, { children: label });
+	if (!indices.length) return /* @__PURE__ */ jsx(Fragment$1, { children: label });
 	const out = [];
 	for (let pos = 0; pos < label.length; pos++) if (indices.includes(pos)) {
 		let run = label[pos];
@@ -71,7 +71,7 @@ function HighlightedLabel({ label, indices }) {
 		}, `m-${pos}`));
 		pos = p - 1;
 	} else out.push(/* @__PURE__ */ jsx("span", { children: label[pos] }, `t-${pos}`));
-	return /* @__PURE__ */ jsx(Fragment, { children: out });
+	return /* @__PURE__ */ jsx(Fragment$1, { children: out });
 }
 function SearchIcon() {
 	return /* @__PURE__ */ jsxs("svg", {
@@ -492,7 +492,7 @@ function DocsCommandSearch({ api = "/api/docs", locale }) {
 	}
 	if (!mounted || !open) return null;
 	const allItems = [...recentItems, ...displayItems];
-	return createPortal(/* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("div", {
+	return createPortal(/* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("div", {
 		className: "omni-overlay",
 		onClick: () => setOpen(false)
 	}), /* @__PURE__ */ jsxs("div", {

package/dist/docs-layout.mjs

@@ -587,7 +587,7 @@ function createDocsLayout(config, options) {
 	const readingTimeWordsPerMinute = readingTimeOptions.wordsPerMinute ?? 220;
 	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) => ({
+	const openDocsProviders = (pageActions?.openDocs && typeof pageActions.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((p) => ({
 		name: p.name,
 		urlTemplate: p.urlTemplate,
 		iconHtml: p.icon ? serializeIcon(p.icon) : void 0

package/dist/docs-page-client.mjs

@@ -4,11 +4,11 @@ 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 { Children, Fragment, cloneElement, isValidElement, useEffect, useState } from "react";
 import { DocsBody, DocsPage, EditOnGitHub } from "fumadocs-ui/layouts/docs/page";
 import { createPortal } from "react-dom";
 import { usePathname, useRouter } from "fumadocs-core/framework";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/docs-page-client.tsx
 /**
@@ -124,6 +124,7 @@ function injectTitleDecorations(node, { description, belowTitle }) {
 		node,
 		inserted: false
 	};
+	const insertedExtras = extras.map((extra, index) => /* @__PURE__ */ jsx(Fragment, { children: extra }, `fd-title-decoration-${index}`));
 	function visit(current) {
 		if (current == null || typeof current === "boolean") return current;
 		if (inserted) return current;
@@ -134,7 +135,7 @@ function injectTitleDecorations(node, { description, belowTitle }) {
 		if (!isValidElement(current)) return current;
 		if (typeof current.type === "string" && current.type === "h1") {
 			inserted = true;
-			return Children.toArray([current, ...extras]);
+			return /* @__PURE__ */ jsxs(Fragment, { children: [current, insertedExtras] }, "fd-title-decoration-block");
 		}
 		const childProps = current.props ?? null;
 		if (childProps?.children === void 0) return current;
@@ -159,7 +160,7 @@ function injectTitleDecorations(node, { description, belowTitle }) {
 }
 function TitleDecorations({ description, belowTitle }) {
 	if (!description && !belowTitle) return null;
-	return /* @__PURE__ */ jsx(Fragment, { children: Children.toArray([description, belowTitle].filter(Boolean)) });
+	return /* @__PURE__ */ jsx(Fragment$1, { children: Children.toArray([description, belowTitle].filter(Boolean)) });
 }
 function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", locale, copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackOnFeedback, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
@@ -318,6 +319,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		description: titleDescription,
 		belowTitle: belowTitleBlock
 	}), titlePortalHost) : null;
+	const renderedChildren = Children.toArray(decoratedChildren);
 	return /* @__PURE__ */ jsxs(DocsPage, {
 		full: false,
 		toc,
@@ -360,7 +362,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 				children: [
 					/* @__PURE__ */ jsx("div", {
 						style: { flex: 1 },
-						children: decoratedChildren
+						children: renderedChildren
 					}),
 					titleDecorationsPortal,
 					!isChangelogRoute && feedbackEnabled && /* @__PURE__ */ jsx(DocsFeedback, {

package/dist/index.d.mts

@@ -11,10 +11,11 @@ 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 { Prompt, PromptProps } from "./prompt.mjs";
 import { Agent } from "./mdx.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import { AIConfig, BreadcrumbConfig, ChangelogConfig, ChangelogFrontmatter, 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, Agent, type BreadcrumbConfig, type ChangelogConfig, type ChangelogFrontmatter, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, type CopyMarkdownConfig, DocsBody, DocsClientHooks, DocsCommandSearch, type DocsConfig, DocsFeedback, type DocsFeedbackData, type DocsFeedbackProps, type DocsFeedbackValue, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FeedbackConfig, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, type HoverLinkProps, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };
+export { type AIConfig, Agent, type BreadcrumbConfig, type ChangelogConfig, type ChangelogFrontmatter, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, type CopyMarkdownConfig, DocsBody, DocsClientHooks, DocsCommandSearch, type DocsConfig, DocsFeedback, type DocsFeedbackData, type DocsFeedbackProps, type DocsFeedbackValue, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FeedbackConfig, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, type HoverLinkProps, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, Prompt, type PromptProps, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };

package/dist/index.mjs

@@ -11,6 +11,7 @@ import { ConcreteUIDefaults, concrete } from "./concrete/index.mjs";
 import { HardlineUIDefaults, hardline } from "./hardline/index.mjs";
 import { DocsClientHooks } from "./docs-client-hooks.mjs";
 import { HoverLink } from "./hover-link.mjs";
+import { Prompt } from "./prompt.mjs";
 import { Agent } from "./mdx.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import { createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
@@ -18,4 +19,4 @@ import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, Pre } from "fumadocs-ui/components/codeblock";
 
-export { Agent, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, DocsBody, DocsClientHooks, DocsCommandSearch, DocsFeedback, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, PageActions, Pre, RootProvider, Tab, Tabs, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };
+export { Agent, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CommandGridUIDefaults, ConcreteUIDefaults, DocsBody, DocsClientHooks, DocsCommandSearch, DocsFeedback, DocsLayout, DocsPage, DocsPageClient, DefaultUIDefaults as FumadocsUIDefaults, HardlineUIDefaults, HoverLink, PageActions, Pre, Prompt, RootProvider, Tab, Tabs, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, withLangInUrl };

package/dist/mdx.d.mts

@@ -1,5 +1,6 @@
 import { MDXImg } from "./mdx-img.mjs";
 import { HoverLink } from "./hover-link.mjs";
+import { Prompt, PromptIconValue, PromptOpenDocsProvider } from "./prompt.mjs";
 import React from "react";
 import { CodeBlockCopyData, DocsTheme } from "@farming-labs/docs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
@@ -21,6 +22,7 @@ declare const extendedMdxComponents: {
   table: typeof Table;
   Agent: typeof Agent;
   HoverLink: typeof HoverLink;
+  Prompt: typeof Prompt;
   Tab: typeof Tab;
   Tabs: typeof Tabs;
   CodeBlockTab: typeof fumadocs_ui_components_codeblock0.CodeBlockTab;
@@ -47,7 +49,11 @@ interface GetMDXComponentsOptions {
   onCopyClick?: (data: CodeBlockCopyData) => void;
   /** Theme config used to apply built-in MDX component defaults from `theme.ui.components`. */
   theme?: DocsTheme;
+  /** Shared icon registry from `docs.config.ts[x]`. */
+  icons?: Record<string, PromptIconValue>;
+  /** Optional site-wide "Open in …" providers used by built-in components such as `Prompt`. */
+  openDocsProviders?: PromptOpenDocsProvider[];
 }
 declare function getMDXComponents<T extends Record<string, unknown> = Record<string, unknown>>(overrides?: T, options?: GetMDXComponentsOptions): typeof extendedMdxComponents & T;
 //#endregion
-export { Agent, GetMDXComponentsOptions, HoverLink, Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };
+export { Agent, GetMDXComponentsOptions, HoverLink, Prompt, Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };

package/dist/mdx.mjs

@@ -1,6 +1,8 @@
 import { MDXImg } from "./mdx-img.mjs";
 import { createPreWithCopyCallback } from "./code-block-copy-wrapper.mjs";
 import { HoverLink } from "./hover-link.mjs";
+import { extractPromptText } from "./prompt-text.mjs";
+import { Prompt } from "./prompt.mjs";
 import React from "react";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import defaultMdxComponents from "fumadocs-ui/mdx";
@@ -36,17 +38,32 @@ const extendedMdxComponents = {
 	table: Table,
 	Agent,
 	HoverLink,
+	Prompt,
 	Tab,
 	Tabs
 };
-const mdxComponentDefaults = { HoverLink: {
-	linkLabel: "Open page",
-	showIndicator: false,
-	align: "center",
-	side: "bottom",
-	sideOffset: 12,
-	closeDelay: 90
-} };
+const mdxComponentDefaults = {
+	HoverLink: {
+		linkLabel: "Open page",
+		showIndicator: false,
+		align: "center",
+		side: "bottom",
+		sideOffset: 12,
+		closeDelay: 90
+	},
+	Prompt: {
+		showTitle: true,
+		showDescription: true,
+		showPrompt: false,
+		actions: ["copy"],
+		copyLabel: "Copy prompt",
+		copiedLabel: "Copied",
+		openLabel: "Open in",
+		copyIcon: "copy",
+		copiedIcon: "check",
+		openIcon: "arrowUpRight"
+	}
+};
 function applyBuiltInComponentDefaults(options) {
 	const themeComponents = options?.theme?.ui?.components;
 	if (!themeComponents) return extendedMdxComponents;
@@ -57,9 +74,10 @@ function applyBuiltInComponentDefaults(options) {
 		const Component = components[name];
 		if (!Component) continue;
 		const builtInDefaults = mdxComponentDefaults[name] ?? {};
+		const configuredDefaults = value && typeof value === "object" ? value : {};
 		const componentDefaults = typeof value === "function" ? value(builtInDefaults) : {
 			...builtInDefaults,
-			...value
+			...configuredDefaults
 		};
 		if (!componentDefaults || typeof componentDefaults !== "object") continue;
 		components[name] = function ThemedComponent(props) {
@@ -76,6 +94,19 @@ function getMDXComponents(overrides, options) {
 		...applyBuiltInComponentDefaults(options),
 		...overrides
 	};
+	if (base.Prompt) {
+		const DefaultPrompt = base.Prompt;
+		base.Prompt = function PromptWithDocsContext(props) {
+			const { children, ...rest } = props;
+			return React.createElement(DefaultPrompt, {
+				iconRegistry: options?.icons,
+				openDocsProviders: options?.openDocsProviders,
+				prompt: extractPromptText(children),
+				...rest,
+				children
+			});
+		};
+	}
 	if (options?.onCopyClick) {
 		const DefaultPre = base.pre;
 		if (DefaultPre) base.pre = createPreWithCopyCallback(DefaultPre, options.onCopyClick);
@@ -84,4 +115,4 @@ function getMDXComponents(overrides, options) {
 }
 
 //#endregion
-export { Agent, HoverLink, Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };
+export { Agent, HoverLink, Prompt, Tab, Tabs, defaultMdxComponents, extendedMdxComponents, getMDXComponents };

package/dist/prompt-text.mjs

@@ -0,0 +1,23 @@
+import React from "react";
+
+//#region src/prompt-text.ts
+function extractPromptText(children) {
+	function inner(node) {
+		if (node == null || typeof node === "boolean") return "";
+		if (typeof node === "string" || typeof node === "number") return String(node);
+		if (Array.isArray(node)) return node.map((child) => inner(child)).join("");
+		if (React.isValidElement(node)) {
+			const childText = inner(node.props.children);
+			if (node.type === "br") return "\n";
+			if (node.type === "li") return `- ${childText.trim()}\n`;
+			if (node.type === "p") return `${childText.trim()}\n\n`;
+			if (node.type === "ul" || node.type === "ol") return `${childText.trim()}\n`;
+			return childText;
+		}
+		return "";
+	}
+	return inner(children).replace(/\r\n/g, "\n").replace(/\n{3,}/g, "\n\n").replace(/[ \t]+\n/g, "\n").trim();
+}
+
+//#endregion
+export { extractPromptText };

package/dist/prompt.d.mts

@@ -0,0 +1,53 @@
+import React from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/prompt.d.ts
+type PromptAction = "copy" | "open";
+type PromptIconValue = React.ReactNode | string;
+interface PromptOpenDocsProvider {
+  name: string;
+  icon?: PromptIconValue;
+  urlTemplate: string;
+  promptUrlTemplate?: string;
+}
+interface PromptProps {
+  title?: string;
+  description?: string;
+  prompt?: string;
+  icon?: string;
+  showTitle?: boolean;
+  showDescription?: boolean;
+  showPrompt?: boolean;
+  actions?: PromptAction[] | string[];
+  providers?: string[] | string;
+  copyLabel?: string;
+  copiedLabel?: string;
+  openLabel?: string;
+  copyIcon?: string | false;
+  copiedIcon?: string | false;
+  openIcon?: string | false;
+  iconRegistry?: Record<string, PromptIconValue>;
+  openDocsProviders?: PromptOpenDocsProvider[];
+}
+declare function Prompt({
+  title,
+  description,
+  prompt,
+  icon,
+  showTitle,
+  showDescription,
+  showPrompt,
+  actions,
+  providers,
+  copyLabel,
+  copiedLabel,
+  openLabel,
+  copyIcon,
+  copiedIcon,
+  openIcon,
+  iconRegistry,
+  openDocsProviders,
+  children
+}: React.PropsWithChildren<PromptProps>): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { Prompt, PromptIconValue, PromptOpenDocsProvider, PromptProps };

package/dist/prompt.mjs

@@ -0,0 +1,281 @@
+"use client";
+
+import { extractPromptText } from "./prompt-text.mjs";
+import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/prompt.tsx
+const builtInIcons = {
+	copy: /* @__PURE__ */ jsxs("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [/* @__PURE__ */ jsx("rect", {
+			x: "9",
+			y: "9",
+			width: "13",
+			height: "13",
+			rx: "2",
+			ry: "2"
+		}), /* @__PURE__ */ jsx("path", { d: "M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" })]
+	}),
+	check: /* @__PURE__ */ jsx("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: /* @__PURE__ */ jsx("polyline", { points: "20 6 9 17 4 12" })
+	}),
+	arrowUpRight: /* @__PURE__ */ jsxs("svg", {
+		width: "14",
+		height: "14",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: [
+			/* @__PURE__ */ jsx("path", { d: "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6" }),
+			/* @__PURE__ */ jsx("polyline", { points: "15 3 21 3 21 9" }),
+			/* @__PURE__ */ jsx("line", {
+				x1: "10",
+				y1: "14",
+				x2: "21",
+				y2: "3"
+			})
+		]
+	}),
+	chevronDown: /* @__PURE__ */ jsx("svg", {
+		width: "12",
+		height: "12",
+		viewBox: "0 0 24 24",
+		fill: "none",
+		stroke: "currentColor",
+		strokeWidth: "2",
+		strokeLinecap: "round",
+		strokeLinejoin: "round",
+		children: /* @__PURE__ */ jsx("polyline", { points: "6 9 12 15 18 9" })
+	})
+};
+const defaultPromptProviderTemplates = {
+	chatgpt: "https://chatgpt.com/?q={prompt}",
+	claude: "https://claude.ai/new?q={prompt}",
+	cursor: "https://cursor.com/link/prompt?text={prompt}",
+	gemini: "https://gemini.google.com/app?q={prompt}",
+	copilot: "https://github.com/copilot?prompt={prompt}"
+};
+function normalizeProviderName(name) {
+	return name.trim().toLowerCase();
+}
+function parseStringArray(value) {
+	if (Array.isArray(value)) {
+		const normalized = value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter(Boolean);
+		return normalized.length > 0 ? normalized : void 0;
+	}
+	if (typeof value !== "string") return void 0;
+	const trimmed = value.trim();
+	if (!trimmed) return void 0;
+	if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+		const normalized = trimmed.slice(1, -1).split(",").map((entry) => entry.trim().replace(/^['"]|['"]$/g, "")).filter(Boolean);
+		return normalized.length > 0 ? normalized : void 0;
+	}
+	const normalized = trimmed.split(",").map((entry) => entry.trim()).filter(Boolean);
+	return normalized.length > 0 ? normalized : void 0;
+}
+function resolveProviderChoices(availableProviders, preferredNames) {
+	const configuredByName = new Map((availableProviders ?? []).map((provider) => [normalizeProviderName(provider.name), provider]));
+	const names = preferredNames && preferredNames.length > 0 ? preferredNames : (availableProviders ?? []).map((provider) => provider.name);
+	const seen = /* @__PURE__ */ new Set();
+	const resolved = [];
+	for (const rawName of names) {
+		const name = rawName.trim();
+		if (!name) continue;
+		const normalized = normalizeProviderName(name);
+		if (seen.has(normalized)) continue;
+		seen.add(normalized);
+		const configured = configuredByName.get(normalized);
+		const template = configured?.promptUrlTemplate ?? configured?.urlTemplate ?? defaultPromptProviderTemplates[normalized];
+		if (!template) continue;
+		resolved.push({
+			name: configured?.name ?? name,
+			icon: configured?.icon,
+			urlTemplate: template
+		});
+	}
+	return resolved;
+}
+function resolveActionIcon(name, iconRegistry) {
+	if (name === false) return null;
+	if (!name) return null;
+	const registryMatch = iconRegistry?.[name];
+	if (registryMatch) {
+		if (typeof registryMatch !== "string") return registryMatch;
+	}
+	if (name in builtInIcons) return builtInIcons[name];
+	return null;
+}
+async function fallbackCopyText(text) {
+	if (typeof document === "undefined") return false;
+	const textarea = document.createElement("textarea");
+	textarea.value = text;
+	textarea.setAttribute("readonly", "");
+	textarea.style.position = "fixed";
+	textarea.style.top = "0";
+	textarea.style.left = "0";
+	textarea.style.opacity = "0";
+	textarea.style.pointerEvents = "none";
+	document.body.appendChild(textarea);
+	textarea.focus();
+	textarea.select();
+	let copied = false;
+	try {
+		copied = document.execCommand("copy");
+	} catch {
+		copied = false;
+	} finally {
+		document.body.removeChild(textarea);
+	}
+	return copied;
+}
+function Prompt({ title, description, prompt, icon, showTitle = true, showDescription = true, showPrompt = false, actions, providers, copyLabel = "Copy prompt", copiedLabel = "Copied", openLabel = "Open in", copyIcon = "copy", copiedIcon = "check", openIcon = "arrowUpRight", iconRegistry, openDocsProviders, children }) {
+	const [copied, setCopied] = useState(false);
+	const [menuOpen, setMenuOpen] = useState(false);
+	const dropdownRef = useRef(null);
+	const promptText = useMemo(() => typeof prompt === "string" && prompt.trim() ? prompt.trim() : extractPromptText(children), [prompt, children]);
+	const promptIconValue = icon && iconRegistry?.[icon] ? iconRegistry[icon] : void 0;
+	const promptIcon = promptIconValue && typeof promptIconValue !== "string" ? promptIconValue : null;
+	const resolvedActions = useMemo(() => parseStringArray(actions) ?? ["copy"], [actions]);
+	const resolvedProviders = useMemo(() => resolveProviderChoices(openDocsProviders, parseStringArray(providers)), [openDocsProviders, providers]);
+	const handleCopy = useCallback(async () => {
+		if (!promptText) return;
+		try {
+			if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) await navigator.clipboard.writeText(promptText);
+			else if (!await fallbackCopyText(promptText)) return;
+			setCopied(true);
+			window.setTimeout(() => setCopied(false), 2e3);
+		} catch {
+			if (!await fallbackCopyText(promptText)) return;
+			setCopied(true);
+			window.setTimeout(() => setCopied(false), 2e3);
+		}
+	}, [promptText]);
+	const handleOpen = useCallback((provider) => {
+		if (!promptText) return;
+		const targetUrl = provider.urlTemplate.replace(/\{prompt\}/g, encodeURIComponent(promptText));
+		window.open(targetUrl, "_blank", "noopener,noreferrer");
+		setMenuOpen(false);
+	}, [promptText]);
+	useEffect(() => {
+		if (!menuOpen) return;
+		function handleOutsideClick(event) {
+			if (!dropdownRef.current) return;
+			if (!dropdownRef.current.contains(event.target)) setMenuOpen(false);
+		}
+		document.addEventListener("mousedown", handleOutsideClick);
+		return () => document.removeEventListener("mousedown", handleOutsideClick);
+	}, [menuOpen]);
+	const showCopy = resolvedActions.includes("copy");
+	const showOpen = resolvedActions.includes("open") && resolvedProviders.length > 0;
+	const singleProvider = showOpen && resolvedProviders.length === 1 ? resolvedProviders[0] : null;
+	const visibleTitle = showTitle ? title : void 0;
+	const visibleDescription = showDescription ? description : void 0;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "fd-prompt",
+		"data-prompt-card": true,
+		children: [
+			(promptIcon || visibleTitle || visibleDescription) && /* @__PURE__ */ jsxs("div", {
+				className: "fd-prompt-header",
+				children: [promptIcon ? /* @__PURE__ */ jsx("span", {
+					className: "fd-prompt-icon",
+					children: promptIcon
+				}) : null, /* @__PURE__ */ jsxs("div", {
+					className: "fd-prompt-copy",
+					children: [visibleTitle && /* @__PURE__ */ jsx("p", {
+						className: "fd-prompt-title",
+						children: visibleTitle
+					}), visibleDescription && /* @__PURE__ */ jsx("p", {
+						className: "fd-prompt-description",
+						children: visibleDescription
+					})]
+				})]
+			}),
+			showPrompt && promptText && /* @__PURE__ */ jsx("div", {
+				className: "fd-prompt-body",
+				children: /* @__PURE__ */ jsx("pre", {
+					className: "fd-prompt-code",
+					children: promptText
+				})
+			}),
+			(showCopy || showOpen) && /* @__PURE__ */ jsxs("div", {
+				className: "fd-prompt-actions",
+				children: [
+					showCopy && /* @__PURE__ */ jsxs("button", {
+						type: "button",
+						className: "fd-prompt-action-btn",
+						"data-copied": copied,
+						onClick: handleCopy,
+						children: [copied ? resolveActionIcon(copiedIcon, iconRegistry) : resolveActionIcon(copyIcon, iconRegistry), /* @__PURE__ */ jsx("span", { children: copied ? copiedLabel : copyLabel })]
+					}),
+					singleProvider ? /* @__PURE__ */ jsxs("button", {
+						type: "button",
+						className: "fd-prompt-action-btn",
+						onClick: () => handleOpen(singleProvider),
+						children: [resolveActionIcon(openIcon, iconRegistry), /* @__PURE__ */ jsxs("span", { children: [
+							openLabel,
+							" ",
+							singleProvider.name
+						] })]
+					}) : null,
+					!singleProvider && showOpen ? /* @__PURE__ */ jsxs("div", {
+						ref: dropdownRef,
+						className: "fd-prompt-dropdown",
+						children: [/* @__PURE__ */ jsxs("button", {
+							type: "button",
+							className: "fd-prompt-action-btn",
+							"aria-expanded": menuOpen,
+							onClick: () => setMenuOpen((current) => !current),
+							children: [
+								resolveActionIcon(openIcon, iconRegistry),
+								/* @__PURE__ */ jsx("span", { children: openLabel }),
+								builtInIcons.chevronDown
+							]
+						}), menuOpen && /* @__PURE__ */ jsx("div", {
+							className: "fd-prompt-menu",
+							role: "menu",
+							children: resolvedProviders.map((provider) => /* @__PURE__ */ jsxs("button", {
+								type: "button",
+								role: "menuitem",
+								className: "fd-prompt-menu-item",
+								onClick: () => handleOpen(provider),
+								children: [provider.icon && typeof provider.icon !== "string" ? /* @__PURE__ */ jsx("span", {
+									className: "fd-prompt-menu-icon",
+									children: provider.icon
+								}) : null, /* @__PURE__ */ jsxs("span", {
+									className: "fd-prompt-menu-label",
+									children: [
+										openLabel,
+										" ",
+										provider.name
+									]
+								})]
+							}, provider.name))
+						})]
+					}) : null
+				]
+			})
+		]
+	});
+}
+
+//#endregion
+export { Prompt };

package/dist/tanstack-layout.mjs

@@ -238,7 +238,7 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 	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) => ({
+	const openDocsProviders = (pageActions?.openDocs && typeof pageActions.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((provider) => ({
 		name: provider.name,
 		urlTemplate: provider.urlTemplate
 	}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.1.58",
+  "version": "0.1.60",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -133,7 +133,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^3.2.4",
-    "@farming-labs/docs": "0.1.58"
+    "@farming-labs/docs": "0.1.60"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",

package/styles/base.css

@@ -422,12 +422,12 @@ figure.shiki:has(figcaption) figcaption {
   }
 }
 
-.fd-page-action-menu-item {
+.fd-page-action-menu-item,
+.fd-prompt-menu-item {
   display: flex;
   align-items: center;
   gap: 0.5rem;
   width: 100%;
-  padding: 0.2rem 0.625rem;
   font-size: 0.8125rem;
   font-weight: 400;
   color: var(--color-fd-popover-foreground);
@@ -441,9 +441,8 @@ figure.shiki:has(figcaption) figcaption {
     color 0.1s;
 }
 
-.fd-page-action-menu-item:hover {
-  background: var(--color-fd-accent);
-  color: var(--color-fd-accent-foreground);
+.fd-page-action-menu-item {
+  padding: 0.2rem 0.625rem;
 }
 
 .fd-page-action-menu-icon {
@@ -464,6 +463,177 @@ figure.shiki:has(figcaption) figcaption {
   flex: 1;
 }
 
+/* ─── Prompt Cards ─────────────────────────────────────────────────── */
+
+.fd-prompt {
+  display: flex;
+  flex-direction: column;
+  gap: 0.875rem;
+  margin: 1.25rem 0;
+  padding: 1rem;
+  border: 1px solid var(--color-fd-border);
+  border-radius: 0.75rem;
+  background: color-mix(in srgb, var(--color-fd-card) 78%, transparent);
+}
+
+.fd-prompt-header {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.75rem;
+}
+
+.fd-prompt-icon,
+.fd-prompt-action-icon,
+.fd-prompt-menu-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+}
+
+.fd-prompt-icon {
+  width: 1.75rem;
+  height: 1.75rem;
+  border-radius: 0.5rem;
+  border: 1px solid color-mix(in srgb, var(--color-fd-border) 80%, transparent);
+  background: color-mix(in srgb, var(--color-fd-background) 55%, transparent);
+  color: var(--color-fd-foreground);
+}
+
+.fd-prompt-icon svg,
+.fd-prompt-action-icon svg,
+.fd-prompt-menu-icon svg {
+  width: 1rem;
+  height: 1rem;
+}
+
+.fd-prompt-copy {
+  min-width: 0;
+}
+
+.fd-prompt-title {
+  margin: 0;
+  color: var(--color-fd-foreground);
+  font-size: 0.9375rem;
+  font-weight: 600;
+  line-height: 1.35;
+}
+
+.fd-prompt-description {
+  margin: 0.25rem 0 0;
+  color: var(--color-fd-muted-foreground);
+  font-size: 0.875rem;
+  line-height: 1.55;
+}
+
+.fd-prompt-body {
+  margin: 0;
+  padding: 0.875rem 1rem;
+  border-radius: 0.625rem;
+  border: 1px solid color-mix(in srgb, var(--color-fd-border) 82%, transparent);
+  background: color-mix(in srgb, var(--color-fd-background) 45%, transparent);
+  overflow-x: auto;
+}
+
+.fd-prompt-body > pre.fd-prompt-code {
+  margin: 0;
+  padding: 0 !important;
+  border: 0 !important;
+  border-radius: 0 !important;
+  background: transparent !important;
+  box-shadow: none !important;
+  color: var(--color-fd-foreground);
+  font-size: 0.875rem;
+  line-height: 1.65;
+  white-space: pre-wrap;
+  word-break: break-word;
+  font-family: var(
+    --fd-font-mono,
+    ui-monospace,
+    "SF Mono",
+    SFMono-Regular,
+    Menlo,
+    Consolas,
+    monospace
+  );
+}
+
+.fd-prompt-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  align-items: center;
+  justify-content: flex-end;
+}
+
+.fd-prompt-action-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4375rem;
+  min-height: 2rem;
+  padding: 0.375rem 0.75rem;
+  border: 1px solid var(--color-fd-border);
+  border-radius: 0.375rem;
+  background: var(--color-fd-secondary);
+  color: var(--color-fd-muted-foreground);
+  font-size: 0.8125rem;
+  font-weight: 500;
+  line-height: 1;
+  cursor: pointer;
+  transition:
+    color 0.15s,
+    background 0.15s,
+    border-color 0.15s;
+}
+
+.fd-prompt-action-btn:hover {
+  color: var(--color-fd-accent-foreground);
+  background: var(--color-fd-accent);
+}
+
+.fd-prompt-action-btn[data-copied="true"] {
+  color: var(--color-fd-foreground);
+}
+
+.fd-prompt-action-icon-copied[hidden] {
+  display: none;
+}
+
+.fd-prompt-dropdown {
+  position: relative;
+}
+
+.fd-prompt-menu {
+  position: absolute;
+  top: calc(100% + 0.375rem);
+  right: 0;
+  z-index: 50;
+  min-width: 220px;
+  padding: 0.375rem;
+  background: var(--color-fd-popover);
+  border: 1px solid var(--color-fd-border);
+  border-radius: 0.5rem;
+  box-shadow: 0 4px 24px hsl(0 0% 0% / 0.15);
+  display: flex;
+  flex-direction: column;
+  gap: 0.125rem;
+  animation: fd-page-actions-fade-in 0.12s ease-out;
+}
+
+.fd-prompt-menu-item {
+  padding: 0.25rem 0.625rem;
+}
+
+.fd-page-action-menu-item:hover,
+.fd-prompt-menu-item:hover {
+  background: var(--color-fd-accent);
+  color: var(--color-fd-accent-foreground);
+}
+
+.fd-prompt-menu-label {
+  flex: 1;
+}
+
 /* ─── Docs Feedback ────────────────────────────────────────────────── */
 
 .fd-feedback {

package/styles/pixel-border.css

@@ -529,6 +529,68 @@ hr {
   font-family: var(--fd-font-mono, var(--font-geist-mono, ui-monospace, monospace)) !important;
 }
 
+/* ─── Prompt (pixel-border overrides) ────────────────────────────── */
+
+.fd-prompt {
+  border-radius: 0 !important;
+  border: 1px solid var(--color-fd-border, #262626) !important;
+  background: var(--color-fd-card, var(--color-fd-background)) !important;
+  box-shadow: 4px 4px 0 0 var(--color-fd-border, #262626) !important;
+}
+
+.fd-prompt-body {
+  border-radius: 0 !important;
+  border-top: 1px solid var(--color-fd-border, #262626) !important;
+  background: var(--color-fd-background, #0c0c0c) !important;
+}
+
+.fd-prompt-action-btn {
+  border-radius: 0 !important;
+  font-size: 0.75rem !important;
+  letter-spacing: 0.03em !important;
+  text-transform: uppercase !important;
+  box-shadow: 2px 2px 0 0 var(--color-fd-border, #262626) !important;
+  font-family: var(--fd-font-mono, var(--font-geist-mono, ui-monospace, monospace)) !important;
+  background: var(--color-fd-background, #0c0c0c) !important;
+  color: var(--color-fd-foreground, inherit) !important;
+  border: 1px solid var(--color-fd-border, #262626) !important;
+}
+
+.fd-prompt-action-btn:hover {
+  background: var(--color-fd-muted, var(--color-fd-accent)) !important;
+  color: var(--color-fd-foreground, inherit) !important;
+}
+
+.fd-prompt-menu {
+  border-radius: 0 !important;
+  box-shadow:
+    4px 4px 0 0 var(--color-fd-border, #262626),
+    0 4px 24px hsl(0 0% 0% / 0.5) !important;
+  background: var(--color-fd-popover, var(--color-fd-background)) !important;
+  border: 2px solid var(--color-fd-border, #262626) !important;
+  padding: 0.375rem !important;
+}
+
+.fd-prompt-menu-item {
+  border-radius: 0 !important;
+  font-size: 0.8rem !important;
+  letter-spacing: 0.03em !important;
+  text-transform: uppercase !important;
+  color: var(--color-fd-popover-foreground, var(--color-fd-foreground)) !important;
+  font-family: var(--fd-font-mono, var(--font-geist-mono, ui-monospace, monospace)) !important;
+  background: transparent !important;
+  border-top: 1px solid var(--color-fd-border, #262626) !important;
+}
+
+.fd-prompt-menu-item:first-child {
+  border-top: none !important;
+}
+
+.fd-prompt-menu-item:hover {
+  background: var(--color-fd-muted, var(--color-fd-accent)) !important;
+  color: var(--color-fd-foreground, inherit) !important;
+}
+
 /* model selector  */
 .fd-ai-model-select-row {
   display: flex;