@farming-labs/theme 0.2.17 → 0.2.18

package/dist/docs-layout.mjs

@@ -792,6 +792,7 @@ function createDocsLayout(config, options) {
 						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

@@ -24,6 +24,7 @@ interface DocsPageClientProps {
   locale?: string;
   copyMarkdown?: boolean;
   copyMarkdownFormat?: CopyMarkdownFormat;
+  copyMarkdownIncludeTitle?: boolean;
   copyMarkdownLabel?: string;
   copyMarkdownCopiedLabel?: string;
   openDocs?: boolean;
@@ -95,6 +96,7 @@ declare function DocsPageClient({
   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, copyMarkdownFormat, 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);
@@ -466,6 +466,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 				children: /* @__PURE__ */ jsx(PageActions, {
 					copyMarkdown,
 					copyMarkdownFormat,
+					copyMarkdownIncludeTitle,
 					copyMarkdownLabel,
 					copyMarkdownCopiedLabel,
 					openDocs,
@@ -512,6 +513,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 		children: /* @__PURE__ */ jsx(PageActions, {
 			copyMarkdown,
 			copyMarkdownFormat,
+			copyMarkdownIncludeTitle,
 			copyMarkdownLabel,
 			copyMarkdownCopiedLabel,
 			openDocs,
@@ -567,6 +569,7 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 						children: /* @__PURE__ */ jsx(PageActions, {
 							copyMarkdown,
 							copyMarkdownFormat,
+							copyMarkdownIncludeTitle,
 							copyMarkdownLabel,
 							copyMarkdownCopiedLabel,
 							openDocs,

package/dist/page-actions.d.mts

@@ -13,6 +13,7 @@ interface SerializedProvider {
 interface PageActionsProps {
   copyMarkdown?: boolean;
   copyMarkdownFormat?: CopyMarkdownFormat;
+  copyMarkdownIncludeTitle?: boolean;
   copyMarkdownLabel?: string;
   copyMarkdownCopiedLabel?: string;
   openDocs?: boolean;
@@ -25,9 +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,
@@ -40,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, copyMarkdownFormat = "markdown", 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);
@@ -149,12 +168,19 @@ function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdo
 			} 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
 				}
 			});
@@ -164,6 +190,7 @@ function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdo
 	}, [
 		analytics,
 		copyMarkdownFormat,
+		copyMarkdownIncludeTitle,
 		markdownHref,
 		pathname
 	]);
@@ -241,6 +268,7 @@ function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdo
 				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", {
@@ -275,6 +303,7 @@ function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", copyMarkdo
 			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,
@@ -324,4 +353,4 @@ function PageActions({ copyMarkdown, copyMarkdownFormat = "markdown", 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.17",
+  "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.17"
+    "@farming-labs/docs": "0.2.18"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",