import { usePage } from '@inertiajs/react'; import type { ComponentProps, KeyboardEvent, Ref, SyntheticEvent } from 'react'; import { useEffect, useId, useRef, useState } from 'react'; import { createPortal } from 'react-dom'; import { index as issueSuggestions } from '@/actions/App/Http/Controllers/IssueSuggestionController'; import MentionSuggestionController from '@/actions/App/Http/Controllers/MentionSuggestionController'; import { GuildIcon } from '@/components/guild-icon'; import { OrganizationAvatar } from '@/components/organization-avatar'; import { Spinner } from '@/components/ui/spinner'; import { UserAvatar } from '@/components/user-avatar'; import { typedProse } from '@/lib/code'; import type { EmojiSuggestion } from '@/lib/emoji'; import { emojifyInput, searchEmoji } from '@/lib/emoji'; import { issueReferenceBeforeCaret } from '@/lib/issue-reference'; import { suggestionPosition } from '@/lib/suggestion-position'; import { toastWhenThrottled } from '@/lib/throttle'; import { characterCount, cn, laneColor, limitCharacters } from '@/lib/utils'; import type { Organization, OrgMember, User } from '@/types'; type Trigger = { kind: 'mention' | 'emoji' | 'issue' | 'guild'; start: number; query: string; }; type IssueSuggestion = { number: number; title: string; url: string; }; type MentionResults = { users: User[]; organizations: Organization[]; }; type Suggestions = MentionResults & { key: string }; type Position = ReturnType; const debounce = 120; const cache = new Map(); export function clearMentionSuggestionsCache(): void { cache.clear(); } // The "@handle" being typed right before the caret. Keep the rules in sync with app/Services/Mentions.php. const mentionBeforeCaretPattern = /(?:^|[^\p{L}\p{N}_./@-])@([A-Za-z0-9][A-Za-z0-9-]{0,38}|)$/u; // The ":shortcode" being typed in prose right before the caret, from two characters on so times like 10:30 stay quiet. const emojiBeforeCaretPattern = /(?:^|[^\p{L}\p{N}_:])(:([A-Za-z0-9_+-]{2,}))$/u; // Every style that changes where text wraps, so the mirror below wraps exactly like the textarea. const mirroredProperties = [ 'box-sizing', 'width', 'border-top-width', 'border-right-width', 'border-bottom-width', 'border-left-width', 'padding-top', 'padding-right', 'padding-bottom', 'padding-left', 'font-family', 'font-size', 'font-weight', 'font-style', 'font-stretch', 'font-feature-settings', 'font-variant', 'line-height', 'letter-spacing', 'word-spacing', 'text-transform', 'text-indent', 'tab-size', ]; function triggerAt( textarea: HTMLTextAreaElement, suggestsMentions: boolean, suggestsIssues: boolean, suggestsGuilds: boolean, ): Trigger | null { if (textarea.selectionStart !== textarea.selectionEnd) { return null; } const caret = textarea.selectionStart; const before = textarea.value.slice(0, caret); const mention = suggestsMentions ? before.match(mentionBeforeCaretPattern) : null; if (mention) { return { kind: 'mention', start: caret - mention[1].length - 1, query: mention[1], }; } const emoji = (typedProse(before).at(-1) ?? '').match( emojiBeforeCaretPattern, ); if (emoji) { return { kind: 'emoji', start: caret - emoji[1].length, query: emoji[2], }; } const issue = suggestsIssues ? issueReferenceBeforeCaret(textarea.value, caret) : null; if (issue) return { kind: 'issue', ...issue }; const guild = suggestsGuilds ? (typedProse(before).at(-1) ?? '').match( /(?:^|[\s([{])#(\p{L}[\p{L}\p{M}\p{N}_]*|)$/u, ) : null; return guild && !/^[\p{L}\p{M}\p{N}_/#-]/u.test(textarea.value.slice(caret)) ? { kind: 'guild', start: caret - guild[1].length - 1, query: guild[1] } : null; } /** * Where a character of the textarea is drawn, measured on a hidden copy of it that wraps the same way. */ function characterRect(textarea: HTMLTextAreaElement, index: number) { const style = window.getComputedStyle(textarea); const mirror = document.createElement('div'); const marker = document.createElement('span'); mirroredProperties.forEach((property) => mirror.style.setProperty(property, style.getPropertyValue(property)), ); mirror.style.position = 'absolute'; mirror.style.visibility = 'hidden'; mirror.style.top = '0'; mirror.style.left = '-9999px'; mirror.style.whiteSpace = 'pre-wrap'; mirror.style.overflowWrap = 'break-word'; mirror.textContent = textarea.value.slice(0, index); marker.textContent = textarea.value.slice(index) || '.'; mirror.appendChild(marker); document.body.appendChild(mirror); const rect = textarea.getBoundingClientRect(); const lineHeight = Number.parseFloat(style.lineHeight) || Number.parseFloat(style.fontSize) * 1.4; const top = rect.top + marker.offsetTop - textarea.scrollTop; const left = rect.left + marker.offsetLeft - textarea.scrollLeft; mirror.remove(); return { top, left, bottom: top + lineHeight }; } function positionFor(textarea: HTMLTextAreaElement, index: number): Position { const character = characterRect(textarea, index); const viewport = window.visualViewport; return suggestionPosition( character, { left: viewport?.offsetLeft ?? 0, top: viewport?.offsetTop ?? 0, width: viewport?.width ?? window.innerWidth, height: viewport?.height ?? window.innerHeight, }, window.innerHeight, ); } async function fetchSuggestions( query: string, org: string | undefined, reply: string | undefined, quote: string | undefined, signal: AbortSignal, ): Promise { const response = await fetch( MentionSuggestionController.index({ query: { q: query, org, reply, quote }, }).url, { headers: { Accept: 'application/json', 'X-Requested-With': 'XMLHttpRequest', }, signal, }, ); if (!response.ok) { toastWhenThrottled(response); throw new Error('Unable to load suggestions'); } const data = (await response.json()) as MentionResults; // Replies need fresh participants when someone joins the thread. if (!reply) { cache.set( `${org ?? ''}:${reply ?? ''}:${quote ?? ''}:${query.toLowerCase()}`, data, ); } return data; } /** * Where the query matches the text, preferring the start of a word, so ":art" marks "arts" in "martial_arts". */ function matchIndex(text: string, query: string): number { const lower = text.toLowerCase(); const first = query === '' ? -1 : lower.indexOf(query); for (let at = first; at !== -1; at = lower.indexOf(query, at + 1)) { if (at === 0 || /[^\p{L}\p{N}]/u.test(lower[at - 1])) { return at; } } return first; } function Highlighted({ text, query }: { text: string; query: string }) { const index = matchIndex(text, query); if (index === -1) { return text; } return ( <> {text.slice(0, index)} {text.slice(index, index + query.length)} {text.slice(index + query.length)} ); } /** * A textarea that suggests developers to mention as soon as "@" is typed, right under the "@", unless it doesn't * suggest mentions, suggests emoji for the ":shortcode" being typed, and turns emoji shortcodes into emoji as they * are typed. Within an org, it only suggests the org's members. */ export function MentionTextarea({ ref, value, onValueChange, onKeyDown, onSelect, onBlur, maxLength, suggestsMentions = true, suggestsIssues = suggestsMentions, org, members, reply, quote, ...props }: Omit, 'value' | 'onChange'> & { ref?: Ref; value: string; onValueChange: (value: string) => void; suggestsMentions?: boolean; suggestsIssues?: boolean; org?: string; members?: OrgMember[]; reply?: string; quote?: string; }) { const { repository, guilds } = usePage().props; const id = useId(); const textareaRef = useRef(null); const listRef = useRef(null); const dismissedIssue = useRef(null); const [trigger, setTrigger] = useState(null); const [position, setPosition] = useState(null); const [results, setResults] = useState(null); const [activeIndex, setActiveIndex] = useState(0); const [issueResult, setIssueResult] = useState( null, ); const issueQuery = trigger?.kind === 'issue' ? trigger.query : null; const issue = issueQuery === String(issueResult?.number) ? issueResult : null; const query = trigger?.kind === 'mention' ? trigger.query.toLowerCase() : null; const key = query === null ? null : `${org ?? ''}:${reply ?? ''}:${quote ?? ''}:${query}`; const setRefs = (element: HTMLTextAreaElement | null) => { textareaRef.current = element; if (typeof ref === 'function') { ref(element); } else if (ref) { ref.current = element; } }; const close = () => { setTrigger(null); setPosition(null); }; const track = (textarea: HTMLTextAreaElement) => { const next = triggerAt( textarea, suggestsMentions, suggestsIssues, suggestsIssues && !!guilds?.length, ); if ( next?.kind === 'issue' && dismissedIssue.current === `${next.start}:${next.query}` ) { close(); return; } dismissedIssue.current = null; if (!next) { close(); return; } if ( next.kind !== trigger?.kind || next.start !== trigger.start || next.query !== trigger.query ) { setActiveIndex(0); } setTrigger(next); setPosition(positionFor(textarea, next.start)); }; useEffect(() => { if ( members !== undefined || query === null || key === null || cache.has(key) ) { return; } const controller = new AbortController(); const timeout = setTimeout( () => fetchSuggestions(query, org, reply, quote, controller.signal) .then((data) => setResults({ key, ...data })) .catch(() => undefined), query === '' ? 0 : debounce, ); return () => { clearTimeout(timeout); controller.abort(); }; }, [key, query, org, reply, quote, members]); useEffect(() => { if (issueQuery === null) { return; } const controller = new AbortController(); const timeout = setTimeout(() => { void fetch(issueSuggestions.url({ query: { q: issueQuery } }), { headers: { Accept: 'application/json' }, signal: controller.signal, }) .then(async (response) => { if (!response.ok) { return; } const data = (await response.json()) as { issue: IssueSuggestion | null; }; if (!controller.signal.aborted) { setIssueResult(data.issue); } }) .catch(() => undefined); }, debounce); return () => { clearTimeout(timeout); controller.abort(); }; }, [issueQuery]); useEffect(() => { if (!trigger) { return; } const reposition = () => { if (textareaRef.current) { setPosition(positionFor(textareaRef.current, trigger.start)); } }; window.addEventListener('scroll', reposition, { capture: true, passive: true, }); window.addEventListener('resize', reposition); const viewport = window.visualViewport; viewport?.addEventListener('resize', reposition); viewport?.addEventListener('scroll', reposition); return () => { window.removeEventListener('scroll', reposition, { capture: true, }); window.removeEventListener('resize', reposition); viewport?.removeEventListener('resize', reposition); viewport?.removeEventListener('scroll', reposition); }; }, [trigger]); useEffect(() => { listRef.current ?.querySelector('[aria-selected="true"]') ?.scrollIntoView({ block: 'nearest' }); }, [activeIndex, members]); const cached = key === null ? undefined : cache.get(key); const local = members === undefined || query === null ? null : members .filter((member) => member.suggests_mentions) .filter( ({ user }) => user.handle.toLowerCase().includes(query) || user.name.toLowerCase().includes(query), ) .map((member) => ({ ...member, tier: member.user.handle.toLowerCase() === query ? 0 : member.user.handle .toLowerCase() .startsWith(query) ? 1 : member.user.name .toLowerCase() .startsWith(query) ? 2 : 3, })) .sort( (a, b) => a.tier - b.tier || Number(b.is_followed) - Number(a.is_followed) || (a.user.handle < b.user.handle ? -1 : 1), ) .slice(0, 6) .map(({ user }) => user); const current = local !== null && key !== null ? { key, users: local, organizations: [] } : key !== null && cached ? { key, ...cached } : results; const suggestions = key !== null && current?.key === key ? current.users : []; const organizations = key !== null && current?.key === key ? current.organizations : []; const emojiQuery = trigger?.kind === 'emoji' ? trigger.query.toLowerCase() : ''; const emojis = emojiQuery === '' ? [] : searchEmoji(emojiQuery); const guildQuery = trigger?.kind === 'guild' ? trigger.query.toLowerCase() : ''; const matchingGuilds = trigger?.kind === 'guild' ? (guilds ?? []) .filter( (guild) => guild.handle.includes(guildQuery) || guild.name.toLowerCase().includes(guildQuery), ) .toSorted( (a, b) => Number(b.handle.startsWith(guildQuery)) - Number(a.handle.startsWith(guildQuery)), ) .slice(0, 6) : []; const optionCount = trigger?.kind === 'guild' ? matchingGuilds.length : trigger?.kind === 'issue' ? issue ? 1 : 0 : trigger?.kind === 'emoji' ? emojis.length : suggestions.length + organizations.length; const selectedIndex = Math.min(activeIndex, Math.max(0, optionCount - 1)); const isOpen = trigger !== null && position !== null && (trigger.kind === 'guild' ? matchingGuilds.length > 0 : trigger.kind === 'issue' ? issue !== null : trigger.kind === 'emoji' ? emojis.length > 0 : suggestions.length + organizations.length > 0 || query !== ''); const insert = (text: string, separator: string) => { const textarea = textareaRef.current; if (!textarea || !trigger) { return; } const caret = trigger.start + 1 + trigger.query.length; if ( trigger.kind === 'issue' && value.slice(trigger.start, caret) !== `#${trigger.query}` ) { close(); return; } const after = value.slice(caret); const spacing = /^\s/u.test(after) ? '' : separator; let next = `${value.slice(0, trigger.start)}${text}${spacing}${after}`; if (maxLength !== undefined && characterCount(next) > maxLength) { next = `${value.slice(0, trigger.start)}${text}${after}`; } if (maxLength !== undefined && characterCount(next) > maxLength) { close(); return; } const nextCaret = trigger.kind === 'issue' ? textarea.selectionStart + next.length - value.length : trigger.start + text.length + separator.length; onValueChange(next); close(); requestAnimationFrame(() => { textarea.focus(); textarea.setSelectionRange( Math.min(nextCaret, next.length), Math.min(nextCaret, next.length), ); }); }; const select = (account: User | Organization) => insert(`@${account.handle}`, ' '); const selectEmoji = (emoji: EmojiSuggestion) => insert(emoji.emoji, ''); const handleKeyDown = (event: KeyboardEvent) => { if (isOpen && !event.nativeEvent.isComposing) { const hasModifier = event.metaKey || event.ctrlKey || event.altKey; if ( (event.key === 'ArrowDown' || event.key === 'ArrowUp') && optionCount > 0 ) { event.preventDefault(); const step = event.key === 'ArrowDown' ? 1 : -1; setActiveIndex( (selectedIndex + step + optionCount) % optionCount, ); return; } if ( (event.key === 'Enter' || event.key === 'Tab') && !hasModifier && !event.shiftKey && selectedIndex < optionCount ) { event.preventDefault(); if (trigger?.kind === 'issue' && issue) { insert(issue.url, ' '); } else if (trigger?.kind === 'guild') { insert(`#${matchingGuilds[selectedIndex].handle}`, ' '); } else if (trigger?.kind === 'emoji') { selectEmoji(emojis[selectedIndex]); } else { select( selectedIndex < suggestions.length ? suggestions[selectedIndex] : organizations[selectedIndex - suggestions.length], ); } return; } if (event.key === 'Escape') { event.preventDefault(); event.stopPropagation(); if (trigger?.kind === 'issue') { dismissedIssue.current = `${trigger.start}:${trigger.query}`; } close(); return; } } onKeyDown?.(event); }; const activeId = !isOpen ? undefined : trigger?.kind === 'guild' ? `${id}-guild-${matchingGuilds[selectedIndex].id}` : trigger?.kind === 'issue' ? `${id}-issue-${issue?.number}` : trigger?.kind === 'emoji' ? emojis[selectedIndex] && `${id}-emoji-${emojis[selectedIndex].name}` : selectedIndex < suggestions.length ? `${id}-mention-${suggestions[selectedIndex].id}` : organizations[selectedIndex - suggestions.length] && `${id}-mention-${organizations[selectedIndex - suggestions.length].handle}`; const isSearching = current?.key !== key; const listId = trigger?.kind === 'guild' ? `${id}-guilds` : trigger?.kind === 'issue' ? `${id}-issues` : trigger?.kind === 'emoji' ? `${id}-emojis` : `${id}-mentions`; return ( <>