@cognitap/radiant 0.0.34 → 0.0.36

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 (52) hide show
  1. package/CHANGELOG.md +22 -8
  2. package/dist/library/ContextMenu.d.ts +38 -0
  3. package/dist/library/ContextMenu.d.ts.map +1 -0
  4. package/dist/library/ContextMenu.js +169 -0
  5. package/dist/library/ContextMenu.js.map +1 -0
  6. package/dist/library/HoverCard.d.ts +26 -0
  7. package/dist/library/HoverCard.d.ts.map +1 -0
  8. package/dist/library/HoverCard.js +89 -0
  9. package/dist/library/HoverCard.js.map +1 -0
  10. package/dist/library/Menu.d.ts +83 -3
  11. package/dist/library/Menu.d.ts.map +1 -1
  12. package/dist/library/Menu.js +209 -25
  13. package/dist/library/Menu.js.map +1 -1
  14. package/dist/library/Popover.d.ts +32 -3
  15. package/dist/library/Popover.d.ts.map +1 -1
  16. package/dist/library/Popover.js +34 -9
  17. package/dist/library/Popover.js.map +1 -1
  18. package/dist/library/Tooltip.d.ts.map +1 -1
  19. package/dist/library/Tooltip.js +10 -88
  20. package/dist/library/Tooltip.js.map +1 -1
  21. package/dist/library/cn.d.ts.map +1 -1
  22. package/dist/library/cn.js +2 -0
  23. package/dist/library/cn.js.map +1 -1
  24. package/dist/library/index.d.ts +6 -0
  25. package/dist/library/index.d.ts.map +1 -1
  26. package/dist/library/index.js +3 -0
  27. package/dist/library/index.js.map +1 -1
  28. package/dist/library/react/useHoverSurface.d.ts +18 -0
  29. package/dist/library/react/useHoverSurface.d.ts.map +1 -0
  30. package/dist/library/react/useHoverSurface.js +109 -0
  31. package/dist/library/react/useHoverSurface.js.map +1 -0
  32. package/dist/library/react/usePopoverSurface.d.ts +6 -1
  33. package/dist/library/react/usePopoverSurface.d.ts.map +1 -1
  34. package/dist/library/react/usePopoverSurface.js +27 -6
  35. package/dist/library/react/usePopoverSurface.js.map +1 -1
  36. package/dist/library/styles.css +1 -1
  37. package/dist/library/themes/components.d.ts +6 -0
  38. package/dist/library/themes/components.d.ts.map +1 -1
  39. package/dist/library/themes/components.js +2 -0
  40. package/dist/library/themes/components.js.map +1 -1
  41. package/docs/architecture.md +35 -30
  42. package/package.json +1 -1
  43. package/src/ContextMenu.tsx +354 -0
  44. package/src/HoverCard.tsx +179 -0
  45. package/src/Menu.tsx +496 -40
  46. package/src/Popover.tsx +69 -14
  47. package/src/Tooltip.tsx +9 -80
  48. package/src/cn.ts +2 -0
  49. package/src/index.ts +72 -0
  50. package/src/react/useHoverSurface.ts +119 -0
  51. package/src/react/usePopoverSurface.ts +33 -6
  52. package/src/themes/components.ts +2 -0
