@whity/ui 0.5.0 → 1.0.0

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 (205) hide show
  1. package/README.md +107 -107
  2. package/package.json +221 -192
  3. package/src/access-denied.stories.tsx +179 -179
  4. package/src/access-denied.tsx +305 -305
  5. package/src/action-proposal.tsx +338 -302
  6. package/src/actor-chip.tsx +71 -71
  7. package/src/agent-activity.tsx +163 -163
  8. package/src/agent-collaboration.stories.tsx +156 -156
  9. package/src/agent-run-status.tsx +196 -196
  10. package/src/alert-dialog.stories.tsx +45 -45
  11. package/src/alert-dialog.tsx +147 -147
  12. package/src/alert.stories.tsx +91 -91
  13. package/src/alert.tsx +89 -89
  14. package/src/app-sidebar.stories.tsx +195 -195
  15. package/src/app-sidebar.tsx +604 -500
  16. package/src/approval-queue.tsx +109 -108
  17. package/src/audience-group-picker.stories.tsx +198 -198
  18. package/src/audience-group-picker.tsx +362 -362
  19. package/src/audience-people-picker.stories.tsx +102 -102
  20. package/src/audience-people-picker.tsx +279 -279
  21. package/src/avatar-pattern.ts +138 -0
  22. package/src/avatar.tsx +125 -83
  23. package/src/badge.stories.tsx +105 -105
  24. package/src/badge.tsx +68 -68
  25. package/src/beta-warning.stories.tsx +79 -79
  26. package/src/beta-warning.tsx +189 -189
  27. package/src/bilingual-input.stories.tsx +82 -82
  28. package/src/bilingual-input.tsx +188 -183
  29. package/src/board.tsx +216 -0
  30. package/src/breadcrumb.stories.tsx +51 -51
  31. package/src/breadcrumb.tsx +90 -90
  32. package/src/built-on-whity.tsx +52 -0
  33. package/src/button.stories.tsx +87 -87
  34. package/src/button.tsx +123 -118
  35. package/src/card.stories.tsx +423 -423
  36. package/src/card.tsx +180 -180
  37. package/src/chart.stories.tsx +66 -66
  38. package/src/chart.tsx +228 -228
  39. package/src/checkbox.stories.tsx +62 -62
  40. package/src/checkbox.tsx +54 -54
  41. package/src/collapsible.stories.tsx +48 -48
  42. package/src/collapsible.tsx +34 -34
  43. package/src/color-card.stories.tsx +61 -61
  44. package/src/color-card.tsx +270 -270
  45. package/src/color-picker.stories.tsx +65 -65
  46. package/src/color-picker.tsx +425 -425
  47. package/src/column-matcher.tsx +84 -0
  48. package/src/command-palette.tsx +398 -306
  49. package/src/confirm-action.tsx +98 -0
  50. package/src/copy-block.stories.tsx +38 -38
  51. package/src/copy-block.tsx +85 -85
  52. package/src/data-table.stories.tsx +200 -200
  53. package/src/data-table.tsx +1686 -1106
  54. package/src/date-picker.stories.tsx +61 -61
  55. package/src/date-picker.tsx +456 -422
  56. package/src/design-cards.stories.tsx +551 -458
  57. package/src/dialog.stories.tsx +48 -48
  58. package/src/dialog.tsx +179 -166
  59. package/src/display-preferences.tsx +50 -0
  60. package/src/documents/barcode-svg.stories.tsx +72 -72
  61. package/src/documents/barcode-svg.tsx +79 -79
  62. package/src/dropdown-menu.stories.tsx +77 -77
  63. package/src/dropdown-menu.tsx +271 -271
  64. package/src/editor/agent-panel.tsx +222 -0
  65. package/src/editor/agents.stories.tsx +81 -0
  66. package/src/editor/agents.ts +55 -0
  67. package/src/editor/behaviour.ts +279 -279
  68. package/src/editor/block-ids.ts +44 -44
  69. package/src/editor/block-list.tsx +104 -101
  70. package/src/editor/block-toolbar.tsx +490 -477
  71. package/src/editor/bubble.tsx +119 -93
  72. package/src/editor/catalogue.ts +169 -103
  73. package/src/editor/collab-rail.tsx +746 -746
  74. package/src/editor/collab.stories.tsx +207 -207
  75. package/src/editor/collab.ts +87 -87
  76. package/src/editor/contract.ts +476 -408
  77. package/src/editor/convert.ts +414 -362
  78. package/src/editor/doc-editor.stories.tsx +98 -98
  79. package/src/editor/doc-editor.tsx +1492 -1287
  80. package/src/editor/editor.css +636 -536
  81. package/src/editor/extensions.ts +86 -86
  82. package/src/editor/field-bar.tsx +154 -0
  83. package/src/editor/field-picker.tsx +109 -107
  84. package/src/editor/fields.ts +100 -100
  85. package/src/editor/gutter.tsx +443 -367
  86. package/src/editor/index.ts +23 -22
  87. package/src/editor/label-sheet.tsx +289 -289
  88. package/src/editor/labels.ts +394 -310
  89. package/src/editor/link-tools.tsx +141 -141
  90. package/src/editor/node-views.tsx +461 -450
  91. package/src/editor/page-view.tsx +372 -353
  92. package/src/editor/phone.tsx +310 -0
  93. package/src/editor/plugin-block-view.tsx +230 -0
  94. package/src/editor/plugin-blocks.stories.tsx +96 -0
  95. package/src/editor/plugin-blocks.ts +52 -0
  96. package/src/editor/publish-check.tsx +201 -182
  97. package/src/editor/rich-blocks.stories.tsx +146 -146
  98. package/src/editor/sample.ts +40 -40
  99. package/src/editor/save-block-dialog.tsx +141 -0
  100. package/src/editor/saved-block-view.tsx +205 -0
  101. package/src/editor/saved-blocks.stories.tsx +105 -0
  102. package/src/editor/saved-parts.ts +192 -0
  103. package/src/editor/schema-rich.ts +156 -150
  104. package/src/editor/schema.ts +368 -315
  105. package/src/editor/services.tsx +205 -127
  106. package/src/editor/slash.ts +64 -64
  107. package/src/editor/suggesting.ts +372 -372
  108. package/src/editor/suggestions.ts +763 -763
  109. package/src/editor/table-keys.ts +66 -66
  110. package/src/editor/templates.stories.tsx +324 -324
  111. package/src/editor/toolbar.tsx +364 -358
  112. package/src/empty-state.stories.tsx +51 -51
  113. package/src/empty-state.tsx +126 -100
  114. package/src/empty-state.usage-notes.md +30 -30
  115. package/src/form.stories.tsx +112 -112
  116. package/src/form.tsx +176 -176
  117. package/src/globals.css +20 -20
  118. package/src/icon-button.tsx +85 -85
  119. package/src/icon-map.ts +335 -244
  120. package/src/icon.tsx +41 -41
  121. package/src/index.ts +90 -67
  122. package/src/input.stories.tsx +157 -157
  123. package/src/input.tsx +768 -759
  124. package/src/kpi-strip.tsx +47 -0
  125. package/src/localized-text.ts +76 -0
  126. package/src/locked-screen.stories.tsx +29 -29
  127. package/src/locked-screen.tsx +75 -61
  128. package/src/lockup.tsx +42 -0
  129. package/src/lottie.tsx +441 -0
  130. package/src/mark.tsx +62 -62
  131. package/src/math-text.stories.tsx +33 -33
  132. package/src/math-text.tsx +43 -43
  133. package/src/menu-bar.stories.tsx +198 -198
  134. package/src/menu-bar.tsx +373 -373
  135. package/src/message-thread.tsx +181 -0
  136. package/src/money/currency.ts +244 -230
  137. package/src/money/money-input.tsx +131 -0
  138. package/src/money/money.tsx +33 -0
  139. package/src/open-on-computer.tsx +150 -0
  140. package/src/otp-input.tsx +161 -0
  141. package/src/page-header.stories.tsx +95 -95
  142. package/src/page-header.tsx +122 -122
  143. package/src/page-shell.stories.tsx +42 -42
  144. package/src/page-shell.tsx +32 -32
  145. package/src/page-states.tsx +277 -0
  146. package/src/pagination.stories.tsx +45 -45
  147. package/src/pagination.tsx +98 -98
  148. package/src/paper-sheet.stories.tsx +88 -0
  149. package/src/paper-sheet.tsx +85 -0
  150. package/src/phone-tab-bar.tsx +152 -0
  151. package/src/plugin-card.stories.tsx +208 -180
  152. package/src/plugin-card.tsx +931 -848
  153. package/src/popover.stories.tsx +48 -48
  154. package/src/popover.tsx +55 -55
  155. package/src/radio-group.stories.tsx +26 -26
  156. package/src/radio-group.tsx +44 -44
  157. package/src/route-flow/editor.tsx +1087 -1014
  158. package/src/route-flow/model.ts +771 -716
  159. package/src/save-bar.tsx +94 -0
  160. package/src/scope-grant.tsx +139 -139
  161. package/src/screen-too-small.stories.tsx +61 -61
  162. package/src/screen-too-small.tsx +104 -104
  163. package/src/search-field.tsx +65 -0
  164. package/src/select.stories.tsx +44 -44
  165. package/src/select.tsx +197 -197
  166. package/src/separator.stories.tsx +34 -34
  167. package/src/separator.tsx +34 -34
  168. package/src/sheet.stories.tsx +49 -49
  169. package/src/sheet.tsx +168 -168
  170. package/src/skeleton.stories.tsx +28 -28
  171. package/src/skeleton.tsx +19 -19
  172. package/src/slider.stories.tsx +78 -78
  173. package/src/slider.tsx +300 -300
  174. package/src/spinner.stories.tsx +33 -33
  175. package/src/spinner.tsx +55 -55
  176. package/src/stepper.tsx +85 -0
  177. package/src/switch.stories.tsx +42 -42
  178. package/src/switch.tsx +41 -41
  179. package/src/switcher.stories.tsx +111 -111
  180. package/src/switcher.tsx +131 -131
  181. package/src/system-state.tsx +55 -0
  182. package/src/table.stories.tsx +48 -48
  183. package/src/table.tsx +121 -121
  184. package/src/tabs.stories.tsx +74 -74
  185. package/src/tabs.tsx +90 -90
  186. package/src/tag-input.stories.tsx +67 -67
  187. package/src/tag-input.tsx +117 -117
  188. package/src/tenant-logo.tsx +63 -63
  189. package/src/tenant-switcher.stories.tsx +38 -38
  190. package/src/tenant-switcher.tsx +164 -164
  191. package/src/textarea.stories.tsx +27 -27
  192. package/src/textarea.tsx +18 -18
  193. package/src/theme-mode.ts +52 -52
  194. package/src/time-grid.tsx +163 -0
  195. package/src/time-picker.stories.tsx +62 -62
  196. package/src/time-picker.tsx +615 -615
  197. package/src/toggle-group.tsx +138 -138
  198. package/src/tooltip.stories.tsx +43 -43
  199. package/src/tooltip.tsx +73 -73
  200. package/src/top-nav.stories.tsx +58 -58
  201. package/src/top-nav.tsx +324 -324
  202. package/src/undo-bar.tsx +107 -107
  203. package/src/utils.ts +45 -45
  204. package/src/view-toggle.stories.tsx +84 -84
  205. package/src/view-toggle.tsx +110 -110
