@brightlocal/ui-components 3.0.0 → 3.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (235) hide show
  1. package/README.md +7 -1
  2. package/component-meta.json +749 -53
  3. package/deprecations.json +114 -4
  4. package/dist/accordion.cjs +1 -1
  5. package/dist/accordion.d.ts +36 -0
  6. package/dist/accordion.d.ts.map +1 -1
  7. package/dist/accordion.js +74 -61
  8. package/dist/alert-dialog.cjs +1 -1
  9. package/dist/alert-dialog.d.ts +32 -3
  10. package/dist/alert-dialog.d.ts.map +1 -1
  11. package/dist/alert-dialog.js +61 -58
  12. package/dist/alert.cjs +1 -1
  13. package/dist/alert.d.ts.map +1 -1
  14. package/dist/alert.js +58 -57
  15. package/dist/badge.cjs +1 -1
  16. package/dist/badge.d.ts +9 -0
  17. package/dist/badge.d.ts.map +1 -1
  18. package/dist/badge.js +50 -30
  19. package/dist/banner.cjs +1 -0
  20. package/dist/banner.d.ts +81 -0
  21. package/dist/banner.d.ts.map +1 -0
  22. package/dist/banner.js +176 -0
  23. package/dist/blocks/empty-state.cjs +1 -1
  24. package/dist/blocks/empty-state.d.ts +4 -3
  25. package/dist/blocks/empty-state.d.ts.map +1 -1
  26. package/dist/blocks/empty-state.js +50 -57
  27. package/dist/blocks/progress-state.d.ts +2 -2
  28. package/dist/blocks/sidebar.cjs +1 -1
  29. package/dist/blocks/sidebar.d.ts +17 -0
  30. package/dist/blocks/sidebar.d.ts.map +1 -1
  31. package/dist/blocks/sidebar.js +8 -2
  32. package/dist/brand-illustration-motif.d.ts +1 -1
  33. package/dist/button-group.cjs +1 -0
  34. package/dist/button-group.d.ts +36 -0
  35. package/dist/button-group.d.ts.map +1 -0
  36. package/dist/button-group.js +47 -0
  37. package/dist/button.cjs +1 -1
  38. package/dist/button.js +1 -1
  39. package/dist/card.cjs +1 -1
  40. package/dist/card.d.ts +105 -7
  41. package/dist/card.d.ts.map +1 -1
  42. package/dist/card.js +198 -101
  43. package/dist/chart.cjs +3 -3
  44. package/dist/chart.d.ts +270 -24
  45. package/dist/chart.d.ts.map +1 -1
  46. package/dist/chart.js +497 -322
  47. package/dist/checkbox.cjs +1 -1
  48. package/dist/checkbox.d.ts +1 -1
  49. package/dist/checkbox.d.ts.map +1 -1
  50. package/dist/checkbox.js +2 -1
  51. package/dist/chip.cjs +1 -1
  52. package/dist/chip.d.ts +38 -4
  53. package/dist/chip.d.ts.map +1 -1
  54. package/dist/chip.js +95 -81
  55. package/dist/combobox.cjs +1 -1
  56. package/dist/combobox.js +2 -2
  57. package/dist/command.cjs +1 -1
  58. package/dist/command.d.ts +23 -1
  59. package/dist/command.d.ts.map +1 -1
  60. package/dist/command.js +251 -225
  61. package/dist/data-table.cjs +1 -1
  62. package/dist/data-table.d.ts +201 -23
  63. package/dist/data-table.d.ts.map +1 -1
  64. package/dist/data-table.js +712 -568
  65. package/dist/date-picker.cjs +1 -1
  66. package/dist/date-picker.d.ts +13 -5
  67. package/dist/date-picker.d.ts.map +1 -1
  68. package/dist/date-picker.js +54 -53
  69. package/dist/field.cjs +1 -1
  70. package/dist/field.d.ts +8 -1
  71. package/dist/field.d.ts.map +1 -1
  72. package/dist/field.js +79 -52
  73. package/dist/global-layout.cjs +1 -1
  74. package/dist/global-layout.d.ts +105 -13
  75. package/dist/global-layout.d.ts.map +1 -1
  76. package/dist/global-layout.js +146 -129
  77. package/dist/grid.d.ts +26 -3
  78. package/dist/grid.d.ts.map +1 -1
  79. package/dist/hooks/use-breakpoint.cjs +1 -1
  80. package/dist/hooks/use-breakpoint.d.ts +1 -1
  81. package/dist/hooks/use-breakpoint.d.ts.map +1 -1
  82. package/dist/hooks/use-breakpoint.js +1 -0
  83. package/dist/hooks/use-mobile.cjs +1 -0
  84. package/dist/hooks/use-mobile.js +8 -0
  85. package/dist/index.cjs +1 -1
  86. package/dist/index.d.ts +6 -0
  87. package/dist/index.d.ts.map +1 -1
  88. package/dist/index.js +594 -553
  89. package/dist/info-tooltip.cjs +1 -0
  90. package/dist/info-tooltip.d.ts +39 -0
  91. package/dist/info-tooltip.d.ts.map +1 -0
  92. package/dist/info-tooltip.js +41 -0
  93. package/dist/input-chip.cjs +1 -1
  94. package/dist/input-chip.js +1 -1
  95. package/dist/input-group.cjs +1 -1
  96. package/dist/input-group.d.ts +33 -2
  97. package/dist/input-group.d.ts.map +1 -1
  98. package/dist/input-group.js +167 -54
  99. package/dist/input-otp.cjs +1 -1
  100. package/dist/input-otp.js +9 -9
  101. package/dist/input-password.cjs +1 -1
  102. package/dist/input-password.d.ts +45 -15
  103. package/dist/input-password.d.ts.map +1 -1
  104. package/dist/input-password.js +31 -30
  105. package/dist/input.cjs +1 -1
  106. package/dist/input.js +10 -10
  107. package/dist/lib/block-illustration.cjs +1 -1
  108. package/dist/lib/block-illustration.d.ts +4 -1
  109. package/dist/lib/block-illustration.d.ts.map +1 -1
  110. package/dist/lib/block-illustration.js +12 -11
  111. package/dist/lib/empty-chip.cjs +1 -0
  112. package/dist/lib/empty-chip.d.ts +4 -0
  113. package/dist/lib/empty-chip.d.ts.map +1 -0
  114. package/dist/lib/empty-chip.js +13 -0
  115. package/dist/lib/utils.cjs +1 -1
  116. package/dist/lib/utils.d.ts.map +1 -1
  117. package/dist/lib/utils.js +4 -3
  118. package/dist/list.cjs +1 -1
  119. package/dist/list.js +1 -1
  120. package/dist/multi-select-filter.cjs +1 -0
  121. package/dist/multi-select-filter.d.ts +178 -0
  122. package/dist/multi-select-filter.d.ts.map +1 -0
  123. package/dist/multi-select-filter.js +463 -0
  124. package/dist/pagination.cjs +1 -1
  125. package/dist/pagination.d.ts +3 -0
  126. package/dist/pagination.d.ts.map +1 -1
  127. package/dist/pagination.js +57 -57
  128. package/dist/progress.cjs +1 -1
  129. package/dist/progress.d.ts +123 -16
  130. package/dist/progress.d.ts.map +1 -1
  131. package/dist/progress.js +89 -75
  132. package/dist/rating.cjs +1 -1
  133. package/dist/rating.js +18 -18
  134. package/dist/relative-date.cjs +1 -0
  135. package/dist/relative-date.d.ts +65 -0
  136. package/dist/relative-date.d.ts.map +1 -0
  137. package/dist/relative-date.js +128 -0
  138. package/dist/scroll-area.cjs +1 -1
  139. package/dist/scroll-area.d.ts +15 -6
  140. package/dist/scroll-area.d.ts.map +1 -1
  141. package/dist/scroll-area.js +38 -36
  142. package/dist/select.cjs +2 -2
  143. package/dist/select.d.ts +24 -3
  144. package/dist/select.d.ts.map +1 -1
  145. package/dist/select.js +130 -110
  146. package/dist/sheet.cjs +1 -1
  147. package/dist/sheet.d.ts +78 -2
  148. package/dist/sheet.d.ts.map +1 -1
  149. package/dist/sheet.js +192 -85
  150. package/dist/single-select-filter.cjs +1 -0
  151. package/dist/single-select-filter.d.ts +81 -0
  152. package/dist/single-select-filter.d.ts.map +1 -0
  153. package/dist/single-select-filter.js +226 -0
  154. package/dist/sonner.cjs +1 -1
  155. package/dist/sonner.d.ts.map +1 -1
  156. package/dist/sonner.js +22 -22
  157. package/dist/split-layout.cjs +1 -1
  158. package/dist/split-layout.d.ts +1 -1
  159. package/dist/split-layout.js +13 -13
  160. package/dist/table.cjs +1 -1
  161. package/dist/table.d.ts +45 -4
  162. package/dist/table.d.ts.map +1 -1
  163. package/dist/table.js +90 -73
  164. package/dist/tabs.cjs +1 -1
  165. package/dist/tabs.d.ts +12 -1
  166. package/dist/tabs.d.ts.map +1 -1
  167. package/dist/tabs.js +148 -126
  168. package/dist/textarea.cjs +1 -1
  169. package/dist/textarea.js +1 -1
  170. package/dist/tooltip.cjs +1 -1
  171. package/dist/tooltip.d.ts +38 -36
  172. package/dist/tooltip.d.ts.map +1 -1
  173. package/dist/tooltip.js +262 -73
  174. package/dist/typography-heading.cjs +1 -1
  175. package/dist/typography-heading.d.ts +13 -0
  176. package/dist/typography-heading.d.ts.map +1 -1
  177. package/dist/typography-heading.js +32 -21
  178. package/dist/typography-text.cjs +1 -1
  179. package/dist/typography-text.d.ts +15 -2
  180. package/dist/typography-text.d.ts.map +1 -1
  181. package/dist/typography-text.js +35 -24
  182. package/dist/typography.d.ts +1 -1
  183. package/package.json +5 -6
  184. package/src/blocks/empty-state.tsx +17 -24
  185. package/src/blocks/progress-state.tsx +2 -2
  186. package/src/blocks/sidebar.tsx +26 -2
  187. package/src/components/accordion.tsx +82 -27
  188. package/src/components/alert-dialog.tsx +50 -5
  189. package/src/components/alert.tsx +16 -8
  190. package/src/components/badge.tsx +40 -3
  191. package/src/components/banner.tsx +288 -0
  192. package/src/components/brand-illustration-motif.tsx +1 -1
  193. package/src/components/button-group.tsx +112 -0
  194. package/src/components/button.tsx +1 -1
  195. package/src/components/card.tsx +249 -27
  196. package/src/components/chart.tsx +586 -53
  197. package/src/components/checkbox.tsx +1 -1
  198. package/src/components/chip.tsx +83 -10
  199. package/src/components/combobox.tsx +2 -2
  200. package/src/components/command.tsx +56 -4
  201. package/src/components/data-table.tsx +842 -199
  202. package/src/components/date-picker.tsx +18 -7
  203. package/src/components/field.tsx +81 -12
  204. package/src/components/global-layout.tsx +176 -38
  205. package/src/components/grid.tsx +34 -3
  206. package/src/components/info-tooltip.tsx +94 -0
  207. package/src/components/input-chip.tsx +1 -1
  208. package/src/components/input-group.tsx +246 -11
  209. package/src/components/input-otp.tsx +1 -1
  210. package/src/components/input-password.tsx +56 -22
  211. package/src/components/input.tsx +1 -1
  212. package/src/components/list.tsx +1 -1
  213. package/src/components/multi-select-filter.tsx +912 -0
  214. package/src/components/pagination.tsx +10 -3
  215. package/src/components/progress.tsx +190 -31
  216. package/src/components/rating.tsx +1 -1
  217. package/src/components/relative-date.tsx +230 -0
  218. package/src/components/scroll-area.tsx +23 -10
  219. package/src/components/select.tsx +65 -11
  220. package/src/components/sheet.tsx +240 -4
  221. package/src/components/single-select-filter.tsx +443 -0
  222. package/src/components/sonner.tsx +16 -5
  223. package/src/components/split-layout.tsx +2 -2
  224. package/src/components/table.tsx +71 -11
  225. package/src/components/tabs.tsx +93 -46
  226. package/src/components/textarea.tsx +1 -1
  227. package/src/components/tooltip.tsx +440 -68
  228. package/src/components/typography-heading.tsx +24 -0
  229. package/src/components/typography-text.tsx +27 -3
  230. package/src/components/typography.tsx +1 -1
  231. package/src/hooks/use-breakpoint.ts +2 -1
  232. package/src/index.ts +6 -0
  233. package/src/lib/block-illustration.tsx +5 -1
  234. package/src/lib/empty-chip.ts +24 -0
  235. package/src/lib/utils.ts +1 -0
