@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,335 @@
1
+ 'use client'
2
+
3
+ /* oxlint-disable jsx-a11y/prefer-tag-over-role -- A non-modal dialog uses the native Popover top layer. */
4
+ import {
5
+ createContext,
6
+ useContext,
7
+ useLayoutEffect,
8
+ useRef,
9
+ useState,
10
+ type ComponentProps,
11
+ type ReactNode,
12
+ type RefObject
13
+ } from 'react'
14
+ import { cn } from 'cn'
15
+ import { composeAction } from '../../internal/events.js'
16
+ import { joinIds } from '../../internal/ids.js'
17
+ import type { PartStyle } from '../../presentation.js'
18
+ import { useComposedRefs } from '../../react/useComposedRefs.js'
19
+ import { useControllableState } from '../../react/useControllableState.js'
20
+ import type { StateOwner } from '../../react/useNativeOwner.js'
21
+ import { Button } from '../Button/Button.js'
22
+ import {
23
+ Popover,
24
+ PopoverContentRoot,
25
+ usePopoverContext,
26
+ type PopoverAlign,
27
+ type PopoverSide,
28
+ type PopoverTriggerProps
29
+ } from '../Popover/Popover.js'
30
+
31
+ export type TourStep = {
32
+ /** A CSS selector within this Tour. */
33
+ target: string
34
+ title: string
35
+ description?: ReactNode
36
+ side?: PopoverSide
37
+ align?: PopoverAlign
38
+ }
39
+
40
+ export type TourProps = Omit<ComponentProps<'div'>, 'style'> &
41
+ StateOwner<'open', boolean> & {
42
+ steps: readonly TourStep[]
43
+ onOpenChange?: (open: boolean) => void
44
+ backLabel?: string
45
+ nextLabel?: string
46
+ skipLabel?: string
47
+ doneLabel?: string
48
+ formatProgress?: (step: number, total: number) => string
49
+ motion?: 'inherit' | 'off'
50
+ style?: PartStyle['style']
51
+ parts?: { popup?: PartStyle }
52
+ 'data-slot'?: string
53
+ }
54
+ export type TourTriggerProps = PopoverTriggerProps
55
+
56
+ const TourContext = createContext<{
57
+ open: boolean
58
+ launch: (opener: HTMLElement) => void
59
+ } | null>(null)
60
+
61
+ type ReadyStep = { index: number; node: HTMLElement }
62
+
63
+ export function Tour({
64
+ steps,
65
+ open,
66
+ defaultOpen,
67
+ onOpenChange,
68
+ backLabel = 'Back',
69
+ nextLabel = 'Next',
70
+ skipLabel = 'Skip tour',
71
+ doneLabel = 'Done',
72
+ formatProgress = (step, total) => `Step ${step} of ${total}`,
73
+ motion,
74
+ parts,
75
+ className,
76
+ children,
77
+ ref,
78
+ ...props
79
+ }: TourProps) {
80
+ const state = useControllableState({
81
+ name: 'Tour',
82
+ value: open,
83
+ defaultValue: defaultOpen,
84
+ initialValue: false,
85
+ onChange: onOpenChange
86
+ })
87
+ const host = useRef<HTMLDivElement>(null)
88
+ const hostRef = useComposedRefs(host, ref)
89
+ const opener = useRef<HTMLElement | null>(null)
90
+ const [requested, setRequested] = useState(0)
91
+ const [ready, setReady] = useState<ReadyStep[] | null>(null)
92
+ const notifiedEmpty = useRef(false)
93
+ const isOpen = state.value
94
+ const [wasOpen, setWasOpen] = useState(isOpen)
95
+ if (wasOpen !== isOpen) {
96
+ setWasOpen(isOpen)
97
+ if (isOpen) {
98
+ setReady(null)
99
+ setRequested(0)
100
+ }
101
+ }
102
+
103
+ useLayoutEffect(() => {
104
+ if (!isOpen) {
105
+ opener.current = null
106
+ notifiedEmpty.current = false
107
+ return
108
+ }
109
+ const root = host.current!
110
+ const doc = root.ownerDocument
111
+ const win = doc.defaultView!
112
+ if (!opener.current && doc.activeElement instanceof win.HTMLElement) {
113
+ opener.current = doc.activeElement
114
+ }
115
+ let frame = 0
116
+ const refresh = () => {
117
+ frame = 0
118
+ const matches = steps.flatMap(({ target }, index) => {
119
+ let node: Element | null
120
+ try {
121
+ node = root.querySelector(target)
122
+ } catch {
123
+ return []
124
+ }
125
+ return node instanceof win.HTMLElement &&
126
+ node.checkVisibility({ checkVisibilityCSS: true, checkOpacity: true })
127
+ ? [{ index, node }]
128
+ : []
129
+ })
130
+ setReady(current =>
131
+ current?.length === matches.length &&
132
+ current.every(
133
+ (entry, index) =>
134
+ entry.index === matches[index].index && entry.node === matches[index].node
135
+ )
136
+ ? current
137
+ : matches
138
+ )
139
+ }
140
+ const schedule = () => {
141
+ if (!frame) frame = win.requestAnimationFrame(refresh)
142
+ }
143
+ const observer = new win.MutationObserver(schedule)
144
+ observer.observe(root, {
145
+ subtree: true,
146
+ childList: true,
147
+ attributes: true,
148
+ attributeFilter: ['class', 'id', 'style', 'hidden', 'open', 'data-state']
149
+ })
150
+ root.addEventListener('toggle', schedule, true)
151
+ win.addEventListener('resize', schedule)
152
+ schedule()
153
+ return () => {
154
+ observer.disconnect()
155
+ root.removeEventListener('toggle', schedule, true)
156
+ win.removeEventListener('resize', schedule)
157
+ win.cancelAnimationFrame(frame)
158
+ }
159
+ }, [isOpen, steps])
160
+
161
+ const firstAvailable = ready?.findIndex(item => item.index >= requested) ?? -1
162
+ const position = firstAvailable === -1 ? (ready?.length ?? 0) - 1 : firstAvailable
163
+ const current = ready?.[position]
164
+ const step = current && steps[current.index]
165
+ const empty = ready?.length === 0
166
+ useLayoutEffect(() => {
167
+ if (isOpen && empty && !notifiedEmpty.current) {
168
+ notifiedEmpty.current = true
169
+ state.request(false)
170
+ } else if (!empty) notifiedEmpty.current = false
171
+ })
172
+
173
+ return (
174
+ <TourContext.Provider
175
+ value={{
176
+ open: isOpen && !!step,
177
+ launch: node => {
178
+ if (isOpen) return
179
+ opener.current = node
180
+ state.request(true)
181
+ }
182
+ }}
183
+ >
184
+ <Popover
185
+ open={isOpen && !!step}
186
+ onOpenChange={state.request}
187
+ >
188
+ <div
189
+ {...props}
190
+ ref={hostRef}
191
+ data-slot={joinIds('tour', props['data-slot'])}
192
+ className={cn(
193
+ 'min-w-0 [&_[data-rad-tour-target]]:[outline:2px_solid_var(--rad-color-focus)] [&_[data-rad-tour-target]]:outline-offset-4 forced-colors:[&_[data-rad-tour-target]]:outline-[Highlight]',
194
+ className
195
+ )}
196
+ >
197
+ {children}
198
+ <TourSurface
199
+ anchor={isOpen && step ? current.node : null}
200
+ step={step}
201
+ stepIndex={current?.index}
202
+ opener={opener}
203
+ motion={motion}
204
+ part={parts?.popup}
205
+ >
206
+ {step && (
207
+ <>
208
+ <p
209
+ data-slot="tour-progress"
210
+ className="text-xs [color:var(--rad-color-muted-foreground)]"
211
+ >
212
+ {formatProgress(position + 1, ready!.length)}
213
+ </p>
214
+ <p className="text-sm font-semibold">{step.title}</p>
215
+ {step.description && <div className="text-sm">{step.description}</div>}
216
+ <div
217
+ className="flex flex-wrap gap-2"
218
+ data-slot="tour-actions"
219
+ >
220
+ <Button
221
+ controlSize="small"
222
+ variant="ghost"
223
+ onClick={() => state.request(false)}
224
+ >
225
+ {skipLabel}
226
+ </Button>
227
+ {position > 0 && (
228
+ <Button
229
+ controlSize="small"
230
+ variant="outline"
231
+ onClick={() => setRequested(ready![position - 1].index)}
232
+ >
233
+ {backLabel}
234
+ </Button>
235
+ )}
236
+ <Button
237
+ controlSize="small"
238
+ onClick={() => {
239
+ const next = ready![position + 1]
240
+ if (next) setRequested(next.index)
241
+ else state.request(false)
242
+ }}
243
+ >
244
+ {position === ready!.length - 1 ? doneLabel : nextLabel}
245
+ </Button>
246
+ </div>
247
+ </>
248
+ )}
249
+ </TourSurface>
250
+ </div>
251
+ </Popover>
252
+ </TourContext.Provider>
253
+ )
254
+ }
255
+
256
+ function TourSurface({
257
+ anchor,
258
+ step,
259
+ stepIndex,
260
+ opener,
261
+ motion,
262
+ part,
263
+ children
264
+ }: {
265
+ anchor: HTMLElement | null
266
+ step?: TourStep
267
+ stepIndex?: number
268
+ opener: RefObject<HTMLElement | null>
269
+ motion?: TourProps['motion']
270
+ part?: PartStyle
271
+ children: ReactNode
272
+ }) {
273
+ const { setTrigger } = usePopoverContext()
274
+ const popup = useRef<HTMLDivElement>(null)
275
+ const description = useRef<HTMLDivElement>(null)
276
+ useLayoutEffect(() => {
277
+ setTrigger(anchor)
278
+ if (!anchor) return
279
+ anchor.scrollIntoView({ block: 'nearest', inline: 'nearest', behavior: 'instant' })
280
+ anchor.setAttribute('data-rad-tour-target', '')
281
+ return () => anchor.removeAttribute('data-rad-tour-target')
282
+ }, [anchor, setTrigger])
283
+ useLayoutEffect(() => {
284
+ if (anchor && popup.current?.matches(':popover-open')) {
285
+ description.current?.focus({ preventScroll: true })
286
+ }
287
+ }, [anchor, stepIndex])
288
+
289
+ return (
290
+ <PopoverContentRoot
291
+ ref={popup}
292
+ data-slot="tour-popup"
293
+ role="dialog"
294
+ aria-label={step?.title}
295
+ side={step?.side}
296
+ align={step?.align}
297
+ motion={motion}
298
+ initialFocusRef={description}
299
+ returnFocusRef={opener}
300
+ className={cn('w-max max-w-[min(19rem,var(--_rad-popover-max-width))]', part?.className)}
301
+ style={part?.style}
302
+ >
303
+ <div
304
+ ref={description}
305
+ tabIndex={-1}
306
+ className="grid gap-2 focus:outline-none"
307
+ >
308
+ {children}
309
+ </div>
310
+ </PopoverContentRoot>
311
+ )
312
+ }
313
+
314
+ export function TourTrigger({ onClick, ...props }: TourTriggerProps) {
315
+ const tour = useContext(TourContext)
316
+ const { contentId } = usePopoverContext()
317
+ if (!tour) throw new Error('TourTrigger must render inside Tour.')
318
+ return (
319
+ <Button
320
+ {...props}
321
+ type="button"
322
+ pressed={undefined}
323
+ defaultPressed={undefined}
324
+ onPressedChange={undefined}
325
+ aria-pressed={undefined}
326
+ popoverTarget={undefined}
327
+ popoverTargetAction={undefined}
328
+ data-slot={joinIds('tour-trigger', props['data-slot'])}
329
+ aria-controls={contentId}
330
+ aria-expanded={tour.open}
331
+ aria-haspopup="dialog"
332
+ onClick={composeAction(onClick, event => tour.launch(event.currentTarget))}
333
+ />
334
+ )
335
+ }