@farming-labs/theme 0.1.112 → 0.1.114

package/dist/docs-layout.mjs

@@ -3,6 +3,7 @@ import { withLangInUrl } from "./i18n.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { DocsAIFeatures } from "./docs-ai-features.mjs";
 import { DocsCommandSearch } from "./docs-command-search.mjs";
+import { resolveOpenDocsProviders } from "./open-docs-providers.mjs";
 import { resolvePageReadingTime, resolveReadingTimeOptions } from "./reading-time.mjs";
 import { SidebarSearchWithAI } from "./sidebar-search-ai.mjs";
 import { LocaleThemeControl } from "./locale-theme-control.mjs";
@@ -660,11 +661,12 @@ function createDocsLayout(config, options) {
 	const readingTimeWordsPerMinute = readingTimeOptions.wordsPerMinute ?? 220;
 	const llmsTxtEnabled = resolveEnabledByDefault(config.llmsTxt);
 	const feedbackConfig = resolveFeedbackConfig(config.feedback);
-	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
-	}));
+	const openDocsConfig = pageActions?.openDocs && typeof pageActions.openDocs === "object" ? pageActions.openDocs : void 0;
+	const openDocsProviders = resolveOpenDocsProviders(openDocsConfig?.providers, {
+		target: openDocsConfig?.target,
+		prompt: openDocsConfig?.prompt,
+		serializeIcon
+	});
 	const githubRaw = config.github;
 	const githubUrl = typeof githubRaw === "string" ? githubRaw.replace(/\/$/, "") : githubRaw?.url.replace(/\/$/, "");
 	const githubBranch = typeof githubRaw === "object" ? githubRaw.branch ?? "main" : "main";
