sanity-plugin-seofields 1.2.3 → 1.2.5

package/dist/next.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: !0 });
+var jsxRuntime = require("react/jsx-runtime"), r = require("react");
+function _interopDefaultCompat(e) {
+  return e && typeof e == "object" && "default" in e ? e : { default: e };
+}
+var r__default = /* @__PURE__ */ _interopDefaultCompat(r);
+const VALID_OG_TYPES = [
+  "website",
+  "article",
+  "profile",
+  "book",
+  "music",
+  "video",
+  "product"
+];
+function sanitizeOGType(value) {
+  return value && VALID_OG_TYPES.includes(value) ? value : "website";
+}
+const VALID_TWITTER_CARDS = ["summary", "summary_large_image", "app", "player"];
+function sanitizeTwitterCard(value) {
+  return value && VALID_TWITTER_CARDS.includes(value) ? value : "summary_large_image";
+}
+function buildSeoMeta(options) {
+  const { seo, baseUrl = "", path = "", defaults = {}, imageUrlResolver } = options, normalizedBase = baseUrl.replace(/\/+$/, ""), normalizedPath = path.replace(/^\/+/, ""), fullUrl = [normalizedBase, normalizedPath].filter(Boolean).join("/");
+  let ogImageURL = defaults.ogImage || "";
+  seo?.openGraph?.imageType === "url" && seo.openGraph.imageUrl ? ogImageURL = seo.openGraph.imageUrl : seo?.openGraph?.image && imageUrlResolver && (ogImageURL = imageUrlResolver(seo.openGraph.image) || ogImageURL);
+  let twitterImageURL = ogImageURL;
+  seo?.twitter?.imageType === "url" && seo.twitter.imageUrl ? twitterImageURL = seo.twitter.imageUrl : seo?.twitter?.image && imageUrlResolver && (twitterImageURL = imageUrlResolver(seo.twitter.image) || twitterImageURL);
+  const other = {};
+  if (Array.isArray(seo?.metaAttributes))
+    for (const attr of seo.metaAttributes)
+      attr.key && attr.value && (other[attr.key] = attr.value);
+  const ogUrl = seo?.openGraph?.url || fullUrl;
+  return {
+    title: seo?.title ?? defaults.title ?? null,
+    description: seo?.description ?? defaults.description ?? null,
+    keywords: seo?.keywords?.length ? seo.keywords : void 0,
+    robots: {
+      index: !seo?.robots?.noIndex,
+      follow: !seo?.robots?.noFollow,
+      googleBot: {
+        index: !seo?.robots?.noIndex,
+        follow: !seo?.robots?.noFollow
+      }
+    },
+    openGraph: {
+      type: sanitizeOGType(seo?.openGraph?.type ?? void 0),
+      url: ogUrl || void 0,
+      title: seo?.openGraph?.title ?? defaults.title,
+      description: seo?.openGraph?.description ?? defaults.description,
+      siteName: seo?.openGraph?.siteName ?? defaults.siteName,
+      images: ogImageURL ? [{ url: ogImageURL }] : []
+    },
+    twitter: {
+      card: sanitizeTwitterCard(seo?.twitter?.card ?? void 0),
+      site: seo?.twitter?.site ?? defaults.twitterSite,
+      creator: seo?.twitter?.creator ?? defaults.twitterCreator,
+      title: seo?.twitter?.title ?? defaults.title,
+      description: seo?.twitter?.description ?? defaults.description,
+      images: twitterImageURL ? [twitterImageURL] : []
+    },
+    alternates: {
+      canonical: fullUrl || void 0
+    },
+    ...Object.keys(other).length > 0 ? { other } : {}
+  };
+}
+function SeoMetaTags({ data, baseUrl, path, defaults, imageUrlResolver }) {
+  const meta = buildSeoMeta({ seo: data, baseUrl, path, defaults, imageUrlResolver }), robotsContent = [
+    meta.robots?.index === !1 ? "noindex" : "index",
+    meta.robots?.follow === !1 ? "nofollow" : "follow"
+  ].join(", ");
+  return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    meta.title && /* @__PURE__ */ jsxRuntime.jsx("title", { children: meta.title }),
+    meta.description && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "description", content: meta.description }),
+    meta.keywords?.length ? /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "keywords", content: meta.keywords.join(", ") }) : null,
+    /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "robots", content: robotsContent }),
+    /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "googlebot", content: robotsContent }),
+    meta.openGraph?.type && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:type", content: meta.openGraph.type }),
+    meta.openGraph?.url && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:url", content: meta.openGraph.url }),
+    meta.openGraph?.title && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:title", content: meta.openGraph.title }),
+    meta.openGraph?.description && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:description", content: meta.openGraph.description }),
+    meta.openGraph?.siteName && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:site_name", content: meta.openGraph.siteName }),
+    meta.openGraph?.images?.map((img, i) => /* @__PURE__ */ jsxRuntime.jsxs(r__default.default.Fragment, { children: [
+      /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:image", content: img.url }),
+      img.width && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:image:width", content: String(img.width) }),
+      img.height && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:image:height", content: String(img.height) }),
+      img.alt && /* @__PURE__ */ jsxRuntime.jsx("meta", { property: "og:image:alt", content: img.alt })
+    ] }, `og-img-${i}`)),
+    meta.twitter?.card && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:card", content: meta.twitter.card }),
+    meta.twitter?.site && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:site", content: meta.twitter.site }),
+    meta.twitter?.creator && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:creator", content: meta.twitter.creator }),
+    meta.twitter?.title && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:title", content: meta.twitter.title }),
+    meta.twitter?.description && /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:description", content: meta.twitter.description }),
+    meta.twitter?.images?.map((url, i) => /* @__PURE__ */ jsxRuntime.jsx("meta", { name: "twitter:image", content: url }, `tw-img-${i}`)),
+    meta.other && Object.entries(meta.other).map(([name, content]) => /* @__PURE__ */ jsxRuntime.jsx("meta", { name, content }, `custom-${name}`)),
+    meta.alternates?.canonical && /* @__PURE__ */ jsxRuntime.jsx("link", { rel: "canonical", href: meta.alternates.canonical })
+  ] });
+}
+exports.SeoMetaTags = SeoMetaTags;
+exports.buildSeoMeta = buildSeoMeta;
+exports.sanitizeOGType = sanitizeOGType;
+exports.sanitizeTwitterCard = sanitizeTwitterCard;
+//# sourceMappingURL=next.js.map

