@farming-labs/theme 0.2.99 → 0.2.102

package/dist/browser.d.mts

@@ -1,9 +1,12 @@
-import { TanstackDocsLayout, TanstackDocsLayoutProps } from "./tanstack-layout.mjs";
+import { TanstackDocsLayoutProps } from "./tanstack-layout.mjs";
 import { ComponentPropsWithoutRef } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 import { RootProvider } from "fumadocs-ui/provider/base";
 
 //#region src/browser.d.ts
+type BrowserDocsLayoutProps = Omit<TanstackDocsLayoutProps, "browserRuntime">;
+/** Docs layout for framework-neutral browser adapters such as Farm.js. */
+declare function BrowserDocsLayout(props: BrowserDocsLayoutProps): react_jsx_runtime0.JSX.Element;
 type FumadocsProviderProps = ComponentPropsWithoutRef<typeof RootProvider>;
 declare global {
   interface Window {
@@ -22,4 +25,4 @@ declare function BrowserRootProvider({
   ...props
 }: BrowserRootProviderProps): react_jsx_runtime0.JSX.Element;
 //#endregion
-export { TanstackDocsLayout as BrowserDocsLayout, type TanstackDocsLayoutProps as BrowserDocsLayoutProps, BrowserRootProvider, BrowserRootProviderProps };
+export { BrowserDocsLayout, BrowserDocsLayoutProps, BrowserRootProvider, BrowserRootProviderProps };

package/dist/browser.mjs

@@ -7,6 +7,13 @@ import { jsx } from "react/jsx-runtime";
 import { RootProvider } from "fumadocs-ui/provider/base";
 
 //#region src/browser.tsx
+/** Docs layout for framework-neutral browser adapters such as Farm.js. */
+function BrowserDocsLayout(props) {
+	return /* @__PURE__ */ jsx(TanstackDocsLayout, {
+		...props,
+		browserRuntime: true
+	});
+}
 function patchHistoryEvents() {
 	if (typeof window === "undefined" || window.__fdBrowserHistoryPatched) return;
 	for (const method of ["pushState", "replaceState"]) {
@@ -71,4 +78,4 @@ function BrowserRootProvider({ children, search, initialPathname = "/", ...props
 }
 
 //#endregion
-export { TanstackDocsLayout as BrowserDocsLayout, BrowserRootProvider };
+export { BrowserDocsLayout, BrowserRootProvider };

package/dist/docs-layout.mjs

@@ -8,7 +8,6 @@ import { DocsCommandSearch } from "./docs-command-search.mjs";
 import { resolveReadingTimeOptions } from "./reading-time-options.mjs";
 import { resolvePageReadingTime } from "./reading-time.mjs";
 import { SidebarSearchWithAI } from "./sidebar-search-ai.mjs";
-import { TabletSidebarBridge } from "./tablet-sidebar-bridge.mjs";
 import { LocaleThemeControl } from "./locale-theme-control.mjs";
 import fs from "node:fs";
 import path from "node:path";
@@ -809,7 +808,6 @@ function createDocsLayout(config, options) {
 				/* @__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, {
@@ -844,7 +842,6 @@ function createDocsLayout(config, options) {
 					fallback: children,
 					children: /* @__PURE__ */ jsx(DocsPageClient, {
 						tocEnabled,
-						themeName: config.theme?.name,
 						tocStyle,
 						breadcrumbEnabled,
 						changelogBasePath,

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

@@ -17,8 +17,8 @@ interface SerializedProvider {
 }
 interface DocsPageClientProps {
   tocEnabled: boolean;
-  /** Active theme preset name, used for theme-specific structural affordances. */
-  themeName?: string;
+  /** Expose the llms.txt action in a runtime-owned header slot. */
+  showLlmsInHeader?: boolean;
   tocStyle?: "default" | "directional";
   breadcrumbEnabled?: boolean;
   changelogBasePath?: string;
@@ -104,7 +104,7 @@ interface DocsPageClientProps {
 }
 declare function DocsPageClient({
   tocEnabled,
-  themeName,
+  showLlmsInHeader,
   tocStyle,
   breadcrumbEnabled,
   changelogBasePath,

package/dist/docs-page-client.mjs

@@ -255,7 +255,7 @@ function findThreadlineTocActionsContainer() {
 	}
 	return toc.parentElement ?? toc;
 }
-function DocsPageClient({ tocEnabled, themeName, 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", previousPage, nextPage, structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedLabel = "Last updated", lastUpdatedPosition = "footer", llmsTxtEnabled = false, generatedTitleMap, descriptionMap, description, descriptionInBody = false, feedbackEnabled = false, feedbackQuestion, feedbackPlaceholder, feedbackRequireComment, feedbackPositiveLabel, feedbackNegativeLabel, feedbackSubmitLabel, feedbackSuccessMessage, feedbackErrorMessage, feedbackOnFeedback, analytics = false, children }) {
+function DocsPageClient({ tocEnabled, showLlmsInHeader = false, 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", previousPage, nextPage, structuredDataMap, structuredData: structuredDataProp, readingTimeEnabled = false, lastUpdatedEnabled = true, lastUpdatedLabel = "Last updated", lastUpdatedPosition = "footer", llmsTxtEnabled = false, generatedTitleMap, descriptionMap, description, descriptionInBody = false, 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);
@@ -268,7 +268,7 @@ function DocsPageClient({ tocEnabled, themeName, tocStyle = "default", breadcrum
 	const activeLocale = resolveClientLocale(searchParams, locale);
 	const resolvedPublicPath = normalizePublicDocsPath(publicPath, entry);
 	const llmsLangQuery = activeLocale ? `?lang=${encodeURIComponent(activeLocale)}` : "";
-	const showLlmsInHeader = llmsTxtEnabled && themeName === "fumadocs-pixel-border";
+	const shouldShowLlmsInHeader = llmsTxtEnabled && showLlmsInHeader;
 	const normalizedPath = (browserPathname || pathname).replace(/\/$/, "") || "/";
 	const pageTitle = generatedTitleMap?.[normalizedPath];
 	const pageDescription = description ?? descriptionMap?.[normalizedPath];
@@ -586,11 +586,11 @@ function DocsPageClient({ tocEnabled, themeName, tocStyle = "default", breadcrum
 		llmsTxtEnabled && /* @__PURE__ */ jsx("a", {
 			href: `/llms.txt${llmsLangQuery}`,
 			className: "fd-agent-llms-directive",
-			"data-visible-in-header": showLlmsInHeader ? "true" : void 0,
-			style: showLlmsInHeader ? void 0 : agentLlmsDirectiveStyle,
-			tabIndex: showLlmsInHeader ? void 0 : -1,
-			"aria-hidden": showLlmsInHeader ? void 0 : true,
-			children: showLlmsInHeader ? "LLMS.TXT" : "llms.txt"
+			"data-visible-in-header": shouldShowLlmsInHeader ? "true" : void 0,
+			style: shouldShowLlmsInHeader ? void 0 : agentLlmsDirectiveStyle,
+			tabIndex: shouldShowLlmsInHeader ? void 0 : -1,
+			"aria-hidden": shouldShowLlmsInHeader ? void 0 : true,
+			children: shouldShowLlmsInHeader ? "LLMS.TXT" : "llms.txt"
 		}, "llms-txt"),
 		titleControlsPortal,
 		tocActionsPortal,
@@ -606,7 +606,7 @@ function DocsPageClient({ tocEnabled, themeName, tocStyle = "default", breadcrum
 				style: fdTocStyle
 			},
 			breadcrumb: { enabled: false },
-			footer: { enabled: false },
+			footer: { enabled: !isChangelogRoute },
 			children: [
 				effectiveBreadcrumbEnabled && /* @__PURE__ */ jsx(PathBreadcrumb, {
 					pathname,

package/dist/pixel-border/index.d.mts

@@ -59,10 +59,10 @@ declare const PixelBorderUIDefaults: {
   layout: {
     contentWidth: number;
     sidebarWidth: number;
-    tocWidth: number;
     toc: {
       enabled: boolean;
       depth: number;
+      style: "directional";
     };
     header: {
       height: number;

package/dist/pixel-border/index.mjs

@@ -29,30 +29,30 @@ const PixelBorderUIDefaults = {
 		},
 		h1: {
 			size: "2.25rem",
-			weight: 400,
-			lineHeight: "1.14",
+			weight: 700,
+			lineHeight: "1.2",
 			letterSpacing: "-0.02em"
 		},
 		h2: {
 			size: "1.5rem",
-			weight: 400,
-			lineHeight: "1.24",
+			weight: 600,
+			lineHeight: "1.3",
 			letterSpacing: "-0.01em"
 		},
 		h3: {
 			size: "1.25rem",
-			weight: 400,
-			lineHeight: "1.3"
+			weight: 600,
+			lineHeight: "1.4"
 		},
 		h4: {
 			size: "1.125rem",
-			weight: 400,
+			weight: 600,
 			lineHeight: "1.4"
 		},
 		body: {
-			size: "0.975rem",
+			size: "1rem",
 			weight: 400,
-			lineHeight: "1.8"
+			lineHeight: "1.75"
 		},
 		small: {
 			size: "0.875rem",
@@ -63,13 +63,13 @@ const PixelBorderUIDefaults = {
 	layout: {
 		contentWidth: 860,
 		sidebarWidth: 286,
-		tocWidth: 240,
 		toc: {
 			enabled: true,
-			depth: 3
+			depth: 3,
+			style: "directional"
 		},
 		header: {
-			height: 44,
+			height: 56,
 			sticky: true
 		}
 	},

package/dist/tanstack-layout.d.mts

@@ -27,6 +27,8 @@ interface TreeRoot {
 interface TanstackDocsLayoutProps {
   config: DocsConfig;
   tree: TreeRoot;
+  /** Enables browser-adapter shell affordances that are not part of a theme preset. */
+  browserRuntime?: boolean;
   locale?: string;
   description?: string;
   descriptionInBody?: boolean;
@@ -47,6 +49,7 @@ interface TanstackDocsLayoutProps {
 declare function TanstackDocsLayout({
   config,
   tree,
+  browserRuntime,
   locale,
   description,
   descriptionInBody,

package/dist/tanstack-layout.mjs

@@ -7,8 +7,8 @@ import { resolveDocsCloudAIClientRequest } from "./docs-cloud-ai-client.mjs";
 import { DocsCommandSearch } from "./docs-command-search.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 { TabletSidebarBridge } from "./tablet-sidebar-bridge.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
 import { Suspense } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -224,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, descriptionInBody, readingTime, lastModified, previousPage, nextPage, structuredData, editOnGithubUrl, children }) {
+function TanstackDocsLayout({ config, tree, browserRuntime = false, 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;
@@ -260,6 +260,7 @@ function TanstackDocsLayout({ config, tree, locale, description, descriptionInBo
 	const llmsTxtEnabled = resolveEnabledByDefault(config.llmsTxt);
 	const feedbackConfig = resolveFeedbackConfig(config.feedback);
 	const staticExport = !!config.staticExport;
+	const frameworkContainerProps = browserRuntime ? { "data-fd-framework": "" } : void 0;
 	const openDocsConfig = pageActions?.openDocs && typeof pageActions.openDocs === "object" ? pageActions.openDocs : void 0;
 	const openDocsProviders = resolveOpenDocsProviders(openDocsConfig?.providers, {
 		target: openDocsConfig?.target,
@@ -323,13 +324,14 @@ function TanstackDocsLayout({ config, tree, locale, description, descriptionInBo
 			enabled: false
 		} : themeSwitch,
 		sidebar: finalSidebarProps,
+		containerProps: frameworkContainerProps,
 		...aiMode === "sidebar-icon" && aiEnabled ? { searchToggle: { components: { lg: /* @__PURE__ */ jsx(SidebarSearchWithAI, {}) } } } : {},
 		children: [
 			/* @__PURE__ */ jsx(ColorStyle, { colors }),
 			/* @__PURE__ */ jsx(TypographyStyle, { typography }),
 			/* @__PURE__ */ jsx(LayoutStyle, { layout: layoutDimensions }),
 			forcedTheme && /* @__PURE__ */ jsx(ForcedThemeScript, { theme: forcedTheme }),
-			config.theme?.name === "fumadocs-pixel-border" && /* @__PURE__ */ jsx(TabletSidebarBridge, {}),
+			browserRuntime && config.theme?.name === "fumadocs-pixel-border" && /* @__PURE__ */ jsx(TabletSidebarBridge, {}),
 			!staticExport && /* @__PURE__ */ jsx(Suspense, {
 				fallback: null,
 				children: /* @__PURE__ */ jsx(DocsCommandSearch, {
@@ -361,7 +363,7 @@ function TanstackDocsLayout({ config, tree, locale, description, descriptionInBo
 				fallback: children,
 				children: /* @__PURE__ */ jsx(DocsPageClient, {
 					tocEnabled,
-					themeName: config.theme?.name,
+					showLlmsInHeader: browserRuntime && config.theme?.name === "fumadocs-pixel-border",
 					tocStyle,
 					breadcrumbEnabled,
 					entry: config.entry ?? "docs",

package/package.json

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