@cognitap/radiant 0.0.14 → 0.0.15

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.
@@ -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(
10
+ nodeRef: RefObject<HTMLDivElement | 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
+ }
@@ -288,6 +288,24 @@ export const componentRegistry = {
288
288
  focusOffset: 'css',
289
289
  focusStyle: 'css'
290
290
  },
291
+ popover: {
292
+ width: 'css',
293
+ padding: 'css',
294
+ gap: 'css',
295
+ radius: 'css',
296
+ cornerShape: 'css',
297
+ background: 'css',
298
+ color: 'css',
299
+ borderWidth: 'css',
300
+ borderStyle: 'css',
301
+ borderColor: 'css',
302
+ shadow: 'css',
303
+ backdropFilter: 'css',
304
+ focusColor: 'css',
305
+ focusWidth: 'css',
306
+ focusOffset: 'css',
307
+ focusStyle: 'css'
308
+ },
291
309
  dialog: {
292
310
  width: 'css',
293
311
  padding: 'css',