Tooltip subtlety round: 500ms rest delay, quiet chip, parens suffixes, drops + trims
Owner round 2026-09-25, over 09c0f6e. The wave's tooltips read as distracting; this round makes them quiet: - Delay: TOOLTIP_DELAY_MS = 500 in the primitive — tooltips appear when you pause on a control, never in passing (Radix focus-opens stay instant by design; keyboard users don't wait). - Vanish on leave: disableHoverableContent — the chip is un-hoverable, so the instant the cursor leaves the trigger it's gone, even mid-move onto the chip's own pixels. - Look: bg-accent (#2a2a2a, the hover-chip tone) instead of the white bg-foreground slab; 11px; px-2 py-1; arrow culled (nothing purely decorative); text-foreground/85. - Suffix: parentheses, not em-dash — "Dictate (⌘D)"; the registry source unchanged (still override-aware). - Drops (owner-selected): send square, start square, stats summary — the icons/numbers describe themselves. - Home logo kept but to the RIGHT with its real shortcut "Home (⌘G)" (jump-graph routes to /, the same destination). - Trims: "Model selector (⌘K)", "Thinking level", "Graph costs — click for details", "How much of this session isn't mapped yet". - Added: Import Notes gets "Import notes into the graph" — the one button whose destination wasn't obvious. Pins: TOOLTIP_DELAY_MS=500; hintText parens expectations updated. Live-verified on :3001 — 508ms hover delay measured, close within 10ms of pointerout, chip styles probed (rgb(42,42,42), 11px, 4px/8px), arrow gone, all new labels + sides confirmed, drops carry no tooltip and no aria-describedby.
This commit is contained in:
@@ -6,9 +6,10 @@ import { bindingForAction, formatBinding, type KeyAction } from "@/src/core"
|
||||
|
||||
/**
|
||||
* The tooltip composition for icon and pill controls (tooltip wave, owner
|
||||
* 2026-09-25). The styled Radix tooltip (ui/tooltip.tsx, adopted as-is —
|
||||
* no restyling) carries the label, with the control's shortcut appended as
|
||||
* an em-dash suffix when it has one ("Dictate — ⌘D").
|
||||
* 2026-09-25; subtlety round same day). The styled Radix tooltip carries
|
||||
* the label, with the control's shortcut appended in parentheses when
|
||||
* it has one ("Dictate (⌘D)") — the owner call: the em-dash suffix read
|
||||
* as too much air.
|
||||
*
|
||||
* The binding is override-aware: pass `action` for registry shortcuts (a
|
||||
* user rebind in Settings → Keyboard changes the suffix live), or
|
||||
@@ -31,7 +32,7 @@ interface HintProps {
|
||||
children: React.ReactElement
|
||||
}
|
||||
|
||||
/** The composition itself, pure — "Dictate" + ⌘D → "Dictate — ⌘D". Exported
|
||||
/** The composition itself, pure — "Dictate" + ⌘D → "Dictate (⌘D)". Exported
|
||||
* for the mechanism pins (tests/tooltip-mechanism.test.tsx). */
|
||||
export function hintText(label: string, action?: KeyAction, binding?: string): string {
|
||||
const live = action
|
||||
@@ -39,7 +40,7 @@ export function hintText(label: string, action?: KeyAction, binding?: string): s
|
||||
: binding
|
||||
? formatBinding(binding)
|
||||
: ""
|
||||
return live ? `${label} — ${live}` : label
|
||||
return live ? `${label} (${live})` : label
|
||||
}
|
||||
|
||||
export function Hint({ label, action, binding, side = "top", children }: HintProps) {
|
||||
|
||||
@@ -5,8 +5,21 @@ import { Tooltip as TooltipPrimitive } from "radix-ui"
|
||||
|
||||
import { cn } from "@/lib/utils"
|
||||
|
||||
/**
|
||||
* The styled tooltip (tooltip wave → subtlety round, owner 2026-09-25):
|
||||
* a quiet dark chip, not a white slab — accent tone (the hover-chip color),
|
||||
* 11px, minimal padding, no arrow (nothing purely decorative). Opens after
|
||||
* a 500ms rest, so tooltips appear when you pause on a control, never in
|
||||
* passing; disableHoverableContent means the chip is un-hoverable — the
|
||||
* instant the cursor leaves the trigger it's gone, even mid-move onto the
|
||||
* chip's own pixels.
|
||||
*/
|
||||
|
||||
/** The rest delay (ms): shared by hover and focus opens. */
|
||||
export const TOOLTIP_DELAY_MS = 500
|
||||
|
||||
function TooltipProvider({
|
||||
delayDuration = 0,
|
||||
delayDuration = TOOLTIP_DELAY_MS,
|
||||
...props
|
||||
}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
|
||||
return (
|
||||
@@ -19,9 +32,16 @@ function TooltipProvider({
|
||||
}
|
||||
|
||||
function Tooltip({
|
||||
disableHoverableContent = true,
|
||||
...props
|
||||
}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
|
||||
return <TooltipPrimitive.Root data-slot="tooltip" {...props} />
|
||||
return (
|
||||
<TooltipPrimitive.Root
|
||||
data-slot="tooltip"
|
||||
disableHoverableContent={disableHoverableContent}
|
||||
{...props}
|
||||
/>
|
||||
)
|
||||
}
|
||||
|
||||
function TooltipTrigger({
|
||||
@@ -32,7 +52,7 @@ function TooltipTrigger({
|
||||
|
||||
function TooltipContent({
|
||||
className,
|
||||
sideOffset = 0,
|
||||
sideOffset = 6,
|
||||
children,
|
||||
...props
|
||||
}: React.ComponentProps<typeof TooltipPrimitive.Content>) {
|
||||
@@ -42,16 +62,15 @@ function TooltipContent({
|
||||
data-slot="tooltip-content"
|
||||
sideOffset={sideOffset}
|
||||
className={cn(
|
||||
"z-50 w-fit origin-(--radix-tooltip-content-transform-origin) animate-in rounded-md bg-foreground px-3 py-1.5 text-xs text-balance text-background fade-in-0 zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95",
|
||||
"z-50 w-fit origin-(--radix-tooltip-content-transform-origin) animate-in rounded-md bg-accent px-2 py-1 text-[11px] text-foreground/85 text-balance fade-in-0 zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95",
|
||||
className
|
||||
)}
|
||||
{...props}
|
||||
>
|
||||
{children}
|
||||
<TooltipPrimitive.Arrow className="z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px] bg-foreground fill-foreground" />
|
||||
</TooltipPrimitive.Content>
|
||||
</TooltipPrimitive.Portal>
|
||||
)
|
||||
}
|
||||
|
||||
export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }
|
||||
export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }
|
||||
Reference in New Issue
Block a user