npm - sanity-plugin-seofields - Versions diffs - 1.8.0 → 1.10.0 - Mend

sanity-plugin-seofields 1.8.0 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (119) hide show

package/README.md +508 -26
package/dist/SeoHealthTool-2COI27KI.cjs +8 -0
package/dist/SeoHealthTool-2COI27KI.cjs.map +1 -0
package/dist/SeoHealthTool-CWI3KB2V.js +8 -0
package/dist/SeoHealthTool-CWI3KB2V.js.map +1 -0
package/dist/{SeoPreview-3EXR6FD4.cjs → SeoPreview-LMZAWWOE.cjs} +35 -38
package/dist/SeoPreview-LMZAWWOE.cjs.map +1 -0
package/dist/{SeoPreview-4PPAF4NO.js → SeoPreview-UNQBKTQO.js} +14 -11
package/dist/SeoPreview-UNQBKTQO.js.map +1 -0
package/dist/{chunk-B5IVI5LP.cjs → chunk-5XTQRILL.cjs} +286 -236
package/dist/chunk-5XTQRILL.cjs.map +1 -0
package/dist/{chunk-254YHUN3.cjs → chunk-7N4MLTMR.js} +8 -6
package/dist/chunk-7N4MLTMR.js.map +1 -0
package/dist/{chunk-DDAAVRWG.js → chunk-A57XNQC7.cjs} +9 -4
package/dist/chunk-A57XNQC7.cjs.map +1 -0
package/dist/chunk-BWLJDK5J.js +624 -0
package/dist/chunk-BWLJDK5J.js.map +1 -0
package/dist/chunk-CRCXC45D.js +56 -0
package/dist/chunk-CRCXC45D.js.map +1 -0
package/dist/chunk-EUG4MNRC.cjs +713 -0
package/dist/chunk-EUG4MNRC.cjs.map +1 -0
package/dist/{chunk-ZBHLMQTS.cjs → chunk-HHO2AKAP.js} +44 -17
package/dist/chunk-HHO2AKAP.js.map +1 -0
package/dist/chunk-NLEB47UV.js +713 -0
package/dist/chunk-NLEB47UV.js.map +1 -0
package/dist/chunk-OULUDJPI.cjs +254 -0
package/dist/chunk-OULUDJPI.cjs.map +1 -0
package/dist/chunk-R2U7JF7U.cjs +624 -0
package/dist/chunk-R2U7JF7U.cjs.map +1 -0
package/dist/chunk-XD4HKLEA.js +254 -0
package/dist/chunk-XD4HKLEA.js.map +1 -0
package/dist/chunk-XYAZJ3WX.cjs +56 -0
package/dist/chunk-XYAZJ3WX.cjs.map +1 -0
package/dist/{chunk-VR44E62I.js → chunk-XZKQWV2H.js} +204 -33
package/dist/chunk-XZKQWV2H.js.map +1 -0
package/dist/{chunk-HDZZQCH7.js → chunk-Y46ACXM4.cjs} +45 -5
package/dist/chunk-Y46ACXM4.cjs.map +1 -0
package/dist/cli.js +27 -27
package/dist/{component-DEXwtemT.d.ts → component-CjT1hvxh.d.ts} +2 -2
package/dist/{component-BzI-LHPw.d.cts → component-WYh0z8as.d.cts} +2 -2
package/dist/define-cli.cjs +2 -4
package/dist/define-cli.cjs.map +1 -1
package/dist/define-cli.js +4 -4
package/dist/define-cli.js.map +1 -1
package/dist/head.cjs +22 -0
package/dist/head.cjs.map +1 -0
package/dist/head.d.cts +314 -0
package/dist/head.d.ts +314 -0
package/dist/head.js +22 -0
package/dist/head.js.map +1 -0
package/dist/hreflang-_VbSuWYD.d.cts +29 -0
package/dist/hreflang-_VbSuWYD.d.ts +29 -0
package/dist/index.cjs +1072 -368
package/dist/index.cjs.map +1 -1
package/dist/index.d.cts +7 -374
package/dist/index.d.ts +7 -374
package/dist/index.js +1015 -288
package/dist/index.js.map +1 -1
package/dist/next.cjs +212 -455
package/dist/next.cjs.map +1 -1
package/dist/next.d.cts +9 -206
package/dist/next.d.ts +9 -206
package/dist/next.js +189 -111
package/dist/next.js.map +1 -1
package/dist/plugin-HFuWZsJu.d.cts +516 -0
package/dist/plugin-oQUCim56.d.ts +516 -0
package/dist/schema/next.cjs +173 -327
package/dist/schema/next.cjs.map +1 -1
package/dist/schema/next.d.cts +4 -4
package/dist/schema/next.d.ts +4 -4
package/dist/schema/next.js +172 -8
package/dist/schema/next.js.map +1 -1
package/dist/schema.cjs +376 -517
package/dist/schema.cjs.map +1 -1
package/dist/schema.d.cts +5 -5
package/dist/schema.d.ts +5 -5
package/dist/schema.js +216 -11
package/dist/schema.js.map +1 -1
package/dist/server.cjs +149 -0
package/dist/server.cjs.map +1 -0
package/dist/server.d.cts +100 -0
package/dist/server.d.ts +100 -0
package/dist/server.js +149 -0
package/dist/server.js.map +1 -0
package/dist/{types-CW8qFdAn.d.ts → types-BAdN1RMu.d.ts} +2 -2
package/dist/{types-B_vjMPtM.d.cts → types-C5i3KMgs.d.cts} +2 -2
package/dist/{types-BXSCbl6p.d.cts → types-DP-DiW6f.d.cts} +2 -2
package/dist/{types-C19cQx5D.d.ts → types-DRLUGLtX.d.ts} +2 -2
package/dist/{types-yVmQfby9.d.cts → types-DxlPXihz.d.cts} +1 -1
package/dist/{types-yVmQfby9.d.ts → types-DxlPXihz.d.ts} +1 -1
package/package.json +25 -4
package/dist/SeoHealthDashboard-AEKVVMUR-7NWV3C3Y.js +0 -4
package/dist/SeoHealthDashboard-AEKVVMUR-7NWV3C3Y.js.map +0 -1
package/dist/SeoHealthDashboard-AEKVVMUR-XWKJUH24.cjs +0 -10
package/dist/SeoHealthDashboard-AEKVVMUR-XWKJUH24.cjs.map +0 -1
package/dist/SeoHealthTool-2KKQJLJL.cjs +0 -11
package/dist/SeoHealthTool-2KKQJLJL.cjs.map +0 -1
package/dist/SeoHealthTool-3CUKGADZ.js +0 -5
package/dist/SeoHealthTool-3CUKGADZ.js.map +0 -1
package/dist/SeoPreview-3EXR6FD4.cjs.map +0 -1
package/dist/SeoPreview-4PPAF4NO.js.map +0 -1
package/dist/chunk-254YHUN3.cjs.map +0 -1
package/dist/chunk-27XSYENH.js +0 -2215
package/dist/chunk-27XSYENH.js.map +0 -1
package/dist/chunk-B5IVI5LP.cjs.map +0 -1
package/dist/chunk-BNXMFD3T.cjs +0 -431
package/dist/chunk-BNXMFD3T.cjs.map +0 -1
package/dist/chunk-DDAAVRWG.js.map +0 -1
package/dist/chunk-HDZZQCH7.js.map +0 -1
package/dist/chunk-P6IOWIO2.cjs +0 -480
package/dist/chunk-P6IOWIO2.cjs.map +0 -1
package/dist/chunk-UOCZFYYP.js +0 -407
package/dist/chunk-UOCZFYYP.js.map +0 -1
package/dist/chunk-VR44E62I.js.map +0 -1
package/dist/chunk-WKXHX3GO.js +0 -424
package/dist/chunk-WKXHX3GO.js.map +0 -1
package/dist/chunk-XZDLJ2N6.cjs +0 -2224
package/dist/chunk-XZDLJ2N6.cjs.map +0 -1
package/dist/chunk-ZBHLMQTS.cjs.map +0 -1

