@rimelight/seo 0.0.15 → 0.0.17

package/dist/assets.d.mts

@@ -21,10 +21,11 @@ export interface GenerateOgCardOptions {
 export declare function generatePng(source: Buffer | Uint8Array | string, options: {
   width: number;
   height: number;
+  background?: string;
 }): Promise<Buffer>;
 /**
- * Generate a maskable PWA PNG icon with safe-zone padding and solid background. The standard
- * recommendation is to place the master icon in the inner 80% safe zone.
+ * Generate a maskable PWA PNG icon with safe-zone padding and solid background. Standard
+ * recommendation is to place the master icon in the inner ~70-80% safe zone.
  */
 export declare function generateMaskablePng(source: Buffer | Uint8Array | string, options?: GenerateMaskableOptions): Promise<Buffer>;
 /**

package/dist/assets.mjs

@@ -1,43 +1,86 @@
-import sharp from "sharp";
 //#region src/assets.ts
+function toDataUrl(source) {
+	if (typeof source === "string") {
+		if (source.startsWith("data:") || source.startsWith("http:") || source.startsWith("https:")) return source;
+		const trimmed = source.trim();
+		if (trimmed.startsWith("<svg")) return `data:image/svg+xml;base64,${Buffer.from(trimmed).toString("base64")}`;
+		return source;
+	}
+	const buf = Buffer.from(source);
+	return `data:${buf.subarray(0, 100).toString("utf8").includes("<svg") ? "image/svg+xml" : "image/png"};base64,${buf.toString("base64")}`;
+}
 /**
 * Generate a PNG buffer resized to specific dimensions from an SVG or image buffer.
 */
 async function generatePng(source, options) {
-	return sharp(source).resize(options.width, options.height, {
-		fit: "contain",
-		background: {
-			r: 0,
-			g: 0,
-			b: 0,
-			alpha: 0
+	const { render } = await import("takumi-js");
+	const src = toDataUrl(source);
+	const png = await render({
+		type: "div",
+		props: {
+			style: {
+				display: "flex",
+				width: `${options.width}px`,
+				height: `${options.height}px`,
+				alignItems: "center",
+				justifyContent: "center",
+				backgroundColor: options.background || "transparent"
+			},
+			children: {
+				type: "img",
+				props: {
+					src,
+					style: {
+						width: "100%",
+						height: "100%",
+						objectFit: "contain"
+					}
+				}
+			}
 		}
-	}).png().toBuffer();
+	}, {
+		width: options.width,
+		height: options.height
+	});
+	return Buffer.from(png);
 }
 /**
-* Generate a maskable PWA PNG icon with safe-zone padding and solid background. The standard
-* recommendation is to place the master icon in the inner 80% safe zone.
+* Generate a maskable PWA PNG icon with safe-zone padding and solid background. Standard
+* recommendation is to place the master icon in the inner ~70-80% safe zone.
 */
 async function generateMaskablePng(source, options = {}) {
 	const { size = 512, background = "#ffffff", paddingRatio = .15 } = options;
-	const innerSize = Math.round(size * (1 - paddingRatio * 2));
-	const pad = Math.floor((size - innerSize) / 2);
-	const innerPng = await sharp(source).resize(innerSize, innerSize, {
-		fit: "contain",
-		background: {
-			r: 0,
-			g: 0,
-			b: 0,
-			alpha: 0
+	const { render } = await import("takumi-js");
+	const src = toDataUrl(source);
+	const innerPercent = `${Math.round((1 - paddingRatio * 2) * 100)}%`;
+	const png = await render({
+		type: "div",
+		props: {
+			style: {
+				display: "flex",
+				width: `${size}px`,
+				height: `${size}px`,
+				backgroundColor: background,
+				alignItems: "center",
+				justifyContent: "center"
+			},
+			children: {
+				type: "img",
+				props: {
+					src,
+					style: {
+						width: innerPercent,
+						height: innerPercent,
+						objectFit: "contain"
+					}
+				}
+			}
 		}
-	}).png().toBuffer();
-	return sharp(innerPng).extend({
-		top: pad,
-		bottom: size - innerSize - pad,
-		left: pad,
-		right: size - innerSize - pad,
-		background
-	}).png().toBuffer();
+	}, {
+		width: size,
+		height: size
+	});
+	return Buffer.from(png);
 }
 /**
 * Generate a valid .ico buffer containing a 32x32 PNG image according to the Windows ICO
@@ -67,30 +110,42 @@ async function generateIco(source, size = 32) {
 */
 async function generateOgCard(options = {}) {
 	const { width = 1200, height = 630, background = "#0a0a0a", logoBuffer } = options;
+	const { render } = await import("takumi-js");
+	const bgStyle = background.startsWith("linear-gradient") || background.startsWith("radial-gradient") ? { background } : { backgroundColor: background };
+	let children = null;
 	if (logoBuffer) {
+		const src = toDataUrl(logoBuffer);
 		const logoSize = Math.min(Math.round(height * .45), 280);
-		const logoPng = await generatePng(logoBuffer, {
-			width: logoSize,
-			height: logoSize
-		});
-		const topPad = Math.floor((height - logoSize) / 2);
-		const bottomPad = height - logoSize - topPad;
-		const leftPad = Math.floor((width - logoSize) / 2);
-		const rightPad = width - logoSize - leftPad;
-		return sharp(logoPng).extend({
-			top: topPad,
-			bottom: bottomPad,
-			left: leftPad,
-			right: rightPad,
-			background
-		}).png().toBuffer();
+		children = {
+			type: "img",
+			props: {
+				src,
+				style: {
+					width: `${logoSize}px`,
+					height: `${logoSize}px`,
+					objectFit: "contain"
+				}
+			}
+		};
 	}
-	return sharp({ create: {
+	const png = await render({
+		type: "div",
+		props: {
+			style: {
+				display: "flex",
+				width: `${width}px`,
+				height: `${height}px`,
+				alignItems: "center",
+				justifyContent: "center",
+				...bgStyle
+			},
+			...children ? { children } : {}
+		}
+	}, {
 		width,
-		height,
-		channels: 4,
-		background
-	} }).png().toBuffer();
+		height
+	});
+	return Buffer.from(png);
 }
 //#endregion
 export { generateIco, generateMaskablePng, generateOgCard, generatePng };

package/dist/index.d.mts

@@ -6,9 +6,9 @@ import { buildApiCatalog } from "./catalog.mjs";
 import { buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, chunkSitemapUrls } from "./sitemap.mjs";
 import { buildRobotsTxt } from "./robots.mjs";
 import { buildRssXml, escapeXml } from "./rss.mjs";
-import { buildCanonicalUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge } from "./meta.mjs";
+import { buildCanonicalUrl, buildDefaultOgImageUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge } from "./meta.mjs";
 import { buildSecurityTxt } from "./security.mjs";
 import { buildWebManifest } from "./manifest.mjs";
 import { OgFontConfig, OgLayoutOptions, OgRenderConfig } from "./og.mjs";
 import rimelightSeo from "./integration.mjs";
-export { type ApiCatalog, type ApiCatalogItem, type ApiCatalogOptions, type ApiCatalogRouteOptions, type ArticleSchemaOptions, type AssetRouteOptions, type BreadcrumbItem, type ChangeFreq, type HeadProps, type LlmsFullRouteOptions, type LlmsFullTxtOptions, type LlmsPage, type LlmsRouteOptions, type LlmsTxtOptions, type LocaleConfig, type ManifestRouteOptions, type OGImage, type OgFontConfig, type OgLayoutOptions, type OgRenderConfig, type OgRouteOptions, type OpenGraphMeta, type RSSFeed, type RimelightSeoOptions, type RobotsOptions, type RobotsRouteOptions, type RssCollectionConfig, type RssFeedOptions, type RssItem, type RssOptions, type SecurityRouteOptions, type SecurityTxtOptions, type SeoEntry, type SiteConfig, type SitemapAlternate, type SitemapOptions, type SitemapUrl, type TwitterMeta, type UserAgentRule, type WebManifest, type WebManifestIcon, type WebManifestOptions, type WebManifestShortcut, buildApiCatalog, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSecurityTxt, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebManifest, buildWebSiteSchema, chunkSitemapUrls, deepMerge, rimelightSeo as default, rimelightSeo, escapeXml, generateIco, generateMaskablePng, generateOgCard, generatePng };
+export { type ApiCatalog, type ApiCatalogItem, type ApiCatalogOptions, type ApiCatalogRouteOptions, type ArticleSchemaOptions, type AssetRouteOptions, type BreadcrumbItem, type ChangeFreq, type HeadProps, type LlmsFullRouteOptions, type LlmsFullTxtOptions, type LlmsPage, type LlmsRouteOptions, type LlmsTxtOptions, type LocaleConfig, type ManifestRouteOptions, type OGImage, type OgFontConfig, type OgLayoutOptions, type OgRenderConfig, type OgRouteOptions, type OpenGraphMeta, type RSSFeed, type RimelightSeoOptions, type RobotsOptions, type RobotsRouteOptions, type RssCollectionConfig, type RssFeedOptions, type RssItem, type RssOptions, type SecurityRouteOptions, type SecurityTxtOptions, type SeoEntry, type SiteConfig, type SitemapAlternate, type SitemapOptions, type SitemapUrl, type TwitterMeta, type UserAgentRule, type WebManifest, type WebManifestIcon, type WebManifestOptions, type WebManifestShortcut, buildApiCatalog, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildDefaultOgImageUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSecurityTxt, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebManifest, buildWebSiteSchema, chunkSitemapUrls, deepMerge, rimelightSeo as default, rimelightSeo, escapeXml, generateIco, generateMaskablePng, generateOgCard, generatePng };

package/dist/index.mjs

@@ -3,7 +3,7 @@ import { buildApiCatalog } from "./catalog.mjs";
 import { buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, chunkSitemapUrls } from "./sitemap.mjs";
 import { buildRobotsTxt } from "./robots.mjs";
 import { buildRssXml, escapeXml } from "./rss.mjs";
-import { buildCanonicalUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge } from "./meta.mjs";
+import { buildCanonicalUrl, buildDefaultOgImageUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge } from "./meta.mjs";
 import { buildLlmsFullTxt, buildLlmsTxt } from "./llms.mjs";
 import { buildSecurityTxt } from "./security.mjs";
 import { buildWebManifest } from "./manifest.mjs";
@@ -12,4 +12,4 @@ import rimelightSeo from "./integration.mjs";
 //#region src/index.ts
 var src_default = rimelightSeo;
 //#endregion
-export { buildApiCatalog, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSecurityTxt, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebManifest, buildWebSiteSchema, chunkSitemapUrls, deepMerge, src_default as default, escapeXml, generateIco, generateMaskablePng, generateOgCard, generatePng, rimelightSeo };
+export { buildApiCatalog, buildArticleSchema, buildBreadcrumbSchema, buildCanonicalUrl, buildDefaultOgImageUrl, buildLlmsFullTxt, buildLlmsTxt, buildPageTitle, buildRobotsMetaContent, buildRobotsTxt, buildRssXml, buildSafeDescription, buildSecurityTxt, buildSitemapIndexXml, buildSitemapUrls, buildSitemapXml, buildWebManifest, buildWebSiteSchema, chunkSitemapUrls, deepMerge, src_default as default, escapeXml, generateIco, generateMaskablePng, generateOgCard, generatePng, rimelightSeo };

package/dist/meta.d.mts

@@ -35,8 +35,16 @@ export declare function buildRobotsMetaContent(opts: {
   override?: string;
 }): string;
 /**
- * \n * Build a Schema.org WebSite JSON-LD object.\n * Pass the result to JSON.stringify and emit
- * via <script type="application/ld+json">.\n
+ * Build dynamic Open Graph image URL fallback when no explicit image is provided.
+ */
+export declare function buildDefaultOgImageUrl(opts: {
+  title?: string | undefined;
+  description?: string | undefined;
+  siteName?: string | undefined;
+}): string;
+/**
+ * Build a Schema.org WebSite JSON-LD object. Pass the result to JSON.stringify and emit via <script
+ * type="application/ld+json">.
  */
 export declare function buildWebSiteSchema(config: Pick<SiteConfig, "name" | "url" | "description">, site?: string): Record<string, unknown>;
 //#endregion

package/dist/meta.mjs

@@ -50,8 +50,19 @@ function buildRobotsMetaContent(opts) {
 	return !opts.noindex && !opts.is404 ? "index, follow, max-image-preview:large" : "noindex, nofollow";
 }
 /**
-* \n * Build a Schema.org WebSite JSON-LD object.\n * Pass the result to JSON.stringify and emit
-* via <script type="application/ld+json">.\n
+* Build dynamic Open Graph image URL fallback when no explicit image is provided.
+*/
+function buildDefaultOgImageUrl(opts) {
+	const params = new URLSearchParams();
+	const title = opts.title || opts.siteName;
+	if (title) params.set("title", title);
+	if (opts.description) params.set("description", opts.description);
+	const qs = params.toString();
+	return qs ? `/open-graph/page.png?${qs}` : "/open-graph/page.png";
+}
+/**
+* Build a Schema.org WebSite JSON-LD object. Pass the result to JSON.stringify and emit via <script
+* type="application/ld+json">.
 */
 function buildWebSiteSchema(config, site) {
 	return {
@@ -63,4 +74,4 @@ function buildWebSiteSchema(config, site) {
 	};
 }
 //#endregion
-export { buildCanonicalUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge };
+export { buildCanonicalUrl, buildDefaultOgImageUrl, buildPageTitle, buildRobotsMetaContent, buildSafeDescription, buildWebSiteSchema, deepMerge };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rimelight/seo",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "private": false,
   "description": "Rimelight Entertainment's SEO Package",
   "homepage": "https://rimelight.com/docs",
@@ -72,24 +72,16 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "takumi-js": "^2.14.0"
+  },
   "devDependencies": {
-    "@rimelight/config": "0.0.18",
+    "@rimelight/config": "0.0.20",
     "astro": "7.3.3",
-    "sharp": "^0.35.4",
     "typescript": "6.0.3"
   },
   "peerDependencies": {
-    "astro": ">=7.0.0",
-    "sharp": ">=0.33.0",
-    "takumi-js": ">=2.0.0"
-  },
-  "peerDependenciesMeta": {
-    "sharp": {
-      "optional": true
-    },
-    "takumi-js": {
-      "optional": true
-    }
+    "astro": ">=7.0.0"
   },
   "engines": {
     "node": ">=26.9.0"

package/src/assets.test.ts

@@ -1,17 +1,27 @@
 import { describe, it, expect } from "vite-plus/test"
 import { generatePng, generateMaskablePng, generateIco, generateOgCard } from "./assets.js"
-import sharp from "sharp"
 
 const sampleSvg = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="100" height="100">
   <circle cx="50" cy="50" r="40" fill="#ff0000" />
 </svg>`
 
+function getPngMetadata(buf: Buffer) {
+  // PNG signature: 8 bytes
+  const isPng =
+    buf.length >= 24 && buf[0] === 0x89 && buf[1] === 0x50 && buf[2] === 0x4e && buf[3] === 0x47
+  return {
+    format: isPng ? "png" : "unknown",
+    width: buf.readUInt32BE(16),
+    height: buf.readUInt32BE(20)
+  }
+}
+
 describe("Asset Generation", () => {
   it("generates PNG buffer with correct dimensions", async () => {
     const pngBuffer = await generatePng(Buffer.from(sampleSvg), { width: 192, height: 192 })
     expect(pngBuffer).toBeInstanceOf(Buffer)
 
-    const meta = await sharp(pngBuffer).metadata()
+    const meta = getPngMetadata(pngBuffer)
     expect(meta.format).toBe("png")
     expect(meta.width).toBe(192)
     expect(meta.height).toBe(192)
@@ -24,7 +34,7 @@ describe("Asset Generation", () => {
     })
     expect(maskableBuffer).toBeInstanceOf(Buffer)
 
-    const meta = await sharp(maskableBuffer).metadata()
+    const meta = getPngMetadata(maskableBuffer)
     expect(meta.format).toBe("png")
     expect(meta.width).toBe(512)
     expect(meta.height).toBe(512)
@@ -49,7 +59,7 @@ describe("Asset Generation", () => {
 
     // Verify PNG payload inside ICO
     const pngSlice = icoBuffer.subarray(22)
-    const meta = await sharp(pngSlice).metadata()
+    const meta = getPngMetadata(pngSlice)
     expect(meta.format).toBe("png")
     expect(meta.width).toBe(32)
     expect(meta.height).toBe(32)
@@ -62,7 +72,7 @@ describe("Asset Generation", () => {
     })
     expect(ogBuffer).toBeInstanceOf(Buffer)
 
-    const meta = await sharp(ogBuffer).metadata()
+    const meta = getPngMetadata(ogBuffer)
     expect(meta.format).toBe("png")
     expect(meta.width).toBe(1200)
     expect(meta.height).toBe(630)

package/src/assets.ts

@@ -1,5 +1,3 @@
-import sharp from "sharp"
-
 export interface GeneratePngOptions {
   width: number
   height: number
@@ -19,52 +17,110 @@ export interface GenerateOgCardOptions {
   logoBuffer?: Buffer | Uint8Array | string | null
 }
 
+function toDataUrl(source: Buffer | Uint8Array | string): string {
+  if (typeof source === "string") {
+    if (source.startsWith("data:") || source.startsWith("http:") || source.startsWith("https:")) {
+      return source
+    }
+    const trimmed = source.trim()
+    if (trimmed.startsWith("<svg")) {
+      return `data:image/svg+xml;base64,${Buffer.from(trimmed).toString("base64")}`
+    }
+    return source
+  }
+  const buf = Buffer.from(source)
+  const isSvg = buf.subarray(0, 100).toString("utf8").includes("<svg")
+  const mime = isSvg ? "image/svg+xml" : "image/png"
+  return `data:${mime};base64,${buf.toString("base64")}`
+}
+
 /**
  * Generate a PNG buffer resized to specific dimensions from an SVG or image buffer.
  */
 export async function generatePng(
   source: Buffer | Uint8Array | string,
-  options: { width: number; height: number }
+  options: { width: number; height: number; background?: string }
 ): Promise<Buffer> {
-  return sharp(source)
-    .resize(options.width, options.height, {
-      fit: "contain",
-      background: { r: 0, g: 0, b: 0, alpha: 0 }
-    })
-    .png()
-    .toBuffer()
+  const { render } = await import("takumi-js")
+  const src = toDataUrl(source)
+
+  const vnode = {
+    type: "div",
+    props: {
+      style: {
+        display: "flex",
+        width: `${options.width}px`,
+        height: `${options.height}px`,
+        alignItems: "center",
+        justifyContent: "center",
+        backgroundColor: options.background || "transparent"
+      },
+      children: {
+        type: "img",
+        props: {
+          src,
+          style: {
+            width: "100%",
+            height: "100%",
+            objectFit: "contain"
+          }
+        }
+      }
+    }
+  }
+
+  const png = await render(vnode, {
+    width: options.width,
+    height: options.height
+  })
+
+  return Buffer.from(png)
 }
 
 /**
- * Generate a maskable PWA PNG icon with safe-zone padding and solid background. The standard
- * recommendation is to place the master icon in the inner 80% safe zone.
+ * Generate a maskable PWA PNG icon with safe-zone padding and solid background. Standard
+ * recommendation is to place the master icon in the inner ~70-80% safe zone.
  */
 export async function generateMaskablePng(
   source: Buffer | Uint8Array | string,
   options: GenerateMaskableOptions = {}
 ): Promise<Buffer> {
   const { size = 512, background = "#ffffff", paddingRatio = 0.15 } = options
-  const innerSize = Math.round(size * (1 - paddingRatio * 2))
-  const pad = Math.floor((size - innerSize) / 2)
-
-  const innerPng = await sharp(source)
-    .resize(innerSize, innerSize, {
-      fit: "contain",
-      background: { r: 0, g: 0, b: 0, alpha: 0 }
-    })
-    .png()
-    .toBuffer()
-
-  return sharp(innerPng)
-    .extend({
-      top: pad,
-      bottom: size - innerSize - pad,
-      left: pad,
-      right: size - innerSize - pad,
-      background
-    })
-    .png()
-    .toBuffer()
+  const { render } = await import("takumi-js")
+  const src = toDataUrl(source)
+  const innerPercent = `${Math.round((1 - paddingRatio * 2) * 100)}%`
+
+  const vnode = {
+    type: "div",
+    props: {
+      style: {
+        display: "flex",
+        width: `${size}px`,
+        height: `${size}px`,
+        backgroundColor: background,
+        alignItems: "center",
+        justifyContent: "center"
+      },
+      children: {
+        type: "img",
+        props: {
+          src,
+          style: {
+            width: innerPercent,
+            height: innerPercent,
+            objectFit: "contain"
+          }
+        }
+      }
+    }
+  }
+
+  const png = await render(vnode, {
+    width: size,
+    height: size
+  })
+
+  return Buffer.from(png)
 }
 
 /**
@@ -103,35 +159,45 @@ export async function generateIco(
  */
 export async function generateOgCard(options: GenerateOgCardOptions = {}): Promise<Buffer> {
   const { width = 1200, height = 630, background = "#0a0a0a", logoBuffer } = options
+  const { render } = await import("takumi-js")
 
+  const bgStyle =
+    background.startsWith("linear-gradient") || background.startsWith("radial-gradient")
+      ? { background }
+      : { backgroundColor: background }
+
+  let children: any = null
   if (logoBuffer) {
+    const src = toDataUrl(logoBuffer)
     const logoSize = Math.min(Math.round(height * 0.45), 280)
-    const logoPng = await generatePng(logoBuffer, { width: logoSize, height: logoSize })
-    const topPad = Math.floor((height - logoSize) / 2)
-    const bottomPad = height - logoSize - topPad
-    const leftPad = Math.floor((width - logoSize) / 2)
-    const rightPad = width - logoSize - leftPad
-
-    return sharp(logoPng)
-      .extend({
-        top: topPad,
-        bottom: bottomPad,
-        left: leftPad,
-        right: rightPad,
-        background
-      })
-      .png()
-      .toBuffer()
+    children = {
+      type: "img",
+      props: {
+        src,
+        style: {
+          width: `${logoSize}px`,
+          height: `${logoSize}px`,
+          objectFit: "contain"
+        }
+      }
+    }
   }
 
-  return sharp({
-    create: {
-      width,
-      height,
-      channels: 4,
-      background
+  const vnode = {
+    type: "div",
+    props: {
+      style: {
+        display: "flex",
+        width: `${width}px`,
+        height: `${height}px`,
+        alignItems: "center",
+        justifyContent: "center",
+        ...bgStyle
+      },
+      ...(children ? { children } : {})
     }
-  })
-    .png()
-    .toBuffer()
+  }
+
+  const png = await render(vnode, { width, height })
+  return Buffer.from(png)
 }

package/src/components/SEOHead.astro

@@ -6,6 +6,7 @@ import {
   buildSafeDescription,
   buildRobotsMetaContent,
   buildWebSiteSchema,
+  buildDefaultOgImageUrl,
   deepMerge
 } from "../meta.js"
 import { buildArticleSchema, buildBreadcrumbSchema } from "../schema.js"
@@ -40,7 +41,6 @@ const {
 // Resolve defaults from config if available
 const siteName = config?.name || 'Rimelight'
 const siteDescription = config?.description || ''
-const ogImageFallback = config?.seo?.ogImageFallback || config?.ogImage || '/og.png'
 const themeColor = config?.branding?.colors?.themeColor
 
 const rawFavicon = customFavicon || (typeof config?.branding?.favicon === 'string' ? config.branding.favicon : config?.branding?.favicon?.svg) || config?.branding?.icon || '/favicon.svg'
@@ -70,7 +70,20 @@ const safeDescription = config?.seo?.maxDescriptionLength
   ? buildSafeDescription(finalDescription, config.seo.maxDescriptionLength)
   : finalDescription
 
-const finalOgImage = ogImage || (ogImageFallback ? { src: ogImageFallback, alt: siteName } : undefined)
+const defaultDynamicOg = buildDefaultOgImageUrl({
+  title,
+  description: finalDescription,
+  siteName
+})
+const ogImageFallback = config?.seo?.ogImageFallback || config?.ogImage || defaultDynamicOg
+
+const rawOgImage = Array.isArray(ogImage)
+  ? ogImage[0]
+  : typeof ogImage === 'string'
+    ? { src: ogImage, alt: siteName }
+    : ogImage
+
+const finalOgImage = rawOgImage || (ogImageFallback ? (typeof ogImageFallback === 'string' ? { src: ogImageFallback, alt: siteName } : ogImageFallback) : undefined)
 const absoluteOgImage = finalOgImage
   ? new URL(finalOgImage.src, Astro.site ?? Astro.url).toString()
   : undefined

package/src/index.ts

@@ -56,6 +56,7 @@ export {
   buildSafeDescription,
   buildRobotsMetaContent,
   buildWebSiteSchema,
+  buildDefaultOgImageUrl,
   deepMerge
 } from "./meta.js"
 

package/src/meta.test.ts

@@ -5,6 +5,7 @@ import {
   buildSafeDescription,
   buildRobotsMetaContent,
   buildWebSiteSchema,
+  buildDefaultOgImageUrl,
   deepMerge
 } from "./meta.js"
 
@@ -132,3 +133,26 @@ describe("buildWebSiteSchema", () => {
     expect(schema["url"]).toBe("https://override.com")
   })
 })
+
+describe("buildDefaultOgImageUrl", () => {
+  it("builds query params for title and description", () => {
+    const url = buildDefaultOgImageUrl({
+      title: "My Page",
+      description: "My description"
+    })
+    expect(url).toBe("/open-graph/page.png?title=My+Page&description=My+description")
+  })
+
+  it("falls back to siteName if title is missing", () => {
+    const url = buildDefaultOgImageUrl({
+      siteName: "Rimelight",
+      description: "Welcome"
+    })
+    expect(url).toBe("/open-graph/page.png?title=Rimelight&description=Welcome")
+  })
+
+  it("returns base path when no params provided", () => {
+    const url = buildDefaultOgImageUrl({})
+    expect(url).toBe("/open-graph/page.png")
+  })
+})

package/src/meta.ts

@@ -83,8 +83,24 @@ export function buildRobotsMetaContent(opts: {
 }
 
 /**
- * \n * Build a Schema.org WebSite JSON-LD object.\n * Pass the result to JSON.stringify and emit
- * via <script type="application/ld+json">.\n
+ * Build dynamic Open Graph image URL fallback when no explicit image is provided.
+ */
+export function buildDefaultOgImageUrl(opts: {
+  title?: string | undefined
+  description?: string | undefined
+  siteName?: string | undefined
+}): string {
+  const params = new URLSearchParams()
+  const title = opts.title || opts.siteName
+  if (title) params.set("title", title)
+  if (opts.description) params.set("description", opts.description)
+  const qs = params.toString()
+  return qs ? `/open-graph/page.png?${qs}` : "/open-graph/page.png"
+}
+
+/**
+ * Build a Schema.org WebSite JSON-LD object. Pass the result to JSON.stringify and emit via <script
+ * type="application/ld+json">.
  */
 export function buildWebSiteSchema(
   config: Pick<SiteConfig, "name" | "url" | "description">,