import { CloseIcon } from "@chopin/icons"; import { createContext, useCallback, useContext, useEffect, useId, useLayoutEffect, useRef, useState, } from "react"; import { createPortal } from "react-dom"; import { evidencePoint } from "../evidence-geometry"; import { planScroller } from "../scroll"; import { useTransitionPresence } from "../transition-presence"; import type { CSSProperties, ReactNode } from "react"; /** What a host knows about a card's evidence: a one-line summary and the full listing. */ export type DecisionEvidence = { summary: ReactNode; content: ReactNode }; type Position = { top: number; left: number; side: "right" | "left" }; type EvidenceControl = { active: boolean; summary: ReactNode; open: boolean; id: string; trigger: React.RefObject; toggle: () => void; }; let EvidenceContext = createContext(null); export function useEvidenceAvailable(): boolean { return !!useContext(EvidenceContext)?.active; } /** The card's evidence summary, which is also the only way to open the listing. */ export function EvidenceTrigger() { let evidence = useContext(EvidenceContext); if (!evidence?.active) return null; return ( ); } /** Evidence remains card-local, but opens only through its summary control. */ export function EvidenceHover({ active, children, evidence, question }: { active: boolean; children: ReactNode; evidence: DecisionEvidence | null; question: string; }) { let content = evidence?.content ?? null; let [open, setOpen] = useState(false); let [position, setPosition] = useState(); let card = useRef(null); let panel = useRef(null); let trigger = useRef(null); let focusPending = useRef(false); let id = useId(); let visible = active && !!content && open; // The listing that is fading out keeps what it showed when it was dismissed. let presence = useTransitionPresence(visible ? content : undefined, 150, false); let dismiss = useCallback((returnFocus = false) => { focusPending.current = false; setOpen(false); if (returnFocus) trigger.current?.focus({ preventScroll: true }); }, []); useEffect(() => { if (!active || !content) dismiss(); }, [active, content, dismiss]); useLayoutEffect(() => { if (!visible || !position || !focusPending.current) return; focusPending.current = false; panel.current?.querySelector("button:not(:disabled)")?.focus(); }, [visible, position]); useEffect(() => { if (!visible) return; let onKey = (event: KeyboardEvent) => { if (event.key !== "Escape") return; event.preventDefault(); event.stopPropagation(); dismiss(true); }; let onPointerDown = (event: PointerEvent) => { let target = event.target; if (!(target instanceof Node)) return; if (!trigger.current?.contains(target) && !panel.current?.contains(target)) dismiss(); }; let onFocus = (event: FocusEvent) => { let target = event.target; if (!(target instanceof Node)) return; if (!trigger.current?.contains(target) && !panel.current?.contains(target)) dismiss(); }; let onHidden = () => { if (document.hidden) dismiss(); }; document.addEventListener("keydown", onKey, true); document.addEventListener("pointerdown", onPointerDown, true); document.addEventListener("focusin", onFocus); document.addEventListener("visibilitychange", onHidden); return () => { document.removeEventListener("keydown", onKey, true); document.removeEventListener("pointerdown", onPointerDown, true); document.removeEventListener("focusin", onFocus); document.removeEventListener("visibilitychange", onHidden); }; }, [visible, dismiss]); useLayoutEffect(() => { if (!visible) return; let anchor = card.current?.querySelector("article"); let surface = panel.current; if (!anchor || !surface) return; let place = () => { if (!anchor.isConnected || anchor.getClientRects().length === 0) { dismiss(); return; } let bounds = anchor.getBoundingClientRect(); let scroller = planScroller(card.current); let viewport = scroller?.getBoundingClientRect(); if ( viewport && (bounds.bottom <= viewport.top || bounds.top >= viewport.bottom) ) { dismiss(); return; } let next = evidencePoint( bounds, { width: innerWidth, height: innerHeight }, surface.offsetWidth, surface.offsetHeight, ); setPosition(current => current?.left === next.left && current.top === next.top && current.side === next.side ? current : next ); }; place(); let observer = new ResizeObserver(place); observer.observe(anchor); observer.observe(surface); window.addEventListener("resize", place); document.addEventListener("scroll", place, true); return () => { observer.disconnect(); window.removeEventListener("resize", place); document.removeEventListener("scroll", place, true); }; }, [visible, content, dismiss]); return ( { if (visible) dismiss(); else { focusPending.current = true; setPosition(undefined); setOpen(true); } }, }} >
{children} {presence.phase !== "closed" && createPortal(
{ if (event.target instanceof Element && event.target.closest("button")) dismiss(); }} ref={panel} role="dialog" style={position ? { left: position.left, top: position.top, "--motion-origin-x": position.side === "right" ? "0%" : "100%", "--motion-origin-y": "0%", } as CSSProperties : { left: 0, top: 0, visibility: "hidden" }} >

Evidence

{presence.value}
, document.body, )}
); }