package/dist/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sources":["../src/helpers/seoMeta.ts","../src/helpers/SeoMetaTags.tsx"],"sourcesContent":["/**\n * Headless CMS integration helpers for sanity-plugin-seofields\n *\n * Provides framework-agnostic SEO metadata utilities for use with:\n * - Next.js App Router  → buildSeoMeta() inside generateMetadata()\n * - Next.js Pages Router → <SeoMetaTags> inside Next.js <Head>\n * - Nuxt / Remix / any SSR → <SeoMetaTags> inside your <head> slot\n */\n\nimport type {SanityImage, SanityImageWithAlt, SeoFields} from '../types'\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\n/** Structured metadata returned by buildSeoMeta(). Compatible with Next.js Metadata (App Router). */\nexport interface SeoMetadata {\n  title?: string | null\n  description?: string | null\n  keywords?: string[]\n  robots?: {\n    index?: boolean\n    follow?: boolean\n    googleBot?: {\n      index?: boolean\n      follow?: boolean\n    }\n  }\n  openGraph?: {\n    type?: string\n    url?: string\n    title?: string\n    description?: string\n    siteName?: string\n    images?: Array<{url: string; width?: number; height?: number; alt?: string}>\n  }\n  twitter?: {\n    card?: string\n    site?: string\n    creator?: string\n    title?: string\n    description?: string\n    images?: string[]\n  }\n  alternates?: {\n    canonical?: string\n  }\n  /** Any custom meta attributes from seo.metaAttributes */\n  other?: Record<string, string>\n}\n\n/** Default values used when SEO fields are missing. */\nexport interface SeoMetaDefaults {\n  title?: string\n  description?: string\n  siteName?: string\n  twitterSite?: string\n  twitterCreator?: string\n  /** Fallback image URL when no OG / Twitter image is set. */\n  ogImage?: string\n}\n\n/**\n * Permissive image shape accepted by buildSeoMeta — compatible with both the\n * plugin's SanityImage and Sanity's code-generated image type (where `asset`\n * and `alt` are optional).\n */\ninterface SeoImageInput {\n  _type?: string\n  asset?: {_ref: string; _type: string; _weak?: boolean; [key: string]: unknown}\n  hotspot?: unknown\n  crop?: unknown\n  alt?: string\n}\n\n/**\n * Input-compatible variant of SeoFields. Structurally matches Sanity's\n * code-generated types (where `asset`, `alt`, `key`, and `type` are all\n * optional), so you can pass `data.seo` from a sanityFetch result directly\n * without any `as any` or manual casting.\n */\nexport interface SeoFieldsInput {\n  _type?: string\n  robots?: {noIndex?: boolean | null; noFollow?: boolean | null} | null\n  title?: string | null\n  description?: string | null\n  metaImage?: SeoImageInput | null\n  metaAttributes?: Array<{_key?: string; key?: string; value?: string; type?: string}> | null\n  keywords?: string[] | null\n  canonicalUrl?: string | null\n  openGraph?: {\n    _type?: string\n    url?: string | null\n    title?: string | null\n    description?: string | null\n    siteName?: string | null\n    type?: string | null\n    imageType?: string | null\n    image?: SeoImageInput | null\n    imageUrl?: string | null\n  } | null\n  twitter?: {\n    _type?: string\n    card?: string | null\n    site?: string | null\n    creator?: string | null\n    title?: string | null\n    description?: string | null\n    imageType?: string | null\n    image?: SeoImageInput | null\n    imageUrl?: string | null\n  } | null\n}\n\n/** Options accepted by buildSeoMeta(). */\nexport interface BuildSeoMetaOptions {\n  /**\n   * The raw SEO object from Sanity (_type excluded or included — both work).\n   * Pass `null` or `undefined` to fall back entirely to `defaults`.\n   *\n   * Accepts both the strict plugin `SeoFields` type and Sanity's code-generated\n   * type (which has all nested fields optional) without any `as any` cast.\n   */\n  seo?: SeoFieldsInput | null\n\n  /**\n   * The base URL of your site, e.g. \"https://example.com\".\n   * Used for canonical URL and OpenGraph URL construction.\n   */\n  baseUrl?: string\n\n  /**\n   * The path for the current page, e.g. \"/about\".\n   * Combined with baseUrl to produce the canonical + OG url.\n   * Defaults to \"\".\n   */\n  path?: string\n\n  /**\n   * Default values used when the Sanity SEO fields are empty / missing.\n   */\n  defaults?: SeoMetaDefaults\n\n  /**\n   * Resolve a Sanity image asset to a plain URL string.\n   *\n   * @example (using @sanity/image-url)\n   * imageUrlResolver: (img) => urlFor(img).width(1200).url()\n   */\n  imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined\n}\n\n// ─── Internal helpers ─────────────────────────────────────────────────────────\n\nconst VALID_OG_TYPES = [\n  'website',\n  'article',\n  'profile',\n  'book',\n  'music',\n  'video',\n  'product',\n] as const\ntype OGType = (typeof VALID_OG_TYPES)[number]\n\n/**\n * Coerce an arbitrary string to a valid OpenGraph type.\n * Falls back to \"website\" when the value is invalid.\n */\nexport function sanitizeOGType(value?: string): OGType {\n  if (value && (VALID_OG_TYPES as readonly string[]).includes(value)) {\n    return value as OGType\n  }\n  return 'website'\n}\n\nconst VALID_TWITTER_CARDS = ['summary', 'summary_large_image', 'app', 'player'] as const\ntype TwitterCard = (typeof VALID_TWITTER_CARDS)[number]\n\n/**\n * Coerce an arbitrary string to a valid Twitter card type.\n * Falls back to \"summary_large_image\" when the value is invalid.\n */\nexport function sanitizeTwitterCard(value?: string): TwitterCard {\n  if (value && (VALID_TWITTER_CARDS as readonly string[]).includes(value)) {\n    return value as TwitterCard\n  }\n  return 'summary_large_image'\n}\n\n// ─── Core builder ─────────────────────────────────────────────────────────────\n\n/**\n * Convert a Sanity SEO object into a structured metadata object.\n *\n * The return value is structurally compatible with Next.js App Router's\n * `Metadata` type, so you can return it directly from `generateMetadata()`.\n *\n * @example Next.js App Router\n * ```ts\n * import { buildSeoMeta } from 'sanity-plugin-seofields'\n * import { urlFor } from '@/sanity/lib/image'\n *\n * export async function generateMetadata(): Promise<Metadata> {\n *   const { seo } = await sanityFetch({ query: PAGE_SEO_QUERY })\n *   return buildSeoMeta({\n *     seo,\n *     baseUrl: process.env.NEXT_PUBLIC_SITE_URL,\n *     path: '/about',\n *     defaults: { title: 'My Site', siteName: 'My Site' },\n *     imageUrlResolver: (img) => urlFor(img).width(1200).url(),\n *   })\n * }\n * ```\n */\nexport function buildSeoMeta(options: BuildSeoMetaOptions): SeoMetadata {\n  const {seo, baseUrl = '', path = '', defaults = {}, imageUrlResolver} = options\n\n  const normalizedBase = baseUrl.replace(/\\/+$/, '') // remove trailing /\n  const normalizedPath = path.replace(/^\\/+/, '') // remove leading /\n\n  const fullUrl = [normalizedBase, normalizedPath].filter(Boolean).join('/')\n\n  // ── OG image resolution ──\n  let ogImageURL: string = defaults.ogImage || ''\n  if (seo?.openGraph?.imageType === 'url' && seo.openGraph.imageUrl) {\n    ogImageURL = seo.openGraph.imageUrl\n  } else if (seo?.openGraph?.image && imageUrlResolver) {\n    ogImageURL = imageUrlResolver(seo.openGraph.image as SanityImage) || ogImageURL\n  }\n\n  // ── Twitter image resolution ──\n  let twitterImageURL: string = ogImageURL // reuse OG image as fallback\n  if (seo?.twitter?.imageType === 'url' && seo.twitter.imageUrl) {\n    twitterImageURL = seo.twitter.imageUrl\n  } else if (seo?.twitter?.image && imageUrlResolver) {\n    twitterImageURL = imageUrlResolver(seo.twitter.image as SanityImage) || twitterImageURL\n  }\n\n  // ── Custom meta attributes → `other` map ──\n  const other: Record<string, string> = {}\n  if (Array.isArray(seo?.metaAttributes)) {\n    for (const attr of seo!.metaAttributes!) {\n      if (attr.key && attr.value) {\n        other[attr.key] = attr.value\n      }\n    }\n  }\n\n  const ogUrl = seo?.openGraph?.url || fullUrl\n\n  return {\n    title: seo?.title ?? defaults.title ?? null,\n    description: seo?.description ?? defaults.description ?? null,\n    keywords: seo?.keywords?.length ? (seo.keywords as string[]) : undefined,\n    robots: {\n      index: !seo?.robots?.noIndex,\n      follow: !seo?.robots?.noFollow,\n      googleBot: {\n        index: !seo?.robots?.noIndex,\n        follow: !seo?.robots?.noFollow,\n      },\n    },\n    openGraph: {\n      type: sanitizeOGType(seo?.openGraph?.type ?? undefined),\n      url: ogUrl || undefined,\n      title: seo?.openGraph?.title ?? defaults.title,\n      description: seo?.openGraph?.description ?? defaults.description,\n      siteName: seo?.openGraph?.siteName ?? defaults.siteName,\n      images: ogImageURL ? [{url: ogImageURL}] : [],\n    },\n    twitter: {\n      card: sanitizeTwitterCard(seo?.twitter?.card ?? undefined),\n      site: seo?.twitter?.site ?? defaults.twitterSite,\n      creator: seo?.twitter?.creator ?? defaults.twitterCreator,\n      title: seo?.twitter?.title ?? defaults.title,\n      description: seo?.twitter?.description ?? defaults.description,\n      images: twitterImageURL ? [twitterImageURL] : [],\n    },\n    alternates: {\n      canonical: fullUrl || undefined,\n    },\n    ...(Object.keys(other).length > 0 ? {other} : {}),\n  }\n}\n","/**\n * <SeoMetaTags> — Framework-agnostic React SEO meta tag renderer.\n *\n * Renders all SEO meta tags as plain React elements.\n * Place it inside your framework's <Head> component:\n *\n * @example Next.js Pages Router\n * ```tsx\n * import Head from 'next/head'\n * import { SeoMetaTags } from 'sanity-plugin-seofields'\n *\n * export default function Page({ seo }) {\n *   return (\n *     <>\n *       <Head>\n *         <SeoMetaTags\n *           data={seo}\n *           baseUrl=\"https://example.com\"\n *           path=\"/about\"\n *           defaults={{ title: 'My Site', siteName: 'My Site' }}\n *           imageUrlResolver={(img) => urlFor(img).width(1200).url()}\n *         />\n *       </Head>\n *       <main>...</main>\n *     </>\n *   )\n * }\n * ```\n *\n * @example Nuxt 3 / generic SSR (inside <Head> slot)\n * ```tsx\n * <Head>\n *   <SeoMetaTags data={seo} baseUrl=\"https://example.com\" path=\"/\" />\n * </Head>\n * ```\n */\nimport React from 'react'\n\nimport type {SanityImage, SanityImageWithAlt, SeoFields} from '../types'\nimport {buildSeoMeta, type BuildSeoMetaOptions} from './seoMeta'\n\n// ─── Props ────────────────────────────────────────────────────────────────────\n\nexport interface SeoMetaTagsProps {\n  /**\n   * The raw SEO object from Sanity.\n   * Pass `null` / `undefined` to render only the defaults.\n   */\n  data?: Partial<SeoFields> | null\n\n  /**\n   * Base URL of your site, e.g. \"https://example.com\".\n   * Used for canonical link, og:url fallback.\n   */\n  baseUrl?: string\n\n  /**\n   * Current page path, e.g. \"/about\".\n   * Defaults to \"\".\n   */\n  path?: string\n\n  /**\n   * Default values used when SEO fields are missing.\n   */\n  defaults?: BuildSeoMetaOptions['defaults']\n\n  /**\n   * Resolve a Sanity image asset reference to a full URL string.\n   *\n   * @example\n   * imageUrlResolver={(img) => urlFor(img).width(1200).url()}\n   */\n  imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined\n}\n\n// ─── Component ────────────────────────────────────────────────────────────────\n\n/**\n * Renders all SEO meta tags for a page as plain React elements.\n * Intended to be placed inside your framework's <Head> / <head> component.\n *\n * Renders:\n * - `<title>`\n * - `<meta name=\"description\">`\n * - `<meta name=\"keywords\">`\n * - `<meta name=\"robots\">`\n * - OpenGraph meta tags (`og:*`)\n * - Twitter Card meta tags (`twitter:*`)\n * - Any custom `seo.metaAttributes` as `<meta name=\"...\" content=\"...\">`\n */\nexport function SeoMetaTags({data, baseUrl, path, defaults, imageUrlResolver}: SeoMetaTagsProps) {\n  const meta = buildSeoMeta({seo: data, baseUrl, path, defaults, imageUrlResolver})\n\n  const robotsContent = [\n    meta.robots?.index === false ? 'noindex' : 'index',\n    meta.robots?.follow === false ? 'nofollow' : 'follow',\n  ].join(', ')\n\n  return (\n    <>\n      {/* ── Title ── */}\n      {meta.title && <title>{meta.title}</title>}\n\n      {/* ── Basic meta ── */}\n      {meta.description && <meta name=\"description\" content={meta.description} />}\n      {meta.keywords?.length ? <meta name=\"keywords\" content={meta.keywords.join(', ')} /> : null}\n      <meta name=\"robots\" content={robotsContent} />\n      <meta name=\"googlebot\" content={robotsContent} />\n\n      {/* ── Open Graph ── */}\n      {meta.openGraph?.type && <meta property=\"og:type\" content={meta.openGraph.type} />}\n      {meta.openGraph?.url && <meta property=\"og:url\" content={meta.openGraph.url} />}\n      {meta.openGraph?.title && <meta property=\"og:title\" content={meta.openGraph.title} />}\n      {meta.openGraph?.description && (\n        <meta property=\"og:description\" content={meta.openGraph.description} />\n      )}\n      {meta.openGraph?.siteName && (\n        <meta property=\"og:site_name\" content={meta.openGraph.siteName} />\n      )}\n      {meta.openGraph?.images?.map((img, i) => (\n        <React.Fragment key={`og-img-${i}`}>\n          <meta property=\"og:image\" content={img.url} />\n          {img.width && <meta property=\"og:image:width\" content={String(img.width)} />}\n          {img.height && <meta property=\"og:image:height\" content={String(img.height)} />}\n          {img.alt && <meta property=\"og:image:alt\" content={img.alt} />}\n        </React.Fragment>\n      ))}\n\n      {/* ── Twitter Card ── */}\n      {meta.twitter?.card && <meta name=\"twitter:card\" content={meta.twitter.card} />}\n      {meta.twitter?.site && <meta name=\"twitter:site\" content={meta.twitter.site} />}\n      {meta.twitter?.creator && <meta name=\"twitter:creator\" content={meta.twitter.creator} />}\n      {meta.twitter?.title && <meta name=\"twitter:title\" content={meta.twitter.title} />}\n      {meta.twitter?.description && (\n        <meta name=\"twitter:description\" content={meta.twitter.description} />\n      )}\n      {meta.twitter?.images?.map((url, i) => (\n        <meta key={`tw-img-${i}`} name=\"twitter:image\" content={url} />\n      ))}\n\n      {/* ── Custom meta attributes ── */}\n      {meta.other &&\n        Object.entries(meta.other).map(([name, content]) => (\n          <meta key={`custom-${name}`} name={name} content={content} />\n        ))}\n\n      {/* ── Canonical URL ── */}\n      {meta.alternates?.canonical && <link rel=\"canonical\" href={meta.alternates.canonical} />}\n    </>\n  )\n}\n\nexport default SeoMetaTags\n"],"names":["jsxs","Fragment","jsx","React"],"mappings":"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"}

