@cognitap/radiant 0.0.13 → 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.
Files changed (44) hide show
  1. package/CHANGELOG.md +9 -1
  2. package/dist/library/AlertDialog.d.ts +25 -0
  3. package/dist/library/AlertDialog.d.ts.map +1 -0
  4. package/dist/library/AlertDialog.js +56 -0
  5. package/dist/library/AlertDialog.js.map +1 -0
  6. package/dist/library/Dialog.d.ts +7 -1
  7. package/dist/library/Dialog.d.ts.map +1 -1
  8. package/dist/library/Dialog.js +33 -16
  9. package/dist/library/Dialog.js.map +1 -1
  10. package/dist/library/Popover.d.ts +44 -0
  11. package/dist/library/Popover.d.ts.map +1 -0
  12. package/dist/library/Popover.js +94 -0
  13. package/dist/library/Popover.js.map +1 -0
  14. package/dist/library/cn.d.ts.map +1 -1
  15. package/dist/library/cn.js +22 -2
  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/internal/popover.d.ts +36 -0
  22. package/dist/library/internal/popover.d.ts.map +1 -0
  23. package/dist/library/internal/popover.js +45 -0
  24. package/dist/library/internal/popover.js.map +1 -0
  25. package/dist/library/react/usePopoverSurface.d.ts +10 -0
  26. package/dist/library/react/usePopoverSurface.d.ts.map +1 -0
  27. package/dist/library/react/usePopoverSurface.js +193 -0
  28. package/dist/library/react/usePopoverSurface.js.map +1 -0
  29. package/dist/library/styles.css +1 -1
  30. package/dist/library/themes/components.d.ts +18 -0
  31. package/dist/library/themes/components.d.ts.map +1 -1
  32. package/dist/library/themes/components.js +18 -0
  33. package/dist/library/themes/components.js.map +1 -1
  34. package/docs/architecture.md +13 -7
  35. package/docs/theming.md +1 -1
  36. package/package.json +1 -1
  37. package/src/AlertDialog.tsx +110 -0
  38. package/src/Dialog.tsx +52 -22
  39. package/src/Popover.tsx +201 -0
  40. package/src/cn.ts +22 -2
  41. package/src/index.ts +40 -0
  42. package/src/internal/popover.ts +66 -0
  43. package/src/react/usePopoverSurface.ts +207 -0
  44. package/src/themes/components.ts +18 -0
