"use client" /** * MergeTagInput — a single-line field (an email subject) whose merge fields draw as badge * chips, matching the ones in RichTextEditor. Value is plain text with `{{key}}` tokens. */ import * as React from "react" import { EditorContent, useEditor } from "@tiptap/react" import Placeholder from "@tiptap/extension-placeholder" import StarterKit from "@tiptap/starter-kit" import { cn } from "../../lib/utils" import { useMergeTagSuggest } from "./merge-tag-suggest" import { MergeTagDetails, chipUnderSelection, type MergeFieldExample, createMergeTagExtension, htmlToTokens, tokensToHtml, type MergeField, } from "./merge-tag" export interface MergeTagInputProps { value: string onChange: (value: string) => void fields: MergeField[] id?: string "aria-label"?: string placeholder?: string disabled?: boolean className?: string /** What a chip becomes for the person being previewed; shown in its details card. */ describeField?: (key: string) => MergeFieldExample | null } const escapeHtml = (text: string) => text.replace(/&/g, "&").replace(//g, ">") const toDoc = (value: string, fields: MergeField[]) => `

${tokensToHtml(escapeHtml(value), fields)}

` export function MergeTagInput({ value, onChange, fields, id, "aria-label": ariaLabel, placeholder, disabled = false, className, describeField, }: MergeTagInputProps) { const [details, setDetails] = React.useState<{ key: string; el: HTMLElement; pos: number } | null>(null) const onChangeRef = React.useRef(onChange) React.useLayoutEffect(() => { onChangeRef.current = onChange }) const mergeTag = React.useMemo(() => createMergeTagExtension(fields), [fields]) const suggest = useMergeTagSuggest(fields) const suggestRef = React.useRef(suggest) React.useLayoutEffect(() => { suggestRef.current = suggest }) const editor = useEditor( { immediatelyRender: false, editable: !disabled, content: toDoc(value, fields), extensions: [ // One line of text and chips: switch off every block and mark. StarterKit.configure({ heading: false, bulletList: false, orderedList: false, listItem: false, blockquote: false, codeBlock: false, code: false, horizontalRule: false, hardBreak: false, bold: false, italic: false, strike: false, underline: false, link: false, }), mergeTag, Placeholder.configure({ placeholder: placeholder ?? "" }), ], editorProps: { attributes: { ...(id ? { id } : {}), role: "textbox", "aria-multiline": "false", ...(ariaLabel ? { "aria-label": ariaLabel } : {}), }, handleKeyDown: (view, event) => { if (suggestRef.current.onKeyDown(event)) return true const chip = chipUnderSelection(view, event) if (chip) { event.preventDefault() setDetails(chip) return true } return event.key === "Enter" }, handleClickOn: (_view, _pos, node, nodePos, event) => { if (node.type.name !== "mergeTag") return false const el = (event.target as HTMLElement).closest("[data-merge-tag]") if (!el) return false setDetails({ key: String(node.attrs.key), el, pos: nodePos }) return true }, // Paste as one line of plain text. handlePaste: (view, event) => { const text = event.clipboardData?.getData("text/plain") if (text == null) return false view.dispatch(view.state.tr.insertText(text.replace(/\s+/g, " "))) return true }, }, onSelectionUpdate({ editor: current }) { suggestRef.current.update(current) }, onBlur() { suggestRef.current.close() }, onUpdate({ editor: current }) { onChangeRef.current(current.getText()) suggestRef.current.update(current) }, }, [mergeTag], ) React.useEffect(() => { suggest.attach(editor) }, [editor, suggest]) React.useEffect(() => { if (!editor) return editor.setEditable(!disabled, false) }, [editor, disabled]) // Adopt outside changes (a template swap) without disturbing the caret while typing. React.useEffect(() => { if (!editor || value === editor.getText()) return editor.commands.setContent(toDoc(value, fields), { emitUpdate: false }) }, [editor, value, fields]) return (
{suggest.popup} {details && editor ? ( f.key === details.key) ?? { key: details.key, label: details.key }} anchor={details.el} example={describeField?.(details.key)} onClose={() => setDetails(null)} onRemove={() => { editor.chain().focus().deleteRange({ from: details.pos, to: details.pos + 1 }).run() setDetails(null) }} /> ) : null}
) }