@@ -1,20 +1,42 @@
1
1
  "use client";
2
2
 
3
3
  import * as React from "react";
4
- import * as TooltipPrimitive from "@radix-ui/react-tooltip";
4
+ import * as PopoverPrimitive from "@radix-ui/react-popover";
5
+ import { Slot } from "@radix-ui/react-slot";
5
6
 
6
7
  import {
7
8
  cn,
8
9
  FLOATING_CONTENT_ANIMATION,
9
10
  } from "@brightlocal/ui-components/lib/utils";
10
11
 
11
- interface TooltipProviderProps extends React.ComponentProps<
12
- typeof TooltipPrimitive.Provider
13
- > {
12
+ /* -------------------------------- Provider -------------------------------- */
13
+
14
+ interface TooltipProviderProps {
15
+ /**
16
+ * The duration in ms to wait before showing the tooltip.
17
+ * @default 0
18
+ */
14
19
  delayDuration?: number;
20
+ /**
21
+ * The duration in ms to skip the delay when moving between tooltips.
22
+ * @default 0
23
+ */
15
24
  skipDelayDuration?: number;
25
+ children: React.ReactNode;
26
+ }
27
+
28
+ interface TooltipProviderContextValue {
29
+ delayDuration: number;
30
+ skipDelayDuration: number;
16
31
  }
17
32
 
33
+ const TooltipProviderContext = React.createContext<TooltipProviderContextValue>(
34
+ {
35
+ delayDuration: 0,
36
+ skipDelayDuration: 0,
37
+ }
38
+ );
39
+
18
40
  /**
19
41
  * TooltipProvider - Wraps your application or a section of it to provide shared tooltip configuration.
20
42
  *
@@ -34,22 +56,98 @@ interface TooltipProviderProps extends React.ComponentProps<
34
56
  function TooltipProvider({
35
57
  delayDuration = 0,
36
58
  skipDelayDuration = 0,
37
- ...props
59
+ children,
38
60
  }: TooltipProviderProps) {
61
+ const value = React.useMemo(
62
+ () => ({ delayDuration, skipDelayDuration }),
63
+ [delayDuration, skipDelayDuration]
64
+ );
39
65
  return (
40
- <TooltipPrimitive.Provider
41
- delayDuration={delayDuration}
42
- skipDelayDuration={skipDelayDuration}
43
- {...props}
44
- />
66
+ <TooltipProviderContext.Provider value={value}>
67
+ {children}
68
+ </TooltipProviderContext.Provider>
45
69
  );
46
70
  }
47
71
 
72
+ /* -------------------------------- Helpers --------------------------------- */
73
+
74
+ /**
75
+ * Calls the consumer's handler first, then ours — unless the consumer called
76
+ * `preventDefault()`. Mirrors Radix's `composeEventHandlers` without adding
77
+ * `@radix-ui/primitive` as a direct dependency.
78
+ */
79
+ function composeEventHandlers<E extends { defaultPrevented: boolean }>(
80
+ theirs: ((event: E) => void) | undefined,
81
+ ours: (event: E) => void
82
+ ) {
83
+ return (event: E) => {
84
+ theirs?.(event);
85
+ if (!event.defaultPrevented) ours(event);
86
+ };
87
+ }
88
+
89
+ /** Grace period (ms) before a hover-opened tooltip closes after the pointer leaves. */
90
+ const HOVER_CLOSE_GRACE_MS = 200;
91
+
92
+ /* ----------------------------- Tooltip context ----------------------------- */
93
+
94
+ /**
95
+ * How the currently open tooltip was opened. Decides which signals may close it:
96
+ * - `hover` — pointer enter/leave, keyboard focus/blur, the hover grace timer.
97
+ * - `touch` — opened by a tap; stays open (so its text can be selected and
98
+ * copied) until the trigger is tapped again, something outside is
99
+ * tapped, or Escape is pressed.
100
+ */
101
+ type TooltipInteractionMode = "hover" | "touch";
102
+
103
+ interface TooltipContextValue {
104
+ open: boolean;
105
+ tooltipId: string;
106
+ triggerRef: React.RefObject<HTMLElement | null>;
107
+ onTriggerPointerEnter: (e: React.PointerEvent) => void;
108
+ onTriggerPointerLeave: (e: React.PointerEvent) => void;
109
+ onTriggerPointerDown: (e: React.PointerEvent) => void;
110
+ onTriggerPointerCancel: () => void;
111
+ onTriggerClick: () => void;
112
+ onTriggerFocus: () => void;
113
+ onTriggerBlur: () => void;
114
+ onContentPointerEnter: () => void;
115
+ onContentPointerLeave: (e: React.PointerEvent) => void;
116
+ onContentInteractOutside: (
117
+ e: Parameters<
118
+ NonNullable<
119
+ React.ComponentProps<
120
+ typeof PopoverPrimitive.Content
121
+ >["onInteractOutside"]
122
+ >
123
+ >[0]
124
+ ) => void;
125
+ }
126
+
127
+ const TooltipContext = React.createContext<TooltipContextValue | null>(null);
128
+
129
+ function useTooltipContext() {
130
+ const ctx = React.useContext(TooltipContext);
131
+ if (!ctx) {
132
+ throw new Error("Tooltip components must be used within <Tooltip>");
133
+ }
134
+ return ctx;
135
+ }
136
+
137
+ /* ------------------------------ Tooltip root ------------------------------- */
138
+
48
139
  /**
49
- * Tooltip - Displays a popup with additional information when hovering over an element.
140
+ * Tooltip - Displays a popup with additional information.
141
+ *
142
+ * Toggletip behaviour by input type:
143
+ * - **Mouse / pen / keyboard**: opens on hover or focus, closes when the pointer
144
+ * leaves (after a short grace period so the pointer can move onto the content)
145
+ * or focus moves away.
146
+ * - **Touch**: a tap toggles it. While open it ignores hover/blur signals so the
147
+ * text can be long-pressed and copied; it closes on a second tap of the
148
+ * trigger, a tap outside, or Escape.
50
149
  *
51
150
  * @example
52
- * // Basic usage (requires TooltipProvider wrapper):
53
151
  * <Tooltip>
54
152
  * <TooltipTrigger asChild>
55
153
  * <Button>Hover me</Button>
@@ -60,97 +158,353 @@ function TooltipProvider({
60
158
  * </Tooltip>
61
159
  *
62
160
  * @remarks
63
- * This component must be used within a TooltipProvider. Wrap your app or component tree
64
- * with TooltipProvider once at the top level for optimal performance and UX when using
65
- * multiple tooltips.
161
+ * Wrap your app once in a TooltipProvider to share `delayDuration` across all
162
+ * tooltips. Without one the provider defaults (no delay) apply.
66
163
  */
67
164
  function Tooltip({
68
- ...props
69
- }: React.ComponentProps<typeof TooltipPrimitive.Root>) {
70
- return <TooltipPrimitive.Root {...props} />;
165
+ open: controlledOpen,
166
+ defaultOpen = false,
167
+ onOpenChange,
168
+ children,
169
+ }: React.ComponentProps<typeof PopoverPrimitive.Root>) {
170
+ const { delayDuration } = React.useContext(TooltipProviderContext);
171
+ const [uncontrolledOpen, setUncontrolledOpen] = React.useState(
172
+ defaultOpen ?? false
173
+ );
174
+ const isControlled = controlledOpen !== undefined;
175
+ const open = isControlled ? controlledOpen : uncontrolledOpen;
176
+
177
+ const hoverTimeout = React.useRef<ReturnType<typeof setTimeout>>(undefined);
178
+ const delayTimer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
179
+ const triggerRef = React.useRef<HTMLElement | null>(null);
180
+ /** Input mode of the current (or most recent) open; reset to hover on close. */
181
+ const mode = React.useRef<TooltipInteractionMode>("hover");
182
+ /**
183
+ * Pointer type of a press on the trigger that hasn't produced its click yet.
184
+ * Focus fired by that press must not open the tooltip (touch: the click
185
+ * toggles; mouse: hover already did), only a real keyboard focus may.
186
+ */
187
+ const pendingPress = React.useRef<"touch" | "mouse" | null>(null);
188
+ const tooltipId = React.useId();
189
+
190
+ const setOpen = React.useCallback(
191
+ (value: boolean) => {
192
+ if (!value) mode.current = "hover";
193
+ if (!isControlled) setUncontrolledOpen(value);
194
+ onOpenChange?.(value);
195
+ },
196
+ [isControlled, onOpenChange]
197
+ );
198
+
199
+ const clearTimers = React.useCallback(() => {
200
+ if (hoverTimeout.current !== undefined) {
201
+ clearTimeout(hoverTimeout.current);
202
+ hoverTimeout.current = undefined;
203
+ }
204
+ if (delayTimer.current !== undefined) {
205
+ clearTimeout(delayTimer.current);
206
+ delayTimer.current = undefined;
207
+ }
208
+ }, []);
209
+
210
+ React.useEffect(() => clearTimers, [clearTimers]);
211
+
212
+ const openFromHover = React.useCallback(() => {
213
+ clearTimers();
214
+ // A tap already owns this tooltip; hover/focus must not restart its timers.
215
+ if (mode.current === "touch") return;
216
+ if (delayDuration > 0) {
217
+ delayTimer.current = setTimeout(() => setOpen(true), delayDuration);
218
+ } else {
219
+ setOpen(true);
220
+ }
221
+ }, [clearTimers, delayDuration, setOpen]);
222
+
223
+ const closeFromHover = React.useCallback(() => {
224
+ clearTimers();
225
+ if (mode.current === "touch") return;
226
+ hoverTimeout.current = setTimeout(
227
+ () => setOpen(false),
228
+ HOVER_CLOSE_GRACE_MS
229
+ );
230
+ }, [clearTimers, setOpen]);
231
+
232
+ const onTriggerPointerEnter = React.useCallback(
233
+ (e: React.PointerEvent) => {
234
+ if (e.pointerType === "touch") return;
235
+ openFromHover();
236
+ },
237
+ [openFromHover]
238
+ );
239
+
240
+ const onTriggerPointerLeave = React.useCallback(
241
+ (e: React.PointerEvent) => {
242
+ if (e.pointerType === "touch") return;
243
+ // A mouse press dragged off the trigger never clicks; forget it.
244
+ pendingPress.current = null;
245
+ closeFromHover();
246
+ },
247
+ [closeFromHover]
248
+ );
249
+
250
+ // A mouse press leaves a hover-open tooltip alone (the hover is still on);
251
+ // it only matters for the focus/click that follow it.
252
+ const onTriggerPointerDown = React.useCallback((e: React.PointerEvent) => {
253
+ pendingPress.current = e.pointerType === "touch" ? "touch" : "mouse";
254
+ }, []);
255
+
256
+ // A touch that turns into a scroll never produces a click; forget it so the
257
+ // next keyboard focus isn't swallowed.
258
+ const onTriggerPointerCancel = React.useCallback(() => {
259
+ pendingPress.current = null;
260
+ }, []);
261
+
262
+ const onTriggerClick = React.useCallback(() => {
263
+ const press = pendingPress.current;
264
+ pendingPress.current = null;
265
+ if (press !== "touch") return;
266
+ clearTimers();
267
+ if (open) {
268
+ setOpen(false);
269
+ } else {
270
+ mode.current = "touch";
271
+ setOpen(true);
272
+ }
273
+ }, [clearTimers, open, setOpen]);
274
+
275
+ // Focus fired by a press (between pointerdown and click) is not an intent to
276
+ // open: on touch the click toggles, with a mouse hover already did.
277
+ const onTriggerFocus = React.useCallback(() => {
278
+ if (pendingPress.current) return;
279
+ openFromHover();
280
+ }, [openFromHover]);
281
+
282
+ const onTriggerBlur = React.useCallback(() => {
283
+ closeFromHover();
284
+ }, [closeFromHover]);
285
+
286
+ const onContentPointerEnter = React.useCallback(() => {
287
+ clearTimers();
288
+ }, [clearTimers]);
289
+
290
+ const onContentPointerLeave = React.useCallback(
291
+ (e: React.PointerEvent) => {
292
+ // A long-press to select text ends with pointercancel + pointerleave.
293
+ if (e.pointerType === "touch") return;
294
+ closeFromHover();
295
+ },
296
+ [closeFromHover]
297
+ );
298
+
299
+ // Radix treats the trigger (a Popover Anchor) as "outside" — leave trigger
300
+ // taps/focus to our own handlers so a second tap toggles instead of racing.
301
+ const onContentInteractOutside = React.useCallback<
302
+ TooltipContextValue["onContentInteractOutside"]
303
+ >((e) => {
304
+ const target = e.target;
305
+ if (target instanceof Node && triggerRef.current?.contains(target)) {
306
+ e.preventDefault();
307
+ }
308
+ }, []);
309
+
310
+ const handlePopoverOpenChange = React.useCallback(
311
+ (newOpen: boolean) => {
312
+ if (!newOpen) {
313
+ clearTimers();
314
+ setOpen(false);
315
+ }
316
+ },
317
+ [clearTimers, setOpen]
318
+ );
319
+
320
+ const contextValue = React.useMemo<TooltipContextValue>(
321
+ () => ({
322
+ open,
323
+ tooltipId,
324
+ triggerRef,
325
+ onTriggerPointerEnter,
326
+ onTriggerPointerLeave,
327
+ onTriggerPointerDown,
328
+ onTriggerPointerCancel,
329
+ onTriggerClick,
330
+ onTriggerFocus,
331
+ onTriggerBlur,
332
+ onContentPointerEnter,
333
+ onContentPointerLeave,
334
+ onContentInteractOutside,
335
+ }),
336
+ [
337
+ open,
338
+ tooltipId,
339
+ onTriggerPointerEnter,
340
+ onTriggerPointerLeave,
341
+ onTriggerPointerDown,
342
+ onTriggerPointerCancel,
343
+ onTriggerClick,
344
+ onTriggerFocus,
345
+ onTriggerBlur,
346
+ onContentPointerEnter,
347
+ onContentPointerLeave,
348
+ onContentInteractOutside,
349
+ ]
350
+ );
351
+
352
+ return (
353
+ <TooltipContext.Provider value={contextValue}>
354
+ <PopoverPrimitive.Root open={open} onOpenChange={handlePopoverOpenChange}>
355
+ {children}
356
+ </PopoverPrimitive.Root>
357
+ </TooltipContext.Provider>
358
+ );
71
359
  }
