@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.
- package/CHANGELOG.md +9 -1
- package/dist/library/AlertDialog.d.ts +25 -0
- package/dist/library/AlertDialog.d.ts.map +1 -0
- package/dist/library/AlertDialog.js +56 -0
- package/dist/library/AlertDialog.js.map +1 -0
- package/dist/library/Dialog.d.ts +7 -1
- package/dist/library/Dialog.d.ts.map +1 -1
- package/dist/library/Dialog.js +33 -16
- package/dist/library/Dialog.js.map +1 -1
- 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/cn.d.ts.map +1 -1
- package/dist/library/cn.js +22 -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 +18 -0
- package/dist/library/themes/components.d.ts.map +1 -1
- package/dist/library/themes/components.js +18 -0
- package/dist/library/themes/components.js.map +1 -1
- package/docs/architecture.md +13 -7
- package/docs/theming.md +1 -1
- package/package.json +1 -1
- package/src/AlertDialog.tsx +110 -0
- package/src/Dialog.tsx +52 -22
- package/src/Popover.tsx +201 -0
- package/src/cn.ts +22 -2
- package/src/index.ts +40 -0
- package/src/internal/popover.ts +66 -0
- package/src/react/usePopoverSurface.ts +207 -0
- package/src/themes/components.ts +18 -0
package/src/Popover.tsx
ADDED
|
@@ -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: [
|
|
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: [
|
|
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
|
+
}
|
package/src/themes/components.ts
CHANGED
|
@@ -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',
|