package/dist/head.cjs.map ADDED Viewed

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

package/dist/head.d.cts ADDED Viewed

@@ -0,0 +1,314 @@
+import { a as SanityImage, b as SanityImageWithAlt } from './types-DxlPXihz.cjs';
+export { B as BuildHreflangsOptions, H as HreflangLinkEntry, a as HreflangTranslation, b as buildHreflangs } from './hreflang-_VbSuWYD.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;
+    /**
+     * Override the hreflang alternates. When provided, this supersedes `seo.hreflangs` — pair it with
+     * `buildHreflangs()` to derive alternates from `@sanity/document-internationalization` translations.
+     *
+     * @example
+     * hreflangs: buildHreflangs(data._translations, { baseUrl })
+     */
+    hreflangs?: Array<{
+        locale?: string | null;
+        url?: string | null;
+    }> | null;
+}
+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;
+interface LlmsLink {
+    title: string;
+    url: string;
+    description?: string;
+}
+interface LlmsSection {
+    title: string;
+    links: LlmsLink[];
+}
+interface BuildLlmsTxtOptions {
+    /** H1 title, e.g. the site name. */
+    title: string;
+    /** One-line blockquote summary rendered directly under the title. */
+    summary?: string;
+    /** Free-form Markdown prose rendered after the summary. */
+    details?: string;
+    /** Link sections rendered as `## {title}` + a bullet list. Empty sections are omitted. */
+    sections?: LlmsSection[];
+    /** Optional version, rendered in a leading `> Version: … | Updated: …` line. */
+    version?: string;
+    /** Optional "updated" label, rendered alongside `version`. */
+    updated?: string;
+    /** Prepended to any relative link URL. */
+    baseUrl?: string;
+}
+declare function buildLlmsTxt(options: BuildLlmsTxtOptions): string;
+interface LlmsDoc {
+    title?: string | null;
+    slug?: {
+        current?: string | null;
+    } | string | null;
+    description?: string | null;
+    [key: string]: unknown;
+}
+interface DocsToLlmsSectionOptions {
+    /** Section heading. */
+    title: string;
+    /** Prepended to each document's path. */
+    baseUrl?: string;
+    /** Build the path for a document. Defaults to `/${slug}`. */
+    resolvePath?: (doc: LlmsDoc) => string | null | undefined;
+    /** Override the link title. Defaults to `doc.title`. */
+    resolveTitle?: (doc: LlmsDoc) => string | null | undefined;
+    /** Override the link description. Defaults to `doc.description`. */
+    resolveDescription?: (doc: LlmsDoc) => string | null | undefined;
+}
+declare function docsToLlmsSection(docs: LlmsDoc[] | null | undefined, options: DocsToLlmsSectionOptions): LlmsSection;
+export { type BuildLlmsTxtOptions, type BuildSeoMetaOptions, type DocsToLlmsSectionOptions, type LlmsDoc, type LlmsLink, type LlmsSection, type SeoFieldsInput, type SeoHead, type SeoHeadLinkTag, type SeoHeadMetaTag, type SeoMetaDefaults, type SeoMetadata, buildLlmsTxt, buildSeoHead, buildSeoMeta, docsToLlmsSection, sanitizeOGType, sanitizeTwitterCard };

