@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
@@ -1,425 +1,425 @@
1
- "use client"
2
-
3
- import * as React from "react"
4
- import {
5
- IconCheck,
6
- IconChevronDown,
7
- IconCopy,
8
- IconInfoCircle,
9
- IconPalette,
10
- IconX,
11
- } from "@tabler/icons-react"
12
-
13
- import { cn } from "./utils"
14
- import { Popover, PopoverContent, PopoverTrigger } from "./popover"
15
- import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./tooltip"
16
-
17
- export interface ColorPickerProps {
18
- /**
19
- * Selected color hex string e.g. "#4f46e5".
20
- */
21
- value?: string
22
- /**
23
- * Default color hex string.
24
- */
25
- defaultValue?: string
26
- /**
27
- * Callback fired when color changes or is cleared.
28
- */
29
- onChange?: (color: string | null) => void
30
- /**
31
- * Field label text displayed statically above the color picker.
32
- */
33
- label?: React.ReactNode
34
- /**
35
- * Displays a required asterisk (*) next to the label.
36
- */
37
- required?: boolean
38
- /**
39
- * Tooltip message displayed in an interactive info icon next to the label.
40
- */
41
- tooltip?: React.ReactNode
42
- /**
43
- * Small informational note rendered below the color picker.
44
- */
45
- helperText?: React.ReactNode
46
- /**
47
- * Error text rendered below the color picker in destructive red.
48
- */
49
- errorText?: React.ReactNode
50
- /**
51
- * Placeholder text when no color is selected. Defaults to "Select color...".
52
- */
53
- placeholder?: string
54
- /** Accessible name for the clear button. */
55
- clearLabel?: string
56
- /** Accessible name for a tooltip trigger. Defaults to "More information". */
57
- tooltipTriggerLabel?: string
58
- /** Tooltip on the copy-hex button. */
59
- copyHexLabel?: string
60
- /** Copy button text, before and after copying. */
61
- copyLabel?: string
62
- copiedLabel?: string
63
- /** Heading above the preset swatches. */
64
- presetsLabel?: string
65
- /** Text of the "no colour" swatch. Defaults to "Clear selection". */
66
- clearSelectionLabel?: string
67
- /**
68
- * Presets color swatches. Defaults to a modern curated color palette.
69
- */
70
- presets?: string[]
71
- /**
72
- * Disables the color picker control.
73
- */
74
- disabled?: boolean
75
- /**
76
- * Allows clearing the selected color. Defaults to true.
77
- */
78
- clearable?: boolean
79
- /**
80
- * Custom container class name.
81
- */
82
- className?: string
83
- id?: string
84
- name?: string
85
- }
86
-
87
- const DEFAULT_PRESETS = [
88
- "#000000", // Black
89
- "#64748b", // Slate
90
- "#ef4444", // Red
91
- "#f97316", // Orange
92
- "#f59e0b", // Amber
93
- "#10b981", // Emerald
94
- "#06b6d4", // Cyan
95
- "#3b82f6", // Blue
96
- "#6366f1", // Indigo
97
- "#8b5cf6", // Violet
98
- "#ec4899", // Pink
99
- "#ffffff", // White
100
- ]
101
-
102
- function normalizeHex(hex?: string | null): string {
103
- if (!hex) return "#3b82f6"
104
- let clean = hex.trim()
105
- if (!clean.startsWith("#")) clean = `#${clean}`
106
- if (/^#[0-9A-F]{6}$/i.test(clean)) return clean
107
- if (/^#[0-9A-F]{3}$/i.test(clean)) {
108
- return `#${clean[1]}${clean[1]}${clean[2]}${clean[2]}${clean[3]}${clean[3]}`
109
- }
110
- return "#3b82f6"
111
- }
112
-
113
- const ColorPicker = React.forwardRef<HTMLDivElement, ColorPickerProps>(
114
- (
115
- {
116
- value,
117
- defaultValue,
118
- onChange,
119
- label,
120
- required,
121
- tooltip,
122
- helperText,
123
- errorText,
124
- placeholder = "Select color...",
125
- clearLabel = "Clear color",
126
- tooltipTriggerLabel = "More information",
127
- copyHexLabel = "Copy HEX code",
128
- copyLabel = "Copy",
129
- copiedLabel = "Copied",
130
- presetsLabel = "Presets",
131
- clearSelectionLabel = "Clear selection",
132
- presets = DEFAULT_PRESETS,
133
- disabled,
134
- clearable = true,
135
- className,
136
- id,
137
- name,
138
- },
139
- ref
140
- ) => {
141
- const [selectedColor, setSelectedColor] = React.useState<string | null>(() => {
142
- return value ?? defaultValue ?? null
143
- })
144
- const [open, setOpen] = React.useState(false)
145
- const [copied, setCopied] = React.useState(false)
146
-
147
- const hexInputRef = React.useRef<HTMLInputElement>(null)
148
-
149
- React.useEffect(() => {
150
- if (value !== undefined) {
151
- setSelectedColor(value)
152
- }
153
- }, [value])
154
-
155
- React.useEffect(() => {
156
- if (open) {
157
- const timer = setTimeout(() => {
158
- if (hexInputRef.current) {
159
- hexInputRef.current.focus()
160
- hexInputRef.current.select()
161
- }
162
- }, 50)
163
- return () => clearTimeout(timer)
164
- }
165
- }, [open])
166
-
167
- const handleColorChange = (newColor: string) => {
168
- const normalized = normalizeHex(newColor)
169
- setSelectedColor(normalized)
170
- onChange?.(normalized)
171
- }
172
-
173
- const handleClear = (e: React.MouseEvent) => {
174
- e.stopPropagation()
175
- setSelectedColor(null)
176
- onChange?.(null)
177
- }
178
-
179
- const handleCopy = () => {
180
- if (!selectedColor) return
181
- navigator.clipboard.writeText(selectedColor)
182
- setCopied(true)
183
- setTimeout(() => setCopied(false), 2000)
184
- }
185
-
186
- const hasHeader = label || tooltip || required
187
- const hasFooter = helperText || errorText
188
-
189
- const activeHex = selectedColor ? normalizeHex(selectedColor) : "#3b82f6"
190
-
191
- const triggerButton = (
192
- <Popover open={open} onOpenChange={setOpen}>
193
- <PopoverTrigger asChild>
194
- <button
195
- type="button"
196
- id={id}
197
- disabled={disabled}
198
- className={cn(
199
- "relative flex h-7 w-full items-center justify-start rounded-md border border-input bg-card ps-8 pe-8 py-0.5 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 aria-invalid:border-destructive aria-invalid:ring-2 aria-invalid:ring-destructive/20",
200
- !selectedColor && "text-muted-foreground font-normal",
201
- className
202
- )}
203
- >
204
- {/* Color Swatch Preview at start-2.5 */}
205
- <div className="absolute start-2.5 flex items-center justify-center size-3.5 shrink-0 z-10">
206
- {selectedColor ? (
207
- <span
208
- className="size-3.5 rounded-full border border-border/80 shadow-2xs transition-transform"
209
- style={{ backgroundColor: activeHex }}
210
- />
211
- ) : (
212
- <IconPalette className="size-3.5 text-muted-foreground shrink-0" aria-hidden="true" />
213
- )}
214
- </div>
215
-
216
- <span className="truncate uppercase font-mono tracking-wider">{selectedColor || placeholder}</span>
217
-
218
- {/* Trailing Chevron / Clear at end-2.5 */}
219
- <div className="absolute end-2.5 flex items-center justify-center gap-1 shrink-0 z-10">
220
- {clearable && selectedColor && !disabled && (
221
- <span
222
- role="button"
223
- tabIndex={-1}
224
- onClick={handleClear}
225
- aria-label={clearLabel}
226
- className="rounded p-0.5 text-muted-foreground transition-colors hover:bg-muted hover:text-foreground"
227
- >
228
- <IconX className="size-3.5" aria-hidden="true" />
229
- </span>
230
- )}
231
- <IconChevronDown className="size-3.5 text-muted-foreground transition-transform duration-200 group-data-[state=open]:rotate-180" />
232
- </div>
233
- </button>
234
- </PopoverTrigger>
235
- <PopoverContent align="start" className="w-64 p-3 shadow-lg border border-border bg-popover text-popover-foreground rounded-xl">
236
- {/* Header */}
237
- <div className="flex items-center justify-between pb-2 mb-2 border-b border-border/50">
238
- <div className="flex items-center gap-2">
239
- <span
240
- className="size-4 rounded-full border border-border/80 shadow-2xs"
241
- style={{ backgroundColor: activeHex }}
242
- />
243
- <span className="text-xs font-semibold text-foreground uppercase font-mono">
244
- {selectedColor ? activeHex : "Select Color"}
245
- </span>
246
- </div>
247
- {selectedColor && (
248
- <button
249
- type="button"
250
- onClick={handleCopy}
251
- title={copyHexLabel}
252
- className="flex items-center gap-1 text-[0.6875rem] font-medium text-muted-foreground transition-colors hover:text-foreground"
253
- >
254
- {copied ? (
255
- <>
256
- <IconCheck className="size-3 text-emerald-500" />
257
- <span className="text-emerald-500 font-semibold">{copiedLabel}</span>
258
- </>
259
- ) : (
260
- <>
261
- <IconCopy className="size-3" />
262
- <span>{copyLabel}</span>
263
- </>
264
- )}
265
- </button>
266
- )}
267
- </div>
268
-
269
- {/* Color Spectrum Picker & Hex Input */}
270
- <div className="flex items-center gap-2 mb-3">
271
- <input
272
- type="color"
273
- value={activeHex}
274
- onChange={(e) => handleColorChange(e.target.value)}
275
- className="size-8 rounded-lg border border-border/80 bg-card p-0.5 cursor-pointer shrink-0"
276
- />
277
- <div className="flex-1 min-w-0">
278
- <input
279
- ref={hexInputRef}
280
- type="text"
281
- value={selectedColor || ""}
282
- placeholder="#000000"
283
- onChange={(e) => handleColorChange(e.target.value)}
284
- onFocus={(e) => e.target.select()}
285
- className="h-8 w-full rounded-md border border-input bg-card px-2 text-xs font-mono font-medium uppercase text-foreground outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30"
286
- />
287
- </div>
288
- </div>
289
-
290
- {/* Swatch Presets Grid */}
291
- <div className="flex flex-col gap-1.5">
292
- <span className="text-[0.625rem] font-semibold text-muted-foreground uppercase">{presetsLabel}</span>
293
- <div className="grid grid-cols-6 gap-1.5">
294
- {presets.map((presetHex) => {
295
- const isSelected = selectedColor?.toLowerCase() === presetHex.toLowerCase()
296
- return (
297
- <button
298
- key={presetHex}
299
- type="button"
300
- onClick={() => handleColorChange(presetHex)}
301
- className={cn(
302
- "relative flex size-7 items-center justify-center rounded-lg border border-border/60 transition-transform hover:scale-110 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
303
- isSelected && "ring-2 ring-primary ring-offset-1"
304
- )}
305
- style={{ backgroundColor: presetHex }}
306
- title={presetHex}
307
- >
308
- {isSelected && (
309
- <IconCheck
310
- className={cn(
311
- "size-3.5 stroke-[3]",
312
- presetHex.toLowerCase() === "#ffffff" ? "text-black" : "text-white"
313
- )}
314
- />
315
- )}
316
- </button>
317
- )
318
- })}
319
- </div>
320
- </div>
321
-
322
- {/* Footer Clear */}
323
- {selectedColor && (
324
- <div className="flex items-center justify-end pt-2 mt-3 border-t border-border/50">
325
- <button
326
- type="button"
327
- onClick={() => {
328
- setSelectedColor(null)
329
- onChange?.(null)
330
- setOpen(false)
331
- }}
332
- className="text-[0.6875rem] text-muted-foreground hover:text-foreground transition-colors"
333
- >
334
- {clearSelectionLabel}
335
- </button>
336
- </div>
337
- )}
338
- </PopoverContent>
339
- </Popover>
340
- )
341
-
342
- if (name && selectedColor) {
343
- return (
344
- <div ref={ref} className="w-full">
345
- <input type="hidden" name={name} value={selectedColor} />
346
- {!hasHeader && !hasFooter ? (
347
- triggerButton
348
- ) : (
349
- <div className="flex flex-col gap-1 w-full text-start">
350
- {hasHeader && (
351
- <div className="flex items-center gap-1 text-xs font-semibold text-foreground">
352
- {label && <span>{label}</span>}
353
- {required && <span className="text-destructive font-semibold ms-0.5">*</span>}
354
- {tooltip && (
355
- <TooltipProvider>
356
- <Tooltip>
357
- <TooltipTrigger asChild>
358
- <button
359
- type="button"
360
- aria-label={tooltipTriggerLabel}
361
- 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"
362
- >
363
- <IconInfoCircle className="size-3.5 shrink-0" aria-hidden="true" />
364
- </button>
365
- </TooltipTrigger>
366
- <TooltipContent>{tooltip}</TooltipContent>
367
- </Tooltip>
368
- </TooltipProvider>
369
- )}
370
- </div>
371
- )}
372
- {triggerButton}
373
- {errorText ? (
374
- <p className="text-[0.6875rem] font-medium text-destructive">{errorText}</p>
375
- ) : (
376
- helperText && <p className="text-[0.6875rem] text-muted-foreground">{helperText}</p>
377
- )}
378
- </div>
379
- )}
380
- </div>
381
- )
382
- }
383
-
384
- if (!hasHeader && !hasFooter) {
385
- return <div ref={ref} className="w-full">{triggerButton}</div>
386
- }
387
-
388
- return (
389
- <div ref={ref} className="flex flex-col gap-1 w-full text-start">
390
- {hasHeader && (
391
- <div className="flex items-center gap-1 text-xs font-semibold text-foreground">
392
- {label && <span>{label}</span>}
393
- {required && <span className="text-destructive font-semibold ms-0.5">*</span>}
394
- {tooltip && (
395
- <TooltipProvider>
396
- <Tooltip>
397
- <TooltipTrigger asChild>
398
- <button
399
- type="button"
400
- aria-label={tooltipTriggerLabel}
401
- 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"
402
- >
403
- <IconInfoCircle className="size-3.5 shrink-0" aria-hidden="true" />
404
- </button>
405
- </TooltipTrigger>
406
- <TooltipContent>{tooltip}</TooltipContent>
407
- </Tooltip>
408
- </TooltipProvider>
409
- )}
410
- </div>
411
- )}
412
- {triggerButton}
413
- {errorText ? (
414
- <p className="text-[0.6875rem] font-medium text-destructive">{errorText}</p>
415
- ) : (
416
- helperText && <p className="text-[0.6875rem] text-muted-foreground">{helperText}</p>
417
- )}
418
- </div>
419
- )
420
- }
421
- )
422
-
423
- ColorPicker.displayName = "ColorPicker"
424
-
425
- export { ColorPicker }
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+ import {
5
+ IconCheck,
6
+ IconChevronDown,
7
+ IconCopy,
8
+ IconInfoCircle,
9
+ IconPalette,
10
+ IconX,
11
+ } from "@tabler/icons-react"
12
+
13
+ import { cn } from "./utils"
14
+ import { Popover, PopoverContent, PopoverTrigger } from "./popover"
15
+ import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./tooltip"
16
+
17
+ export interface ColorPickerProps {
18
+ /**
19
+ * Selected color hex string e.g. "#4f46e5".
20
+ */
21
+ value?: string
22
+ /**
23
+ * Default color hex string.
24
+ */
25
+ defaultValue?: string
26
+ /**
27
+ * Callback fired when color changes or is cleared.
28
+ */
29
+ onChange?: (color: string | null) => void
30
+ /**
31
+ * Field label text displayed statically above the color picker.
32
+ */
33
+ label?: React.ReactNode
34
+ /**
35
+ * Displays a required asterisk (*) next to the label.
36
+ */
37
+ required?: boolean
38
+ /**
39
+ * Tooltip message displayed in an interactive info icon next to the label.
40
+ */
41
+ tooltip?: React.ReactNode
42
+ /**
43
+ * Small informational note rendered below the color picker.
44
+ */
45
+ helperText?: React.ReactNode
46
+ /**
47
+ * Error text rendered below the color picker in destructive red.
48
+ */
49
+ errorText?: React.ReactNode
50
+ /**
51
+ * Placeholder text when no color is selected. Defaults to "Select color...".
52
+ */
53
+ placeholder?: string
54
+ /** Accessible name for the clear button. */
55
+ clearLabel?: string
56
+ /** Accessible name for a tooltip trigger. Defaults to "More information". */
57
+ tooltipTriggerLabel?: string
58
+ /** Tooltip on the copy-hex button. */
59
+ copyHexLabel?: string
60
+ /** Copy button text, before and after copying. */
61
+ copyLabel?: string
62
+ copiedLabel?: string
63
+ /** Heading above the preset swatches. */
64
+ presetsLabel?: string
65
+ /** Text of the "no colour" swatch. Defaults to "Clear selection". */
66
+ clearSelectionLabel?: string
67
+ /**
68
+ * Presets color swatches. Defaults to a modern curated color palette.
69
+ */
70
+ presets?: string[]
71
+ /**
72
+ * Disables the color picker control.
73
+ */
74
+ disabled?: boolean
75
+ /**
76
+ * Allows clearing the selected color. Defaults to true.
77
+ */
78
+ clearable?: boolean
79
+ /**
80
+ * Custom container class name.
81
+ */
82
+ className?: string
83
+ id?: string
84
+ name?: string
85
+ }
86
+
87
+ const DEFAULT_PRESETS = [
88
+ "#000000", // Black
89
+ "#64748b", // Slate
90
+ "#ef4444", // Red
91
+ "#f97316", // Orange
92
+ "#f59e0b", // Amber
93
+ "#10b981", // Emerald
94
+ "#06b6d4", // Cyan
95
+ "#3b82f6", // Blue
96
+ "#6366f1", // Indigo
97
+ "#8b5cf6", // Violet
98
+ "#ec4899", // Pink
99
+ "#ffffff", // White
100
+ ]
101
+
102
+ function normalizeHex(hex?: string | null): string {
103
+ if (!hex) return "#3b82f6"
104
+ let clean = hex.trim()
105
+ if (!clean.startsWith("#")) clean = `#${clean}`
106
+ if (/^#[0-9A-F]{6}$/i.test(clean)) return clean
107
+ if (/^#[0-9A-F]{3}$/i.test(clean)) {
108
+ return `#${clean[1]}${clean[1]}${clean[2]}${clean[2]}${clean[3]}${clean[3]}`
109
+ }
110
+ return "#3b82f6"
111
+ }
112
+
113
+ const ColorPicker = React.forwardRef<HTMLDivElement, ColorPickerProps>(
114
+ (
115
+ {
116
+ value,
117
+ defaultValue,
118
+ onChange,
119
+ label,
120
+ required,
121
+ tooltip,
122
+ helperText,
123
+ errorText,
124
+ placeholder = "Select color...",
125
+ clearLabel = "Clear color",
126
+ tooltipTriggerLabel = "More information",
127
+ copyHexLabel = "Copy HEX code",
128
+ copyLabel = "Copy",
129
+ copiedLabel = "Copied",
130
+ presetsLabel = "Presets",
131
+ clearSelectionLabel = "Clear selection",
132
+ presets = DEFAULT_PRESETS,
133
+ disabled,
134
+ clearable = true,
135
+ className,
136
+ id,
137
+ name,
138
+ },
139
+ ref
140
+ ) => {
141
+ const [selectedColor, setSelectedColor] = React.useState<string | null>(() => {
142
+ return value ?? defaultValue ?? null
143
+ })
144
+ const [open, setOpen] = React.useState(false)
145
+ const [copied, setCopied] = React.useState(false)
146
+
147
+ const hexInputRef = React.useRef<HTMLInputElement>(null)
148
+
149
+ React.useEffect(() => {
150
+ if (value !== undefined) {
151
+ setSelectedColor(value)
152
+ }
153
+ }, [value])
154
+
155
+ React.useEffect(() => {
156
+ if (open) {
157
+ const timer = setTimeout(() => {
158
+ if (hexInputRef.current) {
159
+ hexInputRef.current.focus()
160
+ hexInputRef.current.select()
161
+ }
162
+ }, 50)
163
+ return () => clearTimeout(timer)
164
+ }
165
+ }, [open])
166
+
167
+ const handleColorChange = (newColor: string) => {
168
+ const normalized = normalizeHex(newColor)
169
+ setSelectedColor(normalized)
170
+ onChange?.(normalized)
171
+ }
172
+
173
+ const handleClear = (e: React.MouseEvent) => {
174
+ e.stopPropagation()
175
+ setSelectedColor(null)
176
+ onChange?.(null)
177
+ }
178
+
179
+ const handleCopy = () => {
180
+ if (!selectedColor) return
181
+ navigator.clipboard.writeText(selectedColor)
182
+ setCopied(true)
183
+ setTimeout(() => setCopied(false), 2000)
184
+ }
185
+
186
+ const hasHeader = label || tooltip || required
187
+ const hasFooter = helperText || errorText
188
+
189
+ const activeHex = selectedColor ? normalizeHex(selectedColor) : "#3b82f6"
190
+
191
+ const triggerButton = (
192
+ <Popover open={open} onOpenChange={setOpen}>
193
+ <PopoverTrigger asChild>
194
+ <button
195
+ type="button"
196
+ id={id}
197
+ disabled={disabled}
198
+ className={cn(
199
+ "relative flex h-7 w-full items-center justify-start rounded-md border border-input bg-card ps-8 pe-8 py-0.5 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 aria-invalid:border-destructive aria-invalid:ring-2 aria-invalid:ring-destructive/20",
200
+ !selectedColor && "text-muted-foreground font-normal",
201
+ className
202
+ )}
203
+ >
204
+ {/* Color Swatch Preview at start-2.5 */}
205
+ <div className="absolute start-2.5 flex items-center justify-center size-3.5 shrink-0 z-10">
206
+ {selectedColor ? (
207
+ <span
208
+ className="size-3.5 rounded-full border border-border/80 shadow-2xs transition-transform"
209
+ style={{ backgroundColor: activeHex }}
210
+ />
211
+ ) : (
212
+ <IconPalette className="size-3.5 text-muted-foreground shrink-0" aria-hidden="true" />
213
+ )}
214
+ </div>
215
+
216
+ <span className="truncate uppercase font-mono tracking-wider">{selectedColor || placeholder}</span>
217
+
218
+ {/* Trailing Chevron / Clear at end-2.5 */}
219
+ <div className="absolute end-2.5 flex items-center justify-center gap-1 shrink-0 z-10">
220
+ {clearable && selectedColor && !disabled && (
221
+ <span
222
+ role="button"
223
+ tabIndex={-1}
224
+ onClick={handleClear}
225
+ aria-label={clearLabel}
226
+ className="rounded p-0.5 text-muted-foreground transition-colors hover:bg-muted hover:text-foreground"
227
+ >
228
+ <IconX className="size-3.5" aria-hidden="true" />
229
+ </span>
230
+ )}
231
+ <IconChevronDown className="size-3.5 text-muted-foreground transition-transform duration-200 group-data-[state=open]:rotate-180" />
232
+ </div>
233
+ </button>
234
+ </PopoverTrigger>
235
+ <PopoverContent align="start" className="w-64 p-3 shadow-lg border border-border bg-popover text-popover-foreground rounded-xl">
236
+ {/* Header */}
237
+ <div className="flex items-center justify-between pb-2 mb-2 border-b border-border/50">
238
+ <div className="flex items-center gap-2">
239
+ <span
240
+ className="size-4 rounded-full border border-border/80 shadow-2xs"
241
+ style={{ backgroundColor: activeHex }}
242
+ />
243
+ <span className="text-xs font-semibold text-foreground uppercase font-mono">
244
+ {selectedColor ? activeHex : "Select Color"}
245
+ </span>
246
+ </div>
247
+ {selectedColor && (
248
+ <button
249
+ type="button"
250
+ onClick={handleCopy}
251
+ title={copyHexLabel}
252
+ className="flex items-center gap-1 text-xs font-medium text-muted-foreground transition-colors hover:text-foreground"
253
+ >
254
+ {copied ? (
255
+ <>
256
+ <IconCheck className="size-3 text-emerald-500" />
257
+ <span className="text-emerald-500 font-semibold">{copiedLabel}</span>
258
+ </>
259
+ ) : (
260
+ <>
261
+ <IconCopy className="size-3" />
262
+ <span>{copyLabel}</span>
263
+ </>
264
+ )}
265
+ </button>
266
+ )}
267
+ </div>
268
+
269
+ {/* Color Spectrum Picker & Hex Input */}
270
+ <div className="flex items-center gap-2 mb-3">
271
+ <input
272
+ type="color"
273
+ value={activeHex}
274
+ onChange={(e) => handleColorChange(e.target.value)}
275
+ className="size-8 rounded-lg border border-border/80 bg-card p-0.5 cursor-pointer shrink-0"
276
+ />
277
+ <div className="flex-1 min-w-0">
278
+ <input
279
+ ref={hexInputRef}
280
+ type="text"
281
+ value={selectedColor || ""}
282
+ placeholder="#000000"
283
+ onChange={(e) => handleColorChange(e.target.value)}
284
+ onFocus={(e) => e.target.select()}
285
+ className="h-8 w-full rounded-md border border-input bg-card px-2 text-xs font-mono font-medium uppercase text-foreground outline-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30"
286
+ />
287
+ </div>
288
+ </div>
289
+
290
+ {/* Swatch Presets Grid */}
291
+ <div className="flex flex-col gap-1.5">
292
+ <span className="text-xs font-semibold text-muted-foreground uppercase">{presetsLabel}</span>
293
+ <div className="grid grid-cols-6 gap-1.5">
294
+ {presets.map((presetHex) => {
295
+ const isSelected = selectedColor?.toLowerCase() === presetHex.toLowerCase()
296
+ return (
297
+ <button
298
+ key={presetHex}
299
+ type="button"
300
+ onClick={() => handleColorChange(presetHex)}
301
+ className={cn(
302
+ "relative flex size-7 items-center justify-center rounded-lg border border-border/60 transition-transform hover:scale-110 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
303
+ isSelected && "ring-2 ring-primary ring-offset-1"
304
+ )}
305
+ style={{ backgroundColor: presetHex }}
306
+ title={presetHex}
307
+ >
308
+ {isSelected && (
309
+ <IconCheck
310
+ className={cn(
311
+ "size-3.5 stroke-[3]",
312
+ presetHex.toLowerCase() === "#ffffff" ? "text-black" : "text-white"
313
+ )}
314
+ />
315
+ )}
316
+ </button>
317
+ )
318
+ })}
319
+ </div>
320
+ </div>
321
+
322
+ {/* Footer Clear */}
323
+ {selectedColor && (
324
+ <div className="flex items-center justify-end pt-2 mt-3 border-t border-border/50">
325
+ <button
326
+ type="button"
327
+ onClick={() => {
328
+ setSelectedColor(null)
329
+ onChange?.(null)
330
+ setOpen(false)
331
+ }}
332
+ className="text-xs text-muted-foreground hover:text-foreground transition-colors"
333
+ >
334
+ {clearSelectionLabel}
335
+ </button>
336
+ </div>
337
+ )}
338
+ </PopoverContent>
339
+ </Popover>
340
+ )
341
+
342
+ if (name && selectedColor) {
343
+ return (
344
+ <div ref={ref} className="w-full">
345
+ <input type="hidden" name={name} value={selectedColor} />
346
+ {!hasHeader && !hasFooter ? (
347
+ triggerButton
348
+ ) : (
349
+ <div className="flex flex-col gap-1 w-full text-start">
350
+ {hasHeader && (
351
+ <div className="flex items-center gap-1 text-xs font-semibold text-foreground">
352
+ {label && <span>{label}</span>}
353
+ {required && <span className="text-destructive font-semibold ms-0.5">*</span>}
354
+ {tooltip && (
355
+ <TooltipProvider>
356
+ <Tooltip>
357
+ <TooltipTrigger asChild>
358
+ <button
359
+ type="button"
360
+ aria-label={tooltipTriggerLabel}
361
+ 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"
362
+ >
363
+ <IconInfoCircle className="size-3.5 shrink-0" aria-hidden="true" />
364
+ </button>
365
+ </TooltipTrigger>
366
+ <TooltipContent>{tooltip}</TooltipContent>
367
+ </Tooltip>
368
+ </TooltipProvider>
369
+ )}
370
+ </div>
371
+ )}
372
+ {triggerButton}
373
+ {errorText ? (
374
+ <p className="text-xs font-medium text-destructive">{errorText}</p>
375
+ ) : (
376
+ helperText && <p className="text-xs text-muted-foreground">{helperText}</p>
377
+ )}
378
+ </div>
379
+ )}
380
+ </div>
381
+ )
382
+ }
383
+
384
+ if (!hasHeader && !hasFooter) {
385
+ return <div ref={ref} className="w-full">{triggerButton}</div>
386
+ }
387
+
388
+ return (
389
+ <div ref={ref} className="flex flex-col gap-1 w-full text-start">
390
+ {hasHeader && (
391
+ <div className="flex items-center gap-1 text-xs font-semibold text-foreground">
392
+ {label && <span>{label}</span>}
393
+ {required && <span className="text-destructive font-semibold ms-0.5">*</span>}
394
+ {tooltip && (
395
+ <TooltipProvider>
396
+ <Tooltip>
397
+ <TooltipTrigger asChild>
398
+ <button
399
+ type="button"
400
+ aria-label={tooltipTriggerLabel}
401
+ 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"
402
+ >
403
+ <IconInfoCircle className="size-3.5 shrink-0" aria-hidden="true" />
404
+ </button>
405
+ </TooltipTrigger>
406
+ <TooltipContent>{tooltip}</TooltipContent>
407
+ </Tooltip>
408
+ </TooltipProvider>
409
+ )}
410
+ </div>
411
+ )}
412
+ {triggerButton}
413
+ {errorText ? (
414
+ <p className="text-xs font-medium text-destructive">{errorText}</p>
415
+ ) : (
416
+ helperText && <p className="text-xs text-muted-foreground">{helperText}</p>
417
+ )}
418
+ </div>
419
+ )
420
+ }
421
+ )
422
+
423
+ ColorPicker.displayName = "ColorPicker"
424
+
425
+ export { ColorPicker }