package/dist/next.mjs

@@ -0,0 +1,102 @@
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import r from "react";
+const VALID_OG_TYPES = [
+  "website",
+  "article",
+  "profile",
+  "book",
+  "music",
+  "video",
+  "product"
+];
+function sanitizeOGType(value) {
+  return value && VALID_OG_TYPES.includes(value) ? value : "website";
+}
+const VALID_TWITTER_CARDS = ["summary", "summary_large_image", "app", "player"];
+function sanitizeTwitterCard(value) {
+  return value && VALID_TWITTER_CARDS.includes(value) ? value : "summary_large_image";
+}
+function buildSeoMeta(options) {
+  const { seo, baseUrl = "", path = "", defaults = {}, imageUrlResolver } = options, normalizedBase = baseUrl.replace(/\/+$/, ""), normalizedPath = path.replace(/^\/+/, ""), fullUrl = [normalizedBase, normalizedPath].filter(Boolean).join("/");
+  let ogImageURL = defaults.ogImage || "";
+  seo?.openGraph?.imageType === "url" && seo.openGraph.imageUrl ? ogImageURL = seo.openGraph.imageUrl : seo?.openGraph?.image && imageUrlResolver && (ogImageURL = imageUrlResolver(seo.openGraph.image) || ogImageURL);
+  let twitterImageURL = ogImageURL;
+  seo?.twitter?.imageType === "url" && seo.twitter.imageUrl ? twitterImageURL = seo.twitter.imageUrl : seo?.twitter?.image && imageUrlResolver && (twitterImageURL = imageUrlResolver(seo.twitter.image) || twitterImageURL);
+  const other = {};
+  if (Array.isArray(seo?.metaAttributes))
+    for (const attr of seo.metaAttributes)
+      attr.key && attr.value && (other[attr.key] = attr.value);
+  const ogUrl = seo?.openGraph?.url || fullUrl;
+  return {
+    title: seo?.title ?? defaults.title ?? null,
+    description: seo?.description ?? defaults.description ?? null,
+    keywords: seo?.keywords?.length ? seo.keywords : void 0,
+    robots: {
+      index: !seo?.robots?.noIndex,
+      follow: !seo?.robots?.noFollow,
+      googleBot: {
+        index: !seo?.robots?.noIndex,
+        follow: !seo?.robots?.noFollow
+      }
+    },
+    openGraph: {
+      type: sanitizeOGType(seo?.openGraph?.type ?? void 0),
+      url: ogUrl || void 0,
+      title: seo?.openGraph?.title ?? defaults.title,
+      description: seo?.openGraph?.description ?? defaults.description,
+      siteName: seo?.openGraph?.siteName ?? defaults.siteName,
+      images: ogImageURL ? [{ url: ogImageURL }] : []
+    },
+    twitter: {
+      card: sanitizeTwitterCard(seo?.twitter?.card ?? void 0),
+      site: seo?.twitter?.site ?? defaults.twitterSite,
+      creator: seo?.twitter?.creator ?? defaults.twitterCreator,
+      title: seo?.twitter?.title ?? defaults.title,
+      description: seo?.twitter?.description ?? defaults.description,
+      images: twitterImageURL ? [twitterImageURL] : []
+    },
+    alternates: {
+      canonical: fullUrl || void 0
+    },
+    ...Object.keys(other).length > 0 ? { other } : {}
+  };
+}
+function SeoMetaTags({ data, baseUrl, path, defaults, imageUrlResolver }) {
+  const meta = buildSeoMeta({ seo: data, baseUrl, path, defaults, imageUrlResolver }), robotsContent = [
+    meta.robots?.index === !1 ? "noindex" : "index",
+    meta.robots?.follow === !1 ? "nofollow" : "follow"
+  ].join(", ");
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    meta.title && /* @__PURE__ */ jsx("title", { children: meta.title }),
+    meta.description && /* @__PURE__ */ jsx("meta", { name: "description", content: meta.description }),
+    meta.keywords?.length ? /* @__PURE__ */ jsx("meta", { name: "keywords", content: meta.keywords.join(", ") }) : null,
+    /* @__PURE__ */ jsx("meta", { name: "robots", content: robotsContent }),
+    /* @__PURE__ */ jsx("meta", { name: "googlebot", content: robotsContent }),
+    meta.openGraph?.type && /* @__PURE__ */ jsx("meta", { property: "og:type", content: meta.openGraph.type }),
+    meta.openGraph?.url && /* @__PURE__ */ jsx("meta", { property: "og:url", content: meta.openGraph.url }),
+    meta.openGraph?.title && /* @__PURE__ */ jsx("meta", { property: "og:title", content: meta.openGraph.title }),
+    meta.openGraph?.description && /* @__PURE__ */ jsx("meta", { property: "og:description", content: meta.openGraph.description }),
+    meta.openGraph?.siteName && /* @__PURE__ */ jsx("meta", { property: "og:site_name", content: meta.openGraph.siteName }),
+    meta.openGraph?.images?.map((img, i) => /* @__PURE__ */ jsxs(r.Fragment, { children: [
+      /* @__PURE__ */ jsx("meta", { property: "og:image", content: img.url }),
+      img.width && /* @__PURE__ */ jsx("meta", { property: "og:image:width", content: String(img.width) }),
+      img.height && /* @__PURE__ */ jsx("meta", { property: "og:image:height", content: String(img.height) }),
+      img.alt && /* @__PURE__ */ jsx("meta", { property: "og:image:alt", content: img.alt })
+    ] }, `og-img-${i}`)),
+    meta.twitter?.card && /* @__PURE__ */ jsx("meta", { name: "twitter:card", content: meta.twitter.card }),
+    meta.twitter?.site && /* @__PURE__ */ jsx("meta", { name: "twitter:site", content: meta.twitter.site }),
+    meta.twitter?.creator && /* @__PURE__ */ jsx("meta", { name: "twitter:creator", content: meta.twitter.creator }),
+    meta.twitter?.title && /* @__PURE__ */ jsx("meta", { name: "twitter:title", content: meta.twitter.title }),
+    meta.twitter?.description && /* @__PURE__ */ jsx("meta", { name: "twitter:description", content: meta.twitter.description }),
+    meta.twitter?.images?.map((url, i) => /* @__PURE__ */ jsx("meta", { name: "twitter:image", content: url }, `tw-img-${i}`)),
+    meta.other && Object.entries(meta.other).map(([name, content]) => /* @__PURE__ */ jsx("meta", { name, content }, `custom-${name}`)),
+    meta.alternates?.canonical && /* @__PURE__ */ jsx("link", { rel: "canonical", href: meta.alternates.canonical })
+  ] });
+}
+export {
+  SeoMetaTags,
+  buildSeoMeta,
+  sanitizeOGType,
+  sanitizeTwitterCard
+};
+//# sourceMappingURL=next.mjs.map

