import React from 'react'; import { Text, createStyleSheet } from '@sendbird/uikit-react-native-foundation'; import type { SendbirdFileMessage, SendbirdUser, SendbirdUserMessage } from '@sendbird/uikit-utils'; import { createMentionTemplateRegex, isEndsWithRTL, replaceWithRegex } from '@sendbird/uikit-utils'; import type { MentionedUser, Range } from '../types'; import type { MentionConfigInterface } from './MentionConfig'; const SPAN_DIRECTION = { LRM: '\u200E', RLM: '\u200F', }; class MentionManager { private _invalidStartsKeywords: string[]; private _templateRegex: RegExp; constructor(public config: MentionConfigInterface) { this._invalidStartsKeywords = [this.config.trigger, this.config.delimiter]; this._templateRegex = createMentionTemplateRegex(this.config.trigger); } // Note: When the input starts in LTR and the mentioned user's name is in RTL, it appears as "Hello @{cibarA}." // If typing continues in RTL, the mention is rendered as: "Hello @{txeTlanoitiddA}{cibarA}." // // Conversely, if the input starts in RTL and the mentioned user's name is in LTR, it appears as "{Eng}@ cibarA." // If typing continues, it is rendered as: "{Eng}{AdditionalText}@ cibarA." // // While this follows the natural text direction, it can make mentions harder to distinguish. // To address this, we use the RLM or LRM Unicode characters to reset subsequent spans based on the last text string of the user's name. // By applying this trick, the result will be displayed as "Hello @{cibarA} {txeTlanoitiddA}" or "{AdditionalText} {Eng}@ cibarA," ensuring the mention block remains clearly distinguishable. getDirectionOfNextSpan = (name: string) => { return isEndsWithRTL(name) ? SPAN_DIRECTION.LRM : SPAN_DIRECTION.RLM; }; public rangeHelpers = { inRangeUnderOver(start: number, num: number, end: number) { return start < num && num < end; }, inRangeUnderMore(start: number, num: number, end: number) { return start < num && num <= end; }, inRangeLessOver(start: number, num: number, end: number) { return start <= num && num < end; }, inRangeLessMore(start: number, num: number, end: number) { return start <= num && num <= end; }, overlaps(a: Range, b: Range, compare: 'underOver' | 'underMore' | 'lessOver' | 'lessMore' = 'underOver') { const inRange = { underOver: this.inRangeUnderOver, underMore: this.inRangeUnderMore, lessOver: this.inRangeLessOver, lessMore: this.inRangeLessMore, }[compare]; return inRange(a.start, b.start, a.end) || inRange(a.start, b.end, a.end); }, }; public get templateRegex() { return this._templateRegex; } public getSearchString = (text: string, selectionIndex: number) => { const lastSpan = text.slice(0, selectionIndex).split(this.config.delimiter).pop() ?? ''; const triggerIdx = lastSpan.indexOf(this.config.trigger); const mentionSpan = triggerIdx === -1 ? lastSpan : lastSpan.slice(triggerIdx); const searchString = mentionSpan.slice(this.config.trigger.length); return { searchString, isTriggered: () => mentionSpan.startsWith(this.config.trigger), isValidSearchString: () => this._invalidStartsKeywords.every((it) => !searchString.startsWith(it)), }; }; /** * @description Reconcile the range by offset in the mentioned users * */ public reconcileRangeOfMentionedUsers = (offset: number, selectionIndex: number, mentionedUsers: MentionedUser[]) => { return mentionedUsers.map((it) => { // Changes only on the right text of selection. if (selectionIndex <= it.range.start) { return { ...it, range: { start: it.range.start + offset, end: it.range.end + offset, }, }; } return it; }); }; /** * @description Remove users who in a range * */ public removeMentionedUsersInSelection = (selection: Range, mentionedUsers: MentionedUser[]) => { let lastSelection = 0; let removedOffset = 0; const filtered = mentionedUsers.filter((it) => { const shouldRemove = this.rangeHelpers.overlaps(selection, it.range, 'lessMore'); if (shouldRemove) { lastSelection = Math.max(lastSelection, it.range.end); removedOffset -= it.range.end - it.range.start; } return !shouldRemove; }); return { filtered, lastSelection, removedOffset }; }; public getSearchStringRangeInText = (selectionIndex: number, searchString: string): Range => { return { start: selectionIndex - searchString.length - this.config.trigger.length, end: selectionIndex, }; }; /** * @description User to @{user.id} template format * */ public asMentionedMessageTemplate = (user: SendbirdUser, delimiter = false) => { const prefix = ''; // Do not append anything to here in order to maintain backward compatibility. const content = `${this.config.trigger}{${user.userId}}`; const postfix = delimiter ? this.config.delimiter : ''; return prefix + content + postfix; }; /** * @description User to @user.nickname text format * */ public asMentionedMessageText = (user: SendbirdUser, delimiter = false) => { const prefix = ''; const content = `${this.config.trigger}${user.nickname}`; const postfix = this.getDirectionOfNextSpan(user.nickname) + (delimiter ? this.config.delimiter : ''); return prefix + content + postfix; }; /** * @description Bold @user.nickname * */ public textToMentionedComponents = (text: string, mentionedUsers: MentionedUser[], mentionEnabled: boolean) => { if (!mentionEnabled || mentionedUsers.length === 0) return text; const { leftText, components } = mentionedUsers .sort((a, b) => b.range.start - a.range.start) .reduce( ({ leftText, components }, curr, currentIndex) => { const leftSpan = leftText.slice(0, curr.range.start); const mentionSpan = leftText.slice(curr.range.start, curr.range.end); const rightSpan = leftText.slice(curr.range.end); return { leftText: leftSpan, components: [ {mentionSpan} , rightSpan, ...components, ], }; }, { leftText: text, components: [] as (string | React.ReactNode)[] }, ); return [leftText, ...components]; }; public textToMentionedMessageTemplate = (text: string, mentionedUsers: MentionedUser[], mentionEnabled: boolean) => { if (!mentionEnabled) return text; const { leftText, strings } = mentionedUsers .sort((a, b) => b.range.start - a.range.start) .reduce( ({ leftText, strings }, curr) => { const leftSpan = leftText.slice(0, curr.range.start); const templateSpan = this.asMentionedMessageTemplate(curr.user); const rightSpan = leftText.slice(curr.range.end); return { leftText: leftSpan, strings: [templateSpan, rightSpan, ...strings], }; }, { leftText: text, strings: [] as string[] }, ); return [leftText, ...strings].join(''); }; /** * @description Convert @{user.id} template to @user.nickname text and MentionedUser[] array. * */ public templateToTextAndMentionedUsers = (template: string, mentionedUsers: SendbirdUser[]) => { const actualMentionedUsers: MentionedUser[] = []; let offsetToMove = 0; const mentionedText = replaceWithRegex( template, this.templateRegex, ({ match, matchIndex, groups }) => { const user = mentionedUsers.find((it) => it.userId === groups[2]); if (user && typeof matchIndex === 'number') { const userIdSpan = match; const userNicknameSpan = this.asMentionedMessageText(user); const offsetAfterConverted = userNicknameSpan.length - userIdSpan.length; const originalRange: Range = { start: matchIndex, end: matchIndex + userIdSpan.length, }; const convertedRange: Range = { start: Math.max(0, originalRange.start + offsetToMove), end: originalRange.end + offsetToMove + offsetAfterConverted, }; offsetToMove += offsetAfterConverted; actualMentionedUsers.push({ range: convertedRange, user }); return userNicknameSpan; } return match; }, '', ).join(''); return { mentionedText, mentionedUsers: actualMentionedUsers, }; }; public shouldUseMentionedMessageTemplate = ( message?: SendbirdUserMessage | SendbirdFileMessage, mentionEnabled?: boolean, ): boolean => { return Boolean( mentionEnabled && message && 'mentionedMessageTemplate' in message && message.mentionedMessageTemplate && message.mentionedUsers && message.mentionedUsers.length > 0, ); }; } const styles = createStyleSheet({ mentionedText: { fontWeight: '700' }, }); export default MentionManager;