@farming-labs/theme 0.1.47 → 0.1.48

package/dist/docs-layout.mjs

@@ -3,7 +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 { resolveReadingTimeFromContent, resolveReadingTimeOptions } from "./reading-time.mjs";
+import { resolvePageReadingTime, resolveReadingTimeOptions } from "./reading-time.mjs";
 import { SidebarSearchWithAI } from "./sidebar-search-ai.mjs";
 import { LocaleThemeControl } from "./locale-theme-control.mjs";
 import fs from "node:fs";
@@ -341,7 +341,7 @@ function buildDescriptionMap(config, ctx) {
 	scan(docsDir, []);
 	return map;
 }
-function buildReadingTimeMap(config, ctx, wordsPerMinute) {
+function buildReadingTimeMap(config, ctx, options) {
 	const docsDir = ctx.docsDir;
 	const map = {};
 	const excludedDirs = getExcludedDocsDirs(config, ctx);
@@ -351,8 +351,8 @@ function buildReadingTimeMap(config, ctx, wordsPerMinute) {
 		const pagePath = path.join(dir, "page.mdx");
 		if (fs.existsSync(pagePath)) {
 			const { data, content } = matter(fs.readFileSync(pagePath, "utf-8"));
-			const minutes = resolveReadingTimeFromContent(data, resolveDocsAgentMdxContent(content, "human"), wordsPerMinute);
-			if (minutes !== null) {
+			const minutes = resolvePageReadingTime(data, resolveDocsAgentMdxContent(content, "human"), options);
+			if (typeof minutes === "number") {
 				const url = slugParts.length === 0 ? `/${ctx.entryPath}` : `/${ctx.entryPath}/${slugParts.join("/")}`;
 				map[url] = minutes;
 			}
@@ -582,7 +582,7 @@ function createDocsLayout(config, options) {
 	const lastUpdatedEnabled = lastUpdatedRaw !== false && (typeof lastUpdatedRaw !== "object" || lastUpdatedRaw.enabled !== false);
 	const lastUpdatedPosition = typeof lastUpdatedRaw === "object" ? lastUpdatedRaw.position ?? "footer" : "footer";
 	const readingTimeOptions = resolveReadingTimeOptions(config.readingTime);
-	const readingTimeEnabled = readingTimeOptions.enabled;
+	const readingTimeEnabledByDefault = readingTimeOptions.enabled;
 	const readingTimeWordsPerMinute = readingTimeOptions.wordsPerMinute ?? 220;
 	const llmsTxtEnabled = resolveBool(config.llmsTxt);
 	const feedbackConfig = resolveFeedbackConfig(config.feedback);
@@ -616,7 +616,11 @@ function createDocsLayout(config, options) {
 	}
 	const lastModifiedMap = buildLastModifiedMap(config, localeContext);
 	const descriptionMap = buildDescriptionMap(config, localeContext);
-	const readingTimeMap = readingTimeEnabled ? buildReadingTimeMap(config, localeContext, readingTimeWordsPerMinute) : {};
+	const readingTimeMap = buildReadingTimeMap(config, localeContext, {
+		enabledByDefault: readingTimeEnabledByDefault,
+		wordsPerMinute: readingTimeWordsPerMinute
+	});
+	const readingTimeEnabled = readingTimeEnabledByDefault || Object.keys(readingTimeMap).length > 0;
 	return function DocsLayoutWrapper({ children }) {
 		const tree = buildTree(config, localeContext, !!sidebarFlat);
 		const localizedTree = i18n ? localizeTreeUrls(tree, activeLocale) : tree;

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

@@ -42,8 +42,11 @@ interface DocsPageClientProps {
   /** Map of pathname → reading time in minutes */
   readingTimeMap?: Record<string, number>;
   /** Direct reading-time override for the current page. */
-  readingTime?: number;
-  /** Whether to show estimated reading time at the top of the page. */
+  readingTime?: number | null;
+  /**
+   * Whether path-based reading time values should render by default.
+   * Explicit `readingTime` overrides can still render when this is false.
+   */
   readingTimeEnabled?: boolean;
   /** Whether to show "Last updated" at all */
   lastUpdatedEnabled?: boolean;

package/dist/docs-page-client.mjs

@@ -172,7 +172,8 @@ function DocsPageClient({ tocEnabled, tocStyle = "default", breadcrumbEnabled =
 	const pageDescription = description ?? descriptionMap?.[pathname.replace(/\/$/, "") || "/"];
 	const normalizedPath = (browserPath ?? pathname).replace(/\/$/, "") || "/";
 	const isChangelogRoute = !!(changelogBasePath && (normalizedPath === changelogBasePath || normalizedPath.startsWith(`${changelogBasePath}/`)));
-	const resolvedReadingTime = !isChangelogRoute && readingTimeEnabled ? readingTimeProp ?? readingTimeMap?.[normalizedPath] : void 0;
+	const matchedReadingTime = readingTimeMap?.[normalizedPath];
+	const resolvedReadingTime = !isChangelogRoute ? readingTimeProp !== void 0 ? readingTimeProp : readingTimeEnabled ? matchedReadingTime : void 0 : void 0;
 	const effectiveTocEnabled = isChangelogRoute ? false : tocEnabled;
 	const effectiveBreadcrumbEnabled = isChangelogRoute ? false : breadcrumbEnabled;
 	useEffect(() => {

package/dist/reading-time.mjs

@@ -1,6 +1,9 @@
 import matter from "gray-matter";
 
 //#region src/reading-time.ts
+function hasExplicitReadingTime(frontmatter) {
+	return Object.prototype.hasOwnProperty.call(frontmatter ?? {}, "readingTime");
+}
 function normalizeWordsPerMinute(wordsPerMinute) {
 	if (typeof wordsPerMinute !== "number" || !Number.isFinite(wordsPerMinute)) return 220;
 	return Math.max(1, Math.floor(wordsPerMinute));
@@ -27,6 +30,10 @@ function resolveReadingTimeFromContent(frontmatter, content, wordsPerMinute) {
 	if (typeof pageData.readingTime === "number" && Number.isFinite(pageData.readingTime)) return Math.max(1, Math.ceil(pageData.readingTime));
 	return estimateReadingTimeMinutes(content, wordsPerMinute);
 }
+function resolvePageReadingTime(frontmatter, content, options) {
+	if (!(options?.enabledByDefault ?? false) && !hasExplicitReadingTime(frontmatter)) return;
+	return resolveReadingTimeFromContent(frontmatter, content, options?.wordsPerMinute);
+}
 
 //#endregion
-export { resolveReadingTimeFromContent, resolveReadingTimeOptions };
+export { resolvePageReadingTime, resolveReadingTimeOptions };

package/package.json

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