@cognitap/radiant 0.0.83 → 0.0.85
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 +36 -0
- package/dist/library/color/colorValue.d.ts +8 -0
- package/dist/library/color/colorValue.d.ts.map +1 -0
- package/dist/library/color/colorValue.js +87 -0
- package/dist/library/color/colorValue.js.map +1 -0
- package/dist/library/color/oklch.d.ts +2 -0
- package/dist/library/color/oklch.d.ts.map +1 -1
- package/dist/library/color/oklch.js +27 -11
- package/dist/library/color/oklch.js.map +1 -1
- package/dist/library/components/Cascader/Cascader.d.ts +25 -0
- package/dist/library/components/Cascader/Cascader.d.ts.map +1 -0
- package/dist/library/components/Cascader/Cascader.js +154 -0
- package/dist/library/components/Cascader/Cascader.js.map +1 -0
- package/dist/library/components/Cascader/CascaderColumn.d.ts +25 -0
- package/dist/library/components/Cascader/CascaderColumn.d.ts.map +1 -0
- package/dist/library/components/Cascader/CascaderColumn.js +80 -0
- package/dist/library/components/Cascader/CascaderColumn.js.map +1 -0
- package/dist/library/components/CodeBlock/CodeBlock.d.ts.map +1 -1
- package/dist/library/components/CodeBlock/CodeBlock.js +3 -37
- package/dist/library/components/CodeBlock/CodeBlock.js.map +1 -1
- package/dist/library/components/Collapsible/Collapsible.d.ts +5 -1
- package/dist/library/components/Collapsible/Collapsible.d.ts.map +1 -1
- package/dist/library/components/Collapsible/Collapsible.js +13 -3
- package/dist/library/components/Collapsible/Collapsible.js.map +1 -1
- package/dist/library/components/ColorInput/ColorInput.d.ts +22 -0
- package/dist/library/components/ColorInput/ColorInput.d.ts.map +1 -0
- package/dist/library/components/ColorInput/ColorInput.js +63 -0
- package/dist/library/components/ColorInput/ColorInput.js.map +1 -0
- package/dist/library/components/ColorPicker/ColorArea.d.ts +11 -0
- package/dist/library/components/ColorPicker/ColorArea.d.ts.map +1 -0
- package/dist/library/components/ColorPicker/ColorArea.js +58 -0
- package/dist/library/components/ColorPicker/ColorArea.js.map +1 -0
- package/dist/library/components/ColorPicker/ColorPicker.d.ts +37 -0
- package/dist/library/components/ColorPicker/ColorPicker.d.ts.map +1 -0
- package/dist/library/components/ColorPicker/ColorPicker.js +135 -0
- package/dist/library/components/ColorPicker/ColorPicker.js.map +1 -0
- package/dist/library/components/CopyButton/CopyButton.d.ts +17 -0
- package/dist/library/components/CopyButton/CopyButton.d.ts.map +1 -0
- package/dist/library/components/CopyButton/CopyButton.js +22 -0
- package/dist/library/components/CopyButton/CopyButton.js.map +1 -0
- package/dist/library/components/DataTable/DataTable.d.ts +47 -0
- package/dist/library/components/DataTable/DataTable.d.ts.map +1 -0
- package/dist/library/components/DataTable/DataTable.js +146 -0
- package/dist/library/components/DataTable/DataTable.js.map +1 -0
- package/dist/library/components/Dropzone/Dropzone.d.ts +26 -0
- package/dist/library/components/Dropzone/Dropzone.d.ts.map +1 -0
- package/dist/library/components/Dropzone/Dropzone.js +118 -0
- package/dist/library/components/Dropzone/Dropzone.js.map +1 -0
- package/dist/library/components/Highlight/Highlight.d.ts +15 -0
- package/dist/library/components/Highlight/Highlight.d.ts.map +1 -0
- package/dist/library/components/Highlight/Highlight.js +69 -0
- package/dist/library/components/Highlight/Highlight.js.map +1 -0
- package/dist/library/components/Rating/Rating.d.ts +21 -0
- package/dist/library/components/Rating/Rating.d.ts.map +1 -0
- package/dist/library/components/Rating/Rating.js +81 -0
- package/dist/library/components/Rating/Rating.js.map +1 -0
- package/dist/library/components/Select/Select.d.ts +3 -9
- package/dist/library/components/Select/Select.d.ts.map +1 -1
- package/dist/library/components/Select/Select.js +16 -156
- package/dist/library/components/Select/Select.js.map +1 -1
- package/dist/library/components/Select/SelectPopup.d.ts +29 -0
- package/dist/library/components/Select/SelectPopup.d.ts.map +1 -0
- package/dist/library/components/Select/SelectPopup.js +179 -0
- package/dist/library/components/Select/SelectPopup.js.map +1 -0
- package/dist/library/components/Slider/Slider.d.ts +2 -2
- package/dist/library/components/Slider/Slider.d.ts.map +1 -1
- package/dist/library/components/Slider/Slider.js +44 -3
- package/dist/library/components/Slider/Slider.js.map +1 -1
- package/dist/library/components/Spoiler/Spoiler.d.ts +15 -0
- package/dist/library/components/Spoiler/Spoiler.d.ts.map +1 -0
- package/dist/library/components/Spoiler/Spoiler.js +34 -0
- package/dist/library/components/Spoiler/Spoiler.js.map +1 -0
- package/dist/library/components/Stepper/Stepper.d.ts +48 -0
- package/dist/library/components/Stepper/Stepper.d.ts.map +1 -0
- package/dist/library/components/Stepper/Stepper.js +81 -0
- package/dist/library/components/Stepper/Stepper.js.map +1 -0
- package/dist/library/components/Timeline/Timeline.d.ts +30 -0
- package/dist/library/components/Timeline/Timeline.d.ts.map +1 -0
- package/dist/library/components/Timeline/Timeline.js +15 -0
- package/dist/library/components/Timeline/Timeline.js.map +1 -0
- package/dist/library/components/Tour/Tour.d.ts +31 -0
- package/dist/library/components/Tour/Tour.d.ts.map +1 -0
- package/dist/library/components/Tour/Tour.js +145 -0
- package/dist/library/components/Tour/Tour.js.map +1 -0
- package/dist/library/components/Tree/Tree.d.ts +48 -0
- package/dist/library/components/Tree/Tree.d.ts.map +1 -0
- package/dist/library/components/Tree/Tree.js +298 -0
- package/dist/library/components/Tree/Tree.js.map +1 -0
- package/dist/library/components/Tree/treeModel.d.ts +43 -0
- package/dist/library/components/Tree/treeModel.d.ts.map +1 -0
- package/dist/library/components/Tree/treeModel.js +83 -0
- package/dist/library/components/Tree/treeModel.js.map +1 -0
- package/dist/library/components/Tree/useTreeLoading.d.ts +6 -0
- package/dist/library/components/Tree/useTreeLoading.d.ts.map +1 -0
- package/dist/library/components/Tree/useTreeLoading.js +69 -0
- package/dist/library/components/Tree/useTreeLoading.js.map +1 -0
- package/dist/library/components/TreeSelect/TreeSelect.d.ts +29 -0
- package/dist/library/components/TreeSelect/TreeSelect.d.ts.map +1 -0
- package/dist/library/components/TreeSelect/TreeSelect.js +163 -0
- package/dist/library/components/TreeSelect/TreeSelect.js.map +1 -0
- package/dist/library/index.d.ts +19 -0
- package/dist/library/index.d.ts.map +1 -1
- package/dist/library/index.js +14 -0
- package/dist/library/index.js.map +1 -1
- package/dist/library/motion/transitions.d.ts.map +1 -1
- package/dist/library/motion/transitions.js +8 -3
- package/dist/library/motion/transitions.js.map +1 -1
- package/dist/library/react/useClipboardCopy.d.ts +8 -0
- package/dist/library/react/useClipboardCopy.d.ts.map +1 -0
- package/dist/library/react/useClipboardCopy.js +49 -0
- package/dist/library/react/useClipboardCopy.js.map +1 -0
- package/dist/library/react/useFormReset.d.ts +1 -1
- package/dist/library/react/useFormReset.d.ts.map +1 -1
- package/dist/library/react/useFormReset.js.map +1 -1
- package/dist/library/react/usePopoverSurface.d.ts.map +1 -1
- package/dist/library/react/usePopoverSurface.js +3 -2
- package/dist/library/react/usePopoverSurface.js.map +1 -1
- package/dist/library/styles.css +1 -1
- package/package.json +1 -1
- package/src/color/colorValue.ts +89 -0
- package/src/color/oklch.ts +33 -14
- package/src/components/Cascader/Cascader.tsx +315 -0
- package/src/components/Cascader/CascaderColumn.tsx +203 -0
- package/src/components/CodeBlock/CodeBlock.tsx +3 -45
- package/src/components/Collapsible/Collapsible.tsx +22 -4
- package/src/components/ColorInput/ColorInput.tsx +191 -0
- package/src/components/ColorPicker/ColorArea.tsx +98 -0
- package/src/components/ColorPicker/ColorPicker.tsx +283 -0
- package/src/components/CopyButton/CopyButton.tsx +75 -0
- package/src/components/DataTable/DataTable.tsx +384 -0
- package/src/components/Dropzone/Dropzone.tsx +230 -0
- package/src/components/Highlight/Highlight.tsx +112 -0
- package/src/components/Rating/Rating.tsx +202 -0
- package/src/components/Select/Select.tsx +20 -192
- package/src/components/Select/SelectPopup.tsx +246 -0
- package/src/components/Slider/Slider.tsx +51 -2
- package/src/components/Spoiler/Spoiler.tsx +96 -0
- package/src/components/Stepper/Stepper.tsx +306 -0
- package/src/components/Timeline/Timeline.tsx +139 -0
- package/src/components/Tour/Tour.tsx +335 -0
- package/src/components/Tree/Tree.tsx +530 -0
- package/src/components/Tree/treeModel.ts +110 -0
- package/src/components/Tree/useTreeLoading.ts +73 -0
- package/src/components/TreeSelect/TreeSelect.tsx +326 -0
- package/src/index.ts +50 -0
- package/src/motion/transitions.ts +8 -3
- package/src/react/useClipboardCopy.ts +54 -0
- package/src/react/useFormReset.ts +4 -1
- package/src/react/usePopoverSurface.ts +3 -2
|
@@ -0,0 +1,530 @@
|
|
|
1
|
+
'use client'
|
|
2
|
+
/* oxlint-disable jsx-a11y/prefer-tag-over-role -- Tree groups are owned by tree items. */
|
|
3
|
+
|
|
4
|
+
import {
|
|
5
|
+
Fragment,
|
|
6
|
+
useCallback,
|
|
7
|
+
useEffect,
|
|
8
|
+
useId,
|
|
9
|
+
useLayoutEffect,
|
|
10
|
+
useMemo,
|
|
11
|
+
useRef,
|
|
12
|
+
useState,
|
|
13
|
+
type ComponentProps,
|
|
14
|
+
type ReactElement,
|
|
15
|
+
type KeyboardEvent
|
|
16
|
+
} from 'react'
|
|
17
|
+
import { cn } from 'cn'
|
|
18
|
+
import { requireAccessibleName, type AccessibleName } from '../../internal/accessibleName.js'
|
|
19
|
+
import { composeAction } from '../../internal/events.js'
|
|
20
|
+
import { joinIds } from '../../internal/ids.js'
|
|
21
|
+
import { nextSelection, sameSelection, type Selection } from '../../internal/selection.js'
|
|
22
|
+
import { matchSelectText } from '../../internal/select.js'
|
|
23
|
+
import { useComposedRefs } from '../../react/useComposedRefs.js'
|
|
24
|
+
import { useControllableState } from '../../react/useControllableState.js'
|
|
25
|
+
import { useLocaleMatcher } from '../../react/useLocale.js'
|
|
26
|
+
import type { StateOwner, ValueOwner } from '../../react/useNativeOwner.js'
|
|
27
|
+
import type { ThemeStyle } from '../../themes/defineTheme.js'
|
|
28
|
+
import {
|
|
29
|
+
branchChecks,
|
|
30
|
+
buildTree,
|
|
31
|
+
selectableLeaves,
|
|
32
|
+
visibleTree,
|
|
33
|
+
type TreeItem,
|
|
34
|
+
type TreeNode
|
|
35
|
+
} from './treeModel.js'
|
|
36
|
+
import { useTreeLoading } from './useTreeLoading.js'
|
|
37
|
+
import { focusRingClass } from '../shared/focusStyles.js'
|
|
38
|
+
import { scrollbarClass } from '../shared/scrollbarStyles.js'
|
|
39
|
+
|
|
40
|
+
export type { TreeItem } from './treeModel.js'
|
|
41
|
+
|
|
42
|
+
export type TreeVirtual = {
|
|
43
|
+
/** Scroll viewport height in pixels. */
|
|
44
|
+
height: number
|
|
45
|
+
/** Fixed row height in pixels. Labels use one line. */
|
|
46
|
+
rowHeight: number
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
type TreeSelection<Value> = ValueOwner<Value> & { onValueChange?: (value: Value) => void }
|
|
50
|
+
|
|
51
|
+
export type TreeProps = AccessibleName &
|
|
52
|
+
Omit<
|
|
53
|
+
ComponentProps<'div'>,
|
|
54
|
+
| 'children'
|
|
55
|
+
| 'dangerouslySetInnerHTML'
|
|
56
|
+
| 'role'
|
|
57
|
+
| 'tabIndex'
|
|
58
|
+
| 'style'
|
|
59
|
+
| 'contentEditable'
|
|
60
|
+
| 'defaultValue'
|
|
61
|
+
> &
|
|
62
|
+
StateOwner<'expanded', string[]> & {
|
|
63
|
+
items: readonly TreeItem[]
|
|
64
|
+
onExpandedChange?: (expanded: string[]) => void
|
|
65
|
+
loadingText?: string
|
|
66
|
+
/** Displayed on an expanded branch whose load failed. Enter retries the load. */
|
|
67
|
+
errorText?: string
|
|
68
|
+
virtual?: TreeVirtual
|
|
69
|
+
style?: ThemeStyle
|
|
70
|
+
'data-slot'?: string
|
|
71
|
+
} & (
|
|
72
|
+
| ({ type?: 'single'; checkboxes?: never } & TreeSelection<string | null>)
|
|
73
|
+
| ({ type: 'multiple'; checkboxes?: boolean } & TreeSelection<string[]>)
|
|
74
|
+
)
|
|
75
|
+
|
|
76
|
+
const rowClass =
|
|
77
|
+
'box-border flex min-h-8 items-center gap-2 rounded-[var(--rad-control-radius,0.5rem)] [corner-shape:var(--rad-control-corner-shape,round)] py-1 pe-2 data-disabled:opacity-[var(--rad-state-disabled-opacity,0.5)] not-data-disabled:cursor-pointer not-data-disabled:hover:bg-[var(--rad-color-neutral)] data-selected:bg-[var(--rad-control-selected-background,var(--rad-color-neutral))] data-selected:font-semibold data-selected:[color:var(--rad-control-selected-foreground,var(--rad-color-foreground))] group-focus-visible/tree:data-active:[outline:2px_solid_var(--rad-color-focus)] group-focus-visible/tree:data-active:outline-offset-[-2px] group-focus-visible/tree:forced-colors:data-active:outline-[Highlight] forced-colors:data-selected:underline'
|
|
78
|
+
|
|
79
|
+
export function treeValues(value: Selection, multiple: boolean, name: string) {
|
|
80
|
+
if (
|
|
81
|
+
multiple
|
|
82
|
+
? !Array.isArray(value) ||
|
|
83
|
+
new Set(value).size !== value.length ||
|
|
84
|
+
value.some(item => typeof item !== 'string' || !item)
|
|
85
|
+
: value !== null && (typeof value !== 'string' || !value)
|
|
86
|
+
)
|
|
87
|
+
throw new TypeError(`Tree ${name} must match its mode and contain unique, nonempty values.`)
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
export function useTreeCollection(items: readonly TreeItem[]) {
|
|
91
|
+
const { loads, load } = useTreeLoading(items)
|
|
92
|
+
const model = useMemo(() => buildTree(items, loads), [items, loads])
|
|
93
|
+
return { model, load }
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
export function Tree(props: TreeProps) {
|
|
97
|
+
const collection = useTreeCollection(props.items)
|
|
98
|
+
return (
|
|
99
|
+
<TreeRoot
|
|
100
|
+
{...props}
|
|
101
|
+
collection={collection}
|
|
102
|
+
/>
|
|
103
|
+
)
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** TreeSelect shares the loaded registry so a committed item's path remains available when closed. */
|
|
107
|
+
export function TreeRoot(
|
|
108
|
+
props: TreeProps & {
|
|
109
|
+
collection: ReturnType<typeof useTreeCollection>
|
|
110
|
+
onSelectionCommit?: () => void
|
|
111
|
+
revealOnFocus?: boolean
|
|
112
|
+
}
|
|
113
|
+
) {
|
|
114
|
+
const {
|
|
115
|
+
items: _items,
|
|
116
|
+
collection: { model, load },
|
|
117
|
+
onSelectionCommit,
|
|
118
|
+
revealOnFocus,
|
|
119
|
+
type = 'single',
|
|
120
|
+
checkboxes = false,
|
|
121
|
+
value,
|
|
122
|
+
defaultValue,
|
|
123
|
+
onValueChange: _onValueChange,
|
|
124
|
+
expanded,
|
|
125
|
+
defaultExpanded,
|
|
126
|
+
onExpandedChange,
|
|
127
|
+
loadingText = 'Loading…',
|
|
128
|
+
errorText = 'Could not load. Press Enter to retry.',
|
|
129
|
+
virtual,
|
|
130
|
+
ref,
|
|
131
|
+
className,
|
|
132
|
+
onScroll,
|
|
133
|
+
onKeyDown,
|
|
134
|
+
onClick,
|
|
135
|
+
onFocus,
|
|
136
|
+
onBlur,
|
|
137
|
+
...host
|
|
138
|
+
} = props
|
|
139
|
+
requireAccessibleName('Tree', host)
|
|
140
|
+
const [initialType] = useState(type)
|
|
141
|
+
if (type !== initialType)
|
|
142
|
+
throw new TypeError('Tree cannot change its selection type after mount.')
|
|
143
|
+
if (checkboxes && type !== 'multiple')
|
|
144
|
+
throw new TypeError('Tree checkboxes require multiple selection.')
|
|
145
|
+
if (
|
|
146
|
+
virtual &&
|
|
147
|
+
(![virtual.height, virtual.rowHeight].every(Number.isFinite) ||
|
|
148
|
+
virtual.height <= 0 ||
|
|
149
|
+
virtual.rowHeight <= 0)
|
|
150
|
+
)
|
|
151
|
+
throw new RangeError('Tree virtual height and rowHeight must be positive finite numbers.')
|
|
152
|
+
|
|
153
|
+
const selection = useControllableState<Selection>({
|
|
154
|
+
name: 'Tree value',
|
|
155
|
+
value,
|
|
156
|
+
defaultValue,
|
|
157
|
+
initialValue: type === 'multiple' ? [] : null,
|
|
158
|
+
equal: sameSelection,
|
|
159
|
+
onChange: next => {
|
|
160
|
+
if (props.type === 'multiple') {
|
|
161
|
+
if (Array.isArray(next)) props.onValueChange?.(next)
|
|
162
|
+
} else if (!Array.isArray(next)) props.onValueChange?.(next)
|
|
163
|
+
}
|
|
164
|
+
})
|
|
165
|
+
const expansion = useControllableState<string[]>({
|
|
166
|
+
name: 'Tree expanded',
|
|
167
|
+
value: expanded,
|
|
168
|
+
defaultValue: defaultExpanded,
|
|
169
|
+
initialValue: [],
|
|
170
|
+
onChange: onExpandedChange,
|
|
171
|
+
equal: sameSelection
|
|
172
|
+
})
|
|
173
|
+
treeValues(selection.value, type === 'multiple', 'selection')
|
|
174
|
+
treeValues(expansion.value, true, 'expansion')
|
|
175
|
+
|
|
176
|
+
const openItems = useMemo(() => new Set(expansion.value), [expansion.value])
|
|
177
|
+
const rows = useMemo(() => visibleTree(model.roots, openItems), [model, openItems])
|
|
178
|
+
const byRow = useMemo(() => new Map(rows.map((node, index) => [node.value, index])), [rows])
|
|
179
|
+
const enabled = useMemo(() => rows.filter(node => !node.disabled), [rows])
|
|
180
|
+
const selected = useMemo(() => {
|
|
181
|
+
const current = selection.value
|
|
182
|
+
return new Set(Array.isArray(current) ? current : current === null ? [] : [current])
|
|
183
|
+
}, [selection.value])
|
|
184
|
+
const checked = useMemo(
|
|
185
|
+
() => (checkboxes ? branchChecks(model.roots, selected) : null),
|
|
186
|
+
[checkboxes, model, selected]
|
|
187
|
+
)
|
|
188
|
+
const [focused, setFocused] = useState<string | null>(null)
|
|
189
|
+
let cursor = focused === null ? undefined : model.byValue.get(focused)
|
|
190
|
+
while (cursor && (cursor.disabled || !byRow.has(cursor.value)))
|
|
191
|
+
cursor = cursor.parent ?? undefined
|
|
192
|
+
const active = cursor ?? enabled.find(node => selected.has(node.value)) ?? enabled[0]
|
|
193
|
+
const activeIndex = active ? byRow.get(active.value)! : -1
|
|
194
|
+
if (focused !== null && active?.value !== focused) setFocused(active?.value ?? null)
|
|
195
|
+
const root = useRef<HTMLDivElement>(null)
|
|
196
|
+
const hostRef = useComposedRefs(ref, root)
|
|
197
|
+
const id = useId()
|
|
198
|
+
const matcher = useLocaleMatcher()
|
|
199
|
+
const search = useRef({ text: '', time: 0 })
|
|
200
|
+
const [scrollTop, setScrollTop] = useState(0)
|
|
201
|
+
const rowHeight = virtual?.rowHeight ?? 0
|
|
202
|
+
const height = virtual?.height ?? 0
|
|
203
|
+
const [measuredHeight, setMeasuredHeight] = useState<number | null>(null)
|
|
204
|
+
|
|
205
|
+
useLayoutEffect(() => {
|
|
206
|
+
const element = root.current
|
|
207
|
+
if (!element || !rowHeight) return
|
|
208
|
+
const update = () => setMeasuredHeight(element.clientHeight)
|
|
209
|
+
const observer = new element.ownerDocument.defaultView!.ResizeObserver(update)
|
|
210
|
+
observer.observe(element)
|
|
211
|
+
update()
|
|
212
|
+
return () => observer.disconnect()
|
|
213
|
+
}, [rowHeight])
|
|
214
|
+
|
|
215
|
+
useEffect(() => {
|
|
216
|
+
for (const node of rows) {
|
|
217
|
+
if (
|
|
218
|
+
!node.disabled &&
|
|
219
|
+
openItems.has(node.value) &&
|
|
220
|
+
(!node.load || node.load.status === 'loading')
|
|
221
|
+
)
|
|
222
|
+
load(node)
|
|
223
|
+
}
|
|
224
|
+
}, [rows, openItems, load])
|
|
225
|
+
useEffect(() => {
|
|
226
|
+
search.current = { text: '', time: 0 }
|
|
227
|
+
}, [matcher])
|
|
228
|
+
const reveal = useCallback(
|
|
229
|
+
(index: number) => {
|
|
230
|
+
const element = root.current
|
|
231
|
+
if (!element || index < 0) return
|
|
232
|
+
if (!rowHeight) {
|
|
233
|
+
const row = element.querySelector('[data-active] > [data-slot="tree-row"]')
|
|
234
|
+
row?.scrollIntoView({ block: 'nearest', inline: 'nearest' })
|
|
235
|
+
return
|
|
236
|
+
}
|
|
237
|
+
const start = index * rowHeight
|
|
238
|
+
const end = start + rowHeight
|
|
239
|
+
const visibleHeight = element.clientHeight
|
|
240
|
+
if (start < element.scrollTop || rowHeight > visibleHeight) element.scrollTop = start
|
|
241
|
+
else if (end > element.scrollTop + visibleHeight) element.scrollTop = end - visibleHeight
|
|
242
|
+
setScrollTop(element.scrollTop)
|
|
243
|
+
},
|
|
244
|
+
[rowHeight]
|
|
245
|
+
)
|
|
246
|
+
useEffect(() => {
|
|
247
|
+
const element = root.current
|
|
248
|
+
if (element && element.ownerDocument.activeElement === element) reveal(activeIndex)
|
|
249
|
+
}, [activeIndex, reveal, measuredHeight])
|
|
250
|
+
|
|
251
|
+
function toggle(node: TreeNode) {
|
|
252
|
+
if (node.branch) {
|
|
253
|
+
expansion.request(values =>
|
|
254
|
+
openItems.has(node.value)
|
|
255
|
+
? values.filter(value => value !== node.value)
|
|
256
|
+
: [...values, node.value]
|
|
257
|
+
)
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
function select(node: TreeNode) {
|
|
262
|
+
if (checked) {
|
|
263
|
+
const leaves = selectableLeaves(node)
|
|
264
|
+
if (!leaves.length) return
|
|
265
|
+
selection.request(values => {
|
|
266
|
+
const next = new Set(Array.isArray(values) ? values : [])
|
|
267
|
+
const complete = leaves.every(value => next.has(value))
|
|
268
|
+
for (const value of leaves) {
|
|
269
|
+
if (complete) next.delete(value)
|
|
270
|
+
else next.add(value)
|
|
271
|
+
}
|
|
272
|
+
return [...next]
|
|
273
|
+
})
|
|
274
|
+
} else {
|
|
275
|
+
selection.request(current =>
|
|
276
|
+
nextSelection(current, node.value, type === 'single' || !selected.has(node.value))
|
|
277
|
+
)
|
|
278
|
+
}
|
|
279
|
+
onSelectionCommit?.()
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
function activate(node: TreeNode) {
|
|
283
|
+
if (node.load?.status === 'error' && openItems.has(node.value)) load(node)
|
|
284
|
+
else select(node)
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
function navigate(event: KeyboardEvent<HTMLDivElement>) {
|
|
288
|
+
if (
|
|
289
|
+
!active ||
|
|
290
|
+
event.target !== event.currentTarget ||
|
|
291
|
+
event.altKey ||
|
|
292
|
+
event.ctrlKey ||
|
|
293
|
+
event.metaKey ||
|
|
294
|
+
event.nativeEvent.isComposing
|
|
295
|
+
)
|
|
296
|
+
return
|
|
297
|
+
const view = event.currentTarget.ownerDocument.defaultView!
|
|
298
|
+
const rtl = view.getComputedStyle(event.currentTarget).direction === 'rtl'
|
|
299
|
+
const index = enabled.indexOf(active)
|
|
300
|
+
let destination: TreeNode | undefined
|
|
301
|
+
switch (event.key) {
|
|
302
|
+
case 'ArrowDown':
|
|
303
|
+
destination = enabled[index + 1]
|
|
304
|
+
break
|
|
305
|
+
case 'ArrowUp':
|
|
306
|
+
destination = enabled[index - 1]
|
|
307
|
+
break
|
|
308
|
+
case 'Home':
|
|
309
|
+
destination = enabled[0]
|
|
310
|
+
break
|
|
311
|
+
case 'End':
|
|
312
|
+
destination = enabled.at(-1)
|
|
313
|
+
break
|
|
314
|
+
case rtl ? 'ArrowLeft' : 'ArrowRight':
|
|
315
|
+
if (openItems.has(active.value))
|
|
316
|
+
destination = active.children.find(child => !child.disabled)
|
|
317
|
+
else toggle(active)
|
|
318
|
+
break
|
|
319
|
+
case rtl ? 'ArrowRight' : 'ArrowLeft':
|
|
320
|
+
if (active.branch && openItems.has(active.value)) toggle(active)
|
|
321
|
+
else destination = active.parent ?? undefined
|
|
322
|
+
break
|
|
323
|
+
case 'Enter':
|
|
324
|
+
activate(active)
|
|
325
|
+
break
|
|
326
|
+
case ' ':
|
|
327
|
+
select(active)
|
|
328
|
+
break
|
|
329
|
+
default: {
|
|
330
|
+
if (!matcher.isSingleKey(event.key)) return
|
|
331
|
+
const now = view.performance.now()
|
|
332
|
+
search.current.text =
|
|
333
|
+
(now - search.current.time > 700 ? '' : search.current.text) + event.key
|
|
334
|
+
search.current.time = now
|
|
335
|
+
const match = matchSelectText(enabled, search.current.text, active.value, matcher)
|
|
336
|
+
destination = match === undefined ? undefined : model.byValue.get(match)
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
event.preventDefault()
|
|
340
|
+
if (destination) setFocused(destination.value)
|
|
341
|
+
}
|
|
342
|
+
|
|
343
|
+
// Keep the active descendant mounted while the viewport is scrolled independently of focus.
|
|
344
|
+
const start = virtual ? Math.max(0, Math.floor(scrollTop / rowHeight) - 3) : 0
|
|
345
|
+
const end = virtual
|
|
346
|
+
? Math.min(rows.length, Math.ceil((scrollTop + (measuredHeight ?? height)) / rowHeight) + 3)
|
|
347
|
+
: rows.length
|
|
348
|
+
const windowed = rows.slice(start, end)
|
|
349
|
+
if (virtual && active && activeIndex < start) windowed.unshift(active)
|
|
350
|
+
if (virtual && active && activeIndex >= end) windowed.push(active)
|
|
351
|
+
|
|
352
|
+
function itemId(node: TreeNode) {
|
|
353
|
+
const suffix = Array.from(node.value, character => character.codePointAt(0)!.toString(36))
|
|
354
|
+
return `${id}-${suffix.join('-')}`
|
|
355
|
+
}
|
|
356
|
+
|
|
357
|
+
function renderRow(node: TreeNode): ReactElement {
|
|
358
|
+
const index = byRow.get(node.value)!
|
|
359
|
+
const rowId = itemId(node)
|
|
360
|
+
const groupId = rowId + '-children'
|
|
361
|
+
const open = openItems.has(node.value)
|
|
362
|
+
const hasGroup = !virtual && open && node.children.length > 0
|
|
363
|
+
const check = checked?.get(node.value)
|
|
364
|
+
const chosen = checked ? check === true : selected.has(node.value)
|
|
365
|
+
const status =
|
|
366
|
+
open && node.load?.status === 'loading'
|
|
367
|
+
? loadingText
|
|
368
|
+
: open && node.load?.status === 'error'
|
|
369
|
+
? errorText
|
|
370
|
+
: undefined
|
|
371
|
+
return (
|
|
372
|
+
<Fragment key={node.value}>
|
|
373
|
+
{/* oxlint-disable-next-line jsx-a11y/no-noninteractive-element-to-interactive-role -- Tree owns focus via aria-activedescendant. */}
|
|
374
|
+
<div
|
|
375
|
+
role="treeitem"
|
|
376
|
+
id={rowId}
|
|
377
|
+
aria-labelledby={joinIds(rowId + '-label', status ? rowId + '-status' : undefined)}
|
|
378
|
+
aria-owns={hasGroup ? groupId : undefined}
|
|
379
|
+
aria-level={node.level}
|
|
380
|
+
aria-posinset={node.position}
|
|
381
|
+
aria-setsize={node.size}
|
|
382
|
+
aria-expanded={node.branch ? open : undefined}
|
|
383
|
+
aria-busy={open && node.load?.status === 'loading' ? true : undefined}
|
|
384
|
+
aria-disabled={node.disabled || undefined}
|
|
385
|
+
aria-selected={checked || node.disabled ? undefined : chosen}
|
|
386
|
+
aria-checked={check}
|
|
387
|
+
data-slot="tree-item"
|
|
388
|
+
data-value={node.value}
|
|
389
|
+
data-active={node === active ? '' : undefined}
|
|
390
|
+
className={virtual ? 'absolute inset-x-0' : undefined}
|
|
391
|
+
style={virtual ? { top: index * rowHeight, height: rowHeight } : undefined}
|
|
392
|
+
>
|
|
393
|
+
<div
|
|
394
|
+
data-slot="tree-row"
|
|
395
|
+
data-active={node === active ? '' : undefined}
|
|
396
|
+
data-disabled={node.disabled ? '' : undefined}
|
|
397
|
+
data-selected={chosen ? '' : undefined}
|
|
398
|
+
className={cn(rowClass, virtual && 'h-full min-h-0 overflow-hidden py-0')}
|
|
399
|
+
style={{
|
|
400
|
+
paddingInlineStart: `calc(0.5rem + ${node.level - 1} * var(--rad-tree-indent, 1.25rem))`
|
|
401
|
+
}}
|
|
402
|
+
>
|
|
403
|
+
<span
|
|
404
|
+
aria-hidden="true"
|
|
405
|
+
data-slot={node.branch ? 'tree-disclosure' : undefined}
|
|
406
|
+
className="grid min-h-6 w-6 shrink-0 place-items-center"
|
|
407
|
+
>
|
|
408
|
+
{node.branch && (
|
|
409
|
+
<span
|
|
410
|
+
className={cn(
|
|
411
|
+
'block size-2 border-e border-t border-current',
|
|
412
|
+
open ? 'rotate-[135deg] rtl:rotate-[-135deg]' : 'rotate-45 rtl:-rotate-45'
|
|
413
|
+
)}
|
|
414
|
+
/>
|
|
415
|
+
)}
|
|
416
|
+
</span>
|
|
417
|
+
{check !== undefined ? (
|
|
418
|
+
<span
|
|
419
|
+
aria-hidden="true"
|
|
420
|
+
data-slot="tree-checkbox"
|
|
421
|
+
className={cn(
|
|
422
|
+
'grid size-4 shrink-0 place-items-center rounded-sm border border-[var(--rad-color-border)] text-xs leading-none forced-colors:border-[CanvasText]',
|
|
423
|
+
check && 'bg-[var(--rad-color-accent)] [color:var(--rad-color-accent-foreground)]'
|
|
424
|
+
)}
|
|
425
|
+
>
|
|
426
|
+
{check === 'mixed' ? '−' : check ? '✓' : ''}
|
|
427
|
+
</span>
|
|
428
|
+
) : checkboxes ? (
|
|
429
|
+
<span
|
|
430
|
+
aria-hidden="true"
|
|
431
|
+
className="size-4 shrink-0"
|
|
432
|
+
/>
|
|
433
|
+
) : null}
|
|
434
|
+
{node.item.icon && (
|
|
435
|
+
<span
|
|
436
|
+
aria-hidden="true"
|
|
437
|
+
className="shrink-0"
|
|
438
|
+
>
|
|
439
|
+
{node.item.icon}
|
|
440
|
+
</span>
|
|
441
|
+
)}
|
|
442
|
+
<span
|
|
443
|
+
id={rowId + '-label'}
|
|
444
|
+
className={cn('min-w-0', virtual && 'truncate')}
|
|
445
|
+
>
|
|
446
|
+
{node.item.label}
|
|
447
|
+
</span>
|
|
448
|
+
<output
|
|
449
|
+
id={rowId + '-status'}
|
|
450
|
+
className="ms-auto min-w-0 truncate text-xs [color:var(--rad-color-muted-foreground)]"
|
|
451
|
+
>
|
|
452
|
+
{status}
|
|
453
|
+
</output>
|
|
454
|
+
</div>
|
|
455
|
+
</div>
|
|
456
|
+
{hasGroup && (
|
|
457
|
+
<div
|
|
458
|
+
role="group"
|
|
459
|
+
id={groupId}
|
|
460
|
+
>
|
|
461
|
+
{node.children.map(renderRow)}
|
|
462
|
+
</div>
|
|
463
|
+
)}
|
|
464
|
+
</Fragment>
|
|
465
|
+
)
|
|
466
|
+
}
|
|
467
|
+
|
|
468
|
+
return (
|
|
469
|
+
<div
|
|
470
|
+
{...host}
|
|
471
|
+
ref={hostRef}
|
|
472
|
+
role="tree"
|
|
473
|
+
tabIndex={0}
|
|
474
|
+
contentEditable={undefined}
|
|
475
|
+
dangerouslySetInnerHTML={undefined}
|
|
476
|
+
aria-multiselectable={type === 'multiple' || undefined}
|
|
477
|
+
aria-activedescendant={active ? itemId(active) : undefined}
|
|
478
|
+
data-slot={joinIds('tree', host['data-slot'])}
|
|
479
|
+
className={cn(
|
|
480
|
+
'group/tree min-w-0 rounded-[var(--rad-control-radius,0.5rem)] [color:var(--rad-color-foreground)] font-[family-name:var(--rad-typography-roles-ui-body-family,system-ui,sans-serif)] text-sm',
|
|
481
|
+
active ? 'focus-visible:outline-none' : focusRingClass,
|
|
482
|
+
virtual && scrollbarClass,
|
|
483
|
+
virtual && 'w-72 max-w-full overflow-y-auto overscroll-contain',
|
|
484
|
+
className
|
|
485
|
+
)}
|
|
486
|
+
style={{ ...(virtual && { height }), ...host.style }}
|
|
487
|
+
onScroll={event => {
|
|
488
|
+
onScroll?.(event)
|
|
489
|
+
if (virtual) setScrollTop(event.currentTarget.scrollTop)
|
|
490
|
+
}}
|
|
491
|
+
onFocus={event => {
|
|
492
|
+
onFocus?.(event)
|
|
493
|
+
if (
|
|
494
|
+
event.target === event.currentTarget &&
|
|
495
|
+
(revealOnFocus || event.currentTarget.matches(':focus-visible'))
|
|
496
|
+
)
|
|
497
|
+
reveal(activeIndex)
|
|
498
|
+
}}
|
|
499
|
+
onBlur={event => {
|
|
500
|
+
onBlur?.(event)
|
|
501
|
+
search.current = { text: '', time: 0 }
|
|
502
|
+
}}
|
|
503
|
+
onKeyDown={event => composeAction(onKeyDown, navigate)(event)}
|
|
504
|
+
onClick={composeAction(onClick, event => {
|
|
505
|
+
const target = event.target as Element
|
|
506
|
+
const row = target.closest('[data-slot="tree-row"]')
|
|
507
|
+
const item = row?.closest<HTMLElement>('[data-slot~="tree-item"]')
|
|
508
|
+
if (!item || item.closest('[role="tree"]') !== event.currentTarget) return
|
|
509
|
+
const node = model.byValue.get(item.dataset.value ?? '')
|
|
510
|
+
if (!node || node.disabled) return
|
|
511
|
+
event.currentTarget.focus({ preventScroll: true })
|
|
512
|
+
setFocused(node.value)
|
|
513
|
+
if (target.closest('[data-slot~="tree-disclosure"]')) toggle(node)
|
|
514
|
+
else activate(node)
|
|
515
|
+
})}
|
|
516
|
+
>
|
|
517
|
+
{virtual ? (
|
|
518
|
+
<div
|
|
519
|
+
role="none"
|
|
520
|
+
className="relative"
|
|
521
|
+
style={{ height: rows.length * rowHeight }}
|
|
522
|
+
>
|
|
523
|
+
{windowed.map(renderRow)}
|
|
524
|
+
</div>
|
|
525
|
+
) : (
|
|
526
|
+
model.roots.map(renderRow)
|
|
527
|
+
)}
|
|
528
|
+
</div>
|
|
529
|
+
)
|
|
530
|
+
}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import type { ReactNode } from 'react'
|
|
2
|
+
|
|
3
|
+
export type TreeItem = {
|
|
4
|
+
/** Unique across the tree, including children returned by loaders. */
|
|
5
|
+
value: string
|
|
6
|
+
label: string
|
|
7
|
+
icon?: ReactNode
|
|
8
|
+
disabled?: boolean
|
|
9
|
+
} & (
|
|
10
|
+
| { children?: readonly TreeItem[]; loadChildren?: never }
|
|
11
|
+
| { children?: never; loadChildren: (signal: AbortSignal) => Promise<readonly TreeItem[]> }
|
|
12
|
+
)
|
|
13
|
+
|
|
14
|
+
export type TreeLoad =
|
|
15
|
+
| { status: 'loading' | 'error' }
|
|
16
|
+
| { status: 'loaded'; children: readonly TreeItem[] }
|
|
17
|
+
|
|
18
|
+
export type TreeNode = {
|
|
19
|
+
item: TreeItem
|
|
20
|
+
value: string
|
|
21
|
+
textValue: string
|
|
22
|
+
disabled: boolean
|
|
23
|
+
parent: TreeNode | null
|
|
24
|
+
children: TreeNode[]
|
|
25
|
+
branch: boolean
|
|
26
|
+
load: TreeLoad | undefined
|
|
27
|
+
level: number
|
|
28
|
+
position: number
|
|
29
|
+
size: number
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export function buildTree(items: readonly TreeItem[], loads: ReadonlyMap<string, TreeLoad>) {
|
|
33
|
+
const byValue = new Map<string, TreeNode>()
|
|
34
|
+
function visit(siblings: readonly TreeItem[], parent: TreeNode | null): TreeNode[] {
|
|
35
|
+
return siblings.map((item, index) => {
|
|
36
|
+
if (typeof item.value !== 'string' || !item.value || byValue.has(item.value)) {
|
|
37
|
+
throw new TypeError('Tree items must have unique, nonempty values.')
|
|
38
|
+
}
|
|
39
|
+
if (typeof item.label !== 'string' || !item.label.trim()) {
|
|
40
|
+
throw new TypeError('Tree items must have a nonempty label.')
|
|
41
|
+
}
|
|
42
|
+
const load = item.loadChildren ? loads.get(item.value) : undefined
|
|
43
|
+
const children = item.children ?? (load?.status === 'loaded' ? load.children : [])
|
|
44
|
+
const node: TreeNode = {
|
|
45
|
+
item,
|
|
46
|
+
value: item.value,
|
|
47
|
+
textValue: item.label,
|
|
48
|
+
disabled: !!(item.disabled || parent?.disabled),
|
|
49
|
+
parent,
|
|
50
|
+
children: [],
|
|
51
|
+
branch: children.length > 0 || (!!item.loadChildren && load?.status !== 'loaded'),
|
|
52
|
+
load,
|
|
53
|
+
level: (parent?.level ?? 0) + 1,
|
|
54
|
+
position: index + 1,
|
|
55
|
+
size: siblings.length
|
|
56
|
+
}
|
|
57
|
+
byValue.set(item.value, node)
|
|
58
|
+
node.children = visit(children, node)
|
|
59
|
+
return node
|
|
60
|
+
})
|
|
61
|
+
}
|
|
62
|
+
return { roots: visit(items, null), byValue }
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
export function treePath(node: TreeNode | undefined): TreeNode[] {
|
|
66
|
+
const path: TreeNode[] = []
|
|
67
|
+
for (let current = node; current; current = current.parent ?? undefined) path.push(current)
|
|
68
|
+
return path.reverse()
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
export function visibleTree(roots: TreeNode[], expanded: ReadonlySet<string>) {
|
|
72
|
+
const rows: TreeNode[] = []
|
|
73
|
+
function visit(nodes: TreeNode[]) {
|
|
74
|
+
for (const node of nodes) {
|
|
75
|
+
rows.push(node)
|
|
76
|
+
if (expanded.has(node.value)) visit(node.children)
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
visit(roots)
|
|
80
|
+
return rows
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** Branches derive their state from the selectable leaves already loaded. */
|
|
84
|
+
export function branchChecks(roots: TreeNode[], selected: ReadonlySet<string>) {
|
|
85
|
+
const checks = new Map<string, boolean | 'mixed'>()
|
|
86
|
+
function visit(node: TreeNode): { total: number; checked: number } {
|
|
87
|
+
if (node.disabled) return { total: 0, checked: 0 }
|
|
88
|
+
let total = 0
|
|
89
|
+
let checked = 0
|
|
90
|
+
if (node.branch) {
|
|
91
|
+
for (const child of node.children) {
|
|
92
|
+
const counts = visit(child)
|
|
93
|
+
total += counts.total
|
|
94
|
+
checked += counts.checked
|
|
95
|
+
}
|
|
96
|
+
} else {
|
|
97
|
+
total = 1
|
|
98
|
+
checked = Number(selected.has(node.value))
|
|
99
|
+
}
|
|
100
|
+
if (total) checks.set(node.value, checked === total ? true : checked === 0 ? false : 'mixed')
|
|
101
|
+
return { total, checked }
|
|
102
|
+
}
|
|
103
|
+
for (const root of roots) visit(root)
|
|
104
|
+
return checks
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
export function selectableLeaves(node: TreeNode): string[] {
|
|
108
|
+
if (node.disabled) return []
|
|
109
|
+
return node.branch ? node.children.flatMap(selectableLeaves) : [node.value]
|
|
110
|
+
}
|