ai/mention.tsx
GitHubimport {mergeProps} from '@base-ui/react/merge-props';
import {useRender} from '@base-ui/react/use-render';
import {cva} from 'class-variance-authority';
import {Icon, Close} from '../icon';
import {cn} from '../lib/utils';
type MentionType = 'agent' | 'run' | 'deploy' | 'key' | 'model' | 'file' | 'folder' | 'doc' | 'table' | 'web' | 'command' | 'paste';
type MentionRef = {id: string; type: MentionType; label: string};
const mentionTypeLabels: Record<MentionType, string> = {
agent: 'Agent', run: 'Run', deploy: 'Deployment', key: 'Key', model: 'Model',
file: 'File', folder: 'Folder', doc: 'Doc', table: 'Table', web: 'Web page', command: 'Command', paste: 'Pasted text',
};
const mentionTypes = new Set(Object.keys(mentionTypeLabels));
const loneSurrogate = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/g;
const encodeMentionId = (id: string) => encodeURIComponent(id.replace(loneSurrogate, '�')).replace(/[()]/g, c => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
const labelEscapes: Record<string, string> = {'\\': '\\\\', '[': '\\[', ']': '\\]', '\n': '\\n', '\r': '\\r'};
const labelUnescapes: Record<string, string> = {n: '\n', r: '\r'};
function mentionToText({type, id, label}: MentionRef) {
return `[${label.replace(/[\\[\]\n\r]/g, m => labelEscapes[m])}](${type}:${encodeMentionId(id)})`;
}
const tokenPattern = /[@/]?\[((?:\\.|[^\]\\\n])*)\]\(([a-z]+):([^)\s]*)\)/g;
type MentionToken = {kind: 'text'; text: string} | {kind: 'mention'; mention: MentionRef};
function parseMentions(source: string): MentionToken[] {
const tokens: MentionToken[] = [];
let last = 0;
for (const match of source.matchAll(tokenPattern)) {
const [whole, rawLabel, type, rawId] = match;
if (!mentionTypes.has(type)) continue;
let id = rawId;
try { id = decodeURIComponent(rawId); } catch {}
if (match.index > last) tokens.push({kind: 'text', text: source.slice(last, match.index)});
tokens.push({kind: 'mention', mention: {type: type as MentionType, id, label: rawLabel.replace(/\\(.)/g, (_, c: string) => labelUnescapes[c] ?? c)}});
last = match.index + whole.length;
}
if (last < source.length) tokens.push({kind: 'text', text: source.slice(last)});
return tokens;
}
function uniqueLabel(next: MentionRef, taken: MentionRef[]) {
const same = taken.find(m => m.type === next.type && m.id === next.id);
if (same) return same.label;
const labels = new Set(taken.map(m => m.label));
if (!labels.has(next.label)) return next.label;
let n = 2;
while (labels.has(`${next.label} (${n})`)) n += 1;
return `${next.label} (${n})`;
}
const mentionVariants = cva(
[
'group/mention inline-flex h-5 max-w-full min-w-0 items-center gap-1 rounded-tag border border-line-control bg-paper px-1.5 align-bottom whitespace-nowrap',
'type-label text-text-1 no-underline select-none',
'transition-[background-color,border-color] duration-(--dur-state) ease-out',
'[a]:hover:bg-hover [button]:hover:bg-hover [a,button]:cursor-pointer',
'aria-disabled:text-text-disabled data-missing:border-line-faint data-missing:text-text-2 data-missing:line-through data-missing:decoration-1',
'forced-colors:border-[CanvasText]',
'[&_svg]:pointer-events-none [&_svg]:shrink-0',
],
{
variants: {removable: {true: 'pe-0', false: ''}},
defaultVariants: {removable: false},
},
);
type MentionProps = useRender.ComponentProps<'span'> & {
type: MentionType;
children: React.ReactNode;
missing?: boolean;
onRemove?: () => void;
removeLabel?: string;
missingLabel?: string;
};
function Mention({type, missing, onRemove, removeLabel, missingLabel = ' (no longer exists)', render, className, children, ...props}: MentionProps) {
const text = typeof children === 'string' ? children : undefined;
const label = <>
<span data-slot="mention-label" className="min-w-0 truncate" title={text && text.length > 24 ? text : undefined}>{type === 'command' ? '/' : ''}{children}</span>
{missing && <span className="sr-only">{missingLabel}</span>}
{onRemove && <button
type="button"
data-slot="mention-remove"
aria-label={removeLabel ?? `Remove ${text ?? mentionTypeLabels[type]}`}
onClick={event => {
const list = event.currentTarget.closest('ul, ol, [role="list"], [role="group"]') ?? event.currentTarget.parentElement?.parentElement;
const all = list ? [...list.querySelectorAll<HTMLElement>('[data-slot="mention-remove"]')] : [];
const at = all.indexOf(event.currentTarget);
const next = all[at + 1] ?? all[at - 1];
onRemove();
requestAnimationFrame(() => {
const active = document.activeElement;
if (next?.isConnected && (!active || active === document.body || !active.isConnected)) next.focus();
});
}}
className="relative inline-flex size-4.5 shrink-0 items-center justify-center rounded-tag text-text-2 transition-colors duration-(--dur-state) ease-out after:absolute after:-inset-1 hover:bg-hover hover:text-text-1 focus-visible:focus-ring-inset"
><Icon icon={Close} size={12}/></button>}
</>;
return useRender({
defaultTagName: 'span',
props: mergeProps<'span'>(
{className: cn(mentionVariants({removable: !!onRemove}), className), children: label},
{'data-slot': 'mention', 'data-type': type, 'data-missing': missing || undefined} as React.ComponentProps<'span'>,
props,
),
render,
state: {slot: 'mention', type},
});
}
export {
Mention, mentionVariants, mentionTypeLabels, mentionToText, encodeMentionId, parseMentions, uniqueLabel,
type MentionType, type MentionProps, type MentionRef, type MentionToken,
};