@@ -0,0 +1,201 @@
1
+ 'use client'
2
+
3
+ import {
4
+ createContext,
5
+ useContext,
6
+ useId,
7
+ useRef,
8
+ useState,
9
+ type ComponentProps,
10
+ type ReactNode,
11
+ type RefObject
12
+ } from 'react'
13
+ import { createPortal } from 'react-dom'
14
+ import { Button, type ButtonProps, type ButtonRenderProps } from './Button.js'
15
+ import { cn } from './cn.js'
16
+ import { composeAction } from './internal/events.js'
17
+ import { joinIds } from './internal/ids.js'
18
+ import type { PopoverSide, PopoverAlign } from './internal/popover.js'
19
+ import { useControllableState } from './react/useControllableState.js'
20
+ import { useComposedRefs } from './react/useComposedRefs.js'
21
+ import { usePopoverSurface } from './react/usePopoverSurface.js'
22
+ import { useTransitionHost } from './motion/host.js'
23
+ import type { ThemeStyle } from './themes/defineTheme.js'
24
+
25
+ export type { PopoverSide, PopoverAlign } from './internal/popover.js'
26
+ export type PopoverProps = (
27
+ | { open: boolean; defaultOpen?: never }
28
+ | { open?: undefined; defaultOpen?: boolean }
29
+ ) & {
30
+ onOpenChange?: (open: boolean) => void
31
+ children?: ReactNode
32
+ }
33
+ export type PopoverState = { open: boolean; setOpen: (open: boolean) => void; contentId: string }
34
+ type Context = PopoverState & {
35
+ trigger: HTMLButtonElement | null
36
+ setTrigger: (node: HTMLButtonElement | null) => void
37
+ content: RefObject<HTMLDivElement | null>
38
+ restoreFocus: RefObject<boolean>
39
+ close: (restore: boolean) => void
40
+ }
41
+ const PopoverContext = createContext<Context | null>(null)
42
+ export function usePopover(): PopoverState | null {
43
+ return useContext(PopoverContext)
44
+ }
45
+ function usePopoverContext() {
46
+ const value = useContext(PopoverContext)
47
+ if (!value) throw new Error('Popover parts must render inside Popover.')
48
+ return value
49
+ }
50
+ export function Popover({ open, defaultOpen, onOpenChange, children }: PopoverProps) {
51
+ const state = useControllableState({
52
+ name: 'Popover',
53
+ value: open,
54
+ defaultValue: defaultOpen,
55
+ initialValue: false,
56
+ onChange: onOpenChange
57
+ })
58
+ const contentId = useId()
59
+ const [trigger, setTrigger] = useState<HTMLButtonElement | null>(null)
60
+ const content = useRef<HTMLDivElement>(null)
61
+ const restoreFocus = useRef(true)
62
+ const setOpen = (next: boolean) => {
63
+ restoreFocus.current = true
64
+ state.request(next)
65
+ }
66
+ const close = (restore: boolean) => {
67
+ restoreFocus.current = restore
68
+ state.request(false)
69
+ }
70
+ return (
71
+ <PopoverContext.Provider
72
+ value={{
73
+ open: state.value,
74
+ setOpen,
75
+ contentId,
76
+ trigger,
77
+ setTrigger,
78
+ content,
79
+ restoreFocus,
80
+ close
81
+ }}
82
+ >
83
+ {children}
84
+ </PopoverContext.Provider>
85
+ )
86
+ }
87
+
88
+ export type PopoverTriggerProps = ButtonProps
89
+ export type PopoverCloseProps = ButtonProps
90
+ export type PopoverRenderProps = ButtonRenderProps
91
+ export type PopoverPortalProps = { children?: ReactNode }
92
+ export type PopoverContentProps = Omit<ComponentProps<'div'>, 'style' | 'popover' | 'id'> & {
93
+ style?: ThemeStyle
94
+ side?: PopoverSide
95
+ align?: PopoverAlign
96
+ sideOffset?: number
97
+ collisionPadding?: number
98
+ /** Keep focus on the opener by default; optionally focus a descendant on each open. */
99
+ initialFocusRef?: RefObject<HTMLElement | null>
100
+ motion?: 'inherit' | 'off'
101
+ }
102
+
103
+ export function PopoverTrigger({ ref, onClick, ...props }: PopoverTriggerProps) {
104
+ const popover = usePopoverContext()
105
+ const hostRef = useComposedRefs(popover.setTrigger, ref)
106
+ return (
107
+ <Button
108
+ {...props}
109
+ ref={hostRef}
110
+ popoverTarget={undefined}
111
+ popoverTargetAction={undefined}
112
+ aria-controls={popover.contentId}
113
+ aria-expanded={popover.open}
114
+ data-slot={joinIds('popover-trigger', props['data-slot'])}
115
+ onClick={composeAction(onClick, () => popover.setOpen(!popover.open))}
116
+ />
117
+ )
118
+ }
119
+ export function PopoverClose({ onClick, ...props }: PopoverCloseProps) {
120
+ const popover = usePopoverContext()
121
+ return (
122
+ <Button
123
+ {...props}
124
+ popoverTarget={undefined}
125
+ popoverTargetAction={undefined}
126
+ data-slot={joinIds('popover-close', props['data-slot'])}
127
+ onClick={composeAction(onClick, () => popover.close(true))}
128
+ />
129
+ )
130
+ }
131
+ /** The local portal preserves theme, native form ownership and modal ancestry. */
132
+ export function PopoverPortal({ children }: PopoverPortalProps) {
133
+ const popover = usePopoverContext()
134
+ return popover.trigger?.parentElement
135
+ ? createPortal(children, popover.trigger.parentElement)
136
+ : null
137
+ }
138
+
139
+ const surfaceClass = [
140
+ 'fixed right-auto bottom-auto m-0 box-border min-w-0 overflow-auto overscroll-contain text-start antialiased',
141
+ '[&:not(:popover-open)]:hidden',
142
+ 'left-[var(--_rad-popover-left,0px)] top-[var(--_rad-popover-top,0px)] w-[var(--rad-popover-width,20rem)] max-w-[var(--_rad-popover-max-width,calc(100vw-1rem))] max-h-[var(--_rad-popover-max-height,calc(100dvh-1rem))]',
143
+ 'grid gap-[var(--rad-popover-gap,var(--rad-surface-gap,1rem))] p-[var(--rad-popover-padding,var(--rad-surface-padding,1.5rem))]',
144
+ 'rounded-[var(--rad-popover-radius,var(--rad-surface-radius,0.75rem))] [corner-shape:var(--rad-popover-corner-shape,var(--rad-surface-corner-shape,round))]',
145
+ '[border-width:var(--rad-popover-border-width,var(--rad-surface-border-width,1px))] [border-style:var(--rad-popover-border-style,var(--rad-surface-border-style,solid))] [border-color:var(--rad-popover-border-color,var(--rad-color-border))]',
146
+ 'bg-[var(--rad-popover-background,var(--rad-color-surface,white))] [color:var(--rad-popover-color,var(--rad-color-foreground))] [box-shadow:var(--rad-popover-shadow,var(--rad-surface-overlay-shadow,0_8px_32px_#0003))] [backdrop-filter:var(--rad-popover-backdrop-filter,none)]',
147
+ 'font-[family-name:var(--rad-typography-roles-ui-body-family,system-ui,sans-serif)] text-[length:var(--rad-typography-roles-ui-body-size,0.875rem)] font-[number:var(--rad-typography-roles-ui-body-weight,400)] leading-[var(--rad-typography-roles-ui-body-line-height,1.5)] tracking-[var(--rad-typography-roles-ui-body-letter-spacing,-0.011em)]',
148
+ 'focus-visible:outline-solid focus-visible:[outline-color:var(--rad-popover-focus-color,var(--rad-color-focus))] focus-visible:[outline-width:var(--rad-popover-focus-width,var(--rad-focus-width,2px))] focus-visible:[outline-offset:var(--rad-popover-focus-offset,var(--rad-focus-offset,2px))] focus-visible:[outline-style:var(--rad-popover-focus-style,var(--rad-focus-style,solid))]',
149
+ 'transition-colors duration-[var(--rad-motion-color-duration,150ms)] motion-reduce:transition-none',
150
+ 'forced-colors:border-[CanvasText] forced-colors:bg-[Canvas] forced-colors:text-[CanvasText]'
151
+ ].join(' ')
152
+
153
+ export function PopoverContent({
154
+ ref,
155
+ className,
156
+ side = 'bottom',
157
+ align = 'start',
158
+ sideOffset = 8,
159
+ collisionPadding = 8,
160
+ initialFocusRef,
161
+ motion = 'inherit',
162
+ ...props
163
+ }: PopoverContentProps) {
164
+ const popover = usePopoverContext()
165
+ if (![sideOffset, collisionPadding].every(value => Number.isFinite(value) && value >= 0))
166
+ throw new TypeError('Popover offsets and padding must be finite, nonnegative numbers.')
167
+ const hostRef = useComposedRefs(popover.content, ref)
168
+ const {
169
+ ref: transitionRef,
170
+ active: motionActive,
171
+ off: motionOff
172
+ } = useTransitionHost('popup', hostRef, motion === 'off')
173
+ usePopoverSurface(
174
+ popover.content,
175
+ popover.trigger,
176
+ popover.open,
177
+ popover.close,
178
+ popover.restoreFocus,
179
+ { side, align, sideOffset, collisionPadding, initialFocusRef }
180
+ )
181
+ return (
182
+ <div
183
+ {...props}
184
+ ref={transitionRef}
185
+ id={popover.contentId}
186
+ popover="manual"
187
+ data-slot="popover-content"
188
+ data-state={popover.open ? 'open' : 'closed'}
189
+ data-side={side}
190
+ data-align={align}
191
+ data-motion={motion}
192
+ className={cn(
193
+ surfaceClass,
194
+ motionActive &&
195
+ !motionOff &&
196
+ 'opacity-[var(--_rad-popup-enter,0)] motion-reduce:opacity-100',
197
+ className
198
+ )}
199
+ />
200
+ )
201
+ }
package/src/cn.ts CHANGED
@@ -39,9 +39,19 @@ export const cn: CnFunction = createCn({
39
39
  'h-(--rad-slider-height)',
40
40
  'h-(--rad-slider-length)'
41
41
  ],
42
- w: ['w-(--rad-switch-width)', 'w-(--rad-slider-height)', 'w-(--rad-slider-length)'],
42
+ w: [
43
+ 'w-(--rad-popover-width)',
44
+ 'w-(--rad-switch-width)',
45
+ 'w-(--rad-slider-height)',
46
+ 'w-(--rad-slider-length)'
47
+ ],
43
48
  size: ['size-(--rad-slider-thumb-size)', 'size-(--rad-slider-track-size)'],
44
- gap: ['gap-(--rad-switch-gap)', 'gap-(--rad-tabs-gap)', 'gap-(--rad-tabs-list-gap)'],
49
+ gap: [
50
+ 'gap-(--rad-popover-gap)',
51
+ 'gap-(--rad-switch-gap)',
52
+ 'gap-(--rad-tabs-gap)',
53
+ 'gap-(--rad-tabs-list-gap)'
54
+ ],
45
55
  'min-h': ['min-h-(--rad-textarea-min-height)', 'min-h-(--rad-tabs-trigger-height)'],
46
56
  py: ['py-(--rad-textarea-padding-block)'],
47
57
  px: [
@@ -51,12 +61,14 @@ export const cn: CnFunction = createCn({
51
61
  'px-(--rad-tabs-trigger-padding)'
52
62
  ],
53
63
  p: [
64
+ 'p-(--rad-popover-padding)',
54
65
  'p-(--rad-combobox-content-padding)',
55
66
  'p-(--rad-select-content-padding)',
56
67
  'p-(--rad-tabs-list-padding)',
57
68
  'p-(--rad-tabs-content-padding)'
58
69
  ],
59
70
  rounded: [
71
+ 'rounded-(--rad-popover-radius)',
60
72
  'rounded-(--rad-combobox-radius)',
61
73
  'rounded-(--rad-select-radius)',
62
74
  'rounded-(--rad-textarea-radius)',
@@ -73,6 +85,7 @@ export const cn: CnFunction = createCn({
73
85
  'rounded-(--rad-tabs-content-radius)'
74
86
  ],
75
87
  'border-w': [
88
+ 'border-(--rad-popover-border-width)',
76
89
  'border-(--rad-combobox-border-width)',
77
90
  'border-(--rad-select-border-width)',
78
91
  'border-(--rad-textarea-border-width)',
@@ -81,12 +94,14 @@ export const cn: CnFunction = createCn({
81
94
  'border-(--rad-tabs-trigger-border-width)'
82
95
  ],
83
96
  'border-style': [
97
+ 'border-(--rad-popover-border-style)',
84
98
  'border-(--rad-combobox-border-style)',
85
99
  'border-(--rad-select-border-style)',
86
100
  'border-(--rad-textarea-border-style)',
87
101
  'border-(--rad-switch-border-style)'
88
102
  ],
89
103
  shadow: [
104
+ 'shadow-(--rad-popover-shadow)',
90
105
  'shadow-(--rad-combobox-shadow)',
91
106
  'shadow-(--rad-select-shadow)',
92
107
  'shadow-(--rad-combobox-content-shadow)',
@@ -95,6 +110,7 @@ export const cn: CnFunction = createCn({
95
110
  'shadow-(--rad-slider-thumb-shadow)'
96
111
  ],
97
112
  'corner-shape': [
113
+ '[corner-shape:var(--rad-popover-corner-shape)]',
98
114
  '[corner-shape:var(--rad-combobox-corner-shape)]',
99
115
  '[corner-shape:var(--rad-select-corner-shape)]',
100
116
  '[corner-shape:var(--rad-textarea-corner-shape)]',
@@ -103,18 +119,21 @@ export const cn: CnFunction = createCn({
103
119
  '[corner-shape:var(--rad-tabs-corner-shape)]'
104
120
  ],
105
121
  'outline-w': [
122
+ 'outline-(--rad-popover-focus-width)',
106
123
  'outline-(--rad-textarea-focus-width)',
107
124
  'outline-(--rad-switch-focus-width)',
108
125
  'outline-(--rad-slider-focus-width)',
109
126
  'outline-(--rad-tabs-focus-width)'
110
127
  ],
111
128
  'outline-offset': [
129
+ 'outline-offset-(--rad-popover-focus-offset)',
112
130
  'outline-offset-(--rad-textarea-focus-offset)',
113
131
  'outline-offset-(--rad-switch-focus-offset)',
114
132
  'outline-offset-(--rad-slider-focus-offset)',
115
133
  'outline-offset-(--rad-tabs-focus-offset)'
116
134
  ],
117
135
  'outline-style': [
136
+ 'outline-(--rad-popover-focus-style)',
118
137
  'outline-(--rad-textarea-focus-style)',
119
138
  'outline-(--rad-switch-focus-style)',
120
139
  'outline-(--rad-slider-focus-style)',
@@ -122,6 +141,7 @@ export const cn: CnFunction = createCn({
122
141
  ],
123
142
  opacity: ['opacity-(--rad-tabs-disabled-opacity)'],
124
143
  'backdrop-filter': [
144
+ '[backdrop-filter:var(--rad-popover-backdrop-filter)]',
125
145
  '[backdrop-filter:var(--rad-combobox-content-backdrop-filter)]',
126
146
  '[backdrop-filter:var(--rad-select-content-backdrop-filter)]'
127
147
  ],
package/src/index.ts CHANGED
@@ -21,6 +21,25 @@ export type {
21
21
  ComboboxStatusProps
22
22
  } from './Combobox.js'
23
23
  export { Button } from './Button.js'
24
+ export {
25
+ Popover,
26
+ PopoverTrigger,
27
+ PopoverContent,
28
+ PopoverClose,
29
+ PopoverPortal,
30
+ usePopover
31
+ } from './Popover.js'
32
+ export type {
33
+ PopoverProps,
34
+ PopoverState,
35
+ PopoverTriggerProps,
36
+ PopoverContentProps,
37
+ PopoverCloseProps,
38
+ PopoverPortalProps,
39
+ PopoverRenderProps,
40
+ PopoverSide,
41
+ PopoverAlign
42
+ } from './Popover.js'
24
43
  export { Link } from './Link.js'
25
44
  export type { LinkProps, LinkRenderProps, LinkVariant } from './Link.js'
26
45
  export { Field, useField } from './Field.js'
@@ -91,6 +110,27 @@ export type {
91
110
  DialogTitleProps,
92
111
  DialogTriggerProps
93
112
  } from './Dialog.js'
113
+ export {
114
+ AlertDialog,
115
+ AlertDialogTrigger,
116
+ AlertDialogContent,
117
+ AlertDialogTitle,
118
+ AlertDialogDescription,
119
+ AlertDialogAction,
120
+ AlertDialogCancel,
121
+ useAlertDialog
122
+ } from './AlertDialog.js'
123
+ export type {
124
+ AlertDialogProps,
125
+ AlertDialogState,
126
+ AlertDialogRenderProps,
127
+ AlertDialogTriggerProps,
128
+ AlertDialogContentProps,
129
+ AlertDialogTitleProps,
130
+ AlertDialogDescriptionProps,
131
+ AlertDialogActionProps,
132
+ AlertDialogCancelProps
133
+ } from './AlertDialog.js'
94
134
  export {
95
135
  Collapsible,
96
136
  CollapsibleContent,
@@ -0,0 +1,66 @@
1
+ export type PopoverSide = 'top' | 'right' | 'bottom' | 'left'
2
+ export type PopoverAlign = 'start' | 'center' | 'end'
3
+
4
+ type Rect = {
5
+ top: number
6
+ right: number
7
+ bottom: number
8
+ left: number
9
+ width: number
10
+ height: number
11
+ }
12
+
13
+ /** Flip toward more space, constrain the surface, then shift within the visual viewport. */
14
+ export function positionPopover(input: {
15
+ anchor: Rect
16
+ width: number
17
+ height: number
18
+ viewport: { top: number; left: number; width: number; height: number }
19
+ side: PopoverSide
20
+ align: PopoverAlign
21
+ offset: number
22
+ padding: number
23
+ rtl: boolean
24
+ }) {
25
+ const { anchor, viewport, align, rtl } = input
26
+ const padding = Math.max(0, input.padding)
27
+ const offset = Math.max(0, input.offset)
28
+ const leftEdge = viewport.left + padding
29
+ const topEdge = viewport.top + padding
30
+ const rightEdge = Math.max(leftEdge, viewport.left + viewport.width - padding)
31
+ const bottomEdge = Math.max(topEdge, viewport.top + viewport.height - padding)
32
+ const room = {
33
+ top: Math.max(0, anchor.top - offset - topEdge),
34
+ right: Math.max(0, rightEdge - anchor.right - offset),
35
+ bottom: Math.max(0, bottomEdge - anchor.bottom - offset),
36
+ left: Math.max(0, anchor.left - offset - leftEdge)
37
+ }
38
+ const opposite = { top: 'bottom', bottom: 'top', left: 'right', right: 'left' } as const
39
+ let side = input.side
40
+ const vertical = side === 'top' || side === 'bottom'
41
+ const needed = vertical ? input.height : input.width
42
+ if (room[side] < needed && room[opposite[side]] > room[side]) side = opposite[side]
43
+ const maxWidth = Math.min(rightEdge - leftEdge, vertical ? Infinity : room[side])
44
+ const maxHeight = Math.min(bottomEdge - topEdge, vertical ? room[side] : Infinity)
45
+ const width = Math.min(Math.max(0, input.width), maxWidth)
46
+ const height = Math.min(Math.max(0, input.height), maxHeight)
47
+ const cross = (start: number, end: number, size: number, reverse: boolean) =>
48
+ align === 'center'
49
+ ? (start + end - size) / 2
50
+ : (align === 'end') !== reverse
51
+ ? end - size
52
+ : start
53
+ let left = vertical
54
+ ? cross(anchor.left, anchor.right, width, rtl)
55
+ : side === 'right'
56
+ ? anchor.right + offset
57
+ : anchor.left - offset - width
58
+ let top = vertical
59
+ ? side === 'bottom'
60
+ ? anchor.bottom + offset
61
+ : anchor.top - offset - height
62
+ : cross(anchor.top, anchor.bottom, height, false)
63
+ left = Math.max(leftEdge, Math.min(left, rightEdge - width))
64
+ top = Math.max(topEdge, Math.min(top, bottomEdge - height))
65
+ return { left, top, maxWidth, maxHeight, side, align }
66
+ }
@@ -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',