@farming-labs/theme 0.2.97 → 0.2.99

package/dist/reading-time-options.mjs

@@ -0,0 +1,27 @@
+//#region src/reading-time-options.ts
+function resolveReadingTimeOptions(readingTime) {
+	if (readingTime === true) return {
+		enabled: true,
+		format: "long",
+		includeCode: false
+	};
+	if (readingTime === false || readingTime === void 0 || readingTime === null) return {
+		enabled: false,
+		format: "long",
+		includeCode: false
+	};
+	if (typeof readingTime !== "object") return {
+		enabled: false,
+		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",
+		includeCode: readingTime.includeCode === true
+	};
+}
+
+//#endregion
+export { resolveReadingTimeOptions };

package/dist/reading-time.mjs

@@ -1,3 +1,4 @@
+import { resolveReadingTimeOptions } from "./reading-time-options.mjs";
 import matter from "gray-matter";
 
 //#region src/reading-time.ts
@@ -16,29 +17,6 @@ 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",
-		includeCode: false
-	};
-	if (readingTime === false || readingTime === void 0 || readingTime === null) return {
-		enabled: false,
-		format: "long",
-		includeCode: false
-	};
-	if (typeof readingTime !== "object") return {
-		enabled: false,
-		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",
-		includeCode: readingTime.includeCode === true
-	};
-}
 function resolveReadingTimeFromContent(frontmatter, content, wordsPerMinute, options) {
 	const pageData = frontmatter ?? {};
 	if (pageData.readingTime === false) return null;
@@ -51,4 +29,4 @@ function resolvePageReadingTime(frontmatter, content, options) {
 }
 
 //#endregion
-export { resolvePageReadingTime, resolveReadingTimeOptions };
+export { resolvePageReadingTime };

package/dist/tablet-sidebar-bridge.mjs

@@ -0,0 +1,64 @@
+"use client";
+
+import { useEffect, useRef, useState } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { useSidebar } from "fumadocs-ui/components/sidebar/base";
+
+//#region src/tablet-sidebar-bridge.tsx
+const tabletSidebarQuery = "(min-width: 768px) and (max-width: 1023px)";
+/**
+* Extends Fumadocs' sidebar state through the tablet breakpoint without
+* intercepting its trigger or cloning the configured navigation tree.
+*/
+function TabletSidebarBridge() {
+	const { open, setOpen } = useSidebar();
+	const [isTablet, setIsTablet] = useState(false);
+	const closeButtonRef = useRef(null);
+	const returnFocusRef = useRef(null);
+	const visible = isTablet && open;
+	useEffect(() => {
+		const media = window.matchMedia(tabletSidebarQuery);
+		const update = () => setIsTablet(media.matches);
+		update();
+		media.addEventListener("change", update);
+		return () => media.removeEventListener("change", update);
+	}, []);
+	useEffect(() => {
+		if (!visible) return;
+		returnFocusRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+		closeButtonRef.current?.focus();
+		const closeOnEscape = (event) => {
+			if (event.key !== "Escape") return;
+			event.preventDefault();
+			setOpen(false);
+		};
+		window.addEventListener("keydown", closeOnEscape);
+		return () => {
+			window.removeEventListener("keydown", closeOnEscape);
+			returnFocusRef.current?.focus();
+			returnFocusRef.current = null;
+		};
+	}, [setOpen, visible]);
+	if (!isTablet) return null;
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("span", {
+		hidden: true,
+		"aria-hidden": "true",
+		"data-fd-tablet-sidebar-state": visible ? "open" : "closed"
+	}), visible && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("button", {
+		type: "button",
+		tabIndex: -1,
+		"aria-hidden": "true",
+		className: "fd-tablet-sidebar-backdrop",
+		onClick: () => setOpen(false)
+	}), /* @__PURE__ */ jsx("button", {
+		ref: closeButtonRef,
+		type: "button",
+		"aria-label": "Close Sidebar",
+		className: "fd-tablet-sidebar-close",
+		onClick: () => setOpen(false),
+		children: /* @__PURE__ */ jsx("span", { "aria-hidden": "true" })
+	})] })] });
+}
+
+//#endregion
+export { TabletSidebarBridge };

package/dist/tanstack-layout.d.mts

