@farming-labs/theme 0.2.16 → 0.2.18

package/dist/docs-layout.mjs

@@ -791,6 +791,8 @@ function createDocsLayout(config, options) {
 						publicPath: localeContext.publicPath,
 						locale: activeLocale,
 						copyMarkdown: copyMarkdownEnabled,
+						copyMarkdownFormat: copyMarkdownConfig?.format,
+						copyMarkdownIncludeTitle: copyMarkdownConfig?.includeTitle,
 						copyMarkdownLabel: copyMarkdownConfig?.label,
 						copyMarkdownCopiedLabel: copyMarkdownConfig?.copiedLabel,
 						openDocs: openDocsEnabled,

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

@@ -1,5 +1,5 @@
 import { ReactNode } from "react";
-import { DocsFeedbackData, ReadingTimeFormat } from "@farming-labs/docs";
+import { CopyMarkdownFormat, DocsFeedbackData, ReadingTimeFormat } from "@farming-labs/docs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/docs-page-client.d.ts
@@ -23,6 +23,8 @@ interface DocsPageClientProps {
   /** Active locale (used for llms.txt links) */
   locale?: string;
   copyMarkdown?: boolean;
+  copyMarkdownFormat?: CopyMarkdownFormat;
+  copyMarkdownIncludeTitle?: boolean;
   copyMarkdownLabel?: string;
   copyMarkdownCopiedLabel?: string;
   openDocs?: boolean;
@@ -93,6 +95,8 @@ declare function DocsPageClient({
   publicPath,
   locale,
   copyMarkdown,
+  copyMarkdownFormat,
+  copyMarkdownIncludeTitle,
   copyMarkdownLabel,
   copyMarkdownCopiedLabel,
   openDocs,

package/dist/docs-page-client.mjs

@@ -255,7 +255,7 @@ function findThreadlineTocActionsContainer() {
 	}
 	return toc.parentElement ?? toc;
 }
-function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", publicPath, locale, copyMarkdown = false, copyMarkdownLabel, copyMarkdownCopiedLabel, openDocs = false, openDocsProviders, openDocsTarget, openDocsPrompt, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, readingTimeFormat = "long", structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackRequireComment, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackOnFeedback, analytics = false, children }) {
+function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled = true, changelogBasePath, entry = "docs", publicPath, locale, copyMarkdown = false, copyMarkdownFormat, copyMarkdownIncludeTitle, copyMarkdownLabel, copyMarkdownCopiedLabel, openDocs = false, openDocsProviders, openDocsTarget, openDocsPrompt, pageActionsPosition = "below-title", pageActionsAlignment = "left", githubUrl, contentDir, githubBranch = "main", githubDirectory, editOnGithubUrl, lastModifiedMap, lastModified: lastModifiedProp, readingTimeMap, readingTime: readingTimeProp, readingTimeFormat = "long", structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackRequireComment, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackOnFeedback, analytics = false, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const [titlePortalHost, setTitlePortalHost] = useState(null);
@@ -465,6 +465,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 				"data-actions-alignment": pageActionsAlignment,
 				children: /* @__PURE__ */ jsx(PageActions, {
 					copyMarkdown,
+					copyMarkdownFormat,
+					copyMarkdownIncludeTitle,
 					copyMarkdownLabel,
 					copyMarkdownCopiedLabel,
 					openDocs,
@@ -510,6 +512,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		className: "fd-actions-toc-portal not-prose",
 		children: /* @__PURE__ */ jsx(PageActions, {
 			copyMarkdown,
+			copyMarkdownFormat,
+			copyMarkdownIncludeTitle,
 			copyMarkdownLabel,
 			copyMarkdownCopiedLabel,
 			openDocs,
@@ -564,6 +568,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 						"data-actions-alignment": pageActionsAlignment,
 						children: /* @__PURE__ */ jsx(PageActions, {
 							copyMarkdown,
+							copyMarkdownFormat,
+							copyMarkdownIncludeTitle,
 							copyMarkdownLabel,
 							copyMarkdownCopiedLabel,
 							openDocs,

package/dist/index.d.mts

@@ -16,8 +16,8 @@ import { HoverLink, HoverLinkProps } from "./hover-link.mjs";
 import { Prompt, PromptProps } from "./prompt.mjs";
 import { Agent, CodeGroup } 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 { AIConfig, BreadcrumbConfig, ChangelogConfig, ChangelogFrontmatter, CopyMarkdownConfig, CopyMarkdownFormat, 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, CodeGroup, 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, LedgerUIDefaults, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, Prompt, type PromptProps, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, ThreadlineUIDefaults, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, ledger, threadline, threadlinePageActions, withLangInUrl };
+export { type AIConfig, Agent, type BreadcrumbConfig, type ChangelogConfig, type ChangelogFrontmatter, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, CodeGroup, CommandGridUIDefaults, ConcreteUIDefaults, type CopyMarkdownConfig, type CopyMarkdownFormat, 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, LedgerUIDefaults, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, Prompt, type PromptProps, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, ThreadlineUIDefaults, type TypographyConfig, type UIConfig, commandGrid, concrete, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs, hardline, ledger, threadline, threadlinePageActions, withLangInUrl };

package/dist/page-actions.d.mts

@@ -1,3 +1,4 @@
+import { CopyMarkdownFormat } from "@farming-labs/docs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/page-actions.d.ts
@@ -11,6 +12,8 @@ interface SerializedProvider {
 }
 interface PageActionsProps {
   copyMarkdown?: boolean;
+  copyMarkdownFormat?: CopyMarkdownFormat;
+  copyMarkdownIncludeTitle?: boolean;
   copyMarkdownLabel?: string;
   copyMarkdownCopiedLabel?: string;
   openDocs?: boolean;
@@ -23,8 +26,16 @@ interface PageActionsProps {
   githubFileUrl?: string | null;
   analytics?: boolean;
 }
+declare function formatCopyMarkdownContent(params: {
+  content: string;
+  format: CopyMarkdownFormat;
+  includeTitle?: boolean;
+  title?: string | null;
+}): string;
 declare function PageActions({
   copyMarkdown,
+  copyMarkdownFormat,
+  copyMarkdownIncludeTitle,
   copyMarkdownLabel,
   copyMarkdownCopiedLabel,
   openDocs,
@@ -37,4 +48,4 @@ declare function PageActions({
   analytics
 }: PageActionsProps): react_jsx_runtime0.JSX.Element | null;
 //#endregion
-export { PageActions };
+export { PageActions, formatCopyMarkdownContent };

package/dist/page-actions.mjs

@@ -132,7 +132,26 @@ function pageUrlToMarkdownUrl(pageUrl) {
 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, copyMarkdownLabel = "Copy page", copyMarkdownCopiedLabel = "Copied!", openDocs, providers, openDocsTarget = DEFAULT_OPEN_DOCS_TARGET, openDocsPrompt = DEFAULT_OPEN_DOCS_PROMPT, alignment = "left", variant = "default", githubFileUrl, analytics = false }) {
+function firstContentLine(content) {
+	return content.split(/\r?\n/).map((line) => line.trim()).find(Boolean);
+}
+function formatCopyMarkdownContent(params) {
+	const title = params.title?.trim();
+	if (!params.includeTitle || !title) return params.content;
+	const firstLine = firstContentLine(params.content);
+	if (params.format === "markdown") {
+		const heading = `# ${title}`;
+		if (firstLine === heading || firstLine === title) return params.content;
+		return `${heading}\n\n${params.content.trimStart()}`;
+	}
+	if (firstLine === title) return params.content;
+	return `${title}\n\n${params.content.trimStart()}`;
+}
+function currentPageTitle() {
+	const title = document.querySelector("#nd-page h1") ?? document.querySelector("article h1") ?? document.querySelector("h1");
+	return title?.innerText?.trim() || title?.textContent?.trim() || "";
+}
+function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdownIncludeTitle = false, copyMarkdownLabel = "Copy page", copyMarkdownCopiedLabel = "Copied!", openDocs, providers, openDocsTarget = DEFAULT_OPEN_DOCS_TARGET, openDocsPrompt = DEFAULT_OPEN_DOCS_PROMPT, alignment = "left", variant = "default", githubFileUrl, analytics = false }) {
 	const [copied, setCopied] = useState(false);
 	const [dropdownOpen, setDropdownOpen] = useState(false);
 	const dropdownRef = useRef(null);
@@ -143,17 +162,25 @@ function PageActions({ copyMarkdown, copyMarkdownLabel = "Copy page", copyMarkdo
 	const handleCopyMarkdown = useCallback(async () => {
 		try {
 			let content = "";
-			try {
+			if (copyMarkdownFormat === "markdown") try {
 				const response = await fetch(markdownHref, { headers: { Accept: "text/markdown" } });
 				if (response.ok) content = await response.text();
 			} catch {}
 			if (!content) content = document.querySelector("article")?.innerText || "";
 			if (!content) return;
+			content = formatCopyMarkdownContent({
+				content,
+				format: copyMarkdownFormat,
+				includeTitle: copyMarkdownIncludeTitle,
+				title: currentPageTitle()
+			});
 			await navigator.clipboard.writeText(content);
 			if (analytics) emitClientAnalyticsEvent({
 				type: "page_action_copy_markdown",
 				properties: {
 					contentLength: content.length,
+					format: copyMarkdownFormat,
+					includeTitle: copyMarkdownIncludeTitle,
 					pathname
 				}
 			});
@@ -162,6 +189,8 @@ function PageActions({ copyMarkdown, copyMarkdownLabel = "Copy page", copyMarkdo
 		} catch {}
 	}, [
 		analytics,
+		copyMarkdownFormat,
+		copyMarkdownIncludeTitle,
 		markdownHref,
 		pathname
 	]);
@@ -238,6 +267,8 @@ function PageActions({ copyMarkdown, copyMarkdownLabel = "Copy page", copyMarkdo
 				onClick: handleCopyMarkdown,
 				className: "fd-page-action-btn",
 				"data-copied": copied,
+				"data-copy-markdown-format": copyMarkdownFormat,
+				"data-copy-markdown-include-title": copyMarkdownIncludeTitle || void 0,
 				children: [copied ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx(CopyIcon, {}), /* @__PURE__ */ jsx("span", { children: copied ? copyMarkdownCopiedLabel : copyMarkdownLabel })]
 			}),
 			openDocs && /* @__PURE__ */ jsxs("a", {
@@ -271,6 +302,8 @@ function PageActions({ copyMarkdown, copyMarkdownLabel = "Copy page", copyMarkdo
 			onClick: handleCopyMarkdown,
 			className: "fd-page-action-btn",
 			"data-copied": copied,
+			"data-copy-markdown-format": copyMarkdownFormat,
+			"data-copy-markdown-include-title": copyMarkdownIncludeTitle || void 0,
 			children: [copied ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx(CopyIcon, {}), /* @__PURE__ */ jsx("span", { children: copied ? copyMarkdownCopiedLabel : copyMarkdownLabel })]
 		}), openDocs && resolvedProviders.length > 0 && /* @__PURE__ */ jsxs("div", {
 			ref: dropdownRef,
@@ -320,4 +353,4 @@ function PageActions({ copyMarkdown, copyMarkdownLabel = "Copy page", copyMarkdo
 }
 
 //#endregion
-export { PageActions };
+export { PageActions, formatCopyMarkdownContent };

package/dist/tanstack-layout.mjs

@@ -357,6 +357,8 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 					entry: config.entry ?? "docs",
 					locale,
 					copyMarkdown: copyMarkdownEnabled,
+					copyMarkdownFormat: copyMarkdownConfig?.format,
+					copyMarkdownIncludeTitle: copyMarkdownConfig?.includeTitle,
 					copyMarkdownLabel: copyMarkdownConfig?.label,
 					copyMarkdownCopiedLabel: copyMarkdownConfig?.copiedLabel,
 					openDocs: openDocsEnabled,

package/package.json

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