sanity-plugin-seofields 1.7.0 → 1.9.0

package/dist/define-cli.cjs

@@ -1,12 +1,10 @@
-'use strict';
-
-require('./chunk-S367Y35J.cjs');
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-A57XNQC7.cjs');
 
 // src/define-cli.ts
 function defineSeoCli(config) {
   return config;
 }
 
+
 exports.defineSeoCli = defineSeoCli;
-//# sourceMappingURL=define-cli.cjs.map
 //# sourceMappingURL=define-cli.cjs.map

package/dist/define-cli.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/define-cli.ts"],"names":[],"mappings":";;;;;AAyCO,SAAS,aAAa,MAAA,EAAgD;AAC3E,EAAA,OAAO,MAAA;AACT","file":"define-cli.cjs","sourcesContent":["/**\n * Configuration helper for `seofields` CLI.\n *\n * Create a `seofields.cli.ts` (or `.js`) file in your project root and\n * use `defineSeoCli()` to configure the CLI without passing flags every time.\n *\n * @example\n * ```ts\n * // seofields.cli.ts\n * import { defineSeoCli } from 'sanity-plugin-seofields/define-cli'\n *\n * export default defineSeoCli({\n *   projectId: 'my-project-id',\n *   dataset: 'production',\n *   token: process.env.SANITY_TOKEN,\n *   types: ['post', 'page', 'article'],\n * })\n * ```\n */\n\nexport interface SeoFieldsCliConfig {\n  /** Sanity project ID */\n  projectId?: string\n  /** Sanity dataset name (default: \"production\") */\n  dataset?: string\n  /** Sanity API token (read access at minimum) */\n  token?: string\n  /** Default document types for `report` and `export` commands */\n  types?: string[]\n  /**\n   * Show connection info (project ID, dataset, token source) at the end of\n   * `report` and `export` output. Useful for debugging which credentials\n   * are being used. Defaults to `false`.\n   */\n  showConnectionInfo?: boolean\n}\n\n/**\n * Define CLI configuration for sanity-plugin-seofields commands.\n * Acts as an identity function — provides type safety for the config object.\n */\nexport function defineSeoCli(config: SeoFieldsCliConfig): SeoFieldsCliConfig {\n  return config\n}\n"]}
+{"version":3,"sources":["/Users/hardik/GITHUB/sanity-plugin-seofields/npm/dist/define-cli.cjs","../src/define-cli.ts"],"names":[],"mappings":"AAAA,yGAA6B;AAC7B;AACA;ACuCO,SAAS,YAAA,CAAa,MAAA,EAAgD;AAC3E,EAAA,OAAO,MAAA;AACT;ADrCA;AACE;AACF,oCAAC","file":"/Users/hardik/GITHUB/sanity-plugin-seofields/npm/dist/define-cli.cjs","sourcesContent":[null,"/**\n * Configuration helper for `seofields` CLI.\n *\n * Create a `seofields.cli.ts` (or `.js`) file in your project root and\n * use `defineSeoCli()` to configure the CLI without passing flags every time.\n *\n * @example\n * ```ts\n * // seofields.cli.ts\n * import { defineSeoCli } from 'sanity-plugin-seofields/define-cli'\n *\n * export default defineSeoCli({\n *   projectId: 'my-project-id',\n *   dataset: 'production',\n *   token: process.env.SANITY_TOKEN,\n *   types: ['post', 'page', 'article'],\n * })\n * ```\n */\n\nexport interface SeoFieldsCliConfig {\n  /** Sanity project ID */\n  projectId?: string\n  /** Sanity dataset name (default: \"production\") */\n  dataset?: string\n  /** Sanity API token (read access at minimum) */\n  token?: string\n  /** Default document types for `report` and `export` commands */\n  types?: string[]\n  /**\n   * Show connection info (project ID, dataset, token source) at the end of\n   * `report` and `export` output. Useful for debugging which credentials\n   * are being used. Defaults to `false`.\n   */\n  showConnectionInfo?: boolean\n}\n\n/**\n * Define CLI configuration for sanity-plugin-seofields commands.\n * Acts as an identity function — provides type safety for the config object.\n */\nexport function defineSeoCli(config: SeoFieldsCliConfig): SeoFieldsCliConfig {\n  return config\n}\n"]}

