@farming-labs/theme 0.2.18 → 0.2.21

package/dist/docs-feedback.d.mts

@@ -12,6 +12,8 @@ interface DocsFeedbackProps {
   positiveLabel?: string;
   negativeLabel?: string;
   submitLabel?: string;
+  successMessage?: string;
+  errorMessage?: string;
   onFeedback?: (data: DocsFeedbackData) => void | Promise<void>;
   analytics?: boolean;
 }
@@ -25,6 +27,8 @@ declare function DocsFeedback({
   positiveLabel,
   negativeLabel,
   submitLabel,
+  successMessage,
+  errorMessage,
   onFeedback,
   analytics
 }: DocsFeedbackProps): react_jsx_runtime0.JSX.Element;

package/dist/docs-feedback.mjs

@@ -116,7 +116,7 @@ function CheckIcon() {
 		})
 	});
 }
-function DocsFeedback({ pathname, entry, locale, question = "How is this guide?", placeholder = "Leave your feedback...", requireComment = false, positiveLabel = "Good", negativeLabel = "Bad", submitLabel = "Submit", onFeedback, analytics = false }) {
+function DocsFeedback({ pathname, entry, locale, question = "How is this guide?", placeholder = "Share what could be clearer...", requireComment = false, positiveLabel = "Good", negativeLabel = "Bad", submitLabel = "Submit", successMessage = "Thanks for the feedback.", errorMessage = "Could not send feedback. Please try again.", onFeedback, analytics = false }) {
 	const [selected, setSelected] = useState(null);
 	const [comment, setComment] = useState("");
 	const [status, setStatus] = useState("idle");
@@ -251,7 +251,7 @@ function DocsFeedback({ pathname, entry, locale, question = "How is this guide?"
 						"data-status": "success",
 						role: "status",
 						"aria-live": "polite",
-						children: "Thanks for the feedback."
+						children: successMessage
 					})]
 				}),
 				status === "error" && /* @__PURE__ */ jsx("p", {
@@ -259,7 +259,7 @@ function DocsFeedback({ pathname, entry, locale, question = "How is this guide?"
 					"data-status": "error",
 					role: "status",
 					"aria-live": "polite",
-					children: "Could not send feedback. Please try again."
+					children: errorMessage
 				})
 			]
 		})]

package/dist/docs-layout.mjs

