@brightlocal/ui-components 3.1.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 (176) hide show
  1. package/README.md +6 -1
  2. package/component-meta.json +663 -38
  3. package/deprecations.json +1 -1
  4. package/dist/alert-dialog.cjs +1 -1
  5. package/dist/alert-dialog.d.ts +32 -3
  6. package/dist/alert-dialog.d.ts.map +1 -1
  7. package/dist/alert-dialog.js +61 -58
  8. package/dist/alert.cjs +1 -1
  9. package/dist/alert.d.ts.map +1 -1
  10. package/dist/alert.js +58 -57
  11. package/dist/badge.cjs +1 -1
  12. package/dist/badge.d.ts +9 -0
  13. package/dist/badge.d.ts.map +1 -1
  14. package/dist/badge.js +50 -30
  15. package/dist/banner.cjs +1 -0
  16. package/dist/banner.d.ts +81 -0
  17. package/dist/banner.d.ts.map +1 -0
  18. package/dist/banner.js +176 -0
  19. package/dist/blocks/empty-state.cjs +1 -1
  20. package/dist/blocks/empty-state.d.ts +4 -3
  21. package/dist/blocks/empty-state.d.ts.map +1 -1
  22. package/dist/blocks/empty-state.js +21 -20
  23. package/dist/blocks/progress-state.d.ts +2 -2
  24. package/dist/blocks/sidebar.cjs +1 -1
  25. package/dist/blocks/sidebar.d.ts +17 -0
  26. package/dist/blocks/sidebar.d.ts.map +1 -1
  27. package/dist/blocks/sidebar.js +8 -2
  28. package/dist/brand-illustration-motif.d.ts +1 -1
  29. package/dist/card.cjs +1 -1
  30. package/dist/card.d.ts +86 -6
  31. package/dist/card.d.ts.map +1 -1
  32. package/dist/card.js +185 -96
  33. package/dist/chart.cjs +3 -3
  34. package/dist/chart.d.ts +231 -13
  35. package/dist/chart.d.ts.map +1 -1
  36. package/dist/chart.js +466 -306
  37. package/dist/checkbox.cjs +1 -1
  38. package/dist/checkbox.d.ts +1 -1
  39. package/dist/checkbox.d.ts.map +1 -1
  40. package/dist/checkbox.js +2 -1
  41. package/dist/combobox.cjs +1 -1
  42. package/dist/combobox.js +2 -2
  43. package/dist/command.cjs +1 -1
  44. package/dist/command.js +1 -1
  45. package/dist/data-table.cjs +1 -1
  46. package/dist/data-table.d.ts +169 -22
  47. package/dist/data-table.d.ts.map +1 -1
  48. package/dist/data-table.js +695 -561
  49. package/dist/grid.d.ts +24 -1
  50. package/dist/grid.d.ts.map +1 -1
  51. package/dist/hooks/use-breakpoint.cjs +1 -1
  52. package/dist/hooks/use-breakpoint.d.ts +1 -1
  53. package/dist/hooks/use-breakpoint.d.ts.map +1 -1
  54. package/dist/hooks/use-breakpoint.js +1 -0
  55. package/dist/index.cjs +1 -1
  56. package/dist/index.d.ts +5 -0
  57. package/dist/index.d.ts.map +1 -1
  58. package/dist/index.js +593 -561
  59. package/dist/info-tooltip.cjs +1 -0
  60. package/dist/info-tooltip.d.ts +39 -0
  61. package/dist/info-tooltip.d.ts.map +1 -0
  62. package/dist/info-tooltip.js +41 -0
  63. package/dist/input-chip.cjs +1 -1
  64. package/dist/input-chip.js +1 -1
  65. package/dist/input-group.cjs +1 -1
  66. package/dist/input-group.d.ts +33 -2
  67. package/dist/input-group.d.ts.map +1 -1
  68. package/dist/input-group.js +167 -54
  69. package/dist/input-otp.cjs +1 -1
  70. package/dist/input-otp.js +9 -9
  71. package/dist/input-password.cjs +1 -1
  72. package/dist/input-password.d.ts +28 -6
  73. package/dist/input-password.d.ts.map +1 -1
  74. package/dist/input-password.js +5 -5
  75. package/dist/input.cjs +1 -1
  76. package/dist/input.js +10 -10
  77. package/dist/lib/block-illustration.cjs +1 -1
  78. package/dist/lib/block-illustration.d.ts +4 -1
  79. package/dist/lib/block-illustration.d.ts.map +1 -1
  80. package/dist/lib/block-illustration.js +12 -11
  81. package/dist/lib/utils.cjs +1 -1
  82. package/dist/lib/utils.d.ts.map +1 -1
  83. package/dist/lib/utils.js +4 -3
  84. package/dist/list.cjs +1 -1
  85. package/dist/list.js +1 -1
  86. package/dist/multi-select-filter.cjs +1 -0
  87. package/dist/multi-select-filter.d.ts +178 -0
  88. package/dist/multi-select-filter.d.ts.map +1 -0
  89. package/dist/multi-select-filter.js +463 -0
  90. package/dist/progress.cjs +1 -1
  91. package/dist/progress.d.ts +123 -16
  92. package/dist/progress.d.ts.map +1 -1
  93. package/dist/progress.js +89 -75
  94. package/dist/rating.cjs +1 -1
  95. package/dist/rating.js +18 -18
  96. package/dist/relative-date.cjs +1 -0
  97. package/dist/relative-date.d.ts +65 -0
  98. package/dist/relative-date.d.ts.map +1 -0
  99. package/dist/relative-date.js +128 -0
  100. package/dist/select.cjs +2 -2
  101. package/dist/select.d.ts +11 -1
  102. package/dist/select.d.ts.map +1 -1
  103. package/dist/select.js +97 -81
  104. package/dist/sheet.cjs +1 -1
  105. package/dist/sheet.d.ts +78 -2
  106. package/dist/sheet.d.ts.map +1 -1
  107. package/dist/sheet.js +192 -85
  108. package/dist/single-select-filter.cjs +1 -0
  109. package/dist/single-select-filter.d.ts +81 -0
  110. package/dist/single-select-filter.d.ts.map +1 -0
  111. package/dist/single-select-filter.js +226 -0
  112. package/dist/sonner.cjs +1 -1
  113. package/dist/sonner.d.ts.map +1 -1
  114. package/dist/sonner.js +22 -22
  115. package/dist/split-layout.cjs +1 -1
  116. package/dist/split-layout.d.ts +1 -1
  117. package/dist/split-layout.js +13 -13
  118. package/dist/table.cjs +1 -1
  119. package/dist/table.d.ts +45 -4
  120. package/dist/table.d.ts.map +1 -1
  121. package/dist/table.js +90 -73
  122. package/dist/tabs.cjs +1 -1
  123. package/dist/tabs.d.ts +12 -1
  124. package/dist/tabs.d.ts.map +1 -1
  125. package/dist/tabs.js +148 -126
  126. package/dist/textarea.cjs +1 -1
  127. package/dist/textarea.js +1 -1
  128. package/dist/tooltip.cjs +1 -1
  129. package/dist/tooltip.d.ts +38 -36
  130. package/dist/tooltip.d.ts.map +1 -1
  131. package/dist/tooltip.js +262 -73
  132. package/dist/typography-text.d.ts +1 -2
  133. package/dist/typography-text.d.ts.map +1 -1
  134. package/dist/typography.d.ts +1 -1
  135. package/package.json +5 -6
  136. package/src/blocks/empty-state.tsx +8 -3
  137. package/src/blocks/progress-state.tsx +2 -2
  138. package/src/blocks/sidebar.tsx +26 -2
  139. package/src/components/alert-dialog.tsx +50 -5
  140. package/src/components/alert.tsx +16 -8
  141. package/src/components/badge.tsx +40 -3
  142. package/src/components/banner.tsx +288 -0
  143. package/src/components/brand-illustration-motif.tsx +1 -1
  144. package/src/components/card.tsx +211 -24
  145. package/src/components/chart.tsx +523 -35
  146. package/src/components/checkbox.tsx +1 -1
  147. package/src/components/combobox.tsx +2 -2
  148. package/src/components/command.tsx +1 -1
  149. package/src/components/data-table.tsx +778 -195
  150. package/src/components/grid.tsx +32 -1
  151. package/src/components/info-tooltip.tsx +94 -0
  152. package/src/components/input-chip.tsx +1 -1
  153. package/src/components/input-group.tsx +246 -11
  154. package/src/components/input-otp.tsx +1 -1
  155. package/src/components/input-password.tsx +33 -11
  156. package/src/components/input.tsx +1 -1
  157. package/src/components/list.tsx +1 -1
  158. package/src/components/multi-select-filter.tsx +912 -0
  159. package/src/components/progress.tsx +190 -31
  160. package/src/components/rating.tsx +1 -1
  161. package/src/components/relative-date.tsx +230 -0
  162. package/src/components/select.tsx +35 -5
  163. package/src/components/sheet.tsx +240 -4
  164. package/src/components/single-select-filter.tsx +443 -0
  165. package/src/components/sonner.tsx +16 -5
  166. package/src/components/split-layout.tsx +2 -2
  167. package/src/components/table.tsx +71 -11
  168. package/src/components/tabs.tsx +93 -46
  169. package/src/components/textarea.tsx +1 -1
  170. package/src/components/tooltip.tsx +440 -68
  171. package/src/components/typography-text.tsx +1 -2
  172. package/src/components/typography.tsx +1 -1
  173. package/src/hooks/use-breakpoint.ts +2 -1
  174. package/src/index.ts +5 -0
  175. package/src/lib/block-illustration.tsx +5 -1
  176. 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
  );