@@ -0,0 +1,179 @@
1
+ 'use client'
2
+
3
+ import { createContext, useContext, type ReactNode } from 'react'
4
+ import { Link, type LinkProps, type LinkRenderProps } from './Link.js'
5
+ import {
6
+ Popover,
7
+ PopoverPortal,
8
+ PopoverContentRoot,
9
+ usePopoverContext,
10
+ type PopoverProps,
11
+ type PopoverState,
12
+ type PopoverContentProps
13
+ } from './Popover.js'
14
+ import { useComposedRefs } from './react/useComposedRefs.js'
15
+ import { useHoverSurface } from './react/useHoverSurface.js'
16
+ import { composeAction } from './internal/events.js'
17
+ import { joinIds } from './internal/ids.js'
18
+ import { cn } from './cn.js'
19
+
20
+ export type HoverCardProps = PopoverProps & { openDelay?: number; closeDelay?: number }
21
+ export type HoverCardState = PopoverState
22
+ export type HoverCardRenderProps = Omit<LinkRenderProps, 'data-slot'> & { 'data-slot': string }
23
+ export type HoverCardTriggerProps = Omit<
24
+ LinkProps,
25
+ 'href' | 'render' | 'aria-controls' | 'aria-expanded'
26
+ > & {
27
+ href: string
28
+ render?: (props: HoverCardRenderProps) => ReturnType<NonNullable<LinkProps['render']>>
29
+ 'data-slot'?: string
30
+ }
31
+ export type HoverCardContentProps = Omit<PopoverContentProps, 'initialFocusRef'>
32
+ export type HoverCardPortalProps = { children?: ReactNode }
33
+ type Context = ReturnType<typeof usePopoverContext> & ReturnType<typeof useHoverSurface>
34
+ const HoverCardContext = createContext<Context | null>(null)
35
+ export function useHoverCard(): HoverCardState | null {
36
+ return useContext(HoverCardContext)
37
+ }
38
+ function useHoverCardContext() {
39
+ const card = useContext(HoverCardContext)
40
+ if (!card) throw new Error('HoverCard parts must render inside HoverCard.')
41
+ return card
42
+ }
43
+ export function HoverCard({
44
+ openDelay = 500,
45
+ closeDelay = 150,
46
+ children,
47
+ ...props
48
+ }: HoverCardProps) {
49
+ if (![openDelay, closeDelay].every(n => Number.isFinite(n) && n >= 0))
50
+ throw new TypeError('HoverCard delays must be finite, nonnegative numbers.')
51
+ return (
52
+ <Popover {...props}>
53
+ <HoverCardOwner
54
+ openDelay={openDelay}
55
+ closeDelay={closeDelay}
56
+ >
57
+ {children}
58
+ </HoverCardOwner>
59
+ </Popover>
60
+ )
61
+ }
62
+ function HoverCardOwner({
63
+ children,
64
+ openDelay,
65
+ closeDelay
66
+ }: {
67
+ children?: ReactNode
68
+ openDelay: number
69
+ closeDelay: number
70
+ }) {
71
+ const card = usePopoverContext()
72
+ const hover = useHoverSurface({
73
+ trigger: card.trigger,
74
+ content: card.content,
75
+ open: card.open,
76
+ request: card.setOpen,
77
+ openDelay,
78
+ focusDelay: openDelay,
79
+ closeDelay
80
+ })
81
+ return (
82
+ <HoverCardContext.Provider value={{ ...card, ...hover }}>{children}</HoverCardContext.Provider>
83
+ )
84
+ }
85
+ export function HoverCardTrigger({
86
+ ref,
87
+ render,
88
+ onFocus,
89
+ onBlur,
90
+ onPointerEnter,
91
+ onPointerLeave,
92
+ onPointerDown,
93
+ onClick,
94
+ ...props
95
+ }: HoverCardTriggerProps) {
96
+ if (typeof props.href !== 'string')
97
+ throw new TypeError('HoverCardTrigger requires a navigation href.')
98
+ const card = useHoverCardContext(),
99
+ host = useComposedRefs<HTMLAnchorElement>(card.setTrigger, ref)
100
+ return (
101
+ <Link
102
+ {...props}
103
+ ref={host}
104
+ aria-controls={card.contentId}
105
+ aria-expanded={card.open}
106
+ render={resolved => {
107
+ const scoped: HoverCardRenderProps = {
108
+ ...resolved,
109
+ 'data-slot':
110
+ joinIds('link', 'hover-card-trigger', props['data-slot']) ?? 'link hover-card-trigger'
111
+ }
112
+ return render ? render(scoped) : <a {...scoped}>{scoped.children}</a>
113
+ }}
114
+ onFocus={composeAction(onFocus, () => card.enter(true))}
115
+ onBlur={event => {
116
+ onBlur?.(event)
117
+ const next = event.relatedTarget
118
+ if (
119
+ next instanceof event.currentTarget.ownerDocument.defaultView!.Node &&
120
+ card.content.current?.contains(next)
121
+ )
122
+ return
123
+ card.leave(true)
124
+ }}
125
+ onPointerEnter={composeAction(onPointerEnter, event => {
126
+ if (event.pointerType !== 'touch') card.enter()
127
+ })}
128
+ onPointerLeave={composeAction(onPointerLeave, event => {
129
+ if (event.pointerType !== 'touch') card.leave()
130
+ })}
131
+ onPointerDown={event => {
132
+ onPointerDown?.(event)
133
+ if (event.pointerType === 'touch') card.touch()
134
+ }}
135
+ onClick={composeAction(onClick, card.dismiss)}
136
+ />
137
+ )
138
+ }
139
+ export function HoverCardPortal(props: HoverCardPortalProps) {
140
+ useHoverCardContext()
141
+ return <PopoverPortal {...props} />
142
+ }
143
+ export function HoverCardContent({
144
+ className,
145
+ onPointerEnter,
146
+ onPointerLeave,
147
+ onFocus,
148
+ onBlur,
149
+ ...props
150
+ }: HoverCardContentProps) {
151
+ const card = useHoverCardContext()
152
+ return (
153
+ <PopoverContentRoot
154
+ onFocusOutside={() => card.leave(true)}
155
+ {...props}
156
+ initialFocusRef={undefined}
157
+ data-slot={joinIds('hover-card-content', props['data-slot'])}
158
+ className={cn('w-[var(--rad-hover-card-width,var(--rad-popover-width,20rem))]', className)}
159
+ onPointerEnter={composeAction(onPointerEnter, event => {
160
+ if (event.pointerType !== 'touch') card.enter()
161
+ })}
162
+ onPointerLeave={composeAction(onPointerLeave, event => {
163
+ if (event.pointerType !== 'touch') card.leave()
164
+ })}
165
+ onFocus={composeAction(onFocus, () => card.enter(true))}
166
+ onBlur={event => {
167
+ onBlur?.(event)
168
+ const next = event.relatedTarget,
169
+ node = event.currentTarget
170
+ if (
171
+ next instanceof node.ownerDocument.defaultView!.Node &&
172
+ (node.contains(next) || card.trigger?.contains(next))
173
+ )
174
+ return
175
+ card.leave(true)
176
+ }}
177
+ />
178
+ )
179
+ }