@brightlocal/ui-components 3.4.0 → 3.5.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 (196) hide show
  1. package/AI_USAGE.md +22 -3
  2. package/README.md +177 -109
  3. package/component-meta.json +1061 -102
  4. package/dist/alert-dialog.cjs +1 -1
  5. package/dist/alert-dialog.d.ts +13 -2
  6. package/dist/alert-dialog.d.ts.map +1 -1
  7. package/dist/alert-dialog.js +4 -3
  8. package/dist/banner.cjs +1 -1
  9. package/dist/banner.d.ts +47 -11
  10. package/dist/banner.d.ts.map +1 -1
  11. package/dist/banner.js +156 -79
  12. package/dist/blocks/empty-state.cjs +1 -1
  13. package/dist/blocks/empty-state.d.ts +40 -5
  14. package/dist/blocks/empty-state.d.ts.map +1 -1
  15. package/dist/blocks/empty-state.js +59 -52
  16. package/dist/blocks/input-list.d.ts +1 -0
  17. package/dist/blocks/input-list.d.ts.map +1 -1
  18. package/dist/blocks/sidebar.cjs +1 -1
  19. package/dist/blocks/sidebar.d.ts +12 -6
  20. package/dist/blocks/sidebar.d.ts.map +1 -1
  21. package/dist/blocks/sidebar.js +64 -63
  22. package/dist/button.cjs +1 -1
  23. package/dist/button.d.ts.map +1 -1
  24. package/dist/button.js +47 -43
  25. package/dist/card.cjs +1 -1
  26. package/dist/card.d.ts +12 -0
  27. package/dist/card.d.ts.map +1 -1
  28. package/dist/card.js +115 -97
  29. package/dist/chart.cjs +6 -6
  30. package/dist/chart.d.ts +6 -10
  31. package/dist/chart.d.ts.map +1 -1
  32. package/dist/chart.js +281 -296
  33. package/dist/combobox.cjs +3 -3
  34. package/dist/combobox.d.ts.map +1 -1
  35. package/dist/combobox.js +430 -343
  36. package/dist/command.cjs +1 -1
  37. package/dist/command.d.ts +23 -2
  38. package/dist/command.d.ts.map +1 -1
  39. package/dist/command.js +212 -207
  40. package/dist/count-indicator.cjs +1 -0
  41. package/dist/count-indicator.d.ts +85 -0
  42. package/dist/count-indicator.d.ts.map +1 -0
  43. package/dist/count-indicator.js +72 -0
  44. package/dist/data-table.cjs +1 -1
  45. package/dist/data-table.d.ts +101 -11
  46. package/dist/data-table.d.ts.map +1 -1
  47. package/dist/data-table.js +593 -523
  48. package/dist/dialog.cjs +1 -1
  49. package/dist/dialog.d.ts +26 -3
  50. package/dist/dialog.d.ts.map +1 -1
  51. package/dist/dialog.js +62 -47
  52. package/dist/drawer.cjs +1 -1
  53. package/dist/drawer.d.ts +8 -4
  54. package/dist/drawer.d.ts.map +1 -1
  55. package/dist/drawer.js +37 -38
  56. package/dist/file-upload.cjs +1 -0
  57. package/dist/file-upload.d.ts +546 -0
  58. package/dist/file-upload.d.ts.map +1 -0
  59. package/dist/file-upload.js +1103 -0
  60. package/dist/global-layout.cjs +1 -1
  61. package/dist/global-layout.d.ts +7 -2
  62. package/dist/global-layout.d.ts.map +1 -1
  63. package/dist/global-layout.js +52 -52
  64. package/dist/hooks/use-file-dropzone.cjs +1 -0
  65. package/dist/hooks/use-file-dropzone.d.ts +75 -0
  66. package/dist/hooks/use-file-dropzone.d.ts.map +1 -0
  67. package/dist/hooks/use-file-dropzone.js +133 -0
  68. package/dist/hover-card.cjs +1 -1
  69. package/dist/hover-card.d.ts +29 -16
  70. package/dist/hover-card.d.ts.map +1 -1
  71. package/dist/hover-card.js +153 -36
  72. package/dist/index.cjs +1 -1
  73. package/dist/index.d.ts +3 -0
  74. package/dist/index.d.ts.map +1 -1
  75. package/dist/index.js +676 -640
  76. package/dist/input-chip.cjs +1 -1
  77. package/dist/input-chip.d.ts +30 -1
  78. package/dist/input-chip.d.ts.map +1 -1
  79. package/dist/input-chip.js +131 -115
  80. package/dist/input-group.cjs +1 -1
  81. package/dist/input-group.d.ts +37 -2
  82. package/dist/input-group.d.ts.map +1 -1
  83. package/dist/input-group.js +131 -114
  84. package/dist/input-password.cjs +1 -1
  85. package/dist/input-password.js +6 -6
  86. package/dist/lib/empty-canvas.cjs +1 -1
  87. package/dist/lib/empty-canvas.d.ts +27 -1
  88. package/dist/lib/empty-canvas.d.ts.map +1 -1
  89. package/dist/lib/empty-canvas.js +27 -23
  90. package/dist/lib/empty-chip.cjs +1 -1
  91. package/dist/lib/empty-chip.d.ts +19 -2
  92. package/dist/lib/empty-chip.d.ts.map +1 -1
  93. package/dist/lib/empty-chip.js +14 -9
  94. package/dist/lib/field-aria.cjs +1 -1
  95. package/dist/lib/field-aria.d.ts +4 -4
  96. package/dist/lib/field-aria.d.ts.map +1 -1
  97. package/dist/lib/field-aria.js +7 -5
  98. package/dist/lib/media-viewer-content.cjs +1 -1
  99. package/dist/lib/media-viewer-content.js +1 -1
  100. package/dist/lib/table-internal.cjs +1 -1
  101. package/dist/lib/table-internal.d.ts +19 -0
  102. package/dist/lib/table-internal.d.ts.map +1 -1
  103. package/dist/lib/table-internal.js +22 -7
  104. package/dist/list.cjs +1 -1
  105. package/dist/list.d.ts +13 -0
  106. package/dist/list.d.ts.map +1 -1
  107. package/dist/list.js +103 -82
  108. package/dist/logo-mark.cjs +1 -1
  109. package/dist/logo-mark.d.ts +18 -2
  110. package/dist/logo-mark.d.ts.map +1 -1
  111. package/dist/logo-mark.js +159 -79
  112. package/dist/media-empty.cjs +1 -1
  113. package/dist/media-empty.d.ts +50 -7
  114. package/dist/media-empty.d.ts.map +1 -1
  115. package/dist/media-empty.js +14 -13
  116. package/dist/media-viewer.cjs +1 -1
  117. package/dist/media-viewer.js +6 -6
  118. package/dist/multi-select-filter.cjs +1 -1
  119. package/dist/multi-select-filter.d.ts.map +1 -1
  120. package/dist/multi-select-filter.js +92 -101
  121. package/dist/pagination.cjs +1 -1
  122. package/dist/pagination.d.ts +11 -0
  123. package/dist/pagination.d.ts.map +1 -1
  124. package/dist/pagination.js +17 -17
  125. package/dist/relative-date.d.ts +6 -0
  126. package/dist/relative-date.d.ts.map +1 -1
  127. package/dist/resizable.d.ts +1 -1
  128. package/dist/result-count.cjs +1 -1
  129. package/dist/result-count.d.ts +13 -16
  130. package/dist/result-count.d.ts.map +1 -1
  131. package/dist/result-count.js +24 -33
  132. package/dist/sheet.cjs +1 -1
  133. package/dist/sheet.d.ts +22 -3
  134. package/dist/sheet.d.ts.map +1 -1
  135. package/dist/sheet.js +152 -125
  136. package/dist/single-select-filter.cjs +1 -1
  137. package/dist/single-select-filter.d.ts.map +1 -1
  138. package/dist/single-select-filter.js +67 -76
  139. package/dist/table.cjs +1 -1
  140. package/dist/table.d.ts.map +1 -1
  141. package/dist/table.js +77 -76
  142. package/dist/tabs.cjs +1 -1
  143. package/dist/tabs.d.ts +39 -3
  144. package/dist/tabs.d.ts.map +1 -1
  145. package/dist/tabs.js +127 -76
  146. package/dist/textarea.cjs +1 -1
  147. package/dist/textarea.d.ts +34 -0
  148. package/dist/textarea.d.ts.map +1 -1
  149. package/dist/textarea.js +115 -19
  150. package/dist/tooltip.cjs +1 -1
  151. package/dist/tooltip.d.ts.map +1 -1
  152. package/dist/tooltip.js +137 -131
  153. package/dist/typography-text.cjs +1 -1
  154. package/dist/typography-text.d.ts +6 -2
  155. package/dist/typography-text.d.ts.map +1 -1
  156. package/dist/typography-text.js +14 -13
  157. package/package.json +3 -4
  158. package/src/blocks/empty-state.tsx +108 -48
  159. package/src/blocks/input-list.tsx +1 -0
  160. package/src/blocks/sidebar.tsx +39 -16
  161. package/src/components/alert-dialog.tsx +18 -2
  162. package/src/components/banner.tsx +247 -68
  163. package/src/components/button.tsx +27 -10
  164. package/src/components/card.tsx +89 -7
  165. package/src/components/chart.tsx +47 -67
  166. package/src/components/combobox.tsx +221 -12
  167. package/src/components/command.tsx +83 -37
  168. package/src/components/count-indicator.tsx +188 -0
  169. package/src/components/data-table.tsx +506 -159
  170. package/src/components/dialog.tsx +74 -5
  171. package/src/components/drawer.tsx +52 -32
  172. package/src/components/file-upload.tsx +2574 -0
  173. package/src/components/global-layout.tsx +18 -5
  174. package/src/components/hover-card.tsx +395 -65
  175. package/src/components/input-chip.tsx +67 -2
  176. package/src/components/input-group.tsx +89 -6
  177. package/src/components/list.tsx +40 -3
  178. package/src/components/logo-mark.tsx +109 -25
  179. package/src/components/media-empty.tsx +62 -7
  180. package/src/components/multi-select-filter.tsx +9 -16
  181. package/src/components/pagination.tsx +15 -2
  182. package/src/components/relative-date.tsx +6 -0
  183. package/src/components/result-count.tsx +27 -54
  184. package/src/components/sheet.tsx +86 -8
  185. package/src/components/single-select-filter.tsx +9 -16
  186. package/src/components/table.tsx +16 -1
  187. package/src/components/tabs.tsx +223 -41
  188. package/src/components/textarea.tsx +271 -4
  189. package/src/components/tooltip.tsx +29 -2
  190. package/src/components/typography-text.tsx +7 -2
  191. package/src/hooks/use-file-dropzone.ts +325 -0
  192. package/src/index.ts +3 -0
  193. package/src/lib/empty-canvas.tsx +47 -20
  194. package/src/lib/empty-chip.tsx +38 -3
  195. package/src/lib/field-aria.tsx +11 -6
  196. package/src/lib/table-internal.ts +38 -0