package/dist/next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.mjs","sources":["../src/helpers/seoMeta.ts","../src/helpers/SeoMetaTags.tsx"],"sourcesContent":["/**\n * Headless CMS integration helpers for sanity-plugin-seofields\n *\n * Provides framework-agnostic SEO metadata utilities for use with:\n * - Next.js App Router  → buildSeoMeta() inside generateMetadata()\n * - Next.js Pages Router → <SeoMetaTags> inside Next.js <Head>\n * - Nuxt / Remix / any SSR → <SeoMetaTags> inside your <head> slot\n */\n\nimport type {SanityImage, SanityImageWithAlt, SeoFields} from '../types'\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\n/** Structured metadata returned by buildSeoMeta(). Compatible with Next.js Metadata (App Router). */\nexport interface SeoMetadata {\n  title?: string | null\n  description?: string | null\n  keywords?: string[]\n  robots?: {\n    index?: boolean\n    follow?: boolean\n    googleBot?: {\n      index?: boolean\n      follow?: boolean\n    }\n  }\n  openGraph?: {\n    type?: string\n    url?: string\n    title?: string\n    description?: string\n    siteName?: string\n    images?: Array<{url: string; width?: number; height?: number; alt?: string}>\n  }\n  twitter?: {\n    card?: string\n    site?: string\n    creator?: string\n    title?: string\n    description?: string\n    images?: string[]\n  }\n  alternates?: {\n    canonical?: string\n  }\n  /** Any custom meta attributes from seo.metaAttributes */\n  other?: Record<string, string>\n}\n\n/** Default values used when SEO fields are missing. */\nexport interface SeoMetaDefaults {\n  title?: string\n  description?: string\n  siteName?: string\n  twitterSite?: string\n  twitterCreator?: string\n  /** Fallback image URL when no OG / Twitter image is set. */\n  ogImage?: string\n}\n\n/**\n * Permissive image shape accepted by buildSeoMeta — compatible with both the\n * plugin's SanityImage and Sanity's code-generated image type (where `asset`\n * and `alt` are optional).\n */\ninterface SeoImageInput {\n  _type?: string\n  asset?: {_ref: string; _type: string; _weak?: boolean; [key: string]: unknown}\n  hotspot?: unknown\n  crop?: unknown\n  alt?: string\n}\n\n/**\n * Input-compatible variant of SeoFields. Structurally matches Sanity's\n * code-generated types (where `asset`, `alt`, `key`, and `type` are all\n * optional), so you can pass `data.seo` from a sanityFetch result directly\n * without any `as any` or manual casting.\n */\nexport interface SeoFieldsInput {\n  _type?: string\n  robots?: {noIndex?: boolean | null; noFollow?: boolean | null} | null\n  title?: string | null\n  description?: string | null\n  metaImage?: SeoImageInput | null\n  metaAttributes?: Array<{_key?: string; key?: string; value?: string; type?: string}> | null\n  keywords?: string[] | null\n  canonicalUrl?: string | null\n  openGraph?: {\n    _type?: string\n    url?: string | null\n    title?: string | null\n    description?: string | null\n    siteName?: string | null\n    type?: string | null\n    imageType?: string | null\n    image?: SeoImageInput | null\n    imageUrl?: string | null\n  } | null\n  twitter?: {\n    _type?: string\n    card?: string | null\n    site?: string | null\n    creator?: string | null\n    title?: string | null\n    description?: string | null\n    imageType?: string | null\n    image?: SeoImageInput | null\n    imageUrl?: string | null\n  } | null\n}\n\n/** Options accepted by buildSeoMeta(). */\nexport interface BuildSeoMetaOptions {\n  /**\n   * The raw SEO object from Sanity (_type excluded or included — both work).\n   * Pass `null` or `undefined` to fall back entirely to `defaults`.\n   *\n   * Accepts both the strict plugin `SeoFields` type and Sanity's code-generated\n   * type (which has all nested fields optional) without any `as any` cast.\n   */\n  seo?: SeoFieldsInput | null\n\n  /**\n   * The base URL of your site, e.g. \"https://example.com\".\n   * Used for canonical URL and OpenGraph URL construction.\n   */\n  baseUrl?: string\n\n  /**\n   * The path for the current page, e.g. \"/about\".\n   * Combined with baseUrl to produce the canonical + OG url.\n   * Defaults to \"\".\n   */\n  path?: string\n\n  /**\n   * Default values used when the Sanity SEO fields are empty / missing.\n   */\n  defaults?: SeoMetaDefaults\n\n  /**\n   * Resolve a Sanity image asset to a plain URL string.\n   *\n   * @example (using @sanity/image-url)\n   * imageUrlResolver: (img) => urlFor(img).width(1200).url()\n   */\n  imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined\n}\n\n// ─── Internal helpers ─────────────────────────────────────────────────────────\n\nconst VALID_OG_TYPES = [\n  'website',\n  'article',\n  'profile',\n  'book',\n  'music',\n  'video',\n  'product',\n] as const\ntype OGType = (typeof VALID_OG_TYPES)[number]\n\n/**\n * Coerce an arbitrary string to a valid OpenGraph type.\n * Falls back to \"website\" when the value is invalid.\n */\nexport function sanitizeOGType(value?: string): OGType {\n  if (value && (VALID_OG_TYPES as readonly string[]).includes(value)) {\n    return value as OGType\n  }\n  return 'website'\n}\n\nconst VALID_TWITTER_CARDS = ['summary', 'summary_large_image', 'app', 'player'] as const\ntype TwitterCard = (typeof VALID_TWITTER_CARDS)[number]\n\n/**\n * Coerce an arbitrary string to a valid Twitter card type.\n * Falls back to \"summary_large_image\" when the value is invalid.\n */\nexport function sanitizeTwitterCard(value?: string): TwitterCard {\n  if (value && (VALID_TWITTER_CARDS as readonly string[]).includes(value)) {\n    return value as TwitterCard\n  }\n  return 'summary_large_image'\n}\n\n// ─── Core builder ─────────────────────────────────────────────────────────────\n\n/**\n * Convert a Sanity SEO object into a structured metadata object.\n *\n * The return value is structurally compatible with Next.js App Router's\n * `Metadata` type, so you can return it directly from `generateMetadata()`.\n *\n * @example Next.js App Router\n * ```ts\n * import { buildSeoMeta } from 'sanity-plugin-seofields'\n * import { urlFor } from '@/sanity/lib/image'\n *\n * export async function generateMetadata(): Promise<Metadata> {\n *   const { seo } = await sanityFetch({ query: PAGE_SEO_QUERY })\n *   return buildSeoMeta({\n *     seo,\n *     baseUrl: process.env.NEXT_PUBLIC_SITE_URL,\n *     path: '/about',\n *     defaults: { title: 'My Site', siteName: 'My Site' },\n *     imageUrlResolver: (img) => urlFor(img).width(1200).url(),\n *   })\n * }\n * ```\n */\nexport function buildSeoMeta(options: BuildSeoMetaOptions): SeoMetadata {\n  const {seo, baseUrl = '', path = '', defaults = {}, imageUrlResolver} = options\n\n  const normalizedBase = baseUrl.replace(/\\/+$/, '') // remove trailing /\n  const normalizedPath = path.replace(/^\\/+/, '') // remove leading /\n\n  const fullUrl = [normalizedBase, normalizedPath].filter(Boolean).join('/')\n\n  // ── OG image resolution ──\n  let ogImageURL: string = defaults.ogImage || ''\n  if (seo?.openGraph?.imageType === 'url' && seo.openGraph.imageUrl) {\n    ogImageURL = seo.openGraph.imageUrl\n  } else if (seo?.openGraph?.image && imageUrlResolver) {\n    ogImageURL = imageUrlResolver(seo.openGraph.image as SanityImage) || ogImageURL\n  }\n\n  // ── Twitter image resolution ──\n  let twitterImageURL: string = ogImageURL // reuse OG image as fallback\n  if (seo?.twitter?.imageType === 'url' && seo.twitter.imageUrl) {\n    twitterImageURL = seo.twitter.imageUrl\n  } else if (seo?.twitter?.image && imageUrlResolver) {\n    twitterImageURL = imageUrlResolver(seo.twitter.image as SanityImage) || twitterImageURL\n  }\n\n  // ── Custom meta attributes → `other` map ──\n  const other: Record<string, string> = {}\n  if (Array.isArray(seo?.metaAttributes)) {\n    for (const attr of seo!.metaAttributes!) {\n      if (attr.key && attr.value) {\n        other[attr.key] = attr.value\n      }\n    }\n  }\n\n  const ogUrl = seo?.openGraph?.url || fullUrl\n\n  return {\n    title: seo?.title ?? defaults.title ?? null,\n    description: seo?.description ?? defaults.description ?? null,\n    keywords: seo?.keywords?.length ? (seo.keywords as string[]) : undefined,\n    robots: {\n      index: !seo?.robots?.noIndex,\n      follow: !seo?.robots?.noFollow,\n      googleBot: {\n        index: !seo?.robots?.noIndex,\n        follow: !seo?.robots?.noFollow,\n      },\n    },\n    openGraph: {\n      type: sanitizeOGType(seo?.openGraph?.type ?? undefined),\n      url: ogUrl || undefined,\n      title: seo?.openGraph?.title ?? defaults.title,\n      description: seo?.openGraph?.description ?? defaults.description,\n      siteName: seo?.openGraph?.siteName ?? defaults.siteName,\n      images: ogImageURL ? [{url: ogImageURL}] : [],\n    },\n    twitter: {\n      card: sanitizeTwitterCard(seo?.twitter?.card ?? undefined),\n      site: seo?.twitter?.site ?? defaults.twitterSite,\n      creator: seo?.twitter?.creator ?? defaults.twitterCreator,\n      title: seo?.twitter?.title ?? defaults.title,\n      description: seo?.twitter?.description ?? defaults.description,\n      images: twitterImageURL ? [twitterImageURL] : [],\n    },\n    alternates: {\n      canonical: fullUrl || undefined,\n    },\n    ...(Object.keys(other).length > 0 ? {other} : {}),\n  }\n}\n","/**\n * <SeoMetaTags> — Framework-agnostic React SEO meta tag renderer.\n *\n * Renders all SEO meta tags as plain React elements.\n * Place it inside your framework's <Head> component:\n *\n * @example Next.js Pages Router\n * ```tsx\n * import Head from 'next/head'\n * import { SeoMetaTags } from 'sanity-plugin-seofields'\n *\n * export default function Page({ seo }) {\n *   return (\n *     <>\n *       <Head>\n *         <SeoMetaTags\n *           data={seo}\n *           baseUrl=\"https://example.com\"\n *           path=\"/about\"\n *           defaults={{ title: 'My Site', siteName: 'My Site' }}\n *           imageUrlResolver={(img) => urlFor(img).width(1200).url()}\n *         />\n *       </Head>\n *       <main>...</main>\n *     </>\n *   )\n * }\n * ```\n *\n * @example Nuxt 3 / generic SSR (inside <Head> slot)\n * ```tsx\n * <Head>\n *   <SeoMetaTags data={seo} baseUrl=\"https://example.com\" path=\"/\" />\n * </Head>\n * ```\n */\nimport React from 'react'\n\nimport type {SanityImage, SanityImageWithAlt, SeoFields} from '../types'\nimport {buildSeoMeta, type BuildSeoMetaOptions} from './seoMeta'\n\n// ─── Props ────────────────────────────────────────────────────────────────────\n\nexport interface SeoMetaTagsProps {\n  /**\n   * The raw SEO object from Sanity.\n   * Pass `null` / `undefined` to render only the defaults.\n   */\n  data?: Partial<SeoFields> | null\n\n  /**\n   * Base URL of your site, e.g. \"https://example.com\".\n   * Used for canonical link, og:url fallback.\n   */\n  baseUrl?: string\n\n  /**\n   * Current page path, e.g. \"/about\".\n   * Defaults to \"\".\n   */\n  path?: string\n\n  /**\n   * Default values used when SEO fields are missing.\n   */\n  defaults?: BuildSeoMetaOptions['defaults']\n\n  /**\n   * Resolve a Sanity image asset reference to a full URL string.\n   *\n   * @example\n   * imageUrlResolver={(img) => urlFor(img).width(1200).url()}\n   */\n  imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined\n}\n\n// ─── Component ────────────────────────────────────────────────────────────────\n\n/**\n * Renders all SEO meta tags for a page as plain React elements.\n * Intended to be placed inside your framework's <Head> / <head> component.\n *\n * Renders:\n * - `<title>`\n * - `<meta name=\"description\">`\n * - `<meta name=\"keywords\">`\n * - `<meta name=\"robots\">`\n * - OpenGraph meta tags (`og:*`)\n * - Twitter Card meta tags (`twitter:*`)\n * - Any custom `seo.metaAttributes` as `<meta name=\"...\" content=\"...\">`\n */\nexport function SeoMetaTags({data, baseUrl, path, defaults, imageUrlResolver}: SeoMetaTagsProps) {\n  const meta = buildSeoMeta({seo: data, baseUrl, path, defaults, imageUrlResolver})\n\n  const robotsContent = [\n    meta.robots?.index === false ? 'noindex' : 'index',\n    meta.robots?.follow === false ? 'nofollow' : 'follow',\n  ].join(', ')\n\n  return (\n    <>\n      {/* ── Title ── */}\n      {meta.title && <title>{meta.title}</title>}\n\n      {/* ── Basic meta ── */}\n      {meta.description && <meta name=\"description\" content={meta.description} />}\n      {meta.keywords?.length ? <meta name=\"keywords\" content={meta.keywords.join(', ')} /> : null}\n      <meta name=\"robots\" content={robotsContent} />\n      <meta name=\"googlebot\" content={robotsContent} />\n\n      {/* ── Open Graph ── */}\n      {meta.openGraph?.type && <meta property=\"og:type\" content={meta.openGraph.type} />}\n      {meta.openGraph?.url && <meta property=\"og:url\" content={meta.openGraph.url} />}\n      {meta.openGraph?.title && <meta property=\"og:title\" content={meta.openGraph.title} />}\n      {meta.openGraph?.description && (\n        <meta property=\"og:description\" content={meta.openGraph.description} />\n      )}\n      {meta.openGraph?.siteName && (\n        <meta property=\"og:site_name\" content={meta.openGraph.siteName} />\n      )}\n      {meta.openGraph?.images?.map((img, i) => (\n        <React.Fragment key={`og-img-${i}`}>\n          <meta property=\"og:image\" content={img.url} />\n          {img.width && <meta property=\"og:image:width\" content={String(img.width)} />}\n          {img.height && <meta property=\"og:image:height\" content={String(img.height)} />}\n          {img.alt && <meta property=\"og:image:alt\" content={img.alt} />}\n        </React.Fragment>\n      ))}\n\n      {/* ── Twitter Card ── */}\n      {meta.twitter?.card && <meta name=\"twitter:card\" content={meta.twitter.card} />}\n      {meta.twitter?.site && <meta name=\"twitter:site\" content={meta.twitter.site} />}\n      {meta.twitter?.creator && <meta name=\"twitter:creator\" content={meta.twitter.creator} />}\n      {meta.twitter?.title && <meta name=\"twitter:title\" content={meta.twitter.title} />}\n      {meta.twitter?.description && (\n        <meta name=\"twitter:description\" content={meta.twitter.description} />\n      )}\n      {meta.twitter?.images?.map((url, i) => (\n        <meta key={`tw-img-${i}`} name=\"twitter:image\" content={url} />\n      ))}\n\n      {/* ── Custom meta attributes ── */}\n      {meta.other &&\n        Object.entries(meta.other).map(([name, content]) => (\n          <meta key={`custom-${name}`} name={name} content={content} />\n        ))}\n\n      {/* ── Canonical URL ── */}\n      {meta.alternates?.canonical && <link rel=\"canonical\" href={meta.alternates.canonical} />}\n    </>\n  )\n}\n\nexport default SeoMetaTags\n"],"names":["React"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sanity-plugin-seofields",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "description": "A Sanity Studio plugin to manage SEO fields like meta titles, descriptions, and Open Graph tags for structured, search-optimized content.",
   "keywords": [
     "sanity",
@@ -23,10 +23,21 @@
       "import": "./dist/index.mjs",
       "default": "./dist/index.js"
     },
