sanity-plugin-seofields 1.0.6 → 1.0.7

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://badge.fury.io/js/sanity-plugin-seofields.svg)](https://badge.fury.io/js/sanity-plugin-seofields)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A comprehensive Sanity Studio v3 plugin to manage SEO fields like meta titles, descriptions, Open Graph tags, and Twitter Cards for structured, search-optimized content.
+A comprehensive Sanity Studio v3 plugin to manage SEO fields like meta titles, descriptions, Open Graph tags, and X (Formerly Twitter) Cards for structured, search-optimized content.
 
 ## ✨ Features
 
@@ -264,7 +264,7 @@ seofields({
 ```
 
 This is particularly useful when you want to:
-- Manage sitewide settings (like site name and Twitter handle) in a dedicated Site Settings document
+- Manage sitewide settings (like site name and X handle) in a dedicated Site Settings document
 - Simplify the editing experience by hiding fields that aren't relevant for certain content types
 - Create different SEO workflows for different content types
 
@@ -302,12 +302,12 @@ This is particularly useful when you want to:
 - **Large Image**: Minimum 280x150px
 - **Required**: Alt text for accessibility
 
-#### Twitter Card Creator
+#### X (Formerly Twitter) Card Creator
 
-- **Purpose**: Attribution to content creator on Twitter
-- **Format**: Twitter handle with @ symbol (e.g., @creator)
+- **Purpose**: Attribution to content creator on X (formerly Twitter)
+- **Format**: X handle with @ symbol (e.g., @creator)
 - **Usage**: Identifies the individual author of the content
-- **Best Practice**: Use actual Twitter handles for proper attribution
+- **Best Practice**: Use actual X handles for proper attribution
 
 ## 💻 TypeScript Usage
 

package/dist/index.d.mts

@@ -2,9 +2,15 @@ import {ObjectDefinition} from 'sanity'
 import {Plugin as Plugin_2} from 'sanity'
 import {PreviewConfig} from 'sanity'
 
-export declare type AllFieldKeys = SeoFieldKeys | SitewideFieldKeys
+export declare type AllFieldKeys = SeoFieldKeys | openGraphFieldKeys | twitterFieldKeys
 
 export declare function allSchemas(config?: SeoFieldsPluginConfig): (
+  | ({
+      type: 'object'
+      name: 'twitter'
+    } & Omit<ObjectDefinition, 'preview'> & {
+        preview?: PreviewConfig<Record<string, string>, Record<never, any>> | undefined
+      })
   | ({
       type: 'object'
       name: 'seoFields'
@@ -36,12 +42,6 @@ export declare function allSchemas(config?: SeoFieldsPluginConfig): (
     } & Omit<ObjectDefinition, 'preview'> & {
         preview?: PreviewConfig<Record<string, string>, Record<never, any>> | undefined
       })
-  | ({
-      type: 'object'
-      name: 'twitter'
-    } & Omit<ObjectDefinition, 'preview'> & {
-        preview?: PreviewConfig<Record<string, string>, Record<never, any>> | undefined
-      })
   | ({
       type: 'object'
       name: 'robots'
@@ -106,6 +106,16 @@ export declare const metaTagSchema: {
     preview?: PreviewConfig<Record<string, string>, Record<never, any>> | undefined
   }
 
+export declare type openGraphFieldKeys =
+  | 'openGraphUrl'
+  | 'openGraphTitle'
+  | 'openGraphDescription'
+  | 'openGraphSiteName'
+  | 'openGraphType'
+  | 'openGraphImageType'
+  | 'openGraphImage'
+  | 'openGraphImageUrl'
+
 export declare function openGraphSchema(config?: SeoFieldsPluginConfig): {
   type: 'object'
   name: 'openGraph'
@@ -120,7 +130,7 @@ export declare interface OpenGraphSettings {
   siteName?: string
   type?: 'website' | 'article' | 'profile' | 'book' | 'music' | 'video' | 'product'
   imageType?: 'upload' | 'url'
-  image?: SanityImage
+  image?: SanityImageWithAlt
   imageUrl?: string
 }
 
@@ -192,14 +202,52 @@ declare const seofields: Plugin_2<void | SeoFieldsPluginConfig>
 export default seofields
 
 export declare interface SeoFieldsPluginConfig {
-  seoPreview?: boolean
+  /**
+   * Enable or configure the SEO preview feature.
+   * If set to `true`, the SEO preview will be enabled with default settings.
+   * If set to an object, you can provide a custom prefix function to modify the URL prefix in the preview.
+   * The prefix function receives the current document as an argument and should return a string.
+   * Example:
+   * ```
+   * seoPreview: {
+   *   prefix: (doc) => `/${doc.slug?.current || 'untitled'}`
+   * }
+   * ```
+   */
+  seoPreview?:
+    | boolean
+    | {
+        prefix?: (
+          doc: {
+            _type?: string
+          } & Record<string, unknown>,
+        ) => string
+      }
+  /**
+   * A mapping of field keys to their configuration settings.
+   * This allows customization of field titles and descriptions.
+   * For example, to change the title of the 'title' field:
+   */
   fieldOverrides?: {
-    [key in SeoFieldKeys]?: SeoFieldConfig
+    [key in AllFieldKeys]?: SeoFieldConfig
   }
+  /**
+   * A mapping of document types to field visibility configurations.
+   * This allows you to specify which fields should be hidden for specific document types.
+   */
   fieldVisibility?: {
     [postType: string]: FieldVisibilityConfig
   }
+  /**
+   * A list of fields that should be hidden by default in all document types.
+   * This can be overridden by specific document type settings in `fieldVisibility`.
+   */
   defaultHiddenFields?: AllFieldKeys[]
+  /**
+   * The base URL of your website, used for generating full URLs in the SEO preview.
+   * Defaults to 'https://www.example.com' if not provided.
+   */
+  baseUrl?: string
 }
 
 export declare function seoFieldsSchema(config?: SeoFieldsPluginConfig): {
@@ -232,17 +280,27 @@ export declare interface SeoValidationRules {
   }
 }
 
-export declare type SitewideFieldKeys = 'openGraphSiteName' | 'twitterSite'
-
 export declare interface TwitterCardSettings {
   _type: 'twitter'
   card?: 'summary' | 'summary_large_image' | 'app' | 'player'
   site?: string
   title?: string
   description?: string
+  imageType?: 'upload' | 'url'
   image?: SanityImageWithAlt
+  imageUrl?: string
 }
 
+export declare type twitterFieldKeys =
+  | 'twitterCard'
+  | 'twitterSite'
+  | 'twitterCreator'
+  | 'twitterTitle'
+  | 'twitterDescription'
+  | 'twitterImageType'
+  | 'twitterImage'
+  | 'twitterImageUrl'
+
 export declare function twitterSchema(config?: SeoFieldsPluginConfig): {
   type: 'object'
   name: 'twitter'

package/dist/index.d.ts

@@ -2,9 +2,15 @@ import {ObjectDefinition} from 'sanity'
 import {Plugin as Plugin_2} from 'sanity'
 import {PreviewConfig} from 'sanity'
 
-export declare type AllFieldKeys = SeoFieldKeys | SitewideFieldKeys
+export declare type AllFieldKeys = SeoFieldKeys | openGraphFieldKeys | twitterFieldKeys
 
 export declare function allSchemas(config?: SeoFieldsPluginConfig): (
+  | ({
+      type: 'object'
+      name: 'twitter'
+    } & Omit<ObjectDefinition, 'preview'> & {
+        preview?: PreviewConfig<Record<string, string>, Record<never, any>> | undefined
+      })
   | ({
       type: 'object'
       name: 'seoFields'
@@ -36,12 +42,6 @@ export declare function allSchemas(config?: SeoFieldsPluginConfig): (
     } & Omit<ObjectDefinition, 'preview'> & {
         preview?: PreviewConfig<Record<string, string>, Record<never, any>> | undefined
       })
-  | ({
-      type: 'object'
-      name: 'twitter'
-    } & Omit<ObjectDefinition, 'preview'> & {
-        preview?: PreviewConfig<Record<string, string>, Record<never, any>> | undefined
-      })
   | ({
       type: 'object'
       name: 'robots'
@@ -106,6 +106,16 @@ export declare const metaTagSchema: {
     preview?: PreviewConfig<Record<string, string>, Record<never, any>> | undefined
   }
 
+export declare type openGraphFieldKeys =
+  | 'openGraphUrl'
+  | 'openGraphTitle'
+  | 'openGraphDescription'
+  | 'openGraphSiteName'
+  | 'openGraphType'
+  | 'openGraphImageType'
+  | 'openGraphImage'
+  | 'openGraphImageUrl'
+
 export declare function openGraphSchema(config?: SeoFieldsPluginConfig): {
   type: 'object'
   name: 'openGraph'
@@ -120,7 +130,7 @@ export declare interface OpenGraphSettings {
   siteName?: string
   type?: 'website' | 'article' | 'profile' | 'book' | 'music' | 'video' | 'product'
   imageType?: 'upload' | 'url'
-  image?: SanityImage
+  image?: SanityImageWithAlt
   imageUrl?: string
 }
 
@@ -192,14 +202,52 @@ declare const seofields: Plugin_2<void | SeoFieldsPluginConfig>
 export default seofields
 
 export declare interface SeoFieldsPluginConfig {
-  seoPreview?: boolean
+  /**
+   * Enable or configure the SEO preview feature.
+   * If set to `true`, the SEO preview will be enabled with default settings.
+   * If set to an object, you can provide a custom prefix function to modify the URL prefix in the preview.
+   * The prefix function receives the current document as an argument and should return a string.
+   * Example:
+   * ```
+   * seoPreview: {
+   *   prefix: (doc) => `/${doc.slug?.current || 'untitled'}`
+   * }
+   * ```
+   */
+  seoPreview?:
+    | boolean
+    | {
+        prefix?: (
+          doc: {
+            _type?: string
+          } & Record<string, unknown>,
+        ) => string
+      }
+  /**
+   * A mapping of field keys to their configuration settings.
+   * This allows customization of field titles and descriptions.
+   * For example, to change the title of the 'title' field:
+   */
   fieldOverrides?: {
-    [key in SeoFieldKeys]?: SeoFieldConfig
+    [key in AllFieldKeys]?: SeoFieldConfig
   }
+  /**
+   * A mapping of document types to field visibility configurations.
+   * This allows you to specify which fields should be hidden for specific document types.
+   */
   fieldVisibility?: {
     [postType: string]: FieldVisibilityConfig
   }
+  /**
+   * A list of fields that should be hidden by default in all document types.
+   * This can be overridden by specific document type settings in `fieldVisibility`.
+   */
   defaultHiddenFields?: AllFieldKeys[]
+  /**
+   * The base URL of your website, used for generating full URLs in the SEO preview.
+   * Defaults to 'https://www.example.com' if not provided.
+   */
+  baseUrl?: string
 }
 
 export declare function seoFieldsSchema(config?: SeoFieldsPluginConfig): {
@@ -232,17 +280,27 @@ export declare interface SeoValidationRules {
   }
 }
 
-export declare type SitewideFieldKeys = 'openGraphSiteName' | 'twitterSite'
-
 export declare interface TwitterCardSettings {
   _type: 'twitter'
   card?: 'summary' | 'summary_large_image' | 'app' | 'player'
   site?: string
   title?: string
   description?: string
+  imageType?: 'upload' | 'url'
   image?: SanityImageWithAlt
+  imageUrl?: string
 }
 
+export declare type twitterFieldKeys =
+  | 'twitterCard'
+  | 'twitterSite'
+  | 'twitterCreator'
+  | 'twitterTitle'
+  | 'twitterDescription'
+  | 'twitterImageType'
+  | 'twitterImage'
+  | 'twitterImageUrl'
+
 export declare function twitterSchema(config?: SeoFieldsPluginConfig): {
   type: 'object'
   name: 'twitter'

package/dist/index.js

@@ -227,13 +227,13 @@ const stopWords = ["the", "a", "an", "and", "or", "but"], hasMatchingKeyword = (
     ] }, item.text)) })
   ] });
 }, SeoPreview = (props) => {
-  const { path } = props, parent = sanity.useFormValue([path[0]]) || {
+  const { path, schemaType } = props, { options } = schemaType, baseUrl = options?.baseUrl || "https://www.example.com", prefixFunction = options?.prefix, parent = sanity.useFormValue([path[0]]) || {
     title: "",
     description: "",
     canonicalUrl: ""
-  };
-  console.log("SEO Preview Parent:", parent);
-  const {
+  }, rootDoc = sanity.useFormValue([]) || {
+    slug: { current: "" }
+  }, slug = rootDoc?.slug?.current || "", {
     title,
     description,
     canonicalUrl: url
@@ -247,7 +247,22 @@ const stopWords = ["the", "a", "an", "and", "or", "but"], hasMatchingKeyword = (
         fontFamily: "Arial, sans-serif"
       },
       children: /* @__PURE__ */ jsxRuntime.jsxs(ui.Stack, { space: 3, children: [
-        /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: 1, style: { color: "#006621", fontSize: 12, lineHeight: 1.3, marginBottom: 3 }, children: url || "https://www.example.com/page-url" }),
+        /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: 1, style: { color: "#006621", fontSize: 12, lineHeight: 1.3, marginBottom: 3 }, children: (() => {
+          const base = (url || baseUrl)?.replace(/\/+$/, ""), slugStr = String(slug || "").replace(/^\/+/, ""), path2 = [String(prefixFunction ? prefixFunction(rootDoc) : "").replace(
+            /^\/+|\/+$/g,
+            ""
+          ), slugStr].filter(Boolean).join("/"), finalUrl = path2 ? `${base}/${path2}` : base;
+          return /* @__PURE__ */ jsxRuntime.jsx(
+            "a",
+            {
+              href: finalUrl || "#",
+              target: "_blank",
+              rel: "noopener noreferrer",
+              style: { color: "inherit", textDecoration: "none" },
+              children: finalUrl || "https://www.example.com/page-url"
+            }
+          );
+        })() }),
         /* @__PURE__ */ jsxRuntime.jsx(
           ui.Text,
           {
@@ -305,6 +320,70 @@ const stopWords = ["the", "a", "an", "and", "or", "but"], hasMatchingKeyword = (
   metaAttributes: {
     title: "Additional Meta Attributes",
     description: "Add custom meta attributes to the head of the document for additional SEO and social media integration."
+  },
+  openGraphTitle: {
+    title: "Open Graph Title",
+    description: ""
+  },
+  openGraphUrl: {
+    title: "Open Graph URL",
+    description: "The canonical URL of the page. This should be the full URL including protocol (https://)."
+  },
+  openGraphDescription: {
+    title: "Open Graph Description",
+    description: ""
+  },
+  openGraphSiteName: {
+    title: "Open Graph Site Name",
+    description: "The name of your website. This is often the site title."
+  },
+  openGraphType: {
+    title: "Open Graph Type",
+    description: "Select the type of content for Open Graph."
+  },
+  openGraphImageType: {
+    title: "Image Type",
+    description: "Choose whether to upload an image or provide an image URL for Open Graph."
+  },
+  openGraphImage: {
+    title: "Open Graph Image",
+    description: "Recommended size: 1200x630px (minimum 600x315px). Max file size: 5MB. Aspect ratio 1.91:1."
+  },
+  openGraphImageUrl: {
+    title: "Open Graph Image URL",
+    description: "Enter the full URL of the image. Ensure the image is accessible and meets the recommended size of 1200x630px (minimum 600x315px)."
+  },
+  twitterCard: {
+    title: "Card Type",
+    description: ""
+  },
+  twitterSite: {
+    title: "Site X Handle",
+    description: "The X (formerly Twitter) handle of the website (e.g., @example)"
+  },
+  twitterCreator: {
+    title: "X Creator Handle",
+    description: "The X (formerly Twitter) handle of the content creator (e.g., @creator)"
+  },
+  twitterTitle: {
+    title: "X Title",
+    description: "The title of the content as it should appear on X (formerly Twitter)."
+  },
+  twitterDescription: {
+    title: "X Description",
+    description: "A brief description of the content for X (formerly Twitter)."
+  },
+  twitterImageType: {
+    title: "X Image Type",
+    description: "Choose whether to upload an image or provide an image URL for X (formerly Twitter)."
+  },
+  twitterImage: {
+    title: "X Image",
+    description: 'An image URL which should be at least 120x120px for "summary" card and 280x150px for "summary_large_image" card.'
+  },
+  twitterImageUrl: {
+    title: "X Image URL",
+    description: "Enter the full URL of the image for X (formerly Twitter). Ensure the image is accessible and meets the recommended size."
   }
 }, getFieldInfo = (fieldName, fieldOverrides) => {
   const fieldInfo = fieldOverrides && fieldOverrides[fieldName] || DEFAULT_FIELD_INFO[fieldName];
@@ -312,7 +391,7 @@ const stopWords = ["the", "a", "an", "and", "or", "but"], hasMatchingKeyword = (
 }, isFieldHidden = (fieldName, config, documentType) => !!(config.defaultHiddenFields?.includes(fieldName) || documentType && config.fieldVisibility?.[documentType]?.hiddenFields?.includes(fieldName)), getFieldHiddenFunction = (fieldName, config) => ({ document }) => {
   const documentType = document?._type;
   return isFieldHidden(fieldName, config, documentType);
-};
+}, isEmpty = (value) => value == null || typeof value == "string" && value.trim() === "" || Array.isArray(value) && value.length === 0 || typeof value == "object" && !Array.isArray(value) && Object.keys(value).length === 0;
 function seoFieldsSchema(config = {}) {
   return sanity.defineType({
     name: "seoFields",
@@ -327,15 +406,23 @@ function seoFieldsSchema(config = {}) {
         hidden: getFieldHiddenFunction("robots", config)
       }),
       // 👇 conditionally spread preview field
-      ...config.seoPreview ? [] : [
+      ...typeof config.seoPreview == "boolean" && config.seoPreview || typeof config.seoPreview == "object" && !isEmpty(config.seoPreview) ? [
         sanity.defineField({
           name: "preview",
           title: "SEO Preview",
           type: "string",
           components: { input: SeoPreview },
+          options: {
+            baseUrl: config.baseUrl || "https://www.example.com",
+            ...typeof config.seoPreview == "object" && config.seoPreview && config.seoPreview.prefix ? { prefix: config.seoPreview.prefix } : {}
+          },
+          // Use a readOnly field to prevent editing
+          // This field is just for preview purposes
+          initialValue: {},
+          // TypeScript workaround
           readOnly: !0
         })
-      ],
+      ] : [],
       sanity.defineField({
         name: "title",
         ...getFieldInfo("title", config.fieldOverrides),
@@ -522,14 +609,16 @@ function openGraph(config = {}) {
     fields: [
       sanity.defineField({
         name: "url",
-        title: "Open Graph URL",
         type: "url",
+        ...getFieldInfo("openGraphUrl", config.fieldOverrides),
+        hidden: getFieldHiddenFunction("openGraphUrl", config),
         description: "The canonical URL of the page. This should be the full URL including protocol (https://)."
       }),
       sanity.defineField({
         name: "title",
-        title: "Open Graph Title",
+        ...getFieldInfo("openGraphTitle", config.fieldOverrides),
         type: "string",
+        hidden: getFieldHiddenFunction("openGraphTitle", config),
         components: {
           input: OgTitle
           // Can also wrap with a string input + preview
@@ -537,9 +626,10 @@ function openGraph(config = {}) {
       }),
       sanity.defineField({
         name: "description",
-        title: "Open Graph Description",
+        ...getFieldInfo("openGraphDescription", config.fieldOverrides),
         type: "text",
         rows: 3,
+        hidden: getFieldHiddenFunction("openGraphDescription", config),
         components: {
           input: OgDescription
           // Can also wrap with a text area + preview
@@ -547,14 +637,13 @@ function openGraph(config = {}) {
       }),
       sanity.defineField({
         name: "siteName",
-        title: "Open Graph Site Name",
+        ...getFieldInfo("openGraphSiteName", config.fieldOverrides),
         type: "string",
-        description: "The name of your website. This is often the site title.",
         hidden: getFieldHiddenFunction("openGraphSiteName", config)
       }),
       sanity.defineField({
         name: "type",
-        title: "Open Graph Type",
+        ...getFieldInfo("openGraphType", config.fieldOverrides),
         type: "string",
         options: {
           list: [
@@ -568,13 +657,12 @@ function openGraph(config = {}) {
           ]
           // layout: 'radio', // Display as radio buttons
         },
-        initialValue: "website",
-        description: "Select the type of content for Open Graph."
+        hidden: getFieldHiddenFunction("openGraphType", config),
+        initialValue: "website"
       }),
-      // upload image or ask for url
       sanity.defineField({
         name: "imageType",
-        title: "Image Type",
+        ...getFieldInfo("openGraphImageType", config.fieldOverrides),
         type: "string",
         options: {
           list: [
@@ -582,24 +670,31 @@ function openGraph(config = {}) {
             { title: "Image URL", value: "url" }
           ]
         },
+        hidden: getFieldHiddenFunction("openGraphImage", config),
         initialValue: "upload"
       }),
       sanity.defineField({
         name: "image",
-        title: "Open Graph Image",
+        ...getFieldInfo("openGraphImage", config.fieldOverrides),
         type: "image",
         options: {
           hotspot: !0
         },
-        hidden: ({ parent }) => parent?.imageType !== "upload",
-        description: "Recommended size: 1200x630px (minimum 600x315px). Max file size: 5MB. Aspect ratio 1.91:1."
+        fields: [
+          sanity.defineField({
+            name: "alt",
+            title: "Image Alt Text",
+            type: "string",
+            description: "A description of the image for accessibility purposes."
+          })
+        ],
+        hidden: ({ parent }) => parent?.imageType !== "upload"
       }),
       sanity.defineField({
         name: "imageUrl",
-        title: "Open Graph Image URL",
+        ...getFieldInfo("openGraphImageUrl", config.fieldOverrides),
         type: "url",
-        hidden: ({ parent }) => parent?.imageType !== "url",
-        description: "Enter the full URL of the image. Ensure the image is accessible and meets the recommended size of 1200x630px (minimum 600x315px)."
+        hidden: ({ parent }) => parent?.imageType !== "url"
       })
     ]
   });
@@ -657,7 +752,7 @@ function twitter(config = {}) {
     fields: [
       sanity.defineField({
         name: "card",
-        title: "Card Type",
+        ...getFieldInfo("twitterCard", config.fieldOverrides),
         type: "string",
         options: {
           list: [
@@ -667,46 +762,58 @@ function twitter(config = {}) {
             { title: "Player", value: "player" }
           ]
         },
+        hidden: getFieldHiddenFunction("twitterCard", config),
         initialValue: "summary_large_image"
         // good default
       }),
       sanity.defineField({
         name: "site",
-        title: "Site X Handle",
+        ...getFieldInfo("twitterSite", config.fieldOverrides),
         type: "string",
-        description: "The X (formerly Twitter) handle of the website (e.g., @example)",
         hidden: getFieldHiddenFunction("twitterSite", config)
       }),
       sanity.defineField({
         name: "creator",
-        title: "X Creator Handle",
         type: "string",
-        description: "The X (formerly Twitter) handle of the content creator (e.g., @creator)"
+        ...getFieldInfo("twitterCreator", config.fieldOverrides),
+        hidden: getFieldHiddenFunction("twitterCreator", config)
       }),
       sanity.defineField({
         name: "title",
-        title: "X Title",
         type: "string",
-        description: "The title of the content as it should appear on X (formerly Twitter).",
+        ...getFieldInfo("twitterTitle", config.fieldOverrides),
+        hidden: getFieldHiddenFunction("twitterTitle", config),
         components: {
           input: TwitterTitle
         }
       }),
       sanity.defineField({
         name: "description",
-        title: "X Description",
         type: "text",
         rows: 3,
-        description: "A brief description of the content for X (formerly Twitter).",
+        ...getFieldInfo("twitterDescription", config.fieldOverrides),
+        hidden: getFieldHiddenFunction("twitterDescription", config),
         components: {
           input: TwitterDescription
         }
       }),
+      sanity.defineField({
+        name: "imageType",
+        ...getFieldInfo("twitterImageType", config.fieldOverrides),
+        type: "string",
+        options: {
+          list: [
+            { title: "Upload Image", value: "upload" },
+            { title: "Image URL", value: "url" }
+          ]
+        },
+        hidden: getFieldHiddenFunction("twitterImage", config),
+        initialValue: "upload"
+      }),
       sanity.defineField({
         name: "image",
-        title: "X Image",
+        ...getFieldInfo("twitterImage", config.fieldOverrides),
         type: "image",
-        description: 'An image URL which should be at least 120x120px for "summary" card and 280x150px for "summary_large_image" card.',
         options: {
           hotspot: !0
         },
@@ -715,9 +822,15 @@ function twitter(config = {}) {
             name: "alt",
             title: "Image Alt Text",
             type: "string",
-            description: "Short alt text describing the image"
+            description: "A description of the image for accessibility purposes."
           })
         ]
+      }),
+      sanity.defineField({
+        name: "imageUrl",
+        ...getFieldInfo("twitterImageUrl", config.fieldOverrides),
+        type: "url",
+        hidden: ({ parent }) => parent?.imageType !== "url"
       })
     ]
   });