@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,270 +1,270 @@
1
- "use client"
2
-
3
- import * as React from "react"
4
- import { IconCheck } from "@tabler/icons-react"
5
-
6
- import { cn } from "./utils"
7
- import { Card } from "./card"
8
-
9
- export interface ColorShade {
10
- shade: number // 50, 100, 200, ..., 900
11
- name: string // e.g. "Whity Blue 100"
12
- hex: string // e.g. "#dbeafe"
13
- isMain?: boolean
14
- textColor: string // "#000000" or "#ffffff" for contrast
15
- }
16
-
17
- export interface ColorCardProps extends React.ComponentProps<"div"> {
18
- colorName?: string // e.g. "Whity Blue"
19
- mainHex?: string // e.g. "#2563eb" or pastel "#93c5fd"
20
- mainShade?: number // Which shade number is the main brand color (tagged as MAIN)
21
- onColorSelect?: (shade: ColorShade) => void
22
- /** Accessible name for the MAIN-shade marker. Defaults to "Main Brand Color". */
23
- mainShadeLabel?: string
24
- /** Short badge on the main shade. Defaults to "MAIN". */
25
- mainBadgeLabel?: string
26
- /** Confirmation flash after copying a swatch. Defaults to "COPIED". */
27
- copiedLabel?: string
28
- /**
29
- * Tooltip for a swatch. A function, not a string: the shade name and hex
30
- * sit inside the phrase and languages order them differently.
31
- */
32
- copyHint?: (name: string, hex: string) => string
33
- }
34
-
35
- // Default Whity Brand Design System Color Palette Presets (Including Neutral Greys)
36
- export const WHITY_BRAND_PRESETS = [
37
- { name: "Whity Blue", hex: "#2563eb", mainShade: 600 },
38
- { name: "Whity Greys", hex: "#64748b", mainShade: 500 },
39
- { name: "Whity Pastel Blue", hex: "#93c5fd", mainShade: 300 },
40
- { name: "Whity Emerald", hex: "#10b981", mainShade: 500 },
41
- { name: "Whity Amber", hex: "#f59e0b", mainShade: 500 },
42
- { name: "Whity Rose", hex: "#f43f5e", mainShade: 500 },
43
- { name: "Whity Slate", hex: "#475569", mainShade: 600 },
44
- { name: "Whity Dark Violet", hex: "#6d28d9", mainShade: 700 },
45
- ]
46
-
47
- function hexToRgb(hex: string): { r: number; g: number; b: number } {
48
- let c = hex.replace("#", "")
49
- if (c.length === 3) {
50
- c = c.split("").map((char) => char + char).join("")
51
- }
52
- const num = parseInt(c, 16) || 0
53
- return { r: (num >> 16) & 255, g: (num >> 8) & 255, b: num & 255 }
54
- }
55
-
56
- function rgbToHex(r: number, g: number, b: number): string {
57
- const toHex = (n: number) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, "0")
58
- return `#${toHex(r)}${toHex(g)}${toHex(b)}`
59
- }
60
-
61
- function rgbToHsl(r: number, g: number, b: number): { h: number; s: number; l: number } {
62
- r /= 255
63
- g /= 255
64
- b /= 255
65
- const max = Math.max(r, g, b)
66
- const min = Math.min(r, g, b)
67
- let h = 0
68
- let s = 0
69
- const l = (max + min) / 2
70
-
71
- if (max !== min) {
72
- const d = max - min
73
- s = l > 0.5 ? d / (2 - max - min) : d / (max + min)
74
- switch (max) {
75
- case r:
76
- h = (g - b) / d + (g < b ? 6 : 0)
77
- break
78
- case g:
79
- h = (b - r) / d + 2
80
- break
81
- case b:
82
- h = (r - g) / d + 4
83
- break
84
- }
85
- h /= 6
86
- }
87
- return { h: Math.round(h * 360), s: Math.round(s * 100), l: Math.round(l * 100) }
88
- }
89
-
90
- function hslToRgb(h: number, s: number, l: number): { r: number; g: number; b: number } {
91
- h /= 360
92
- s /= 100
93
- l /= 100
94
- let r: number, g: number, b: number
95
-
96
- if (s === 0) {
97
- r = g = b = l
98
- } else {
99
- const hue2rgb = (p: number, q: number, t: number) => {
100
- if (t < 0) t += 1
101
- if (t > 1) t -= 1
102
- if (t < 1 / 6) return p + (q - p) * 6 * t
103
- if (t < 1 / 2) return q
104
- if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6
105
- return p
106
- }
107
- const q = l < 0.5 ? l * (1 + s) : l + s - l * s
108
- const p = 2 * l - q
109
- r = hue2rgb(p, q, h + 1 / 3)
110
- g = hue2rgb(p, q, h)
111
- b = hue2rgb(p, q, h - 1 / 3)
112
- }
113
- return { r: Math.round(r * 255), g: Math.round(g * 255), b: Math.round(b * 255) }
114
- }
115
-
116
- /**
117
- * Automatically computes 50-900 shade scale (10 even steps) from a main color.
118
- * Black (#000000) and White (#ffffff) are excluded to maintain pure color scales.
119
- */
120
- export function generateShadeScale(
121
- name: string,
122
- mainHex: string,
123
- targetMainShade?: number
124
- ): ColorShade[] {
125
- const steps = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900]
126
- const rgb = hexToRgb(mainHex)
127
- const hsl = rgbToHsl(rgb.r, rgb.g, rgb.b)
128
-
129
- let mainShade = targetMainShade
130
- if (!mainShade) {
131
- const estimatedShade = Math.round((100 - hsl.l) * 10)
132
- mainShade = steps.reduce((prev, curr) =>
133
- Math.abs(curr - estimatedShade) < Math.abs(prev - estimatedShade) ? curr : prev
134
- )
135
- }
136
-
137
- const mainIndex = steps.indexOf(mainShade) !== -1 ? steps.indexOf(mainShade) : 5
138
-
139
- return steps.map((shade, idx) => {
140
- let hex: string
141
-
142
- if (idx === mainIndex) {
143
- hex = mainHex.toLowerCase()
144
- } else if (idx < mainIndex) {
145
- const factor = (mainIndex - idx) / (mainIndex + 1)
146
- const targetL = hsl.l + (96 - hsl.l) * factor
147
- const targetS = Math.max(5, hsl.s - factor * 15)
148
- const resRgb = hslToRgb(hsl.h, targetS, targetL)
149
- hex = rgbToHex(resRgb.r, resRgb.g, resRgb.b)
150
- } else {
151
- const factor = (idx - mainIndex) / (steps.length - mainIndex)
152
- const targetL = hsl.l - (hsl.l - 12) * factor
153
- const targetS = Math.min(100, hsl.s + factor * 10)
154
- const resRgb = hslToRgb(hsl.h, targetS, targetL)
155
- hex = rgbToHex(resRgb.r, resRgb.g, resRgb.b)
156
- }
157
-
158
- const resRgb = hexToRgb(hex)
159
- const luminance = (0.299 * resRgb.r + 0.587 * resRgb.g + 0.114 * resRgb.b) / 255
160
- const textColor = luminance > 0.55 ? "#0f172a" : "#ffffff"
161
-
162
- return {
163
- shade,
164
- name: `${name} ${shade}`,
165
- hex: hex.toLowerCase(),
166
- isMain: idx === mainIndex,
167
- textColor,
168
- }
169
- })
170
- }
171
-
172
- /**
173
- * Ultra-Minimal Color Card with generous top/bottom padding on tokens (`py-3.5 h-20`),
174
- * 10 even shade tokens (50 to 900), and top-edge cutout MAIN badge.
175
- */
176
- export function ColorCard({
177
- className,
178
- colorName = "Whity Blue",
179
- mainHex = "#2563eb",
180
- mainShade = 600,
181
- onColorSelect,
182
- mainShadeLabel = "Main Brand Color",
183
- mainBadgeLabel = "MAIN",
184
- copiedLabel = "COPIED",
185
- copyHint = (name: string, hex: string) => `Click to copy ${name} (${hex})`,
186
- ...props
187
- }: ColorCardProps) {
188
- const [copiedHex, setCopiedHex] = React.useState<string | null>(null)
189
-
190
- const shades = React.useMemo(() => {
191
- return generateShadeScale(colorName, mainHex, mainShade)
192
- }, [colorName, mainHex, mainShade])
193
-
194
- const handleSwatchClick = (shade: ColorShade) => {
195
- navigator.clipboard.writeText(shade.hex)
196
- setCopiedHex(shade.hex)
197
- onColorSelect?.(shade)
198
- setTimeout(() => setCopiedHex(null), 1500)
199
- }
200
-
201
- return (
202
- <Card
203
- variant="elevated"
204
- className={cn("w-full max-w-2xl overflow-visible p-3.5 pt-4 space-y-3.5 transition-all", className)}
205
- {...props}
206
- >
207
- {/* Clean Header */}
208
- <div className="flex items-center justify-between">
209
- <div className="flex items-center gap-2">
210
- <span
211
- className="size-3.5 rounded-full border border-black/10 shrink-0 shadow-2xs"
212
- style={{ backgroundColor: mainHex }}
213
- />
214
- <span className="font-heading font-semibold text-sm text-foreground tracking-tight">{colorName}</span>
215
- </div>
216
- <span className="font-mono text-xs text-muted-foreground uppercase font-semibold">{mainHex}</span>
217
- </div>
218
-
219
- {/* 10 Even Shade Tokens Grid with Generous Top/Bottom Padding (py-3.5 h-20) */}
220
- <div className="grid grid-cols-5 sm:grid-cols-10 gap-1.5 w-full pt-1.5">
221
- {shades.map((shade) => {
222
- const isCopied = copiedHex === shade.hex
223
-
224
- return (
225
- <button
226
- key={shade.shade}
227
- type="button"
228
- onClick={() => handleSwatchClick(shade)}
229
- className={cn(
230
- "group relative flex flex-col justify-between py-3.5 px-1.5 rounded-md h-20 transition-all duration-150 cursor-pointer w-full hover:scale-105 hover:z-30 focus:outline-none border border-black/10 dark:border-white/10 hover:border-foreground/30",
231
- shade.isMain && "z-20"
232
- )}
233
- style={{ backgroundColor: shade.hex, color: shade.textColor }}
234
- title={copyHint(shade.name, shade.hex)}
235
- >
236
- {/* MAIN Badge Resting on Top Edge with Card Background Cutout Border */}
237
- {shade.isMain && (
238
- <span
239
- aria-label={mainShadeLabel}
240
- className="absolute -top-2.5 left-1/2 -translate-x-1/2 z-30 text-[7.5px] font-semibold uppercase tracking-wider px-1.5 py-0.5 rounded-full border-2 border-card shadow-2xs whitespace-nowrap leading-none select-none"
241
- style={{
242
- backgroundColor: shade.hex,
243
- color: shade.textColor,
244
- }}
245
- >
246
- {mainBadgeLabel}
247
- </span>
248
- )}
249
-
250
- <div className="flex items-center justify-between w-full">
251
- <span className="text-[10px] font-semibold font-mono tracking-tight">{shade.shade}</span>
252
- </div>
253
-
254
- {isCopied ? (
255
- <div className="flex items-center justify-center gap-0.5 text-[8px] font-semibold text-emerald-400 bg-slate-950 px-1 py-0.5 rounded-xs animate-pulse ring-1 ring-emerald-500/50">
256
- <IconCheck className="size-2.5 shrink-0" />
257
- <span>{copiedLabel}</span>
258
- </div>
259
- ) : (
260
- <span className="text-[8.5px] font-mono uppercase opacity-90 font-semibold truncate">
261
- {shade.hex}
262
- </span>
263
- )}
264
- </button>
265
- )
266
- })}
267
- </div>
268
- </Card>
269
- )
270
- }
1
+ "use client"
2
+
3
+ import * as React from "react"
4
+ import { IconCheck } from "@tabler/icons-react"
5
+
6
+ import { cn } from "./utils"
7
+ import { Card } from "./card"
8
+
9
+ export interface ColorShade {
10
+ shade: number // 50, 100, 200, ..., 900
11
+ name: string // e.g. "Whity Blue 100"
12
+ hex: string // e.g. "#dbeafe"
13
+ isMain?: boolean
14
+ textColor: string // "#000000" or "#ffffff" for contrast
15
+ }
16
+
17
+ export interface ColorCardProps extends React.ComponentProps<"div"> {
18
+ colorName?: string // e.g. "Whity Blue"
19
+ mainHex?: string // e.g. "#2563eb" or pastel "#93c5fd"
20
+ mainShade?: number // Which shade number is the main brand color (tagged as MAIN)
21
+ onColorSelect?: (shade: ColorShade) => void
22
+ /** Accessible name for the MAIN-shade marker. Defaults to "Main Brand Color". */
23
+ mainShadeLabel?: string
24
+ /** Short badge on the main shade. Defaults to "MAIN". */
25
+ mainBadgeLabel?: string
26
+ /** Confirmation flash after copying a swatch. Defaults to "COPIED". */
27
+ copiedLabel?: string
28
+ /**
29
+ * Tooltip for a swatch. A function, not a string: the shade name and hex
30
+ * sit inside the phrase and languages order them differently.
31
+ */
32
+ copyHint?: (name: string, hex: string) => string
33
+ }
34
+
35
+ // Default Whity Brand Design System Color Palette Presets (Including Neutral Greys)
36
+ export const WHITY_BRAND_PRESETS = [
37
+ { name: "Whity Blue", hex: "#2563eb", mainShade: 600 },
38
+ { name: "Whity Greys", hex: "#64748b", mainShade: 500 },
39
+ { name: "Whity Pastel Blue", hex: "#93c5fd", mainShade: 300 },
40
+ { name: "Whity Emerald", hex: "#10b981", mainShade: 500 },
41
+ { name: "Whity Amber", hex: "#f59e0b", mainShade: 500 },
42
+ { name: "Whity Rose", hex: "#f43f5e", mainShade: 500 },
43
+ { name: "Whity Slate", hex: "#475569", mainShade: 600 },
44
+ { name: "Whity Dark Violet", hex: "#6d28d9", mainShade: 700 },
45
+ ]
46
+
47
+ function hexToRgb(hex: string): { r: number; g: number; b: number } {
48
+ let c = hex.replace("#", "")
49
+ if (c.length === 3) {
50
+ c = c.split("").map((char) => char + char).join("")
51
+ }
52
+ const num = parseInt(c, 16) || 0
53
+ return { r: (num >> 16) & 255, g: (num >> 8) & 255, b: num & 255 }
54
+ }
55
+
56
+ function rgbToHex(r: number, g: number, b: number): string {
57
+ const toHex = (n: number) => Math.max(0, Math.min(255, Math.round(n))).toString(16).padStart(2, "0")
58
+ return `#${toHex(r)}${toHex(g)}${toHex(b)}`
59
+ }
60
+
61
+ function rgbToHsl(r: number, g: number, b: number): { h: number; s: number; l: number } {
62
+ r /= 255
63
+ g /= 255
64
+ b /= 255
65
+ const max = Math.max(r, g, b)
66
+ const min = Math.min(r, g, b)
67
+ let h = 0
68
+ let s = 0
69
+ const l = (max + min) / 2
70
+
71
+ if (max !== min) {
72
+ const d = max - min
73
+ s = l > 0.5 ? d / (2 - max - min) : d / (max + min)
74
+ switch (max) {
75
+ case r:
76
+ h = (g - b) / d + (g < b ? 6 : 0)
77
+ break
78
+ case g:
79
+ h = (b - r) / d + 2
80
+ break
81
+ case b:
82
+ h = (r - g) / d + 4
83
+ break
84
+ }
85
+ h /= 6
86
+ }
87
+ return { h: Math.round(h * 360), s: Math.round(s * 100), l: Math.round(l * 100) }
88
+ }
89
+
90
+ function hslToRgb(h: number, s: number, l: number): { r: number; g: number; b: number } {
91
+ h /= 360
92
+ s /= 100
93
+ l /= 100
94
+ let r: number, g: number, b: number
95
+
96
+ if (s === 0) {
97
+ r = g = b = l
98
+ } else {
99
+ const hue2rgb = (p: number, q: number, t: number) => {
100
+ if (t < 0) t += 1
101
+ if (t > 1) t -= 1
102
+ if (t < 1 / 6) return p + (q - p) * 6 * t
103
+ if (t < 1 / 2) return q
104
+ if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6
105
+ return p
106
+ }
107
+ const q = l < 0.5 ? l * (1 + s) : l + s - l * s
108
+ const p = 2 * l - q
109
+ r = hue2rgb(p, q, h + 1 / 3)
110
+ g = hue2rgb(p, q, h)
111
+ b = hue2rgb(p, q, h - 1 / 3)
112
+ }
113
+ return { r: Math.round(r * 255), g: Math.round(g * 255), b: Math.round(b * 255) }
114
+ }
115
+
116
+ /**
117
+ * Automatically computes 50-900 shade scale (10 even steps) from a main color.
118
+ * Black (#000000) and White (#ffffff) are excluded to maintain pure color scales.
119
+ */
120
+ export function generateShadeScale(
121
+ name: string,
122
+ mainHex: string,
123
+ targetMainShade?: number
124
+ ): ColorShade[] {
125
+ const steps = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900]
126
+ const rgb = hexToRgb(mainHex)
127
+ const hsl = rgbToHsl(rgb.r, rgb.g, rgb.b)
128
+
129
+ let mainShade = targetMainShade
130
+ if (!mainShade) {
131
+ const estimatedShade = Math.round((100 - hsl.l) * 10)
132
+ mainShade = steps.reduce((prev, curr) =>
133
+ Math.abs(curr - estimatedShade) < Math.abs(prev - estimatedShade) ? curr : prev
134
+ )
135
+ }
136
+
137
+ const mainIndex = steps.indexOf(mainShade) !== -1 ? steps.indexOf(mainShade) : 5
138
+
139
+ return steps.map((shade, idx) => {
140
+ let hex: string
141
+
142
+ if (idx === mainIndex) {
143
+ hex = mainHex.toLowerCase()
144
+ } else if (idx < mainIndex) {
145
+ const factor = (mainIndex - idx) / (mainIndex + 1)
146
+ const targetL = hsl.l + (96 - hsl.l) * factor
147
+ const targetS = Math.max(5, hsl.s - factor * 15)
148
+ const resRgb = hslToRgb(hsl.h, targetS, targetL)
149
+ hex = rgbToHex(resRgb.r, resRgb.g, resRgb.b)
150
+ } else {
151
+ const factor = (idx - mainIndex) / (steps.length - mainIndex)
152
+ const targetL = hsl.l - (hsl.l - 12) * factor
153
+ const targetS = Math.min(100, hsl.s + factor * 10)
154
+ const resRgb = hslToRgb(hsl.h, targetS, targetL)
155
+ hex = rgbToHex(resRgb.r, resRgb.g, resRgb.b)
156
+ }
157
+
158
+ const resRgb = hexToRgb(hex)
159
+ const luminance = (0.299 * resRgb.r + 0.587 * resRgb.g + 0.114 * resRgb.b) / 255
160
+ const textColor = luminance > 0.55 ? "#0f172a" : "#ffffff"
161
+
162
+ return {
163
+ shade,
164
+ name: `${name} ${shade}`,
165
+ hex: hex.toLowerCase(),
166
+ isMain: idx === mainIndex,
167
+ textColor,
168
+ }
169
+ })
170
+ }
171
+
172
+ /**
173
+ * Ultra-Minimal Color Card with generous top/bottom padding on tokens (`py-3.5 h-20`),
174
+ * 10 even shade tokens (50 to 900), and top-edge cutout MAIN badge.
175
+ */
176
+ export function ColorCard({
177
+ className,
178
+ colorName = "Whity Blue",
179
+ mainHex = "#2563eb",
180
+ mainShade = 600,
181
+ onColorSelect,
182
+ mainShadeLabel = "Main Brand Color",
183
+ mainBadgeLabel = "MAIN",
184
+ copiedLabel = "COPIED",
185
+ copyHint = (name: string, hex: string) => `Click to copy ${name} (${hex})`,
186
+ ...props
187
+ }: ColorCardProps) {
188
+ const [copiedHex, setCopiedHex] = React.useState<string | null>(null)
189
+
190
+ const shades = React.useMemo(() => {
191
+ return generateShadeScale(colorName, mainHex, mainShade)
192
+ }, [colorName, mainHex, mainShade])
193
+
194
+ const handleSwatchClick = (shade: ColorShade) => {
195
+ navigator.clipboard.writeText(shade.hex)
196
+ setCopiedHex(shade.hex)
197
+ onColorSelect?.(shade)
198
+ setTimeout(() => setCopiedHex(null), 1500)
199
+ }
200
+
201
+ return (
202
+ <Card
203
+ variant="elevated"
204
+ className={cn("w-full max-w-2xl overflow-visible p-3.5 pt-4 space-y-3.5 transition-all", className)}
205
+ {...props}
206
+ >
207
+ {/* Clean Header */}
208
+ <div className="flex items-center justify-between">
209
+ <div className="flex items-center gap-2">
210
+ <span
211
+ className="size-3.5 rounded-full border border-black/10 shrink-0 shadow-2xs"
212
+ style={{ backgroundColor: mainHex }}
213
+ />
214
+ <span className="font-heading font-semibold text-sm text-foreground tracking-tight">{colorName}</span>
215
+ </div>
216
+ <span className="font-mono text-xs text-muted-foreground uppercase font-semibold">{mainHex}</span>
217
+ </div>
218
+
219
+ {/* 10 Even Shade Tokens Grid with Generous Top/Bottom Padding (py-3.5 h-20) */}
220
+ <div className="grid grid-cols-5 sm:grid-cols-10 gap-1.5 w-full pt-1.5">
221
+ {shades.map((shade) => {
222
+ const isCopied = copiedHex === shade.hex
223
+
224
+ return (
225
+ <button
226
+ key={shade.shade}
227
+ type="button"
228
+ onClick={() => handleSwatchClick(shade)}
229
+ className={cn(
230
+ "group relative flex flex-col justify-between py-3.5 px-1.5 rounded-md h-20 transition-all duration-150 cursor-pointer w-full hover:scale-105 hover:z-30 focus:outline-none border border-black/10 dark:border-white/10 hover:border-foreground/30",
231
+ shade.isMain && "z-20"
232
+ )}
233
+ style={{ backgroundColor: shade.hex, color: shade.textColor }}
234
+ title={copyHint(shade.name, shade.hex)}
235
+ >
236
+ {/* MAIN Badge Resting on Top Edge with Card Background Cutout Border */}
237
+ {shade.isMain && (
238
+ <span
239
+ aria-label={mainShadeLabel}
240
+ className="absolute -top-2.5 left-1/2 -translate-x-1/2 z-30 text-xs font-semibold uppercase tracking-wider px-1.5 py-0.5 rounded-full border-2 border-card shadow-2xs whitespace-nowrap leading-none select-none"
241
+ style={{
242
+ backgroundColor: shade.hex,
243
+ color: shade.textColor,
244
+ }}
245
+ >
246
+ {mainBadgeLabel}
247
+ </span>
248
+ )}
249
+
250
+ <div className="flex items-center justify-between w-full">
251
+ <span className="text-xs font-semibold font-mono tracking-tight">{shade.shade}</span>
252
+ </div>
253
+
254
+ {isCopied ? (
255
+ <div className="flex items-center justify-center gap-0.5 text-xs font-semibold text-emerald-400 bg-slate-950 px-1 py-0.5 rounded-xs animate-pulse ring-1 ring-emerald-500/50">
256
+ <IconCheck className="size-2.5 shrink-0" />
257
+ <span>{copiedLabel}</span>
258
+ </div>
259
+ ) : (
260
+ <span className="text-xs font-mono uppercase opacity-90 font-semibold truncate">
261
+ {shade.hex}
262
+ </span>
263
+ )}
264
+ </button>
265
+ )
266
+ })}
267
+ </div>
268
+ </Card>
269
+ )
270
+ }
@@ -1,65 +1,65 @@
1
- import type { Meta, StoryObj } from "@storybook/react"
2
- import { ColorPicker } from "./color-picker"
3
-
4
- const meta: Meta<typeof ColorPicker> = {
5
- title: "Primitives/ColorPicker",
6
- component: ColorPicker,
7
- tags: ["autodocs"],
8
- argTypes: {
9
- value: { control: "color" },
10
- defaultValue: { control: "color" },
11
- label: { control: "text" },
12
- required: { control: "boolean" },
13
- tooltip: { control: "text" },
14
- helperText: { control: "text" },
15
- errorText: { control: "text" },
16
- disabled: { control: "boolean" },
17
- clearable: { control: "boolean" },
18
- },
19
- }
20
-
21
- export default meta
22
- type Story = StoryObj<typeof ColorPicker>
23
-
24
- export const Default: Story = {
25
- args: {
26
- placeholder: "Select color...",
27
- defaultValue: "#4f46e5",
28
- },
29
- }
30
-
31
- export const WithLabelAndTooltip: Story = {
32
- args: {
33
- label: "Brand Theme Color",
34
- required: true,
35
- tooltip: "Choose a primary accent color for your brand dashboard.",
36
- defaultValue: "#3b82f6",
37
- helperText: "Supports HEX, RGB, and color presets.",
38
- },
39
- }
40
-
41
- export const States: Story = {
42
- render: () => (
43
- <div className="flex flex-col gap-4 max-w-sm">
44
- <ColorPicker
45
- label="Empty State"
46
- placeholder="Choose accent color..."
47
- />
48
- <ColorPicker
49
- label="Selected Color"
50
- defaultValue="#10b981"
51
- helperText="Active theme color"
52
- />
53
- <ColorPicker
54
- label="Disabled State"
55
- defaultValue="#6366f1"
56
- disabled
57
- />
58
- <ColorPicker
59
- label="Error State"
60
- defaultValue="#ef4444"
61
- errorText="Invalid color selection"
62
- />
63
- </div>
64
- ),
65
- }
1
+ import type { Meta, StoryObj } from "@storybook/react"
2
+ import { ColorPicker } from "./color-picker"
3
+
4
+ const meta: Meta<typeof ColorPicker> = {
5
+ title: "Primitives/ColorPicker",
6
+ component: ColorPicker,
7
+ tags: ["autodocs"],
8
+ argTypes: {
9
+ value: { control: "color" },
10
+ defaultValue: { control: "color" },
11
+ label: { control: "text" },
12
+ required: { control: "boolean" },
13
+ tooltip: { control: "text" },
14
+ helperText: { control: "text" },
15
+ errorText: { control: "text" },
16
+ disabled: { control: "boolean" },
17
+ clearable: { control: "boolean" },
18
+ },
19
+ }
20
+
21
+ export default meta
22
+ type Story = StoryObj<typeof ColorPicker>
23
+
24
+ export const Default: Story = {
25
+ args: {
26
+ placeholder: "Select color...",
27
+ defaultValue: "#4f46e5",
28
+ },
29
+ }
30
+
31
+ export const WithLabelAndTooltip: Story = {
32
+ args: {
33
+ label: "Brand Theme Color",
34
+ required: true,
35
+ tooltip: "Choose a primary accent color for your brand dashboard.",
36
+ defaultValue: "#3b82f6",
37
+ helperText: "Supports HEX, RGB, and color presets.",
38
+ },
39
+ }
40
+
41
+ export const States: Story = {
42
+ render: () => (
43
+ <div className="flex flex-col gap-4 max-w-sm">
44
+ <ColorPicker
45
+ label="Empty State"
46
+ placeholder="Choose accent color..."
47
+ />
48
+ <ColorPicker
49
+ label="Selected Color"
50
+ defaultValue="#10b981"
51
+ helperText="Active theme color"
52
+ />
53
+ <ColorPicker
54
+ label="Disabled State"
55
+ defaultValue="#6366f1"
56
+ disabled
57
+ />
58
+ <ColorPicker
59
+ label="Error State"
60
+ defaultValue="#ef4444"
61
+ errorText="Invalid color selection"
62
+ />
63
+ </div>
64
+ ),
65
+ }