@cognitap/radiant 0.0.15 → 0.0.17

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 (38) hide show
  1. package/CHANGELOG.md +9 -1
  2. package/dist/library/Menu.d.ts +22 -0
  3. package/dist/library/Menu.d.ts.map +1 -0
  4. package/dist/library/Menu.js +144 -0
  5. package/dist/library/Menu.js.map +1 -0
  6. package/dist/library/Popover.d.ts +1 -0
  7. package/dist/library/Popover.d.ts.map +1 -1
  8. package/dist/library/Popover.js +1 -1
  9. package/dist/library/Popover.js.map +1 -1
  10. package/dist/library/Tooltip.d.ts +40 -0
  11. package/dist/library/Tooltip.d.ts.map +1 -0
  12. package/dist/library/Tooltip.js +182 -0
  13. package/dist/library/Tooltip.js.map +1 -0
  14. package/dist/library/cn.d.ts.map +1 -1
  15. package/dist/library/cn.js +16 -0
  16. package/dist/library/cn.js.map +1 -1
  17. package/dist/library/index.d.ts +4 -0
  18. package/dist/library/index.d.ts.map +1 -1
  19. package/dist/library/index.js +2 -0
  20. package/dist/library/index.js.map +1 -1
  21. package/dist/library/react/usePopoverSurface.d.ts +1 -1
  22. package/dist/library/react/usePopoverSurface.d.ts.map +1 -1
  23. package/dist/library/react/usePopoverSurface.js.map +1 -1
  24. package/dist/library/styles.css +1 -1
  25. package/dist/library/themes/components.d.ts +28 -0
  26. package/dist/library/themes/components.d.ts.map +1 -1
  27. package/dist/library/themes/components.js +28 -0
  28. package/dist/library/themes/components.js.map +1 -1
  29. package/docs/architecture.md +4 -4
  30. package/docs/theming.md +1 -1
  31. package/package.json +1 -1
  32. package/src/Menu.tsx +248 -0
  33. package/src/Popover.tsx +2 -1
  34. package/src/Tooltip.tsx +287 -0
  35. package/src/cn.ts +16 -0
  36. package/src/index.ts +20 -0
  37. package/src/react/usePopoverSurface.ts +2 -2
  38. package/src/themes/components.ts +28 -0