@@ -135,7 +135,10 @@ interface GlobalLayoutContentProps extends React.ComponentProps<"div"> {
135
135
  */
136
136
  dataHook?: string;
137
137
  /**
138
- * Maximum width of the content area. Use `breakpoint` tokens from `@brightlocal/tokens/breakpoints`.
138
+ * Maximum width of the content column. Use `breakpoint` tokens from `@brightlocal/tokens/breakpoints`.
139
+ * The page header (`GlobalLayoutContentHeader`), a standalone
140
+ * `GlobalLayoutActions` row and `GlobalLayoutBody` all follow it, so the
141
+ * title lines up with the cards below at every width.
139
142
  * @default breakpoint.lg
140
143
  */
141
144
  maxWidth?: string | number;
@@ -194,6 +197,14 @@ GlobalLayoutContent.displayName = "GlobalLayoutContent";
194
197
  // the full width.
195
198
  const CONTENT_REGION_PX = "px-4 md:px-6 lg:px-section-xs";
196
199
 
200
+ // Max width of the header and standalone actions columns. Like
201
+ // GlobalLayoutBody, they read the `--content-max-width` that
202
+ // GlobalLayoutContent sets from its `maxWidth` prop, so the page title, the
203
+ // action row and the cards below share one column at every width (DS-1248).
204
+ // The fallback keeps the header and the standalone actions row at the lg
205
+ // breakpoint when rendered outside GlobalLayoutContent.
206
+ const CONTENT_MAX_WIDTH = "var(--content-max-width, var(--ds-breakpoint-lg))";
207
+
197
208
  interface GlobalLayoutBackLinkCommonProps {
198
209
  /**
199
210
  * Data hook for automated testing
@@ -439,7 +450,9 @@ interface GlobalLayoutContentHeaderProps extends React.ComponentProps<"header">
439
450
  /**
440
451
  * Page header for the content area. Slots direct children (back link, image,
441
452
  * breadcrumb, subtitle, actions) around the title row per the Figma Page
442
- * Header design.
453
+ * Header design. Its column follows the `maxWidth` set on
454
+ * `GlobalLayoutContent`, so it is always as wide as `GlobalLayoutBody` — no
455
+ * `maxWidth` override needed (DS-1248).
443
456
  *
444
457
  * The consumer-supplied page title must be `TypographyHeading level={1}
445
458
  * variant="page"` so it sits on the semantic type scale's
@@ -525,7 +538,7 @@ const GlobalLayoutContentHeader = React.forwardRef<
525
538
  )}
526
539
  data-slot="content-header"
527
540
  dataHook={dataHook}
528
- style={{ maxWidth: "var(--ds-breakpoint-lg)" }}
541
+ style={{ maxWidth: CONTENT_MAX_WIDTH }}
529
542
  trackingEl={trackingEl}
530
543
  trackingLabel={trackingLabel}
531
544
  {...props}
@@ -548,7 +561,7 @@ const GlobalLayoutContentHeader = React.forwardRef<
548
561
  className={cn("mx-auto w-full items-start gap-4", className)}
549
562
  data-slot="content-header"
550
563
  dataHook={dataHook}
551
- style={{ maxWidth: "var(--ds-breakpoint-lg)" }}
564
+ style={{ maxWidth: CONTENT_MAX_WIDTH }}
552
565
  trackingEl={trackingEl}
553
566
  trackingLabel={trackingLabel}
554
567
  {...props}
@@ -652,7 +665,7 @@ const GlobalLayoutActions = React.forwardRef<
652
665
  data-slot="content-actions"
653
666
  data-tracking-el={trackingEl}
654
667
  data-tracking-label={trackingLabel}
655
- style={inHeader ? undefined : { maxWidth: "var(--ds-breakpoint-lg)" }}
668
+ style={inHeader ? undefined : { maxWidth: CONTENT_MAX_WIDTH }}
656
669
  {...props}
657
670
  >
658
671
  {children}
@@ -1,61 +1,289 @@
1
1
  "use client";
2
2
 
3
3
  import * as React from "react";
4
- import * as HoverCardPrimitive from "@radix-ui/react-hover-card";
4
+ import * as PopoverPrimitive from "@radix-ui/react-popover";
5
+ import { Slot } from "@radix-ui/react-slot";
6
+
7
+ import { composeEventHandlers } from "../lib/compose-event-handlers";
5
8
  import {
6
9
  cn,
7
10
  FLOATING_CONTENT_ANIMATION,
8
11
  } from "@brightlocal/ui-components/lib/utils";
9
12
 
13
+ /* ----------------------------- HoverCard context --------------------------- */
14
+
15
+ /**
16
+ * How the currently open hover card was opened:
17
+ * - `hover` — pointer enter/leave and keyboard focus/blur control it.
18
+ * - `touch` — opened by a tap; stays open so text can be selected and copied;
19
+ * closes on a second tap, an outside tap, or Escape.
20
+ */
21
+ type HoverCardInteractionMode = "hover" | "touch";
22
+
23
+ interface HoverCardContextValue {
24
+ open: boolean;
25
+ triggerRef: React.RefObject<HTMLElement | null>;
26
+ onTriggerPointerEnter: (e: React.PointerEvent) => void;
27
+ onTriggerPointerLeave: (e: React.PointerEvent) => void;
28
+ onTriggerPointerDown: (e: React.PointerEvent) => void;
29
+ onTriggerPointerCancel: () => void;
30
+ onTriggerClick: () => void;
31
+ onTriggerFocus: () => void;
32
+ onTriggerBlur: () => void;
33
+ onContentPointerEnter: () => void;
34
+ onContentPointerLeave: (e: React.PointerEvent) => void;
35
+ onContentInteractOutside: (
36
+ e: Parameters<
37
+ NonNullable<
38
+ React.ComponentProps<
39
+ typeof PopoverPrimitive.Content
40
+ >["onInteractOutside"]
41
+ >
42
+ >[0]
43
+ ) => void;
44
+ }
45
+
46
+ const HoverCardContext = React.createContext<HoverCardContextValue | null>(
47
+ null
48
+ );
49
+
50
+ function useHoverCardContext() {
51
+ const ctx = React.useContext(HoverCardContext);
52
+ if (!ctx) {
53
+ throw new Error("HoverCard components must be used within <HoverCard>");
54
+ }
55
+ return ctx;
56
+ }
57
+
58
+ /* ------------------------------ HoverCard root ----------------------------- */
59
+
10
60
  /**
11
61
  * HoverCard props
12
62
  */
13
- export interface HoverCardProps extends React.ComponentProps<
14
- typeof HoverCardPrimitive.Root
15
- > {
63
+ export interface HoverCardProps {
16
64
  /**
17
- * Time in milliseconds to delay opening the hover card
65
+ * Time in milliseconds to delay opening the hover card.
18
66
  * @default 300
19
67
  */
20
68
  openDelay?: number;
21
69
  /**
22
- * Time in milliseconds to delay closing the hover card
70
+ * Time in milliseconds to delay closing the hover card. Also serves as the
71
+ * grace period when moving the pointer from trigger to content.
23
72
  * @default 300
24
73
  */
25
74
  closeDelay?: number;
75
+ /** Controlled open state */
76
+ open?: boolean;
77
+ /** Initial open state for uncontrolled mode */
78
+ defaultOpen?: boolean;
79
+ /** Callback when open state changes */
80
+ onOpenChange?: (open: boolean) => void;
81
+ children: React.ReactNode;
26
82
  }
27
83
 
28
84
  /**
29
- * HoverCard - A component that displays content on hover
30
- *
31
- * Based on Radix UI Hover Card primitive
32
- * @see https://www.radix-ui.com/docs/primitives/components/hover-card
85
+ * HoverCard — a card that appears on hover, with touch support.
33
86
  *
34
- * Default timing:
35
- * - openDelay: 300ms
36
- * - closeDelay: 300ms
87
+ * Behavior by input type:
88
+ * - **Mouse / pen / keyboard**: opens on hover or focus after `openDelay`, closes
89
+ * after `closeDelay` when the pointer leaves (the delay doubles as a grace period
90
+ * so the pointer can move from trigger to content without closing).
91
+ * - **Touch**: a tap toggles it open/closed. While open the card ignores hover/blur
92
+ * so its text can be long-pressed and copied; it closes on a second tap of the
93
+ * trigger, a tap outside, or Escape.
37
94
  */
38
95
  function HoverCard({
39
96
  openDelay = 300,
40
97
  closeDelay = 300,
41
- ...props
98
+ open: controlledOpen,
99
+ defaultOpen = false,
100
+ onOpenChange,
101
+ children,
42
102
  }: HoverCardProps) {
43
- // Note: HoverCardPrimitive.Root is a context provider that doesn't render to DOM
44
- // Data attributes should be placed on HoverCardContent instead
103
+ const [uncontrolledOpen, setUncontrolledOpen] = React.useState(
104
+ defaultOpen ?? false
105
+ );
106
+ const isControlled = controlledOpen !== undefined;
107
+ const open = isControlled ? controlledOpen : uncontrolledOpen;
108
+
109
+ const openTimer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
110
+ const closeTimer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
111
+ const triggerRef = React.useRef<HTMLElement | null>(null);
112
+ const mode = React.useRef<HoverCardInteractionMode>("hover");
113
+ /**
114
+ * Pointer type of a press on the trigger that hasn't produced its click yet.
115
+ * Focus fired by that press must not open the card (touch: the click toggles;
116
+ * mouse: hover already did), only a real keyboard focus may.
117
+ */
118
+ const pendingPress = React.useRef<"touch" | "mouse" | null>(null);
119
+
120
+ const setOpen = React.useCallback(
121
+ (value: boolean) => {
122
+ if (!value) mode.current = "hover";
123
+ if (!isControlled) setUncontrolledOpen(value);
124
+ onOpenChange?.(value);
125
+ },
126
+ [isControlled, onOpenChange]
127
+ );
128
+
129
+ const clearTimers = React.useCallback(() => {
130
+ if (openTimer.current !== undefined) {
131
+ clearTimeout(openTimer.current);
132
+ openTimer.current = undefined;
133
+ }
134
+ if (closeTimer.current !== undefined) {
135
+ clearTimeout(closeTimer.current);
136
+ closeTimer.current = undefined;
137
+ }
138
+ }, []);
139
+
140
+ React.useEffect(() => clearTimers, [clearTimers]);
141
+
142
+ const openFromHover = React.useCallback(() => {
143
+ clearTimers();
144
+ if (mode.current === "touch") {
145
+ if (open) return;
146
+ mode.current = "hover";
147
+ }
148
+ if (openDelay > 0) {
149
+ openTimer.current = setTimeout(() => setOpen(true), openDelay);
150
+ } else {
151
+ setOpen(true);
152
+ }
153
+ }, [clearTimers, openDelay, open, setOpen]);
154
+
155
+ const closeFromHover = React.useCallback(() => {
156
+ clearTimers();
157
+ if (mode.current === "touch" && open) return;
158
+ if (closeDelay > 0) {
159
+ closeTimer.current = setTimeout(() => setOpen(false), closeDelay);
160
+ } else {
161
+ setOpen(false);
162
+ }
163
+ }, [clearTimers, closeDelay, open, setOpen]);
164
+
165
+ const onTriggerPointerEnter = React.useCallback(
166
+ (e: React.PointerEvent) => {
167
+ if (e.pointerType === "touch") return;
168
+ openFromHover();
169
+ },
170
+ [openFromHover]
171
+ );
172
+
173
+ const onTriggerPointerLeave = React.useCallback(
174
+ (e: React.PointerEvent) => {
175
+ if (e.pointerType === "touch") return;
176
+ pendingPress.current = null;
177
+ closeFromHover();
178
+ },
179
+ [closeFromHover]
180
+ );
181
+
182
+ const onTriggerPointerDown = React.useCallback((e: React.PointerEvent) => {
183
+ pendingPress.current = e.pointerType === "touch" ? "touch" : "mouse";
184
+ }, []);
185
+
186
+ const onTriggerPointerCancel = React.useCallback(() => {
187
+ pendingPress.current = null;
188
+ }, []);
189
+
190
+ const onTriggerClick = React.useCallback(() => {
191
+ const press = pendingPress.current;
192
+ pendingPress.current = null;
193
+ if (press !== "touch") return;
194
+ clearTimers();
195
+ if (open) {
196
+ setOpen(false);
197
+ } else {
198
+ mode.current = "touch";
199
+ setOpen(true);
200
+ }
201
+ }, [clearTimers, open, setOpen]);
202
+
203
+ const onTriggerFocus = React.useCallback(() => {
204
+ if (pendingPress.current) return;
205
+ openFromHover();
206
+ }, [openFromHover]);
207
+
208
+ const onTriggerBlur = React.useCallback(() => {
209
+ closeFromHover();
210
+ }, [closeFromHover]);
211
+
212
+ const onContentPointerEnter = React.useCallback(() => {
213
+ clearTimers();
214
+ }, [clearTimers]);
215
+
216
+ const onContentPointerLeave = React.useCallback(
217
+ (e: React.PointerEvent) => {
218
+ if (e.pointerType === "touch") return;
219
+ closeFromHover();
220
+ },
221
+ [closeFromHover]
222
+ );
223
+
224
+ const onContentInteractOutside = React.useCallback<
225
+ HoverCardContextValue["onContentInteractOutside"]
226
+ >((e) => {
227
+ const target = e.target;
228
+ if (target instanceof Node && triggerRef.current?.contains(target)) {
229
+ e.preventDefault();
230
+ }
231
+ }, []);
232
+
233
+ const handlePopoverOpenChange = React.useCallback(
234
+ (newOpen: boolean) => {
235
+ if (!newOpen) {
236
+ clearTimers();
237
+ setOpen(false);
238
+ }
239
+ },
240
+ [clearTimers, setOpen]
241
+ );
242
+
243
+ const contextValue = React.useMemo<HoverCardContextValue>(
244
+ () => ({
245
+ open,
246
+ triggerRef,
247
+ onTriggerPointerEnter,
248
+ onTriggerPointerLeave,
249
+ onTriggerPointerDown,
250
+ onTriggerPointerCancel,
251
+ onTriggerClick,
252
+ onTriggerFocus,
253
+ onTriggerBlur,
254
+ onContentPointerEnter,
255
+ onContentPointerLeave,
256
+ onContentInteractOutside,
257
+ }),
258
+ [
259
+ open,
260
+ onTriggerPointerEnter,
261
+ onTriggerPointerLeave,
262
+ onTriggerPointerDown,
263
+ onTriggerPointerCancel,
264
+ onTriggerClick,
265
+ onTriggerFocus,
266
+ onTriggerBlur,
267
+ onContentPointerEnter,
268
+ onContentPointerLeave,
269
+ onContentInteractOutside,
270
+ ]
271
+ );
272
+
45
273
  return (
46
- <HoverCardPrimitive.Root
47
- closeDelay={closeDelay}
48
- openDelay={openDelay}
49
- {...props}
50
- />
274
+ <HoverCardContext.Provider value={contextValue}>
275
+ <PopoverPrimitive.Root open={open} onOpenChange={handlePopoverOpenChange}>
276
+ {children}
277
+ </PopoverPrimitive.Root>
278
+ </HoverCardContext.Provider>
51
279
  );
52
280
  }
53
281
 
54
282
  HoverCard.displayName = "HoverCard";
55
283
 
56
- export interface HoverCardTriggerProps extends React.ComponentProps<
57
- typeof HoverCardPrimitive.Trigger
58
- > {
284
+ /* -------------------------------- Trigger --------------------------------- */
285
+
286
+ export interface HoverCardTriggerProps extends React.ComponentPropsWithoutRef<"a"> {
59
287
  /**
60
288
  * Data hook for automated testing
61
289
  */
@@ -72,40 +300,113 @@ export interface HoverCardTriggerProps extends React.ComponentProps<
72
300
  * Optional analytics label context
73
301
  */
74
302
  trackingLabel?: string;
303
+ /**
304
+ * Render as child element using Radix Slot
305
+ */
306
+ asChild?: boolean;
75
307
  }
76
308
 
77
309
  /**
78
310
  * HoverCardTrigger - The element that triggers the hover card
79
311
  */
80
312
  const HoverCardTrigger = React.forwardRef<
81
- React.ElementRef<typeof HoverCardPrimitive.Trigger>,
313
+ HTMLAnchorElement,
82
314
  HoverCardTriggerProps
83
315
  >(
84
316
  (
85
- { className, disabled, dataHook, trackingEl, trackingLabel, ...props },
317
+ {
318
+ className,
319
+ disabled,
320
+ dataHook,
321
+ trackingEl,
322
+ trackingLabel,
323
+ asChild,
324
+ children,
325
+ onBlur,
326
+ onClick,
327
+ onFocus,
328
+ onPointerCancel,
329
+ onPointerDown,
330
+ onPointerEnter,
331
+ onPointerLeave,
332
+ ...props
333
+ },
86
334
  ref
87
- ) => (
88
- <HoverCardPrimitive.Trigger
89
- ref={ref}
90
- aria-disabled={disabled}
91
- className={cn(
92
- "text-link text-label cursor-pointer underline",
93
- disabled && "pointer-events-none cursor-not-allowed opacity-50",
94
- className
95
- )}
96
- data-hook={dataHook}
97
- data-slot="hover-card-trigger"
98
- data-tracking-el={trackingEl}
99
- data-tracking-label={trackingLabel}
100
- {...props}
101
- />
102
- )
335
+ ) => {
336
+ const {
337
+ open,
338
+ triggerRef,
339
+ onTriggerPointerEnter,
340
+ onTriggerPointerLeave,
341
+ onTriggerPointerDown,
342
+ onTriggerPointerCancel,
343
+ onTriggerClick,
344
+ onTriggerFocus,
345
+ onTriggerBlur,
346
+ } = useHoverCardContext();
347
+
348
+ const setRefs = React.useCallback(
349
+ (node: HTMLAnchorElement | null) => {
350
+ triggerRef.current = node;
351
+ if (typeof ref === "function") ref(node);
352
+ else if (ref) ref.current = node;
353
+ },
354
+ [ref, triggerRef]
355
+ );
356
+
357
+ const Comp = asChild ? Slot : "a";
358
+
359
+ return (
360
+ <PopoverPrimitive.Anchor asChild>
361
+ <Comp
362
+ ref={setRefs}
363
+ aria-disabled={disabled || undefined}
364
+ aria-expanded={open}
365
+ className={cn(
366
+ "text-link text-label cursor-pointer underline",
367
+ disabled && "pointer-events-none cursor-not-allowed opacity-50",
368
+ className
369
+ )}
370
+ data-hook={dataHook}
371
+ data-slot="hover-card-trigger"
372
+ data-state={open ? "open" : "closed"}
373
+ data-tracking-el={trackingEl}
374
+ data-tracking-label={trackingLabel}
375
+ {...props}
376
+ onBlur={composeEventHandlers(onBlur, onTriggerBlur)}
377
+ onClick={composeEventHandlers(onClick, onTriggerClick)}
378
+ onFocus={composeEventHandlers(onFocus, onTriggerFocus)}
379
+ onPointerCancel={composeEventHandlers(
380
+ onPointerCancel,
381
+ onTriggerPointerCancel
382
+ )}
383
+ onPointerDown={composeEventHandlers(
384
+ onPointerDown,
385
+ onTriggerPointerDown
386
+ )}
387
+ onPointerEnter={composeEventHandlers(
388
+ onPointerEnter,
389
+ onTriggerPointerEnter
390
+ )}
391
+ onPointerLeave={composeEventHandlers(
392
+ onPointerLeave,
393
+ onTriggerPointerLeave
394
+ )}
395
+ >
396
+ {children}
397
+ </Comp>
398
+ </PopoverPrimitive.Anchor>
399
+ );
400
+ }
103
401
  );
104
402
 
105
403
  HoverCardTrigger.displayName = "HoverCardTrigger";
106
404
 
107
- export interface HoverCardContentProps extends React.ComponentPropsWithoutRef<
108
- typeof HoverCardPrimitive.Content
405
+ /* -------------------------------- Content --------------------------------- */
406
+
407
+ export interface HoverCardContentProps extends Omit<
408
+ React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>,
409
+ "onOpenAutoFocus" | "onCloseAutoFocus"
109
410
  > {
110
411
  /**
111
412
  * Data hook for automated testing
@@ -122,10 +423,10 @@ export interface HoverCardContentProps extends React.ComponentPropsWithoutRef<
122
423
  }
123
424
 
124
425
  /**
125
- * HoverCardContent - The content container that appears on hover
426
+ * HoverCardContent - The content container that appears on hover or touch
126
427
  */
127
428
  const HoverCardContent = React.forwardRef<
128
- React.ElementRef<typeof HoverCardPrimitive.Content>,
429
+ React.ElementRef<typeof PopoverPrimitive.Content>,
129
430
  HoverCardContentProps
130
431
  >(
131
432
  (
@@ -136,28 +437,57 @@ const HoverCardContent = React.forwardRef<
136
437
  dataHook,
137
438
  trackingEl,
138
439
  trackingLabel,
440
+ children,
441
+ onInteractOutside,
442
+ onPointerEnter,
443
+ onPointerLeave,
139
444
  ...props
140
445
  },
141
446
  ref
142
- ) => (
143
- <HoverCardPrimitive.Portal>
144
- <HoverCardPrimitive.Content
145
- ref={ref}
146
- align={align}
147
- className={cn(
148
- "border-border bg-popover text-popover-foreground z-50 w-max max-w-sm rounded-lg border p-4 shadow-md outline-hidden",
149
- FLOATING_CONTENT_ANIMATION,
150
- className
151
- )}
152
- data-hook={dataHook}
153
- data-slot="hover-card-content"
154
- data-tracking-el={trackingEl}
155
- data-tracking-label={trackingLabel}
156
- sideOffset={sideOffset}
157
- {...props}
158
- />
159
- </HoverCardPrimitive.Portal>
160
- )
447
+ ) => {
448
+ const {
449
+ onContentPointerEnter,
450
+ onContentPointerLeave,
451
+ onContentInteractOutside,
452
+ } = useHoverCardContext();
453
+
454
+ return (
455
+ <PopoverPrimitive.Portal>
456
+ <PopoverPrimitive.Content
457
+ ref={ref}
458
+ align={align}
459
+ className={cn(
460
+ "border-border bg-popover text-popover-foreground z-50 w-max max-w-sm rounded-lg border p-4 shadow-md outline-hidden",
461
+ FLOATING_CONTENT_ANIMATION,
462
+ className
463
+ )}
464
+ data-hook={dataHook}
465
+ data-slot="hover-card-content"
466
+ data-tracking-el={trackingEl}
467
+ data-tracking-label={trackingLabel}
468
+ sideOffset={sideOffset}
469
+ onCloseAutoFocus={(e) => e.preventDefault()}
470
+ onOpenAutoFocus={(e) => e.preventDefault()}
471
+ {...props}
472
+ role="none"
473
+ onInteractOutside={composeEventHandlers(
474
+ onInteractOutside,
475
+ onContentInteractOutside
476
+ )}
477
+ onPointerEnter={composeEventHandlers(
478
+ onPointerEnter,
479
+ onContentPointerEnter
480
+ )}
481
+ onPointerLeave={composeEventHandlers(
482
+ onPointerLeave,
483
+ onContentPointerLeave
484
+ )}
485
+ >
486
+ {children}
487
+ </PopoverPrimitive.Content>
488
+ </PopoverPrimitive.Portal>
489
+ );
490
+ }
161
491
  );
162
492
  HoverCardContent.displayName = "HoverCardContent";
163
493