@brightlocal/ui-components 2.27.0 → 3.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 (259) hide show
  1. package/README.md +6 -1
  2. package/component-meta.json +480 -126
  3. package/deprecations.json +189 -2
  4. package/dist/accordion.cjs +1 -1
  5. package/dist/accordion.js +2 -2
  6. package/dist/alert-dialog.cjs +1 -1
  7. package/dist/alert-dialog.js +18 -18
  8. package/dist/alert.cjs +1 -1
  9. package/dist/alert.d.ts +11 -1
  10. package/dist/alert.d.ts.map +1 -1
  11. package/dist/alert.js +31 -28
  12. package/dist/avatar.cjs +1 -1
  13. package/dist/avatar.js +4 -4
  14. package/dist/badge.cjs +1 -1
  15. package/dist/badge.d.ts.map +1 -1
  16. package/dist/badge.js +15 -11
  17. package/dist/blocks/empty-state.cjs +1 -0
  18. package/dist/blocks/empty-state.d.ts +172 -0
  19. package/dist/blocks/empty-state.d.ts.map +1 -0
  20. package/dist/blocks/empty-state.js +155 -0
  21. package/dist/blocks/input-list.cjs +2 -2
  22. package/dist/blocks/input-list.d.ts.map +1 -1
  23. package/dist/blocks/input-list.js +124 -108
  24. package/dist/blocks/progress-state.cjs +1 -0
  25. package/dist/blocks/{progress-screen.d.ts → progress-state.d.ts} +30 -18
  26. package/dist/blocks/progress-state.d.ts.map +1 -0
  27. package/dist/blocks/{progress-screen.js → progress-state.js} +100 -71
  28. package/dist/blocks/sidebar.cjs +1 -1
  29. package/dist/blocks/sidebar.d.ts.map +1 -1
  30. package/dist/blocks/sidebar.js +160 -161
  31. package/dist/breadcrumb.cjs +1 -1
  32. package/dist/breadcrumb.js +1 -1
  33. package/dist/button.cjs +1 -1
  34. package/dist/button.js +11 -11
  35. package/dist/calendar.cjs +1 -1
  36. package/dist/calendar.d.ts.map +1 -1
  37. package/dist/calendar.js +37 -38
  38. package/dist/callout.cjs +1 -1
  39. package/dist/callout.d.ts +24 -2
  40. package/dist/callout.d.ts.map +1 -1
  41. package/dist/callout.js +57 -55
  42. package/dist/card.cjs +1 -1
  43. package/dist/card.d.ts +23 -2
  44. package/dist/card.d.ts.map +1 -1
  45. package/dist/card.js +94 -91
  46. package/dist/chart-empty.cjs +1 -0
  47. package/dist/chart-empty.d.ts +59 -0
  48. package/dist/chart-empty.d.ts.map +1 -0
  49. package/dist/chart-empty.js +29 -0
  50. package/dist/chart.cjs +6 -6
  51. package/dist/chart.d.ts +6 -1
  52. package/dist/chart.d.ts.map +1 -1
  53. package/dist/chart.js +183 -183
  54. package/dist/chip.cjs +1 -1
  55. package/dist/chip.d.ts.map +1 -1
  56. package/dist/chip.js +5 -3
  57. package/dist/combobox.cjs +2 -2
  58. package/dist/combobox.d.ts.map +1 -1
  59. package/dist/combobox.js +81 -79
  60. package/dist/command.cjs +1 -1
  61. package/dist/command.d.ts.map +1 -1
  62. package/dist/command.js +74 -77
  63. package/dist/context-menu.cjs +1 -1
  64. package/dist/context-menu.d.ts.map +1 -1
  65. package/dist/context-menu.js +26 -29
  66. package/dist/data-table.cjs +1 -1
  67. package/dist/data-table.d.ts +44 -10
  68. package/dist/data-table.d.ts.map +1 -1
  69. package/dist/data-table.js +13 -11
  70. package/dist/description.cjs +1 -1
  71. package/dist/description.js +5 -5
  72. package/dist/dialog.cjs +1 -1
  73. package/dist/dialog.js +20 -20
  74. package/dist/drawer.cjs +1 -1
  75. package/dist/drawer.d.ts.map +1 -1
  76. package/dist/drawer.js +8 -11
  77. package/dist/dropdown-menu.cjs +1 -1
  78. package/dist/dropdown-menu.d.ts.map +1 -1
  79. package/dist/dropdown-menu.js +17 -20
  80. package/dist/field.cjs +1 -1
  81. package/dist/field.d.ts.map +1 -1
  82. package/dist/field.js +29 -25
  83. package/dist/global-layout.cjs +1 -1
  84. package/dist/global-layout.d.ts +27 -1
  85. package/dist/global-layout.d.ts.map +1 -1
  86. package/dist/global-layout.js +18 -16
  87. package/dist/grid.cjs +1 -0
  88. package/dist/grid.d.ts +56 -0
  89. package/dist/grid.d.ts.map +1 -0
  90. package/dist/grid.js +32 -0
  91. package/dist/header.d.ts +13 -0
  92. package/dist/header.d.ts.map +1 -1
  93. package/dist/hooks/use-delayed-pending.cjs +1 -0
  94. package/dist/hooks/use-delayed-pending.d.ts +34 -0
  95. package/dist/hooks/use-delayed-pending.d.ts.map +1 -0
  96. package/dist/hooks/use-delayed-pending.js +17 -0
  97. package/dist/hover-card.cjs +1 -1
  98. package/dist/hover-card.js +13 -13
  99. package/dist/index.cjs +1 -1
  100. package/dist/index.d.ts +8 -1
  101. package/dist/index.d.ts.map +1 -1
  102. package/dist/index.js +512 -494
  103. package/dist/input-chip.cjs +1 -1
  104. package/dist/input-chip.js +25 -25
  105. package/dist/input-group.cjs +1 -1
  106. package/dist/input-group.js +9 -9
  107. package/dist/input-otp.cjs +1 -1
  108. package/dist/input-otp.js +9 -9
  109. package/dist/input-password.cjs +1 -1
  110. package/dist/input-password.js +51 -51
  111. package/dist/input.cjs +1 -1
  112. package/dist/input.js +9 -9
  113. package/dist/label.cjs +1 -1
  114. package/dist/label.d.ts.map +1 -1
  115. package/dist/label.js +25 -28
  116. package/dist/lib/block-illustration.cjs +1 -0
  117. package/dist/lib/block-illustration.d.ts +28 -0
  118. package/dist/lib/block-illustration.d.ts.map +1 -0
  119. package/dist/lib/block-illustration.js +21 -0
  120. package/dist/lib/empty-canvas.cjs +1 -0
  121. package/dist/lib/empty-canvas.d.ts +27 -0
  122. package/dist/lib/empty-canvas.d.ts.map +1 -0
  123. package/dist/lib/empty-canvas.js +62 -0
  124. package/dist/lib/optical-center.cjs +1 -0
  125. package/dist/lib/optical-center.d.ts +12 -0
  126. package/dist/lib/optical-center.d.ts.map +1 -0
  127. package/dist/lib/optical-center.js +11 -0
  128. package/dist/lib/utils.cjs +1 -1
  129. package/dist/lib/utils.d.ts.map +1 -1
  130. package/dist/lib/utils.js +28 -5
  131. package/dist/list.cjs +1 -1
  132. package/dist/list.d.ts.map +1 -1
  133. package/dist/list.js +62 -58
  134. package/dist/map.cjs +1 -1
  135. package/dist/map.d.ts +60 -2
  136. package/dist/map.d.ts.map +1 -1
  137. package/dist/map.js +187 -164
  138. package/dist/media-empty.cjs +1 -0
  139. package/dist/media-empty.d.ts +72 -0
  140. package/dist/media-empty.d.ts.map +1 -0
  141. package/dist/media-empty.js +45 -0
  142. package/dist/menubar.cjs +1 -1
  143. package/dist/menubar.d.ts.map +1 -1
  144. package/dist/menubar.js +17 -20
  145. package/dist/navigation-menu.cjs +1 -1
  146. package/dist/navigation-menu.js +7 -7
  147. package/dist/pagination.cjs +1 -1
  148. package/dist/pagination.d.ts +127 -1
  149. package/dist/pagination.d.ts.map +1 -1
  150. package/dist/pagination.js +189 -98
  151. package/dist/progress.cjs +1 -1
  152. package/dist/progress.d.ts +2 -26
  153. package/dist/progress.d.ts.map +1 -1
  154. package/dist/progress.js +79 -118
  155. package/dist/select.cjs +2 -2
  156. package/dist/select.d.ts.map +1 -1
  157. package/dist/select.js +19 -18
  158. package/dist/separator.cjs +1 -1
  159. package/dist/separator.js +8 -8
  160. package/dist/sheet.cjs +1 -1
  161. package/dist/sheet.js +2 -2
  162. package/dist/skeleton.cjs +1 -1
  163. package/dist/skeleton.d.ts +38 -3
  164. package/dist/skeleton.d.ts.map +1 -1
  165. package/dist/skeleton.js +43 -20
  166. package/dist/sonner.cjs +1 -1
  167. package/dist/sonner.js +26 -26
  168. package/dist/stepper.cjs +1 -1
  169. package/dist/stepper.js +40 -40
  170. package/dist/table.cjs +1 -1
  171. package/dist/table.d.ts.map +1 -1
  172. package/dist/table.js +31 -28
  173. package/dist/tabs.cjs +1 -1
  174. package/dist/tabs.js +1 -1
  175. package/dist/text-reveal-motion.d.ts +10 -0
  176. package/dist/text-reveal-motion.d.ts.map +1 -1
  177. package/dist/textarea.cjs +1 -1
  178. package/dist/textarea.js +11 -11
  179. package/dist/toggle.cjs +1 -1
  180. package/dist/toggle.js +8 -8
  181. package/dist/tooltip.cjs +1 -1
  182. package/dist/tooltip.js +8 -8
  183. package/dist/typography-heading.cjs +1 -0
  184. package/dist/typography-heading.d.ts +116 -0
  185. package/dist/typography-heading.d.ts.map +1 -0
  186. package/dist/typography-heading.js +84 -0
  187. package/dist/typography-text.cjs +1 -0
  188. package/dist/typography-text.d.ts +113 -0
  189. package/dist/typography-text.d.ts.map +1 -0
  190. package/dist/typography-text.js +81 -0
  191. package/dist/typography.d.ts +13 -0
  192. package/dist/typography.d.ts.map +1 -1
  193. package/package.json +35 -7
  194. package/src/blocks/empty-state.tsx +424 -0
  195. package/src/blocks/input-list.tsx +66 -36
  196. package/src/blocks/{progress-screen.tsx → progress-state.tsx} +154 -93
  197. package/src/blocks/sidebar.tsx +25 -26
  198. package/src/components/accordion.tsx +2 -2
  199. package/src/components/alert-dialog.tsx +2 -2
  200. package/src/components/alert.tsx +27 -13
  201. package/src/components/avatar.tsx +1 -1
  202. package/src/components/badge.tsx +8 -4
  203. package/src/components/breadcrumb.tsx +1 -1
  204. package/src/components/button.tsx +3 -3
  205. package/src/components/calendar.tsx +5 -6
  206. package/src/components/callout.tsx +48 -15
  207. package/src/components/card.tsx +52 -17
  208. package/src/components/chart-empty.tsx +116 -0
  209. package/src/components/chart.tsx +43 -17
  210. package/src/components/chip.tsx +5 -3
  211. package/src/components/combobox.tsx +12 -10
  212. package/src/components/command.tsx +9 -10
  213. package/src/components/context-menu.tsx +6 -9
  214. package/src/components/data-table.tsx +72 -17
  215. package/src/components/description.tsx +1 -1
  216. package/src/components/dialog.tsx +2 -2
  217. package/src/components/drawer.tsx +2 -5
  218. package/src/components/dropdown-menu.tsx +8 -11
  219. package/src/components/field.tsx +8 -4
  220. package/src/components/global-layout.tsx +36 -3
  221. package/src/components/grid.tsx +130 -0
  222. package/src/components/header.tsx +13 -0
  223. package/src/components/hover-card.tsx +1 -1
  224. package/src/components/input-chip.tsx +1 -1
  225. package/src/components/input-group.tsx +1 -1
  226. package/src/components/input-otp.tsx +1 -1
  227. package/src/components/input-password.tsx +1 -1
  228. package/src/components/input.tsx +1 -1
  229. package/src/components/label.tsx +10 -13
  230. package/src/components/list.tsx +13 -9
  231. package/src/components/map.tsx +101 -5
  232. package/src/components/media-empty.tsx +156 -0
  233. package/src/components/menubar.tsx +7 -10
  234. package/src/components/navigation-menu.tsx +1 -1
  235. package/src/components/pagination.tsx +279 -1
  236. package/src/components/progress.tsx +35 -113
  237. package/src/components/select.tsx +5 -4
  238. package/src/components/separator.tsx +1 -1
  239. package/src/components/sheet.tsx +2 -2
  240. package/src/components/skeleton.tsx +78 -7
  241. package/src/components/sonner.tsx +2 -2
  242. package/src/components/stepper.tsx +3 -3
  243. package/src/components/table.tsx +6 -3
  244. package/src/components/tabs.tsx +1 -1
  245. package/src/components/text-reveal-motion.tsx +10 -0
  246. package/src/components/textarea.tsx +1 -1
  247. package/src/components/toggle.tsx +1 -1
  248. package/src/components/tooltip.tsx +1 -1
  249. package/src/components/typography-heading.tsx +229 -0
  250. package/src/components/typography-text.tsx +225 -0
  251. package/src/components/typography.tsx +13 -0
  252. package/src/hooks/use-delayed-pending.ts +60 -0
  253. package/src/index.ts +10 -1
  254. package/src/lib/block-illustration.tsx +88 -0
  255. package/src/lib/empty-canvas.tsx +128 -0
  256. package/src/lib/optical-center.tsx +45 -0
  257. package/src/lib/utils.ts +26 -0
  258. package/dist/blocks/progress-screen.cjs +0 -1
  259. package/dist/blocks/progress-screen.d.ts.map +0 -1
