⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.
TypeScript agenticagileai-agentsbug-reportingbug-trackerganttissue-trackerjirajira-alternativekanbanlinearlinear-alternativeopen-sourceproduct-managementproject-managementroadmapself-hostedsprint-planningteam-collaborationtrello-alternative
import { useCallback, useEffect, useRef, useState } from 'react';
import type { Editor } from '@tiptap/react';
import { previewableLink } from './previewableLink';
export function useEditorLinkPreview(editor: Editor, disabled = false) {
const [anchor, setAnchor] = useState<HTMLAnchorElement | null>(null);
const [candidateAnchor, setCandidateAnchor] = useState<HTMLAnchorElement | null>(null);
const [open, setOpen] = useState(false);
const anchorRef = useRef<HTMLAnchorElement | null>(null);
const visibleRef = useRef(false);
const openTimer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
const closeTimer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
const clearTimer = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);
const keepOpen = useCallback(() => {
clearTimeout(closeTimer.current);
clearTimeout(clearTimer.current);
}, []);
const close = useCallback(() => {
if (!anchorRef.current) return;
clearTimeout(openTimer.current);
openTimer.current = undefined;
clearTimeout(closeTimer.current);
clearTimeout(clearTimer.current);
visibleRef.current = false;
setOpen(false);
clearTimer.current = setTimeout(() => {
anchorRef.current = null;
setAnchor(null);
setCandidateAnchor(null);
}, 160);
}, []);
const leave = useCallback(() => {
clearTimeout(openTimer.current);
openTimer.current = undefined;
clearTimeout(closeTimer.current);
closeTimer.current = setTimeout(close, 120);
}, [close]);
useEffect(() => {
if (disabled) {
close();
return;
}
const root = editor.view.dom;
let touchFocus = false;
const pointerDown = (event: PointerEvent) => {
touchFocus = event.pointerType === 'touch' || event.pointerType === 'pen';
};
const keyDown = () => {
touchFocus = false;
};
const enter = (event: Event) => {
if (event instanceof PointerEvent && event.pointerType === 'touch') return;
if (event.type === 'focusin' && touchFocus) return;
const link = previewableLink(event.target, root);
if (!link) return;
keepOpen();
if (anchorRef.current === link && (visibleRef.current || openTimer.current)) return;
clearTimeout(openTimer.current);
anchorRef.current = link;
setCandidateAnchor(link);
visibleRef.current = false;
setOpen(false);
openTimer.current = setTimeout(() => {
openTimer.current = undefined;
setAnchor(link);
visibleRef.current = true;
setOpen(true);
}, 650);
};
const exit = (event: MouseEvent | FocusEvent) => {
if (anchorRef.current?.contains(event.relatedTarget as Node | null)) return;
leave();
};
const escape = (event: KeyboardEvent) => {
if (event.key !== 'Escape' || !anchorRef.current) return;
if (visibleRef.current) {
event.preventDefault();
event.stopPropagation();
}
close();
};
root.addEventListener('pointerover', enter);
root.addEventListener('pointerdown', pointerDown, true);
root.addEventListener('keydown', keyDown, true);
root.addEventListener('pointerout', exit);
root.addEventListener('focusin', enter);
root.addEventListener('focusout', exit);
document.addEventListener('keydown', escape, true);
window.addEventListener('scroll', close, true);
return () => {
root.removeEventListener('pointerover', enter);
root.removeEventListener('pointerdown', pointerDown, true);
root.removeEventListener('keydown', keyDown, true);
root.removeEventListener('pointerout', exit);
root.removeEventListener('focusin', enter);
root.removeEventListener('focusout', exit);
document.removeEventListener('keydown', escape, true);
window.removeEventListener('scroll', close, true);
clearTimeout(openTimer.current);
clearTimeout(closeTimer.current);
clearTimeout(clearTimer.current);
};
}, [editor, close, leave, keepOpen, disabled]);
return {
anchor: disabled ? null : anchor,
candidateAnchor: disabled ? null : candidateAnchor,
open: !disabled && open,
keepOpen,
leave,
close,
};
}