@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.
Files changed (149) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/dist/library/color/colorValue.d.ts +8 -0
  3. package/dist/library/color/colorValue.d.ts.map +1 -0
  4. package/dist/library/color/colorValue.js +87 -0
  5. package/dist/library/color/colorValue.js.map +1 -0
  6. package/dist/library/color/oklch.d.ts +2 -0
  7. package/dist/library/color/oklch.d.ts.map +1 -1
  8. package/dist/library/color/oklch.js +27 -11
  9. package/dist/library/color/oklch.js.map +1 -1
  10. package/dist/library/components/Cascader/Cascader.d.ts +25 -0
  11. package/dist/library/components/Cascader/Cascader.d.ts.map +1 -0
  12. package/dist/library/components/Cascader/Cascader.js +154 -0
  13. package/dist/library/components/Cascader/Cascader.js.map +1 -0
  14. package/dist/library/components/Cascader/CascaderColumn.d.ts +25 -0
  15. package/dist/library/components/Cascader/CascaderColumn.d.ts.map +1 -0
  16. package/dist/library/components/Cascader/CascaderColumn.js +80 -0
  17. package/dist/library/components/Cascader/CascaderColumn.js.map +1 -0
  18. package/dist/library/components/CodeBlock/CodeBlock.d.ts.map +1 -1
  19. package/dist/library/components/CodeBlock/CodeBlock.js +3 -37
  20. package/dist/library/components/CodeBlock/CodeBlock.js.map +1 -1
  21. package/dist/library/components/Collapsible/Collapsible.d.ts +5 -1
  22. package/dist/library/components/Collapsible/Collapsible.d.ts.map +1 -1
  23. package/dist/library/components/Collapsible/Collapsible.js +13 -3
  24. package/dist/library/components/Collapsible/Collapsible.js.map +1 -1
  25. package/dist/library/components/ColorInput/ColorInput.d.ts +22 -0
  26. package/dist/library/components/ColorInput/ColorInput.d.ts.map +1 -0
  27. package/dist/library/components/ColorInput/ColorInput.js +63 -0
  28. package/dist/library/components/ColorInput/ColorInput.js.map +1 -0
  29. package/dist/library/components/ColorPicker/ColorArea.d.ts +11 -0
  30. package/dist/library/components/ColorPicker/ColorArea.d.ts.map +1 -0
  31. package/dist/library/components/ColorPicker/ColorArea.js +58 -0
  32. package/dist/library/components/ColorPicker/ColorArea.js.map +1 -0
  33. package/dist/library/components/ColorPicker/ColorPicker.d.ts +37 -0
  34. package/dist/library/components/ColorPicker/ColorPicker.d.ts.map +1 -0
  35. package/dist/library/components/ColorPicker/ColorPicker.js +135 -0
  36. package/dist/library/components/ColorPicker/ColorPicker.js.map +1 -0
  37. package/dist/library/components/CopyButton/CopyButton.d.ts +17 -0
  38. package/dist/library/components/CopyButton/CopyButton.d.ts.map +1 -0
  39. package/dist/library/components/CopyButton/CopyButton.js +22 -0
  40. package/dist/library/components/CopyButton/CopyButton.js.map +1 -0
  41. package/dist/library/components/DataTable/DataTable.d.ts +47 -0
  42. package/dist/library/components/DataTable/DataTable.d.ts.map +1 -0
  43. package/dist/library/components/DataTable/DataTable.js +146 -0
  44. package/dist/library/components/DataTable/DataTable.js.map +1 -0
  45. package/dist/library/components/Dropzone/Dropzone.d.ts +26 -0
  46. package/dist/library/components/Dropzone/Dropzone.d.ts.map +1 -0
  47. package/dist/library/components/Dropzone/Dropzone.js +118 -0
  48. package/dist/library/components/Dropzone/Dropzone.js.map +1 -0
  49. package/dist/library/components/Highlight/Highlight.d.ts +15 -0
  50. package/dist/library/components/Highlight/Highlight.d.ts.map +1 -0
  51. package/dist/library/components/Highlight/Highlight.js +69 -0
  52. package/dist/library/components/Highlight/Highlight.js.map +1 -0
  53. package/dist/library/components/Rating/Rating.d.ts +21 -0
  54. package/dist/library/components/Rating/Rating.d.ts.map +1 -0
  55. package/dist/library/components/Rating/Rating.js +81 -0
  56. package/dist/library/components/Rating/Rating.js.map +1 -0
  57. package/dist/library/components/Select/Select.d.ts +3 -9
  58. package/dist/library/components/Select/Select.d.ts.map +1 -1
  59. package/dist/library/components/Select/Select.js +16 -156
  60. package/dist/library/components/Select/Select.js.map +1 -1
  61. package/dist/library/components/Select/SelectPopup.d.ts +29 -0
  62. package/dist/library/components/Select/SelectPopup.d.ts.map +1 -0
  63. package/dist/library/components/Select/SelectPopup.js +179 -0
  64. package/dist/library/components/Select/SelectPopup.js.map +1 -0
  65. package/dist/library/components/Slider/Slider.d.ts +2 -2
  66. package/dist/library/components/Slider/Slider.d.ts.map +1 -1
  67. package/dist/library/components/Slider/Slider.js +44 -3
  68. package/dist/library/components/Slider/Slider.js.map +1 -1
  69. package/dist/library/components/Spoiler/Spoiler.d.ts +15 -0
  70. package/dist/library/components/Spoiler/Spoiler.d.ts.map +1 -0
  71. package/dist/library/components/Spoiler/Spoiler.js +34 -0
  72. package/dist/library/components/Spoiler/Spoiler.js.map +1 -0
  73. package/dist/library/components/Stepper/Stepper.d.ts +48 -0
  74. package/dist/library/components/Stepper/Stepper.d.ts.map +1 -0
  75. package/dist/library/components/Stepper/Stepper.js +81 -0
  76. package/dist/library/components/Stepper/Stepper.js.map +1 -0
  77. package/dist/library/components/Timeline/Timeline.d.ts +30 -0
  78. package/dist/library/components/Timeline/Timeline.d.ts.map +1 -0
  79. package/dist/library/components/Timeline/Timeline.js +15 -0
  80. package/dist/library/components/Timeline/Timeline.js.map +1 -0
  81. package/dist/library/components/Tour/Tour.d.ts +31 -0
  82. package/dist/library/components/Tour/Tour.d.ts.map +1 -0
  83. package/dist/library/components/Tour/Tour.js +145 -0
  84. package/dist/library/components/Tour/Tour.js.map +1 -0
  85. package/dist/library/components/Tree/Tree.d.ts +48 -0
  86. package/dist/library/components/Tree/Tree.d.ts.map +1 -0
  87. package/dist/library/components/Tree/Tree.js +298 -0
  88. package/dist/library/components/Tree/Tree.js.map +1 -0
  89. package/dist/library/components/Tree/treeModel.d.ts +43 -0
  90. package/dist/library/components/Tree/treeModel.d.ts.map +1 -0
  91. package/dist/library/components/Tree/treeModel.js +83 -0
  92. package/dist/library/components/Tree/treeModel.js.map +1 -0
  93. package/dist/library/components/Tree/useTreeLoading.d.ts +6 -0
  94. package/dist/library/components/Tree/useTreeLoading.d.ts.map +1 -0
  95. package/dist/library/components/Tree/useTreeLoading.js +69 -0
  96. package/dist/library/components/Tree/useTreeLoading.js.map +1 -0
  97. package/dist/library/components/TreeSelect/TreeSelect.d.ts +29 -0
  98. package/dist/library/components/TreeSelect/TreeSelect.d.ts.map +1 -0
  99. package/dist/library/components/TreeSelect/TreeSelect.js +163 -0
  100. package/dist/library/components/TreeSelect/TreeSelect.js.map +1 -0
  101. package/dist/library/index.d.ts +19 -0
  102. package/dist/library/index.d.ts.map +1 -1
  103. package/dist/library/index.js +14 -0
  104. package/dist/library/index.js.map +1 -1
  105. package/dist/library/motion/transitions.d.ts.map +1 -1
  106. package/dist/library/motion/transitions.js +8 -3
  107. package/dist/library/motion/transitions.js.map +1 -1
  108. package/dist/library/react/useClipboardCopy.d.ts +8 -0
  109. package/dist/library/react/useClipboardCopy.d.ts.map +1 -0
  110. package/dist/library/react/useClipboardCopy.js +49 -0
  111. package/dist/library/react/useClipboardCopy.js.map +1 -0
  112. package/dist/library/react/useFormReset.d.ts +1 -1
  113. package/dist/library/react/useFormReset.d.ts.map +1 -1
  114. package/dist/library/react/useFormReset.js.map +1 -1
  115. package/dist/library/react/usePopoverSurface.d.ts.map +1 -1
  116. package/dist/library/react/usePopoverSurface.js +3 -2
  117. package/dist/library/react/usePopoverSurface.js.map +1 -1
  118. package/dist/library/styles.css +1 -1
  119. package/package.json +1 -1
  120. package/src/color/colorValue.ts +89 -0
  121. package/src/color/oklch.ts +33 -14
  122. package/src/components/Cascader/Cascader.tsx +315 -0
  123. package/src/components/Cascader/CascaderColumn.tsx +203 -0
  124. package/src/components/CodeBlock/CodeBlock.tsx +3 -45
  125. package/src/components/Collapsible/Collapsible.tsx +22 -4
  126. package/src/components/ColorInput/ColorInput.tsx +191 -0
  127. package/src/components/ColorPicker/ColorArea.tsx +98 -0
  128. package/src/components/ColorPicker/ColorPicker.tsx +283 -0
  129. package/src/components/CopyButton/CopyButton.tsx +75 -0
  130. package/src/components/DataTable/DataTable.tsx +384 -0
  131. package/src/components/Dropzone/Dropzone.tsx +230 -0
  132. package/src/components/Highlight/Highlight.tsx +112 -0
  133. package/src/components/Rating/Rating.tsx +202 -0
  134. package/src/components/Select/Select.tsx +20 -192
  135. package/src/components/Select/SelectPopup.tsx +246 -0
  136. package/src/components/Slider/Slider.tsx +51 -2
  137. package/src/components/Spoiler/Spoiler.tsx +96 -0
  138. package/src/components/Stepper/Stepper.tsx +306 -0
  139. package/src/components/Timeline/Timeline.tsx +139 -0
  140. package/src/components/Tour/Tour.tsx +335 -0
  141. package/src/components/Tree/Tree.tsx +530 -0
  142. package/src/components/Tree/treeModel.ts +110 -0
  143. package/src/components/Tree/useTreeLoading.ts +73 -0
  144. package/src/components/TreeSelect/TreeSelect.tsx +326 -0
  145. package/src/index.ts +50 -0
  146. package/src/motion/transitions.ts +8 -3
  147. package/src/react/useClipboardCopy.ts +54 -0
  148. package/src/react/useFormReset.ts +4 -1
  149. 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
+ }