@brightlocal/ui-components 0.1.2 → 0.1.3

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 (236) hide show
  1. package/dist/accordion.cjs +1 -1
  2. package/dist/accordion.d.ts +74 -4
  3. package/dist/accordion.d.ts.map +1 -1
  4. package/dist/accordion.js +100 -105
  5. package/dist/alert-dialog.cjs +1 -1
  6. package/dist/alert-dialog.d.ts +30 -10
  7. package/dist/alert-dialog.d.ts.map +1 -1
  8. package/dist/alert-dialog.js +129 -132
  9. package/dist/alert.d.ts +22 -1
  10. package/dist/alert.d.ts.map +1 -1
  11. package/dist/aspect-ratio.cjs +1 -1
  12. package/dist/aspect-ratio.d.ts +11 -1
  13. package/dist/aspect-ratio.d.ts.map +1 -1
  14. package/dist/aspect-ratio.js +16 -20
  15. package/dist/avatar.cjs +1 -1
  16. package/dist/avatar.d.ts +43 -3
  17. package/dist/avatar.d.ts.map +1 -1
  18. package/dist/avatar.js +18 -16
  19. package/dist/badge.cjs +1 -1
  20. package/dist/badge.d.ts +24 -9
  21. package/dist/badge.d.ts.map +1 -1
  22. package/dist/badge.js +34 -32
  23. package/dist/blocks/data-table.cjs +1 -1
  24. package/dist/blocks/data-table.d.ts.map +1 -1
  25. package/dist/blocks/data-table.js +177 -170
  26. package/dist/blocks/sidebar.cjs +1 -1
  27. package/dist/blocks/sidebar.d.ts +1 -1
  28. package/dist/blocks/sidebar.d.ts.map +1 -1
  29. package/dist/blocks/sidebar.js +154 -154
  30. package/dist/breadcrumb.cjs +1 -1
  31. package/dist/breadcrumb.d.ts +63 -8
  32. package/dist/breadcrumb.d.ts.map +1 -1
  33. package/dist/breadcrumb.js +97 -93
  34. package/dist/button.cjs +1 -1
  35. package/dist/button.d.ts +17 -45
  36. package/dist/button.d.ts.map +1 -1
  37. package/dist/button.js +49 -50
  38. package/dist/calendar.cjs +1 -1
  39. package/dist/calendar.d.ts +12 -0
  40. package/dist/calendar.d.ts.map +1 -1
  41. package/dist/calendar.js +10 -8
  42. package/dist/card.cjs +1 -1
  43. package/dist/card.d.ts +58 -18
  44. package/dist/card.d.ts.map +1 -1
  45. package/dist/card.js +60 -51
  46. package/dist/carousel.cjs +1 -1
  47. package/dist/carousel.d.ts +99 -9
  48. package/dist/carousel.d.ts.map +1 -1
  49. package/dist/carousel.js +142 -128
  50. package/dist/centred-layout.cjs +1 -1
  51. package/dist/centred-layout.d.ts +18 -2
  52. package/dist/centred-layout.d.ts.map +1 -1
  53. package/dist/centred-layout.js +46 -33
  54. package/dist/chart.cjs +4 -4
  55. package/dist/chart.d.ts +70 -7
  56. package/dist/chart.d.ts.map +1 -1
  57. package/dist/chart.js +71 -66
  58. package/dist/checkbox.cjs +1 -1
  59. package/dist/checkbox.d.ts +9 -5
  60. package/dist/checkbox.d.ts.map +1 -1
  61. package/dist/checkbox.js +61 -82
  62. package/dist/collapsible.cjs +1 -1
  63. package/dist/collapsible.d.ts +65 -8
  64. package/dist/collapsible.d.ts.map +1 -1
  65. package/dist/collapsible.js +41 -55
  66. package/dist/combobox.cjs +1 -1
  67. package/dist/combobox.d.ts +29 -11
  68. package/dist/combobox.d.ts.map +1 -1
  69. package/dist/combobox.js +193 -159
  70. package/dist/command.cjs +1 -1
  71. package/dist/command.d.ts +115 -9
  72. package/dist/command.d.ts.map +1 -1
  73. package/dist/command.js +176 -152
  74. package/dist/context-menu.cjs +1 -1
  75. package/dist/context-menu.d.ts +188 -20
  76. package/dist/context-menu.d.ts.map +1 -1
  77. package/dist/context-menu.js +119 -121
  78. package/dist/date-picker.cjs +1 -1
  79. package/dist/date-picker.d.ts +75 -9
  80. package/dist/date-picker.d.ts.map +1 -1
  81. package/dist/date-picker.js +220 -81
  82. package/dist/description.cjs +1 -0
  83. package/dist/description.d.ts +37 -0
  84. package/dist/description.d.ts.map +1 -0
  85. package/dist/description.js +25 -0
  86. package/dist/dialog.cjs +1 -1
  87. package/dist/dialog.d.ts +73 -9
  88. package/dist/dialog.d.ts.map +1 -1
  89. package/dist/dialog.js +103 -112
  90. package/dist/drawer.cjs +1 -1
  91. package/dist/drawer.d.ts +92 -0
  92. package/dist/drawer.d.ts.map +1 -1
  93. package/dist/drawer.js +67 -52
  94. package/dist/dropdown-menu.cjs +1 -1
  95. package/dist/dropdown-menu.d.ts +95 -11
  96. package/dist/dropdown-menu.d.ts.map +1 -1
  97. package/dist/dropdown-menu.js +146 -106
  98. package/dist/field.cjs +1 -1
  99. package/dist/field.d.ts +23 -6
  100. package/dist/field.d.ts.map +1 -1
  101. package/dist/field.js +54 -53
  102. package/dist/global-layout.cjs +1 -1
  103. package/dist/global-layout.d.ts +27 -17
  104. package/dist/global-layout.d.ts.map +1 -1
  105. package/dist/global-layout.js +86 -79
  106. package/dist/hover-card.cjs +1 -1
  107. package/dist/hover-card.d.ts +36 -6
  108. package/dist/hover-card.d.ts.map +1 -1
  109. package/dist/hover-card.js +44 -42
  110. package/dist/index.cjs +1 -1
  111. package/dist/index.d.ts +1 -1
  112. package/dist/index.d.ts.map +1 -1
  113. package/dist/index.js +383 -387
  114. package/dist/input-group.cjs +1 -1
  115. package/dist/input-group.d.ts +21 -2
  116. package/dist/input-group.d.ts.map +1 -1
  117. package/dist/input-group.js +51 -41
  118. package/dist/input-password.cjs +1 -1
  119. package/dist/input-password.d.ts.map +1 -1
  120. package/dist/input-password.js +24 -25
  121. package/dist/input.cjs +1 -1
  122. package/dist/input.d.ts +38 -24
  123. package/dist/input.d.ts.map +1 -1
  124. package/dist/input.js +68 -136
  125. package/dist/label.cjs +1 -1
  126. package/dist/label.d.ts +20 -1
  127. package/dist/label.d.ts.map +1 -1
  128. package/dist/label.js +31 -18
  129. package/dist/logo.cjs +1 -1
  130. package/dist/logo.d.ts +3 -0
  131. package/dist/logo.d.ts.map +1 -1
  132. package/dist/logo.js +12 -10
  133. package/dist/menubar.cjs +1 -1
  134. package/dist/menubar.d.ts +40 -6
  135. package/dist/menubar.d.ts.map +1 -1
  136. package/dist/menubar.js +97 -76
  137. package/dist/popover.cjs +1 -1
  138. package/dist/popover.d.ts +59 -4
  139. package/dist/popover.d.ts.map +1 -1
  140. package/dist/popover.js +42 -34
  141. package/dist/progress.cjs +1 -1
  142. package/dist/progress.d.ts +9 -2
  143. package/dist/progress.d.ts.map +1 -1
  144. package/dist/progress.js +71 -59
  145. package/dist/radio-group.d.ts +40 -0
  146. package/dist/radio-group.d.ts.map +1 -1
  147. package/dist/rating.d.ts +4 -0
  148. package/dist/rating.d.ts.map +1 -1
  149. package/dist/resizable.cjs +1 -1
  150. package/dist/resizable.d.ts +65 -4
  151. package/dist/resizable.d.ts.map +1 -1
  152. package/dist/resizable.js +53 -36
  153. package/dist/scroll-area.cjs +1 -1
  154. package/dist/scroll-area.d.ts +46 -5
  155. package/dist/scroll-area.d.ts.map +1 -1
  156. package/dist/scroll-area.js +42 -38
  157. package/dist/select.cjs +1 -1
  158. package/dist/select.d.ts +30 -0
  159. package/dist/select.d.ts.map +1 -1
  160. package/dist/select.js +64 -54
  161. package/dist/separator.cjs +1 -1
  162. package/dist/separator.d.ts +49 -2
  163. package/dist/separator.d.ts.map +1 -1
  164. package/dist/separator.js +48 -36
  165. package/dist/sheet.cjs +1 -1
  166. package/dist/sheet.d.ts +80 -9
  167. package/dist/sheet.d.ts.map +1 -1
  168. package/dist/sheet.js +117 -113
  169. package/dist/skeleton.cjs +1 -1
  170. package/dist/skeleton.d.ts +24 -2
  171. package/dist/skeleton.d.ts.map +1 -1
  172. package/dist/skeleton.js +15 -9
  173. package/dist/slider.cjs +1 -1
  174. package/dist/slider.d.ts +18 -4
  175. package/dist/slider.d.ts.map +1 -1
  176. package/dist/slider.js +72 -66
  177. package/dist/sonner.cjs +1 -1
  178. package/dist/sonner.d.ts +4 -2
  179. package/dist/sonner.d.ts.map +1 -1
  180. package/dist/sonner.js +29 -28
  181. package/dist/split-layout.d.ts +4 -1
  182. package/dist/split-layout.d.ts.map +1 -1
  183. package/package.json +8 -2
  184. package/src/blocks/data-table.tsx +42 -32
  185. package/src/blocks/sidebar.tsx +4 -12
  186. package/src/components/accordion.tsx +163 -77
  187. package/src/components/alert-dialog.tsx +156 -111
  188. package/src/components/alert.tsx +26 -13
  189. package/src/components/aspect-ratio.tsx +25 -16
  190. package/src/components/avatar.tsx +56 -8
  191. package/src/components/badge.tsx +65 -42
  192. package/src/components/breadcrumb.tsx +158 -82
  193. package/src/components/button.tsx +41 -62
  194. package/src/components/calendar.tsx +16 -2
  195. package/src/components/card.tsx +92 -40
  196. package/src/components/carousel.tsx +240 -115
  197. package/src/components/centred-layout.tsx +67 -35
  198. package/src/components/chart.tsx +118 -47
  199. package/src/components/checkbox.tsx +42 -78
  200. package/src/components/collapsible.tsx +95 -26
  201. package/src/components/combobox.tsx +242 -144
  202. package/src/components/command.tsx +295 -121
  203. package/src/components/context-menu.tsx +278 -81
  204. package/src/components/date-picker.tsx +281 -30
  205. package/src/components/description.tsx +60 -0
  206. package/src/components/dialog.tsx +162 -86
  207. package/src/components/drawer.tsx +76 -2
  208. package/src/components/dropdown-menu.tsx +143 -37
  209. package/src/components/field.tsx +36 -11
  210. package/src/components/global-layout.tsx +116 -77
  211. package/src/components/hover-card.tsx +54 -14
  212. package/src/components/input-group.tsx +56 -18
  213. package/src/components/input-password.tsx +3 -4
  214. package/src/components/input.tsx +93 -186
  215. package/src/components/label.tsx +56 -15
  216. package/src/components/logo.tsx +3 -0
  217. package/src/components/menubar.tsx +58 -4
  218. package/src/components/popover.tsx +103 -20
  219. package/src/components/progress.tsx +82 -60
  220. package/src/components/radio-group.tsx +40 -0
  221. package/src/components/rating.tsx +4 -0
  222. package/src/components/resizable.tsx +119 -31
  223. package/src/components/scroll-area.tsx +123 -56
  224. package/src/components/select.tsx +21 -1
  225. package/src/components/separator.tsx +97 -20
  226. package/src/components/sheet.tsx +180 -79
  227. package/src/components/skeleton.tsx +40 -10
  228. package/src/components/slider.tsx +83 -57
  229. package/src/components/sonner.tsx +10 -7
  230. package/src/components/split-layout.tsx +4 -1
  231. package/src/index.ts +1 -1
  232. package/dist/input-base.cjs +0 -1
  233. package/dist/input-base.d.ts +0 -28
  234. package/dist/input-base.d.ts.map +0 -1
  235. package/dist/input-base.js +0 -56
  236. package/src/components/input-base.tsx +0 -86
