@moku-labs/web 1.5.1 → 1.5.2

package/dist/index.cjs

@@ -4390,9 +4390,10 @@ async function generateOgImages(ctx, options = {}) {
 		fonts,
 		...renderHook
 	});
+	const siteCardRender = typeof config.defaultCard === "function" ? config.defaultCard : defaultSiteCard;
 	const renderSitePng = options.renderPng ?? makeDefaultRenderer({
 		fonts,
-		render: defaultSiteCard
+		render: siteCardRender
 	});
 	const siteName = resolveSiteName(ctx);
 	const defaultLocale = ctx.require(i18nPlugin).defaultLocale();
@@ -4418,7 +4419,7 @@ async function generateOgImages(ctx, options = {}) {
 			outDir
 		}, tally);
 	})));
-	const defaultCard = config.defaultCard === true;
+	const defaultCard = config.defaultCard === true || typeof config.defaultCard === "function";
 	if (defaultCard) {
 		const png = await renderSitePng({
 			title: siteName,

package/dist/index.d.cts

@@ -1633,12 +1633,16 @@ interface OgImageConfig {
   /** Explicit named fonts loaded once per build (overrides the first-file scan). */
   fonts?: OgFont[];
   /**
-   * When `true`, also render a single SITE-LEVEL default card to `<outDir>/og-default.png`
-   * — a generic site name + description on a dark background, using the same loaded fonts (the
-   * per-article `render` hook is NOT applied). Point `head.defaultOgImage` at `"/og-default.png"`
-   * to use it as the og:image fallback for non-article pages. Default `false`.
+   * Also render a single SITE-LEVEL default card to `<outDir>/og-default.png`, used (via
+   * `head.defaultOgImage: "/og-default.png"`) as the og:image fallback for non-article pages.
+   * Rendered ONCE with the same loaded fonts; the per-article `render` hook is NOT applied.
+   *
+   * - `true` → the built-in generic card (site name over its description on a dark background).
+   * - a render function → your OWN card, e.g. `defaultCard: MySiteCard` (a `(input) => VNode`,
+   *   the same shape as `render`); `input.siteName`/`input.description` carry the site identity.
+   * - `false`/omitted → no card (default).
    */
-  defaultCard?: boolean;
+  defaultCard?: boolean | ((input: RichOgInput) => import("preact").VNode);
 }
 /**
  * Public configuration for the `build` plugin. Flags give opt-in granularity over

package/dist/index.d.mts

@@ -1633,12 +1633,16 @@ interface OgImageConfig {
   /** Explicit named fonts loaded once per build (overrides the first-file scan). */
   fonts?: OgFont[];
   /**
-   * When `true`, also render a single SITE-LEVEL default card to `<outDir>/og-default.png`
-   * — a generic site name + description on a dark background, using the same loaded fonts (the
-   * per-article `render` hook is NOT applied). Point `head.defaultOgImage` at `"/og-default.png"`
-   * to use it as the og:image fallback for non-article pages. Default `false`.
+   * Also render a single SITE-LEVEL default card to `<outDir>/og-default.png`, used (via
+   * `head.defaultOgImage: "/og-default.png"`) as the og:image fallback for non-article pages.
+   * Rendered ONCE with the same loaded fonts; the per-article `render` hook is NOT applied.
+   *
+   * - `true` → the built-in generic card (site name over its description on a dark background).
+   * - a render function → your OWN card, e.g. `defaultCard: MySiteCard` (a `(input) => VNode`,
+   *   the same shape as `render`); `input.siteName`/`input.description` carry the site identity.
+   * - `false`/omitted → no card (default).
    */
-  defaultCard?: boolean;
+  defaultCard?: boolean | ((input: RichOgInput) => import("preact").VNode);
 }
 /**
  * Public configuration for the `build` plugin. Flags give opt-in granularity over

package/dist/index.mjs

@@ -4377,9 +4377,10 @@ async function generateOgImages(ctx, options = {}) {
 		fonts,
 		...renderHook
 	});
+	const siteCardRender = typeof config.defaultCard === "function" ? config.defaultCard : defaultSiteCard;
 	const renderSitePng = options.renderPng ?? makeDefaultRenderer({
 		fonts,
-		render: defaultSiteCard
+		render: siteCardRender
 	});
 	const siteName = resolveSiteName(ctx);
 	const defaultLocale = ctx.require(i18nPlugin).defaultLocale();
@@ -4405,7 +4406,7 @@ async function generateOgImages(ctx, options = {}) {
 			outDir
 		}, tally);
 	})));
-	const defaultCard = config.defaultCard === true;
+	const defaultCard = config.defaultCard === true || typeof config.defaultCard === "function";
 	if (defaultCard) {
 		const png = await renderSitePng({
 			title: siteName,

package/package.json

@@ -113,5 +113,5 @@
     "test:cli-e2e": "bun test src/plugins/cli/__tests__/e2e/",
     "test:coverage": "vitest run --project unit --project integration --coverage"
   },
-  "version": "1.5.1"
+  "version": "1.5.2"
 }