package/dist/define-cli.js

@@ -1,10 +1,10 @@
-import './chunk-2NMEKWO5.js';
+import "./chunk-7N4MLTMR.js";
 
 // src/define-cli.ts
 function defineSeoCli(config) {
   return config;
 }
-
-export { defineSeoCli };
-//# sourceMappingURL=define-cli.js.map
+export {
+  defineSeoCli
+};
 //# sourceMappingURL=define-cli.js.map

package/dist/define-cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/define-cli.ts"],"names":[],"mappings":";;;AAyCO,SAAS,aAAa,MAAA,EAAgD;AAC3E,EAAA,OAAO,MAAA;AACT","file":"define-cli.js","sourcesContent":["/**\n * Configuration helper for `seofields` CLI.\n *\n * Create a `seofields.cli.ts` (or `.js`) file in your project root and\n * use `defineSeoCli()` to configure the CLI without passing flags every time.\n *\n * @example\n * ```ts\n * // seofields.cli.ts\n * import { defineSeoCli } from 'sanity-plugin-seofields/define-cli'\n *\n * export default defineSeoCli({\n *   projectId: 'my-project-id',\n *   dataset: 'production',\n *   token: process.env.SANITY_TOKEN,\n *   types: ['post', 'page', 'article'],\n * })\n * ```\n */\n\nexport interface SeoFieldsCliConfig {\n  /** Sanity project ID */\n  projectId?: string\n  /** Sanity dataset name (default: \"production\") */\n  dataset?: string\n  /** Sanity API token (read access at minimum) */\n  token?: string\n  /** Default document types for `report` and `export` commands */\n  types?: string[]\n  /**\n   * Show connection info (project ID, dataset, token source) at the end of\n   * `report` and `export` output. Useful for debugging which credentials\n   * are being used. Defaults to `false`.\n   */\n  showConnectionInfo?: boolean\n}\n\n/**\n * Define CLI configuration for sanity-plugin-seofields commands.\n * Acts as an identity function — provides type safety for the config object.\n */\nexport function defineSeoCli(config: SeoFieldsCliConfig): SeoFieldsCliConfig {\n  return config\n}\n"]}
+{"version":3,"sources":["../src/define-cli.ts"],"sourcesContent":["/**\n * Configuration helper for `seofields` CLI.\n *\n * Create a `seofields.cli.ts` (or `.js`) file in your project root and\n * use `defineSeoCli()` to configure the CLI without passing flags every time.\n *\n * @example\n * ```ts\n * // seofields.cli.ts\n * import { defineSeoCli } from 'sanity-plugin-seofields/define-cli'\n *\n * export default defineSeoCli({\n *   projectId: 'my-project-id',\n *   dataset: 'production',\n *   token: process.env.SANITY_TOKEN,\n *   types: ['post', 'page', 'article'],\n * })\n * ```\n */\n\nexport interface SeoFieldsCliConfig {\n  /** Sanity project ID */\n  projectId?: string\n  /** Sanity dataset name (default: \"production\") */\n  dataset?: string\n  /** Sanity API token (read access at minimum) */\n  token?: string\n  /** Default document types for `report` and `export` commands */\n  types?: string[]\n  /**\n   * Show connection info (project ID, dataset, token source) at the end of\n   * `report` and `export` output. Useful for debugging which credentials\n   * are being used. Defaults to `false`.\n   */\n  showConnectionInfo?: boolean\n}\n\n/**\n * Define CLI configuration for sanity-plugin-seofields commands.\n * Acts as an identity function — provides type safety for the config object.\n */\nexport function defineSeoCli(config: SeoFieldsCliConfig): SeoFieldsCliConfig {\n  return config\n}\n"],"mappings":";;;AAyCO,SAAS,aAAa,QAAgD;AAC3E,SAAO;AACT;","names":[]}