@@ -25,12 +25,17 @@ import { cn } from "@brightlocal/ui-components/lib/utils";
25
25
  function Menubar({
26
26
  className,
27
27
  dataHook,
28
+ defaultValue,
28
29
  ...props
29
30
  }: React.ComponentProps<typeof MenubarPrimitive.Root> & {
30
31
  /**
31
32
  * Required data-hook attribute for testing and analytics
32
33
  */
33
34
  dataHook: string;
35
+ /**
36
+ * The value of the menu that should be open when initially rendered (uncontrolled)
37
+ */
38
+ defaultValue?: string;
34
39
  }) {
35
40
  return (
36
41
  <MenubarPrimitive.Root
@@ -42,6 +47,7 @@ function Menubar({
42
47
  data-slot="menubar"
43
48
  data-tracking-el="menubar"
44
49
  data-tracking-label={dataHook}
50
+ defaultValue={defaultValue}
45
51
  {...props}
46
52
  />
47
53
  );
@@ -51,9 +57,17 @@ function Menubar({
51
57
  * MenubarMenu - Individual menu within the menubar
52
58
  */
53
59
  function MenubarMenu({
60
+ value,
54
61
  ...props
55
- }: React.ComponentProps<typeof MenubarPrimitive.Menu>) {
56
- return <MenubarPrimitive.Menu data-slot="menubar-menu" {...props} />;
62
+ }: React.ComponentProps<typeof MenubarPrimitive.Menu> & {
63
+ /**
64
+ * A unique value that associates the menu with the menubar's defaultValue/value
65
+ */
66
+ value?: string;
67
+ }) {
68
+ return (
69
+ <MenubarPrimitive.Menu data-slot="menubar-menu" value={value} {...props} />
70
+ );
57
71
  }
58
72
 
59
73
  /**
@@ -113,9 +127,14 @@ function MenubarContent({
113
127
  */
114
128
  function MenubarItem({
115
129
  className,
130
+ disabled,
116
131
  inset,
117
132
  ...props
118
133
  }: React.ComponentProps<typeof MenubarPrimitive.Item> & {
134
+ /**
135
+ * Whether the menu item is disabled
136
+ */
137
+ disabled?: boolean;
119
138
  /**
120
139
  * Adds left padding for alignment with items that have icons
121
140
  */
@@ -132,6 +151,7 @@ function MenubarItem({
132
151
  className
133
152
  )}
134
153
  data-slot="menubar-item"
154
+ disabled={disabled}
135
155
  {...props}
136
156
  />
137
157
  );
@@ -141,20 +161,31 @@ function MenubarItem({
141
161
  * MenubarCheckboxItem - Menu item with checkbox
142
162
  */
143
163
  function MenubarCheckboxItem({
164
+ checked,
144
165
  children,
145
166
  className,
146
167
  closeOnSelect = true,
168
+ onCheckedChange,
147
169
  onSelect,
148
170
  ...props
149
171
  }: React.ComponentProps<typeof MenubarPrimitive.CheckboxItem> & {
172
+ /**
173
+ * The controlled checked state of the checkbox
174
+ */
175
+ checked?: boolean;
150
176
  /**
151
177
  * Whether to close the menu when the item is selected
152
178
  * @default true
153
179
  */
154
180
  closeOnSelect?: boolean;
181
+ /**
182
+ * Callback fired when the checked state changes
183
+ */
184
+ onCheckedChange?: (checked: boolean) => void;
155
185
  }) {
156
186
  return (
157
187
  <MenubarPrimitive.CheckboxItem
188
+ checked={checked}
158
189
  className={cn(
159
190
  "text-foreground relative flex cursor-pointer items-center justify-between rounded-sm py-1.5 pr-2 pl-8 text-sm font-normal transition-colors outline-none",
160
191
  "hover:bg-accent hover:text-foreground",
@@ -163,6 +194,7 @@ function MenubarCheckboxItem({
163
194
  className
164
195
  )}
165
196
  data-slot="menubar-checkbox-item"
197
+ onCheckedChange={onCheckedChange}
166
198
  onSelect={(event) => {
167
199
  if (!closeOnSelect) {
168
200
  event.preventDefault();
@@ -185,10 +217,26 @@ function MenubarCheckboxItem({
185
217
  * MenubarRadioGroup - Container for radio menu items
186
218
  */
187
219
  function MenubarRadioGroup({
220
+ onValueChange,
221
+ value,
188
222
  ...props
189
- }: React.ComponentProps<typeof MenubarPrimitive.RadioGroup>) {
223
+ }: React.ComponentProps<typeof MenubarPrimitive.RadioGroup> & {
224
+ /**
225
+ * Callback fired when the selected value changes
226
+ */
227
+ onValueChange?: (value: string) => void;
228
+ /**
229
+ * The controlled value of the selected radio item
230
+ */
231
+ value?: string;
232
+ }) {
190
233
  return (
191
- <MenubarPrimitive.RadioGroup data-slot="menubar-radio-group" {...props} />
234
+ <MenubarPrimitive.RadioGroup
235
+ data-slot="menubar-radio-group"
236
+ value={value}
237
+ onValueChange={onValueChange}
238
+ {...props}
239
+ />
192
240
  );
193
241
  }
194
242
 
@@ -200,6 +248,7 @@ function MenubarRadioItem({
200
248
  className,
201
249
  closeOnSelect = true,
202
250
  onSelect,
251
+ value,
203
252
  ...props
204
253
  }: React.ComponentProps<typeof MenubarPrimitive.RadioItem> & {
205
254
  /**
@@ -207,6 +256,10 @@ function MenubarRadioItem({
207
256
  * @default true
208
257
  */
209
258
  closeOnSelect?: boolean;
259
+ /**
260
+ * The unique value of the radio item
261
+ */
262
+ value: string;
210
263
  }) {
211
264
  return (
212
265
  <MenubarPrimitive.RadioItem
@@ -218,6 +271,7 @@ function MenubarRadioItem({
218
271
  className
219
272
  )}
220
273
  data-slot="menubar-radio-item"
274
+ value={value}
221
275
  onSelect={(event) => {
222
276
  if (!closeOnSelect) {
223
277
  event.preventDefault();
@@ -1,46 +1,129 @@
1
+ "use client";
2
+
1
3
  import * as React from "react";
2
4
  import * as PopoverPrimitive from "@radix-ui/react-popover";
3
5
 
4
6
  import { cn } from "@brightlocal/ui-components/lib/utils";
5
7
 
6
- function Popover({
7
- ...props
8
- }: React.ComponentProps<typeof PopoverPrimitive.Root>) {
8
+ export interface PopoverProps extends React.ComponentProps<
9
+ typeof PopoverPrimitive.Root
10
+ > {
11
+ /** The open state when initially rendered. Use when you do not need to control the open state. */
12
+ defaultOpen?: boolean;
13
+ /** The controlled open state of the popover. */
14
+ open?: boolean;
15
+ /** Event handler called when the open state of the popover changes. */
16
+ onOpenChange?: (open: boolean) => void;
17
+ /** When true, interaction with outside elements is disabled and only popover content is visible to screen readers. */
18
+ modal?: boolean;
19
+ }
20
+
21
+ /**
22
+ * Contains all the parts of a popover.
23
+ */
24
+ function Popover({ ...props }: PopoverProps) {
9
25
  return <PopoverPrimitive.Root data-slot="popover" {...props} />;
10
26
  }
27
+ Popover.displayName = "Popover";
28
+
29
+ export interface PopoverTriggerProps extends React.ComponentProps<
30
+ typeof PopoverPrimitive.Trigger
31
+ > {
32
+ /** Change the default rendered element for the one passed as a child, merging their props and behavior. */
33
+ asChild?: boolean;
34
+ /** Test hook identifier for testing purposes. */
35
+ dataHook?: string;
36
+ }
37
+
38
+ /**
39
+ * The button that toggles the popover.
40
+ */
41
+ const PopoverTrigger = React.forwardRef<
42
+ React.ComponentRef<typeof PopoverPrimitive.Trigger>,
43
+ PopoverTriggerProps
44
+ >(({ dataHook, ...props }, ref) => (
45
+ <PopoverPrimitive.Trigger
46
+ ref={ref}
47
+ data-hook={dataHook}
48
+ data-slot="popover-trigger"
49
+ {...props}
50
+ />
51
+ ));
52
+ PopoverTrigger.displayName = "PopoverTrigger";
11
53
 
12
- function PopoverTrigger({
13
- ...props
14
- }: React.ComponentProps<typeof PopoverPrimitive.Trigger>) {
15
- return <PopoverPrimitive.Trigger data-slot="popover-trigger" {...props} />;
54
+ export interface PopoverContentProps extends React.ComponentProps<
55
+ typeof PopoverPrimitive.Content
56
+ > {
57
+ /** Test hook identifier for testing purposes. */
58
+ dataHook?: string;
59
+ /** The preferred side of the anchor to render against. Will be reversed when collisions occur. */
60
+ side?: "top" | "right" | "bottom" | "left";
61
+ /** The distance in pixels from the anchor. */
62
+ sideOffset?: number;
63
+ /** The preferred alignment against the anchor. May change when collisions occur. */
64
+ align?: "start" | "center" | "end";
65
+ /** An offset in pixels from the "start" or "end" alignment options. */
66
+ alignOffset?: number;
67
+ /** When true, overrides side and align to prevent collisions with boundary edges. */
68
+ avoidCollisions?: boolean;
69
+ /** The sticky behavior on the align axis. "partial" keeps content in boundary as long as trigger is at least partially in boundary. */
70
+ sticky?: "partial" | "always";
71
+ /** Whether to hide content when the trigger becomes fully occluded. */
72
+ hideWhenDetached?: boolean;
16
73
  }
17
74
 
18
- function PopoverContent({
19
- className,
20
- align = "center",
21
- sideOffset = 4,
22
- ...props
23
- }: React.ComponentProps<typeof PopoverPrimitive.Content>) {
24
- return (
75
+ /**
76
+ * The component that pops out when the popover is open.
77
+ */
78
+ const PopoverContent = React.forwardRef<
79
+ React.ComponentRef<typeof PopoverPrimitive.Content>,
80
+ PopoverContentProps
81
+ >(
82
+ (
83
+ { className, align = "center", sideOffset = 4, dataHook, ...props },
84
+ ref
85
+ ) => (
25
86
  <PopoverPrimitive.Portal>
26
87
  <PopoverPrimitive.Content
88
+ ref={ref}
27
89
  align={align}
28
90
  className={cn(
29
91
  "bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-72 origin-(--radix-popover-content-transform-origin) rounded-md border p-4 shadow-md outline-hidden",
30
92
  className
31
93
  )}
94
+ data-hook={dataHook}
32
95
  data-slot="popover-content"
33
96
  sideOffset={sideOffset}
34
97
  {...props}
35
98
  />
36
99
  </PopoverPrimitive.Portal>
37
- );
38
- }
100
+ )
101
+ );
102
+ PopoverContent.displayName = "PopoverContent";
39
103
 
40
- function PopoverAnchor({
41
- ...props
42
- }: React.ComponentProps<typeof PopoverPrimitive.Anchor>) {
43
- return <PopoverPrimitive.Anchor data-slot="popover-anchor" {...props} />;
104
+ export interface PopoverAnchorProps extends React.ComponentProps<
105
+ typeof PopoverPrimitive.Anchor
106
+ > {
107
+ /** Change the default rendered element for the one passed as a child, merging their props and behavior. */
108
+ asChild?: boolean;
109
+ /** Test hook identifier for testing purposes. */
110
+ dataHook?: string;
44
111
  }
45
112
 
113
+ /**
114
+ * An optional element to position the popover against. If not used, the popover will position against the trigger.
115
+ */
116
+ const PopoverAnchor = React.forwardRef<
117
+ React.ComponentRef<typeof PopoverPrimitive.Anchor>,
118
+ PopoverAnchorProps
119
+ >(({ dataHook, ...props }, ref) => (
120
+ <PopoverPrimitive.Anchor
121
+ ref={ref}
122
+ data-hook={dataHook}
123
+ data-slot="popover-anchor"
124
+ {...props}
125
+ />
126
+ ));
127
+ PopoverAnchor.displayName = "PopoverAnchor";
128
+
46
129
  export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor };
@@ -6,6 +6,9 @@ import { motion } from "framer-motion";
6
6
 
7
7
  import { cn } from "@brightlocal/ui-components/lib/utils";
8
8
 
9
+ /**
10
+ * Props for the Progress component.
11
+ */
9
12
  interface ProgressProps extends React.ComponentProps<
10
13
  typeof ProgressPrimitive.Root
11
14
  > {
@@ -23,7 +26,7 @@ interface ProgressProps extends React.ComponentProps<
23
26
  trackingLabel?: string;
24
27
  /**
25
28
  * Accessible label for the progress bar for screen readers
26
- * Defaults to "Progress" if not provided
29
+ * @default "Progress"
27
30
  */
28
31
  ariaLabel?: string;
29
32
  /**
@@ -32,69 +35,88 @@ interface ProgressProps extends React.ComponentProps<
32
35
  label?: string;
33
36
  }
34
37
 
35
- function Progress({
36
- className,
37
- value,
38
- dataHook,
39
- trackingEl,
40
- trackingLabel,
41
- ariaLabel = "Progress",
42
- label,
43
- ...props
44
- }: ProgressProps) {
45
- const labelId = React.useId();
46
- const hasVisibleLabel = !!label;
38
+ /**
39
+ * Progress component for displaying loading states and task completion.
40
+ * Built on Radix UI Progress primitive with Framer Motion animation.
41
+ */
42
+ const Progress = React.forwardRef<
43
+ React.ComponentRef<typeof ProgressPrimitive.Root>,
44
+ ProgressProps
45
+ >(
46
+ (
47
+ {
48
+ className,
49
+ value,
50
+ dataHook,
51
+ trackingEl,
52
+ trackingLabel,
53
+ ariaLabel = "Progress",
54
+ label,
55
+ ...props
56
+ },
57
+ ref
58
+ ) => {
59
+ const labelId = React.useId();
60
+ const hasVisibleLabel = !!label;
47
61
 
48
- const progressBar = (
49
- <ProgressPrimitive.Root
50
- aria-label={hasVisibleLabel ? undefined : ariaLabel}
51
- aria-labelledby={hasVisibleLabel ? labelId : undefined}
52
- className={cn(
53
- "relative h-2 w-full overflow-hidden rounded-full",
54
- "bg-primary/20",
55
- className
56
- )}
57
- data-hook={dataHook}
58
- data-slot="progress"
59
- data-tracking-el={trackingEl}
60
- data-tracking-label={trackingLabel}
61
- {...props}
62
- >
63
- <ProgressPrimitive.Indicator asChild>
64
- <motion.div
65
- animate={{
66
- transform: `translateX(-${100 - (value || 0)}%)`,
67
- }}
68
- className="h-full w-full flex-1 bg-green-400"
69
- data-slot="progress-indicator"
70
- initial={false}
71
- transition={{
72
- type: "spring",
73
- stiffness: 80,
74
- damping: 20,
75
- mass: 1,
76
- }}
77
- />
78
- </ProgressPrimitive.Indicator>
79
- </ProgressPrimitive.Root>
80
- );
62
+ const progressBar = (
63
+ <ProgressPrimitive.Root
64
+ ref={ref}
65
+ aria-label={hasVisibleLabel ? undefined : ariaLabel}
66
+ aria-labelledby={hasVisibleLabel ? labelId : undefined}
67
+ className={cn(
68
+ "relative h-2 w-full overflow-hidden rounded-full",
69
+ "bg-primary/20",
70
+ className
71
+ )}
72
+ data-hook={dataHook}
73
+ data-slot="progress"
74
+ data-tracking-el={trackingEl}
75
+ data-tracking-label={trackingLabel}
76
+ {...props}
77
+ >
78
+ <ProgressPrimitive.Indicator asChild>
79
+ <motion.div
80
+ animate={{
81
+ transform: `translateX(-${100 - (value || 0)}%)`,
82
+ }}
83
+ className="h-full w-full flex-1 bg-green-400"
84
+ data-slot="progress-indicator"
85
+ initial={false}
86
+ transition={{
87
+ type: "spring",
88
+ stiffness: 80,
89
+ damping: 20,
90
+ mass: 1,
91
+ }}
92
+ />
93
+ </ProgressPrimitive.Indicator>
94
+ </ProgressPrimitive.Root>
95
+ );
81
96
 
82
- if (!label) {
83
- return progressBar;
84
- }
97
+ if (!label) {
98
+ return progressBar;
99
+ }
85
100
 
86
- return (
87
- <div className="flex w-full items-center gap-2">
88
- <span
89
- className="text-foreground text-sm leading-normal font-medium"
90
- id={labelId}
101
+ return (
102
+ <div
103
+ className="flex w-full items-center gap-2"
104
+ data-slot="progress-wrapper"
91
105
  >
92
- {label}
93
- </span>
94
- {progressBar}
95
- </div>
96
- );
97
- }
106
+ <span
107
+ className="text-foreground text-sm leading-normal font-medium"
108
+ data-slot="progress-label"
109
+ id={labelId}
110
+ >
111
+ {label}
112
+ </span>
113
+ {progressBar}
114
+ </div>
115
+ );
116
+ }
117
+ );
118
+
119
+ Progress.displayName = "Progress";
98
120
 
99
121
  export { Progress };
100
122
  export type { ProgressProps };
@@ -118,10 +118,17 @@ const radioContentVariants = cva(
118
118
 
119
119
  /* ---------------------------------- Types --------------------------------- */
120
120
 
121
+ /**
122
+ * Visual style variants for the radio group component.
123
+ */
121
124
  enum RadioGroupVariant {
125
+ /** Standard radio group with minimal styling */
122
126
  DEFAULT = "default",
127
+ /** Radio items wrapped in styled card containers */
123
128
  BOX = "box",
129
+ /** Radio items with icons displayed vertically above the label */
124
130
  BOX_ICON_VERTICAL = "boxIconVertical",
131
+ /** Radio items with icons displayed horizontally to the left */
125
132
  BOX_ICON_HORIZONTAL = "boxIconHorizontal",
126
133
  }
127
134
 
@@ -129,24 +136,57 @@ interface RadioGroupContextValue {
129
136
  variant?: RadioGroupVariant;
130
137
  }
131
138
 
139
+ /**
140
+ * Props for the RadioGroup component.
141
+ */
132
142
  interface RadioGroupProps
133
143
  extends
134
144
  React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root>,
135
145
  VariantProps<typeof radioGroupVariants> {
146
+ /**
147
+ * Data hook for automated testing (required)
148
+ */
136
149
  dataHook: string;
150
+ /**
151
+ * Tracking element identifier for analytics
152
+ */
137
153
  trackingEl?: string;
154
+ /**
155
+ * Tracking label for analytics context
156
+ */
138
157
  trackingLabel?: string;
139
158
  }
140
159
 
160
+ /**
161
+ * Props for the RadioGroupItem component.
162
+ */
141
163
  interface RadioGroupItemProps
142
164
  extends
143
165
  React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item>,
144
166
  VariantProps<typeof radioGroupItemVariants> {
167
+ /**
168
+ * Label text displayed next to the radio button
169
+ */
145
170
  label?: React.ReactNode;
171
+ /**
172
+ * Description text displayed below the label
173
+ */
146
174
  description?: React.ReactNode;
175
+ /**
176
+ * Icon displayed for box icon variants
177
+ */
147
178
  icon?: React.ReactNode;
179
+ /**
180
+ * Data hook for automated testing (required)
181
+ */
148
182
  dataHook: string;
183
+ /**
184
+ * Tracking element identifier for analytics
185
+ */
149
186
  trackingEl?: string;
187
+ /**
188
+ * Tracking label for analytics context
189
+ */
150
190
  trackingLabel?: string;
151
191
  }
152
192
 
@@ -3,6 +3,10 @@ import { StarRating } from "@brightlocal/icons";
3
3
 
4
4
  import { cn } from "@brightlocal/ui-components/lib/utils";
5
5
 
6
+ /**
7
+ * Rating component displays a star-based rating indicator.
8
+ * Supports full and half-star values for precise rating display.
9
+ */
6
10
  export interface RatingProps extends React.HTMLAttributes<HTMLDivElement> {
7
11
  /**
8
12
  * The rating value (0-5, supports 0.5 increments)