@@ -0,0 +1,287 @@
1
+ 'use client'
2
+
3
+ import {
4
+ createContext,
5
+ useCallback,
6
+ useContext,
7
+ useEffect,
8
+ useId,
9
+ useRef,
10
+ useState,
11
+ type ComponentProps,
12
+ type ReactNode,
13
+ type RefObject
14
+ } from 'react'
15
+ import { createPortal } from 'react-dom'
16
+ import { Button, type ButtonProps, type ButtonRenderProps } from './Button.js'
17
+ import { cn } from './cn.js'
18
+ import { joinIds } from './internal/ids.js'
19
+ import { composeAction } from './internal/events.js'
20
+ import type { PopoverSide, PopoverAlign } from './internal/popover.js'
21
+ import { useControllableState } from './react/useControllableState.js'
22
+ import { useComposedRefs } from './react/useComposedRefs.js'
23
+ import { usePopoverSurface } from './react/usePopoverSurface.js'
24
+ import { useTransitionHost } from './motion/host.js'
25
+ import type { ThemeStyle } from './themes/defineTheme.js'
26
+
27
+ export type TooltipProps = (
28
+ | { open: boolean; defaultOpen?: never }
29
+ | { open?: undefined; defaultOpen?: boolean }
30
+ ) & {
31
+ onOpenChange?: (open: boolean) => void
32
+ openDelay?: number
33
+ closeDelay?: number
34
+ children?: ReactNode
35
+ }
36
+ export type TooltipState = { open: boolean; setOpen: (open: boolean) => void; contentId: string }
37
+ type Context = TooltipState & {
38
+ trigger: HTMLButtonElement | null
39
+ setTrigger: (node: HTMLButtonElement | null) => void
40
+ content: RefObject<HTMLSpanElement | null>
41
+ enter: (focus?: boolean) => void
42
+ leave: (focus?: boolean) => void
43
+ dismiss: () => void
44
+ touch: () => void
45
+ }
46
+ const TooltipContext = createContext<Context | null>(null)
47
+ export function useTooltip(): TooltipState | null {
48
+ return useContext(TooltipContext)
49
+ }
50
+ function useTooltipContext() {
51
+ const value = useContext(TooltipContext)
52
+ if (!value) throw new Error('Tooltip parts must render inside Tooltip.')
53
+ return value
54
+ }
55
+
56
+ export function Tooltip({
57
+ open,
58
+ defaultOpen,
59
+ onOpenChange,
60
+ openDelay = 500,
61
+ closeDelay = 150,
62
+ children
63
+ }: TooltipProps) {
64
+ if (![openDelay, closeDelay].every(n => Number.isFinite(n) && n >= 0))
65
+ throw new TypeError('Tooltip delays must be finite, nonnegative numbers.')
66
+ const state = useControllableState({
67
+ name: 'Tooltip',
68
+ value: open,
69
+ defaultValue: defaultOpen,
70
+ initialValue: false,
71
+ onChange: onOpenChange
72
+ })
73
+ const contentId = useId()
74
+ const [trigger, setTrigger] = useState<HTMLButtonElement | null>(null)
75
+ const content = useRef<HTMLSpanElement>(null)
76
+ const timer = useRef<{ view: Window; id: number } | null>(null)
77
+ const activity = useRef({ focused: false, hovered: false, suppressed: false, touch: false })
78
+ const clear = () => {
79
+ if (timer.current) timer.current.view.clearTimeout(timer.current.id)
80
+ timer.current = null
81
+ }
82
+ const latest = useRef(state.request)
83
+ useEffect(() => {
84
+ latest.current = state.request
85
+ })
86
+ useEffect(() => () => clear(), [])
87
+ const schedule = useCallback(
88
+ (next: boolean, delay: number) => {
89
+ clear()
90
+ const view = trigger?.ownerDocument.defaultView
91
+ if (!view) return
92
+ timer.current = {
93
+ view,
94
+ id: view.setTimeout(() => {
95
+ timer.current = null
96
+ latest.current(next)
97
+ }, delay)
98
+ }
99
+ },
100
+ [trigger]
101
+ )
102
+ const dismiss = () => {
103
+ clear()
104
+ activity.current.suppressed = true
105
+ state.request(false)
106
+ }
107
+ const enter = (focus = false) => {
108
+ if (focus && !activity.current.focused) activity.current.suppressed = false
109
+ if (focus) activity.current.focused = true
110
+ else activity.current.hovered = true
111
+ clear()
112
+ if (activity.current.suppressed || activity.current.touch) return
113
+ if (focus) state.request(true)
114
+ else if (!state.value) schedule(true, openDelay)
115
+ }
116
+ const leave = (focus = false) => {
117
+ if (focus) {
118
+ activity.current.focused = false
119
+ activity.current.touch = false
120
+ } else activity.current.hovered = false
121
+ if (activity.current.focused || activity.current.hovered) return
122
+ activity.current.suppressed = false
123
+ schedule(false, closeDelay)
124
+ }
125
+ useEffect(() => {
126
+ if (!trigger || !state.value) return
127
+ const move = (event: PointerEvent) => {
128
+ if (
129
+ event.pointerType === 'touch' ||
130
+ activity.current.focused ||
131
+ activity.current.hovered ||
132
+ activity.current.suppressed
133
+ )
134
+ return
135
+ const panel = content.current
136
+ if (!panel) return
137
+ const a = trigger.getBoundingClientRect()
138
+ const b = panel.getBoundingClientRect()
139
+ // Keep a hoverable bridge across the placement gap, including magnified pointer movement.
140
+ const within =
141
+ event.clientX >= Math.min(a.left, b.left) &&
142
+ event.clientX <= Math.max(a.right, b.right) &&
143
+ event.clientY >= Math.min(a.top, b.top) &&
144
+ event.clientY <= Math.max(a.bottom, b.bottom)
145
+ if (within) clear()
146
+ else if (!timer.current) schedule(false, closeDelay)
147
+ }
148
+ trigger.ownerDocument.addEventListener('pointermove', move)
149
+ return () => trigger.ownerDocument.removeEventListener('pointermove', move)
150
+ }, [trigger, state.value, closeDelay, schedule])
151
+ return (
152
+ <TooltipContext.Provider
153
+ value={{
154
+ open: state.value,
155
+ setOpen: state.request,
156
+ contentId,
157
+ trigger,
158
+ setTrigger,
159
+ content,
160
+ enter,
161
+ leave,
162
+ dismiss,
163
+ touch: () => {
164
+ activity.current.touch = true
165
+ dismiss()
166
+ }
167
+ }}
168
+ >
169
+ {children}
170
+ </TooltipContext.Provider>
171
+ )
172
+ }
173
+
174
+ export type TooltipTriggerProps = ButtonProps
175
+ export type TooltipRenderProps = ButtonRenderProps
176
+ export type TooltipPortalProps = { children?: ReactNode }
177
+ export type TooltipContentProps = Omit<
178
+ ComponentProps<'span'>,
179
+ 'style' | 'id' | 'role' | 'popover' | 'tabIndex'
180
+ > & {
181
+ style?: ThemeStyle
182
+ side?: PopoverSide
183
+ align?: PopoverAlign
184
+ sideOffset?: number
185
+ collisionPadding?: number
186
+ motion?: 'inherit' | 'off'
187
+ }
188
+ export function TooltipTrigger({
189
+ ref,
190
+ onClick,
191
+ onFocus,
192
+ onBlur,
193
+ onPointerEnter,
194
+ onPointerLeave,
195
+ onPointerDown,
196
+ ...props
197
+ }: TooltipTriggerProps) {
198
+ const tip = useTooltipContext()
199
+ const hostRef = useComposedRefs(tip.setTrigger, ref)
200
+ return (
201
+ <Button
202
+ {...props}
203
+ ref={hostRef}
204
+ data-slot={joinIds('tooltip-trigger', props['data-slot'])}
205
+ aria-describedby={joinIds(tip.contentId, props['aria-describedby'])}
206
+ onFocus={event => {
207
+ onFocus?.(event)
208
+ tip.enter(true)
209
+ }}
210
+ onBlur={event => {
211
+ onBlur?.(event)
212
+ tip.leave(true)
213
+ }}
214
+ onPointerEnter={composeAction(onPointerEnter, event => {
215
+ if (event.pointerType !== 'touch') tip.enter()
216
+ })}
217
+ onPointerLeave={composeAction(onPointerLeave, event => {
218
+ if (event.pointerType !== 'touch') tip.leave()
219
+ })}
220
+ onPointerDown={event => {
221
+ onPointerDown?.(event)
222
+ if (event.pointerType === 'touch') tip.touch()
223
+ }}
224
+ onClick={composeAction(onClick, tip.dismiss)}
225
+ />
226
+ )
227
+ }
228
+ export function TooltipPortal({ children }: TooltipPortalProps) {
229
+ const tip = useTooltipContext()
230
+ return tip.trigger?.parentElement ? createPortal(children, tip.trigger.parentElement) : children
231
+ }
232
+ export function TooltipContent({
233
+ ref,
234
+ className,
235
+ side = 'top',
236
+ align = 'center',
237
+ sideOffset = 8,
238
+ collisionPadding = 8,
239
+ motion = 'inherit',
240
+ onPointerEnter,
241
+ onPointerLeave,
242
+ ...props
243
+ }: TooltipContentProps) {
244
+ const tip = useTooltipContext()
245
+ if (![sideOffset, collisionPadding].every(n => Number.isFinite(n) && n >= 0))
246
+ throw new TypeError('Tooltip offsets must be finite, nonnegative numbers.')
247
+ const hostRef = useComposedRefs(tip.content, ref)
248
+ const restoreFocus = useRef(false)
249
+ const { ref: transitionRef, active, off } = useTransitionHost('popup', hostRef, motion === 'off')
250
+ usePopoverSurface(tip.content, tip.trigger, tip.open, tip.dismiss, restoreFocus, {
251
+ side,
252
+ align,
253
+ sideOffset,
254
+ collisionPadding
255
+ })
256
+ return (
257
+ <span
258
+ {...props}
259
+ ref={transitionRef}
260
+ id={tip.contentId}
261
+ role="tooltip"
262
+ popover="manual"
263
+ tabIndex={undefined}
264
+ data-slot="tooltip-content"
265
+ data-state={tip.open ? 'open' : 'closed'}
266
+ data-side={side}
267
+ data-align={align}
268
+ data-motion={motion}
269
+ onPointerEnter={composeAction(onPointerEnter, event => {
270
+ if (event.pointerType !== 'touch') tip.enter()
271
+ })}
272
+ onPointerLeave={composeAction(onPointerLeave, event => {
273
+ if (event.pointerType !== 'touch') tip.leave()
274
+ })}
275
+ className={cn(
276
+ 'fixed right-auto bottom-auto m-0 box-border block min-w-0 w-max overflow-auto break-words text-start antialiased [&:not(:popover-open)]:hidden',
277
+ 'left-[var(--_rad-popover-left,0px)] top-[var(--_rad-popover-top,0px)] max-w-[min(var(--rad-tooltip-max-width,20rem),var(--_rad-popover-max-width,calc(100vw-1rem)))] max-h-[var(--_rad-popover-max-height,calc(100dvh-1rem))]',
278
+ 'p-[var(--rad-tooltip-padding,0.625rem)] rounded-[var(--rad-tooltip-radius,var(--rad-control-radius,0.5rem))]',
279
+ 'bg-[var(--rad-tooltip-background,var(--rad-color-surface,white))] [color:var(--rad-tooltip-color,var(--rad-color-foreground))] [border-color:var(--rad-tooltip-border-color,var(--rad-color-border))] [border-width:var(--rad-tooltip-border-width,var(--rad-surface-border-width,1px))] [border-style:var(--rad-tooltip-border-style,var(--rad-surface-border-style,solid))] [box-shadow:var(--rad-tooltip-shadow,var(--rad-surface-overlay-shadow,0_8px_32px_#0003))]',
280
+ 'font-[family-name:var(--rad-typography-roles-ui-supporting-family,system-ui,sans-serif)] text-[length:var(--rad-tooltip-font-size,var(--rad-typography-roles-ui-supporting-size,0.8125rem))] font-[number:var(--rad-tooltip-font-weight,var(--rad-typography-roles-ui-supporting-weight,400))] leading-[var(--rad-typography-roles-ui-supporting-line-height,1.5)]',
281
+ 'forced-colors:border-[CanvasText] forced-colors:bg-[Canvas] forced-colors:text-[CanvasText]',
282
+ active && !off && 'opacity-[var(--_rad-popup-enter,0)] motion-reduce:opacity-100',
283
+ className
284
+ )}
285
+ />
286
+ )
287
+ }
package/src/cn.ts CHANGED
@@ -17,6 +17,7 @@ export const cn: CnFunction = createCn({
17
17
  'font-(--rad-tabs-font-family)'
18
18
  ],
19
19
  'font-weight': [
20
+ 'font-(--rad-tooltip-font-weight)',
20
21
  ...roleClasses('font', 'weight'),
21
22
  'font-(--rad-combobox-font-weight)',
22
23
  'font-(--rad-select-font-weight)',
@@ -24,6 +25,7 @@ export const cn: CnFunction = createCn({
24
25
  'font-(--rad-tabs-font-weight)'
25
26
  ],
26
27
  'font-size': [
28
+ 'text-(--rad-tooltip-font-size)',
27
29
  ...roleClasses('text', 'size'),
28
30
  ...roleClasses('text', 'fluid-size'),
29
31
  'text-(--rad-combobox-font-size)',
@@ -40,11 +42,13 @@ export const cn: CnFunction = createCn({
40
42
  'h-(--rad-slider-length)'
41
43
  ],
42
44
  w: [
45
+ 'w-(--rad-menu-width)',
43
46
  'w-(--rad-popover-width)',
44
47
  'w-(--rad-switch-width)',
45
48
  'w-(--rad-slider-height)',
46
49
  'w-(--rad-slider-length)'
47
50
  ],
51
+ 'max-w': ['max-w-(--rad-tooltip-max-width)'],
48
52
  size: ['size-(--rad-slider-thumb-size)', 'size-(--rad-slider-track-size)'],
49
53
  gap: [
50
54
  'gap-(--rad-popover-gap)',
@@ -61,6 +65,9 @@ export const cn: CnFunction = createCn({
61
65
  'px-(--rad-tabs-trigger-padding)'
62
66
  ],
63
67
  p: [
68
+ 'p-(--rad-menu-padding)',
69
+ 'p-(--rad-menu-item-padding)',
70
+ 'p-(--rad-tooltip-padding)',
64
71
  'p-(--rad-popover-padding)',
65
72
  'p-(--rad-combobox-content-padding)',
66
73
  'p-(--rad-select-content-padding)',
@@ -68,6 +75,9 @@ export const cn: CnFunction = createCn({
68
75
  'p-(--rad-tabs-content-padding)'
69
76
  ],
70
77
  rounded: [
78
+ 'rounded-(--rad-menu-radius)',
79
+ 'rounded-(--rad-menu-item-radius)',
80
+ 'rounded-(--rad-tooltip-radius)',
71
81
  'rounded-(--rad-popover-radius)',
72
82
  'rounded-(--rad-combobox-radius)',
73
83
  'rounded-(--rad-select-radius)',
@@ -85,6 +95,8 @@ export const cn: CnFunction = createCn({
85
95
  'rounded-(--rad-tabs-content-radius)'
86
96
  ],
87
97
  'border-w': [
98
+ 'border-(--rad-menu-border-width)',
99
+ 'border-(--rad-tooltip-border-width)',
88
100
  'border-(--rad-popover-border-width)',
89
101
  'border-(--rad-combobox-border-width)',
90
102
  'border-(--rad-select-border-width)',
@@ -94,6 +106,8 @@ export const cn: CnFunction = createCn({
94
106
  'border-(--rad-tabs-trigger-border-width)'
95
107
  ],
96
108
  'border-style': [
109
+ 'border-(--rad-menu-border-style)',
110
+ 'border-(--rad-tooltip-border-style)',
97
111
  'border-(--rad-popover-border-style)',
98
112
  'border-(--rad-combobox-border-style)',
99
113
  'border-(--rad-select-border-style)',
@@ -101,6 +115,8 @@ export const cn: CnFunction = createCn({
101
115
  'border-(--rad-switch-border-style)'
102
116
  ],
103
117
  shadow: [
118
+ 'shadow-(--rad-menu-shadow)',
119
+ 'shadow-(--rad-tooltip-shadow)',
104
120
  'shadow-(--rad-popover-shadow)',
105
121
  'shadow-(--rad-combobox-shadow)',
106
122
  'shadow-(--rad-select-shadow)',
package/src/index.ts CHANGED
@@ -21,6 +21,15 @@ export type {
21
21
  ComboboxStatusProps
22
22
  } from './Combobox.js'
23
23
  export { Button } from './Button.js'
24
+ export { Tooltip, TooltipTrigger, TooltipContent, TooltipPortal, useTooltip } from './Tooltip.js'
25
+ export type {
26
+ TooltipProps,
27
+ TooltipState,
28
+ TooltipTriggerProps,
29
+ TooltipContentProps,
30
+ TooltipPortalProps,
31
+ TooltipRenderProps
32
+ } from './Tooltip.js'
24
33
  export {
25
34
  Popover,
26
35
  PopoverTrigger,
@@ -232,3 +241,14 @@ export type {
232
241
  MotionInteraction,
233
242
  SpringParameters
234
243
  } from './motion/config.js'
244
+
245
+ export { Menu, MenuTrigger, MenuContent, MenuItem, MenuPortal, useMenu } from './Menu.js'
246
+ export type {
247
+ MenuProps,
248
+ MenuState,
249
+ MenuTriggerProps,
250
+ MenuContentProps,
251
+ MenuItemProps,
252
+ MenuPortalProps,
253
+ MenuRenderProps
254
+ } from './Menu.js'
@@ -6,8 +6,8 @@ import { positionPopover, type PopoverAlign, type PopoverSide } from '../interna
6
6
  // Each document owns its layers; imports never inspect a browser global.
7
7
  const layers = new WeakMap<Document, HTMLElement[]>()
8
8
 
9
- export function usePopoverSurface(
10
- nodeRef: RefObject<HTMLDivElement | null>,
9
+ export function usePopoverSurface<Node extends HTMLElement>(
10
+ nodeRef: RefObject<Node | null>,
11
11
  trigger: HTMLButtonElement | null,
12
12
  open: boolean,
13
13
  close: (restore: boolean) => void,
@@ -288,6 +288,19 @@ export const componentRegistry = {
288
288
  focusOffset: 'css',
289
289
  focusStyle: 'css'
290
290
  },
291
+ tooltip: {
292
+ maxWidth: 'css',
293
+ padding: 'css',
294
+ radius: 'css',
295
+ background: 'css',
296
+ color: 'css',
297
+ borderColor: 'css',
298
+ borderWidth: 'css',
299
+ borderStyle: 'css',
300
+ shadow: 'css',
301
+ fontSize: 'css',
302
+ fontWeight: 'weight'
303
+ },
291
304
  popover: {
292
305
  width: 'css',
293
306
  padding: 'css',
@@ -368,6 +381,21 @@ export const componentRegistry = {
368
381
  descriptionColor: 'css',
369
382
  descriptionSize: 'css'
370
383
  },
384
+ menu: {
385
+ width: 'css',
386
+ padding: 'css',
387
+ radius: 'css',
388
+ background: 'css',
389
+ color: 'css',
390
+ borderColor: 'css',
391
+ borderWidth: 'css',
392
+ borderStyle: 'css',
393
+ shadow: 'css',
394
+ itemPadding: 'css',
395
+ itemRadius: 'css',
396
+ itemFocusBackground: 'css',
397
+ itemFocusColor: 'css'
398
+ },
371
399
  radioGroup: { gap: 'css' }
372
400
  } as const
373
401