{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "contact-form-basic",
  "title": "Contact Form Basic",
  "description": "An accessible contact form with name, email, organization, and message fields, inline validation, and confirmed submission feedback.",
  "registryDependencies": [],
  "files": [
    {
      "path": "payload-components/source/blocks/ContactFormBasic/config.ts",
      "content": "import type { Block } from 'payload'\n\nimport { validateSameOriginFormAction } from '@/blocks/shared/safeUrls'\n\nexport const ContactFormBasic: Block = {\n  slug: 'contactFormBasic',\n  // Existing apps must migrate stored data before adopting this identifier:\n  // https://www.payload-components.xyz/docs/registry#installed-source-and-migrations\n  dbName: 'pc_con_for_bas',\n  interfaceName: 'ContactFormBasicBlock',\n  admin: {\n    group: 'Contact',\n  },\n  labels: { singular: 'Contact Form Basic', plural: 'Contact Form Basic Blocks' },\n  fields: [\n    {\n      name: 'title',\n      type: 'text',\n      custom: { payloadComponents: { localization: 'localized' } },\n      required: true,\n      defaultValue: 'Let’s talk.',\n    },\n    {\n      name: 'description',\n      type: 'textarea',\n      custom: { payloadComponents: { localization: 'localized' } },\n    },\n    {\n      name: 'action',\n      type: 'text',\n      custom: { payloadComponents: { localization: 'global' } },\n      required: true,\n      validate: validateSameOriginFormAction,\n      admin: {\n        description:\n          'Your same-origin endpoint, such as /api/contact. Accepts multipart form data and returns JSON { success: true } after accepting the message.',\n      },\n    },\n    {\n      name: 'submitLabel',\n      type: 'text',\n      custom: { payloadComponents: { localization: 'localized' } },\n      defaultValue: 'Send message',\n    },\n    {\n      name: 'successMessage',\n      type: 'textarea',\n      custom: { payloadComponents: { localization: 'localized' } },\n      required: true,\n      defaultValue: 'Thanks for reaching out. Your message has been received.',\n    },\n    {\n      name: 'nameLabel',\n      type: 'text',\n      custom: { payloadComponents: { localization: 'localized' } },\n      defaultValue: 'Name',\n    },\n    {\n      name: 'emailLabel',\n      type: 'text',\n      custom: { payloadComponents: { localization: 'localized' } },\n      defaultValue: 'Email',\n    },\n    {\n      name: 'organizationLabel',\n      type: 'text',\n      custom: { payloadComponents: { localization: 'localized' } },\n      defaultValue: 'Organization',\n    },\n    {\n      name: 'messageLabel',\n      type: 'text',\n      custom: { payloadComponents: { localization: 'localized' } },\n      defaultValue: 'Message',\n    },\n  ],\n}\n",
      "type": "registry:file",
      "target": "~/src/blocks/ContactFormBasic/config.ts"
    },
    {
      "path": "payload-components/source/blocks/ContactFormBasic/Component.tsx",
      "content": "'use client'\n\nimport React, { useId, useRef, useState } from 'react'\n\nimport type { ContactFormBasicBlock as ContactFormBasicBlockData } from '@/payload-types'\n\nimport { getSafeFormAction } from '@/blocks/shared/safeUrls'\nimport { cn } from '@/utilities/ui'\n\nimport { type ContactErrors, type ContactField, sendContactForm, validateContactForm } from './form'\n\ntype Props = ContactFormBasicBlockData & {\n  id?: string\n  className?: string\n  disableInnerContainer?: boolean\n}\n\nexport const ContactFormBasicBlock: React.FC<Props> = (props) => {\n  // A new block or destination starts a new form. Keeping its state and DOM in\n  // a keyed instance prevents an older request from clearing or acknowledging\n  // a replacement form during live preview or another parent update.\n  const identity = JSON.stringify([props.id, getSafeFormAction(props.action)])\n  return <ContactFormInstance {...props} key={identity} />\n}\n\nconst ContactFormInstance: React.FC<Props> = ({\n  action,\n  className,\n  description,\n  disableInnerContainer,\n  emailLabel,\n  id,\n  messageLabel,\n  nameLabel,\n  organizationLabel,\n  submitLabel,\n  successMessage,\n  title,\n}) => {\n  const formId = useId()\n  const submitting = useRef(false)\n  const [pending, setPending] = useState(false)\n  const [errors, setErrors] = useState<ContactErrors>({})\n  const [status, setStatus] = useState<'idle' | 'success' | 'error'>('idle')\n  const formAction = getSafeFormAction(action)\n  const fields: {\n    name: ContactField\n    label: string\n    autoComplete?: string\n    type?: string\n    required?: boolean\n  }[] = [\n    {\n      name: 'name',\n      label: nameLabel || 'Name',\n      autoComplete: 'name',\n      type: 'text',\n      required: true,\n    },\n    {\n      name: 'email',\n      label: emailLabel || 'Email',\n      autoComplete: 'email',\n      type: 'email',\n      required: true,\n    },\n    {\n      name: 'organization',\n      label: organizationLabel || 'Organization',\n      autoComplete: 'organization',\n      type: 'text',\n    },\n    { name: 'message', label: messageLabel || 'Message', required: true },\n  ]\n\n  const submit = async (event: React.FormEvent<HTMLFormElement>) => {\n    event.preventDefault()\n    if (!formAction || submitting.current) return\n    const form = event.currentTarget\n    const data = new FormData(form)\n    const nextErrors = validateContactForm(data)\n    setErrors(nextErrors)\n    setStatus('idle')\n    const firstInvalid = fields.find(({ name }) => nextErrors[name])\n    if (firstInvalid) {\n      const control = form.elements.namedItem(firstInvalid.name)\n      if (control instanceof HTMLElement) control.focus()\n      return\n    }\n    submitting.current = true\n    setPending(true)\n    try {\n      await sendContactForm(formAction, data)\n      form.reset()\n      setStatus('success')\n    } catch {\n      setStatus('error')\n    } finally {\n      submitting.current = false\n      setPending(false)\n    }\n  }\n\n  return (\n    <section className={cn('container', className)} id={id ? `block-${id}` : undefined}>\n      <div className=\"overflow-hidden rounded-frame border border-border/70 bg-card/35 px-6 py-10 sm:px-8 lg:px-12 lg:py-14\">\n        <div\n          className={cn('grid gap-10 lg:grid-cols-2 lg:gap-16', {\n            'mx-auto max-w-5xl': !disableInnerContainer,\n          })}\n        >\n          <div className=\"space-y-5\">\n            <p className=\"text-xs font-medium uppercase tracking-eyebrow text-muted-foreground\">\n              Get in touch\n            </p>\n            <h2 className=\"text-4xl font-medium tracking-display text-balance sm:text-5xl\">\n              {title}\n            </h2>\n            {description ? (\n              <p className=\"max-w-md text-base leading-7 text-muted-foreground\">{description}</p>\n            ) : null}\n            <p className=\"text-sm text-muted-foreground\">Fields marked * are required.</p>\n          </div>\n          <form\n            action={formAction}\n            method=\"post\"\n            encType=\"multipart/form-data\"\n            noValidate\n            onSubmit={submit}\n            aria-busy={pending}\n            aria-describedby={`${formId}-status`}\n            className=\"space-y-5\"\n          >\n            {fields.map(({ name, label, autoComplete, type, required }) => {\n              const controlProps = {\n                id: `${formId}-${name}`,\n                name,\n                autoComplete,\n                required,\n                disabled: !formAction || pending,\n                'aria-invalid': Boolean(errors[name]),\n                'aria-describedby': errors[name] ? `${formId}-${name}-error` : undefined,\n                onChange: () => {\n                  setErrors((current) => ({ ...current, [name]: undefined }))\n                  setStatus('idle')\n                },\n              }\n              return (\n                <div key={name} className=\"space-y-2\">\n                  <label htmlFor={controlProps.id} className=\"block text-sm font-medium\">\n                    {label}\n                    {required ? ' *' : ' (optional)'}\n                  </label>\n                  {name === 'message' ? (\n                    <textarea\n                      {...controlProps}\n                      rows={4}\n                      maxLength={10000}\n                      className=\"w-full resize-y rounded-lg border border-border bg-background px-4 py-3 text-base outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:opacity-60\"\n                    />\n                  ) : (\n                    <input\n                      {...controlProps}\n                      type={type}\n                      inputMode={name === 'email' ? 'email' : undefined}\n                      maxLength={name === 'email' ? 254 : 200}\n                      className=\"h-12 w-full rounded-lg border border-border bg-background px-4 text-base outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:opacity-60\"\n                    />\n                  )}\n                  {errors[name] ? (\n                    <p id={`${formId}-${name}-error`} className=\"text-sm text-destructive\">\n                      {errors[name]}\n                    </p>\n                  ) : null}\n                </div>\n              )\n            })}\n            <button\n              disabled={!formAction || pending}\n              type=\"submit\"\n              className=\"inline-flex min-h-12 w-full items-center justify-center rounded-lg bg-primary px-6 py-3 text-sm font-medium text-primary-foreground outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-not-allowed disabled:opacity-60\"\n            >\n              {pending ? 'Sending…' : submitLabel || 'Send message'}\n            </button>\n            <p\n              id={`${formId}-status`}\n              role=\"status\"\n              aria-live=\"polite\"\n              className=\"text-sm leading-6 text-muted-foreground\"\n            >\n              {!formAction\n                ? 'Contact form unavailable. Please try again later.'\n                : status === 'success'\n                  ? successMessage || 'Thanks for reaching out. Your message has been received.'\n                  : status === 'error'\n                    ? 'We could not confirm delivery. Your message is still here; please try again.'\n                    : ''}\n            </p>\n          </form>\n        </div>\n      </div>\n    </section>\n  )\n}\n",
      "type": "registry:file",
      "target": "~/src/blocks/ContactFormBasic/Component.tsx"
    },
    {
      "path": "payload-components/source/blocks/ContactFormBasic/form.ts",
      "content": "export type ContactField = 'name' | 'email' | 'organization' | 'message'\nexport type ContactErrors = Partial<Record<ContactField, string>>\n\nexport const validateContactForm = (data: FormData): ContactErrors => {\n  const errors: ContactErrors = {}\n  const name = String(data.get('name') ?? '').trim()\n  const email = String(data.get('email') ?? '').trim()\n  const message = String(data.get('message') ?? '').trim()\n  if (!name) errors.name = 'Enter your name.'\n  if (!email || !/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(email))\n    errors.email = 'Enter a valid email address.'\n  if (!message) errors.message = 'Enter a message.'\n  return errors\n}\n\n/** An explicit acknowledgement prevents an HTML redirect or a 200 error page from looking successful. */\nexport const sendContactForm = async (action: string, data: FormData): Promise<void> => {\n  const response = await fetch(action, {\n    method: 'POST',\n    body: data,\n    credentials: 'same-origin',\n    redirect: 'error',\n    headers: { Accept: 'application/json' },\n    signal: AbortSignal.timeout(15_000),\n  })\n  if (!response.ok) throw new Error('The endpoint did not accept the message.')\n  const result: unknown = await response.json()\n  if (!result || typeof result !== 'object' || !('success' in result) || result.success !== true) {\n    throw new Error('The endpoint did not acknowledge the message.')\n  }\n}\n",
      "type": "registry:file",
      "target": "~/src/blocks/ContactFormBasic/form.ts"
    },
    {
      "path": "payload-components/source/blocks/shared/safeUrls.ts",
      "content": "const approvedEmbedHosts = new Set([\n  'airtable.com',\n  'docs.google.com',\n  'form.typeform.com',\n  'lookerstudio.google.com',\n  'maps.google.com',\n  'player.vimeo.com',\n  'vimeo.com',\n  'www.airtable.com',\n  'www.google.com',\n  'www.youtube-nocookie.com',\n  'www.youtube.com',\n  'youtube-nocookie.com',\n  'youtube.com',\n])\n\nconst approvedEmbedHostSuffixes = [\n  '.airtable.com',\n  '.google.com',\n  '.typeform.com',\n  '.vimeo.com',\n  '.youtube-nocookie.com',\n  '.youtube.com',\n]\n\nconst embedUrlError = 'Use an approved HTTPS embed URL.'\nconst formActionError = 'Use a same-origin path, such as /api/newsletter.'\nconst sameOriginBase = 'https://payload-components.local'\n\nconst isApprovedEmbedHost = (hostname: string) => {\n  const normalizedHost = hostname.toLowerCase()\n\n  return (\n    approvedEmbedHosts.has(normalizedHost) ||\n    approvedEmbedHostSuffixes.some((suffix) => normalizedHost.endsWith(suffix))\n  )\n}\n\nexport const getSafeEmbedUrl = (value: unknown) => {\n  if (typeof value !== 'string') return undefined\n\n  const trimmed = value.trim()\n\n  if (!trimmed) return undefined\n\n  try {\n    const parsed = new URL(trimmed)\n\n    if (parsed.protocol !== 'https:' || parsed.username || parsed.password) {\n      return undefined\n    }\n\n    if (!isApprovedEmbedHost(parsed.hostname)) {\n      return undefined\n    }\n\n    return parsed.toString()\n  } catch {\n    return undefined\n  }\n}\n\nexport const validateEmbedUrl = (value: unknown) => getSafeEmbedUrl(value) ? true : embedUrlError\n\nexport const getSafeFormAction = (value: unknown) => {\n  if (typeof value !== 'string') return undefined\n\n  const trimmed = value.trim()\n\n  if (!trimmed || !trimmed.startsWith('/') || trimmed.startsWith('//') || trimmed.includes('\\\\')) {\n    return undefined\n  }\n\n  try {\n    const parsed = new URL(trimmed, sameOriginBase)\n\n    if (parsed.origin !== sameOriginBase) {\n      return undefined\n    }\n\n    return `${parsed.pathname}${parsed.search}${parsed.hash}`\n  } catch {\n    return undefined\n  }\n}\n\nexport const validateSameOriginFormAction = (value: unknown) => {\n  if (value === null || value === undefined || (typeof value === 'string' && value.trim() === '')) {\n    return true\n  }\n\n  return getSafeFormAction(value) ? true : formActionError\n}\n",
      "type": "registry:file",
      "target": "~/src/blocks/shared/safeUrls.ts"
    }
  ],
  "meta": {
    "payloadComponent": {
      "installCommand": "payload-components add contact-form-basic",
      "postInstall": [
        "generate:types",
        "generate:importmap"
      ],
      "requiresPayloadComponentWrapper": true,
      "supportedTargets": [
        "payload-website-starter",
        "payload-blocks-app"
      ]
    }
  },
  "docs": "Payload Components installs this as a Payload CMS block for the Payload website starter shape.\n\nRecommended install:\n\n```bash\npnpm payload-components add contact-form-basic\n```\n\nDirect shadcn install URL:\n\n```bash\npnpm dlx shadcn@latest add https://www.payload-components.xyz/r/contact-form-basic.json\n```\n\nDirect shadcn installs only copy the block source files and shadcn UI dependencies. Use `payload-components add contact-form-basic` when you also want Payload layout registration, `RenderBlocks` wiring, `generate:types`, and `generate:importmap` handled for you.",
  "type": "registry:block"
}