@djangocfg/nextjs 2.1.438 → 2.1.439

package/README.md

@@ -23,7 +23,7 @@
 
 ## Features
 
-- **OG Images** — typed URL builder for Django's `django_ogimage` renderer (`@djangocfg/nextjs/og-image`)
+- **Page Metadata + OG Images** — one factory for complete page metadata; static or dynamically-rendered OG images via Django's `django_ogimage` (`@djangocfg/nextjs/og-image`)
 - **i18n** — full next-intl integration with routing, middleware, and components
 - **PWA** — zero-config service worker and manifest
 - **Base Next.js Config** — reusable `createBaseNextConfig()` factory for monorepos
@@ -387,23 +387,31 @@ export const GET = createHealthHandler({
 });
 ```
 
-### OG Image Generation
+### Page Metadata + OG Images
 
-Builds typed URLs pointing to Django's `django_ogimage` renderer — no Edge Runtime, no `@vercel/og`:
+One factory per app builds complete page `Metadata` (title, openGraph, twitter,
+canonical + hreflang, icons). The OG image is chosen by a single `og` field —
+static brand image by default, dynamic title-rendered card on demand. No Edge
+Runtime, no `@vercel/og`:
 
 ```tsx
-// app/page.tsx
-import { withOgImage } from '@djangocfg/nextjs/og-image'
-
-export async function generateMetadata(): Promise<Metadata> {
-  return withOgImage(
-    { title: 'My Page', description: 'Description' },
-    { preset: 'DARK_BLUE', layout: 'HERO' }
-  )
-}
+// app/_core/metadata.ts — bind once
+import { makeMetadataFactory } from '@djangocfg/nextjs/og-image'
+export const createMetadata = makeMetadataFactory({
+  name: settings.app.name,
+  description: settings.app.description,
+  siteUrl: settings.app.siteUrl,
+  ogImage: settings.app.media.ogimage,
+  locales: LOCALES,
+})
+
+// landing page → static brand image (default)
+export const metadata = createMetadata({ title: 'Pricing', path: '/pricing' })
+// content page → render the title onto the card
+export const metadata = createMetadata({ title: post.title, path, og: 'dynamic' })
 ```
 
-The URL is resolved automatically from `NEXT_PUBLIC_MEDIA_URL` → `NEXT_PUBLIC_API_URL` → `NEXT_PUBLIC_SITE_URL`. Django renders and caches the PNG — no Edge Runtime or `@vercel/og` required.
+The dynamic URL is resolved automatically from `NEXT_PUBLIC_MEDIA_URL` → `NEXT_PUBLIC_API_URL` → `NEXT_PUBLIC_SITE_URL`. Django renders and caches the PNG — no Edge Runtime or `@vercel/og` required.
 
 ### Navigation Utilities
 
@@ -453,7 +461,7 @@ import { RedirectPage } from '@djangocfg/layouts/components/RedirectPage';
 | `@djangocfg/nextjs/pwa/worker` | Service worker creation helpers |
 | `@djangocfg/nextjs/sitemap` | Sitemap generation with i18n hreflang support |
 | `@djangocfg/nextjs/health` | Health check handlers |
-| `@djangocfg/nextjs/og-image` | OG image URL builder for Django's `django_ogimage` renderer |
+| `@djangocfg/nextjs/og-image` | Page metadata factory + static/dynamic OG images for Django's `django_ogimage` |
 | `@djangocfg/nextjs/navigation` | Route definitions, menu generation, navigation helpers |
 
 ## API Reference
@@ -613,47 +621,41 @@ createHealthHandler({
 })
 ```
 
-### OG Image
+### Page Metadata + OG Image
 
-`@djangocfg/nextjs/og-image` builds typed URLs pointing to Django's `django_ogimage` renderer.
-No Edge Runtime, no `@vercel/og`, no JSX templates — Django renders and caches the PNG.
+`@djangocfg/nextjs/og-image` builds complete page metadata and OG images for
+Django's `django_ogimage` renderer. No Edge Runtime, no `@vercel/og`, no JSX
+templates — Django renders and caches the PNG.
 
-See [`src/og-image/README.md`](./src/og-image/README.md) for full docs including URL resolution logic and deployment examples.
+See [`src/og-image/README.md`](./src/og-image/README.md) for full docs (the `og`
+axis, `SiteMetaConfig`/`PageMeta` fields, URL resolution, deployment examples).
 
-#### `withOgImage(metadata, params)`
+#### `makeMetadataFactory(config)` — recommended
 
-Merges OG image into an existing `Metadata` object. Auto-extracts `title` if not in params.
+Binds a `SiteMetaConfig` once; returns a per-page factory. The OG image is set by
+the single `og` field: `'static'` (default) · `'dynamic'` · `{ render }` · `{ image, alt? }`.
 
 ```tsx
-import { withOgImage } from '@djangocfg/nextjs/og-image'
-
-export async function generateMetadata(): Promise<Metadata> {
-  return withOgImage(
-    { title: 'My Page', description: 'Description' },
-    { preset: 'DARK_BLUE', layout: 'HERO' }
-  )
-}
-```
-
-#### `createOgMetadata(params)`
+import { makeMetadataFactory } from '@djangocfg/nextjs/og-image'
 
-Returns a `Metadata` fragment with `openGraph.images` + `twitter.images`.
-
-```tsx
-import { createOgMetadata } from '@djangocfg/nextjs/og-image'
+export const createMetadata = makeMetadataFactory({
+  name: 'CMDOP', description: '…', siteUrl: 'https://cmdop.com',
+  ogImage: '/static/ogimage.png', locales: LOCALES,
+})
 
-export async function generateMetadata() {
-  return createOgMetadata({ title: 'Page', preset: 'DARK_BLUE' })
-}
+export const metadata = createMetadata({ title: 'About', path: '/about' })          // static
+export const metadata = createMetadata({ title: post.title, path, og: 'dynamic' })  // rendered title
 ```
 
-#### `buildOgUrl(params)`
+#### Low-level (escape hatches)
 
-Returns the raw URL string. Useful when you need the URL outside of metadata.
+`withOgImage(metadata, params)` merges a dynamic OG image into existing metadata;
+`createOgMetadata(params)` returns the `{ openGraph, twitter }` fragment;
+`buildOgUrl(params)` returns the raw URL string; `resolveOgImage(spec, …)` is the
+`OgSpec` decision point. Most pages use `createMetadata` and never touch these.
 
 ```tsx
 import { buildOgUrl } from '@djangocfg/nextjs/og-image'
-
 const url = buildOgUrl({ title: 'Hello', preset: 'DARK_BLUE' })
 ```
 

package/dist/config/index.mjs

@@ -14,7 +14,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@djangocfg/nextjs",
-      version: "2.1.438",
+      version: "2.1.439",
       description: "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
       keywords: [
         "nextjs",