sanity-plugin-seofields 1.8.0 → 1.9.0

package/dist/chunk-KIEO6QG3.js

@@ -0,0 +1,195 @@
+import {
+  __spreadValues
+} from "./chunk-7N4MLTMR.js";
+
+// src/helpers/seoMeta.ts
+var VALID_OG_TYPES = [
+  "website",
+  "article",
+  "profile",
+  "book",
+  "music",
+  "video",
+  "product"
+];
+function sanitizeOGType(value) {
+  if (value && VALID_OG_TYPES.includes(value)) {
+    return value;
+  }
+  return "website";
+}
+var VALID_TWITTER_CARDS = ["summary", "summary_large_image", "app", "player"];
+function sanitizeTwitterCard(value) {
+  if (value && VALID_TWITTER_CARDS.includes(value)) {
+    return value;
+  }
+  return "summary_large_image";
+}
+function resolveOgImage(seo, defaults, imageUrlResolver) {
+  var _a, _b;
+  if (((_a = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _a.imageType) === "url" && seo.openGraph.imageUrl) {
+    return seo.openGraph.imageUrl;
+  }
+  if (((_b = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _b.image) && imageUrlResolver) {
+    return imageUrlResolver(seo.openGraph.image) || defaults.ogImage || "";
+  }
+  if ((seo == null ? void 0 : seo.metaImage) && imageUrlResolver) {
+    return imageUrlResolver(seo.metaImage) || defaults.ogImage || "";
+  }
+  return defaults.ogImage || "";
+}
+function resolveTwitterImage(seo, ogImageURL, imageUrlResolver) {
+  var _a, _b;
+  if (((_a = seo == null ? void 0 : seo.twitter) == null ? void 0 : _a.imageType) === "url" && seo.twitter.imageUrl) {
+    return seo.twitter.imageUrl;
+  }
+  if (((_b = seo == null ? void 0 : seo.twitter) == null ? void 0 : _b.image) && imageUrlResolver) {
+    return imageUrlResolver(seo.twitter.image) || ogImageURL;
+  }
+  return ogImageURL;
+}
+function buildCustomMetaMap(seo) {
+  const other = {};
+  if (Array.isArray(seo == null ? void 0 : seo.metaAttributes)) {
+    for (const attr of seo.metaAttributes) {
+      if (attr.key && attr.value) {
+        other[attr.key] = attr.value;
+      }
+    }
+  }
+  return other;
+}
+function buildHreflangMap(hreflangs) {
+  if (!Array.isArray(hreflangs)) return void 0;
+  const languages = {};
+  for (const entry of hreflangs) {
+    if ((entry == null ? void 0 : entry.locale) && entry.url) {
+      languages[entry.locale] = entry.url;
+    }
+  }
+  return Object.keys(languages).length > 0 ? languages : void 0;
+}
+function robotsToContent(meta) {
+  var _a, _b, _c, _d;
+  return [
+    ((_a = meta.robots) == null ? void 0 : _a.index) === false ? "noindex" : "index",
+    ((_b = meta.robots) == null ? void 0 : _b.follow) === false ? "nofollow" : "follow",
+    ((_c = meta.robots) == null ? void 0 : _c.notranslate) ? "notranslate" : null,
+    ((_d = meta.robots) == null ? void 0 : _d.noimageindex) ? "noimageindex" : null
+  ].filter(Boolean).join(", ");
+}
+function pushNameMeta(meta, name, content) {
+  if (content) meta.push({ name, content });
+}
+function pushPropertyMeta(meta, property, content) {
+  if (content) meta.push({ property, content });
+}
+function customMetaUsesProperty(name) {
+  return /^(og|fb|article|book|music|profile|product|video):/.test(name);
+}
+function buildSeoMeta(options) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N;
+  const { seo, baseUrl = "", path = "", defaults = {}, imageUrlResolver } = options;
+  const normalizedBase = baseUrl.replace(/\/+$/, "");
+  const normalizedPath = path.replace(/^\/+/, "");
+  const fullUrl = [normalizedBase, normalizedPath].filter(Boolean).join("/");
+  const ogImageURL = resolveOgImage(seo, defaults, imageUrlResolver);
+  const twitterImageURL = resolveTwitterImage(seo, ogImageURL, imageUrlResolver);
+  const other = buildCustomMetaMap(seo);
+  const languages = buildHreflangMap(seo == null ? void 0 : seo.hreflangs);
+  const ogUrl = ((_a = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _a.url) || fullUrl;
+  return __spreadValues({
+    title: (_c = (_b = seo == null ? void 0 : seo.title) != null ? _b : defaults.title) != null ? _c : null,
+    description: (_e = (_d = seo == null ? void 0 : seo.description) != null ? _d : defaults.description) != null ? _e : null,
+    keywords: ((_f = seo == null ? void 0 : seo.keywords) == null ? void 0 : _f.length) ? seo.keywords : void 0,
+    robots: {
+      index: !((_g = seo == null ? void 0 : seo.robots) == null ? void 0 : _g.noIndex),
+      follow: !((_h = seo == null ? void 0 : seo.robots) == null ? void 0 : _h.noFollow),
+      notranslate: !!((_i = seo == null ? void 0 : seo.robots) == null ? void 0 : _i.noTranslate),
+      noimageindex: !!((_j = seo == null ? void 0 : seo.robots) == null ? void 0 : _j.noImageIndex),
+      googleBot: {
+        index: !((_k = seo == null ? void 0 : seo.robots) == null ? void 0 : _k.noIndex),
+        follow: !((_l = seo == null ? void 0 : seo.robots) == null ? void 0 : _l.noFollow),
+        notranslate: !!((_m = seo == null ? void 0 : seo.robots) == null ? void 0 : _m.noTranslate),
+        noimageindex: !!((_n = seo == null ? void 0 : seo.robots) == null ? void 0 : _n.noImageIndex)
+      }
+    },
+    openGraph: {
+      type: sanitizeOGType((_p = (_o = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _o.type) != null ? _p : void 0),
+      url: ogUrl || void 0,
+      title: (_s = (_r = (_q = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _q.title) != null ? _r : seo == null ? void 0 : seo.title) != null ? _s : defaults.title,
+      description: (_v = (_u = (_t = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _t.description) != null ? _u : seo == null ? void 0 : seo.description) != null ? _v : defaults.description,
+      siteName: (_x = (_w = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _w.siteName) != null ? _x : defaults.siteName,
+      images: ogImageURL ? [{ url: ogImageURL }] : []
+    },
+    twitter: {
+      card: sanitizeTwitterCard((_z = (_y = seo == null ? void 0 : seo.twitter) == null ? void 0 : _y.card) != null ? _z : void 0),
+      site: (_B = (_A = seo == null ? void 0 : seo.twitter) == null ? void 0 : _A.site) != null ? _B : defaults.twitterSite,
+      creator: (_D = (_C = seo == null ? void 0 : seo.twitter) == null ? void 0 : _C.creator) != null ? _D : defaults.twitterCreator,
+      title: (_I = (_H = (_G = (_E = seo == null ? void 0 : seo.twitter) == null ? void 0 : _E.title) != null ? _G : (_F = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _F.title) != null ? _H : seo == null ? void 0 : seo.title) != null ? _I : defaults.title,
+      description: (_N = (_M = (_L = (_J = seo == null ? void 0 : seo.twitter) == null ? void 0 : _J.description) != null ? _L : (_K = seo == null ? void 0 : seo.openGraph) == null ? void 0 : _K.description) != null ? _M : seo == null ? void 0 : seo.description) != null ? _N : defaults.description,
+      images: twitterImageURL ? [twitterImageURL] : []
+    },
+    alternates: __spreadValues({
+      canonical: (seo == null ? void 0 : seo.canonicalUrl) || fullUrl || void 0
+    }, languages ? { languages } : {})
+  }, Object.keys(other).length > 0 ? { other } : {});
+}
+function buildSeoHead(options) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o;
+  const metadata = buildSeoMeta(options);
+  const meta = [];
+  const link = [];
+  const robotsContent = robotsToContent(metadata);
+  pushNameMeta(meta, "description", metadata.description);
+  if ((_a = metadata.keywords) == null ? void 0 : _a.length) {
+    pushNameMeta(meta, "keywords", metadata.keywords.join(", "));
+  }
+  pushNameMeta(meta, "robots", robotsContent);
+  pushNameMeta(meta, "googlebot", robotsContent);
+  pushPropertyMeta(meta, "og:type", (_b = metadata.openGraph) == null ? void 0 : _b.type);
+  pushPropertyMeta(meta, "og:url", (_c = metadata.openGraph) == null ? void 0 : _c.url);
+  pushPropertyMeta(meta, "og:title", (_d = metadata.openGraph) == null ? void 0 : _d.title);
+  pushPropertyMeta(meta, "og:description", (_e = metadata.openGraph) == null ? void 0 : _e.description);
+  pushPropertyMeta(meta, "og:site_name", (_f = metadata.openGraph) == null ? void 0 : _f.siteName);
+  for (const image of ((_g = metadata.openGraph) == null ? void 0 : _g.images) || []) {
+    pushPropertyMeta(meta, "og:image", image.url);
+    if (image.width) pushPropertyMeta(meta, "og:image:width", String(image.width));
+    if (image.height) pushPropertyMeta(meta, "og:image:height", String(image.height));
+    if (image.alt) pushPropertyMeta(meta, "og:image:alt", image.alt);
+  }
+  pushNameMeta(meta, "twitter:card", (_h = metadata.twitter) == null ? void 0 : _h.card);
+  pushNameMeta(meta, "twitter:site", (_i = metadata.twitter) == null ? void 0 : _i.site);
+  pushNameMeta(meta, "twitter:creator", (_j = metadata.twitter) == null ? void 0 : _j.creator);
+  pushNameMeta(meta, "twitter:title", (_k = metadata.twitter) == null ? void 0 : _k.title);
+  pushNameMeta(meta, "twitter:description", (_l = metadata.twitter) == null ? void 0 : _l.description);
+  for (const imageUrl of ((_m = metadata.twitter) == null ? void 0 : _m.images) || []) {
+    pushNameMeta(meta, "twitter:image", imageUrl);
+  }
+  for (const [name, content] of Object.entries(metadata.other || {})) {
+    if (customMetaUsesProperty(name)) {
+      pushPropertyMeta(meta, name, content);
+    } else {
+      pushNameMeta(meta, name, content);
+    }
+  }
+  if ((_n = metadata.alternates) == null ? void 0 : _n.canonical) {
+    link.push({ rel: "canonical", href: metadata.alternates.canonical });
+  }
+  for (const [hreflang, href] of Object.entries(((_o = metadata.alternates) == null ? void 0 : _o.languages) || {})) {
+    link.push({ rel: "alternate", hreflang, href });
+  }
+  return {
+    title: metadata.title,
+    meta,
+    link
+  };
+}
+
+export {
+  sanitizeOGType,
+  sanitizeTwitterCard,
+  buildSeoMeta,
+  buildSeoHead
+};
+//# sourceMappingURL=chunk-KIEO6QG3.js.map

package/dist/chunk-KIEO6QG3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/helpers/seoMeta.ts"],"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 * - Astro / Nuxt / Vue / SvelteKit / Remix → buildSeoHead() into native head APIs\n */\n\nimport type {SanityImage, SanityImageWithAlt} 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    notranslate?: boolean\n    noimageindex?: boolean\n    googleBot?: {\n      index?: boolean\n      follow?: boolean\n      notranslate?: boolean\n      noimageindex?: 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    languages?: Record<string, string>\n  }\n  /** Any custom meta attributes from seo.metaAttributes */\n  other?: Record<string, string>\n}\n\n/** Plain `<meta>` tag data returned by buildSeoHead(). */\nexport type SeoHeadMetaTag = {name: string; content: string} | {property: string; content: string}\n\n/** Plain `<link>` tag data returned by buildSeoHead(). */\nexport interface SeoHeadLinkTag {\n  rel: string\n  href: string\n  hreflang?: string\n}\n\n/**\n * Framework-neutral head data returned by buildSeoHead().\n *\n * Use this in Astro, Nuxt, Vue, SvelteKit, Remix, or any frontend where you\n * need plain values instead of React elements or Next.js Metadata.\n */\nexport interface SeoHead {\n  title?: string | null\n  meta: SeoHeadMetaTag[]\n  link: SeoHeadLinkTag[]\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?: {\n    noIndex?: boolean | null\n    noFollow?: boolean | null\n    noTranslate?: boolean | null\n    noImageIndex?: boolean | null\n  } | 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  hreflangs?: Array<{locale?: string | null; url?: string | null}> | 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/**\n * Resolve OG image URL from SEO fields or defaults.\n */\nfunction resolveOgImage(\n  seo: SeoFieldsInput | null | undefined,\n  defaults: SeoMetaDefaults,\n  imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined,\n): string {\n  if (seo?.openGraph?.imageType === 'url' && seo.openGraph.imageUrl) {\n    return seo.openGraph.imageUrl\n  }\n  if (seo?.openGraph?.image && imageUrlResolver) {\n    return imageUrlResolver(seo.openGraph.image as SanityImage) || defaults.ogImage || ''\n  }\n  if (seo?.metaImage && imageUrlResolver) {\n    return imageUrlResolver(seo.metaImage as SanityImage) || defaults.ogImage || ''\n  }\n  return defaults.ogImage || ''\n}\n\n/**\n * Resolve Twitter image URL from SEO fields, falling back to OG image.\n */\nfunction resolveTwitterImage(\n  seo: SeoFieldsInput | null | undefined,\n  ogImageURL: string,\n  imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined,\n): string {\n  if (seo?.twitter?.imageType === 'url' && seo.twitter.imageUrl) {\n    return seo.twitter.imageUrl\n  }\n  if (seo?.twitter?.image && imageUrlResolver) {\n    return imageUrlResolver(seo.twitter.image as SanityImage) || ogImageURL\n  }\n  return ogImageURL\n}\n\n/**\n * Build custom meta attributes map from SEO fields.\n */\nfunction buildCustomMetaMap(seo: SeoFieldsInput | null | undefined): Record<string, string> {\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  return other\n}\n\nfunction buildHreflangMap(\n  hreflangs: SeoFieldsInput['hreflangs'] | null | undefined,\n): Record<string, string> | undefined {\n  if (!Array.isArray(hreflangs)) return undefined\n\n  const languages: Record<string, string> = {}\n  for (const entry of hreflangs) {\n    if (entry?.locale && entry.url) {\n      languages[entry.locale] = entry.url\n    }\n  }\n\n  return Object.keys(languages).length > 0 ? languages : undefined\n}\n\nfunction robotsToContent(meta: SeoMetadata): string {\n  return [\n    meta.robots?.index === false ? 'noindex' : 'index',\n    meta.robots?.follow === false ? 'nofollow' : 'follow',\n    meta.robots?.notranslate ? 'notranslate' : null,\n    meta.robots?.noimageindex ? 'noimageindex' : null,\n  ]\n    .filter(Boolean)\n    .join(', ')\n}\n\nfunction pushNameMeta(meta: SeoHeadMetaTag[], name: string, content?: string | null): void {\n  if (content) meta.push({name, content})\n}\n\nfunction pushPropertyMeta(meta: SeoHeadMetaTag[], property: string, content?: string | null): void {\n  if (content) meta.push({property, content})\n}\n\nfunction customMetaUsesProperty(name: string): boolean {\n  return /^(og|fb|article|book|music|profile|product|video):/.test(name)\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/next'\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  const ogImageURL = resolveOgImage(seo, defaults, imageUrlResolver)\n  const twitterImageURL = resolveTwitterImage(seo, ogImageURL, imageUrlResolver)\n  const other = buildCustomMetaMap(seo)\n  const languages = buildHreflangMap(seo?.hreflangs)\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      notranslate: !!seo?.robots?.noTranslate,\n      noimageindex: !!seo?.robots?.noImageIndex,\n      googleBot: {\n        index: !seo?.robots?.noIndex,\n        follow: !seo?.robots?.noFollow,\n        notranslate: !!seo?.robots?.noTranslate,\n        noimageindex: !!seo?.robots?.noImageIndex,\n      },\n    },\n    openGraph: {\n      type: sanitizeOGType(seo?.openGraph?.type ?? undefined),\n      url: ogUrl || undefined,\n      title: seo?.openGraph?.title ?? seo?.title ?? defaults.title,\n      description: seo?.openGraph?.description ?? seo?.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 ?? seo?.openGraph?.title ?? seo?.title ?? defaults.title,\n      description:\n        seo?.twitter?.description ??\n        seo?.openGraph?.description ??\n        seo?.description ??\n        defaults.description,\n      images: twitterImageURL ? [twitterImageURL] : [],\n    },\n    alternates: {\n      canonical: seo?.canonicalUrl || fullUrl || undefined,\n      ...(languages ? {languages} : {}),\n    },\n    ...(Object.keys(other).length > 0 ? {other} : {}),\n  }\n}\n\n/**\n * Convert Sanity SEO fields into plain head tag data.\n *\n * This helper is framework-neutral: it returns serializable `title`, `meta`,\n * and `link` arrays that can be passed to Astro layouts, Nuxt/Vue `useHead`,\n * SvelteKit `<svelte:head>`, Remix `meta()` exports, or any custom renderer.\n *\n * @example Astro / Nuxt / SvelteKit\n * ```ts\n * import { buildSeoHead } from 'sanity-plugin-seofields/head'\n *\n * const head = buildSeoHead({\n *   seo: page.seo,\n *   baseUrl: 'https://example.com',\n *   path: `/blog/${page.slug}`,\n *   defaults: { title: page.title, siteName: 'My Site' },\n *   imageUrlResolver: (img) => urlFor(img).width(1200).height(630).url(),\n * })\n * ```\n */\nexport function buildSeoHead(options: BuildSeoMetaOptions): SeoHead {\n  const metadata = buildSeoMeta(options)\n  const meta: SeoHeadMetaTag[] = []\n  const link: SeoHeadLinkTag[] = []\n  const robotsContent = robotsToContent(metadata)\n\n  pushNameMeta(meta, 'description', metadata.description)\n  if (metadata.keywords?.length) {\n    pushNameMeta(meta, 'keywords', metadata.keywords.join(', '))\n  }\n  pushNameMeta(meta, 'robots', robotsContent)\n  pushNameMeta(meta, 'googlebot', robotsContent)\n\n  pushPropertyMeta(meta, 'og:type', metadata.openGraph?.type)\n  pushPropertyMeta(meta, 'og:url', metadata.openGraph?.url)\n  pushPropertyMeta(meta, 'og:title', metadata.openGraph?.title)\n  pushPropertyMeta(meta, 'og:description', metadata.openGraph?.description)\n  pushPropertyMeta(meta, 'og:site_name', metadata.openGraph?.siteName)\n\n  for (const image of metadata.openGraph?.images || []) {\n    pushPropertyMeta(meta, 'og:image', image.url)\n    if (image.width) pushPropertyMeta(meta, 'og:image:width', String(image.width))\n    if (image.height) pushPropertyMeta(meta, 'og:image:height', String(image.height))\n    if (image.alt) pushPropertyMeta(meta, 'og:image:alt', image.alt)\n  }\n\n  pushNameMeta(meta, 'twitter:card', metadata.twitter?.card)\n  pushNameMeta(meta, 'twitter:site', metadata.twitter?.site)\n  pushNameMeta(meta, 'twitter:creator', metadata.twitter?.creator)\n  pushNameMeta(meta, 'twitter:title', metadata.twitter?.title)\n  pushNameMeta(meta, 'twitter:description', metadata.twitter?.description)\n\n  for (const imageUrl of metadata.twitter?.images || []) {\n    pushNameMeta(meta, 'twitter:image', imageUrl)\n  }\n\n  for (const [name, content] of Object.entries(metadata.other || {})) {\n    if (customMetaUsesProperty(name)) {\n      pushPropertyMeta(meta, name, content)\n    } else {\n      pushNameMeta(meta, name, content)\n    }\n  }\n\n  if (metadata.alternates?.canonical) {\n    link.push({rel: 'canonical', href: metadata.alternates.canonical})\n  }\n\n  for (const [hreflang, href] of Object.entries(metadata.alternates?.languages || {})) {\n    link.push({rel: 'alternate', hreflang, href})\n  }\n\n  return {\n    title: metadata.title,\n    meta,\n    link,\n  }\n}\n"],"mappings":"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","names":[]}