@@ -658,11 +658,13 @@ function createDocsLayout(config, options) {
 	const pageActionsAlignment = pageActions?.alignment ?? "left";
 	const lastUpdatedRaw = config.lastUpdated;
 	const lastUpdatedEnabled = lastUpdatedRaw !== false && (typeof lastUpdatedRaw !== "object" || lastUpdatedRaw.enabled !== false);
+	const lastUpdatedLabel = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.label ?? "Last updated" : "Last updated";
 	const lastUpdatedPosition = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.position ?? "footer" : "footer";
 	const readingTimeOptions = resolveReadingTimeOptions(config.readingTime);
 	const readingTimeEnabledByDefault = readingTimeOptions.enabled;
 	const readingTimeWordsPerMinute = readingTimeOptions.wordsPerMinute ?? 220;
 	const readingTimeFormat = readingTimeOptions.format;
+	const readingTimeIncludeCode = readingTimeOptions.includeCode;
 	const llmsTxtEnabled = resolveEnabledByDefault(config.llmsTxt);
 	const feedbackConfig = resolveFeedbackConfig(config.feedback);
 	const openDocsConfig = pageActions?.openDocs && typeof pageActions.openDocs === "object" ? pageActions.openDocs : void 0;
@@ -699,7 +701,8 @@ function createDocsLayout(config, options) {
 	const descriptionMap = buildDescriptionMap(config, localeContext);
 	const readingTimeMap = buildReadingTimeMap(config, localeContext, {
 		enabledByDefault: readingTimeEnabledByDefault,
-		wordsPerMinute: readingTimeWordsPerMinute
+		wordsPerMinute: readingTimeWordsPerMinute,
+		includeCode: readingTimeIncludeCode
 	});
 	const structuredDataMap = buildStructuredDataMap(config, localeContext);
 	const readingTimeEnabled = readingTimeEnabledByDefault || Object.keys(readingTimeMap).length > 0;
@@ -807,6 +810,7 @@ function createDocsLayout(config, options) {
 						githubDirectory,
 						lastModifiedMap,
 						lastUpdatedEnabled,
+						lastUpdatedLabel,
 						lastUpdatedPosition,
 						readingTimeEnabled,
 						readingTimeFormat,
@@ -821,6 +825,8 @@ function createDocsLayout(config, options) {
 						feedbackPositiveLabel: feedbackConfig.positiveLabel,
 						feedbackNegativeLabel: feedbackConfig.negativeLabel,
 						feedbackSubmitLabel: feedbackConfig.submitLabel,
+						feedbackSuccessMessage: feedbackConfig.successMessage,
+						feedbackErrorMessage: feedbackConfig.errorMessage,
 						analytics: analyticsEnabled,
 						children
 					})
@@ -844,18 +850,20 @@ function resolveFeedbackConfig(feedback) {
 	const defaults = {
 		enabled: false,
 		question: "How is this guide?",
-		placeholder: "Leave your feedback...",
+		placeholder: "Share what could be clearer...",
 		requireComment: false,
 		positiveLabel: "Good",
 		negativeLabel: "Bad",
-		submitLabel: "Submit"
+		submitLabel: "Submit",
+		successMessage: "Thanks for the feedback.",
+		errorMessage: "Could not send feedback. Please try again."
 	};
 	if (feedback === void 0 || feedback === false) return defaults;
 	if (feedback === true) return {
 		...defaults,
 		enabled: true
 	};
-	const hasHumanFeedbackConfig = feedback.enabled !== void 0 || feedback.question !== void 0 || feedback.placeholder !== void 0 || feedback.requireComment !== void 0 || feedback.positiveLabel !== void 0 || feedback.negativeLabel !== void 0 || feedback.submitLabel !== void 0 || feedback.onFeedback !== void 0;
+	const hasHumanFeedbackConfig = feedback.enabled !== void 0 || feedback.question !== void 0 || feedback.placeholder !== void 0 || feedback.requireComment !== void 0 || feedback.positiveLabel !== void 0 || feedback.negativeLabel !== void 0 || feedback.submitLabel !== void 0 || feedback.successMessage !== void 0 || feedback.errorMessage !== void 0 || feedback.onFeedback !== void 0;
 	return {
 		enabled: feedback.enabled === true || feedback.enabled !== false && hasHumanFeedbackConfig,
 		question: feedback.question ?? defaults.question,
@@ -863,7 +871,9 @@ function resolveFeedbackConfig(feedback) {
 		requireComment: feedback.requireComment ?? defaults.requireComment,
 		positiveLabel: feedback.positiveLabel ?? defaults.positiveLabel,
 		negativeLabel: feedback.negativeLabel ?? defaults.negativeLabel,
-		submitLabel: feedback.submitLabel ?? defaults.submitLabel
+		submitLabel: feedback.submitLabel ?? defaults.submitLabel,
+		successMessage: feedback.successMessage ?? defaults.successMessage,
+		errorMessage: feedback.errorMessage ?? defaults.errorMessage
 	};
 }
 /**

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

@@ -66,6 +66,8 @@ interface DocsPageClientProps {
   readingTimeEnabled?: boolean;
   /** Whether to show "Last updated" at all */
   lastUpdatedEnabled?: boolean;
+  /** Label shown before the formatted last-updated date */
+  lastUpdatedLabel?: string;
   /** Where to show the "Last updated" date: "footer" (next to Edit on GitHub) or "below-title" */
   lastUpdatedPosition?: "footer" | "below-title";
   /** Whether llms.txt is enabled — shows links in footer */
@@ -82,6 +84,8 @@ interface DocsPageClientProps {
   feedbackPositiveLabel?: string;
   feedbackNegativeLabel?: string;
   feedbackSubmitLabel?: string;
+  feedbackSuccessMessage?: string;
+  feedbackErrorMessage?: string;
   feedbackOnFeedback?: (data: DocsFeedbackData) => void | Promise<void>;
   analytics?: boolean;
   children: ReactNode;
@@ -119,6 +123,7 @@ declare function DocsPageClient({
   structuredData: structuredDataProp,
   readingTimeEnabled,
   lastUpdatedEnabled,
+  lastUpdatedLabel,
   lastUpdatedPosition,
   llmsTxtEnabled,
   descriptionMap,
@@ -130,6 +135,8 @@ declare function DocsPageClient({
   feedbackPositiveLabel,
   feedbackNegativeLabel,
   feedbackSubmitLabel,
+  feedbackSuccessMessage,
+  feedbackErrorMessage,
   feedbackOnFeedback,
   analytics,
   children

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, 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 }) {
+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, lastUpdatedLabel = "Last updated", lastUpdatedPosition = "footer", llmsTxtEnabled = false, descriptionMap, description, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackRequireComment, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackSuccessMessage, feedbackErrorMessage, feedbackOnFeedback, analytics = false, children }) {
 	const fdTocStyle = tocStyle === "directional" ? "clerk" : void 0;
 	const [toc, setToc] = useState([]);
 	const [titlePortalHost, setTitlePortalHost] = useState(null);
@@ -434,6 +434,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 	const lastModified = !isChangelogRoute && lastUpdatedEnabled ? lastModifiedProp ?? lastModifiedMap?.[normalizedPath] : void 0;
 	const showLastUpdatedBelowTitle = !!lastModified && lastUpdatedPosition === "below-title";
 	const showLastUpdatedInFooter = !!lastModified && lastUpdatedPosition === "footer";
+	const lastUpdatedLabelText = lastUpdatedLabel.trim();
+	const lastUpdatedText = lastUpdatedLabelText && lastModified ? `${lastUpdatedLabelText} ${lastModified}` : lastModified;
 	const showFooter = !isChangelogRoute && (!!githubFileUrl || showLastUpdatedInFooter || llmsTxtEnabled);
 	const readingTimeBlock = typeof resolvedReadingTime === "number" ? /* @__PURE__ */ jsxs("div", {
 		className: "fd-page-meta not-prose",
@@ -455,9 +457,9 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 	const belowTitleBlock = showLastUpdatedBelowTitle || showActionsBelowTitle || showReadingTimeBelowTitle ? /* @__PURE__ */ jsxs("div", {
 		className: "fd-below-title-block not-prose",
 		children: [
-			showLastUpdatedBelowTitle && /* @__PURE__ */ jsxs("p", {
+			showLastUpdatedBelowTitle && /* @__PURE__ */ jsx("p", {
 				className: "fd-last-updated-inline",
-				children: ["Last updated ", lastModified]
+				children: lastUpdatedText
 			}, "last-updated"),
 			/* @__PURE__ */ jsx("hr", { className: "fd-title-separator" }, "separator"),
 			showActionsBelowTitle && /* @__PURE__ */ jsx("div", {
@@ -605,6 +607,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 							positiveLabel: feedbackPositiveLabel,
 							negativeLabel: feedbackNegativeLabel,
 							submitLabel: feedbackSubmitLabel,
+							successMessage: feedbackSuccessMessage,
+							errorMessage: feedbackErrorMessage,
 							onFeedback: feedbackOnFeedback,
 							analytics
 						}, "feedback"),
@@ -628,9 +632,9 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 										children: "llms-full.txt"
 									})]
 								}, "llms-links"),
-								showLastUpdatedInFooter && lastModified && /* @__PURE__ */ jsxs("span", {
+								showLastUpdatedInFooter && lastModified && /* @__PURE__ */ jsx("span", {
 									className: "fd-last-updated-footer",
-									children: ["Last updated ", lastModified]
+									children: lastUpdatedText
 								}, "last-updated")
 							]
 						}, "footer")

package/dist/reading-time.mjs

@@ -8,41 +8,46 @@ function normalizeWordsPerMinute(wordsPerMinute) {
 	if (typeof wordsPerMinute !== "number" || !Number.isFinite(wordsPerMinute)) return 220;
 	return Math.max(1, Math.floor(wordsPerMinute));
 }
-function stripNonReadingContent(content) {
-	return content.replace(/(`{3,})[^\n]*\n[\s\S]*?\1/g, " ").replace(/(~{3,})[^\n]*\n[\s\S]*?\1/g, " ").replace(/`[^`\n]+`/g, " ").replace(/!\[[^\]]*\]\([^)]+\)/g, " ").replace(/\[([^\]]+)\]\([^)]+\)/g, " $1 ").replace(/<[^>]+>/g, " ").replace(/\{[^{}]*\}/g, " ").replace(/https?:\/\/\S+/g, " ").replace(/[#>*_~|]/g, " ");
+function stripNonReadingContent(content, options) {
+	const includeCode = options?.includeCode === true;
+	return (includeCode ? content.replace(/^(`{3,}|~{3,})[^\n]*$/gm, " ").replace(/`([^`\n]+)`/g, " $1 ") : content.replace(/(`{3,})[^\n]*\n[\s\S]*?\1/g, " ").replace(/(~{3,})[^\n]*\n[\s\S]*?\1/g, " ").replace(/`[^`\n]+`/g, " ")).replace(/!\[[^\]]*\]\([^)]+\)/g, " ").replace(/\[([^\]]+)\]\([^)]+\)/g, " $1 ").replace(/<[^>]+>/g, " ").replace(includeCode ? /[{}]/g : /\{[^{}]*\}/g, " ").replace(/https?:\/\/\S+/g, " ").replace(/[#>*_~|]/g, " ");
 }
-function estimateReadingTimeMinutes(content, wordsPerMinute) {
-	const wordCount = stripNonReadingContent(content).match(/\b[\p{L}\p{N}][\p{L}\p{N}'’-]*\b/gu)?.length ?? 0;
+function estimateReadingTimeMinutes(content, wordsPerMinute, options) {
+	const wordCount = stripNonReadingContent(content, options).match(/\b[\p{L}\p{N}][\p{L}\p{N}'’-]*\b/gu)?.length ?? 0;
 	return Math.max(1, Math.ceil(wordCount / normalizeWordsPerMinute(wordsPerMinute)));
 }
 function resolveReadingTimeOptions(readingTime) {
 	if (readingTime === true) return {
 		enabled: true,
-		format: "long"
+		format: "long",
+		includeCode: false
 	};
 	if (readingTime === false || readingTime === void 0 || readingTime === null) return {
 		enabled: false,
-		format: "long"
+		format: "long",
+		includeCode: false
 	};
 	if (typeof readingTime !== "object") return {
 		enabled: false,
-		format: "long"
+		format: "long",
+		includeCode: false
 	};
 	return {
 		enabled: readingTime.enabled !== false,
 		wordsPerMinute: typeof readingTime.wordsPerMinute === "number" && Number.isFinite(readingTime.wordsPerMinute) ? readingTime.wordsPerMinute : void 0,
-		format: readingTime.format === "short" ? "short" : "long"
+		format: readingTime.format === "short" ? "short" : "long",
+		includeCode: readingTime.includeCode === true
 	};
 }
-function resolveReadingTimeFromContent(frontmatter, content, wordsPerMinute) {
+function resolveReadingTimeFromContent(frontmatter, content, wordsPerMinute, options) {
 	const pageData = frontmatter ?? {};
 	if (pageData.readingTime === false) return null;
 	if (typeof pageData.readingTime === "number" && Number.isFinite(pageData.readingTime)) return Math.max(1, Math.ceil(pageData.readingTime));
-	return estimateReadingTimeMinutes(content, wordsPerMinute);
+	return estimateReadingTimeMinutes(content, wordsPerMinute, options);
 }
 function resolvePageReadingTime(frontmatter, content, options) {
 	if (!(options?.enabledByDefault ?? false) && !hasExplicitReadingTime(frontmatter)) return;
-	return resolveReadingTimeFromContent(frontmatter, content, options?.wordsPerMinute);
+	return resolveReadingTimeFromContent(frontmatter, content, options?.wordsPerMinute, { includeCode: options?.includeCode });
 }
 
 //#endregion

package/dist/tanstack-layout.mjs

@@ -192,18 +192,20 @@ function resolveFeedbackConfig(feedback) {
 	const defaults = {
 		enabled: false,
 		question: "How is this guide?",
-		placeholder: "Leave your feedback...",
+		placeholder: "Share what could be clearer...",
 		requireComment: false,
 		positiveLabel: "Good",
 		negativeLabel: "Bad",
-		submitLabel: "Submit"
+		submitLabel: "Submit",
+		successMessage: "Thanks for the feedback.",
+		errorMessage: "Could not send feedback. Please try again."
 	};
 	if (feedback === void 0 || feedback === false) return defaults;
 	if (feedback === true) return {
 		...defaults,
 		enabled: true
 	};
-	const hasHumanFeedbackConfig = feedback.enabled !== void 0 || feedback.question !== void 0 || feedback.placeholder !== void 0 || feedback.requireComment !== void 0 || feedback.positiveLabel !== void 0 || feedback.negativeLabel !== void 0 || feedback.submitLabel !== void 0 || feedback.onFeedback !== void 0;
+	const hasHumanFeedbackConfig = feedback.enabled !== void 0 || feedback.question !== void 0 || feedback.placeholder !== void 0 || feedback.requireComment !== void 0 || feedback.positiveLabel !== void 0 || feedback.negativeLabel !== void 0 || feedback.submitLabel !== void 0 || feedback.successMessage !== void 0 || feedback.errorMessage !== void 0 || feedback.onFeedback !== void 0;
 	return {
 		enabled: feedback.enabled === true || feedback.enabled !== false && hasHumanFeedbackConfig,
 		question: feedback.question ?? defaults.question,
@@ -211,7 +213,9 @@ function resolveFeedbackConfig(feedback) {
 		requireComment: feedback.requireComment ?? defaults.requireComment,
 		positiveLabel: feedback.positiveLabel ?? defaults.positiveLabel,
 		negativeLabel: feedback.negativeLabel ?? defaults.negativeLabel,
-		submitLabel: feedback.submitLabel ?? defaults.submitLabel
+		submitLabel: feedback.submitLabel ?? defaults.submitLabel,
+		successMessage: feedback.successMessage ?? defaults.successMessage,
+		errorMessage: feedback.errorMessage ?? defaults.errorMessage
 	};
 }
 function ForcedThemeScript({ theme }) {
@@ -246,6 +250,7 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 	const pageActionsAlignment = pageActions?.alignment ?? "left";
 	const lastUpdatedRaw = config.lastUpdated;
 	const lastUpdatedEnabled = lastUpdatedRaw !== false && (typeof lastUpdatedRaw !== "object" || lastUpdatedRaw.enabled !== false);
+	const lastUpdatedLabel = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.label ?? "Last updated" : "Last updated";
 	const lastUpdatedPosition = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.position ?? "footer" : "footer";
 	const readingTimeOptions = resolveReadingTimeOptions(config.readingTime);
 	const readingTimeEnabled = readingTimeOptions.enabled;
@@ -369,6 +374,7 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 					pageActionsAlignment,
 					editOnGithubUrl,
 					lastUpdatedEnabled,
+					lastUpdatedLabel,
 					lastUpdatedPosition,
 					lastModified,
 					readingTimeEnabled,
@@ -383,6 +389,8 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 					feedbackPositiveLabel: feedbackConfig.positiveLabel,
 					feedbackNegativeLabel: feedbackConfig.negativeLabel,
 					feedbackSubmitLabel: feedbackConfig.submitLabel,
+					feedbackSuccessMessage: feedbackConfig.successMessage,
+					feedbackErrorMessage: feedbackConfig.errorMessage,
 					analytics: analyticsEnabled,
 					children
 				})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.2.18",
+  "version": "0.2.21",
   "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.18"
+    "@farming-labs/docs": "0.2.21"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",