package/dist/head.d.ts ADDED Viewed

@@ -0,0 +1,314 @@
+import { a as SanityImage, b as SanityImageWithAlt } from './types-DxlPXihz.js';
+export { B as BuildHreflangsOptions, H as HreflangLinkEntry, a as HreflangTranslation, b as buildHreflangs } from './hreflang-_VbSuWYD.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;
+    /**
+     * Override the hreflang alternates. When provided, this supersedes `seo.hreflangs` — pair it with
+     * `buildHreflangs()` to derive alternates from `@sanity/document-internationalization` translations.
+     *
+     * @example
+     * hreflangs: buildHreflangs(data._translations, { baseUrl })
+     */
+    hreflangs?: Array<{
+        locale?: string | null;
+        url?: string | null;
+    }> | null;
+}
+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;
+interface LlmsLink {
+    title: string;
+    url: string;
+    description?: string;
+}
+interface LlmsSection {
+    title: string;
+    links: LlmsLink[];
+}
+interface BuildLlmsTxtOptions {
+    /** H1 title, e.g. the site name. */
+    title: string;
+    /** One-line blockquote summary rendered directly under the title. */
+    summary?: string;
+    /** Free-form Markdown prose rendered after the summary. */
+    details?: string;
+    /** Link sections rendered as `## {title}` + a bullet list. Empty sections are omitted. */
+    sections?: LlmsSection[];
+    /** Optional version, rendered in a leading `> Version: … | Updated: …` line. */
+    version?: string;
+    /** Optional "updated" label, rendered alongside `version`. */
+    updated?: string;
+    /** Prepended to any relative link URL. */
+    baseUrl?: string;
+}
+declare function buildLlmsTxt(options: BuildLlmsTxtOptions): string;
+interface LlmsDoc {
+    title?: string | null;
+    slug?: {
+        current?: string | null;
+    } | string | null;
+    description?: string | null;
+    [key: string]: unknown;
+}
+interface DocsToLlmsSectionOptions {
+    /** Section heading. */
+    title: string;
+    /** Prepended to each document's path. */
+    baseUrl?: string;
+    /** Build the path for a document. Defaults to `/${slug}`. */
+    resolvePath?: (doc: LlmsDoc) => string | null | undefined;
+    /** Override the link title. Defaults to `doc.title`. */
+    resolveTitle?: (doc: LlmsDoc) => string | null | undefined;
+    /** Override the link description. Defaults to `doc.description`. */
+    resolveDescription?: (doc: LlmsDoc) => string | null | undefined;
+}
+declare function docsToLlmsSection(docs: LlmsDoc[] | null | undefined, options: DocsToLlmsSectionOptions): LlmsSection;
+export { type BuildLlmsTxtOptions, type BuildSeoMetaOptions, type DocsToLlmsSectionOptions, type LlmsDoc, type LlmsLink, type LlmsSection, type SeoFieldsInput, type SeoHead, type SeoHeadLinkTag, type SeoHeadMetaTag, type SeoMetaDefaults, type SeoMetadata, buildLlmsTxt, buildSeoHead, buildSeoMeta, docsToLlmsSection, sanitizeOGType, sanitizeTwitterCard };