@@ -249,7 +249,7 @@ const CommandInput = React.forwardRef<
249
249
  <CommandPrimitive.Input
250
250
  ref={inputRef}
251
251
  className={cn(
252
- "placeholder:text-muted-foreground flex w-full bg-transparent text-base outline-hidden disabled:cursor-not-allowed disabled:opacity-50",
252
+ "placeholder:text-muted-foreground text-body flex w-full bg-transparent outline-hidden disabled:cursor-not-allowed disabled:opacity-50",
253
253
  className
254
254
  )}
255
255
  data-slot="command-input"
@@ -262,7 +262,9 @@ const CommandInput = React.forwardRef<
262
262
  {showClearButton && (
263
263
  <Button
264
264
  aria-label={clearSearchAriaLabel ?? "Clear search"}
265
- className="text-muted-foreground hover:text-foreground"
265
+ /* Same square hit area as the DataTableSearch clear — a default
266
+ h-9 px-4 button hovers as a wide pill inside the field. */
267
+ className="text-muted-foreground hover:text-foreground size-6 p-0"
266
268
  dataHook="command-input-clear"
267
269
  variant="ghost"
268
270
  onClick={handleClear}
@@ -352,7 +354,7 @@ const CommandEmpty = React.forwardRef<
352
354
  ref={setRef}
353
355
  aria-disabled="true"
354
356
  aria-selected="false"
355
- className="py-6 text-center text-sm"
357
+ className="text-body-sm py-6 text-center"
356
358
  data-hook={dataHook}
357
359
  data-slot="command-empty"
358
360
  {...props}
@@ -387,7 +389,7 @@ const CommandGroup = React.forwardRef<
387
389
  <CommandPrimitive.Group
388
390
  ref={ref}
389
391
  className={cn(
390
- "text-foreground [&_[cmdk-group-heading]]:text-muted-foreground overflow-hidden px-2 py-1 [&_[cmdk-group-heading]]:px-2 [&_[cmdk-group-heading]]:py-1.5 [&_[cmdk-group-heading]]:text-xs [&_[cmdk-group-heading]]:font-medium",
392
+ "text-foreground [&_[cmdk-group-heading]]:text-muted-foreground [&_[cmdk-group-heading]]:text-label-sm overflow-hidden px-2 py-1 [&_[cmdk-group-heading]]:px-2 [&_[cmdk-group-heading]]:py-1.5",
391
393
  className
392
394
  )}
393
395
  data-hook={dataHook}
@@ -480,7 +482,7 @@ const CommandItem = React.forwardRef<
480
482
  <CommandPrimitive.Item
481
483
  ref={ref}
482
484
  className={cn(
483
- "data-[selected=true]:bg-accent data-[selected=true]:text-accent-foreground data-[disabled=true]:text-muted-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-3 text-sm outline-hidden select-none data-[disabled=true]:pointer-events-none data-[disabled=true]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0",
485
+ "data-[selected=true]:bg-accent data-[selected=true]:text-accent-foreground data-[disabled=true]:text-muted-foreground text-label relative flex cursor-default items-center gap-2 rounded-sm px-2 py-3 outline-hidden select-none data-[disabled=true]:pointer-events-none data-[disabled=true]:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0",
484
486
  className
485
487
  )}
486
488
  data-hook={dataHook}
@@ -526,10 +528,7 @@ const CommandShortcut = React.forwardRef<HTMLSpanElement, CommandShortcutProps>(
526
528
  ({ className, dataHook, trackingEl, trackingLabel, ...props }, ref) => (
527
529
  <span
528
530
  ref={ref}
529
- className={cn(
530
- "text-muted-foreground ml-auto text-xs tracking-widest",
531
- className
532
- )}
531
+ className={cn("text-muted-foreground text-body-xs ml-auto", className)}
533
532
  data-hook={dataHook}
534
533
  data-slot="command-shortcut"
535
534
  data-tracking-el={trackingEl}
@@ -976,7 +975,7 @@ const CommandVirtualItem = React.forwardRef<
976
975
  aria-selected={selected || undefined}
977
976
  aria-setsize={virtualCtx?.filteredCount}
978
977
  className={cn(
979
- "data-[highlighted=true]:bg-accent data-[highlighted=true]:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-3 text-sm outline-hidden select-none",
978
+ "data-[highlighted=true]:bg-accent data-[highlighted=true]:text-accent-foreground text-label relative flex cursor-default items-center gap-2 rounded-sm px-2 py-3 outline-hidden select-none",
980
979
  "[&_svg]:pointer-events-none [&_svg]:shrink-0",
981
980
  disabled && "pointer-events-none opacity-50",
982
981
  className
@@ -168,7 +168,7 @@ const ContextMenuSubTrigger = React.forwardRef<
168
168
  <ContextMenuPrimitive.SubTrigger
169
169
  ref={ref}
170
170
  className={cn(
171
- "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none select-none",
171
+ "focus:bg-accent focus:text-accent-foreground data-[state=open]:bg-accent data-[state=open]:text-accent-foreground text-label flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 outline-none select-none",
172
172
  inset && "pl-8",
173
173
  className
174
174
  )}
@@ -284,7 +284,7 @@ const ContextMenuItem = React.forwardRef<
284
284
  <ContextMenuPrimitive.Item
285
285
  ref={ref}
286
286
  className={cn(
287
- "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
287
+ "focus:bg-accent focus:text-accent-foreground text-label relative flex cursor-default items-center gap-2 rounded-sm px-2 py-1.5 outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
288
288
  inset && "pl-8",
289
289
  className
290
290
  )}
@@ -341,7 +341,7 @@ const ContextMenuCheckboxItem = React.forwardRef<
341
341
  ref={ref}
342
342
  checked={checked}
343
343
  className={cn(
344
- "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center rounded-sm py-1.5 pr-2 pl-8 text-sm outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
344
+ "focus:bg-accent focus:text-accent-foreground text-label relative flex cursor-default items-center rounded-sm py-1.5 pr-2 pl-8 outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
345
345
  className
346
346
  )}
347
347
  data-hook={dataHook}
@@ -395,7 +395,7 @@ const ContextMenuRadioItem = React.forwardRef<
395
395
  <ContextMenuPrimitive.RadioItem
396
396
  ref={ref}
397
397
  className={cn(
398
- "focus:bg-accent focus:text-accent-foreground relative flex cursor-default items-center rounded-sm py-1.5 pr-2 pl-8 text-sm outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
398
+ "focus:bg-accent focus:text-accent-foreground text-label relative flex cursor-default items-center rounded-sm py-1.5 pr-2 pl-8 outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
399
399
  className
400
400
  )}
401
401
  data-hook={dataHook}
@@ -437,7 +437,7 @@ const ContextMenuLabel = React.forwardRef<
437
437
  <ContextMenuPrimitive.Label
438
438
  ref={ref}
439
439
  className={cn(
440
- "text-foreground px-2 py-1.5 text-sm font-semibold",
440
+ "text-foreground text-label-sm px-2 py-1.5",
441
441
  inset && "pl-8",
442
442
  className
443
443
  )}
@@ -484,10 +484,7 @@ const ContextMenuShortcut = React.forwardRef<
484
484
  >(({ className, ...props }, ref) => (
485
485
  <span
486
486
  ref={ref}
487
- className={cn(
488
- "text-muted-foreground ml-auto text-xs tracking-widest",
489
- className
490
- )}
487
+ className={cn("text-muted-foreground text-body-xs ml-auto", className)}
491
488
  data-slot="context-menu-shortcut"
492
489
  {...props}
493
490
  />
@@ -18,8 +18,6 @@
18
18
  * - Layout: `DataTableToolbar`, `DataTableToolbarLeft`,
19
19
  * `DataTableToolbarRight` — responsive flex container for search +
20
20
  * pagination above (or below) the table.
21
- *
22
- * Block composition example — see `apps/sandbox/components/audit-table.tsx`.
23
21
  */
24
22
 
25
23
  import * as React from "react";
@@ -182,8 +180,16 @@ export interface UseDataTableOptions<TData> {
182
180
  enableSorting?: boolean;
183
181
  /** Enable global text search across rows (substring match). @default false */
184
182
  enableGlobalFiltering?: boolean;
185
- /** Enable row selection via checkboxes. @default false */
186
- enableRowSelection?: boolean;
183
+ /**
184
+ * Enable row selection via checkboxes. Pass a predicate to decide per row:
185
+ * a row for which it returns `false` has `row.getCanSelect() === false`, so
186
+ * `DataTableSelectRowCheckbox` renders disabled and `DataTableSelectAllCheckbox`
187
+ * skips the row. Use it for caps and allowances — let already-selected rows
188
+ * stay selectable so the user can undo.
189
+ * @default false
190
+ * @example enableRowSelection: (row) => row.getIsSelected() || selectedCount < 20
191
+ */
192
+ enableRowSelection?: boolean | ((row: Row<TData>) => boolean);
187
193
  /** Enable client-side pagination. @default false */
188
194
  enablePagination?: boolean;
189
195
  /** Initial page size when pagination is enabled. @default 10 */
@@ -288,6 +294,14 @@ export interface UseDataTableOptions<TData> {
288
294
  * mixed (keep the table-level default and set `enableSorting: false` on the
289
295
  * individual column defs that must not sort).
290
296
  *
297
+ * Row selection can be resolved per row the same way: `enableRowSelection`
298
+ * takes a predicate as well as a boolean, which backs `row.getCanSelect()`.
299
+ * A blocked row renders a disabled `DataTableSelectRowCheckbox` and is skipped
300
+ * by `DataTableSelectAllCheckbox`. Let already-selected rows pass the
301
+ * predicate, or a cap leaves the user no way to swap a choice — and leave
302
+ * select-all out of a capped table, since every row passes a count-based
303
+ * predicate while the selection is empty.
304
+ *
291
305
  * @example
292
306
  * const table = useDataTable({
293
307
  * columns,
@@ -402,7 +416,9 @@ export function useDataTable<TData>(
402
416
  // omitting it would leave `row.getCanSelect()` returning true and
403
417
  // `DataTableSelectRowCheckbox` enabled on tables without selection.
404
418
  enableRowSelection,
405
- ...(enableRowSelection && {
419
+ // A predicate turns selection on for the table as a whole; individual rows
420
+ // opt out through `row.getCanSelect()`, so the state wiring is still needed.
421
+ ...(enableRowSelection !== false && {
406
422
  onRowSelectionChange: setRowSelectionState,
407
423
  }),
408
424
 
@@ -457,8 +473,22 @@ export interface DataTableProps<TData> {
457
473
  isLoading?: boolean;
458
474
  /** Number of skeleton rows when loading. Falls back to the table's page size, then 10. */
459
475
  skeletonRowCount?: number;
460
- /** Empty state message. @default "No results." */
461
- noResultsMessage?: string;
476
+ /**
477
+ * What the table shows in place of rows when it has none.
478
+ *
479
+ * A string is the no-results case — a filter or search that excludes
480
+ * everything — and it is announced politely, because the reader's own query
481
+ * caused it and they are waiting to hear the outcome.
482
+ *
483
+ * Pass an `<EmptyState>` for a collection that is empty rather than filtered:
484
+ * nothing has been added yet, so the cell needs a title and a way to add the
485
+ * first one. The cell brings the block's breathing room with it — do not wrap
486
+ * it in a padding element. The block is wrapped in the same live region, so
487
+ * keep it to the standard anatomy — its title and one line are worth hearing;
488
+ * a wall of copy is not.
489
+ * @default "No results."
490
+ */
491
+ noResultsMessage?: React.ReactNode;
462
492
  /**
463
493
  * Pin the `<thead>` to the top of the scroll container so column headers
464
494
  * remain visible while scrolling. The header keeps its opaque `bg-muted`
@@ -626,7 +656,14 @@ export function DataTable<TData>({
626
656
  ) : (
627
657
  <TableRow>
628
658
  <TableCell align="center" colSpan={columnCount} size="lg">
629
- <div aria-live="polite" role="status">
659
+ {/* Padded for a block, not for a line: an `EmptyState` passed
660
+ as the message needs the same room here that it gets
661
+ anywhere else, and a prop API gives the consumer nowhere
662
+ to add it. 24 rather than 32, because this sits inside
663
+ the cell's own 8: together they give the block its 32,
664
+ and a one-line message still measures under `size="lg"`'s
665
+ min-height, so the plain-string row does not move. */}
666
+ <div aria-live="polite" className="py-6" role="status">
630
667
  {noResultsMessage}
631
668
  </div>
632
669
  </TableCell>
@@ -960,7 +997,9 @@ export function VirtualizedDataTable<TData>({
960
997
  ) : (
961
998
  <TableRow>
962
999
  <TableCell align="center" colSpan={columnCount} size="lg">
963
- <div aria-live="polite" role="status">
1000
+ {/* Padded for a block — see the note on the non-virtualised
1001
+ table's no-results cell. */}
1002
+ <div aria-live="polite" className="py-6" role="status">
964
1003
  {noResultsMessage}
965
1004
  </div>
966
1005
  </TableCell>
@@ -1028,7 +1067,7 @@ export function DataTableColumnHeader<TData, TValue>({
1028
1067
  return (
1029
1068
  <div
1030
1069
  className={cn(
1031
- "text-muted-foreground text-left text-sm leading-normal font-medium",
1070
+ "text-muted-foreground text-label text-left font-semibold",
1032
1071
  align === "right" && "text-right",
1033
1072
  align === "center" && "text-center",
1034
1073
  className
@@ -1066,7 +1105,7 @@ export function DataTableColumnHeader<TData, TValue>({
1066
1105
  >
1067
1106
  <Button
1068
1107
  aria-label={sortLabel}
1069
- className="text-muted-foreground h-auto p-0 text-sm font-medium"
1108
+ className="text-muted-foreground text-label h-auto p-0 font-semibold"
1070
1109
  dataHook={dataHook || `column-header-${column.id}`}
1071
1110
  size="sm"
1072
1111
  variant="ghost"
@@ -1155,7 +1194,9 @@ export function DataTableSearch<TData>({
1155
1194
  <InputGroupAddon className="pr-1">
1156
1195
  <Button
1157
1196
  aria-label={clearSearchAriaLabel ?? "Clear search"}
1158
- className="h-auto p-1"
1197
+ /* Fixed square hit area — h-auto p-1 let the ghost hover hug the
1198
+ 14px icon into a squashed pill. */
1199
+ className="size-6 p-0"
1159
1200
  data-slot="data-table-search-clear"
1160
1201
  dataHook={`${inputGroupProps.dataHook}-clear`}
1161
1202
  variant="ghost"
@@ -1348,7 +1389,7 @@ function DataTablePaginationRowCount({
1348
1389
 
1349
1390
  return (
1350
1391
  <span
1351
- className={cn("text-muted-foreground text-sm", className)}
1392
+ className={cn("text-body-sm text-muted-foreground", className)}
1352
1393
  data-slot="data-table-pagination-row-count"
1353
1394
  >
1354
1395
  {content}
@@ -1374,8 +1415,9 @@ export interface DataTablePaginationNavProps {
1374
1415
  /**
1375
1416
  * Pagination navigation for `DataTablePagination`.
1376
1417
  *
1377
- * Renders previous/next buttons and page links. Must be rendered inside
1378
- * `<DataTablePagination>`.
1418
+ * Renders previous/next buttons and page links. Renders nothing when there
1419
+ * is at most one page — navigation controls are noise when there is nowhere
1420
+ * to navigate. Must be rendered inside `<DataTablePagination>`.
1379
1421
  */
1380
1422
  function DataTablePaginationNav({
1381
1423
  ariaLabel = "Table pagination",
@@ -1389,6 +1431,10 @@ function DataTablePaginationNav({
1389
1431
  totalPages: info.totalPages,
1390
1432
  });
1391
1433
 
1434
+ if (info.totalPages <= 1) {
1435
+ return null;
1436
+ }
1437
+
1392
1438
  return (
1393
1439
  <Pagination
1394
1440
  ariaLabel={ariaLabel}
@@ -1500,6 +1546,11 @@ export interface DataTablePaginationProps<TData> {
1500
1546
  * optional "start–end of total" row count label. Use `renderRowCount` for
1501
1547
  * i18n-friendly text.
1502
1548
  *
1549
+ * The navigation hides itself when there is at most one page (the row count
1550
+ * stays, keeping the bar informative and the layout stable). When both the
1551
+ * row count and the nav are empty, the component renders nothing — no
1552
+ * consumer render gate needed.
1553
+ *
1503
1554
  * **Compositional mode** (with children): acts as a context provider.
1504
1555
  * Compose `DataTablePaginationRowCount` and `DataTablePaginationNav`
1505
1556
  * in any order/layout.
@@ -1579,18 +1630,22 @@ export function DataTablePagination<TData>({
1579
1630
  return `${info.startRow}-${info.endRow} of ${info.totalRows}`;
1580
1631
  })();
1581
1632
 
1633
+ if (rowCountContent == null && info.totalPages <= 1) {
1634
+ return null;
1635
+ }
1636
+
1582
1637
  return (
1583
1638
  <DataTablePaginationContext.Provider value={contextValue}>
1584
1639
  <div
1585
1640
  className={cn(
1586
- "flex w-full items-center gap-4",
1641
+ "flex min-h-9 w-full items-center gap-4",
1587
1642
  rowCountContent != null ? "justify-between" : "justify-end",
1588
1643
  className
1589
1644
  )}
1590
1645
  {...wrapperDataAttrs}
1591
1646
  >
1592
1647
  {rowCountContent != null && (
1593
- <span className="text-muted-foreground text-sm">
1648
+ <span className="text-body-sm text-muted-foreground">
1594
1649
  {rowCountContent}
1595
1650
  </span>
1596
1651
  )}
@@ -41,7 +41,7 @@ const Description = React.forwardRef<HTMLParagraphElement, DescriptionProps>(
41
41
  <p
42
42
  ref={ref}
43
43
  className={cn(
44
- "text-muted-foreground text-left text-sm",
44
+ "text-body-sm text-muted-foreground text-left",
45
45
  "[&>a:hover]:text-primary [&>a]:underline [&>a]:underline-offset-4",
46
46
  className
47
47
  )}
@@ -218,7 +218,7 @@ const DialogTitle = React.forwardRef<
218
218
  >(({ className, dataHook, ...props }, ref) => (
219
219
  <DialogPrimitive.Title
220
220
  ref={ref}
221
- className={cn("text-lg leading-none font-semibold", className)}
221
+ className={cn("text-heading-section", className)}
222
222
  data-hook={dataHook}
223
223
  data-slot="dialog-title"
224
224
  {...props}
@@ -249,7 +249,7 @@ const DialogDescription = React.forwardRef<
249
249
  >(({ className, dataHook, ...props }, ref) => (
250
250
  <DialogPrimitive.Description
251
251
  ref={ref}
252
- className={cn("text-muted-foreground text-sm", className)}
252
+ className={cn("text-body-sm text-muted-foreground", className)}
253
253
  data-hook={dataHook}
254
254
  data-slot="dialog-description"
255
255
  {...props}
@@ -196,10 +196,7 @@ function DrawerTitle({
196
196
  }: React.ComponentProps<typeof DrawerPrimitive.Title>) {
197
197
  return (
198
198
  <DrawerPrimitive.Title
199
- className={cn(
200
- "text-foreground text-lg leading-none font-semibold",
201
- className
202
- )}
199
+ className={cn("text-foreground text-heading-section", className)}
203
200
  data-slot="drawer-title"
204
201
  {...props}
205
202
  />
@@ -217,7 +214,7 @@ function DrawerDescription({
217
214
  }: React.ComponentProps<typeof DrawerPrimitive.Description>) {
218
215
  return (
219
216
  <DrawerPrimitive.Description
220
- className={cn("text-muted-foreground text-sm leading-normal", className)}
217
+ className={cn("text-body-sm text-muted-foreground", className)}
221
218
  data-slot="drawer-description"
222
219
  {...props}
223
220
  />
@@ -195,7 +195,7 @@ const DropdownMenuItem = React.forwardRef<
195
195
  className={cn(
196
196
  [
197
197
  "relative flex cursor-default items-center gap-2 self-stretch select-none",
198
- "rounded-sm px-2 py-1.5 text-sm leading-normal outline-hidden",
198
+ "text-label rounded-sm px-2 py-1.5 outline-hidden",
199
199
  // Text truncation for child text elements
200
200
  "[&>span]:overflow-hidden [&>span]:text-ellipsis [&>span]:whitespace-nowrap",
201
201
  "focus:bg-accent focus:text-accent-foreground",
@@ -263,7 +263,7 @@ const DropdownMenuCheckboxItem = React.forwardRef<
263
263
  className={cn(
264
264
  [
265
265
  "relative flex cursor-default items-center gap-2 select-none",
266
- "rounded-sm py-1.5 pr-2 pl-8 text-sm outline-hidden",
266
+ "text-label rounded-sm py-1.5 pr-2 pl-8 outline-hidden",
267
267
  "focus:bg-accent focus:text-accent-foreground",
268
268
  "data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
269
269
  // Icon styling
@@ -335,7 +335,7 @@ const DropdownMenuRadioItem = React.forwardRef<
335
335
  className={cn(
336
336
  [
337
337
  "relative flex cursor-default items-center gap-2 select-none",
338
- "rounded-sm py-1.5 pr-2 pl-8 text-sm outline-hidden",
338
+ "text-label rounded-sm py-1.5 pr-2 pl-8 outline-hidden",
339
339
  "focus:bg-accent focus:text-accent-foreground",
340
340
  "data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
341
341
  // Icon styling
@@ -387,10 +387,7 @@ const DropdownMenuLabel = React.forwardRef<
387
387
  <DropdownMenuPrimitive.Label
388
388
  ref={ref}
389
389
  className={cn(
390
- [
391
- "px-2 py-1.5 text-sm leading-normal font-semibold",
392
- "data-[inset]:pl-8",
393
- ],
390
+ ["text-label-sm px-2 py-1.5", "data-[inset]:pl-8"],
394
391
  className
395
392
  )}
396
393
  data-hook={dataHook}
@@ -432,7 +429,7 @@ function DropdownMenuShortcut({
432
429
  return (
433
430
  <span
434
431
  className={cn(
435
- ["text-popover-foreground ml-auto text-xs leading-normal opacity-60"],
432
+ ["text-popover-foreground text-body-xs ml-auto opacity-60"],
436
433
  className
437
434
  )}
438
435
  data-slot="dropdown-menu-shortcut"
@@ -500,7 +497,7 @@ const DropdownMenuSubTrigger = React.forwardRef<
500
497
  className={cn(
501
498
  [
502
499
  "flex cursor-default items-center gap-2 select-none",
503
- "rounded-sm px-2 py-1.5 text-sm outline-hidden",
500
+ "text-label rounded-sm px-2 py-1.5 outline-hidden",
504
501
  "focus:bg-accent focus:text-accent-foreground",
505
502
  "data-[state=open]:bg-accent data-[state=open]:text-accent-foreground",
506
503
  "data-[inset]:pl-8",
@@ -634,11 +631,11 @@ const DropdownMenuTriggerAvatar = React.forwardRef<
634
631
  >
635
632
  {avatar}
636
633
  <div className="flex min-w-0 flex-1 flex-col items-start">
637
- <span className="w-full overflow-hidden text-sm leading-normal font-semibold text-ellipsis whitespace-nowrap">
634
+ <span className="text-heading-compact w-full overflow-hidden text-ellipsis whitespace-nowrap">
638
635
  {title}
639
636
  </span>
640
637
  {description && (
641
- <span className="text-muted-foreground w-full overflow-hidden text-xs leading-normal text-ellipsis whitespace-nowrap">
638
+ <span className="text-muted-foreground text-body-xs w-full overflow-hidden text-ellipsis whitespace-nowrap">
642
639
  {description}
643
640
  </span>
644
641
  )}
@@ -49,9 +49,9 @@ function FieldLegend({
49
49
  return (
50
50
  <legend
51
51
  className={cn(
52
- "mb-3 font-medium",
53
- "data-[variant=legend]:text-base",
54
- "data-[variant=label]:text-sm",
52
+ "mb-3",
53
+ "data-[variant=legend]:text-heading-subsection",
54
+ "data-[variant=label]:text-label",
55
55
  srOnly && "sr-only",
56
56
  className
57
57
  )}
@@ -98,6 +98,9 @@ const fieldVariants = cva(
98
98
  "grid grid-cols-[auto_1fr] items-center gap-x-2",
99
99
  "[&>[data-slot=field-description]]:col-start-2 [&>[data-slot=field-error]]:col-start-2",
100
100
  "has-[>[data-slot=field-content]]:items-start",
101
+ // Top-aligned rows: a 16px control centres on the label's first line
102
+ // (text-label is 20px), never on the content box's top edge.
103
+ "has-[>[data-slot=field-content]]:[&>[role=radio]]:mt-0.5",
101
104
  // sr-only label leaves grid flow — collapse to a single column
102
105
  "has-[>.sr-only[data-slot=field-label]]:grid-cols-[1fr]",
103
106
  "[&:has(>.sr-only[data-slot=field-label])>[data-slot=field-description]]:col-start-1",
@@ -107,6 +110,7 @@ const fieldVariants = cva(
107
110
  "flex-col [&>*]:w-full [&>.sr-only]:w-auto @md/field-group:grid @md/field-group:grid-cols-[auto_1fr] @md/field-group:items-center @md/field-group:[&>*]:w-auto",
108
111
  "@md/field-group:[&>[data-slot=field-description]]:col-start-2 @md/field-group:[&>[data-slot=field-error]]:col-start-2",
109
112
  "@md/field-group:has-[>[data-slot=field-content]]:items-start",
113
+ "@md/field-group:has-[>[data-slot=field-content]]:[&>[role=radio]]:mt-0.5",
110
114
  // sr-only label leaves grid flow — collapse to a single column
111
115
  "@md/field-group:has-[>.sr-only[data-slot=field-label]]:grid-cols-[1fr]",
112
116
  "@md/field-group:[&:has(>.sr-only[data-slot=field-label])>[data-slot=field-description]]:col-start-1",
@@ -399,7 +403,7 @@ function FieldError({
399
403
  }
400
404
 
401
405
  const baseStyles = cn(
402
- "text-destructive-foreground text-sm font-normal leading-5",
406
+ "text-body-sm text-destructive-foreground",
403
407
  "mt-2",
404
408
  "group-has-[[data-orientation=horizontal]]/field:text-balance",
405
409
  "last:mt-0 nth-last-2:-mt-1 [[data-variant=legend]+&]:-mt-1.5",
@@ -6,7 +6,7 @@ import { Breadcrumb } from "./breadcrumb";
6
6
  import { Header } from "./header";
7
7
  import { Link } from "./link";
8
8
  import { ScrollArea } from "./scroll-area";
9
- import { TypographyMuted } from "./typography";
9
+ import { TypographyText } from "./typography-text";
10
10
 
11
11
  interface GlobalLayoutProps extends React.ComponentProps<"div"> {
12
12
  /**
@@ -245,7 +245,12 @@ const GlobalLayoutBackLink = React.forwardRef<
245
245
 
246
246
  GlobalLayoutBackLink.displayName = "GlobalLayoutBackLink";
247
247
 
248
- interface GlobalLayoutSubtitleProps extends React.ComponentProps<"p"> {
248
+ // The deprecated native `color` presentation attribute is omitted: the
249
+ // subtitle's colour is the type scale's muted role, not a free-form value.
250
+ interface GlobalLayoutSubtitleProps extends Omit<
251
+ React.ComponentProps<"p">,
252
+ "color"
253
+ > {
249
254
  /**
250
255
  * Data hook for automated testing
251
256
  * @default "content-header-subtitle"
@@ -263,17 +268,23 @@ interface GlobalLayoutSubtitleProps extends React.ComponentProps<"p"> {
263
268
  * Muted description text for the page header. Place it as a direct child of
264
269
  * `GlobalLayoutContentHeader` — the header positions it below the title row.
265
270
  * For rich descriptions, pass `asChild` with your own flex row as the child.
271
+ *
272
+ * Sits on the semantic type scale's `text-body-sm` (Inter · Figma 500 · 14/20,
273
+ * rendering one CSS weight lighter per the DS-305 offset) with the muted
274
+ * colour role — de-emphasis is colour-only, never a lighter weight.
266
275
  */
267
276
  const GlobalLayoutSubtitle = React.forwardRef<
268
277
  HTMLParagraphElement,
269
278
  GlobalLayoutSubtitleProps
270
279
  >(({ dataHook, asChild, ...props }, ref) => {
271
280
  return (
272
- <TypographyMuted
281
+ <TypographyText
273
282
  ref={ref}
274
283
  asChild={asChild}
284
+ color="muted"
275
285
  data-slot="content-header-subtitle"
276
286
  dataHook={dataHook ?? "content-header-subtitle"}
287
+ variant="body-sm"
277
288
  {...props}
278
289
  />
279
290
  );
@@ -334,6 +345,28 @@ interface GlobalLayoutContentHeaderProps extends React.ComponentProps<"header">
334
345
  trackingLabel?: string;
335
346
  }
336
347
 
348
+ /**
349
+ * Page header for the content area. Slots direct children (back link, image,
350
+ * breadcrumb, subtitle, actions) around the title row per the Figma Page
351
+ * Header design.
352
+ *
353
+ * The consumer-supplied page title must be `TypographyHeading level={1}
354
+ * variant="page"` so it sits on the semantic type scale's
355
+ * `text-heading-page` (DS-714) — never a hand-styled heading. Exactly one
356
+ * page title per screen: a second title is a section (`variant="section"`,
357
+ * `text-heading-section`).
358
+ *
359
+ * @example
360
+ * <GlobalLayoutContentHeader dataHook="page-header">
361
+ * <TypographyHeading level={1} variant="page" dataHook="page-title">
362
+ * All Locations
363
+ * </TypographyHeading>
364
+ * <GlobalLayoutContentActions dataHook="header-actions">
365
+ * <Button dataHook="add-location">Add Location</Button>
366
+ * </GlobalLayoutContentActions>
367
+ * <GlobalLayoutSubtitle>Manage your business locations.</GlobalLayoutSubtitle>
368
+ * </GlobalLayoutContentHeader>
369
+ */
337
370
  const GlobalLayoutContentHeader = React.forwardRef<
338
371
  HTMLElement,
339
372
  GlobalLayoutContentHeaderProps