@@ -29,6 +29,7 @@ interface TanstackDocsLayoutProps {
   tree: TreeRoot;
   locale?: string;
   description?: string;
+  descriptionInBody?: boolean;
   readingTime?: number | null;
   lastModified?: string;
   previousPage?: {
@@ -48,6 +49,7 @@ declare function TanstackDocsLayout({
   tree,
   locale,
   description,
+  descriptionInBody,
   readingTime,
   lastModified,
   previousPage,

package/dist/tanstack-layout.mjs

@@ -1,17 +1,18 @@
+import { resolveOpenDocsProviders } from "./open-docs-providers.mjs";
 import { withLangInUrl } from "./i18n.mjs";
 import { escapeJsonLdForScript } from "./json-ld.mjs";
 import { DocsPageClient } from "./docs-page-client.mjs";
 import { DocsAIFeatures } from "./docs-ai-features.mjs";
 import { resolveDocsCloudAIClientRequest } from "./docs-cloud-ai-client.mjs";
 import { DocsCommandSearch } from "./docs-command-search.mjs";
-import { resolveOpenDocsProviders } from "./open-docs-providers.mjs";
-import { resolveReadingTimeOptions } from "./reading-time.mjs";
+import { resolveReadingTimeOptions } from "./reading-time-options.mjs";
 import { SidebarSearchWithAI } from "./sidebar-search-ai.mjs";
+import { TabletSidebarBridge } from "./tablet-sidebar-bridge.mjs";
 import { LocaleThemeControl } from "./locale-theme-control.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import { Suspense } from "react";
-import { applySidebarFolderIndexBehavior, resolveDocsAnalyticsConfig } from "@farming-labs/docs";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { applySidebarFolderIndexBehavior, resolveDocsAnalyticsConfig } from "@farming-labs/docs/browser";
 
 //#region src/tanstack-layout.tsx
 function resolveTreeIcon(icon, registry) {
@@ -223,7 +224,7 @@ function resolveFeedbackConfig(feedback) {
 function ForcedThemeScript({ theme }) {
 	return /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: `document.documentElement.classList.remove('light','dark');document.documentElement.classList.add('${theme === "light" || theme === "dark" ? theme : "light"}');` } });
 }
-function TanstackDocsLayout({ config, tree, locale, description, readingTime, lastModified, previousPage, nextPage, structuredData, editOnGithubUrl, children }) {
+function TanstackDocsLayout({ config, tree, locale, description, descriptionInBody, readingTime, lastModified, previousPage, nextPage, structuredData, editOnGithubUrl, children }) {
 	const tocConfig = config.theme?.ui?.layout?.toc;
 	const tocEnabled = tocConfig?.enabled !== false;
 	const tocStyle = tocConfig?.style;
@@ -328,6 +329,7 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 			/* @__PURE__ */ jsx(TypographyStyle, { typography }),
 			/* @__PURE__ */ jsx(LayoutStyle, { layout: layoutDimensions }),
 			forcedTheme && /* @__PURE__ */ jsx(ForcedThemeScript, { theme: forcedTheme }),
+			config.theme?.name === "fumadocs-pixel-border" && /* @__PURE__ */ jsx(TabletSidebarBridge, {}),
 			!staticExport && /* @__PURE__ */ jsx(Suspense, {
 				fallback: null,
 				children: /* @__PURE__ */ jsx(DocsCommandSearch, {
@@ -359,6 +361,7 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 				fallback: children,
 				children: /* @__PURE__ */ jsx(DocsPageClient, {
 					tocEnabled,
+					themeName: config.theme?.name,
 					tocStyle,
 					breadcrumbEnabled,
 					entry: config.entry ?? "docs",
@@ -386,6 +389,7 @@ function TanstackDocsLayout({ config, tree, locale, description, readingTime, la
 					readingTime: typeof readingTime === "number" ? readingTime : void 0,
 					llmsTxtEnabled,
 					description,
+					descriptionInBody,
 					feedbackEnabled: feedbackConfig.enabled,
 					feedbackQuestion: feedbackConfig.question,
 					feedbackPlaceholder: feedbackConfig.placeholder,

package/dist/tanstack.d.mts

@@ -1,4 +1,4 @@
+import { TanstackDocsLayout } from "./tanstack-layout.mjs";
 import { DocsClientHooks } from "./docs-client-hooks.mjs";
 import { RootProvider } from "./provider-tanstack.mjs";
-import { TanstackDocsLayout } from "./tanstack-layout.mjs";
 export { DocsClientHooks, RootProvider, TanstackDocsLayout };

package/dist/tanstack.mjs

@@ -1,5 +1,5 @@
 import { DocsClientHooks } from "./docs-client-hooks.mjs";
-import { RootProvider } from "./provider-tanstack.mjs";
 import { TanstackDocsLayout } from "./tanstack-layout.mjs";
+import { RootProvider } from "./provider-tanstack.mjs";
 
 export { DocsClientHooks, RootProvider, TanstackDocsLayout };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.2.97",
+  "version": "0.2.99",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -33,6 +33,12 @@
       "import": "./dist/docs-client-hooks.mjs",
       "default": "./dist/docs-client-hooks.mjs"
     },
+    "./browser": {
+      "types": "./dist/browser.d.mts",
+      "import": "./dist/browser.mjs",
+      "default": "./dist/browser.mjs"
+    },
+    "./browser/css": "./styles/bundles/browser-framework.css",
     "./default": {
       "types": "./dist/default/index.d.mts",
       "import": "./dist/default/index.mjs",
@@ -151,10 +157,11 @@
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
     "next": ">=14.0.0",
+    "postcss": "^8.5.6",
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@farming-labs/docs": "0.2.97"
+    "@farming-labs/docs": "0.2.99"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",