@brightlocal/ui-components 3.3.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.
- package/AI_USAGE.md +22 -3
- package/README.md +177 -109
- package/component-meta.json +1307 -113
- package/dist/alert-dialog.cjs +1 -1
- package/dist/alert-dialog.d.ts +13 -2
- package/dist/alert-dialog.d.ts.map +1 -1
- package/dist/alert-dialog.js +4 -3
- package/dist/banner.cjs +1 -1
- package/dist/banner.d.ts +47 -11
- package/dist/banner.d.ts.map +1 -1
- package/dist/banner.js +156 -79
- package/dist/blocks/empty-state.cjs +1 -1
- package/dist/blocks/empty-state.d.ts +40 -5
- package/dist/blocks/empty-state.d.ts.map +1 -1
- package/dist/blocks/empty-state.js +59 -52
- package/dist/blocks/input-list.cjs +1 -1
- package/dist/blocks/input-list.d.ts +1 -0
- package/dist/blocks/input-list.d.ts.map +1 -1
- package/dist/blocks/input-list.js +39 -39
- package/dist/blocks/sidebar.cjs +1 -1
- package/dist/blocks/sidebar.d.ts +12 -6
- package/dist/blocks/sidebar.d.ts.map +1 -1
- package/dist/blocks/sidebar.js +64 -63
- package/dist/button.cjs +1 -1
- package/dist/button.d.ts.map +1 -1
- package/dist/button.js +47 -43
- package/dist/card.cjs +1 -1
- package/dist/card.d.ts +12 -0
- package/dist/card.d.ts.map +1 -1
- package/dist/card.js +115 -97
- package/dist/chart.cjs +6 -6
- package/dist/chart.d.ts +6 -10
- package/dist/chart.d.ts.map +1 -1
- package/dist/chart.js +281 -296
- package/dist/combobox.cjs +3 -3
- package/dist/combobox.d.ts.map +1 -1
- package/dist/combobox.js +430 -343
- package/dist/command.cjs +1 -1
- package/dist/command.d.ts +23 -2
- package/dist/command.d.ts.map +1 -1
- package/dist/command.js +212 -207
- package/dist/count-indicator.cjs +1 -0
- package/dist/count-indicator.d.ts +85 -0
- package/dist/count-indicator.d.ts.map +1 -0
- package/dist/count-indicator.js +72 -0
- package/dist/data-table.cjs +1 -1
- package/dist/data-table.d.ts +101 -11
- package/dist/data-table.d.ts.map +1 -1
- package/dist/data-table.js +593 -523
- package/dist/description-list.cjs +1 -0
- package/dist/description-list.d.ts +142 -0
- package/dist/description-list.d.ts.map +1 -0
- package/dist/description-list.js +173 -0
- package/dist/dialog.cjs +1 -1
- package/dist/dialog.d.ts +26 -3
- package/dist/dialog.d.ts.map +1 -1
- package/dist/dialog.js +62 -47
- package/dist/drawer.cjs +1 -1
- package/dist/drawer.d.ts +8 -4
- package/dist/drawer.d.ts.map +1 -1
- package/dist/drawer.js +37 -38
- package/dist/file-upload.cjs +1 -0
- package/dist/file-upload.d.ts +546 -0
- package/dist/file-upload.d.ts.map +1 -0
- package/dist/file-upload.js +1103 -0
- package/dist/global-layout.cjs +1 -1
- package/dist/global-layout.d.ts +7 -2
- package/dist/global-layout.d.ts.map +1 -1
- package/dist/global-layout.js +52 -52
- package/dist/hooks/use-file-dropzone.cjs +1 -0
- package/dist/hooks/use-file-dropzone.d.ts +75 -0
- package/dist/hooks/use-file-dropzone.d.ts.map +1 -0
- package/dist/hooks/use-file-dropzone.js +133 -0
- package/dist/hover-card.cjs +1 -1
- package/dist/hover-card.d.ts +29 -16
- package/dist/hover-card.d.ts.map +1 -1
- package/dist/hover-card.js +153 -36
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +681 -623
- package/dist/input-chip.cjs +1 -1
- package/dist/input-chip.d.ts +30 -1
- package/dist/input-chip.d.ts.map +1 -1
- package/dist/input-chip.js +131 -115
- package/dist/input-group.cjs +1 -1
- package/dist/input-group.d.ts +37 -2
- package/dist/input-group.d.ts.map +1 -1
- package/dist/input-group.js +131 -114
- package/dist/input-password.cjs +1 -1
- package/dist/input-password.js +6 -6
- package/dist/lib/empty-canvas.cjs +1 -1
- package/dist/lib/empty-canvas.d.ts +27 -1
- package/dist/lib/empty-canvas.d.ts.map +1 -1
- package/dist/lib/empty-canvas.js +27 -23
- package/dist/lib/empty-chip.cjs +1 -1
- package/dist/lib/empty-chip.d.ts +19 -2
- package/dist/lib/empty-chip.d.ts.map +1 -1
- package/dist/lib/empty-chip.js +14 -9
- package/dist/lib/field-aria.cjs +1 -1
- package/dist/lib/field-aria.d.ts +4 -4
- package/dist/lib/field-aria.d.ts.map +1 -1
- package/dist/lib/field-aria.js +7 -5
- package/dist/lib/media-viewer-content.cjs +1 -1
- package/dist/lib/media-viewer-content.js +1 -1
- package/dist/lib/motion.cjs +1 -1
- package/dist/lib/motion.js +15 -10
- package/dist/lib/table-internal.cjs +1 -1
- package/dist/lib/table-internal.d.ts +19 -0
- package/dist/lib/table-internal.d.ts.map +1 -1
- package/dist/lib/table-internal.js +22 -7
- package/dist/list.cjs +1 -1
- package/dist/list.d.ts +230 -40
- package/dist/list.d.ts.map +1 -1
- package/dist/list.js +301 -66
- package/dist/logo-mark.cjs +1 -1
- package/dist/logo-mark.d.ts +18 -2
- package/dist/logo-mark.d.ts.map +1 -1
- package/dist/logo-mark.js +159 -79
- package/dist/media-empty.cjs +1 -1
- package/dist/media-empty.d.ts +50 -7
- package/dist/media-empty.d.ts.map +1 -1
- package/dist/media-empty.js +14 -13
- package/dist/media-viewer.cjs +1 -1
- package/dist/media-viewer.js +6 -6
- package/dist/multi-select-filter.cjs +1 -1
- package/dist/multi-select-filter.d.ts.map +1 -1
- package/dist/multi-select-filter.js +92 -101
- package/dist/pagination.cjs +1 -1
- package/dist/pagination.d.ts +11 -0
- package/dist/pagination.d.ts.map +1 -1
- package/dist/pagination.js +17 -17
- package/dist/relative-date.d.ts +6 -0
- package/dist/relative-date.d.ts.map +1 -1
- package/dist/resizable.d.ts +1 -1
- package/dist/result-count.cjs +1 -1
- package/dist/result-count.d.ts +13 -16
- package/dist/result-count.d.ts.map +1 -1
- package/dist/result-count.js +24 -33
- package/dist/route-progress.cjs +1 -1
- package/dist/route-progress.js +24 -23
- package/dist/sheet.cjs +1 -1
- package/dist/sheet.d.ts +22 -3
- package/dist/sheet.d.ts.map +1 -1
- package/dist/sheet.js +152 -125
- package/dist/single-select-filter.cjs +1 -1
- package/dist/single-select-filter.d.ts.map +1 -1
- package/dist/single-select-filter.js +67 -76
- package/dist/table.cjs +1 -1
- package/dist/table.d.ts.map +1 -1
- package/dist/table.js +77 -76
- package/dist/tabs.cjs +1 -1
- package/dist/tabs.d.ts +39 -3
- package/dist/tabs.d.ts.map +1 -1
- package/dist/tabs.js +127 -76
- package/dist/textarea.cjs +1 -1
- package/dist/textarea.d.ts +34 -0
- package/dist/textarea.d.ts.map +1 -1
- package/dist/textarea.js +115 -19
- package/dist/tooltip.cjs +1 -1
- package/dist/tooltip.d.ts.map +1 -1
- package/dist/tooltip.js +137 -131
- package/dist/typography-text.cjs +1 -1
- package/dist/typography-text.d.ts +6 -2
- package/dist/typography-text.d.ts.map +1 -1
- package/dist/typography-text.js +14 -13
- package/package.json +2 -3
- package/src/blocks/empty-state.tsx +108 -48
- package/src/blocks/input-list.tsx +15 -9
- package/src/blocks/sidebar.tsx +39 -16
- package/src/components/alert-dialog.tsx +18 -2
- package/src/components/banner.tsx +247 -68
- package/src/components/button.tsx +27 -10
- package/src/components/card.tsx +89 -7
- package/src/components/chart.tsx +47 -67
- package/src/components/combobox.tsx +221 -12
- package/src/components/command.tsx +83 -37
- package/src/components/count-indicator.tsx +188 -0
- package/src/components/data-table.tsx +506 -159
- package/src/components/description-list.tsx +445 -0
- package/src/components/dialog.tsx +74 -5
- package/src/components/drawer.tsx +52 -32
- package/src/components/file-upload.tsx +2574 -0
- package/src/components/global-layout.tsx +18 -5
- package/src/components/hover-card.tsx +395 -65
- package/src/components/input-chip.tsx +67 -2
- package/src/components/input-group.tsx +89 -6
- package/src/components/list.tsx +720 -72
- package/src/components/logo-mark.tsx +109 -25
- package/src/components/media-empty.tsx +62 -7
- package/src/components/multi-select-filter.tsx +9 -16
- package/src/components/pagination.tsx +15 -2
- package/src/components/relative-date.tsx +6 -0
- package/src/components/result-count.tsx +27 -54
- package/src/components/sheet.tsx +86 -8
- package/src/components/single-select-filter.tsx +9 -16
- package/src/components/table.tsx +16 -1
- package/src/components/tabs.tsx +223 -41
- package/src/components/textarea.tsx +271 -4
- package/src/components/tooltip.tsx +29 -2
- package/src/components/typography-text.tsx +7 -2
- package/src/hooks/use-file-dropzone.ts +325 -0
- package/src/index.ts +4 -0
- package/src/lib/empty-canvas.tsx +47 -20
- package/src/lib/empty-chip.tsx +38 -3
- package/src/lib/field-aria.tsx +11 -6
- 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
|
|
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:
|
|
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:
|
|
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:
|
|
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
|
|
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
|
|
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
|
|
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
|
-
*
|
|
35
|
-
* - openDelay
|
|
36
|
-
*
|
|
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
|
-
|
|
98
|
+
open: controlledOpen,
|
|
99
|
+
defaultOpen = false,
|
|
100
|
+
onOpenChange,
|
|
101
|
+
children,
|
|
42
102
|
}: HoverCardProps) {
|
|
43
|
-
|
|
44
|
-
|
|
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
|
-
<
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
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
|
-
|
|
57
|
-
|
|
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
|
-
|
|
313
|
+
HTMLAnchorElement,
|
|
82
314
|
HoverCardTriggerProps
|
|
83
315
|
>(
|
|
84
316
|
(
|
|
85
|
-
{
|
|
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
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
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
|
-
|
|
108
|
-
|
|
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
|
|
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
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
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
|
|