@@ -784,6 +786,8 @@ function createDocsLayout(config, options) {
 						copyMarkdown: copyMarkdownEnabled,
 						openDocs: openDocsEnabled,
 						openDocsProviders,
+						openDocsTarget: openDocsConfig?.target,
+						openDocsPrompt: openDocsConfig?.prompt,
 						pageActionsPosition,
 						pageActionsAlignment,
 						githubUrl,

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

@@ -8,6 +8,8 @@ interface SerializedProvider {
   name: string;
   iconHtml?: string;
   urlTemplate: string;
+  target?: "markdown" | "page" | "source" | "github";
+  prompt?: string;
 }
 interface DocsPageClientProps {
   tocEnabled: boolean;
@@ -23,6 +25,8 @@ interface DocsPageClientProps {
   copyMarkdown?: boolean;
   openDocs?: boolean;
   openDocsProviders?: SerializedProvider[];
+  openDocsTarget?: "markdown" | "page" | "source" | "github";
+  openDocsPrompt?: string;
   /** Where to render page actions relative to the title */
   pageActionsPosition?: "above-title" | "below-title";
   /** Horizontal alignment of page action buttons */
@@ -86,6 +90,8 @@ declare function DocsPageClient({
   copyMarkdown,
   openDocs,
   openDocsProviders,
+  openDocsTarget,
+  openDocsPrompt,
   pageActionsPosition,
   pageActionsAlignment,
   githubUrl,

package/dist/docs-page-client.mjs

@@ -263,7 +263,7 @@ function TitleDecorations({ description, belowTitle }) {
 	if (!description && !belowTitle) return null;
 	return /* @__PURE__ */ jsx(Fragment$1, { children: Children.toArray([description, belowTitle].filter(Boolean)) });
 }
-function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", publicPath, locale, copyMarkdown = false, openDocs = false, openDocsProviders, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackOnFeedback, analytics = false, children }) {
+function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", publicPath, locale, copyMarkdown = false, openDocs = false, openDocsProviders, openDocsTarget, openDocsPrompt, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackOnFeedback, analytics = false, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const [titlePortalHost, setTitlePortalHost] = useState(null);
@@ -414,6 +414,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 					copyMarkdown,
 					openDocs,
 					providers: openDocsProviders,
+					openDocsTarget,
+					openDocsPrompt,
 					alignment: pageActionsAlignment,
 					githubFileUrl,
 					analytics
@@ -492,6 +494,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 							copyMarkdown,
 							openDocs,
 							providers: openDocsProviders,
+							openDocsTarget,
+							openDocsPrompt,
 							alignment: pageActionsAlignment,
 							githubFileUrl,
 							analytics

package/dist/open-docs-providers.mjs

@@ -0,0 +1,79 @@
+//#region src/open-docs-providers.ts
+const PROMPT_PROVIDER_TEMPLATES = {
+	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}"
+};
+const OPEN_DOCS_PROVIDER_PRESETS = {
+	chatgpt: {
+		name: "ChatGPT",
+		urlTemplate: "https://chatgpt.com/?q={prompt}",
+		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.chatgpt
+	},
+	claude: {
+		name: "Claude",
+		urlTemplate: "https://claude.ai/new?q={prompt}",
+		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.claude
+	},
+	cursor: {
+		name: "Cursor",
+		urlTemplate: "https://cursor.com/link/prompt?text={prompt}",
+		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.cursor
+	},
+	gemini: {
+		name: "Gemini",
+		urlTemplate: "https://gemini.google.com/app?q={prompt}",
+		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.gemini
+	},
+	copilot: {
+		name: "Copilot",
+		urlTemplate: "https://github.com/copilot?prompt={prompt}",
+		promptUrlTemplate: PROMPT_PROVIDER_TEMPLATES.copilot
+	},
+	github: {
+		name: "GitHub",
+		urlTemplate: "{githubUrl}",
+		promptUrlTemplate: "{githubUrl}",
+		target: "github"
+	}
+};
+function normalizeProviderName(name) {
+	return name.trim().toLowerCase();
+}
+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);
+	return serialized.length > 0 ? serialized : void 0;
+}
+function resolveOpenDocsProvider(provider, options = {}) {
+	const normalizedId = typeof provider === "string" ? normalizeProviderName(provider) : typeof provider.id === "string" ? normalizeProviderName(provider.id) : typeof provider.name === "string" ? normalizeProviderName(provider.name) : typeof provider.label === "string" ? normalizeProviderName(provider.label) : void 0;
+	const preset = normalizedId ? OPEN_DOCS_PROVIDER_PRESETS[normalizedId] : void 0;
+	if (typeof provider === "string") {
+		if (!preset) return void 0;
+		return {
+			name: preset.name,
+			urlTemplate: preset.urlTemplate,
+			promptUrlTemplate: preset.promptUrlTemplate,
+			target: preset.target ?? options.target,
+			prompt: options.prompt
+		};
+	}
+	const cursorAppTemplate = normalizedId === "cursor" && provider.mode === "app" ? "cursor://anysphere.cursor-deeplink/prompt?text={prompt}" : void 0;
+	const name = provider.name ?? provider.label ?? preset?.name;
+	const urlTemplate = provider.urlTemplate ?? cursorAppTemplate ?? preset?.urlTemplate;
+	const hasCustomUrlTemplate = typeof provider.urlTemplate === "string";
+	if (!name || !urlTemplate) return void 0;
+	return {
+		name,
+		urlTemplate,
+		promptUrlTemplate: provider.promptUrlTemplate ?? cursorAppTemplate ?? preset?.promptUrlTemplate,
+		iconHtml: options.serializeIcon?.(provider.icon) ?? (typeof provider.icon === "string" ? provider.icon : void 0),
+		target: provider.target ?? preset?.target ?? options.target ?? (hasCustomUrlTemplate ? "page" : void 0),
+		prompt: provider.prompt ?? options.prompt
+	};
+}
+
+//#endregion
+export { resolveOpenDocsProviders };

package/dist/page-actions.d.mts

@@ -6,11 +6,15 @@ interface SerializedProvider {
   name: string;
   iconHtml?: string;
   urlTemplate: string;
+  target?: "markdown" | "page" | "source" | "github";
+  prompt?: string;
 }
 interface PageActionsProps {
   copyMarkdown?: boolean;
   openDocs?: boolean;
   providers?: SerializedProvider[];
+  openDocsTarget?: "markdown" | "page" | "source" | "github";
+  openDocsPrompt?: string;
   alignment?: "left" | "right";
   /** GitHub file URL (edit view) for the current page. Used when urlTemplate contains {githubUrl}. */
   githubFileUrl?: string | null;
@@ -20,6 +24,8 @@ declare function PageActions({
   copyMarkdown,
   openDocs,
   providers,
+  openDocsTarget,
+  openDocsPrompt,
   alignment,
   githubFileUrl,
   analytics

package/dist/page-actions.mjs

@@ -1,6 +1,7 @@
 "use client";
 
 import { emitClientAnalyticsEvent } from "./client-analytics.mjs";
+import { sanitizeIconHtml } from "./safe-icon-html.mjs";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { usePathname } from "fumadocs-core/framework";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -68,12 +69,30 @@ const ExternalLinkIcon = () => /* @__PURE__ */ jsxs("svg", {
 });
 const DEFAULT_PROVIDERS = [{
 	name: "ChatGPT",
-	urlTemplate: "https://chatgpt.com/?hints=search&q=Read+{mdxUrl},+I+want+to+ask+questions+about+it."
+	urlTemplate: "https://chatgpt.com/?q={prompt}"
 }, {
 	name: "Claude",
-	urlTemplate: "https://claude.ai/new?q=Read+{mdxUrl},+I+want+to+ask+questions+about+it."
+	urlTemplate: "https://claude.ai/new?q={prompt}"
 }];
-function PageActions({ copyMarkdown, openDocs, providers, alignment = "left", githubFileUrl, analytics = false }) {
+const DEFAULT_OPEN_DOCS_TARGET = "markdown";
+const DEFAULT_OPEN_DOCS_PROMPT = "Read this documentation: {url}";
+function pageUrlToMarkdownUrl(pageUrl) {
+	try {
+		const url = new URL(pageUrl);
+		const pathname = url.pathname.replace(/\/+$/, "") || url.pathname;
+		url.pathname = pathname.endsWith(".md") ? pathname : `${pathname}.md`;
+		url.search = "";
+		url.hash = "";
+		return url.toString();
+	} catch {
+		const clean = pageUrl.replace(/[?#].*$/, "").replace(/\/+$/, "") || pageUrl;
+		return clean.endsWith(".md") ? clean : `${clean}.md`;
+	}
+}
+function fillPromptTemplate(template, values) {
+	return template.replace(/\{pageUrl\}/g, values.pageUrl).replace(/\{markdownUrl\}/g, values.markdownUrl).replace(/\{sourceUrl\}/g, values.sourceUrl).replace(/\{mdxUrl\}/g, values.sourceUrl).replace(/\{githubUrl\}/g, values.githubUrl).replace(/\{url\}/g, values.url);
+}
+function PageActions({ copyMarkdown, openDocs, providers, openDocsTarget = DEFAULT_OPEN_DOCS_TARGET, openDocsPrompt = DEFAULT_OPEN_DOCS_PROMPT, alignment = "left", githubFileUrl, analytics = false }) {
 	const [copied, setCopied] = useState(false);
 	const [dropdownOpen, setDropdownOpen] = useState(false);
 	const dropdownRef = useRef(null);
@@ -99,13 +118,28 @@ function PageActions({ copyMarkdown, openDocs, providers, alignment = "left", gi
 	}, [analytics, pathname]);
 	const handleOpen = useCallback((provider) => {
 		const template = provider.urlTemplate;
-		if (/\{githubUrl\}/.test(template) && !githubFileUrl) {
+		const githubUrl = githubFileUrl ?? "";
+		if (/\{githubUrl\}/.test(template) && !githubUrl) {
 			setDropdownOpen(false);
 			return;
 		}
 		const pageUrl = window.location.href;
-		const mdxUrl = `${window.location.origin}${pathname}.mdx`;
-		let url = template.replace(/\{url\}/g, encodeURIComponent(pageUrl)).replace(/\{mdxUrl\}/g, encodeURIComponent(mdxUrl)).replace(/\{githubUrl\}/g, githubFileUrl ?? "");
+		const sourceUrl = `${window.location.origin}${pathname}.mdx`;
+		const markdownUrl = pageUrlToMarkdownUrl(pageUrl);
+		const target = provider.target ?? openDocsTarget;
+		if (target === "github" && !githubUrl) {
+			setDropdownOpen(false);
+			return;
+		}
+		const targetUrl = target === "markdown" ? markdownUrl : target === "source" ? sourceUrl : target === "github" ? githubUrl : pageUrl;
+		const prompt = fillPromptTemplate(provider.prompt ?? openDocsPrompt, {
+			url: targetUrl,
+			pageUrl,
+			markdownUrl,
+			sourceUrl,
+			githubUrl
+		});
+		let url = template.replace(/\{prompt\}/g, encodeURIComponent(prompt)).replace(/\{url\}/g, encodeURIComponent(targetUrl)).replace(/\{pageUrl\}/g, encodeURIComponent(pageUrl)).replace(/\{markdownUrl\}/g, encodeURIComponent(markdownUrl)).replace(/\{sourceUrl\}/g, encodeURIComponent(sourceUrl)).replace(/\{mdxUrl\}/g, encodeURIComponent(sourceUrl)).replace(/\{githubUrl\}/g, githubUrl);
 		if (analytics) emitClientAnalyticsEvent({
 			type: "page_action_open_docs",
 			properties: {
@@ -119,7 +153,9 @@ function PageActions({ copyMarkdown, openDocs, providers, alignment = "left", gi
 	}, [
 		analytics,
 		pathname,
-		githubFileUrl
+		githubFileUrl,
+		openDocsPrompt,
+		openDocsTarget
 	]);
 	useEffect(() => {
 		if (!dropdownOpen) return;
@@ -166,23 +202,26 @@ function PageActions({ copyMarkdown, openDocs, providers, alignment = "left", gi
 			}), dropdownOpen && /* @__PURE__ */ jsx("div", {
 				className: "fd-page-action-menu",
 				role: "menu",
-				children: resolvedProviders.map((provider) => /* @__PURE__ */ jsxs("button", {
-					type: "button",
-					role: "menuitem",
-					className: "fd-page-action-menu-item",
-					onClick: () => handleOpen(provider),
-					children: [
-						provider.iconHtml && /* @__PURE__ */ jsx("span", {
-							className: "fd-page-action-menu-icon",
-							dangerouslySetInnerHTML: { __html: provider.iconHtml }
-						}),
-						/* @__PURE__ */ jsxs("span", {
-							className: "fd-page-action-menu-label",
-							children: ["Open in ", provider.name]
-						}),
-						/* @__PURE__ */ jsx(ExternalLinkIcon, {})
-					]
-				}, provider.name))
+				children: resolvedProviders.map((provider) => {
+					const iconHtml = sanitizeIconHtml(provider.iconHtml);
+					return /* @__PURE__ */ jsxs("button", {
+						type: "button",
+						role: "menuitem",
+						className: "fd-page-action-menu-item",
+						onClick: () => handleOpen(provider),
+						children: [
+							iconHtml && /* @__PURE__ */ jsx("span", {
+								className: "fd-page-action-menu-icon",
+								dangerouslySetInnerHTML: { __html: iconHtml }
+							}),
+							/* @__PURE__ */ jsxs("span", {
+								className: "fd-page-action-menu-label",
+								children: ["Open in ", provider.name]
+							}),
+							/* @__PURE__ */ jsx(ExternalLinkIcon, {})
+						]
+					}, provider.name);
+				})
 			})]
 		})]
 	});

package/dist/prompt.d.mts

@@ -4,12 +4,16 @@ 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;
+type PromptOpenDocsProvider = string | {
+  id?: string;
+  name?: string;
+  label?: string;
   icon?: PromptIconValue;
-  urlTemplate: string;
+  iconHtml?: string;
+  urlTemplate?: string;
   promptUrlTemplate?: string;
-}
+  mode?: "web" | "app";
+};
 interface PromptProps {
   title?: string;
   description?: string;

package/dist/prompt.mjs

@@ -1,5 +1,6 @@
 "use client";
 
+import { sanitizeIconHtml } from "./safe-icon-html.mjs";
 import { extractPromptText } from "./prompt-text.mjs";
 import React, { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -74,6 +75,13 @@ const defaultPromptProviderTemplates = {
 	gemini: "https://gemini.google.com/app?q={prompt}",
 	copilot: "https://github.com/copilot?prompt={prompt}"
 };
+const defaultPromptProviderLabels = {
+	chatgpt: "ChatGPT",
+	claude: "Claude",
+	cursor: "Cursor",
+	gemini: "Gemini",
+	copilot: "Copilot"
+};
 function normalizeProviderName(name) {
 	return name.trim().toLowerCase();
 }
@@ -93,8 +101,32 @@ function parseStringArray(value) {
 	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 configuredProviders = (availableProviders ?? []).map((provider) => {
+		if (typeof provider === "string") {
+			const normalized = normalizeProviderName(provider);
+			return {
+				normalized,
+				name: defaultPromptProviderLabels[normalized] ?? provider,
+				provider: {
+					id: provider,
+					name: defaultPromptProviderLabels[normalized] ?? provider
+				}
+			};
+		}
+		const rawName = provider.name ?? provider.label ?? provider.id;
+		if (!rawName) return null;
+		const normalized = normalizeProviderName(rawName);
+		return {
+			normalized,
+			name: provider.name ?? provider.label ?? defaultPromptProviderLabels[normalized] ?? rawName,
+			provider: {
+				...provider,
+				name: provider.name ?? provider.label ?? defaultPromptProviderLabels[normalized] ?? rawName
+			}
+		};
+	}).filter((entry) => entry !== null);
+	const configuredByName = new Map(configuredProviders.map((entry) => [entry.normalized, entry.provider]));
+	const names = preferredNames && preferredNames.length > 0 ? preferredNames : configuredProviders.map((entry) => entry.name);
 	const seen = /* @__PURE__ */ new Set();
 	const resolved = [];
 	for (const rawName of names) {
@@ -104,11 +136,13 @@ function resolveProviderChoices(availableProviders, preferredNames) {
 		if (seen.has(normalized)) continue;
 		seen.add(normalized);
 		const configured = configuredByName.get(normalized);
-		const template = configured?.promptUrlTemplate ?? configured?.urlTemplate ?? defaultPromptProviderTemplates[normalized];
+		const cursorAppTemplate = normalized === "cursor" && configured?.mode === "app" ? "cursor://anysphere.cursor-deeplink/prompt?text={prompt}" : void 0;
+		const template = configured?.promptUrlTemplate ?? cursorAppTemplate ?? configured?.urlTemplate ?? defaultPromptProviderTemplates[normalized];
 		if (!template) continue;
 		resolved.push({
-			name: configured?.name ?? name,
+			name: configured?.name ?? defaultPromptProviderLabels[normalized] ?? name,
 			icon: configured?.icon,
+			iconHtml: configured?.iconHtml,
 			urlTemplate: template
 		});
 	}
@@ -252,23 +286,29 @@ function Prompt({ title, description, prompt, icon, showTitle = true, showDescri
 						}), 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))
+							children: resolvedProviders.map((provider) => {
+								const iconHtml = sanitizeIconHtml(provider.iconHtml);
+								return /* @__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
+									}) : iconHtml ? /* @__PURE__ */ jsx("span", {
+										className: "fd-prompt-menu-icon",
+										dangerouslySetInnerHTML: { __html: iconHtml }
+									}) : null, /* @__PURE__ */ jsxs("span", {
+										className: "fd-prompt-menu-label",
+										children: [
+											openLabel,
+											" ",
+											provider.name
+										]
+									})]
+								}, provider.name);
+							})
 						})]
 					}) : null
 				]

package/dist/safe-icon-html.mjs

@@ -0,0 +1,45 @@
+//#region src/safe-icon-html.ts
+const SAFE_ICON_TAGS = new Set([
+	"circle",
+	"clippath",
+	"defs",
+	"desc",
+	"ellipse",
+	"g",
+	"line",
+	"lineargradient",
+	"mask",
+	"path",
+	"polygon",
+	"polyline",
+	"radialgradient",
+	"rect",
+	"span",
+	"stop",
+	"svg",
+	"symbol",
+	"title",
+	"use"
+]);
+const TAG_PATTERN = /<\/?\s*([a-zA-Z][\w:-]*)\b/g;
+const BLOCKED_MARKUP_PATTERN = /<\s*!/;
+const BLOCKED_ATTRIBUTE_PATTERN = /(?:^|[\s/])(?:on[a-z][\w:-]*|srcdoc|style)\s*=/i;
+const URL_ATTRIBUTE_PATTERN = /(?:^|[\s/])(?:href|xlink:href|src)\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi;
+function sanitizeIconHtml(html) {
+	const trimmed = html?.trim();
+	if (!trimmed || trimmed.length > 1e4) return void 0;
+	if (BLOCKED_MARKUP_PATTERN.test(trimmed) || BLOCKED_ATTRIBUTE_PATTERN.test(trimmed)) return;
+	let tagMatch;
+	TAG_PATTERN.lastIndex = 0;
+	while ((tagMatch = TAG_PATTERN.exec(trimmed)) !== null) if (!SAFE_ICON_TAGS.has(tagMatch[1].toLowerCase())) return void 0;
+	let urlMatch;
+	URL_ATTRIBUTE_PATTERN.lastIndex = 0;
+	while ((urlMatch = URL_ATTRIBUTE_PATTERN.exec(trimmed)) !== null) {
+		const value = (urlMatch[1] ?? urlMatch[2] ?? urlMatch[3] ?? "").trim();
+		if (value && !value.startsWith("#")) return void 0;
+	}
+	return trimmed;
+}
+
+//#endregion
+export { sanitizeIconHtml };

package/dist/tanstack-layout.mjs

@@ -3,6 +3,7 @@ import { escapeJsonLdForScript } from "./json-ld.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { DocsAIFeatures } from "./docs-ai-features.mjs";
 import { DocsCommandSearch } from "./docs-command-search.mjs";
+import { resolveOpenDocsProviders } from "./open-docs-providers.mjs";
 import { resolveReadingTimeOptions } from "./reading-time.mjs";
 import { SidebarSearchWithAI } from "./sidebar-search-ai.mjs";
 import { LocaleThemeControl } from "./locale-theme-control.mjs";
@@ -245,10 +246,11 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 	const llmsTxtEnabled = resolveEnabledByDefault(config.llmsTxt);
 	const feedbackConfig = resolveFeedbackConfig(config.feedback);
 	const staticExport = !!config.staticExport;
-	const openDocsProviders = (pageActions?.openDocs && typeof pageActions.openDocs === "object" && pageActions.openDocs.providers ? pageActions.openDocs.providers : void 0)?.map((provider) => ({
-		name: provider.name,
-		urlTemplate: provider.urlTemplate
-	}));
+	const openDocsConfig = pageActions?.openDocs && typeof pageActions.openDocs === "object" ? pageActions.openDocs : void 0;
+	const openDocsProviders = resolveOpenDocsProviders(openDocsConfig?.providers, {
+		target: openDocsConfig?.target,
+		prompt: openDocsConfig?.prompt
+	});
 	const aiConfig = config.ai;
 	const aiEnabled = !staticExport && !!aiConfig?.enabled;
 	const aiMode = aiConfig?.mode ?? "search";
@@ -348,6 +350,8 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 					copyMarkdown: copyMarkdownEnabled,
 					openDocs: openDocsEnabled,
 					openDocsProviders,
+					openDocsTarget: openDocsConfig?.target,
+					openDocsPrompt: openDocsConfig?.prompt,
 					pageActionsPosition,
 					pageActionsAlignment,
 					editOnGithubUrl,

package/package.json

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