@farming-labs/theme 0.0.10 → 0.0.11

package/dist/docs-layout.d.mts

@@ -1,6 +1,6 @@
 import { ReactNode } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
-import { DocsConfig } from "@farming-labs/docs";
+import { DocsConfig, PageFrontmatter } from "@farming-labs/docs";
 
 //#region src/docs-layout.d.ts
 /**
@@ -16,23 +16,19 @@ import { DocsConfig } from "@farming-labs/docs";
  */
 declare function createDocsMetadata(config: DocsConfig): Record<string, unknown>;
 /**
- * Generate page-level metadata with dynamic OG images.
+ * Generate page-level metadata with dynamic or static OG/twitter.
+ * When the page has `openGraph` or `twitter` in frontmatter, those are used (static OG).
+ * Otherwise uses `ogImage` or the config dynamic endpoint.
  *
  * Usage in a docs page or [[...slug]] route:
  * ```ts
  * export function generateMetadata({ params }) {
  *   const page = getPage(params.slug);
- *   return createPageMetadata(docsConfig, {
- *     title: page.data.title,
- *     description: page.data.description,
- *   });
+ *   return createPageMetadata(docsConfig, page.data);
  * }
  * ```
  */
-declare function createPageMetadata(config: DocsConfig, page: {
-  title: string;
-  description?: string;
-}): Record<string, unknown>;
+declare function createPageMetadata(config: DocsConfig, page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph" | "twitter">, baseUrl?: string): Record<string, unknown>;
 declare function createDocsLayout(config: DocsConfig): ({
   children
 }: {

package/dist/docs-layout.mjs

@@ -8,6 +8,7 @@ import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
+import { buildPageOpenGraph, buildPageTwitter } from "@farming-labs/docs";
 
 //#region src/docs-layout.tsx
 /** Resolve a frontmatter `icon` string to a ReactNode via the icon registry. */
@@ -231,42 +232,28 @@ function createDocsMetadata(config) {
 	return result;
 }
 /**
-* Generate page-level metadata with dynamic OG images.
+* Generate page-level metadata with dynamic or static OG/twitter.
+* When the page has `openGraph` or `twitter` in frontmatter, those are used (static OG).
+* Otherwise uses `ogImage` or the config dynamic endpoint.
 *
 * Usage in a docs page or [[...slug]] route:
 * ```ts
 * export function generateMetadata({ params }) {
 *   const page = getPage(params.slug);
-*   return createPageMetadata(docsConfig, {
-*     title: page.data.title,
-*     description: page.data.description,
-*   });
+*   return createPageMetadata(docsConfig, page.data);
 * }
 * ```
 */
-function createPageMetadata(config, page) {
-	const og = config.og;
+function createPageMetadata(config, page, baseUrl) {
 	const result = {
 		title: page.title,
 		...page.description ? { description: page.description } : {}
 	};
-	if (og?.enabled !== false && og?.endpoint) {
-		const ogUrl = `${og.endpoint}?title=${encodeURIComponent(page.title)}${page.description ? `&description=${encodeURIComponent(page.description)}` : ""}`;
-		result.openGraph = {
-			title: page.title,
-			description: page.description,
-			images: [{
-				url: ogUrl,
-				width: 1200,
-				height: 630
-			}]
-		};
-		result.twitter = {
-			card: "summary_large_image",
-			title: page.title,
-			description: page.description,
-			images: [ogUrl]
-		};
+	if (config.og?.enabled !== false) {
+		const openGraph = buildPageOpenGraph(page, config.og, baseUrl);
+		if (openGraph) result.openGraph = openGraph;
+		const twitter = buildPageTwitter(page, config.og, baseUrl);
+		if (twitter) result.twitter = twitter;
 	}
 	return result;
 }

package/dist/index.d.mts

@@ -5,8 +5,8 @@ import { DocsPageClient } from "./docs-page-client.mjs";
 import { RootProvider } from "./provider.mjs";
 import { PageActions } from "./page-actions.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
-import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 import { AIConfig, BreadcrumbConfig, CopyMarkdownConfig, DocsConfig, DocsMetadata, DocsNav, DocsTheme, FontStyle, OGConfig, OpenDocsConfig, OpenDocsProvider, PageActionsConfig, PageFrontmatter, SidebarConfig, ThemeToggleConfig, TypographyConfig, UIConfig, createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
+import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, Pre } from "fumadocs-ui/components/codeblock";
 export { type AIConfig, type BreadcrumbConfig, CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, type CopyMarkdownConfig, DocsBody, DocsCommandSearch, type DocsConfig, DocsLayout, type DocsMetadata, type DocsNav, DocsPage, DocsPageClient, type DocsTheme, type FontStyle, DefaultUIDefaults as FumadocsUIDefaults, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, PageActions, type PageActionsConfig, type PageFrontmatter, Pre, RootProvider, type SidebarConfig, Tab, Tabs, type ThemeToggleConfig, type TypographyConfig, type UIConfig, createDocsLayout, createDocsMetadata, createPageMetadata, createTheme, deepMerge, defineDocs, extendTheme, fumadocs };

package/dist/index.mjs

@@ -5,8 +5,8 @@ import { createDocsLayout, createDocsMetadata, createPageMetadata } from "./docs
 import { RootProvider } from "./provider.mjs";
 import { DefaultUIDefaults, fumadocs } from "./default/index.mjs";
 import { DocsLayout } from "fumadocs-ui/layouts/docs";
-import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 import { createTheme, deepMerge, defineDocs, extendTheme } from "@farming-labs/docs";
+import { DocsBody, DocsPage } from "fumadocs-ui/layouts/docs/page";
 import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import { CodeBlock, CodeBlockTab, CodeBlockTabs, CodeBlockTabsList, CodeBlockTabsTrigger, Pre } from "fumadocs-ui/components/codeblock";
 

package/package.json

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