+    "./next": {
+      "source": "./src/next.ts",
+      "import": "./dist/next.mjs",
+      "require": "./dist/next.js",
+      "default": "./dist/next.js"
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "next": ["./dist/next.d.ts"]
+    }
+  },
   "files": [
     "dist",
     "sanity.json",
@@ -57,6 +68,7 @@
     "@types/react": "^19.1.13",
     "@typescript-eslint/eslint-plugin": "^8.44.0",
     "@typescript-eslint/parser": "^8.44.0",
+    "baseline-browser-mapping": "^2.10.8",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-config-sanity": "^7.1.4",

package/src/helpers/SeoMetaTags.tsx

@@ -0,0 +1,154 @@
+/**
+ * <SeoMetaTags> — Framework-agnostic React SEO meta tag renderer.
+ *
+ * Renders all SEO meta tags as plain React elements.
+ * Place it inside your framework's <Head> component:
+ *
+ * @example Next.js Pages Router
+ * ```tsx
+ * import Head from 'next/head'
+ * import { SeoMetaTags } from 'sanity-plugin-seofields'
+ *
+ * export default function Page({ seo }) {
+ *   return (
+ *     <>
+ *       <Head>
+ *         <SeoMetaTags
+ *           data={seo}
+ *           baseUrl="https://example.com"
+ *           path="/about"
+ *           defaults={{ title: 'My Site', siteName: 'My Site' }}
+ *           imageUrlResolver={(img) => urlFor(img).width(1200).url()}
+ *         />
+ *       </Head>
+ *       <main>...</main>
+ *     </>
+ *   )
+ * }
+ * ```
+ *
+ * @example Nuxt 3 / generic SSR (inside <Head> slot)
+ * ```tsx
+ * <Head>
+ *   <SeoMetaTags data={seo} baseUrl="https://example.com" path="/" />
+ * </Head>
+ * ```
+ */
+import React from 'react'
+
+import type {SanityImage, SanityImageWithAlt, SeoFields} from '../types'
+import {buildSeoMeta, type BuildSeoMetaOptions} from './seoMeta'
+
+// ─── Props ────────────────────────────────────────────────────────────────────
+
+export interface SeoMetaTagsProps {
+  /**
+   * The raw SEO object from Sanity.
+   * Pass `null` / `undefined` to render only the defaults.
+   */
+  data?: Partial<SeoFields> | null
+
+  /**
+   * Base URL of your site, e.g. "https://example.com".
+   * Used for canonical link, og:url fallback.
+   */
+  baseUrl?: string
+
+  /**
+   * Current page path, e.g. "/about".
+   * Defaults to "".
+   */
+  path?: string
+
+  /**
+   * Default values used when SEO fields are missing.
+   */
+  defaults?: BuildSeoMetaOptions['defaults']
+
+  /**
+   * Resolve a Sanity image asset reference to a full URL string.
+   *
+   * @example
+   * imageUrlResolver={(img) => urlFor(img).width(1200).url()}
+   */
+  imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined
+}
+
+// ─── Component ────────────────────────────────────────────────────────────────
+
+/**
+ * Renders all SEO meta tags for a page as plain React elements.
+ * Intended to be placed inside your framework's <Head> / <head> component.
+ *
+ * Renders:
+ * - `<title>`
+ * - `<meta name="description">`
+ * - `<meta name="keywords">`
+ * - `<meta name="robots">`
+ * - OpenGraph meta tags (`og:*`)
+ * - Twitter Card meta tags (`twitter:*`)
+ * - Any custom `seo.metaAttributes` as `<meta name="..." content="...">`
+ */
+export function SeoMetaTags({data, baseUrl, path, defaults, imageUrlResolver}: SeoMetaTagsProps) {
+  const meta = buildSeoMeta({seo: data, baseUrl, path, defaults, imageUrlResolver})
+
+  const robotsContent = [
+    meta.robots?.index === false ? 'noindex' : 'index',
+    meta.robots?.follow === false ? 'nofollow' : 'follow',
+  ].join(', ')
+
+  return (
+    <>
+      {/* ── Title ── */}
+      {meta.title && <title>{meta.title}</title>}
+
+      {/* ── Basic meta ── */}
+      {meta.description && <meta name="description" content={meta.description} />}
+      {meta.keywords?.length ? <meta name="keywords" content={meta.keywords.join(', ')} /> : null}
+      <meta name="robots" content={robotsContent} />
+      <meta name="googlebot" content={robotsContent} />
+
+      {/* ── Open Graph ── */}
+      {meta.openGraph?.type && <meta property="og:type" content={meta.openGraph.type} />}
+      {meta.openGraph?.url && <meta property="og:url" content={meta.openGraph.url} />}
+      {meta.openGraph?.title && <meta property="og:title" content={meta.openGraph.title} />}
+      {meta.openGraph?.description && (
+        <meta property="og:description" content={meta.openGraph.description} />
+      )}
+      {meta.openGraph?.siteName && (
+        <meta property="og:site_name" content={meta.openGraph.siteName} />
+      )}
+      {meta.openGraph?.images?.map((img, i) => (
+        <React.Fragment key={`og-img-${i}`}>
+          <meta property="og:image" content={img.url} />
+          {img.width && <meta property="og:image:width" content={String(img.width)} />}
+          {img.height && <meta property="og:image:height" content={String(img.height)} />}
+          {img.alt && <meta property="og:image:alt" content={img.alt} />}
+        </React.Fragment>
+      ))}
+
+      {/* ── Twitter Card ── */}
+      {meta.twitter?.card && <meta name="twitter:card" content={meta.twitter.card} />}
+      {meta.twitter?.site && <meta name="twitter:site" content={meta.twitter.site} />}
+      {meta.twitter?.creator && <meta name="twitter:creator" content={meta.twitter.creator} />}
+      {meta.twitter?.title && <meta name="twitter:title" content={meta.twitter.title} />}
+      {meta.twitter?.description && (
+        <meta name="twitter:description" content={meta.twitter.description} />
+      )}
+      {meta.twitter?.images?.map((url, i) => (
+        <meta key={`tw-img-${i}`} name="twitter:image" content={url} />
+      ))}
+
+      {/* ── Custom meta attributes ── */}
+      {meta.other &&
+        Object.entries(meta.other).map(([name, content]) => (
+          <meta key={`custom-${name}`} name={name} content={content} />
+        ))}
+
+      {/* ── Canonical URL ── */}
+      {meta.alternates?.canonical && <link rel="canonical" href={meta.alternates.canonical} />}
+    </>
+  )
+}
+
+export default SeoMetaTags