@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.
- package/README.md +7 -1
- package/component-meta.json +749 -53
- package/deprecations.json +114 -4
- package/dist/accordion.cjs +1 -1
- package/dist/accordion.d.ts +36 -0
- package/dist/accordion.d.ts.map +1 -1
- package/dist/accordion.js +74 -61
- package/dist/alert-dialog.cjs +1 -1
- package/dist/alert-dialog.d.ts +32 -3
- package/dist/alert-dialog.d.ts.map +1 -1
- package/dist/alert-dialog.js +61 -58
- package/dist/alert.cjs +1 -1
- package/dist/alert.d.ts.map +1 -1
- package/dist/alert.js +58 -57
- package/dist/badge.cjs +1 -1
- package/dist/badge.d.ts +9 -0
- package/dist/badge.d.ts.map +1 -1
- package/dist/badge.js +50 -30
- package/dist/banner.cjs +1 -0
- package/dist/banner.d.ts +81 -0
- package/dist/banner.d.ts.map +1 -0
- package/dist/banner.js +176 -0
- package/dist/blocks/empty-state.cjs +1 -1
- package/dist/blocks/empty-state.d.ts +4 -3
- package/dist/blocks/empty-state.d.ts.map +1 -1
- package/dist/blocks/empty-state.js +50 -57
- package/dist/blocks/progress-state.d.ts +2 -2
- package/dist/blocks/sidebar.cjs +1 -1
- package/dist/blocks/sidebar.d.ts +17 -0
- package/dist/blocks/sidebar.d.ts.map +1 -1
- package/dist/blocks/sidebar.js +8 -2
- package/dist/brand-illustration-motif.d.ts +1 -1
- package/dist/button-group.cjs +1 -0
- package/dist/button-group.d.ts +36 -0
- package/dist/button-group.d.ts.map +1 -0
- package/dist/button-group.js +47 -0
- package/dist/button.cjs +1 -1
- package/dist/button.js +1 -1
- package/dist/card.cjs +1 -1
- package/dist/card.d.ts +105 -7
- package/dist/card.d.ts.map +1 -1
- package/dist/card.js +198 -101
- package/dist/chart.cjs +3 -3
- package/dist/chart.d.ts +270 -24
- package/dist/chart.d.ts.map +1 -1
- package/dist/chart.js +497 -322
- package/dist/checkbox.cjs +1 -1
- package/dist/checkbox.d.ts +1 -1
- package/dist/checkbox.d.ts.map +1 -1
- package/dist/checkbox.js +2 -1
- package/dist/chip.cjs +1 -1
- package/dist/chip.d.ts +38 -4
- package/dist/chip.d.ts.map +1 -1
- package/dist/chip.js +95 -81
- package/dist/combobox.cjs +1 -1
- package/dist/combobox.js +2 -2
- package/dist/command.cjs +1 -1
- package/dist/command.d.ts +23 -1
- package/dist/command.d.ts.map +1 -1
- package/dist/command.js +251 -225
- package/dist/data-table.cjs +1 -1
- package/dist/data-table.d.ts +201 -23
- package/dist/data-table.d.ts.map +1 -1
- package/dist/data-table.js +712 -568
- package/dist/date-picker.cjs +1 -1
- package/dist/date-picker.d.ts +13 -5
- package/dist/date-picker.d.ts.map +1 -1
- package/dist/date-picker.js +54 -53
- package/dist/field.cjs +1 -1
- package/dist/field.d.ts +8 -1
- package/dist/field.d.ts.map +1 -1
- package/dist/field.js +79 -52
- package/dist/global-layout.cjs +1 -1
- package/dist/global-layout.d.ts +105 -13
- package/dist/global-layout.d.ts.map +1 -1
- package/dist/global-layout.js +146 -129
- package/dist/grid.d.ts +26 -3
- package/dist/grid.d.ts.map +1 -1
- package/dist/hooks/use-breakpoint.cjs +1 -1
- package/dist/hooks/use-breakpoint.d.ts +1 -1
- package/dist/hooks/use-breakpoint.d.ts.map +1 -1
- package/dist/hooks/use-breakpoint.js +1 -0
- package/dist/hooks/use-mobile.cjs +1 -0
- package/dist/hooks/use-mobile.js +8 -0
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +6 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +594 -553
- package/dist/info-tooltip.cjs +1 -0
- package/dist/info-tooltip.d.ts +39 -0
- package/dist/info-tooltip.d.ts.map +1 -0
- package/dist/info-tooltip.js +41 -0
- package/dist/input-chip.cjs +1 -1
- package/dist/input-chip.js +1 -1
- package/dist/input-group.cjs +1 -1
- package/dist/input-group.d.ts +33 -2
- package/dist/input-group.d.ts.map +1 -1
- package/dist/input-group.js +167 -54
- package/dist/input-otp.cjs +1 -1
- package/dist/input-otp.js +9 -9
- package/dist/input-password.cjs +1 -1
- package/dist/input-password.d.ts +45 -15
- package/dist/input-password.d.ts.map +1 -1
- package/dist/input-password.js +31 -30
- package/dist/input.cjs +1 -1
- package/dist/input.js +10 -10
- package/dist/lib/block-illustration.cjs +1 -1
- package/dist/lib/block-illustration.d.ts +4 -1
- package/dist/lib/block-illustration.d.ts.map +1 -1
- package/dist/lib/block-illustration.js +12 -11
- package/dist/lib/empty-chip.cjs +1 -0
- package/dist/lib/empty-chip.d.ts +4 -0
- package/dist/lib/empty-chip.d.ts.map +1 -0
- package/dist/lib/empty-chip.js +13 -0
- package/dist/lib/utils.cjs +1 -1
- package/dist/lib/utils.d.ts.map +1 -1
- package/dist/lib/utils.js +4 -3
- package/dist/list.cjs +1 -1
- package/dist/list.js +1 -1
- package/dist/multi-select-filter.cjs +1 -0
- package/dist/multi-select-filter.d.ts +178 -0
- package/dist/multi-select-filter.d.ts.map +1 -0
- package/dist/multi-select-filter.js +463 -0
- package/dist/pagination.cjs +1 -1
- package/dist/pagination.d.ts +3 -0
- package/dist/pagination.d.ts.map +1 -1
- package/dist/pagination.js +57 -57
- package/dist/progress.cjs +1 -1
- package/dist/progress.d.ts +123 -16
- package/dist/progress.d.ts.map +1 -1
- package/dist/progress.js +89 -75
- package/dist/rating.cjs +1 -1
- package/dist/rating.js +18 -18
- package/dist/relative-date.cjs +1 -0
- package/dist/relative-date.d.ts +65 -0
- package/dist/relative-date.d.ts.map +1 -0
- package/dist/relative-date.js +128 -0
- package/dist/scroll-area.cjs +1 -1
- package/dist/scroll-area.d.ts +15 -6
- package/dist/scroll-area.d.ts.map +1 -1
- package/dist/scroll-area.js +38 -36
- package/dist/select.cjs +2 -2
- package/dist/select.d.ts +24 -3
- package/dist/select.d.ts.map +1 -1
- package/dist/select.js +130 -110
- package/dist/sheet.cjs +1 -1
- package/dist/sheet.d.ts +78 -2
- package/dist/sheet.d.ts.map +1 -1
- package/dist/sheet.js +192 -85
- package/dist/single-select-filter.cjs +1 -0
- package/dist/single-select-filter.d.ts +81 -0
- package/dist/single-select-filter.d.ts.map +1 -0
- package/dist/single-select-filter.js +226 -0
- package/dist/sonner.cjs +1 -1
- package/dist/sonner.d.ts.map +1 -1
- package/dist/sonner.js +22 -22
- package/dist/split-layout.cjs +1 -1
- package/dist/split-layout.d.ts +1 -1
- package/dist/split-layout.js +13 -13
- package/dist/table.cjs +1 -1
- package/dist/table.d.ts +45 -4
- package/dist/table.d.ts.map +1 -1
- package/dist/table.js +90 -73
- package/dist/tabs.cjs +1 -1
- package/dist/tabs.d.ts +12 -1
- package/dist/tabs.d.ts.map +1 -1
- package/dist/tabs.js +148 -126
- package/dist/textarea.cjs +1 -1
- package/dist/textarea.js +1 -1
- package/dist/tooltip.cjs +1 -1
- package/dist/tooltip.d.ts +38 -36
- package/dist/tooltip.d.ts.map +1 -1
- package/dist/tooltip.js +262 -73
- package/dist/typography-heading.cjs +1 -1
- package/dist/typography-heading.d.ts +13 -0
- package/dist/typography-heading.d.ts.map +1 -1
- package/dist/typography-heading.js +32 -21
- package/dist/typography-text.cjs +1 -1
- package/dist/typography-text.d.ts +15 -2
- package/dist/typography-text.d.ts.map +1 -1
- package/dist/typography-text.js +35 -24
- package/dist/typography.d.ts +1 -1
- package/package.json +5 -6
- package/src/blocks/empty-state.tsx +17 -24
- package/src/blocks/progress-state.tsx +2 -2
- package/src/blocks/sidebar.tsx +26 -2
- package/src/components/accordion.tsx +82 -27
- package/src/components/alert-dialog.tsx +50 -5
- package/src/components/alert.tsx +16 -8
- package/src/components/badge.tsx +40 -3
- package/src/components/banner.tsx +288 -0
- package/src/components/brand-illustration-motif.tsx +1 -1
- package/src/components/button-group.tsx +112 -0
- package/src/components/button.tsx +1 -1
- package/src/components/card.tsx +249 -27
- package/src/components/chart.tsx +586 -53
- package/src/components/checkbox.tsx +1 -1
- package/src/components/chip.tsx +83 -10
- package/src/components/combobox.tsx +2 -2
- package/src/components/command.tsx +56 -4
- package/src/components/data-table.tsx +842 -199
- package/src/components/date-picker.tsx +18 -7
- package/src/components/field.tsx +81 -12
- package/src/components/global-layout.tsx +176 -38
- package/src/components/grid.tsx +34 -3
- package/src/components/info-tooltip.tsx +94 -0
- package/src/components/input-chip.tsx +1 -1
- package/src/components/input-group.tsx +246 -11
- package/src/components/input-otp.tsx +1 -1
- package/src/components/input-password.tsx +56 -22
- package/src/components/input.tsx +1 -1
- package/src/components/list.tsx +1 -1
- package/src/components/multi-select-filter.tsx +912 -0
- package/src/components/pagination.tsx +10 -3
- package/src/components/progress.tsx +190 -31
- package/src/components/rating.tsx +1 -1
- package/src/components/relative-date.tsx +230 -0
- package/src/components/scroll-area.tsx +23 -10
- package/src/components/select.tsx +65 -11
- package/src/components/sheet.tsx +240 -4
- package/src/components/single-select-filter.tsx +443 -0
- package/src/components/sonner.tsx +16 -5
- package/src/components/split-layout.tsx +2 -2
- package/src/components/table.tsx +71 -11
- package/src/components/tabs.tsx +93 -46
- package/src/components/textarea.tsx +1 -1
- package/src/components/tooltip.tsx +440 -68
- package/src/components/typography-heading.tsx +24 -0
- package/src/components/typography-text.tsx +27 -3
- package/src/components/typography.tsx +1 -1
- package/src/hooks/use-breakpoint.ts +2 -1
- package/src/index.ts +6 -0
- package/src/lib/block-illustration.tsx +5 -1
- package/src/lib/empty-chip.ts +24 -0
- 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
|
|
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
|
-
|
|
12
|
-
|
|
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
|
-
|
|
59
|
+
children,
|
|
38
60
|
}: TooltipProviderProps) {
|
|
61
|
+
const value = React.useMemo(
|
|
62
|
+
() => ({ delayDuration, skipDelayDuration }),
|
|
63
|
+
[delayDuration, skipDelayDuration]
|
|
64
|
+
);
|
|
39
65
|
return (
|
|
40
|
-
<
|
|
41
|
-
|
|
42
|
-
|
|
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
|
|
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
|
-
*
|
|
64
|
-
*
|
|
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
|
-
|
|
69
|
-
|
|
70
|
-
|
|
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
|
-
|
|
74
|
-
|
|
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
|
|
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
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
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
|
-
|
|
114
|
-
|
|
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
|
|
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
|
-
<
|
|
153
|
-
<
|
|
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
|
-
{
|
|
538
|
+
<span id={tooltipId} role="tooltip">
|
|
539
|
+
{children}
|
|
540
|
+
</span>
|
|
169
541
|
{!hideArrow && (
|
|
170
|
-
<
|
|
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
|
-
</
|
|
178
|
-
</
|
|
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
|
)}
|