package/src/slider.tsx CHANGED
@@ -1,300 +1,300 @@
1
- "use client"
2
-
3
- import * as React from "react"
4
- import { Slider as SliderPrimitive } from "radix-ui"
5
- import { IconInfoCircle } from "@tabler/icons-react"
6
-
7
- import { cn } from "./utils"
8
- import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./tooltip"
9
-
10
- export interface SliderProps extends React.ComponentPropsWithoutRef<typeof SliderPrimitive.Root> {
11
- /**
12
- * Field label text displayed above the slider.
13
- */
14
- label?: React.ReactNode
15
- /**
16
- * Displays a required asterisk (*) next to the label.
17
- */
18
- required?: boolean
19
- /**
20
- * Tooltip message displayed in an interactive info icon next to the label.
21
- */
22
- tooltip?: React.ReactNode
23
- /** Accessible name for the tooltip's trigger button. Defaults to "More information". */
24
- tooltipTriggerLabel?: string
25
- /**
26
- * Small informational note rendered below the slider.
27
- */
28
- helperText?: React.ReactNode
29
- /**
30
- * Error text rendered below the slider in destructive red.
31
- */
32
- errorText?: React.ReactNode
33
- /**
34
- * Displays the current value badge next to the label. Defaults to true.
35
- */
36
- showValueBadge?: boolean
37
- /**
38
- * Renders direct numeric entry input field(s) alongside the slider track. Defaults to true.
39
- */
40
- showInput?: boolean
41
- /**
42
- * Optional formatter function for the value badge e.g. (val) => `${val}%`.
43
- */
44
- formatValue?: (value: number) => React.ReactNode
45
- }
46
-
47
- const Slider = React.forwardRef<
48
- React.ElementRef<typeof SliderPrimitive.Root>,
49
- SliderProps
50
- >(
51
- (
52
- {
53
- className,
54
- label,
55
- required,
56
- tooltip,
57
- tooltipTriggerLabel = "More information",
58
- helperText,
59
- errorText,
60
- showValueBadge = true,
61
- showInput = true,
62
- formatValue,
63
- defaultValue,
64
- value,
65
- min = 0,
66
- max = 100,
67
- step = 1,
68
- disabled,
69
- onValueChange,
70
- ...props
71
- },
72
- ref
73
- ) => {
74
- const initialVals = Array.isArray(value)
75
- ? value
76
- : Array.isArray(defaultValue)
77
- ? defaultValue
78
- : [min]
79
-
80
- const [internalValues, setInternalValues] = React.useState<number[]>(initialVals)
81
- const [inputStrings, setInputStrings] = React.useState<string[]>(
82
- initialVals.map((v) => String(v))
83
- )
84
-
85
- React.useEffect(() => {
86
- let nextVals = initialVals
87
- if (Array.isArray(value)) {
88
- nextVals = value
89
- } else if (Array.isArray(defaultValue)) {
90
- nextVals = defaultValue
91
- }
92
- setInternalValues(nextVals)
93
- setInputStrings(nextVals.map((v) => String(v)))
94
- }, [value, defaultValue])
95
-
96
- const handleValueChange = (vals: number[]) => {
97
- setInternalValues(vals)
98
- setInputStrings(vals.map((v) => String(v)))
99
- onValueChange?.(vals)
100
- }
101
-
102
- const handleDirectInputChange = (index: number, rawVal: string) => {
103
- setInputStrings((prev) => {
104
- const next = [...prev]
105
- next[index] = rawVal
106
- return next
107
- })
108
-
109
- const parsed = parseFloat(rawVal)
110
- if (isNaN(parsed)) return
111
-
112
- const newVals = [...internalValues]
113
- if (newVals.length === 1) {
114
- const clamped = Math.min(Math.max(parsed, min), max)
115
- newVals[0] = clamped
116
- setInternalValues(newVals)
117
- onValueChange?.(newVals)
118
- } else if (newVals.length === 2) {
119
- if (index === 0) {
120
- const clamped = Math.min(Math.max(parsed, min), newVals[1])
121
- newVals[0] = clamped
122
- } else {
123
- const clamped = Math.min(Math.max(parsed, newVals[0]), max)
124
- newVals[1] = clamped
125
- }
126
- setInternalValues(newVals)
127
- onValueChange?.(newVals)
128
- }
129
- }
130
-
131
- const handleInputBlur = (index: number) => {
132
- let parsed = parseFloat(inputStrings[index])
133
- if (isNaN(parsed)) {
134
- parsed = internalValues[index] ?? min
135
- }
136
- const newVals = [...internalValues]
137
- if (newVals.length === 1) {
138
- const clamped = Math.min(Math.max(parsed, min), max)
139
- newVals[0] = clamped
140
- } else if (newVals.length === 2) {
141
- if (index === 0) {
142
- const clamped = Math.min(Math.max(parsed, min), newVals[1])
143
- newVals[0] = clamped
144
- } else {
145
- const clamped = Math.min(Math.max(parsed, newVals[0]), max)
146
- newVals[1] = clamped
147
- }
148
- }
149
- setInternalValues(newVals)
150
- setInputStrings(newVals.map((v) => String(v)))
151
- onValueChange?.(newVals)
152
- }
153
-
154
- const renderDisplayVal = () => {
155
- if (!internalValues || internalValues.length === 0) return null
156
- if (internalValues.length === 1) {
157
- const val = internalValues[0]
158
- return formatValue ? formatValue(val) : val
159
- }
160
- const val1 = formatValue ? formatValue(internalValues[0]) : internalValues[0]
161
- const val2 = formatValue ? formatValue(internalValues[1]) : internalValues[1]
162
- return `${val1} – ${val2}`
163
- }
164
-
165
- const hasHeader = label || tooltip || required || (showValueBadge && (!showInput || !!formatValue))
166
- const hasFooter = helperText || errorText
167
-
168
- const isRange = internalValues.length > 1
169
-
170
- const sliderPrimitive = (
171
- <SliderPrimitive.Root
172
- ref={ref}
173
- data-slot="slider"
174
- disabled={disabled}
175
- defaultValue={defaultValue}
176
- value={value}
177
- min={min}
178
- max={max}
179
- step={step}
180
- onValueChange={handleValueChange}
181
- className={cn(
182
- "relative flex w-full touch-none select-none items-center py-1.5",
183
- disabled && "pointer-events-none opacity-50",
184
- className
185
- )}
186
- {...props}
187
- >
188
- <SliderPrimitive.Track className="relative h-1.5 w-full grow overflow-hidden rounded-full bg-muted">
189
- <SliderPrimitive.Range className="absolute h-full bg-primary" />
190
- </SliderPrimitive.Track>
191
- <SliderPrimitive.Thumb className="block size-4 rounded-full border-2 border-primary bg-card shadow-2xs transition-colors hover:scale-110 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 cursor-grab active:cursor-grabbing" />
192
- {isRange && (
193
- <SliderPrimitive.Thumb className="block size-4 rounded-full border-2 border-primary bg-card shadow-2xs transition-colors hover:scale-110 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 cursor-grab active:cursor-grabbing" />
194
- )}
195
- </SliderPrimitive.Root>
196
- )
197
-
198
- const renderCombinedSlider = () => {
199
- if (!showInput) return sliderPrimitive
200
-
201
- if (!isRange) {
202
- return (
203
- <div className="flex items-center gap-3 w-full">
204
- <div className="flex-1 min-w-0">{sliderPrimitive}</div>
205
- <input
206
- type="number"
207
- min={min}
208
- max={max}
209
- step={step}
210
- disabled={disabled}
211
- value={inputStrings[0] ?? ""}
212
- onChange={(e) => handleDirectInputChange(0, e.target.value)}
213
- onBlur={() => handleInputBlur(0)}
214
- onKeyDown={(e) => e.key === "Enter" && handleInputBlur(0)}
215
- className="h-7 w-14 shrink-0 rounded-md border border-input bg-card px-1.5 py-0.5 text-center text-xs font-medium text-foreground transition-colors outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 [appearance:textfield] [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:appearance-none"
216
- />
217
- </div>
218
- )
219
- }
220
-
221
- return (
222
- <div className="flex items-center gap-2.5 w-full">
223
- <input
224
- type="number"
225
- min={min}
226
- max={internalValues[1]}
227
- step={step}
228
- disabled={disabled}
229
- value={inputStrings[0] ?? ""}
230
- onChange={(e) => handleDirectInputChange(0, e.target.value)}
231
- onBlur={() => handleInputBlur(0)}
232
- onKeyDown={(e) => e.key === "Enter" && handleInputBlur(0)}
233
- className="h-7 w-14 shrink-0 rounded-md border border-input bg-card px-1.5 py-0.5 text-center text-xs font-medium text-foreground transition-colors outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 [appearance:textfield] [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:appearance-none"
234
- />
235
- <div className="flex-1 min-w-0">{sliderPrimitive}</div>
236
- <input
237
- type="number"
238
- min={internalValues[0]}
239
- max={max}
240
- step={step}
241
- disabled={disabled}
242
- value={inputStrings[1] ?? ""}
243
- onChange={(e) => handleDirectInputChange(1, e.target.value)}
244
- onBlur={() => handleInputBlur(1)}
245
- onKeyDown={(e) => e.key === "Enter" && handleInputBlur(1)}
246
- className="h-7 w-14 shrink-0 rounded-md border border-input bg-card px-1.5 py-0.5 text-center text-xs font-medium text-foreground transition-colors outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 [appearance:textfield] [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:appearance-none"
247
- />
248
- </div>
249
- )
250
- }
251
-
252
- if (!hasHeader && !hasFooter) {
253
- return renderCombinedSlider()
254
- }
255
-
256
- return (
257
- <div className="flex flex-col gap-1.5 w-full text-start">
258
- {hasHeader && (
259
- <div className="flex items-center justify-between gap-2 text-xs font-semibold text-foreground">
260
- <div className="flex items-center gap-1">
261
- {label && <span>{label}</span>}
262
- {required && <span className="text-destructive font-semibold ms-0.5">*</span>}
263
- {tooltip && (
264
- <TooltipProvider>
265
- <Tooltip>
266
- <TooltipTrigger asChild>
267
- <button
268
- type="button"
269
- aria-label={tooltipTriggerLabel}
270
- className="inline-flex items-center text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring rounded p-0.5"
271
- >
272
- <IconInfoCircle className="size-3.5 shrink-0" aria-hidden="true" />
273
- </button>
274
- </TooltipTrigger>
275
- <TooltipContent>{tooltip}</TooltipContent>
276
- </Tooltip>
277
- </TooltipProvider>
278
- )}
279
- </div>
280
- {showValueBadge && (!showInput || !!formatValue) && (
281
- <span className="rounded bg-muted px-1.5 py-0.5 font-mono text-[0.6875rem] font-semibold text-muted-foreground">
282
- {renderDisplayVal()}
283
- </span>
284
- )}
285
- </div>
286
- )}
287
- {renderCombinedSlider()}
288
- {errorText ? (
289
- <p className="text-[0.6875rem] font-medium text-destructive">{errorText}</p>
290
- ) : (
291
- helperText && <p className="text-[0.6875rem] text-muted-foreground">{helperText}</p>
292
- )}
293
- </div>
294
- )
295
- }
296
- )
297
-
298
- Slider.displayName = "Slider"
299
-
300
- export { Slider }
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+ import { Slider as SliderPrimitive } from "radix-ui"
5
+ import { IconInfoCircle } from "@tabler/icons-react"
6
+
7
+ import { cn } from "./utils"
8
+ import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./tooltip"
9
+
10
+ export interface SliderProps extends React.ComponentPropsWithoutRef<typeof SliderPrimitive.Root> {
11
+ /**
12
+ * Field label text displayed above the slider.
13
+ */
14
+ label?: React.ReactNode
15
+ /**
16
+ * Displays a required asterisk (*) next to the label.
17
+ */
18
+ required?: boolean
19
+ /**
20
+ * Tooltip message displayed in an interactive info icon next to the label.
21
+ */
22
+ tooltip?: React.ReactNode
23
+ /** Accessible name for the tooltip's trigger button. Defaults to "More information". */
24
+ tooltipTriggerLabel?: string
25
+ /**
26
+ * Small informational note rendered below the slider.
27
+ */
28
+ helperText?: React.ReactNode
29
+ /**
30
+ * Error text rendered below the slider in destructive red.
31
+ */
32
+ errorText?: React.ReactNode
33
+ /**
34
+ * Displays the current value badge next to the label. Defaults to true.
35
+ */
36
+ showValueBadge?: boolean
37
+ /**
38
+ * Renders direct numeric entry input field(s) alongside the slider track. Defaults to true.
39
+ */
40
+ showInput?: boolean
41
+ /**
42
+ * Optional formatter function for the value badge e.g. (val) => `${val}%`.
43
+ */
44
+ formatValue?: (value: number) => React.ReactNode
45
+ }
46
+
47
+ const Slider = React.forwardRef<
48
+ React.ElementRef<typeof SliderPrimitive.Root>,
49
+ SliderProps
50
+ >(
51
+ (
52
+ {
53
+ className,
54
+ label,
55
+ required,
56
+ tooltip,
57
+ tooltipTriggerLabel = "More information",
58
+ helperText,
59
+ errorText,
60
+ showValueBadge = true,
61
+ showInput = true,
62
+ formatValue,
63
+ defaultValue,
64
+ value,
65
+ min = 0,
66
+ max = 100,
67
+ step = 1,
68
+ disabled,
69
+ onValueChange,
70
+ ...props
71
+ },
72
+ ref
73
+ ) => {
74
+ const initialVals = Array.isArray(value)
75
+ ? value
76
+ : Array.isArray(defaultValue)
77
+ ? defaultValue
78
+ : [min]
79
+
80
+ const [internalValues, setInternalValues] = React.useState<number[]>(initialVals)
81
+ const [inputStrings, setInputStrings] = React.useState<string[]>(
82
+ initialVals.map((v) => String(v))
83
+ )
84
+
85
+ React.useEffect(() => {
86
+ let nextVals = initialVals
87
+ if (Array.isArray(value)) {
88
+ nextVals = value
89
+ } else if (Array.isArray(defaultValue)) {
90
+ nextVals = defaultValue
91
+ }
92
+ setInternalValues(nextVals)
93
+ setInputStrings(nextVals.map((v) => String(v)))
94
+ }, [value, defaultValue])
95
+
96
+ const handleValueChange = (vals: number[]) => {
97
+ setInternalValues(vals)
98
+ setInputStrings(vals.map((v) => String(v)))
99
+ onValueChange?.(vals)
100
+ }
101
+
102
+ const handleDirectInputChange = (index: number, rawVal: string) => {
103
+ setInputStrings((prev) => {
104
+ const next = [...prev]
105
+ next[index] = rawVal
106
+ return next
107
+ })
108
+
109
+ const parsed = parseFloat(rawVal)
110
+ if (isNaN(parsed)) return
111
+
112
+ const newVals = [...internalValues]
113
+ if (newVals.length === 1) {
114
+ const clamped = Math.min(Math.max(parsed, min), max)
115
+ newVals[0] = clamped
116
+ setInternalValues(newVals)
117
+ onValueChange?.(newVals)
118
+ } else if (newVals.length === 2) {
119
+ if (index === 0) {
120
+ const clamped = Math.min(Math.max(parsed, min), newVals[1])
121
+ newVals[0] = clamped
122
+ } else {
123
+ const clamped = Math.min(Math.max(parsed, newVals[0]), max)
124
+ newVals[1] = clamped
125
+ }
126
+ setInternalValues(newVals)
127
+ onValueChange?.(newVals)
128
+ }
129
+ }
130
+
131
+ const handleInputBlur = (index: number) => {
132
+ let parsed = parseFloat(inputStrings[index])
133
+ if (isNaN(parsed)) {
134
+ parsed = internalValues[index] ?? min
135
+ }
136
+ const newVals = [...internalValues]
137
+ if (newVals.length === 1) {
138
+ const clamped = Math.min(Math.max(parsed, min), max)
139
+ newVals[0] = clamped
140
+ } else if (newVals.length === 2) {
141
+ if (index === 0) {
142
+ const clamped = Math.min(Math.max(parsed, min), newVals[1])
143
+ newVals[0] = clamped
144
+ } else {
145
+ const clamped = Math.min(Math.max(parsed, newVals[0]), max)
146
+ newVals[1] = clamped
147
+ }
148
+ }
149
+ setInternalValues(newVals)
150
+ setInputStrings(newVals.map((v) => String(v)))
151
+ onValueChange?.(newVals)
152
+ }
153
+
154
+ const renderDisplayVal = () => {
155
+ if (!internalValues || internalValues.length === 0) return null
156
+ if (internalValues.length === 1) {
157
+ const val = internalValues[0]
158
+ return formatValue ? formatValue(val) : val
159
+ }
160
+ const val1 = formatValue ? formatValue(internalValues[0]) : internalValues[0]
161
+ const val2 = formatValue ? formatValue(internalValues[1]) : internalValues[1]
162
+ return `${val1} – ${val2}`
163
+ }
164
+
165
+ const hasHeader = label || tooltip || required || (showValueBadge && (!showInput || !!formatValue))
166
+ const hasFooter = helperText || errorText
167
+
168
+ const isRange = internalValues.length > 1
169
+
170
+ const sliderPrimitive = (
171
+ <SliderPrimitive.Root
172
+ ref={ref}
173
+ data-slot="slider"
174
+ disabled={disabled}
175
+ defaultValue={defaultValue}
176
+ value={value}
177
+ min={min}
178
+ max={max}
179
+ step={step}
180
+ onValueChange={handleValueChange}
181
+ className={cn(
182
+ "relative flex w-full touch-none select-none items-center py-1.5",
183
+ disabled && "pointer-events-none opacity-50",
184
+ className
185
+ )}
186
+ {...props}
187
+ >
188
+ <SliderPrimitive.Track className="relative h-1.5 w-full grow overflow-hidden rounded-full bg-muted">
189
+ <SliderPrimitive.Range className="absolute h-full bg-primary" />
190
+ </SliderPrimitive.Track>
191
+ <SliderPrimitive.Thumb className="block size-4 rounded-full border-2 border-primary bg-card shadow-2xs transition-colors hover:scale-110 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 cursor-grab active:cursor-grabbing" />
192
+ {isRange && (
193
+ <SliderPrimitive.Thumb className="block size-4 rounded-full border-2 border-primary bg-card shadow-2xs transition-colors hover:scale-110 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 cursor-grab active:cursor-grabbing" />
194
+ )}
195
+ </SliderPrimitive.Root>
196
+ )
197
+
198
+ const renderCombinedSlider = () => {
199
+ if (!showInput) return sliderPrimitive
200
+
201
+ if (!isRange) {
202
+ return (
203
+ <div className="flex items-center gap-3 w-full">
204
+ <div className="flex-1 min-w-0">{sliderPrimitive}</div>
205
+ <input
206
+ type="number"
207
+ min={min}
208
+ max={max}
209
+ step={step}
210
+ disabled={disabled}
211
+ value={inputStrings[0] ?? ""}
212
+ onChange={(e) => handleDirectInputChange(0, e.target.value)}
213
+ onBlur={() => handleInputBlur(0)}
214
+ onKeyDown={(e) => e.key === "Enter" && handleInputBlur(0)}
215
+ className="h-7 w-14 shrink-0 rounded-md border border-input bg-card px-1.5 py-0.5 text-center text-xs font-medium text-foreground transition-colors outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 [appearance:textfield] [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:appearance-none"
216
+ />
217
+ </div>
218
+ )
219
+ }
220
+
221
+ return (
222
+ <div className="flex items-center gap-2.5 w-full">
223
+ <input
224
+ type="number"
225
+ min={min}
226
+ max={internalValues[1]}
227
+ step={step}
228
+ disabled={disabled}
229
+ value={inputStrings[0] ?? ""}
230
+ onChange={(e) => handleDirectInputChange(0, e.target.value)}
231
+ onBlur={() => handleInputBlur(0)}
232
+ onKeyDown={(e) => e.key === "Enter" && handleInputBlur(0)}
233
+ className="h-7 w-14 shrink-0 rounded-md border border-input bg-card px-1.5 py-0.5 text-center text-xs font-medium text-foreground transition-colors outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 [appearance:textfield] [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:appearance-none"
234
+ />
235
+ <div className="flex-1 min-w-0">{sliderPrimitive}</div>
236
+ <input
237
+ type="number"
238
+ min={internalValues[0]}
239
+ max={max}
240
+ step={step}
241
+ disabled={disabled}
242
+ value={inputStrings[1] ?? ""}
243
+ onChange={(e) => handleDirectInputChange(1, e.target.value)}
244
+ onBlur={() => handleInputBlur(1)}
245
+ onKeyDown={(e) => e.key === "Enter" && handleInputBlur(1)}
246
+ className="h-7 w-14 shrink-0 rounded-md border border-input bg-card px-1.5 py-0.5 text-center text-xs font-medium text-foreground transition-colors outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 [appearance:textfield] [&::-webkit-outer-spin-button]:appearance-none [&::-webkit-inner-spin-button]:appearance-none"
247
+ />
248
+ </div>
249
+ )
250
+ }
251
+
252
+ if (!hasHeader && !hasFooter) {
253
+ return renderCombinedSlider()
254
+ }
255
+
256
+ return (
257
+ <div className="flex flex-col gap-1.5 w-full text-start">
258
+ {hasHeader && (
259
+ <div className="flex items-center justify-between gap-2 text-xs font-semibold text-foreground">
260
+ <div className="flex items-center gap-1">
261
+ {label && <span>{label}</span>}
262
+ {required && <span className="text-destructive font-semibold ms-0.5">*</span>}
263
+ {tooltip && (
264
+ <TooltipProvider>
265
+ <Tooltip>
266
+ <TooltipTrigger asChild>
267
+ <button
268
+ type="button"
269
+ aria-label={tooltipTriggerLabel}
270
+ className="inline-flex items-center text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring rounded p-0.5"
271
+ >
272
+ <IconInfoCircle className="size-3.5 shrink-0" aria-hidden="true" />
273
+ </button>
274
+ </TooltipTrigger>
275
+ <TooltipContent>{tooltip}</TooltipContent>
276
+ </Tooltip>
277
+ </TooltipProvider>
278
+ )}
279
+ </div>
280
+ {showValueBadge && (!showInput || !!formatValue) && (
281
+ <span className="rounded bg-muted px-1.5 py-0.5 font-mono text-xs font-semibold text-muted-foreground">
282
+ {renderDisplayVal()}
283
+ </span>
284
+ )}
285
+ </div>
286
+ )}
287
+ {renderCombinedSlider()}
288
+ {errorText ? (
289
+ <p className="text-xs font-medium text-destructive">{errorText}</p>
290
+ ) : (
291
+ helperText && <p className="text-xs text-muted-foreground">{helperText}</p>
292
+ )}
293
+ </div>
294
+ )
295
+ }
296
+ )
297
+
298
+ Slider.displayName = "Slider"
299
+
300
+ export { Slider }
@@ -1,33 +1,33 @@
1
- import type { Meta, StoryObj } from "@storybook/react-vite"
2
-
3
- import { Spinner } from "./spinner"
4
-
5
- const meta = {
6
- title: "Primitives/Spinner",
7
- component: Spinner,
8
- tags: ["autodocs"],
9
- argTypes: {
10
- size: { control: "select", options: ["sm", "default", "lg"] },
11
- },
12
- } satisfies Meta<typeof Spinner>
13
-
14
- export default meta
15
- type Story = StoryObj<typeof meta>
16
-
17
- export const Default: Story = {
18
- args: {},
19
- }
20
-
21
- export const Sizes: Story = {
22
- render: () => (
23
- <div className="flex items-center gap-4">
24
- <Spinner size="sm" />
25
- <Spinner size="default" />
26
- <Spinner size="lg" />
27
- </div>
28
- ),
29
- }
30
-
31
- export const CustomLabel: Story = {
32
- args: { label: "Fetching audit logs…" },
33
- }
1
+ import type { Meta, StoryObj } from "@storybook/react-vite"
2
+
3
+ import { Spinner } from "./spinner"
4
+
5
+ const meta = {
6
+ title: "Primitives/Spinner",
7
+ component: Spinner,
8
+ tags: ["autodocs"],
9
+ argTypes: {
10
+ size: { control: "select", options: ["sm", "default", "lg"] },
11
+ },
12
+ } satisfies Meta<typeof Spinner>
13
+
14
+ export default meta
15
+ type Story = StoryObj<typeof meta>
16
+
17
+ export const Default: Story = {
18
+ args: {},
19
+ }
20
+
21
+ export const Sizes: Story = {
22
+ render: () => (
23
+ <div className="flex items-center gap-4">
24
+ <Spinner size="sm" />
25
+ <Spinner size="default" />
26
+ <Spinner size="lg" />
27
+ </div>
28
+ ),
29
+ }
30
+
31
+ export const CustomLabel: Story = {
32
+ args: { label: "Fetching audit logs…" },
33
+ }