72
360
 
73
- interface TooltipTriggerProps extends React.ComponentProps<
74
- typeof TooltipPrimitive.Trigger
75
- > {
361
+ /* -------------------------------- Trigger --------------------------------- */
362
+
363
+ interface TooltipTriggerProps extends React.ComponentPropsWithoutRef<"button"> {
76
364
  /**
77
- * Data hook for automated testing, rendered as the `data-hook` attribute
78
- * (the platform test-selector contract).
79
- *
365
+ * Data hook for automated testing, rendered as the `data-hook` attribute.
80
366
  * Optional because `TooltipTrigger` is commonly used with `asChild`, where the
81
- * child element (e.g. a `Button`) already carries its own `dataHook`. When
82
- * `asChild` is set, the child's `data-hook` wins over this one.
367
+ * child element already carries its own `dataHook`.
83
368
  */
84
369
  dataHook?: string;
85
- /**
86
- * Optional analytics element identifier
87
- */
370
+ /** Optional analytics element identifier */
88
371
  trackingEl?: string;
89
- /**
90
- * Optional analytics label context
91
- */
372
+ /** Optional analytics label context */
92
373
  trackingLabel?: string;
374
+ /** Render as child element using Radix Slot */
375
+ asChild?: boolean;
93
376
  }
94
377
 
95
- const TooltipTrigger = React.forwardRef<
96
- React.ElementRef<typeof TooltipPrimitive.Trigger>,
97
- TooltipTriggerProps
98
- >(({ dataHook, trackingEl, trackingLabel, ...props }, ref) => {
99
- return (
100
- <TooltipPrimitive.Trigger
101
- ref={ref}
102
- data-hook={dataHook}
103
- data-slot="tooltip-trigger"
104
- data-tracking-el={trackingEl}
105
- data-tracking-label={trackingLabel}
106
- {...props}
107
- />
108
- );
109
- });
378
+ const TooltipTrigger = React.forwardRef<HTMLButtonElement, TooltipTriggerProps>(
379
+ (
380
+ {
381
+ dataHook,
382
+ trackingEl,
383
+ trackingLabel,
384
+ asChild,
385
+ children,
386
+ onBlur,
387
+ onClick,
388
+ onFocus,
389
+ onPointerCancel,
390
+ onPointerDown,
391
+ onPointerEnter,
392
+ onPointerLeave,
393
+ ...props
394
+ },
395
+ ref
396
+ ) => {
397
+ const {
398
+ open,
399
+ tooltipId,
400
+ triggerRef,
401
+ onTriggerPointerEnter,
402
+ onTriggerPointerLeave,
403
+ onTriggerPointerDown,
404
+ onTriggerPointerCancel,
405
+ onTriggerClick,
406
+ onTriggerFocus,
407
+ onTriggerBlur,
408
+ } = useTooltipContext();
409
+
410
+ const setRefs = React.useCallback(
411
+ (node: HTMLButtonElement | null) => {
412
+ triggerRef.current = node;
413
+ if (typeof ref === "function") ref(node);
414
+ else if (ref) ref.current = node;
415
+ },
416
+ [ref, triggerRef]
417
+ );
418
+
419
+ const Comp = asChild ? Slot : "button";
420
+
421
+ return (
422
+ <PopoverPrimitive.Anchor asChild>
423
+ <Comp
424
+ ref={setRefs}
425
+ data-slot="tooltip-trigger"
426
+ {...props}
427
+ aria-describedby={open ? tooltipId : undefined}
428
+ data-hook={dataHook}
429
+ data-tracking-el={trackingEl}
430
+ data-tracking-label={trackingLabel}
431
+ type={asChild ? undefined : "button"}
432
+ onBlur={composeEventHandlers(onBlur, onTriggerBlur)}
433
+ onClick={composeEventHandlers(onClick, onTriggerClick)}
434
+ onFocus={composeEventHandlers(onFocus, onTriggerFocus)}
435
+ onPointerCancel={composeEventHandlers(
436
+ onPointerCancel,
437
+ onTriggerPointerCancel
438
+ )}
439
+ onPointerDown={composeEventHandlers(
440
+ onPointerDown,
441
+ onTriggerPointerDown
442
+ )}
443
+ onPointerEnter={composeEventHandlers(
444
+ onPointerEnter,
445
+ onTriggerPointerEnter
446
+ )}
447
+ onPointerLeave={composeEventHandlers(
448
+ onPointerLeave,
449
+ onTriggerPointerLeave
450
+ )}
451
+ >
452
+ {children}
453
+ </Comp>
454
+ </PopoverPrimitive.Anchor>
455
+ );
456
+ }
457
+ );
110
458
 
111
459
  TooltipTrigger.displayName = "TooltipTrigger";
112
460
 
113
- interface TooltipContentProps extends React.ComponentProps<
114
- typeof TooltipPrimitive.Content
461
+ /* -------------------------------- Content --------------------------------- */
462
+
463
+ interface TooltipContentProps extends Omit<
464
+ React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>,
465
+ "onOpenAutoFocus" | "onCloseAutoFocus"
115
466
  > {
116
- /**
117
- * Required data-hook attribute for testing and analytics
118
- */
467
+ /** Required data-hook attribute for testing and analytics */
119
468
  dataHook: string;
120
- /**
121
- * Optional analytics element identifier
122
- */
469
+ /** Optional analytics element identifier */
123
470
  trackingEl?: string;
124
- /**
125
- * Optional analytics label context
126
- */
471
+ /** Optional analytics label context */
127
472
  trackingLabel?: string;
128
- /**
129
- * Hide the tooltip arrow
130
- */
473
+ /** Hide the tooltip arrow */
131
474
  hideArrow?: boolean;
132
475
  }
133
476
 
134
477
  const TooltipContent = React.forwardRef<
135
- React.ElementRef<typeof TooltipPrimitive.Content>,
478
+ React.ElementRef<typeof PopoverPrimitive.Content>,
136
479
  TooltipContentProps
137
480
  >(
138
481
  (
139
482
  {
140
483
  className,
484
+ side = "top",
141
485
  sideOffset = 0,
142
486
  dataHook,
143
487
  trackingEl,
144
488
  trackingLabel,
145
489
  hideArrow = false,
146
490
  children,
491
+ onInteractOutside,
492
+ onPointerEnter,
493
+ onPointerLeave,
147
494
  ...props
148
495
  },
149
496
  ref
150
497
  ) => {
498
+ const {
499
+ tooltipId,
500
+ onContentPointerEnter,
501
+ onContentPointerLeave,
502
+ onContentInteractOutside,
503
+ } = useTooltipContext();
504
+
151
505
  return (
152
- <TooltipPrimitive.Portal>
153
- <TooltipPrimitive.Content
506
+ <PopoverPrimitive.Portal>
507
+ <PopoverPrimitive.Content
154
508
  ref={ref}
155
509
  className={cn(
156
510
  "bg-secondary text-secondary-foreground text-body-xs z-50 w-max max-w-sm rounded-md px-3 py-1.5",
@@ -162,20 +516,38 @@ const TooltipContent = React.forwardRef<
162
516
  data-slot="tooltip-content"
163
517
  data-tracking-el={trackingEl}
164
518
  data-tracking-label={trackingLabel}
519
+ side={side}
165
520
  sideOffset={sideOffset}
521
+ onCloseAutoFocus={(e) => e.preventDefault()}
522
+ onOpenAutoFocus={(e) => e.preventDefault()}
166
523
  {...props}
524
+ role="none"
525
+ onInteractOutside={composeEventHandlers(
526
+ onInteractOutside,
527
+ onContentInteractOutside
528
+ )}
529
+ onPointerEnter={composeEventHandlers(
530
+ onPointerEnter,
531
+ onContentPointerEnter
532
+ )}
533
+ onPointerLeave={composeEventHandlers(
534
+ onPointerLeave,
535
+ onContentPointerLeave
536
+ )}
167
537
  >
168
- {children}
538
+ <span id={tooltipId} role="tooltip">
539
+ {children}
540
+ </span>
169
541
  {!hideArrow && (
170
- <TooltipPrimitive.Arrow
542
+ <PopoverPrimitive.Arrow
171
543
  className="fill-secondary"
172
544
  data-slot="tooltip-arrow"
173
545
  height={7}
174
546
  width={14}
175
547
  />
176
548
  )}
177
- </TooltipPrimitive.Content>
178
- </TooltipPrimitive.Portal>
549
+ </PopoverPrimitive.Content>
550
+ </PopoverPrimitive.Portal>
179
551
  );
180
552
  }
181
553
  );
@@ -74,6 +74,15 @@ const typographyHeadingVariants = cva("", {
74
74
  true: "tabular-nums",
75
75
  false: "proportional-nums",
76
76
  },
77
+ // Boolean on purpose (no `false` class): unlike tabular there is no
78
+ // inherited context to undo — either the element clips or it doesn't.
79
+ // `block` is load-bearing: an inline asChild child (e.g. a `span`) cannot
80
+ // clip — overflow does not apply to non-replaced inlines — so the variant
81
+ // forces a block container. A no-op on the default h1–h6 (already block)
82
+ // and on flex/grid items (blockified by the layout).
83
+ truncate: {
84
+ true: "block truncate",
85
+ },
77
86
  },
78
87
  defaultVariants: {
79
88
  color: "default",
@@ -140,6 +149,19 @@ interface TypographyHeadingProps extends React.ComponentProps<"h1"> {
140
149
  * TypographyText `metric` (plus `tabular` if it must align), not a heading.
141
150
  */
142
151
  tabular?: boolean;
152
+ /**
153
+ * Clip overflowing text to a single line with an ellipsis — card titles in
154
+ * a fixed-width grid, panel headers beside actions; anywhere a title can
155
+ * outgrow its container. The surrounding layout must still allow the
156
+ * element to shrink: inside a flex row the element (or its wrapper) needs
157
+ * `min-w-0`, and in a grid column `minmax(0, …)` — otherwise the box grows
158
+ * instead of clipping. Forces `display: block` (an inline box cannot
159
+ * clip), so an inline `asChild` child becomes a block while truncating —
160
+ * a no-op on the default h1–h6. Single-line only by design; a multi-line
161
+ * clamp can follow if demand appears.
162
+ * @default false
163
+ */
164
+ truncate?: boolean;
143
165
  /**
144
166
  * Render as a different element using Radix Slot pattern.
145
167
  * When true, merges props onto the child element.
@@ -186,6 +208,7 @@ const TypographyHeading = React.forwardRef<
186
208
  color = "default",
187
209
  align,
188
210
  tabular,
211
+ truncate = false,
189
212
  asChild = false,
190
213
  dataHook,
191
214
  trackingEl,
@@ -205,6 +228,7 @@ const TypographyHeading = React.forwardRef<
205
228
  color,
206
229
  align,
207
230
  tabular,
231
+ truncate,
208
232
  }),
209
233
  className
210
234
  )}