package/dist/head.cjs

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+var _chunkFUUWBQE2cjs = require('./chunk-FUUWBQE2.cjs');
+require('./chunk-A57XNQC7.cjs');
+
+
+
+
+
+exports.buildSeoHead = _chunkFUUWBQE2cjs.buildSeoHead; exports.buildSeoMeta = _chunkFUUWBQE2cjs.buildSeoMeta; exports.sanitizeOGType = _chunkFUUWBQE2cjs.sanitizeOGType; exports.sanitizeTwitterCard = _chunkFUUWBQE2cjs.sanitizeTwitterCard;
+//# sourceMappingURL=head.cjs.map

package/dist/head.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/hardik/GITHUB/sanity-plugin-seofields/npm/dist/head.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,6OAAC","file":"/Users/hardik/GITHUB/sanity-plugin-seofields/npm/dist/head.cjs"}

package/dist/head.d.cts

@@ -0,0 +1,254 @@
+import { a as SanityImage, b as SanityImageWithAlt } from './types-DxlPXihz.cjs';
+
+/**
+ * Headless CMS integration helpers for sanity-plugin-seofields
+ *
+ * Provides framework-agnostic SEO metadata utilities for use with:
+ * - Next.js App Router  → buildSeoMeta() inside generateMetadata()
+ * - Next.js Pages Router → <SeoMetaTags> inside Next.js <Head>
+ * - Astro / Nuxt / Vue / SvelteKit / Remix → buildSeoHead() into native head APIs
+ */
+
+/** Structured metadata returned by buildSeoMeta(). Compatible with Next.js Metadata (App Router). */
+interface SeoMetadata {
+    title?: string | null;
+    description?: string | null;
+    keywords?: string[];
+    robots?: {
+        index?: boolean;
+        follow?: boolean;
+        notranslate?: boolean;
+        noimageindex?: boolean;
+        googleBot?: {
+            index?: boolean;
+            follow?: boolean;
+            notranslate?: boolean;
+            noimageindex?: boolean;
+        };
+    };
+    openGraph?: {
+        type?: string;
+        url?: string;
+        title?: string;
+        description?: string;
+        siteName?: string;
+        images?: Array<{
+            url: string;
+            width?: number;
+            height?: number;
+            alt?: string;
+        }>;
+    };
+    twitter?: {
+        card?: string;
+        site?: string;
+        creator?: string;
+        title?: string;
+        description?: string;
+        images?: string[];
+    };
+    alternates?: {
+        canonical?: string;
+        languages?: Record<string, string>;
+    };
+    /** Any custom meta attributes from seo.metaAttributes */
+    other?: Record<string, string>;
+}
+/** Plain `<meta>` tag data returned by buildSeoHead(). */
+type SeoHeadMetaTag = {
+    name: string;
+    content: string;
+} | {
+    property: string;
+    content: string;
+};
+/** Plain `<link>` tag data returned by buildSeoHead(). */
+interface SeoHeadLinkTag {
+    rel: string;
+    href: string;
+    hreflang?: string;
+}
+/**
+ * Framework-neutral head data returned by buildSeoHead().
+ *
+ * Use this in Astro, Nuxt, Vue, SvelteKit, Remix, or any frontend where you
+ * need plain values instead of React elements or Next.js Metadata.
+ */
+interface SeoHead {
+    title?: string | null;
+    meta: SeoHeadMetaTag[];
+    link: SeoHeadLinkTag[];
+}
+/** Default values used when SEO fields are missing. */
+interface SeoMetaDefaults {
+    title?: string;
+    description?: string;
+    siteName?: string;
+    twitterSite?: string;
+    twitterCreator?: string;
+    /** Fallback image URL when no OG / Twitter image is set. */
+    ogImage?: string;
+}
+/**
+ * Permissive image shape accepted by buildSeoMeta — compatible with both the
+ * plugin's SanityImage and Sanity's code-generated image type (where `asset`
+ * and `alt` are optional).
+ */
+interface SeoImageInput {
+    _type?: string;
+    asset?: {
+        _ref: string;
+        _type: string;
+        _weak?: boolean;
+        [key: string]: unknown;
+    };
+    hotspot?: unknown;
+    crop?: unknown;
+    alt?: string;
+}
+/**
+ * Input-compatible variant of SeoFields. Structurally matches Sanity's
+ * code-generated types (where `asset`, `alt`, `key`, and `type` are all
+ * optional), so you can pass `data.seo` from a sanityFetch result directly
+ * without any `as any` or manual casting.
+ */
+interface SeoFieldsInput {
+    _type?: string;
+    robots?: {
+        noIndex?: boolean | null;
+        noFollow?: boolean | null;
+        noTranslate?: boolean | null;
+        noImageIndex?: boolean | null;
+    } | null;
+    title?: string | null;
+    description?: string | null;
+    metaImage?: SeoImageInput | null;
+    metaAttributes?: Array<{
+        _key?: string;
+        key?: string;
+        value?: string;
+        type?: string;
+    }> | null;
+    keywords?: string[] | null;
+    canonicalUrl?: string | null;
+    hreflangs?: Array<{
+        locale?: string | null;
+        url?: string | null;
+    }> | null;
+    openGraph?: {
+        _type?: string;
+        url?: string | null;
+        title?: string | null;
+        description?: string | null;
+        siteName?: string | null;
+        type?: string | null;
+        imageType?: string | null;
+        image?: SeoImageInput | null;
+        imageUrl?: string | null;
+    } | null;
+    twitter?: {
+        _type?: string;
+        card?: string | null;
+        site?: string | null;
+        creator?: string | null;
+        title?: string | null;
+        description?: string | null;
+        imageType?: string | null;
+        image?: SeoImageInput | null;
+        imageUrl?: string | null;
+    } | null;
+}
+/** Options accepted by buildSeoMeta(). */
+interface BuildSeoMetaOptions {
+    /**
+     * The raw SEO object from Sanity (_type excluded or included — both work).
+     * Pass `null` or `undefined` to fall back entirely to `defaults`.
+     *
+     * Accepts both the strict plugin `SeoFields` type and Sanity's code-generated
+     * type (which has all nested fields optional) without any `as any` cast.
+     */
+    seo?: SeoFieldsInput | null;
+    /**
+     * The base URL of your site, e.g. "https://example.com".
+     * Used for canonical URL and OpenGraph URL construction.
+     */
+    baseUrl?: string;
+    /**
+     * The path for the current page, e.g. "/about".
+     * Combined with baseUrl to produce the canonical + OG url.
+     * Defaults to "".
+     */
+    path?: string;
+    /**
+     * Default values used when the Sanity SEO fields are empty / missing.
+     */
+    defaults?: SeoMetaDefaults;
+    /**
+     * Resolve a Sanity image asset to a plain URL string.
+     *
+     * @example (using @sanity/image-url)
+     * imageUrlResolver: (img) => urlFor(img).width(1200).url()
+     */
+    imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined;
+}
+declare const VALID_OG_TYPES: readonly ["website", "article", "profile", "book", "music", "video", "product"];
+type OGType = (typeof VALID_OG_TYPES)[number];
+/**
+ * Coerce an arbitrary string to a valid OpenGraph type.
+ * Falls back to "website" when the value is invalid.
+ */
+declare function sanitizeOGType(value?: string): OGType;
+declare const VALID_TWITTER_CARDS: readonly ["summary", "summary_large_image", "app", "player"];
+type TwitterCard = (typeof VALID_TWITTER_CARDS)[number];
+/**
+ * Coerce an arbitrary string to a valid Twitter card type.
+ * Falls back to "summary_large_image" when the value is invalid.
+ */
+declare function sanitizeTwitterCard(value?: string): TwitterCard;
+/**
+ * Convert a Sanity SEO object into a structured metadata object.
+ *
+ * The return value is structurally compatible with Next.js App Router's
+ * `Metadata` type, so you can return it directly from `generateMetadata()`.
+ *
+ * @example Next.js App Router
+ * ```ts
+ * import { buildSeoMeta } from 'sanity-plugin-seofields/next'
+ * import { urlFor } from '@/sanity/lib/image'
+ *
+ * export async function generateMetadata(): Promise<Metadata> {
+ *   const { seo } = await sanityFetch({ query: PAGE_SEO_QUERY })
+ *   return buildSeoMeta({
+ *     seo,
+ *     baseUrl: process.env.NEXT_PUBLIC_SITE_URL,
+ *     path: '/about',
+ *     defaults: { title: 'My Site', siteName: 'My Site' },
+ *     imageUrlResolver: (img) => urlFor(img).width(1200).url(),
+ *   })
+ * }
+ * ```
+ */
+declare function buildSeoMeta(options: BuildSeoMetaOptions): SeoMetadata;
+/**
+ * Convert Sanity SEO fields into plain head tag data.
+ *
+ * This helper is framework-neutral: it returns serializable `title`, `meta`,
+ * and `link` arrays that can be passed to Astro layouts, Nuxt/Vue `useHead`,
+ * SvelteKit `<svelte:head>`, Remix `meta()` exports, or any custom renderer.
+ *
+ * @example Astro / Nuxt / SvelteKit
+ * ```ts
+ * import { buildSeoHead } from 'sanity-plugin-seofields/head'
+ *
+ * const head = buildSeoHead({
+ *   seo: page.seo,
+ *   baseUrl: 'https://example.com',
+ *   path: `/blog/${page.slug}`,
+ *   defaults: { title: page.title, siteName: 'My Site' },
+ *   imageUrlResolver: (img) => urlFor(img).width(1200).height(630).url(),
+ * })
+ * ```
+ */
+declare function buildSeoHead(options: BuildSeoMetaOptions): SeoHead;
+
+export { type BuildSeoMetaOptions, type SeoFieldsInput, type SeoHead, type SeoHeadLinkTag, type SeoHeadMetaTag, type SeoMetaDefaults, type SeoMetadata, buildSeoHead, buildSeoMeta, sanitizeOGType, sanitizeTwitterCard };

