sanity-plugin-seofields 1.2.6 → 1.2.7

package/README.md

@@ -658,6 +658,205 @@ export function SEO({seo}) {
 }
 ```
 
+## 🎯 Framework Integration Examples
+
+### Remix (Loader + Action Approach)
+
+Handle SEO metadata in Remix loaders for server-side rendering with JSON responses:
+
+```typescript
+// routes/posts.$slug.tsx
+import {json, type LoaderFunction} from '@remix-run/node'
+import {useLoaderData} from '@remix-run/react'
+import {buildSeoMeta} from 'sanity-plugin-seofields/utils'
+
+export const loader: LoaderFunction = async ({params}) => {
+  // Fetch post with SEO fields from Sanity
+  const post = await sanityClient.fetch(
+    `*[_type == "post" && slug.current == $slug][0]{
+      title, content, seo, slug
+    }`,
+    {slug: params.slug},
+  )
+  
+  // Use buildSeoMeta to generate meta tags
+  const seoMeta = buildSeoMeta(post.seo, {
+    defaultTitle: 'Blog',
+    siteUrl: 'https://example.com',
+  })
+  
+  return json({post, seoMeta})
+}
+
+export const meta: MetaFunction<typeof loader> = ({data}) => {
+  return data?.seoMeta || []
+}
+
+export default function PostRoute() {
+  const {post} = useLoaderData<typeof loader>()
+  return <article>{post.title}</article>
+}
+```
+
+### Nuxt 3 (Composable Approach)
+
+Create a composable for SSR-friendly SEO management:
+
+```typescript
+// composables/useSanityMeta.ts
+import {buildSeoMeta} from 'sanity-plugin-seofields/utils'
+
+export const useSanityMeta = (seo: SEOFields, options = {}) => {
+  const {
+    defaultTitle = 'My Site',
+    siteUrl = 'https://example.com',
+  } = options
+  
+  const meta = buildSeoMeta(seo, {defaultTitle, siteUrl})
+  
+  // useHead() handles SSR + client-side rendering
+  useHead({
+    title: seo?.title || defaultTitle,
+    meta: meta.map(m => ({
+      name: m.name || m.property,
+      content: m.content,
+    })),
+    link: seo?.canonicalUrl 
+      ? [{rel: 'canonical', href: seo.canonicalUrl}]
+      : [],
+  })
+}
+
+// pages/blog/[slug].vue
+<script setup lang="ts">
+const route = useRoute()
+const {data: post} = await useFetch(`/api/posts/${route.params.slug}`)
+
+useSanityMeta(post.value?.seo, {
+  siteUrl: 'https://example.com',
+})
+</script>
+
+<template>
+  <article v-if="post">
+    <h1>{{ post.title }}</h1>
+  </article>
+</template>
+```
+
+### Astro (Server-Side Rendering)
+
+Leverage Astro's component-level SEO with static generation:
+
+```typescript
+// src/pages/blog/[slug].astro
+---
+import {buildSeoMeta} from 'sanity-plugin-seofields/utils'
+import Layout from '../../layouts/Layout.astro'
+
+// Fetch from Sanity at build time
+const {slug} = Astro.params
+const post = await sanityClient.fetch(
+  `*[_type == "post" && slug.current == $slug][0]{
+    title, content, seo, slug
+  }`,
+  {slug},
+)
+
+// Generate meta tags for static HTML
+const seoMeta = buildSeoMeta(post.seo, {
+  defaultTitle: 'Blog',
+  siteUrl: Astro.site,
+})
+---
+
+<Layout
+  title={post.seo?.title}
+  meta={seoMeta}
+  canonicalUrl={post.seo?.canonicalUrl}
+>
+  <article>
+    <h1>{post.title}</h1>
+  </article>
+</Layout>
+
+<!-- Astro layouts handle meta tag rendering -->
+```
+
+### React SPA (Client-Side with Helmet)
+
+For client-rendered React apps without SSR:
+
+```typescript
+// components/PostHead.tsx
+import {Helmet} from 'react-helmet-async'
+import type {SEOFields} from 'sanity-plugin-seofields'
+
+interface PostHeadProps {
+  seo?: SEOFields
+  fallbackTitle: string
+}
+
+export function PostHead({seo, fallbackTitle}: PostHeadProps) {
+  return (
+    <Helmet>
+      {/* Basic Meta */}
+      <title>{seo?.title || fallbackTitle}</title>
+      <meta name="description" content={seo?.description || ''} />
+      
+      {/* Open Graph - critical for social shares */}
+      <meta property="og:title" content={seo?.openGraph?.title} />
+      <meta property="og:description" content={seo?.openGraph?.description} />
+      {seo?.openGraph?.image?.url && (
+        <meta property="og:image" content={seo.openGraph.image.url} />
+      )}
+      
+      {/* Robots */}
+      {seo?.robots?.noIndex && <meta name="robots" content="noindex" />}
+      
+      {/* Canonical (limit crawl budget) */}
+      {seo?.canonicalUrl && (
+        <link rel="canonical" href={seo.canonicalUrl} />
+      )}
+    </Helmet>
+  )
+}
+
+// Usage in page component
+// Note: Client-side rendering cannot inject meta tags pre-page-load.
+// For public pages, use SSR or static generation instead.
+```
+
+---
+
+## 🚀 Migrating from Other SEO Plugins
+
+Coming from **Yoast**, **All in One SEO**, or **RankMath**?
+
+| Feature | Yoast | All in One SEO | RankMath | sanity-plugin-seofields |
+|---------|-------|----------------|----------|------------------------|
+| **Meta Title/Description** | ✅ | ✅ | ✅ | ✅ |
+| **Open Graph Tags** | ✅ | ✅ | ✅ | ✅ |
+| **Twitter Cards** | ⚠️ Limited | ✅ | ✅ | ✅ |
+| **Readability Analysis** | ✅ | ✅ | ✅ | ❌ (Sanity-native focus) |
+| **Keyword Density** | ✅ | ✅ | ✅ | ❌ (External tools) |
+| **Custom Meta Attributes** | ⚠️ Limited | ✅ | ✅ | ✅ |
+| **Robots/Canonical** | ✅ | ✅ | ✅ | ✅ |
+| **Headless-First** | ❌ | ❌ | ❌ | ✅ Framework-agnostic |
+| **SSR-Ready** | N/A | N/A | N/A | ✅ All frameworks |
+
+### Migration Path
+
+1. **Export existing metadata** from your old plugin (title, description, OG tags)
+2. **Create a Sanity schema** matching your current fields — map to `seoFields` type
+3. **Bulk import** using Sanity's API or migration scripts
+4. **Update your frontend** to use `buildSeoMeta` utilities instead of plugin hooks
+5. **Test meta rendering** in browsers DevTools and social preview tools
+
+For detailed migration guides, see [Migration Guides](#) in our documentation.
+
+---
+
 ## 📚 API Reference
 
 ### Main Export
@@ -675,6 +874,272 @@ import seofields from 'sanity-plugin-seofields'
 - `metaAttribute` - Individual meta attribute
 - `robots` - Search engine robots settings
 
+## 🔧 Troubleshooting
+
+### TypeScript auto-import not working
+
+**Problem:** `buildSeoMeta` doesn't appear in IDE autocomplete
+
+**Solution:**
+
+1. Check your `package.json` exports field has a `"types"` condition:
+```json
+{
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "default": "./dist/next.js"
+    }
+  }
+}
+```
+
+2. Verify your `tsconfig.json` has the correct `moduleResolution`:
+```json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true
+  }
+}
+```
+
+---
+
+### "Cannot find module 'sanity-plugin-seofields/next'"
+
+**Problem:** Runtime import error when trying to use Next.js utilities
+
+**Solution:**
+
+1. Ensure built files exist in `dist/next.js`:
+```bash
+npm run build
+```
+
+2. Clear and reinstall node_modules:
+```bash
+rm -rf node_modules package-lock.json
+npm install
+```
+
+3. Verify `package.json` exports includes the next export:
+```json
+{
+  "exports": {
+    "./next": {
+      "types": "./dist/next.d.ts",
+      "default": "./dist/next.js"
+    }
+  }
+}
+```
+
+---
+
+### Type inference in generateMetadata()
+
+**Problem:** `buildSeoMeta()` return type is not recognized as Next.js `Metadata`
+
+**Solution:** Explicitly type the return value:
+
+```tsx
+import type {Metadata} from 'next'
+import {buildSeoMeta} from 'sanity-plugin-seofields/next'
+
+export async function generateMetadata(): Promise<Metadata> {
+  const seoData = await fetchSeoData()
+  const metadata = buildSeoMeta(seoData)
+  
+  return {
+    title: metadata.title,
+    description: metadata.description,
+    openGraph: {
+      title: metadata.openGraph?.title,
+      description: metadata.openGraph?.description,
+      url: metadata.openGraph?.url,
+    },
+    twitter: {
+      card: metadata.twitter?.card as any,
+      site: metadata.twitter?.site,
+      creator: metadata.twitter?.creator,
+    },
+  }
+}
+```
+
+---
+
+### Dashboard not showing in Sanity Studio
+
+**Problem:** SEO Health tool doesn't appear in the studio
+
+**Solution:**
+
+1. Ensure the plugin is added to `sanity.config.ts`:
+```typescript
+import seofields from 'sanity-plugin-seofields'
+
+export default defineConfig({
+  // ... other config
+  plugins: [
+    seofields({
+      documentTypes: ['post', 'page', 'product'],
+      // other options
+    }),
+  ],
+})
+```
+
+2. Check that `documentTypes` array includes your document types:
+```typescript
+seofields({
+  documentTypes: ['post', 'page'], // Add your document types here
+})
+```
+
+3. Verify plugin config fieldVisibility is not hiding SEO fields:
+```typescript
+seofields({
+  documentTypes: ['post'],
+  fieldVisibility: {
+    // Make sure SEO fields aren't set to hidden
+  },
+})
+```
+
+---
+
+### Image URLs not resolving
+
+**Problem:** OG/Twitter images show as `undefined` in meta tags
+
+**Solution:** Provide an `imageUrlResolver` function:
+
+```tsx
+import imageUrlBuilder from '@sanity/image-url'
+import {client} from './sanity.client'
+
+const imageBuilder = imageUrlBuilder(client)
+
+export function buildImageUrl(source) {
+  if (!source) return undefined
+  return imageBuilder.image(source).url()
+}
+
+// In your buildSeoMeta call:
+const metadata = buildSeoMeta({
+  ...seoData,
+  imageUrlResolver: buildImageUrl,
+})
+```
+
+Or use it in your Next.js layout:
+
+```tsx
+import {buildSeoMeta} from 'sanity-plugin-seofields/next'
+import imageUrlBuilder from '@sanity/image-url'
+
+const imageBuilder = imageUrlBuilder(client)
+
+export async function generateMetadata(): Promise<Metadata> {
+  const seoData = await sanityFetch(SeoQuery)
+  
+  const metadata = buildSeoMeta({
+    ...seoData,
+    imageUrlResolver: (image) => imageBuilder.image(image).url(),
+  })
+  
+  return metadata
+}
+```
+
+---
+
+### generateMetadata() not finding Sanity data
+
+**Problem:** Data is `undefined` when trying to fetch from Sanity in Next.js
+
+**Solution:**
+
+1. Ensure `sanityFetch` is properly awaited:
+```tsx
+import {sanityFetch} from '@/lib/sanity.client'
+
+export async function generateMetadata(): Promise<Metadata> {
+  try {
+    const seoData = await sanityFetch(SeoQuery) // Don't forget await!
+    return buildSeoMeta(seoData)
+  } catch (error) {
+    console.error('Failed to fetch SEO data:', error)
+    return {title: 'Default Title'}
+  }
+}
+```
+
+2. Verify environment variables are set:
+```bash
+# .env.local
+NEXT_PUBLIC_SANITY_PROJECT_ID=your_project_id
+NEXT_PUBLIC_SANITY_DATASET=production
+SANITY_API_TOKEN=your_token (if using authenticated fetches)
+```
+
+3. Complete example with proper error handling:
+```tsx
+import type {Metadata} from 'next'
+import {buildSeoMeta} from 'sanity-plugin-seofields/next'
+import {sanityFetch} from '@/lib/sanity.client'
+
+const SeoQuery = `*[_type == "post" && slug.current == $slug][0] {
+  title,
+  seo {
+    title,
+    description,
+    openGraph {
+      title,
+      description,
+      image,
+    },
+    twitter {
+      card,
+      site,
+      creator,
+    },
+  },
+}`
+
+export async function generateMetadata({
+  params,
+}: {
+  params: {slug: string}
+}): Promise<Metadata> {
+  try {
+    const doc = await sanityFetch(SeoQuery, {slug: params.slug})
+    
+    if (!doc) {
+      return {title: 'Post not found'}
+    }
+    
+    return buildSeoMeta(doc.seo || {})
+  } catch (error) {
+    console.error('SEO metadata error:', error)
+    return {title: 'Error loading page'}
+  }
+}
+```
+
+---
+
+**Still stuck?** Check our:
+- 📖 [Full Documentation](./TYPES_SCHEMA_DOCS.md)
+- 🐛 [GitHub Issues](https://github.com/hardik-143/sanity-plugin-seofields/issues)
+- 📧 [Email Support](mailto:dhardik1430@gmail.com)
+
 ## 🤝 Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/next.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/next.ts","../src/helpers/seoMeta.ts","../src/helpers/SeoMetaTags.tsx"],"sourcesContent":["/**\n * Next.js App Router helpers — safe to import in Server Components.\n *\n * @example\n * import { buildSeoMeta, SeoMetaTags } from 'sanity-plugin-seofields/next'\n */\nexport {buildSeoMeta, sanitizeOGType, sanitizeTwitterCard} from './helpers/seoMeta'\n\nexport type {BuildSeoMetaOptions, SeoMetaDefaults, SeoMetadata} from './helpers/seoMeta'\n\nexport {SeoMetaTags} from './helpers/SeoMetaTags'\nexport type {SeoMetaTagsProps} from './helpers/SeoMetaTags'\n","/**\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"],"mappings":"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","names":["React"]}
+{"version":3,"sources":["../src/next.ts","../src/helpers/seoMeta.ts","../src/helpers/SeoMetaTags.tsx"],"sourcesContent":["/**\n * Next.js App Router helpers — safe to import in Server Components.\n *\n * @example\n * import { buildSeoMeta, SeoMetaTags } from 'sanity-plugin-seofields/next'\n */\nexport type {\n  BuildSeoMetaOptions,\n  SeoFieldsInput,\n  SeoMetadata,\n  SeoMetaDefaults,\n} from './helpers/seoMeta'\nexport {buildSeoMeta, sanitizeOGType, sanitizeTwitterCard} from './helpers/seoMeta'\nexport type {SeoMetaTagsProps} from './helpers/SeoMetaTags'\nexport {SeoMetaTags} from './helpers/SeoMetaTags'\n","/**\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"],"mappings":"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","names":["React"]}

package/dist/next.d.cts

@@ -238,4 +238,4 @@ interface SeoMetaTagsProps {
  */
 declare function SeoMetaTags({ data, baseUrl, path, defaults, imageUrlResolver }: SeoMetaTagsProps): react_jsx_runtime.JSX.Element;
 
-export { type BuildSeoMetaOptions, type SeoMetaDefaults, SeoMetaTags, type SeoMetaTagsProps, type SeoMetadata, buildSeoMeta, sanitizeOGType, sanitizeTwitterCard };
+export { type BuildSeoMetaOptions, type SeoFieldsInput, type SeoMetaDefaults, SeoMetaTags, type SeoMetaTagsProps, type SeoMetadata, buildSeoMeta, sanitizeOGType, sanitizeTwitterCard };

package/dist/next.d.ts

@@ -238,4 +238,4 @@ interface SeoMetaTagsProps {
  */
 declare function SeoMetaTags({ data, baseUrl, path, defaults, imageUrlResolver }: SeoMetaTagsProps): react_jsx_runtime.JSX.Element;
 
-export { type BuildSeoMetaOptions, type SeoMetaDefaults, SeoMetaTags, type SeoMetaTagsProps, type SeoMetadata, buildSeoMeta, sanitizeOGType, sanitizeTwitterCard };
+export { type BuildSeoMetaOptions, type SeoFieldsInput, type SeoMetaDefaults, SeoMetaTags, type SeoMetaTagsProps, type SeoMetadata, buildSeoMeta, sanitizeOGType, sanitizeTwitterCard };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sanity-plugin-seofields",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "description": "A Sanity Studio plugin to manage SEO fields like meta titles, descriptions, and Open Graph tags for structured, search-optimized content.",
   "keywords": [
     "sanity",
@@ -52,8 +52,10 @@
     "format": "prettier --write --cache --ignore-unknown .",
     "lint": "eslint .",
     "prepublishOnly": "npm run build",
-    "generate-schema": "npx tsx schema-generator.ts",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
   },
   "sanityPlugin": {
     "linkWatch": {
@@ -78,9 +80,13 @@
   "devDependencies": {
     "@sanity/codegen": "^4.9.0",
     "@sanity/plugin-kit": "^4.0.20",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/jest": "^30.0.0",
     "@types/react": "^19.1.13",
     "@typescript-eslint/eslint-plugin": "^8.44.0",
     "@typescript-eslint/parser": "^8.44.0",
+    "babel-jest": "^30.3.0",
     "baseline-browser-mapping": "^2.10.8",
     "eslint": "^8.57.1",
     "eslint-config-prettier": "^10.1.8",
@@ -88,12 +94,18 @@
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.2.0",
+    "husky": "^9.1.7",
+    "identity-obj-proxy": "^3.0.0",
+    "jest": "^30.3.0",
+    "jest-environment-jsdom": "^30.3.0",
+    "lint-staged": "^16.4.0",
     "prettier": "^3.6.2",
     "prettier-plugin-packagejson": "^2.5.19",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
     "sanity": "^4.10.0",
     "styled-components": "^6.1.19",
+    "ts-jest": "^29.4.6",
     "ts-json-schema-generator": "^2.4.0",
     "tsup": "^8.0.0",
     "tsx": "^4.20.5",