@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,306 @@
1
+ 'use client'
2
+
3
+ import { useId, type ComponentProps, type ReactNode } from 'react'
4
+ import { cn } from 'cn'
5
+ import { requireAccessibleName, type AccessibleName } from '../../internal/accessibleName.js'
6
+ import { joinIds } from '../../internal/ids.js'
7
+ import type { ControlSize, PartStyle } from '../../presentation.js'
8
+ import { useControllableState } from '../../react/useControllableState.js'
9
+ import type { ValueOwner } from '../../react/useNativeOwner.js'
10
+ import type { ThemeStyle } from '../../themes/defineTheme.js'
11
+ import { Button } from '../Button/Button.js'
12
+ import { controlBorderClass, controlMetrics } from '../shared/controlStyles.js'
13
+ import { focusRingClass } from '../shared/focusStyles.js'
14
+ import { scrollbarClass } from '../shared/scrollbarStyles.js'
15
+
16
+ export type StepperStep = {
17
+ /** Stable, unique identifier. */
18
+ value: string
19
+ label: ReactNode
20
+ description?: ReactNode
21
+ disabled?: boolean
22
+ /** Overrides completion inferred from order in linear mode. */
23
+ completed?: boolean
24
+ /** Visible details when this step needs attention. */
25
+ error?: ReactNode
26
+ }
27
+
28
+ const statusText = {
29
+ current: 'Current',
30
+ completed: 'Completed',
31
+ upcoming: 'Upcoming',
32
+ error: 'Needs attention'
33
+ } as const
34
+
35
+ type StepStatus = keyof typeof statusText
36
+
37
+ export type StepperProps = Omit<
38
+ ComponentProps<'nav'>,
39
+ 'children' | 'role' | 'style' | 'aria-current' | 'dangerouslySetInnerHTML'
40
+ > &
41
+ AccessibleName &
42
+ ValueOwner<string | null> & {
43
+ steps: readonly StepperStep[]
44
+ onValueChange?: (value: string) => void
45
+ /** Linear mode permits prior steps and the next enabled step. */
46
+ navigation?: 'linear' | 'free'
47
+ orientation?: 'horizontal' | 'vertical'
48
+ controlSize?: ControlSize
49
+ statusLabels?: Partial<Record<StepStatus, string>>
50
+ style?: ThemeStyle
51
+ parts?: {
52
+ list?: PartStyle
53
+ step?: PartStyle
54
+ indicator?: PartStyle
55
+ label?: PartStyle
56
+ description?: PartStyle
57
+ status?: PartStyle
58
+ error?: PartStyle
59
+ connector?: PartStyle
60
+ }
61
+ 'data-slot'?: string
62
+ }
63
+
64
+ const markerClass =
65
+ 'box-border grid size-[var(--_rad-control-height)] shrink-0 place-items-center [border-width:var(--rad-control-border-width,1px)] [border-style:var(--rad-control-border-style,solid)] [border-color:var(--_rad-control-border)] rounded-[var(--rad-control-radius,0.5rem)] [corner-shape:var(--rad-control-corner-shape,round)] bg-[var(--rad-control-field-background,var(--rad-color-surface))] font-semibold tabular-nums forced-colors:border-[CanvasText] forced-colors:bg-[Canvas] forced-colors:text-[CanvasText]'
66
+
67
+ function hasText(content: ReactNode) {
68
+ return content != null && typeof content !== 'boolean' && content !== ''
69
+ }
70
+
71
+ /** A named, ordered navigation list whose selected step is owned by the flow. */
72
+ export function Stepper({
73
+ steps,
74
+ value,
75
+ defaultValue,
76
+ onValueChange,
77
+ navigation = 'linear',
78
+ orientation = 'horizontal',
79
+ controlSize = 'medium',
80
+ statusLabels,
81
+ parts,
82
+ className,
83
+ ...props
84
+ }: StepperProps) {
85
+ requireAccessibleName('Stepper', props)
86
+ const stepValues = new Set(steps.map(step => step.value))
87
+ if (
88
+ stepValues.size !== steps.length ||
89
+ steps.some(step => typeof step.value !== 'string' || !step.value.trim())
90
+ ) {
91
+ throw new TypeError('Stepper steps must have unique, nonempty values.')
92
+ }
93
+ const firstEnabled = steps.find(step => !step.disabled)?.value
94
+ const selection = useControllableState<string | null>({
95
+ name: 'Stepper value',
96
+ value,
97
+ defaultValue,
98
+ initialValue: firstEnabled ?? null,
99
+ onChange: next => {
100
+ if (next !== null) onValueChange?.(next)
101
+ }
102
+ })
103
+ const id = useId()
104
+ const linear = navigation === 'linear'
105
+ const horizontal = orientation === 'horizontal'
106
+ const currentIndex = steps.findIndex(step => step.value === selection.value)
107
+ const nextIndex = steps.findIndex((step, index) => index > currentIndex && !step.disabled)
108
+ const nativeProps = {
109
+ ...props,
110
+ role: undefined,
111
+ 'aria-current': undefined,
112
+ dangerouslySetInnerHTML: undefined
113
+ }
114
+
115
+ return (
116
+ <nav
117
+ {...nativeProps}
118
+ data-slot={joinIds('stepper', props['data-slot'])}
119
+ data-orientation={orientation}
120
+ data-navigation={navigation}
121
+ className={cn(
122
+ 'min-w-0 max-w-full [color:var(--rad-color-foreground)] font-[family-name:var(--rad-typography-roles-ui-body-family,system-ui,sans-serif)] text-[length:var(--_rad-control-font-size)] leading-[var(--rad-typography-roles-ui-body-line-height,1.5)]',
123
+ controlMetrics({ controlSize }),
124
+ controlBorderClass,
125
+ className
126
+ )}
127
+ >
128
+ <ol
129
+ data-slot="stepper-list"
130
+ className={cn(
131
+ 'm-0 min-w-0 list-none p-0',
132
+ horizontal ? 'flex items-stretch overflow-x-auto px-1 py-2' : 'grid px-1',
133
+ horizontal && scrollbarClass,
134
+ parts?.list?.className
135
+ )}
136
+ style={parts?.list?.style}
137
+ >
138
+ {steps.map((step, index) => {
139
+ const current = index === currentIndex
140
+ const error = hasText(step.error)
141
+ const completed =
142
+ !error && (step.completed ?? (linear && index < currentIndex && !step.disabled))
143
+ const blocked = step.disabled || (linear && index > currentIndex && index !== nextIndex)
144
+ const status: StepStatus = error
145
+ ? 'error'
146
+ : completed
147
+ ? 'completed'
148
+ : current
149
+ ? 'current'
150
+ : 'upcoming'
151
+ const labelId = id + '-label-' + index
152
+ const statusId = id + '-status-' + index
153
+ const descriptionId = hasText(step.description) ? id + '-description-' + index : undefined
154
+ const errorId = error ? id + '-error-' + index : undefined
155
+ return (
156
+ <li
157
+ key={step.value}
158
+ data-slot="stepper-item"
159
+ data-value={step.value}
160
+ data-state={status}
161
+ data-current={current ? '' : undefined}
162
+ data-completed={completed ? '' : undefined}
163
+ className={cn(
164
+ 'relative min-w-0',
165
+ horizontal
166
+ ? 'min-w-22 flex-1'
167
+ : 'min-h-[calc(var(--_rad-control-height)_+_1rem)] ps-[calc(var(--_rad-control-height)_+_0.75rem)] pb-4'
168
+ )}
169
+ >
170
+ {index < steps.length - 1 && (
171
+ <span
172
+ aria-hidden="true"
173
+ data-slot="stepper-connector"
174
+ className={cn(
175
+ 'pointer-events-none absolute [background:var(--rad-color-border)] forced-colors:[background:CanvasText]',
176
+ horizontal
177
+ ? 'start-[calc(50%_+_var(--_rad-control-height)/2_+_0.375rem)] top-[calc(0.125rem_+_var(--_rad-control-height)/2)] h-px w-[calc(100%_-_var(--_rad-control-height)_-_0.75rem)]'
178
+ : 'start-[calc(0.25rem_+_var(--_rad-control-height)/2)] top-[calc(var(--_rad-control-height)_+_0.5rem)] bottom-0 w-px',
179
+ completed &&
180
+ '[background:var(--rad-control-selected-border-color,var(--rad-color-accent))]',
181
+ parts?.connector?.className
182
+ )}
183
+ style={parts?.connector?.style}
184
+ />
185
+ )}
186
+ <Button
187
+ type="button"
188
+ variant="ghost"
189
+ tone="neutral"
190
+ controlSize={controlSize}
191
+ disabled={blocked}
192
+ motion="off"
193
+ aria-current={current ? 'step' : undefined}
194
+ aria-labelledby={labelId}
195
+ aria-describedby={joinIds(
196
+ status === 'current' ? undefined : statusId,
197
+ descriptionId,
198
+ errorId
199
+ )}
200
+ data-slot="stepper-step"
201
+ data-state={status}
202
+ data-current={current ? '' : undefined}
203
+ data-completed={completed ? '' : undefined}
204
+ style={parts?.step?.style}
205
+ render={resolved => (
206
+ <button
207
+ {...resolved}
208
+ className={cn(
209
+ 'relative flex w-full min-w-0 [&>span]:min-w-0 rounded-[var(--rad-control-radius,0.5rem)] [corner-shape:var(--rad-control-corner-shape,round)] bg-transparent px-1 text-inherit enabled:cursor-pointer enabled:hover:[&_[data-slot=stepper-label]]:underline disabled:cursor-default',
210
+ horizontal
211
+ ? 'justify-center pt-[calc(var(--_rad-control-height)_+_0.625rem)] text-center'
212
+ : "pt-0.5 text-start before:absolute before:end-[calc(100%_+_0.5rem)] before:top-0.5 before:size-[var(--_rad-control-height)] before:content-['']",
213
+ focusRingClass,
214
+ parts?.step?.className
215
+ )}
216
+ />
217
+ )}
218
+ onClick={() => selection.request(step.value)}
219
+ >
220
+ <span
221
+ id={labelId}
222
+ data-slot="stepper-label"
223
+ className={cn(
224
+ 'min-w-0 font-semibold [overflow-wrap:anywhere]',
225
+ parts?.label?.className
226
+ )}
227
+ style={parts?.label?.style}
228
+ >
229
+ {step.label}
230
+ </span>
231
+ </Button>
232
+ <span
233
+ aria-hidden="true"
234
+ data-slot="stepper-indicator"
235
+ className={cn(
236
+ markerClass,
237
+ 'pointer-events-none absolute top-0.5',
238
+ horizontal ? 'left-1/2 -translate-x-1/2' : 'start-1',
239
+ completed &&
240
+ 'border-[color:var(--rad-control-selected-border-color,var(--rad-color-accent))] bg-[var(--rad-control-selected-background,var(--rad-color-neutral))] [color:var(--rad-control-selected-foreground,var(--rad-color-foreground))]',
241
+ current &&
242
+ 'border-[color:var(--rad-color-accent)] bg-[var(--rad-color-accent)] [color:var(--rad-color-accent-foreground)] forced-colors:border-[Highlight] forced-colors:bg-[Highlight] forced-colors:text-[HighlightText]',
243
+ error &&
244
+ 'border-[color:var(--rad-color-invalid)] bg-[var(--rad-control-field-background,var(--rad-color-surface))] [color:var(--rad-color-invalid)] forced-colors:border-[CanvasText] forced-colors:bg-[Canvas] forced-colors:text-[CanvasText]',
245
+ parts?.indicator?.className
246
+ )}
247
+ style={parts?.indicator?.style}
248
+ >
249
+ {error ? '!' : completed && !current ? '✓' : index + 1}
250
+ </span>
251
+ <div
252
+ className={cn(
253
+ 'grid min-w-0 gap-0.5 px-1 pt-0.5 [overflow-wrap:anywhere]',
254
+ horizontal && 'text-center'
255
+ )}
256
+ >
257
+ <span
258
+ id={statusId}
259
+ data-slot="stepper-status"
260
+ className={cn(
261
+ 'text-xs [color:var(--rad-color-muted-foreground)]',
262
+ current && !error && 'font-medium [color:var(--rad-color-foreground)]',
263
+ error && 'font-semibold [color:var(--rad-color-invalid)]',
264
+ parts?.status?.className
265
+ )}
266
+ style={parts?.status?.style}
267
+ >
268
+ {current && status !== 'current' && (
269
+ <span aria-hidden="true">{statusLabels?.current || statusText.current} · </span>
270
+ )}
271
+ {statusLabels?.[status] || statusText[status]}
272
+ </span>
273
+ {descriptionId && (
274
+ <span
275
+ id={descriptionId}
276
+ data-slot="stepper-description"
277
+ className={cn(
278
+ 'text-xs [color:var(--rad-color-muted-foreground)]',
279
+ parts?.description?.className
280
+ )}
281
+ style={parts?.description?.style}
282
+ >
283
+ {step.description}
284
+ </span>
285
+ )}
286
+ {errorId && (
287
+ <span
288
+ id={errorId}
289
+ data-slot="stepper-error"
290
+ className={cn(
291
+ 'text-xs [color:var(--rad-color-invalid)]',
292
+ parts?.error?.className
293
+ )}
294
+ style={parts?.error?.style}
295
+ >
296
+ {step.error}
297
+ </span>
298
+ )}
299
+ </div>
300
+ </li>
301
+ )
302
+ })}
303
+ </ol>
304
+ </nav>
305
+ )
306
+ }
@@ -0,0 +1,139 @@
1
+ import type { ComponentProps, ReactNode } from 'react'
2
+ import { cn } from 'cn'
3
+ import { joinIds } from '../../internal/ids.js'
4
+ import type { PartStyle, Tone } from '../../presentation.js'
5
+ import type { ThemeStyle } from '../../themes/defineTheme.js'
6
+ import { actionTone } from '../shared/actionStyles.js'
7
+
8
+ type TimelinePart<Host extends 'ol' | 'li'> = Omit<ComponentProps<Host>, 'role' | 'style'> & {
9
+ style?: ThemeStyle
10
+ 'data-slot'?: string
11
+ }
12
+
13
+ export type TimelineProps = TimelinePart<'ol'>
14
+
15
+ export type TimelineItemProps = Omit<TimelinePart<'li'>, 'aria-current' | 'title'> & {
16
+ label: ReactNode
17
+ /** Machine-readable value forwarded to the native time element. */
18
+ dateTime: string
19
+ /** Formatted timestamp shown alongside the label. */
20
+ time: ReactNode
21
+ /** Decorative. Include its meaning in the event label or content. */
22
+ icon?: ReactNode
23
+ tone?: Tone
24
+ active?: boolean
25
+ parts?: {
26
+ indicator?: PartStyle
27
+ connector?: PartStyle
28
+ label?: PartStyle
29
+ time?: PartStyle
30
+ body?: PartStyle
31
+ }
32
+ }
33
+
34
+ export function Timeline({ className, ...props }: TimelineProps) {
35
+ return (
36
+ <ol
37
+ {...props}
38
+ // oxlint-disable-next-line jsx-a11y/no-redundant-roles -- Safari drops list semantics when markers are hidden.
39
+ role="list"
40
+ data-slot={joinIds('timeline', props['data-slot'])}
41
+ className={cn(
42
+ 'm-0 grid min-w-0 list-none p-0 text-start [color:var(--rad-color-foreground)] 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)] leading-[var(--rad-typography-roles-ui-body-line-height,1.5)] [--_rad-timeline-marker:var(--rad-timeline-marker-size,2rem)]',
43
+ className
44
+ )}
45
+ />
46
+ )
47
+ }
48
+
49
+ export function TimelineItem({
50
+ label,
51
+ dateTime,
52
+ time,
53
+ icon,
54
+ tone = 'neutral',
55
+ active = false,
56
+ parts,
57
+ className,
58
+ children,
59
+ ...props
60
+ }: TimelineItemProps) {
61
+ const nativeProps = { ...props, role: undefined }
62
+ return (
63
+ <li
64
+ {...nativeProps}
65
+ aria-current={active ? true : undefined}
66
+ data-slot={joinIds('timeline-item', props['data-slot'])}
67
+ data-active={active ? '' : undefined}
68
+ data-tone={tone}
69
+ className={cn(
70
+ 'group/timeline-item relative grid min-w-0 grid-cols-[var(--_rad-timeline-marker)_minmax(0,1fr)] items-start gap-x-3 pb-5 last:pb-0',
71
+ actionTone({ tone }),
72
+ className
73
+ )}
74
+ >
75
+ <span
76
+ aria-hidden="true"
77
+ data-slot="timeline-connector"
78
+ className={cn(
79
+ 'pointer-events-none absolute start-[calc(var(--_rad-timeline-marker)/2)] top-[calc(var(--_rad-timeline-marker)_+_0.25rem)] bottom-1 w-px [background:var(--rad-color-border)] group-last/timeline-item:hidden forced-colors:[background:CanvasText]',
80
+ parts?.connector?.className
81
+ )}
82
+ style={parts?.connector?.style}
83
+ />
84
+ <span
85
+ aria-hidden="true"
86
+ data-slot="timeline-indicator"
87
+ className={cn(
88
+ 'relative grid size-[var(--_rad-timeline-marker)] place-items-center rounded-[var(--rad-control-radius,0.5rem)] [corner-shape:var(--rad-control-corner-shape,round)] [border-width:var(--rad-control-border-width,1px)] [border-style:var(--rad-control-border-style,solid)] [border-color:var(--_action-edge)] bg-[var(--_action-soft)] [color:var(--_action-ink)] [&_svg]:size-4 forced-colors:border-[CanvasText] forced-colors:bg-[Canvas] forced-colors:text-[CanvasText]',
89
+ active &&
90
+ '[border-color:var(--_action-color)] bg-[var(--_action-color)] [color:var(--_action-on-color)] forced-colors:border-[Highlight] forced-colors:bg-[Highlight] forced-colors:text-[HighlightText]',
91
+ parts?.indicator?.className
92
+ )}
93
+ style={parts?.indicator?.style}
94
+ >
95
+ {icon ?? (
96
+ <span className={cn('rounded-full bg-current', active ? 'size-2.5' : 'size-1.5')} />
97
+ )}
98
+ </span>
99
+ <div className="grid min-w-0 gap-1 pt-0.5 [overflow-wrap:anywhere]">
100
+ <div className="flex min-w-0 flex-wrap items-baseline justify-between gap-x-3 gap-y-0.5">
101
+ <span
102
+ data-slot="timeline-label"
103
+ className={cn(
104
+ 'font-semibold',
105
+ active && 'underline decoration-2 underline-offset-3',
106
+ parts?.label?.className
107
+ )}
108
+ style={parts?.label?.style}
109
+ >
110
+ {label}
111
+ </span>
112
+ <time
113
+ dateTime={dateTime}
114
+ data-slot="timeline-time"
115
+ className={cn(
116
+ 'text-xs tabular-nums [color:var(--rad-color-muted-foreground)]',
117
+ parts?.time?.className
118
+ )}
119
+ style={parts?.time?.style}
120
+ >
121
+ {time}
122
+ </time>
123
+ </div>
124
+ {children != null && (
125
+ <div
126
+ data-slot="timeline-body"
127
+ className={cn(
128
+ 'text-sm [color:var(--rad-color-muted-foreground)]',
129
+ parts?.body?.className
130
+ )}
131
+ style={parts?.body?.style}
132
+ >
133
+ {children}
134
+ </div>
135
+ )}
136
+ </div>
137
+ </li>
138
+ )
139
+ }