@cognitap/radiant 0.0.14 → 0.0.16
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/CHANGELOG.md +10 -2
- package/dist/library/Popover.d.ts +44 -0
- package/dist/library/Popover.d.ts.map +1 -0
- package/dist/library/Popover.js +94 -0
- package/dist/library/Popover.js.map +1 -0
- package/dist/library/Tooltip.d.ts +40 -0
- package/dist/library/Tooltip.d.ts.map +1 -0
- package/dist/library/Tooltip.js +182 -0
- package/dist/library/Tooltip.js.map +1 -0
- package/dist/library/cn.d.ts.map +1 -1
- package/dist/library/cn.js +30 -2
- package/dist/library/cn.js.map +1 -1
- package/dist/library/index.d.ts +4 -0
- package/dist/library/index.d.ts.map +1 -1
- package/dist/library/index.js +2 -0
- package/dist/library/index.js.map +1 -1
- package/dist/library/internal/popover.d.ts +36 -0
- package/dist/library/internal/popover.d.ts.map +1 -0
- package/dist/library/internal/popover.js +45 -0
- package/dist/library/internal/popover.js.map +1 -0
- package/dist/library/react/usePopoverSurface.d.ts +10 -0
- package/dist/library/react/usePopoverSurface.d.ts.map +1 -0
- package/dist/library/react/usePopoverSurface.js +193 -0
- package/dist/library/react/usePopoverSurface.js.map +1 -0
- package/dist/library/styles.css +1 -1
- package/dist/library/themes/components.d.ts +31 -0
- package/dist/library/themes/components.d.ts.map +1 -1
- package/dist/library/themes/components.js +31 -0
- package/dist/library/themes/components.js.map +1 -1
- package/docs/architecture.md +6 -3
- package/docs/theming.md +1 -1
- package/package.json +1 -1
- package/src/Popover.tsx +201 -0
- package/src/Tooltip.tsx +287 -0
- package/src/cn.ts +30 -2
- package/src/index.ts +28 -0
- package/src/internal/popover.ts +66 -0
- package/src/react/usePopoverSurface.ts +207 -0
- package/src/themes/components.ts +31 -0
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
'use client'
|
|
2
|
+
|
|
3
|
+
import { useLayoutEffect, useRef, useState, type RefObject } from 'react'
|
|
4
|
+
import { positionPopover, type PopoverAlign, type PopoverSide } from '../internal/popover.js'
|
|
5
|
+
|
|
6
|
+
// Each document owns its layers; imports never inspect a browser global.
|
|
7
|
+
const layers = new WeakMap<Document, HTMLElement[]>()
|
|
8
|
+
|
|
9
|
+
export function usePopoverSurface<Node extends HTMLElement>(
|
|
10
|
+
nodeRef: RefObject<Node | null>,
|
|
11
|
+
trigger: HTMLButtonElement | null,
|
|
12
|
+
open: boolean,
|
|
13
|
+
close: (restore: boolean) => void,
|
|
14
|
+
restoreFocus: RefObject<boolean>,
|
|
15
|
+
options: {
|
|
16
|
+
initialFocusRef?: RefObject<HTMLElement | null>
|
|
17
|
+
side: PopoverSide
|
|
18
|
+
align: PopoverAlign
|
|
19
|
+
sideOffset: number
|
|
20
|
+
collisionPadding: number
|
|
21
|
+
}
|
|
22
|
+
) {
|
|
23
|
+
const latest = useRef({ ...options, open, close })
|
|
24
|
+
const reposition = useRef(() => {})
|
|
25
|
+
const ancestorClosing = useRef(false)
|
|
26
|
+
const [generation, setGeneration] = useState(0)
|
|
27
|
+
useLayoutEffect(() => {
|
|
28
|
+
latest.current = { ...options, open, close }
|
|
29
|
+
})
|
|
30
|
+
const { side, align, sideOffset, collisionPadding } = options
|
|
31
|
+
|
|
32
|
+
useLayoutEffect(() => {
|
|
33
|
+
const node = nodeRef.current
|
|
34
|
+
if (!node || !trigger) return
|
|
35
|
+
const ancestors: HTMLElement[] = []
|
|
36
|
+
for (let parent = trigger.parentElement; parent; parent = parent.parentElement) {
|
|
37
|
+
if (parent.matches('dialog, [popover]')) ancestors.push(parent)
|
|
38
|
+
}
|
|
39
|
+
const reconcile = () => {
|
|
40
|
+
if (!latest.current.open) return
|
|
41
|
+
const visible = trigger.checkVisibility()
|
|
42
|
+
if (!visible && node.matches(':popover-open')) {
|
|
43
|
+
ancestorClosing.current = true
|
|
44
|
+
latest.current.close(false)
|
|
45
|
+
node.hidePopover()
|
|
46
|
+
setGeneration(value => value + 1)
|
|
47
|
+
} else if (visible && !node.matches(':popover-open')) setGeneration(value => value + 1)
|
|
48
|
+
}
|
|
49
|
+
const observer = new node.ownerDocument.defaultView!.MutationObserver(reconcile)
|
|
50
|
+
for (const ancestor of ancestors) {
|
|
51
|
+
observer.observe(ancestor, { attributes: true, attributeFilter: ['open', 'data-state'] })
|
|
52
|
+
ancestor.addEventListener('toggle', reconcile)
|
|
53
|
+
}
|
|
54
|
+
return () => {
|
|
55
|
+
observer.disconnect()
|
|
56
|
+
for (const ancestor of ancestors) ancestor.removeEventListener('toggle', reconcile)
|
|
57
|
+
}
|
|
58
|
+
}, [nodeRef, trigger])
|
|
59
|
+
|
|
60
|
+
useLayoutEffect(() => {
|
|
61
|
+
const node = nodeRef.current
|
|
62
|
+
if (!node || !trigger || !open || !trigger.checkVisibility() || generation < 0) return
|
|
63
|
+
const doc = node.ownerDocument
|
|
64
|
+
const win = doc.defaultView!
|
|
65
|
+
const shouldRestore = () => restoreFocus.current
|
|
66
|
+
const place = () => {
|
|
67
|
+
if (!node.isConnected || !node.matches(':popover-open')) return
|
|
68
|
+
const { side, align, sideOffset, collisionPadding } = latest.current
|
|
69
|
+
const viewport = win.visualViewport
|
|
70
|
+
const view = {
|
|
71
|
+
top: viewport?.offsetTop ?? 0,
|
|
72
|
+
left: viewport?.offsetLeft ?? 0,
|
|
73
|
+
width: viewport?.width ?? win.innerWidth,
|
|
74
|
+
height: viewport?.height ?? win.innerHeight
|
|
75
|
+
}
|
|
76
|
+
node.style.setProperty(
|
|
77
|
+
'--_rad-popover-max-width',
|
|
78
|
+
`${Math.max(0, view.width - 2 * collisionPadding)}px`
|
|
79
|
+
)
|
|
80
|
+
node.style.setProperty(
|
|
81
|
+
'--_rad-popover-max-height',
|
|
82
|
+
`${Math.max(0, view.height - 2 * collisionPadding)}px`
|
|
83
|
+
)
|
|
84
|
+
const css = win.getComputedStyle(node)
|
|
85
|
+
const next = positionPopover({
|
|
86
|
+
anchor: trigger.getBoundingClientRect(),
|
|
87
|
+
width: node.offsetWidth,
|
|
88
|
+
height:
|
|
89
|
+
node.scrollHeight + parseFloat(css.borderTopWidth) + parseFloat(css.borderBottomWidth),
|
|
90
|
+
viewport: view,
|
|
91
|
+
side,
|
|
92
|
+
align,
|
|
93
|
+
offset: sideOffset,
|
|
94
|
+
padding: collisionPadding,
|
|
95
|
+
rtl: win.getComputedStyle(trigger).direction === 'rtl'
|
|
96
|
+
})
|
|
97
|
+
for (const key of ['left', 'top', 'maxWidth', 'maxHeight'] as const) {
|
|
98
|
+
const property = key === 'maxWidth' ? 'max-width' : key === 'maxHeight' ? 'max-height' : key
|
|
99
|
+
node.style.setProperty(`--_rad-popover-${property}`, `${next[key]}px`)
|
|
100
|
+
}
|
|
101
|
+
node.dataset.side = next.side
|
|
102
|
+
node.dataset.align = next.align
|
|
103
|
+
}
|
|
104
|
+
// A manual native popover keeps controlled owners authoritative and avoids auto-stack reopen loops.
|
|
105
|
+
// The source preserves the browser's logical Tab order without assigning content semantics.
|
|
106
|
+
node.showPopover({ source: trigger })
|
|
107
|
+
ancestorClosing.current = false
|
|
108
|
+
reposition.current = place
|
|
109
|
+
place()
|
|
110
|
+
const target = latest.current.initialFocusRef?.current
|
|
111
|
+
if (target && node.contains(target)) target.focus({ preventScroll: true })
|
|
112
|
+
const stack = layers.get(doc) ?? []
|
|
113
|
+
layers.set(doc, stack)
|
|
114
|
+
const descendant = stack.findIndex(layer => node.contains(layer))
|
|
115
|
+
if (descendant < 0) stack.push(node)
|
|
116
|
+
else stack.splice(descendant, 0, node)
|
|
117
|
+
let frame = 0
|
|
118
|
+
const schedule = () => {
|
|
119
|
+
if (!frame)
|
|
120
|
+
frame = win.requestAnimationFrame(() => {
|
|
121
|
+
frame = 0
|
|
122
|
+
place()
|
|
123
|
+
})
|
|
124
|
+
}
|
|
125
|
+
const inside = (target: EventTarget | null) =>
|
|
126
|
+
target instanceof win.Node && (node.contains(target) || trigger.contains(target))
|
|
127
|
+
let pointerDismissed = false
|
|
128
|
+
const pointerEnd = () => {
|
|
129
|
+
pointerDismissed = false
|
|
130
|
+
}
|
|
131
|
+
const outside = (event: PointerEvent | FocusEvent) => {
|
|
132
|
+
if (
|
|
133
|
+
event.type === 'focusin' &&
|
|
134
|
+
(event.target === doc.body || event.target === doc.documentElement)
|
|
135
|
+
)
|
|
136
|
+
return
|
|
137
|
+
if (event.type === 'focusin' && pointerDismissed) return
|
|
138
|
+
if (event.type === 'pointerdown') pointerDismissed = !inside(event.target)
|
|
139
|
+
if (!inside(event.target)) latest.current.close(false)
|
|
140
|
+
}
|
|
141
|
+
const escape = (event: KeyboardEvent) => {
|
|
142
|
+
if (
|
|
143
|
+
event.key !== 'Escape' ||
|
|
144
|
+
event.defaultPrevented ||
|
|
145
|
+
stack.filter(layer => layer.matches(':popover-open')).at(-1) !== node
|
|
146
|
+
)
|
|
147
|
+
return
|
|
148
|
+
const modal = Array.from(doc.querySelectorAll('dialog:modal')).at(-1)
|
|
149
|
+
if (modal && !modal.contains(node)) return
|
|
150
|
+
const nested =
|
|
151
|
+
event.target instanceof win.Element ? event.target.closest('[popover]:popover-open') : null
|
|
152
|
+
if (
|
|
153
|
+
nested &&
|
|
154
|
+
nested !== node &&
|
|
155
|
+
node.contains(nested) &&
|
|
156
|
+
nested.getAttribute('popover') !== 'manual'
|
|
157
|
+
)
|
|
158
|
+
return
|
|
159
|
+
event.preventDefault()
|
|
160
|
+
event.stopPropagation()
|
|
161
|
+
latest.current.close(true)
|
|
162
|
+
}
|
|
163
|
+
const toggle = () => {
|
|
164
|
+
if (ancestorClosing.current || node.matches(':popover-open') || !latest.current.open) return
|
|
165
|
+
latest.current.close(true)
|
|
166
|
+
// Native hide is an observation; a controlled owner may refuse the request.
|
|
167
|
+
setGeneration(value => value + 1)
|
|
168
|
+
}
|
|
169
|
+
const observer = new win.ResizeObserver(schedule)
|
|
170
|
+
const mutations = new win.MutationObserver(schedule)
|
|
171
|
+
observer.observe(trigger)
|
|
172
|
+
observer.observe(node)
|
|
173
|
+
mutations.observe(node, { childList: true, subtree: true, characterData: true })
|
|
174
|
+
node.addEventListener('toggle', toggle)
|
|
175
|
+
doc.addEventListener('pointerdown', outside, true)
|
|
176
|
+
doc.addEventListener('pointerup', pointerEnd, true)
|
|
177
|
+
doc.addEventListener('pointercancel', pointerEnd, true)
|
|
178
|
+
doc.addEventListener('focusin', outside)
|
|
179
|
+
doc.addEventListener('keydown', escape)
|
|
180
|
+
doc.addEventListener('scroll', schedule, true)
|
|
181
|
+
win.addEventListener('resize', schedule)
|
|
182
|
+
win.visualViewport?.addEventListener('resize', schedule)
|
|
183
|
+
win.visualViewport?.addEventListener('scroll', schedule)
|
|
184
|
+
return () => {
|
|
185
|
+
observer.disconnect()
|
|
186
|
+
mutations.disconnect()
|
|
187
|
+
win.cancelAnimationFrame(frame)
|
|
188
|
+
node.removeEventListener('toggle', toggle)
|
|
189
|
+
doc.removeEventListener('pointerdown', outside, true)
|
|
190
|
+
doc.removeEventListener('pointerup', pointerEnd, true)
|
|
191
|
+
doc.removeEventListener('pointercancel', pointerEnd, true)
|
|
192
|
+
doc.removeEventListener('focusin', outside)
|
|
193
|
+
doc.removeEventListener('keydown', escape)
|
|
194
|
+
doc.removeEventListener('scroll', schedule, true)
|
|
195
|
+
win.removeEventListener('resize', schedule)
|
|
196
|
+
win.visualViewport?.removeEventListener('resize', schedule)
|
|
197
|
+
win.visualViewport?.removeEventListener('scroll', schedule)
|
|
198
|
+
stack.splice(stack.indexOf(node), 1)
|
|
199
|
+
if (!stack.length) layers.delete(doc)
|
|
200
|
+
if (shouldRestore() && node.contains(doc.activeElement) && trigger.isConnected)
|
|
201
|
+
trigger.focus({ preventScroll: true })
|
|
202
|
+
if (node.matches(':popover-open')) node.hidePopover()
|
|
203
|
+
reposition.current = () => {}
|
|
204
|
+
}
|
|
205
|
+
}, [nodeRef, trigger, open, generation, restoreFocus])
|
|
206
|
+
useLayoutEffect(() => reposition.current(), [side, align, sideOffset, collisionPadding])
|
|
207
|
+
}
|
package/src/themes/components.ts
CHANGED
|
@@ -288,6 +288,37 @@ 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
|
+
},
|
|
304
|
+
popover: {
|
|
305
|
+
width: 'css',
|
|
306
|
+
padding: 'css',
|
|
307
|
+
gap: 'css',
|
|
308
|
+
radius: 'css',
|
|
309
|
+
cornerShape: 'css',
|
|
310
|
+
background: 'css',
|
|
311
|
+
color: 'css',
|
|
312
|
+
borderWidth: 'css',
|
|
313
|
+
borderStyle: 'css',
|
|
314
|
+
borderColor: 'css',
|
|
315
|
+
shadow: 'css',
|
|
316
|
+
backdropFilter: 'css',
|
|
317
|
+
focusColor: 'css',
|
|
318
|
+
focusWidth: 'css',
|
|
319
|
+
focusOffset: 'css',
|
|
320
|
+
focusStyle: 'css'
|
|
321
|
+
},
|
|
291
322
|
dialog: {
|
|
292
323
|
width: 'css',
|
|
293
324
|
padding: 'css',
|