The best way to control Claude Code, Codex and more from any computer or phone
| 1 | import { Tooltip as TooltipPrimitive } from "@base-ui/react/tooltip"; |
| 2 | import { |
| 3 | createContext, |
| 4 | use, |
| 5 | useEffect, |
| 6 | useRef, |
| 7 | useState, |
| 8 | type ComponentProps, |
| 9 | type RefObject, |
| 10 | } from "react"; |
| 11 | |
| 12 | import { cn } from "~/lib/utils"; |
| 13 | import { useNativeTitlebarHeight } from "~/lib/windowControlsOverlay"; |
| 14 | |
| 15 | // Base UI's default, restated because a padding object zeroes the sides it omits. |
| 16 | const COLLISION_PADDING = 5; |
| 17 | |
| 18 | const TooltipProvider = TooltipPrimitive.Provider; |
| 19 | |
| 20 | type TooltipActionsRef = RefObject<TooltipPrimitive.Root.Actions | null>; |
| 21 | |
| 22 | // The compiler freezes context values; update hovered tooltips through calls instead of shared ref writes. |
| 23 | function createTooltipHoverTracker() { |
| 24 | let hovered: { trigger: HTMLElement; actionsRef: TooltipActionsRef } | null = null; |
| 25 | return { |
| 26 | hover(trigger: HTMLElement, actionsRef: TooltipActionsRef) { |
| 27 | hovered = { trigger, actionsRef }; |
| 28 | }, |
| 29 | release(actionsRef: TooltipActionsRef) { |
| 30 | if (hovered?.actionsRef === actionsRef) hovered = null; |
| 31 | }, |
| 32 | dismissUnfocused() { |
| 33 | const tooltip = hovered; |
| 34 | if (!tooltip) return; |
| 35 | const focused = tooltip.trigger.ownerDocument.activeElement; |
| 36 | if (focused && tooltip.trigger.contains(focused) && focused.matches(":focus-visible")) { |
| 37 | return; |
| 38 | } |
| 39 | hovered = null; |
| 40 | // Base UI also cancels delayed hover opens through this action. |
| 41 | tooltip.actionsRef.current?.close(); |
| 42 | }, |
| 43 | }; |
| 44 | } |
| 45 | |
| 46 | type TooltipHoverTracker = ReturnType<typeof createTooltipHoverTracker>; |
| 47 | const TooltipHoverContext = createContext<TooltipActionsRef | null>(null); |
| 48 | const TooltipScrollContext = createContext<TooltipHoverTracker | null>(null); |
| 49 | |
| 50 | function TooltipScrollDismissArea({ onScrollCapture, ...props }: ComponentProps<"div">) { |
| 51 | const [tracker] = useState(createTooltipHoverTracker); |
| 52 | return ( |
| 53 | <TooltipScrollContext value={tracker}> |
| 54 | <div |
| 55 | {...props} |
| 56 | onScrollCapture={(event) => { |
| 57 | onScrollCapture?.(event); |
| 58 | tracker.dismissUnfocused(); |
| 59 | }} |
| 60 | /> |
| 61 | </TooltipScrollContext> |
| 62 | ); |
| 63 | } |
| 64 | |
| 65 | function Tooltip<Payload>(props: TooltipPrimitive.Root.Props<Payload>) { |
| 66 | const tracker = use(TooltipScrollContext); |
| 67 | const localActionsRef = useRef<TooltipPrimitive.Root.Actions | null>(null); |
| 68 | const actionsRef = props.actionsRef ?? localActionsRef; |
| 69 | // oxlint-disable-next-line t3code/no-unreasoned-state-sync -- releases this tooltip from the scroll tracker on unmount |
| 70 | useEffect(() => () => tracker?.release(actionsRef), [actionsRef, tracker]); |
| 71 | |
| 72 | if (!tracker) return <TooltipPrimitive.Root {...props} />; |
| 73 | return ( |
| 74 | <TooltipHoverContext value={actionsRef}> |
| 75 | <TooltipPrimitive.Root |
| 76 | {...props} |
| 77 | actionsRef={actionsRef} |
| 78 | onOpenChange={(open, details) => { |
| 79 | props.onOpenChange?.(open, details); |
| 80 | if (!open && !details.isCanceled) tracker.release(actionsRef); |
| 81 | }} |
| 82 | /> |
| 83 | </TooltipHoverContext> |
| 84 | ); |
| 85 | } |
| 86 | |
| 87 | function TooltipTrigger(props: TooltipPrimitive.Trigger.Props) { |
| 88 | const tracker = use(TooltipScrollContext); |
| 89 | const actionsRef = use(TooltipHoverContext); |
| 90 | if (!tracker || !actionsRef) { |
| 91 | return <TooltipPrimitive.Trigger data-slot="tooltip-trigger" {...props} />; |
| 92 | } |
| 93 | return ( |
| 94 | <TooltipPrimitive.Trigger |
| 95 | data-slot="tooltip-trigger" |
| 96 | {...props} |
| 97 | onMouseEnter={(event) => { |
| 98 | props.onMouseEnter?.(event); |
| 99 | tracker.hover(event.currentTarget, actionsRef); |
| 100 | }} |
| 101 | /> |
| 102 | ); |
| 103 | } |
| 104 | |
| 105 | function TooltipPositioner(props: TooltipPrimitive.Positioner.Props) { |
| 106 | const titlebarHeight = useNativeTitlebarHeight(); |
| 107 | return ( |
| 108 | <TooltipPrimitive.Positioner |
| 109 | className="pointer-events-none z-[140] max-w-(--available-width) transition-[top,left,right,bottom,transform] data-instant:transition-none" |
| 110 | collisionPadding={{ |
| 111 | top: COLLISION_PADDING + titlebarHeight, |
| 112 | right: COLLISION_PADDING, |
| 113 | bottom: COLLISION_PADDING, |
| 114 | left: COLLISION_PADDING, |
| 115 | }} |
| 116 | data-slot="tooltip-positioner" |
| 117 | {...props} |
| 118 | /> |
| 119 | ); |
| 120 | } |
| 121 | |
| 122 | function TooltipPopup({ |
| 123 | className, |
| 124 | align = "center", |
| 125 | sideOffset = 4, |
| 126 | side = "top", |
| 127 | variant = "default", |
| 128 | anchor, |
| 129 | children, |
| 130 | ...props |
| 131 | }: TooltipPrimitive.Popup.Props & { |
| 132 | align?: TooltipPrimitive.Positioner.Props["align"]; |
| 133 | side?: TooltipPrimitive.Positioner.Props["side"]; |
| 134 | sideOffset?: TooltipPrimitive.Positioner.Props["sideOffset"]; |
| 135 | variant?: "default" | "glass" | "code"; |
| 136 | anchor?: TooltipPrimitive.Positioner.Props["anchor"]; |
| 137 | }) { |
| 138 | return ( |
| 139 | <TooltipPrimitive.Portal> |
| 140 | <TooltipPositioner align={align} anchor={anchor} side={side} sideOffset={sideOffset}> |
| 141 | <TooltipPrimitive.Popup |
| 142 | className={cn( |
| 143 | "relative flex origin-(--transform-origin) rounded-md text-popover-foreground text-xs transition-[scale,opacity] before:pointer-events-none before:absolute before:inset-0 before:rounded-[calc(var(--radius-md)-1px)] before:shadow-[0_1px_--theme(--color-black/4%)] data-ending-style:scale-98 data-starting-style:scale-98 data-ending-style:opacity-0 data-starting-style:opacity-0 data-instant:duration-0 dark:before:shadow-[0_-1px_--theme(--color-white/6%)]", |
| 144 | variant === "glass" |
| 145 | ? "dropdown-glass shadow-xl shadow-black/25 before:hidden" |
| 146 | : "border bg-popover not-dark:bg-clip-padding shadow-md/5", |
| 147 | variant === "code" |
| 148 | ? "max-w-120 wrap-anywhere text-left font-mono text-[11px] leading-relaxed" |
| 149 | : "max-w-80 wrap-anywhere whitespace-normal leading-snug", |
| 150 | className, |
| 151 | )} |
| 152 | data-slot="tooltip-popup" |
| 153 | {...props} |
| 154 | > |
| 155 | <div className="min-w-0 px-2 py-1" data-slot="tooltip-viewport"> |
| 156 | {children} |
| 157 | </div> |
| 158 | </TooltipPrimitive.Popup> |
| 159 | </TooltipPositioner> |
| 160 | </TooltipPrimitive.Portal> |
| 161 | ); |
| 162 | } |
| 163 | |
| 164 | export { TooltipProvider, Tooltip, TooltipTrigger, TooltipPopup, TooltipScrollDismissArea }; |