@@ -14,8 +14,7 @@ import { cn } from "@brightlocal/ui-components/lib/utils";
14
14
  * proportional; add `tabular` where metrics sit in a column or the value
15
15
  * updates in place.
16
16
  * - `code` — Geist Mono 400 · 16/24. IDs, keys, coordinates a user copies verbatim.
17
- * Inside a sentence use the `text-code-inline` utility on a `code` element instead
18
- * (0.9em, inherits the line's height).
17
+ * Inside a sentence use `text-code-inline` on a `code` element instead (deprecated alias — 0.9em, inherits the line's height).
19
18
  *
20
19
  * There are no standalone label variants on purpose: the `text-label` /
21
20
  * `text-label-sm` tokens are reserved for control-owning components
@@ -431,7 +431,7 @@ interface TypographyInlineCodeProps
431
431
  /**
432
432
  * Inline code component for code snippets within text.
433
433
  * Displays with monospace font and muted background.
434
- * @deprecated Use `<code className="text-code-inline">` inside a sentence (0.9em, inherits the line's height — semantic type scale, DS-714).
434
+ * @deprecated Use `<code className="text-code-inline">` inside a sentence (semantic type scale, DS-714).
435
435
  */
436
436
  const TypographyInlineCode = React.forwardRef<
437
437
  HTMLElement,
@@ -3,10 +3,11 @@ import * as React from "react";
3
3
  /**
4
4
  * Breakpoint name matching design token keys from `@brightlocal/tokens/breakpoints`.
5
5
  */
6
- type Breakpoint = "sm" | "md" | "lg" | "xl" | "2xl";
6
+ type Breakpoint = "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
7
7
 
8
8
  /** Fallback values when CSS variables are not available (e.g. SSR) */
9
9
  const BREAKPOINT_FALLBACKS: Record<Breakpoint, number> = {
10
+ xs: 480,
10
11
  sm: 640,
11
12
  md: 768,
12
13
  lg: 1024,
package/src/index.ts CHANGED
@@ -5,6 +5,7 @@ export * from "./components/alert-dialog";
5
5
  export * from "./components/aspect-ratio";
6
6
  export * from "./components/avatar";
7
7
  export * from "./components/badge";
8
+ export * from "./components/banner";
8
9
  export * from "./components/brand-illustration-motif";
9
10
  export * from "./components/breadcrumb";
10
11
  export * from "./components/button";
@@ -36,6 +37,7 @@ export * from "./components/grid";
36
37
  export * from "./components/header";
37
38
  export * from "./components/height-transition";
38
39
  export * from "./components/hover-card";
40
+ export * from "./components/info-tooltip";
39
41
  export * from "./components/input";
40
42
  export * from "./components/input-chip";
41
43
  export * from "./components/input-group";
@@ -48,6 +50,7 @@ export * from "./components/logo";
48
50
  export * from "./components/map";
49
51
  export * from "./components/media-empty";
50
52
  export * from "./components/menubar";
53
+ export * from "./components/multi-select-filter";
51
54
  export * from "./components/navigation-menu";
52
55
  export * from "./components/pagination";
53
56
  export * from "./components/input-password";
@@ -55,12 +58,14 @@ export * from "./components/popover";
55
58
  export * from "./components/progress";
56
59
  export * from "./components/radio-group";
57
60
  export * from "./components/rating";
61
+ export * from "./components/relative-date";
58
62
  export * from "./components/resizable";
59
63
  export * from "./components/route-progress";
60
64
  export * from "./components/scroll-area";
61
65
  export * from "./components/select";
62
66
  export * from "./components/separator";
63
67
  export * from "./components/sheet";
68
+ export * from "./components/single-select-filter";
64
69
  export * from "./components/skeleton";
65
70
  export * from "./components/slider";
66
71
  export * from "./components/sonner";
@@ -1,4 +1,5 @@
1
1
  import * as React from "react";
2
+ import { ILLUSTRATION_SIZES } from "@brightlocal/illustrations";
2
3
 
3
4
  /* -------------------------------------------------------------------------------------------------
4
5
  * BlockIllustration (internal)
@@ -38,8 +39,11 @@ import * as React from "react";
38
39
  * The artwork is the title's companion, not the subject of the screen: much
39
40
  * larger and it outweighs the 24px heading under it, and the eye lands on the
40
41
  * drawing instead of the words that say what to do next.
42
+ *
43
+ * This is the `md` step of the shared illustration scale, so a consumer who
44
+ * places the same artwork by hand with `size="md"` gets the identical size.
41
45
  */
42
- const BLOCK_ILLUSTRATION_SIZE = 130;
46
+ const BLOCK_ILLUSTRATION_SIZE = ILLUSTRATION_SIZES.md;
43
47
 
44
48
  /**
45
49
  * Props for the internal BlockIllustration wrapper.