package/dist/head.d.ts

@@ -0,0 +1,254 @@
+import { a as SanityImage, b as SanityImageWithAlt } from './types-DxlPXihz.js';
+
+/**
+ * Headless CMS integration helpers for sanity-plugin-seofields
+ *
+ * Provides framework-agnostic SEO metadata utilities for use with:
+ * - Next.js App Router  → buildSeoMeta() inside generateMetadata()
+ * - Next.js Pages Router → <SeoMetaTags> inside Next.js <Head>
+ * - Astro / Nuxt / Vue / SvelteKit / Remix → buildSeoHead() into native head APIs
+ */
+
+/** Structured metadata returned by buildSeoMeta(). Compatible with Next.js Metadata (App Router). */
+interface SeoMetadata {
+    title?: string | null;
+    description?: string | null;
+    keywords?: string[];
+    robots?: {
+        index?: boolean;
+        follow?: boolean;
+        notranslate?: boolean;
+        noimageindex?: boolean;
+        googleBot?: {
+            index?: boolean;
+            follow?: boolean;
+            notranslate?: boolean;
+            noimageindex?: boolean;
+        };
+    };
+    openGraph?: {
+        type?: string;
+        url?: string;
+        title?: string;
+        description?: string;
+        siteName?: string;
+        images?: Array<{
+            url: string;
+            width?: number;
+            height?: number;
+            alt?: string;
+        }>;
+    };
+    twitter?: {
+        card?: string;
+        site?: string;
+        creator?: string;
+        title?: string;
+        description?: string;
+        images?: string[];
+    };
+    alternates?: {
+        canonical?: string;
+        languages?: Record<string, string>;
+    };
+    /** Any custom meta attributes from seo.metaAttributes */
+    other?: Record<string, string>;
+}
+/** Plain `<meta>` tag data returned by buildSeoHead(). */
+type SeoHeadMetaTag = {
+    name: string;
+    content: string;
+} | {
+    property: string;
+    content: string;
+};
+/** Plain `<link>` tag data returned by buildSeoHead(). */
+interface SeoHeadLinkTag {
+    rel: string;
+    href: string;
+    hreflang?: string;
+}
+/**
+ * Framework-neutral head data returned by buildSeoHead().
+ *
+ * Use this in Astro, Nuxt, Vue, SvelteKit, Remix, or any frontend where you
+ * need plain values instead of React elements or Next.js Metadata.
+ */
+interface SeoHead {
+    title?: string | null;
+    meta: SeoHeadMetaTag[];
+    link: SeoHeadLinkTag[];
+}
+/** Default values used when SEO fields are missing. */
+interface SeoMetaDefaults {
+    title?: string;
+    description?: string;
+    siteName?: string;
+    twitterSite?: string;
+    twitterCreator?: string;
+    /** Fallback image URL when no OG / Twitter image is set. */
+    ogImage?: string;
+}
+/**
+ * Permissive image shape accepted by buildSeoMeta — compatible with both the
+ * plugin's SanityImage and Sanity's code-generated image type (where `asset`
+ * and `alt` are optional).
+ */
+interface SeoImageInput {
+    _type?: string;
+    asset?: {
+        _ref: string;
+        _type: string;
+        _weak?: boolean;
+        [key: string]: unknown;
+    };
+    hotspot?: unknown;
+    crop?: unknown;
+    alt?: string;
+}
+/**
+ * Input-compatible variant of SeoFields. Structurally matches Sanity's
+ * code-generated types (where `asset`, `alt`, `key`, and `type` are all
+ * optional), so you can pass `data.seo` from a sanityFetch result directly
+ * without any `as any` or manual casting.
+ */
+interface SeoFieldsInput {
+    _type?: string;
+    robots?: {
+        noIndex?: boolean | null;
+        noFollow?: boolean | null;
+        noTranslate?: boolean | null;
+        noImageIndex?: boolean | null;
+    } | null;
+    title?: string | null;
+    description?: string | null;
+    metaImage?: SeoImageInput | null;
+    metaAttributes?: Array<{
+        _key?: string;
+        key?: string;
+        value?: string;
+        type?: string;
+    }> | null;
+    keywords?: string[] | null;
+    canonicalUrl?: string | null;
+    hreflangs?: Array<{
+        locale?: string | null;
+        url?: string | null;
+    }> | null;
+    openGraph?: {
+        _type?: string;
+        url?: string | null;
+        title?: string | null;
+        description?: string | null;
+        siteName?: string | null;
+        type?: string | null;
+        imageType?: string | null;
+        image?: SeoImageInput | null;
+        imageUrl?: string | null;
+    } | null;
+    twitter?: {
+        _type?: string;
+        card?: string | null;
+        site?: string | null;
+        creator?: string | null;
+        title?: string | null;
+        description?: string | null;
+        imageType?: string | null;
+        image?: SeoImageInput | null;
+        imageUrl?: string | null;
+    } | null;
+}
+/** Options accepted by buildSeoMeta(). */
+interface BuildSeoMetaOptions {
+    /**
+     * The raw SEO object from Sanity (_type excluded or included — both work).
+     * Pass `null` or `undefined` to fall back entirely to `defaults`.
+     *
+     * Accepts both the strict plugin `SeoFields` type and Sanity's code-generated
+     * type (which has all nested fields optional) without any `as any` cast.
+     */
+    seo?: SeoFieldsInput | null;
+    /**
+     * The base URL of your site, e.g. "https://example.com".
+     * Used for canonical URL and OpenGraph URL construction.
+     */
+    baseUrl?: string;
+    /**
+     * The path for the current page, e.g. "/about".
+     * Combined with baseUrl to produce the canonical + OG url.
+     * Defaults to "".
+     */
+    path?: string;
+    /**
+     * Default values used when the Sanity SEO fields are empty / missing.
+     */
+    defaults?: SeoMetaDefaults;
+    /**
+     * Resolve a Sanity image asset to a plain URL string.
+     *
+     * @example (using @sanity/image-url)
+     * imageUrlResolver: (img) => urlFor(img).width(1200).url()
+     */
+    imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined;
+}
+declare const VALID_OG_TYPES: readonly ["website", "article", "profile", "book", "music", "video", "product"];
+type OGType = (typeof VALID_OG_TYPES)[number];
+/**
+ * Coerce an arbitrary string to a valid OpenGraph type.
+ * Falls back to "website" when the value is invalid.
+ */
+declare function sanitizeOGType(value?: string): OGType;
+declare const VALID_TWITTER_CARDS: readonly ["summary", "summary_large_image", "app", "player"];
+type TwitterCard = (typeof VALID_TWITTER_CARDS)[number];
+/**
+ * Coerce an arbitrary string to a valid Twitter card type.
+ * Falls back to "summary_large_image" when the value is invalid.
+ */
+declare function sanitizeTwitterCard(value?: string): TwitterCard;
+/**
+ * Convert a Sanity SEO object into a structured metadata object.
+ *
+ * The return value is structurally compatible with Next.js App Router's
+ * `Metadata` type, so you can return it directly from `generateMetadata()`.
+ *
+ * @example Next.js App Router
+ * ```ts
+ * import { buildSeoMeta } from 'sanity-plugin-seofields/next'
+ * import { urlFor } from '@/sanity/lib/image'
+ *
+ * export async function generateMetadata(): Promise<Metadata> {
+ *   const { seo } = await sanityFetch({ query: PAGE_SEO_QUERY })
+ *   return buildSeoMeta({
+ *     seo,
+ *     baseUrl: process.env.NEXT_PUBLIC_SITE_URL,
+ *     path: '/about',
+ *     defaults: { title: 'My Site', siteName: 'My Site' },
+ *     imageUrlResolver: (img) => urlFor(img).width(1200).url(),
+ *   })
+ * }
+ * ```
+ */
+declare function buildSeoMeta(options: BuildSeoMetaOptions): SeoMetadata;
+/**
+ * Convert Sanity SEO fields into plain head tag data.
+ *
+ * This helper is framework-neutral: it returns serializable `title`, `meta`,
+ * and `link` arrays that can be passed to Astro layouts, Nuxt/Vue `useHead`,
+ * SvelteKit `<svelte:head>`, Remix `meta()` exports, or any custom renderer.
+ *
+ * @example Astro / Nuxt / SvelteKit
+ * ```ts
+ * import { buildSeoHead } from 'sanity-plugin-seofields/head'
+ *
+ * const head = buildSeoHead({
+ *   seo: page.seo,
+ *   baseUrl: 'https://example.com',
+ *   path: `/blog/${page.slug}`,
+ *   defaults: { title: page.title, siteName: 'My Site' },
+ *   imageUrlResolver: (img) => urlFor(img).width(1200).height(630).url(),
+ * })
+ * ```
+ */
+declare function buildSeoHead(options: BuildSeoMetaOptions): SeoHead;
+
+export { type BuildSeoMetaOptions, type SeoFieldsInput, type SeoHead, type SeoHeadLinkTag, type SeoHeadMetaTag, type SeoMetaDefaults, type SeoMetadata, buildSeoHead, buildSeoMeta, sanitizeOGType, sanitizeTwitterCard };

package/dist/head.js

@@ -0,0 +1,14 @@
+import {
+  buildSeoHead,
+  buildSeoMeta,
+  sanitizeOGType,
+  sanitizeTwitterCard
+} from "./chunk-KIEO6QG3.js";
+import "./chunk-7N4MLTMR.js";
+export {
+  buildSeoHead,
+  buildSeoMeta,
+  sanitizeOGType,
+  sanitizeTwitterCard
+};
+//# sourceMappingURL=head.js.map

package/dist/head.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}