package/dist/head.js ADDED Viewed

@@ -0,0 +1,22 @@
+import {
+  buildLlmsTxt,
+  buildSeoHead,
+  buildSeoMeta,
+  docsToLlmsSection,
+  sanitizeOGType,
+  sanitizeTwitterCard
+} from "./chunk-XD4HKLEA.js";
+import {
+  buildHreflangs
+} from "./chunk-CRCXC45D.js";
+import "./chunk-7N4MLTMR.js";
+export {
+  buildHreflangs,
+  buildLlmsTxt,
+  buildSeoHead,
+  buildSeoMeta,
+  docsToLlmsSection,
+  sanitizeOGType,
+  sanitizeTwitterCard
+};
+//# sourceMappingURL=head.js.map

package/dist/head.js.map ADDED Viewed

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

package/dist/hreflang-_VbSuWYD.d.cts ADDED Viewed

@@ -0,0 +1,29 @@
+interface HreflangTranslation {
+    /** BCP 47 language/region tag, e.g. "en", "fr-FR". */
+    language?: string | null;
+    /** Sanity slug — either the raw string or the `{ current }` object. */
+    slug?: {
+        current?: string | null;
+    } | string | null;
+    /** Pre-built path (e.g. "/fr/about"). Wins over `slug`. */
+    path?: string | null;
+    /** Absolute URL. Wins over `baseUrl` + path. */
+    url?: string | null;
+}
+interface BuildHreflangsOptions {
+    /** Site origin, e.g. "https://example.com". Prepended to each translation's path. */
+    baseUrl?: string;
+    /** Build the path for a translation. Defaults to `/${slug}`. Return null/undefined to skip. */
+    resolvePath?: (t: HreflangTranslation) => string | null | undefined;
+    /** Language tag to also emit as an `x-default` entry (pointing at that language's URL). */
+    xDefault?: string;
+    /** Include the current document itself in the set. */
+    current?: HreflangTranslation;
+}
+interface HreflangLinkEntry {
+    locale: string;
+    url: string;
+}
+declare function buildHreflangs(translations: HreflangTranslation[] | null | undefined, options?: BuildHreflangsOptions): HreflangLinkEntry[];
+export { type BuildHreflangsOptions as B, type HreflangLinkEntry as H, type HreflangTranslation as a, buildHreflangs as b };