@tfn-design/design-system 0.2.0 → 0.3.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 (967) hide show
  1. package/README.md +3 -3
  2. package/dist/accordion/accordion.d.ts +2 -2
  3. package/dist/accordion/web/ds-accordion.d.ts +10 -3
  4. package/dist/accordion/web/ds-accordion.js +33 -4
  5. package/dist/account-password-field/account-password-field.d.ts +4 -4
  6. package/dist/account-password-field/web/ds-account-password-field.d.ts +2 -2
  7. package/dist/account-password-field/web/ds-account-password-field.js +1 -1
  8. package/dist/account-switcher/account-switcher.d.ts +7 -7
  9. package/dist/account-switcher/web/ds-account-switcher.d.ts +5 -5
  10. package/dist/account-switcher/web/ds-account-switcher.js +3 -3
  11. package/dist/action-toast/action-toast.d.ts +12 -12
  12. package/dist/action-toast/web/ds-action-toast.d.ts +5 -5
  13. package/dist/action-toast/web/ds-action-toast.js +9 -4
  14. package/dist/ai-assist-field/ai-assist-field.d.ts +8 -6
  15. package/dist/ai-assist-field/ai-assist-field.js +12 -2
  16. package/dist/ai-assist-field/web/ds-ai-assist-field.d.ts +1 -1
  17. package/dist/ai-assist-field/web/ds-ai-assist-field.js +9 -8
  18. package/dist/ai-attachment/web/ds-ai-attachment.js +2 -1
  19. package/dist/ai-branch-switcher/ai-branch-switcher.d.ts +3 -0
  20. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.d.ts +1 -1
  21. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.js +8 -5
  22. package/dist/ai-citation/ai-citation.d.ts +8 -8
  23. package/dist/ai-citation/native/ds-ai-citation.js +5 -5
  24. package/dist/ai-citation/web/ds-ai-citation.js +6 -5
  25. package/dist/ai-composer/ai-composer.d.ts +2 -2
  26. package/dist/ai-composer/native/ds-ai-composer.js +5 -4
  27. package/dist/ai-composer/web/ds-ai-composer.d.ts +1 -1
  28. package/dist/ai-composer/web/ds-ai-composer.js +2 -2
  29. package/dist/ai-confirmation/ai-confirmation.d.ts +9 -9
  30. package/dist/ai-confirmation/native/ds-ai-confirmation.js +2 -2
  31. package/dist/ai-confirmation/web/ds-ai-confirmation.d.ts +1 -1
  32. package/dist/ai-confirmation/web/ds-ai-confirmation.js +3 -2
  33. package/dist/ai-context-scope/ai-context-scope.d.ts +5 -5
  34. package/dist/ai-context-scope/ai-context-scope.js +1 -1
  35. package/dist/ai-context-scope/native/ds-ai-context-scope.d.ts +1 -1
  36. package/dist/ai-context-scope/native/ds-ai-context-scope.js +6 -3
  37. package/dist/ai-context-scope/web/ds-ai-context-scope.d.ts +2 -2
  38. package/dist/ai-context-scope/web/ds-ai-context-scope.js +12 -2
  39. package/dist/ai-conversation-list/ai-conversation-list.d.ts +5 -5
  40. package/dist/ai-conversation-list/web/ds-ai-conversation-list.d.ts +1 -1
  41. package/dist/ai-conversation-list/web/ds-ai-conversation-list.js +7 -6
  42. package/dist/ai-diff/ai-diff.d.ts +2 -2
  43. package/dist/ai-diff/native/ds-ai-diff.js +3 -2
  44. package/dist/ai-diff/web/ds-ai-diff.js +3 -2
  45. package/dist/ai-draft-panel/ai-draft-panel.d.ts +3 -3
  46. package/dist/ai-draft-panel/ai-draft-panel.js +3 -3
  47. package/dist/ai-draft-panel/web/ds-ai-draft-panel.d.ts +2 -2
  48. package/dist/ai-draft-panel/web/ds-ai-draft-panel.js +3 -2
  49. package/dist/ai-empty-state/native/ds-ai-empty-state.d.ts +1 -1
  50. package/dist/ai-empty-state/native/ds-ai-empty-state.js +4 -3
  51. package/dist/ai-empty-state/web/ds-ai-empty-state.d.ts +1 -1
  52. package/dist/ai-empty-state/web/ds-ai-empty-state.js +2 -1
  53. package/dist/ai-error-state/native/ds-ai-error-state.js +3 -2
  54. package/dist/ai-error-state/web/ds-ai-error-state.js +2 -1
  55. package/dist/ai-feedback/ai-feedback.d.ts +1 -1
  56. package/dist/ai-feedback/ai-feedback.js +1 -1
  57. package/dist/ai-feedback/web/ds-ai-feedback.js +3 -2
  58. package/dist/ai-label/ai-label.d.ts +5 -5
  59. package/dist/ai-label/native/ds-ai-label.js +5 -4
  60. package/dist/ai-label/web/ds-ai-label.js +4 -4
  61. package/dist/ai-message/ai-message.d.ts +3 -3
  62. package/dist/ai-message/native/ds-ai-message.d.ts +1 -1
  63. package/dist/ai-message/native/ds-ai-message.js +12 -10
  64. package/dist/ai-message/web/ds-ai-message-markdown.js +5 -5
  65. package/dist/ai-message/web/ds-ai-message.d.ts +2 -2
  66. package/dist/ai-message/web/ds-ai-message.js +3 -2
  67. package/dist/ai-message-actions/ai-message-actions.d.ts +1 -1
  68. package/dist/ai-message-actions/native/ds-ai-message-actions.js +2 -1
  69. package/dist/ai-message-actions/web/use-ai-clipboard.d.ts +1 -1
  70. package/dist/ai-plan/ai-plan.d.ts +4 -4
  71. package/dist/ai-plan/web/ds-ai-plan.js +3 -2
  72. package/dist/ai-reasoning/ai-reasoning.d.ts +1 -1
  73. package/dist/ai-side-nav/ai-side-nav.d.ts +19 -19
  74. package/dist/ai-side-nav/web/ds-ai-side-nav.d.ts +9 -9
  75. package/dist/ai-side-nav/web/ds-ai-side-nav.js +2 -1
  76. package/dist/ai-suggestions/native/ds-ai-suggestions.js +1 -1
  77. package/dist/ai-suggestions/web/ds-ai-suggestions.js +1 -1
  78. package/dist/ai-summary-card/ai-summary-card.d.ts +8 -8
  79. package/dist/ai-summary-card/native/ds-ai-summary-card.d.ts +1 -1
  80. package/dist/ai-summary-card/native/ds-ai-summary-card.js +3 -3
  81. package/dist/ai-summary-card/web/ds-ai-summary-card.d.ts +1 -1
  82. package/dist/ai-summary-card/web/ds-ai-summary-card.js +2 -1
  83. package/dist/ai-thinking/native/ds-ai-thinking.js +3 -2
  84. package/dist/ai-thinking/web/ds-ai-thinking.js +1 -1
  85. package/dist/ai-thread/ai-thread.d.ts +3 -3
  86. package/dist/ai-thread/native/ds-ai-thread-panel.js +2 -1
  87. package/dist/ai-thread/native/ds-ai-thread.d.ts +2 -2
  88. package/dist/ai-thread/native/ds-ai-thread.js +4 -2
  89. package/dist/ai-thread/web/ds-ai-thread.d.ts +2 -2
  90. package/dist/ai-thread/web/ds-ai-thread.js +1 -1
  91. package/dist/ai-tool-call/ai-tool-call.d.ts +6 -6
  92. package/dist/ai-tool-call/native/ds-ai-tool-call.d.ts +1 -1
  93. package/dist/ai-tool-call/native/ds-ai-tool-call.js +5 -5
  94. package/dist/ai-tool-call/web/ds-ai-tool-call.d.ts +1 -1
  95. package/dist/ai-tool-call/web/ds-ai-tool-call.js +4 -3
  96. package/dist/alert/alert.d.ts +9 -9
  97. package/dist/alert/alert.js +1 -1
  98. package/dist/alert/native/ds-alert.js +9 -11
  99. package/dist/alert/web/ds-alert.js +24 -14
  100. package/dist/ambient-gradient/ambient-gradient.d.ts +11 -11
  101. package/dist/ambient-gradient/native/ambient-gradient-provider.d.ts +1 -1
  102. package/dist/ambient-gradient/native/ds-ambient-gradient.d.ts +1 -1
  103. package/dist/ambient-gradient/web/ds-ambient-gradient.d.ts +1 -1
  104. package/dist/amount/amount.d.ts +25 -25
  105. package/dist/amount/amount.js +4 -3
  106. package/dist/amount/native/ds-amount.js +2 -1
  107. package/dist/amount/web/ds-amount.js +1 -1
  108. package/dist/amount-cell/web/ds-amount-cell.js +1 -1
  109. package/dist/amount-entry/amount-entry.d.ts +8 -8
  110. package/dist/amount-entry/native/ds-amount-entry.js +3 -2
  111. package/dist/amount-entry/web/ds-amount-entry.js +2 -1
  112. package/dist/app-shell/app-shell.d.ts +9 -9
  113. package/dist/app-shell/app-shell.js +1 -1
  114. package/dist/app-shell/web/ds-app-shell.d.ts +24 -6
  115. package/dist/app-shell/web/ds-app-shell.js +4 -3
  116. package/dist/approval-chain/approval-chain.d.ts +12 -12
  117. package/dist/approval-chain/native/ds-approval-chain.d.ts +1 -1
  118. package/dist/approval-chain/native/ds-approval-chain.js +8 -6
  119. package/dist/approval-chain/web/ds-approval-chain.d.ts +1 -1
  120. package/dist/approval-chain/web/ds-approval-chain.js +7 -6
  121. package/dist/auth-shell/auth-shell.d.ts +4 -4
  122. package/dist/auth-shell/web/ds-auth-shell.d.ts +24 -6
  123. package/dist/auth-shell/web/ds-auth-shell.js +27 -2
  124. package/dist/avatar/avatar.d.ts +2 -2
  125. package/dist/avatar/native/ds-avatar.js +3 -2
  126. package/dist/avatar-group/avatar-group.d.ts +3 -3
  127. package/dist/avatar-group/native/ds-avatar-group.js +3 -2
  128. package/dist/avatar-group/web/ds-avatar-group.js +2 -2
  129. package/dist/balance-header/balance-header.d.ts +7 -7
  130. package/dist/balance-header/native/ds-balance-header.d.ts +1 -1
  131. package/dist/balance-header/native/ds-balance-header.js +3 -2
  132. package/dist/balance-header/web/ds-balance-header.d.ts +1 -1
  133. package/dist/balance-header/web/ds-balance-header.js +2 -1
  134. package/dist/bank-logo/bank-logo.d.ts +187 -0
  135. package/dist/bank-logo/bank-logo.js +151 -0
  136. package/dist/bank-logo/native/ds-bank-logo.d.ts +7 -0
  137. package/dist/bank-logo/native/ds-bank-logo.js +43 -0
  138. package/dist/bank-logo/web/ds-bank-logo.d.ts +10 -0
  139. package/dist/bank-logo/web/ds-bank-logo.js +27 -0
  140. package/dist/bar-chart/bar-chart.d.ts +63 -15
  141. package/dist/bar-chart/bar-chart.js +79 -2
  142. package/dist/bar-chart/web/ds-bar-chart.d.ts +5 -4
  143. package/dist/bar-chart/web/ds-bar-chart.js +86 -27
  144. package/dist/bottom-nav/bottom-nav.d.ts +27 -20
  145. package/dist/bottom-nav/bottom-nav.js +1 -0
  146. package/dist/bottom-nav/native/bottom-nav-icon-weight.d.ts +6 -0
  147. package/dist/bottom-nav/native/bottom-nav-icon-weight.js +6 -0
  148. package/dist/bottom-nav/native/ds-bottom-nav.d.ts +8 -8
  149. package/dist/bottom-nav/native/ds-bottom-nav.js +26 -17
  150. package/dist/bottom-nav/web/ds-bottom-nav.d.ts +16 -0
  151. package/dist/bottom-nav/web/ds-bottom-nav.js +31 -0
  152. package/dist/brand-lockup/brand-lockup.d.ts +41 -35
  153. package/dist/brand-lockup/brand-lockup.js +1 -1
  154. package/dist/brand-lockup/native/ds-brand-lockup.d.ts +7 -7
  155. package/dist/brand-lockup/native/ds-brand-lockup.js +6 -4
  156. package/dist/brand-lockup/web/ds-brand-lockup.d.ts +8 -8
  157. package/dist/brand-lockup/web/ds-brand-lockup.js +6 -4
  158. package/dist/breadcrumbs/breadcrumbs.d.ts +4 -4
  159. package/dist/breadcrumbs/web/ds-breadcrumbs.d.ts +1 -1
  160. package/dist/bulk-action-bar/bulk-action-bar.d.ts +6 -6
  161. package/dist/bulk-action-bar/web/ds-bulk-action-bar.d.ts +4 -4
  162. package/dist/bulk-action-bar/web/ds-bulk-action-bar.js +2 -1
  163. package/dist/bullet-chart/bullet-chart.d.ts +82 -0
  164. package/dist/bullet-chart/bullet-chart.js +60 -0
  165. package/dist/bullet-chart/web/ds-bullet-chart.d.ts +8 -0
  166. package/dist/bullet-chart/web/ds-bullet-chart.js +31 -0
  167. package/dist/button/button.d.ts +36 -36
  168. package/dist/button/button.js +14 -14
  169. package/dist/button/native/ds-button.js +10 -11
  170. package/dist/button/web/ds-button.d.ts +3 -3
  171. package/dist/button/web/ds-button.js +41 -24
  172. package/dist/button-group/button-group.d.ts +2 -2
  173. package/dist/button-group/web/ds-button-group.d.ts +3 -3
  174. package/dist/button-group/web/ds-button-group.js +1 -1
  175. package/dist/calendar/calendar.d.ts +14 -14
  176. package/dist/calendar/web/ds-calendar.d.ts +9 -5
  177. package/dist/calendar/web/ds-calendar.js +11 -9
  178. package/dist/card-carousel/card-carousel.d.ts +5 -5
  179. package/dist/card-carousel/native/ds-card-carousel.js +1 -1
  180. package/dist/card-carousel/web/ds-card-carousel.js +4 -2
  181. package/dist/chart/chart.d.ts +140 -60
  182. package/dist/chart/chart.js +146 -46
  183. package/dist/chart/web/ds-chart.d.ts +15 -13
  184. package/dist/chart/web/ds-chart.js +122 -49
  185. package/dist/check-option/check-option.d.ts +8 -10
  186. package/dist/check-option/check-option.js +0 -2
  187. package/dist/check-option/web/ds-check-option.d.ts +4 -4
  188. package/dist/check-option/web/ds-check-option.js +5 -4
  189. package/dist/checkbox/checkbox.d.ts +1 -1
  190. package/dist/checkbox/web/ds-checkbox.js +3 -7
  191. package/dist/chip/chip-wash.d.ts +5 -5
  192. package/dist/chip/chip.d.ts +5 -5
  193. package/dist/chip/native/ds-chip.d.ts +1 -1
  194. package/dist/chip/native/ds-chip.js +5 -4
  195. package/dist/chip/web/ds-chip.d.ts +2 -2
  196. package/dist/chip/web/ds-chip.js +37 -4
  197. package/dist/code-block/code-block.d.ts +10 -10
  198. package/dist/code-block/web/ds-code-block.js +2 -1
  199. package/dist/code-block/web/use-code-block-clipboard.d.ts +1 -1
  200. package/dist/column-picker/web/ds-column-picker.d.ts +3 -1
  201. package/dist/column-picker/web/ds-column-picker.js +2 -2
  202. package/dist/combobox/combobox.d.ts +24 -10
  203. package/dist/combobox/combobox.js +2 -5
  204. package/dist/combobox/web/ds-combobox.d.ts +2 -2
  205. package/dist/combobox/web/ds-combobox.js +45 -13
  206. package/dist/command-palette/command-palette.d.ts +30 -30
  207. package/dist/command-palette/web/ds-command-palette.d.ts +3 -3
  208. package/dist/command-palette/web/ds-command-palette.js +9 -7
  209. package/dist/comment-thread/comment-thread.d.ts +11 -11
  210. package/dist/comment-thread/native/ds-comment-thread.d.ts +1 -1
  211. package/dist/comment-thread/native/ds-comment-thread.js +14 -12
  212. package/dist/comment-thread/web/ds-comment-thread.d.ts +1 -1
  213. package/dist/comment-thread/web/ds-comment-thread.js +8 -7
  214. package/dist/condition-builder/condition-builder.d.ts +18 -18
  215. package/dist/condition-builder/condition-builder.js +1 -1
  216. package/dist/condition-builder/web/ds-condition-builder.js +9 -9
  217. package/dist/context-menu/context-menu.d.ts +4 -4
  218. package/dist/context-menu/web/ds-context-menu.d.ts +1 -1
  219. package/dist/context-menu/web/ds-context-menu.js +2 -2
  220. package/dist/coordinate-field/coordinate-field.d.ts +10 -10
  221. package/dist/coordinate-field/native/ds-coordinate-field.d.ts +1 -1
  222. package/dist/coordinate-field/native/ds-coordinate-field.js +2 -2
  223. package/dist/coordinate-field/web/ds-coordinate-field.d.ts +1 -1
  224. package/dist/coordinate-field/web/ds-coordinate-field.js +2 -2
  225. package/dist/copy-field/copy-field.d.ts +8 -8
  226. package/dist/copy-field/web/ds-copy-field.d.ts +1 -1
  227. package/dist/copy-field/web/ds-copy-field.js +4 -4
  228. package/dist/count-badge/count-badge.d.ts +9 -9
  229. package/dist/count-badge/native/ds-count-badge.js +3 -2
  230. package/dist/count-badge/web/ds-count-badge.js +4 -4
  231. package/dist/countdown/native/ds-countdown.js +3 -2
  232. package/dist/countdown/web/ds-countdown.js +2 -1
  233. package/dist/dashboard-shell/dashboard-shell.d.ts +3 -3
  234. package/dist/dashboard-shell/web/ds-dashboard-shell.d.ts +4 -4
  235. package/dist/data-table/data-table-license.d.ts +3 -3
  236. package/dist/data-table/data-table-store.d.ts +5 -5
  237. package/dist/data-table/url-state.d.ts +6 -6
  238. package/dist/data-table/web/data-table-parts.d.ts +2 -2
  239. package/dist/data-table/web/data-table-theme.css +83 -21
  240. package/dist/data-table/web/ds-data-table-skeleton-chip.d.ts +2 -2
  241. package/dist/data-table/web/ds-data-table.d.ts +4 -2
  242. package/dist/data-table/web/ds-data-table.js +7 -2
  243. package/dist/date-field/web/ds-date-field.d.ts +1 -1
  244. package/dist/date-input/date-input.d.ts +47 -12
  245. package/dist/date-input/date-input.js +30 -3
  246. package/dist/date-input/web/ds-date-input.d.ts +2 -2
  247. package/dist/date-input/web/ds-date-input.js +33 -7
  248. package/dist/date-picker/date-picker.d.ts +23 -23
  249. package/dist/date-picker/date-picker.js +1 -1
  250. package/dist/date-picker/web/ds-date-picker.d.ts +13 -7
  251. package/dist/date-picker/web/ds-date-picker.js +8 -7
  252. package/dist/date-range-picker/web/ds-date-range-picker.js +33 -3
  253. package/dist/day-picker/day-picker.d.ts +8 -2
  254. package/dist/day-picker/day-picker.js +1 -1
  255. package/dist/day-picker/web/ds-day-picker.d.ts +3 -3
  256. package/dist/day-picker/web/ds-day-picker.js +16 -4
  257. package/dist/delta/delta.d.ts +19 -3
  258. package/dist/delta/delta.js +30 -1
  259. package/dist/delta/native/ds-delta.js +10 -5
  260. package/dist/delta/web/ds-delta.js +7 -4
  261. package/dist/description-list/description-list.d.ts +3 -3
  262. package/dist/description-list/native/ds-description-list.d.ts +2 -2
  263. package/dist/description-list/native/ds-description-list.js +6 -3
  264. package/dist/description-list/web/ds-description-list.d.ts +2 -2
  265. package/dist/description-list/web/ds-description-list.js +3 -1
  266. package/dist/dialog/dialog.d.ts +9 -9
  267. package/dist/dialog/native/ds-dialog.d.ts +1 -1
  268. package/dist/dialog/native/ds-dialog.js +2 -1
  269. package/dist/dialog/web/ds-dialog.d.ts +13 -5
  270. package/dist/dialog/web/ds-dialog.js +9 -11
  271. package/dist/diverging-bar-chart/diverging-bar-chart.d.ts +23 -8
  272. package/dist/diverging-bar-chart/diverging-bar-chart.js +24 -2
  273. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.d.ts +2 -2
  274. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.js +30 -15
  275. package/dist/divider/divider.d.ts +2 -2
  276. package/dist/divider/web/ds-divider.d.ts +1 -1
  277. package/dist/divider/web/ds-divider.js +2 -2
  278. package/dist/donut-chart/donut-chart.d.ts +19 -3
  279. package/dist/donut-chart/donut-chart.js +19 -2
  280. package/dist/donut-chart/web/ds-donut-chart.d.ts +3 -1
  281. package/dist/donut-chart/web/ds-donut-chart.js +20 -12
  282. package/dist/drawer/drawer.d.ts +10 -10
  283. package/dist/drawer/native/ds-drawer.d.ts +3 -3
  284. package/dist/drawer/native/ds-drawer.js +4 -3
  285. package/dist/drawer/web/ds-drawer.d.ts +3 -3
  286. package/dist/drawer/web/ds-drawer.js +5 -3
  287. package/dist/dropdown-menu/dropdown-menu.d.ts +17 -17
  288. package/dist/dropdown-menu/dropdown-menu.js +1 -1
  289. package/dist/dropdown-menu/native/ds-dropdown-menu.d.ts +2 -2
  290. package/dist/dropdown-menu/native/ds-dropdown-menu.js +4 -3
  291. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.d.ts +5 -5
  292. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.js +5 -4
  293. package/dist/dropdown-menu/web/ds-dropdown-menu.d.ts +4 -4
  294. package/dist/dumbbell-chart/dumbbell-chart.d.ts +39 -0
  295. package/dist/dumbbell-chart/dumbbell-chart.js +19 -0
  296. package/dist/dumbbell-chart/web/ds-dumbbell-chart.d.ts +13 -0
  297. package/dist/dumbbell-chart/web/ds-dumbbell-chart.js +20 -0
  298. package/dist/editable-row/editable-row.d.ts +7 -2
  299. package/dist/editable-row/web/ds-editable-row.d.ts +2 -2
  300. package/dist/editable-row/web/ds-editable-row.js +3 -3
  301. package/dist/empty-state/empty-state.d.ts +5 -5
  302. package/dist/empty-state/empty-state.js +1 -1
  303. package/dist/empty-state/native/ds-empty-state.d.ts +3 -3
  304. package/dist/empty-state/native/ds-empty-state.js +1 -1
  305. package/dist/empty-state/web/ds-empty-state.d.ts +8 -8
  306. package/dist/empty-state/web/ds-empty-state.js +2 -8
  307. package/dist/environment-banner/environment-banner.d.ts +9 -9
  308. package/dist/environment-banner/web/ds-environment-banner.d.ts +2 -2
  309. package/dist/environment-banner/web/ds-environment-banner.js +4 -2
  310. package/dist/evaluation-trace/evaluation-trace.d.ts +3 -3
  311. package/dist/evaluation-trace/web/ds-evaluation-trace.d.ts +1 -1
  312. package/dist/evaluation-trace/web/ds-evaluation-trace.js +7 -6
  313. package/dist/event-row/web/ds-event-row.d.ts +1 -1
  314. package/dist/event-row/web/ds-event-row.js +2 -1
  315. package/dist/facet-button/facet-button.d.ts +3 -3
  316. package/dist/facet-button/web/ds-facet-button.d.ts +1 -1
  317. package/dist/facet-button/web/ds-facet-button.js +4 -10
  318. package/dist/facet-menu/web/ds-facet-menu-row.d.ts +1 -1
  319. package/dist/facet-menu/web/ds-facet-menu.js +5 -4
  320. package/dist/fact/fact.d.ts +2 -2
  321. package/dist/fact/fact.js +1 -1
  322. package/dist/fact/native/ds-fact.js +3 -2
  323. package/dist/field-rules/field-rules.d.ts +9 -9
  324. package/dist/figure/figure.d.ts +1 -1
  325. package/dist/figure/figure.js +1 -1
  326. package/dist/figure/native/ds-figure.js +4 -3
  327. package/dist/file-dropzone/file-dropzone.d.ts +10 -10
  328. package/dist/file-dropzone/web/ds-file-dropzone.d.ts +2 -2
  329. package/dist/file-dropzone/web/ds-file-dropzone.js +3 -2
  330. package/dist/file-field/file-field.d.ts +4 -4
  331. package/dist/file-field/web/ds-file-field.d.ts +4 -4
  332. package/dist/file-field/web/ds-file-field.js +2 -1
  333. package/dist/file-import/file-import.d.ts +8 -8
  334. package/dist/file-import/file-import.js +1 -1
  335. package/dist/file-import/web/ds-file-import.d.ts +2 -2
  336. package/dist/file-import/web/ds-file-import.js +1 -1
  337. package/dist/file-upload/file-upload.d.ts +13 -13
  338. package/dist/file-upload/file-upload.js +1 -1
  339. package/dist/file-upload/web/ds-file-upload.d.ts +3 -1
  340. package/dist/file-upload/web/ds-file-upload.js +4 -4
  341. package/dist/filter-bar/filter-bar.d.ts +4 -4
  342. package/dist/filter-bar/web/ds-filter-bar.d.ts +2 -2
  343. package/dist/filter-bar/web/ds-filter-bar.js +2 -1
  344. package/dist/filter-button/filter-button.d.ts +7 -7
  345. package/dist/filter-button/web/ds-filter-button.d.ts +1 -1
  346. package/dist/filter-chip/filter-chip.d.ts +12 -12
  347. package/dist/filter-chip/web/ds-filter-chip.d.ts +1 -1
  348. package/dist/filter-chip/web/ds-filter-chip.js +4 -4
  349. package/dist/filter-popover/filter-popover.d.ts +3 -0
  350. package/dist/filter-popover/web/ds-filter-popover.d.ts +2 -2
  351. package/dist/filter-popover/web/ds-filter-popover.js +9 -4
  352. package/dist/form-field-group/form-field-group.d.ts +7 -7
  353. package/dist/form-field-group/web/ds-form-field-group.js +1 -1
  354. package/dist/form-section/form-section.d.ts +1 -1
  355. package/dist/form-section/form-section.js +1 -1
  356. package/dist/form-section/web/ds-form-section.d.ts +2 -2
  357. package/dist/form-section/web/ds-form-section.js +3 -1
  358. package/dist/freshness-indicator/freshness-indicator.d.ts +4 -1
  359. package/dist/freshness-indicator/freshness-indicator.js +8 -2
  360. package/dist/freshness-indicator/web/ds-freshness-indicator.d.ts +1 -1
  361. package/dist/freshness-indicator/web/ds-freshness-indicator.js +4 -2
  362. package/dist/funnel/funnel.d.ts +4 -4
  363. package/dist/funnel/web/ds-funnel.d.ts +3 -3
  364. package/dist/funnel/web/ds-funnel.js +21 -28
  365. package/dist/gauge/gauge.d.ts +9 -3
  366. package/dist/gauge/gauge.js +11 -1
  367. package/dist/gauge/web/ds-gauge.d.ts +8 -3
  368. package/dist/gauge/web/ds-gauge.js +15 -8
  369. package/dist/geo/geo.d.ts +15 -15
  370. package/dist/geofence-editor/geofence-editor.d.ts +8 -8
  371. package/dist/geofence-editor/web/ds-geofence-editor.d.ts +6 -6
  372. package/dist/geofence-editor/web/ds-geofence-editor.js +18 -18
  373. package/dist/glass.d.ts +15 -15
  374. package/dist/glass.js +1 -1
  375. package/dist/gradient-card/gradient-card.d.ts +3 -3
  376. package/dist/gradient-card/web/ds-gradient-card.d.ts +2 -2
  377. package/dist/gradient-card/web/ds-gradient-card.js +1 -1
  378. package/dist/group-header/group-header.d.ts +1 -1
  379. package/dist/group-header/web/ds-group-header.d.ts +1 -1
  380. package/dist/group-header/web/ds-group-header.js +1 -1
  381. package/dist/heading/heading.d.ts +18 -0
  382. package/dist/heading/heading.js +14 -0
  383. package/dist/heading/native/ds-heading.d.ts +5 -0
  384. package/dist/heading/native/ds-heading.js +9 -0
  385. package/dist/heading/web/ds-heading.d.ts +5 -0
  386. package/dist/heading/web/ds-heading.js +10 -0
  387. package/dist/heatmap/heatmap.d.ts +15 -4
  388. package/dist/heatmap/heatmap.js +6 -0
  389. package/dist/heatmap/web/ds-heatmap.d.ts +4 -4
  390. package/dist/heatmap/web/ds-heatmap.js +24 -11
  391. package/dist/helper-text/helper-text.d.ts +13 -13
  392. package/dist/helper-text/helper-text.js +4 -4
  393. package/dist/helper-text/native/ds-helper-text.d.ts +1 -1
  394. package/dist/helper-text/web/ds-helper-text.d.ts +1 -1
  395. package/dist/histogram/histogram.d.ts +68 -0
  396. package/dist/histogram/histogram.js +79 -0
  397. package/dist/histogram/web/ds-histogram.d.ts +10 -0
  398. package/dist/histogram/web/ds-histogram.js +33 -0
  399. package/dist/hover-card/hover-card.d.ts +1 -1
  400. package/dist/hover-card/web/ds-hover-card.d.ts +1 -1
  401. package/dist/hover-card/web/ds-hover-card.js +3 -2
  402. package/dist/icon/web/ds-icon-provider.js +2 -1
  403. package/dist/icon-button/icon-button.d.ts +8 -8
  404. package/dist/icon-button/icon-button.js +1 -1
  405. package/dist/icon-button/native/ds-icon-button.js +2 -2
  406. package/dist/icon-button/web/ds-icon-button.d.ts +1 -1
  407. package/dist/icon-button/web/ds-icon-button.js +3 -3
  408. package/dist/icon-frame/icon-frame.d.ts +23 -9
  409. package/dist/icon-frame/icon-frame.js +6 -2
  410. package/dist/icon-frame/native/ds-icon-frame.d.ts +1 -1
  411. package/dist/icon-frame/native/ds-icon-frame.js +24 -7
  412. package/dist/icon-frame/web/ds-icon-frame.d.ts +2 -2
  413. package/dist/icon-frame/web/ds-icon-frame.js +25 -6
  414. package/dist/icon-toggle-group/web/ds-icon-toggle-group.d.ts +5 -1
  415. package/dist/icon-toggle-group/web/ds-icon-toggle-group.js +2 -2
  416. package/dist/ident/ident.d.ts +4 -4
  417. package/dist/ident/web/ds-ident.js +1 -1
  418. package/dist/impersonation-banner/impersonation-banner.d.ts +2 -2
  419. package/dist/impersonation-banner/impersonation-banner.js +2 -2
  420. package/dist/impersonation-banner/web/ds-impersonation-banner.d.ts +5 -5
  421. package/dist/impersonation-banner/web/ds-impersonation-banner.js +2 -1
  422. package/dist/index.d.ts +39 -11
  423. package/dist/index.js +24 -10
  424. package/dist/inline-edit/inline-edit.d.ts +5 -5
  425. package/dist/inline-edit/web/ds-inline-edit.d.ts +2 -2
  426. package/dist/inline-edit/web/ds-inline-edit.js +8 -6
  427. package/dist/input/input.d.ts +8 -8
  428. package/dist/input/input.js +1 -1
  429. package/dist/input/native/ds-input.js +2 -3
  430. package/dist/input/web/ds-input.d.ts +2 -2
  431. package/dist/input/web/ds-input.js +13 -10
  432. package/dist/interaction.d.ts +7 -7
  433. package/dist/interaction.js +2 -2
  434. package/dist/json-viewer/json-viewer.d.ts +17 -17
  435. package/dist/json-viewer/web/ds-json-viewer.d.ts +1 -1
  436. package/dist/json-viewer/web/ds-json-viewer.js +3 -2
  437. package/dist/kanban-board/kanban-board.d.ts +13 -13
  438. package/dist/kanban-board/web/ds-kanban-board.d.ts +1 -1
  439. package/dist/kanban-board/web/ds-kanban-board.js +6 -5
  440. package/dist/kbd/kbd.d.ts +6 -6
  441. package/dist/kbd/web/ds-kbd.js +2 -2
  442. package/dist/key-value-editor/key-value-editor.d.ts +15 -10
  443. package/dist/key-value-editor/web/ds-key-value-editor.d.ts +2 -2
  444. package/dist/key-value-editor/web/ds-key-value-editor.js +11 -8
  445. package/dist/keypad/keypad.d.ts +4 -4
  446. package/dist/keypad/native/ds-keypad.js +3 -2
  447. package/dist/keypad/web/ds-keypad.js +1 -1
  448. package/dist/label/label.d.ts +28 -28
  449. package/dist/label/label.js +6 -6
  450. package/dist/label/native/ds-label-group.js +5 -3
  451. package/dist/label/native/ds-label.d.ts +2 -2
  452. package/dist/label/native/ds-label.js +18 -13
  453. package/dist/label/web/ds-label-group.js +4 -3
  454. package/dist/label/web/ds-label.d.ts +2 -2
  455. package/dist/label/web/ds-label.js +17 -13
  456. package/dist/label-picker/label-picker.d.ts +9 -9
  457. package/dist/label-picker/native/ds-label-picker.js +8 -5
  458. package/dist/label-picker/web/ds-label-picker.js +7 -6
  459. package/dist/labeled-divider/web/ds-labeled-divider.js +2 -1
  460. package/dist/labeled-field/labeled-field.d.ts +6 -6
  461. package/dist/labeled-field/web/ds-labeled-field.d.ts +4 -4
  462. package/dist/labeled-field/web/ds-labeled-field.js +1 -1
  463. package/dist/leaderboard/leaderboard.d.ts +53 -0
  464. package/dist/leaderboard/leaderboard.js +35 -0
  465. package/dist/leaderboard/web/ds-leaderboard.d.ts +14 -0
  466. package/dist/leaderboard/web/ds-leaderboard.js +16 -0
  467. package/dist/legend/legend.d.ts +28 -3
  468. package/dist/legend/legend.js +4 -0
  469. package/dist/legend/web/ds-legend.d.ts +5 -2
  470. package/dist/legend/web/ds-legend.js +32 -23
  471. package/dist/lib/chart-context.d.ts +32 -0
  472. package/dist/lib/chart-context.js +18 -0
  473. package/dist/lib/chart-curve.js +7 -1
  474. package/dist/lib/chart-finish.d.ts +28 -18
  475. package/dist/lib/chart-finish.js +25 -22
  476. package/dist/lib/chart-hue.d.ts +4 -3
  477. package/dist/lib/chart-hue.js +1 -1
  478. package/dist/lib/chart-library.d.ts +1 -1
  479. package/dist/lib/chart-library.js +1 -1
  480. package/dist/lib/chart-palette.d.ts +7 -7
  481. package/dist/lib/chart-series.d.ts +52 -7
  482. package/dist/lib/chart-series.js +43 -1
  483. package/dist/lib/chart-table.d.ts +14 -0
  484. package/dist/lib/chart-table.js +14 -0
  485. package/dist/lib/chart-ticks.d.ts +24 -0
  486. package/dist/lib/chart-ticks.js +33 -0
  487. package/dist/lib/chart-value.d.ts +2 -0
  488. package/dist/lib/chart-value.js +6 -0
  489. package/dist/lib/cn.d.ts +2 -0
  490. package/dist/lib/cn.js +22 -24
  491. package/dist/lib/focus-order.d.ts +2 -2
  492. package/dist/lib/ink-child.d.ts +1 -1
  493. package/dist/lib/native/glass.d.ts +3 -3
  494. package/dist/lib/native/glass.js +1 -1
  495. package/dist/lib/native/text.d.ts +5 -0
  496. package/dist/lib/native/text.js +6 -0
  497. package/dist/lib/native/use-large-text.d.ts +3 -0
  498. package/dist/lib/native/use-large-text.js +9 -0
  499. package/dist/lib/overlay-stack.d.ts +11 -11
  500. package/dist/lib/sets-type.d.ts +1 -0
  501. package/dist/lib/sets-type.js +5 -0
  502. package/dist/lib/use-theme-epoch.d.ts +4 -4
  503. package/dist/lib/use-theme-epoch.native.d.ts +7 -7
  504. package/dist/lib/web/assign-ref.d.ts +4 -0
  505. package/dist/lib/web/assign-ref.js +6 -0
  506. package/dist/lib/web/chart-figures.d.ts +25 -0
  507. package/dist/lib/web/chart-figures.js +25 -0
  508. package/dist/lib/web/chart-finish.d.ts +20 -6
  509. package/dist/lib/web/chart-finish.js +16 -2
  510. package/dist/lib/web/density.js +5 -5
  511. package/dist/lib/web/focus-trap.d.ts +3 -3
  512. package/dist/lib/web/map-glass.js +2 -2
  513. package/dist/lib/web/scroll-lock.d.ts +1 -1
  514. package/dist/lib/web/use-anchored-surface.d.ts +6 -6
  515. package/dist/lib/web/use-chart-points.d.ts +23 -0
  516. package/dist/lib/web/use-chart-points.js +58 -0
  517. package/dist/lib/web/use-overlay.d.ts +3 -3
  518. package/dist/list-row/list-row.d.ts +6 -6
  519. package/dist/list-row/native/ds-list-row.js +5 -2
  520. package/dist/list-row/web/ds-list-row-group.d.ts +13 -0
  521. package/dist/list-row/web/ds-list-row-group.js +5 -0
  522. package/dist/list-row/web/ds-list-row.d.ts +15 -3
  523. package/dist/list-row/web/ds-list-row.js +12 -5
  524. package/dist/loading-screen/loading-screen.d.ts +10 -10
  525. package/dist/loading-screen/native/ds-loading-screen.d.ts +1 -1
  526. package/dist/loading-screen/native/ds-loading-screen.js +3 -2
  527. package/dist/loading-screen/web/ds-loading-screen.d.ts +1 -1
  528. package/dist/loading-screen/web/ds-loading-screen.js +3 -3
  529. package/dist/loading-state/loading-state.d.ts +9 -9
  530. package/dist/loading-state/web/ds-loading-state.js +1 -1
  531. package/dist/log-viewer/log-viewer.d.ts +20 -20
  532. package/dist/log-viewer/log-viewer.js +14 -2
  533. package/dist/log-viewer/web/ds-log-viewer.js +12 -3
  534. package/dist/map/map.d.ts +18 -18
  535. package/dist/map/map.js +2 -2
  536. package/dist/map/web/ds-map-fence.d.ts +2 -2
  537. package/dist/map/web/ds-map-fence.js +14 -13
  538. package/dist/map/web/ds-map-popup.d.ts +2 -2
  539. package/dist/map/web/ds-map-popup.js +1 -1
  540. package/dist/map/web/ds-map.d.ts +3 -3
  541. package/dist/map/web/ds-map.js +5 -4
  542. package/dist/map/web/map-provider.d.ts +7 -7
  543. package/dist/map-banner/map-banner.d.ts +4 -4
  544. package/dist/map-banner/map-banner.js +1 -1
  545. package/dist/map-banner/native/ds-map-banner.js +2 -2
  546. package/dist/map-banner/web/ds-map-banner.js +3 -2
  547. package/dist/map-controls/map-controls.d.ts +6 -6
  548. package/dist/map-controls/map-controls.js +1 -1
  549. package/dist/map-controls/native/ds-map-controls.d.ts +1 -1
  550. package/dist/map-controls/native/ds-map-controls.js +5 -4
  551. package/dist/map-controls/web/ds-map-controls.d.ts +1 -1
  552. package/dist/map-controls/web/ds-map-controls.js +4 -4
  553. package/dist/map-draw-toolbar/map-draw-toolbar.d.ts +3 -3
  554. package/dist/map-draw-toolbar/map-draw-toolbar.js +1 -1
  555. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.d.ts +1 -1
  556. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.js +3 -2
  557. package/dist/map-heatmap-layer/map-heatmap-layer.d.ts +25 -8
  558. package/dist/map-heatmap-layer/map-heatmap-layer.js +4 -0
  559. package/dist/map-heatmap-layer/web/ds-map-heatmap-layer.d.ts +19 -7
  560. package/dist/map-heatmap-layer/web/ds-map-heatmap-layer.js +15 -11
  561. package/dist/map-layers/map-layers.d.ts +1 -1
  562. package/dist/map-layers/map-layers.js +1 -1
  563. package/dist/map-layers/native/ds-map-layers.d.ts +1 -1
  564. package/dist/map-layers/native/ds-map-layers.js +4 -4
  565. package/dist/map-layers/web/ds-map-layers.d.ts +2 -2
  566. package/dist/map-layers/web/ds-map-layers.js +6 -5
  567. package/dist/map-list/map-list.d.ts +1 -1
  568. package/dist/map-list/web/ds-map-list.js +2 -2
  569. package/dist/map-marker/map-marker.d.ts +2 -2
  570. package/dist/map-marker/web/ds-map-marker.d.ts +1 -1
  571. package/dist/map-marker/web/ds-map-marker.js +4 -3
  572. package/dist/map-search/map-search.d.ts +2 -2
  573. package/dist/map-search/map-search.js +1 -1
  574. package/dist/map-search/native/ds-map-search.d.ts +1 -1
  575. package/dist/map-search/native/ds-map-search.js +4 -4
  576. package/dist/map-search/web/ds-map-search.d.ts +1 -1
  577. package/dist/map-search/web/ds-map-search.js +21 -14
  578. package/dist/map-search-area/map-search-area.d.ts +1 -1
  579. package/dist/map-search-area/map-search-area.js +1 -1
  580. package/dist/map-search-area/native/ds-map-search-area.d.ts +1 -1
  581. package/dist/map-search-area/native/ds-map-search-area.js +2 -2
  582. package/dist/map-search-area/web/ds-map-search-area.d.ts +1 -1
  583. package/dist/map-search-area/web/ds-map-search-area.js +3 -2
  584. package/dist/map-sheet/map-sheet.d.ts +7 -7
  585. package/dist/map-sheet/map-sheet.js +1 -1
  586. package/dist/map-sheet/native/ds-map-sheet.js +2 -2
  587. package/dist/map-sheet/web/ds-map-sheet.d.ts +1 -1
  588. package/dist/map-sheet/web/ds-map-sheet.js +14 -6
  589. package/dist/map-summary/web/ds-map-summary.d.ts +1 -1
  590. package/dist/map-summary/web/ds-map-summary.js +6 -3
  591. package/dist/measure.d.ts +3 -3
  592. package/dist/mention-input/mention-input.d.ts +13 -13
  593. package/dist/mention-input/native/ds-mention-input.d.ts +1 -1
  594. package/dist/mention-input/native/ds-mention-input.js +6 -3
  595. package/dist/mention-input/web/ds-mention-input.d.ts +3 -3
  596. package/dist/mention-input/web/ds-mention-input.js +9 -7
  597. package/dist/menu-button/web/ds-menu-button.d.ts +2 -2
  598. package/dist/menu-button/web/ds-menu-button.js +9 -3
  599. package/dist/merchant-avatar/merchant-avatar.d.ts +6 -3
  600. package/dist/merchant-avatar/merchant-avatar.js +8 -0
  601. package/dist/merchant-avatar/native/ds-merchant-avatar.js +10 -9
  602. package/dist/merchant-avatar/web/ds-merchant-avatar.js +8 -8
  603. package/dist/meter/meter.d.ts +8 -4
  604. package/dist/meter/meter.js +5 -0
  605. package/dist/meter/native/ds-meter.d.ts +1 -1
  606. package/dist/meter/native/ds-meter.js +6 -4
  607. package/dist/meter/web/ds-meter.d.ts +8 -2
  608. package/dist/meter/web/ds-meter.js +12 -5
  609. package/dist/metric/metric.d.ts +5 -5
  610. package/dist/metric/native/ds-metric.js +5 -3
  611. package/dist/metric/web/ds-metric.js +2 -1
  612. package/dist/metric-card/metric-card.d.ts +60 -0
  613. package/dist/metric-card/metric-card.js +18 -0
  614. package/dist/metric-card/web/ds-metric-card.d.ts +24 -0
  615. package/dist/metric-card/web/ds-metric-card.js +17 -0
  616. package/dist/month-picker/month-picker.d.ts +2 -0
  617. package/dist/month-picker/web/ds-month-picker.d.ts +1 -1
  618. package/dist/month-picker/web/ds-month-picker.js +5 -4
  619. package/dist/month-strip/month-strip.d.ts +2 -0
  620. package/dist/month-strip/web/ds-month-strip.d.ts +3 -3
  621. package/dist/month-strip/web/ds-month-strip.js +12 -7
  622. package/dist/morph/morph.d.ts +10 -10
  623. package/dist/morph/native/ds-morph.d.ts +1 -1
  624. package/dist/morph/native/morph-provider.d.ts +2 -2
  625. package/dist/morph/web/ds-morph.d.ts +4 -4
  626. package/dist/motion.d.ts +33 -33
  627. package/dist/motion.js +12 -12
  628. package/dist/multi-select/multi-select.d.ts +10 -10
  629. package/dist/multi-select/web/ds-multi-select.js +9 -8
  630. package/dist/native.d.ts +6 -0
  631. package/dist/native.js +3 -0
  632. package/dist/notification-list/native/ds-notification-list.d.ts +1 -1
  633. package/dist/notification-list/native/ds-notification-list.js +7 -4
  634. package/dist/notification-list/notification-list.d.ts +4 -4
  635. package/dist/notification-list/web/ds-notification-list.d.ts +1 -1
  636. package/dist/notification-list/web/ds-notification-list.js +6 -5
  637. package/dist/number-field/native/ds-number-field.js +15 -7
  638. package/dist/number-field/number-field.d.ts +7 -7
  639. package/dist/number-field/web/ds-number-field.js +8 -7
  640. package/dist/otp/native/ds-otp-field.d.ts +1 -1
  641. package/dist/otp/native/ds-otp-field.js +9 -3
  642. package/dist/otp/native/ds-otp.js +1 -1
  643. package/dist/otp/otp.d.ts +14 -10
  644. package/dist/otp/web/ds-otp-field.d.ts +2 -2
  645. package/dist/otp/web/ds-otp-field.js +6 -1
  646. package/dist/otp/web/ds-otp.d.ts +1 -1
  647. package/dist/otp/web/ds-otp.js +3 -3
  648. package/dist/overflow-menu/web/ds-overflow-menu.js +9 -3
  649. package/dist/page-head/page-head.d.ts +4 -4
  650. package/dist/page-head/web/ds-page-head.d.ts +5 -3
  651. package/dist/page-head/web/ds-page-head.js +6 -2
  652. package/dist/pagination/web/ds-pagination.js +2 -1
  653. package/dist/panel/native/ds-panel.js +7 -4
  654. package/dist/panel/panel.d.ts +14 -14
  655. package/dist/panel/panel.js +7 -7
  656. package/dist/panel/web/ds-panel.d.ts +7 -5
  657. package/dist/panel/web/ds-panel.js +4 -3
  658. package/dist/password-feedback/password-feedback.d.ts +3 -3
  659. package/dist/password-feedback/web/ds-password-feedback.js +2 -2
  660. package/dist/password-requirements/password-requirements.d.ts +5 -5
  661. package/dist/password-requirements/web/ds-password-requirements.js +1 -1
  662. package/dist/password-strength/password-strength.d.ts +5 -5
  663. package/dist/password-strength/web/ds-password-strength.d.ts +2 -2
  664. package/dist/password-strength/web/ds-password-strength.js +4 -2
  665. package/dist/payment-card/native/ds-payment-card.js +5 -2
  666. package/dist/payment-card/payment-card.d.ts +2 -2
  667. package/dist/payment-card/web/ds-payment-card.js +2 -1
  668. package/dist/people-cell/web/ds-people-cell.js +1 -1
  669. package/dist/person-cell/person-cell.d.ts +1 -1
  670. package/dist/phone-field/native/ds-phone-field.d.ts +1 -1
  671. package/dist/phone-field/native/ds-phone-field.js +6 -4
  672. package/dist/phone-field/phone-field.d.ts +13 -12
  673. package/dist/phone-field/phone-field.js +1 -1
  674. package/dist/phone-field/web/ds-phone-field.d.ts +3 -3
  675. package/dist/phone-field/web/ds-phone-field.js +15 -8
  676. package/dist/place-card/native/ds-place-card.js +15 -7
  677. package/dist/place-card/place-card.d.ts +18 -18
  678. package/dist/place-card/web/ds-place-card.js +18 -8
  679. package/dist/plan-chart/plan-chart.d.ts +68 -0
  680. package/dist/plan-chart/plan-chart.js +42 -0
  681. package/dist/plan-chart/web/ds-plan-chart.d.ts +10 -0
  682. package/dist/plan-chart/web/ds-plan-chart.js +35 -0
  683. package/dist/popover/native/ds-popover.d.ts +1 -1
  684. package/dist/popover/popover.d.ts +3 -3
  685. package/dist/popover/web/ds-popover.d.ts +1 -1
  686. package/dist/popover/web/ds-popover.js +2 -2
  687. package/dist/presence-indicator/native/ds-presence-indicator.js +4 -3
  688. package/dist/presence-indicator/presence-indicator.d.ts +3 -3
  689. package/dist/presence-indicator/web/ds-presence-indicator.js +2 -2
  690. package/dist/price-pin/native/ds-price-pin.js +3 -2
  691. package/dist/price-pin/price-pin.d.ts +7 -7
  692. package/dist/price-pin/web/ds-price-pin.js +2 -2
  693. package/dist/priority-indicator/native/ds-priority-indicator.d.ts +1 -1
  694. package/dist/priority-indicator/native/ds-priority-indicator.js +3 -2
  695. package/dist/priority-indicator/priority-indicator.d.ts +5 -5
  696. package/dist/priority-indicator/web/ds-priority-indicator.d.ts +1 -1
  697. package/dist/priority-indicator/web/ds-priority-indicator.js +1 -1
  698. package/dist/profile-card/profile-card.d.ts +1 -1
  699. package/dist/profile-card/web/ds-profile-card.d.ts +1 -1
  700. package/dist/profile-card/web/ds-profile-card.js +5 -3
  701. package/dist/progress-bar/native/ds-progress-bar.d.ts +1 -1
  702. package/dist/progress-bar/native/ds-progress-bar.js +1 -1
  703. package/dist/progress-bar/progress-bar.d.ts +8 -8
  704. package/dist/progress-bar/web/ds-progress-bar.d.ts +1 -1
  705. package/dist/progress-bar/web/ds-progress-bar.js +4 -4
  706. package/dist/progress-cell/progress-cell.js +1 -1
  707. package/dist/progress-cell/web/ds-progress-cell.js +4 -1
  708. package/dist/progress-ring/native/ds-progress-ring.js +5 -3
  709. package/dist/progress-ring/progress-ring.d.ts +5 -5
  710. package/dist/progress-ring/web/ds-progress-ring.d.ts +8 -2
  711. package/dist/progress-ring/web/ds-progress-ring.js +9 -3
  712. package/dist/promo-banner/web/ds-promo-banner.js +2 -1
  713. package/dist/proportion-bar/native/ds-proportion-bar.js +4 -3
  714. package/dist/proportion-bar/proportion-bar.d.ts +3 -3
  715. package/dist/proportion-bar/web/ds-proportion-bar.js +5 -5
  716. package/dist/props.d.ts +2 -2
  717. package/dist/provider-button/provider-button.d.ts +6 -6
  718. package/dist/provider-button/web/ds-provider-button.d.ts +8 -8
  719. package/dist/qr-code/qr-code.d.ts +12 -12
  720. package/dist/qr-code/qr-matrix.d.ts +4 -4
  721. package/dist/qr-code/qr-matrix.js +1 -1
  722. package/dist/quick-actions/native/ds-quick-actions.js +4 -3
  723. package/dist/quick-actions/quick-actions.d.ts +2 -2
  724. package/dist/quick-actions/web/ds-quick-actions.js +7 -4
  725. package/dist/radar-chart/radar-chart.d.ts +26 -9
  726. package/dist/radar-chart/radar-chart.js +20 -7
  727. package/dist/radar-chart/web/ds-radar-chart.js +11 -24
  728. package/dist/radial-progress/native/ds-radial-progress.js +18 -20
  729. package/dist/radial-progress/radial-progress.d.ts +10 -10
  730. package/dist/radial-progress/radial-progress.js +1 -1
  731. package/dist/radial-progress/web/ds-radial-progress.js +24 -22
  732. package/dist/radio/radio.d.ts +11 -11
  733. package/dist/radio/web/ds-radio.d.ts +1 -1
  734. package/dist/radio/web/ds-radio.js +9 -5
  735. package/dist/radio-group/radio-group.d.ts +5 -5
  736. package/dist/radio-group/web/ds-radio-group.d.ts +2 -2
  737. package/dist/rating-badge/rating-badge.js +4 -1
  738. package/dist/rating-badge/web/ds-rating-badge.js +1 -1
  739. package/dist/recipient-select/recipient-select.d.ts +8 -4
  740. package/dist/recipient-select/web/ds-recipient-select.d.ts +2 -2
  741. package/dist/recipient-select/web/ds-recipient-select.js +5 -4
  742. package/dist/record-panel/record-panel.d.ts +1 -1
  743. package/dist/record-panel/web/ds-record-panel.js +20 -12
  744. package/dist/recovery-actions/web/ds-recovery-actions.d.ts +1 -1
  745. package/dist/recovery-shell/web/ds-recovery-shell.js +1 -1
  746. package/dist/relative-time/native/ds-relative-time.js +2 -1
  747. package/dist/relative-time/relative-time.d.ts +4 -4
  748. package/dist/reorder-list/reorder-list.d.ts +2 -2
  749. package/dist/reorder-list/web/ds-reorder-list.js +3 -2
  750. package/dist/resend-control/resend-control.d.ts +3 -3
  751. package/dist/resend-control/web/ds-resend-control.js +1 -1
  752. package/dist/route-line/route-line.d.ts +4 -4
  753. package/dist/route-line/web/ds-route-line.js +1 -1
  754. package/dist/route-stops/route-stops.d.ts +1 -1
  755. package/dist/route-stops/web/ds-route-stops.js +6 -3
  756. package/dist/row-actions-cell/web/ds-row-actions-cell.d.ts +4 -2
  757. package/dist/row-actions-cell/web/ds-row-actions-cell.js +2 -2
  758. package/dist/rule-summary/rule-summary.d.ts +8 -8
  759. package/dist/rule-summary/web/ds-rule-summary.d.ts +5 -5
  760. package/dist/rule-summary/web/ds-rule-summary.js +3 -2
  761. package/dist/save-bar/save-bar.d.ts +3 -3
  762. package/dist/save-bar/save-bar.js +1 -1
  763. package/dist/save-bar/web/ds-save-bar.js +2 -1
  764. package/dist/scale.d.ts +19 -19
  765. package/dist/scanner/native/ds-scanner.d.ts +5 -5
  766. package/dist/scanner/native/ds-scanner.js +4 -4
  767. package/dist/scanner/scanner.d.ts +20 -13
  768. package/dist/scanner/scanner.js +12 -8
  769. package/dist/scatter-chart/scatter-chart.d.ts +48 -0
  770. package/dist/scatter-chart/scatter-chart.js +15 -0
  771. package/dist/scatter-chart/web/ds-scatter-chart.d.ts +9 -0
  772. package/dist/scatter-chart/web/ds-scatter-chart.js +34 -0
  773. package/dist/scrim.d.ts +2 -2
  774. package/dist/scrim.js +1 -1
  775. package/dist/search-field/search-field.d.ts +3 -3
  776. package/dist/search-field/web/ds-search-field.d.ts +1 -1
  777. package/dist/search-field/web/ds-search-field.js +25 -6
  778. package/dist/section/native/ds-section.d.ts +5 -0
  779. package/dist/section/native/ds-section.js +9 -0
  780. package/dist/section/section-context.d.ts +1 -0
  781. package/dist/section/section-context.js +2 -0
  782. package/dist/section/section.d.ts +9 -0
  783. package/dist/section/section.js +8 -0
  784. package/dist/section/web/ds-section.d.ts +5 -0
  785. package/dist/section/web/ds-section.js +8 -0
  786. package/dist/section-nav/section-nav.d.ts +7 -7
  787. package/dist/section-nav/web/ds-section-nav.d.ts +2 -2
  788. package/dist/section-nav/web/ds-section-nav.js +2 -2
  789. package/dist/segmented-control/native/ds-segmented-control.js +21 -9
  790. package/dist/segmented-control/segmented-control.d.ts +5 -5
  791. package/dist/segmented-control/web/ds-segmented-control.js +2 -2
  792. package/dist/select/native/ds-select.d.ts +3 -3
  793. package/dist/select/native/ds-select.js +7 -6
  794. package/dist/select/select.d.ts +14 -14
  795. package/dist/select/web/ds-select-option-labels.d.ts +1 -1
  796. package/dist/select/web/ds-select-option-labels.js +2 -1
  797. package/dist/select/web/ds-select.d.ts +9 -9
  798. package/dist/select/web/ds-select.js +37 -12
  799. package/dist/settings-directory/native/ds-settings-directory.js +4 -2
  800. package/dist/settings-directory/web/ds-settings-directory.js +2 -1
  801. package/dist/settings-row/native/ds-settings-row.d.ts +2 -2
  802. package/dist/settings-row/native/ds-settings-row.js +4 -3
  803. package/dist/settings-row/settings-row.d.ts +3 -3
  804. package/dist/settings-row/web/ds-settings-row-group.d.ts +17 -0
  805. package/dist/settings-row/web/ds-settings-row-group.js +7 -0
  806. package/dist/settings-row/web/ds-settings-row.d.ts +5 -3
  807. package/dist/settings-row/web/ds-settings-row.js +3 -2
  808. package/dist/setup-guide/setup-guide.d.ts +19 -15
  809. package/dist/setup-guide/setup-guide.js +1 -0
  810. package/dist/setup-guide/web/ds-setup-guide.d.ts +5 -2
  811. package/dist/setup-guide/web/ds-setup-guide.js +12 -17
  812. package/dist/sheet/native/ds-sheet.d.ts +2 -2
  813. package/dist/sheet/native/ds-sheet.js +2 -2
  814. package/dist/sheet/sheet.d.ts +15 -15
  815. package/dist/sheet/sheet.js +2 -2
  816. package/dist/sheet/web/ds-sheet.d.ts +3 -3
  817. package/dist/sheet/web/ds-sheet.js +4 -2
  818. package/dist/side-nav/side-nav.d.ts +38 -38
  819. package/dist/side-nav/web/ds-side-nav-header.d.ts +1 -1
  820. package/dist/side-nav/web/ds-side-nav-menu.d.ts +4 -4
  821. package/dist/side-nav/web/ds-side-nav-notifications.d.ts +3 -3
  822. package/dist/side-nav/web/ds-side-nav-notifications.js +2 -1
  823. package/dist/side-nav/web/ds-side-nav-primary.d.ts +2 -2
  824. package/dist/side-nav/web/ds-side-nav-primary.js +1 -1
  825. package/dist/side-nav/web/ds-side-nav-profile.d.ts +2 -2
  826. package/dist/side-nav/web/ds-side-nav-profile.js +2 -1
  827. package/dist/side-nav/web/ds-side-nav-search.d.ts +1 -1
  828. package/dist/side-nav/web/ds-side-nav-search.js +1 -1
  829. package/dist/side-nav/web/ds-side-nav.d.ts +11 -11
  830. package/dist/side-nav/web/ds-side-nav.js +8 -7
  831. package/dist/skeleton/native/ds-skeleton.js +10 -8
  832. package/dist/skeleton/skeleton.d.ts +25 -25
  833. package/dist/skeleton/skeleton.js +15 -15
  834. package/dist/skeleton/web/ds-skeleton.js +44 -20
  835. package/dist/slider/native/ds-slider.js +3 -2
  836. package/dist/slider/slider.d.ts +6 -6
  837. package/dist/slider/web/ds-slider.js +2 -2
  838. package/dist/small-multiples/small-multiples.d.ts +49 -0
  839. package/dist/small-multiples/small-multiples.js +40 -0
  840. package/dist/small-multiples/web/ds-small-multiples.d.ts +10 -0
  841. package/dist/small-multiples/web/ds-small-multiples.js +21 -0
  842. package/dist/sparkline/sparkline.d.ts +8 -4
  843. package/dist/sparkline/sparkline.js +2 -2
  844. package/dist/sparkline/web/ds-sparkline.js +0 -2
  845. package/dist/spinner/spinner.d.ts +3 -3
  846. package/dist/split-pane/split-pane.d.ts +13 -13
  847. package/dist/split-pane/web/ds-split-pane.d.ts +2 -2
  848. package/dist/split-pane/web/ds-split-pane.js +3 -3
  849. package/dist/stat-tile/native/ds-stat-tile.d.ts +1 -1
  850. package/dist/stat-tile/native/ds-stat-tile.js +5 -7
  851. package/dist/stat-tile/stat-tile.d.ts +14 -12
  852. package/dist/stat-tile/stat-tile.js +5 -4
  853. package/dist/stat-tile/web/ds-stat-tile.d.ts +5 -2
  854. package/dist/stat-tile/web/ds-stat-tile.js +6 -5
  855. package/dist/state-message/state-message.d.ts +1 -1
  856. package/dist/state-message/state-message.js +7 -1
  857. package/dist/state-message/web/ds-state-message.js +1 -1
  858. package/dist/status-badge/native/ds-status-badge.js +2 -2
  859. package/dist/status-badge/status-badge.d.ts +3 -3
  860. package/dist/status-badge/web/ds-status-badge.d.ts +6 -6
  861. package/dist/status-badge/web/ds-status-badge.js +2 -2
  862. package/dist/status-cell/web/ds-status-cell.d.ts +1 -1
  863. package/dist/status-cell/web/ds-status-cell.js +3 -2
  864. package/dist/status-control/status-control.d.ts +11 -9
  865. package/dist/status-control/status-control.js +1 -1
  866. package/dist/status-control/web/ds-status-control.d.ts +1 -1
  867. package/dist/status-control/web/ds-status-control.js +3 -3
  868. package/dist/status-dot/native/ds-status-dot.d.ts +1 -1
  869. package/dist/status-dot/native/ds-status-dot.js +4 -2
  870. package/dist/status-dot/status-dot.d.ts +11 -11
  871. package/dist/status-dot/web/ds-status-dot.d.ts +1 -1
  872. package/dist/status-dot/web/ds-status-dot.js +4 -2
  873. package/dist/status-vocabularies.d.ts +2 -2
  874. package/dist/stepper-form/stepper-form.d.ts +7 -7
  875. package/dist/stepper-form/web/ds-stepper-form.d.ts +3 -3
  876. package/dist/stepper-form/web/ds-stepper-form.js +3 -2
  877. package/dist/steps/steps.d.ts +20 -7
  878. package/dist/steps/steps.js +2 -1
  879. package/dist/steps/web/ds-steps.d.ts +1 -1
  880. package/dist/steps/web/ds-steps.js +58 -15
  881. package/dist/stick-chart/stick-chart.d.ts +2 -2
  882. package/dist/stick-chart/web/ds-stick-chart.d.ts +2 -2
  883. package/dist/stick-chart/web/ds-stick-chart.js +13 -10
  884. package/dist/switch/switch.d.ts +2 -2
  885. package/dist/switch/web/ds-switch.js +1 -1
  886. package/dist/system-state/system-state.d.ts +1 -1
  887. package/dist/system-state/web/ds-system-state.d.ts +1 -1
  888. package/dist/system-state/web/ds-system-state.js +2 -1
  889. package/dist/table-toolbar/web/ds-table-toolbar.d.ts +3 -4
  890. package/dist/table-toolbar/web/ds-table-toolbar.js +20 -4
  891. package/dist/tabs/tabs.d.ts +10 -6
  892. package/dist/tabs/tabs.js +13 -4
  893. package/dist/tabs/web/ds-tabs.d.ts +1 -1
  894. package/dist/tabs/web/ds-tabs.js +9 -6
  895. package/dist/task/web/ds-task-editor.d.ts +3 -3
  896. package/dist/task/web/ds-task-editor.js +2 -2
  897. package/dist/task-shell/task-shell.d.ts +17 -13
  898. package/dist/task-shell/task-shell.js +2 -1
  899. package/dist/task-shell/web/ds-task-shell.d.ts +9 -9
  900. package/dist/task-shell/web/ds-task-shell.js +12 -5
  901. package/dist/text/native/ds-text.d.ts +5 -1
  902. package/dist/text/native/ds-text.js +12 -10
  903. package/dist/text/text.d.ts +88 -46
  904. package/dist/text/text.js +76 -41
  905. package/dist/text/web/ds-text.d.ts +1 -1
  906. package/dist/text/web/ds-text.js +16 -10
  907. package/dist/textarea/native/ds-textarea.js +7 -6
  908. package/dist/textarea/web/ds-textarea.js +10 -8
  909. package/dist/time-range/time-range.d.ts +8 -4
  910. package/dist/time-range/web/ds-time-range.d.ts +1 -1
  911. package/dist/time-range/web/ds-time-range.js +23 -9
  912. package/dist/timeline/native/ds-timeline.d.ts +1 -1
  913. package/dist/timeline/native/ds-timeline.js +6 -4
  914. package/dist/timeline/timeline.d.ts +9 -9
  915. package/dist/timeline/web/ds-timeline.d.ts +3 -3
  916. package/dist/timeline/web/ds-timeline.js +4 -3
  917. package/dist/toast/native/ds-toast.js +1 -1
  918. package/dist/toast/toast.d.ts +4 -4
  919. package/dist/toggle-group/toggle-group.d.ts +6 -6
  920. package/dist/token-roles.d.ts +2 -2
  921. package/dist/token-roles.js +21 -4
  922. package/dist/tone.d.ts +9 -9
  923. package/dist/tone.js +1 -1
  924. package/dist/toolbar/toolbar.d.ts +2 -2
  925. package/dist/toolbar/web/ds-toolbar.d.ts +1 -1
  926. package/dist/toolbar/web/ds-toolbar.js +1 -1
  927. package/dist/tooltip/tooltip.d.ts +11 -11
  928. package/dist/tooltip/tooltip.js +4 -4
  929. package/dist/tooltip/web/ds-tooltip.d.ts +4 -4
  930. package/dist/tooltip/web/ds-tooltip.js +1 -1
  931. package/dist/track-bars/track-bars.d.ts +49 -0
  932. package/dist/track-bars/track-bars.js +22 -0
  933. package/dist/track-bars/web/ds-track-bars.d.ts +8 -0
  934. package/dist/track-bars/web/ds-track-bars.js +24 -0
  935. package/dist/trail-line/trail-line.d.ts +12 -12
  936. package/dist/trail-line/trail-line.js +1 -1
  937. package/dist/trail-line/web/ds-trail-line.d.ts +2 -2
  938. package/dist/trail-line/web/ds-trail-line.js +13 -12
  939. package/dist/tree/tree.d.ts +11 -11
  940. package/dist/tree/web/ds-tree.d.ts +1 -1
  941. package/dist/tree/web/ds-tree.js +5 -4
  942. package/dist/treemap/treemap.d.ts +40 -0
  943. package/dist/treemap/treemap.js +74 -0
  944. package/dist/treemap/web/ds-treemap.d.ts +14 -0
  945. package/dist/treemap/web/ds-treemap.js +29 -0
  946. package/dist/trip-replay/trip-replay.d.ts +12 -12
  947. package/dist/trip-replay/web/ds-trip-replay.d.ts +1 -1
  948. package/dist/trip-replay/web/ds-trip-replay.js +2 -1
  949. package/dist/two-line-cell/web/ds-two-line-cell.js +1 -1
  950. package/dist/value-row/native/ds-value-row.js +7 -2
  951. package/dist/value-row/value-row.d.ts +3 -3
  952. package/dist/vehicle-marker/vehicle-marker.d.ts +10 -10
  953. package/dist/vehicle-marker/web/ds-vehicle-marker.d.ts +1 -1
  954. package/dist/vehicle-marker/web/ds-vehicle-marker.js +4 -2
  955. package/dist/waterfall-chart/waterfall-chart.d.ts +55 -0
  956. package/dist/waterfall-chart/waterfall-chart.js +44 -0
  957. package/dist/waterfall-chart/web/ds-waterfall-chart.d.ts +14 -0
  958. package/dist/waterfall-chart/web/ds-waterfall-chart.js +31 -0
  959. package/dist/web.d.ts +36 -2
  960. package/dist/web.js +18 -1
  961. package/dist/week-schedule/web/ds-week-schedule.d.ts +1 -1
  962. package/dist/week-schedule/web/ds-week-schedule.js +5 -4
  963. package/dist/week-schedule/week-schedule.d.ts +4 -4
  964. package/dist/week-schedule/week-schedule.js +5 -2
  965. package/forced-colors.css +35 -35
  966. package/package.json +4 -4
  967. package/styles.css +2 -2
@@ -65,4 +65,4 @@ export function reasonFor(row) {
65
65
  return reason === '' ? UNSTATED_REASON : reason;
66
66
  }
67
67
  export const FILE_IMPORT_NEEDS_A_LABEL = 'A bulk import with no accessible name is announced as an unlabelled group. Pass aria-label or ' +
68
- 'aria-labelledby — "Import vehicles", "Import drivers", "Import cost centres".';
68
+ 'aria-labelledby, for example "Import vehicles", "Import drivers" or "Import cost centres".';
@@ -2,7 +2,7 @@ import { type ComponentProps } from 'react';
2
2
  import { type FileFact, type FileUploadHeadingLevel, type RejectionReason, type UploadPhase } from '../../file-upload/file-upload';
3
3
  import { type ImportRow } from '../file-import';
4
4
  export type DSFileImportProps = Omit<ComponentProps<'div'>, 'role'> & {
5
- /** What is being imported — "Import vehicles". Names the group. */
5
+ /** What is being imported, "Import vehicles". Names the group. */
6
6
  'aria-label': string;
7
7
  /** Where the upload is. Controlled, for the reasons `DSFileUpload` gives. */
8
8
  phase: UploadPhase;
@@ -20,7 +20,7 @@ export type DSFileImportProps = Omit<ComponentProps<'div'>, 'role'> & {
20
20
  maxBytes?: number;
21
21
  onFileAccepted: (file: File) => void;
22
22
  onFileRejected?: (reason: RejectionReason, message: string, file: FileFact) => void;
23
- /** The level of the "Row by row" title, and of the upload's own "Earlier
23
+ /** The level of the "Row by row" title and of the upload's own "Earlier
24
24
  * versions" title, so they sit right in the page's outline. An `h3` unless told. */
25
25
  headingLevel?: FileUploadHeadingLevel;
26
26
  };
@@ -42,5 +42,5 @@ export function DSFileImport({ phase, templateHref, templateName, file = null, p
42
42
  lastSaid.current = said;
43
43
  announceLive(said);
44
44
  }, [said, phase]);
45
- return (_jsxs("div", { role: "group", className: cn('flex flex-col gap-4', className), ...props, children: [_jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [_jsx(DSButton, { variant: "outline", asChild: true, children: _jsxs("a", { href: templateHref, download: templateName, children: [_jsx(Download, { "aria-hidden": "true", className: "size-4" }), "Download template"] }) }), _jsx(DSText, { as: "span", variant: "caption", tone: "muted", children: "Start from the template. Its columns are the ones this reads." })] }), _jsx(DSFileUpload, { "aria-label": "Spreadsheet", headingLevel: headingLevel, phase: phase, accept: IMPORT_ACCEPT, file: file, progress: progress, ...(error === undefined ? {} : { error }), ...(maxBytes === undefined ? {} : { maxBytes }), onFileAccepted: onFileAccepted, ...(onFileRejected === undefined ? {} : { onFileRejected }) }), summary !== null && kind !== null && (_jsxs("div", { id: summaryId, className: cn('rounded-card border p-4', SUMMARY_SURFACE[resultTone(kind)]), children: [_jsx(DSText, { as: "p", variant: "body", tone: "default", children: announceSummary(summary) }), kind === 'partial' && (_jsxs(DSText, { as: "p", variant: "caption", tone: "muted", className: "mt-1", children: ["The ", String(summary.accepted), " that worked have been kept. Fix the rows below in your sheet and import those again."] }))] })), rows !== null && rows.length > 0 && (_jsxs("div", { children: [_jsx(DSText, { as: `h${String(headingLevel)}`, id: tableId, variant: "caption", tone: "muted", className: "mb-1", children: "Row by row" }), _jsxs("table", { "aria-labelledby": tableId, className: "w-full border-collapse text-body-sm text-foreground", children: [_jsx("thead", { children: _jsxs("tr", { className: "border-b border-border text-left text-muted-foreground", children: [_jsx("th", { scope: "col", className: "py-2 pr-3 font-semibold", children: "Row" }), _jsx("th", { scope: "col", className: "py-2 pr-3 font-semibold", children: "In the sheet" }), _jsx("th", { scope: "col", className: "py-2 pr-3 font-semibold", children: "Outcome" }), _jsx("th", { scope: "col", className: "py-2 font-semibold", children: "Why" })] }) }), _jsx("tbody", { children: orderRows(rows).map((row) => (_jsxs("tr", { className: "border-b border-border", children: [_jsx("td", { className: "py-2 pr-3 tabular-nums", children: row.line }), _jsx("td", { className: "py-2 pr-3", children: row.label }), _jsx("td", { className: "py-2 pr-3", children: _jsx(DSStatusBadge, { tone: OUTCOME_TONE[row.outcome], children: OUTCOME_WORD[row.outcome] }) }), _jsx("td", { className: "py-2 text-muted-foreground", children: row.outcome === 'rejected' ? reasonFor(row) : '' })] }, row.line))) })] })] })), kind !== null && !keepsAcceptedRows(kind) && rows !== null && rows.length > 0 && (_jsx(DSText, { as: "p", variant: "caption", tone: "muted", children: "Nothing was imported, so nothing needs undoing." }))] }));
45
+ return (_jsxs("div", { role: "group", className: cn('flex flex-col gap-4', className), ...props, children: [_jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [_jsx(DSButton, { variant: "outline", asChild: true, children: _jsxs("a", { href: templateHref, download: templateName, children: [_jsx(Download, { "aria-hidden": "true", className: "size-4" }), "Download template"] }) }), _jsx(DSText, { as: "span", variant: "body-sm", tone: "muted", children: "Start from the template. Its columns are the ones this reads." })] }), _jsx(DSFileUpload, { "aria-label": "Spreadsheet", headingLevel: headingLevel, phase: phase, accept: IMPORT_ACCEPT, file: file, progress: progress, ...(error === undefined ? {} : { error }), ...(maxBytes === undefined ? {} : { maxBytes }), onFileAccepted: onFileAccepted, ...(onFileRejected === undefined ? {} : { onFileRejected }) }), summary !== null && kind !== null && (_jsxs("div", { id: summaryId, className: cn('rounded-card border p-4', SUMMARY_SURFACE[resultTone(kind)]), children: [_jsx(DSText, { as: "p", variant: "body-md", tone: "default", children: announceSummary(summary) }), kind === 'partial' && (_jsxs(DSText, { as: "p", variant: "body-sm", tone: "muted", className: "mt-1", children: ["The ", String(summary.accepted), " that worked have been kept. Fix the rows below in your sheet and import those again."] }))] })), rows !== null && rows.length > 0 && (_jsxs("div", { children: [_jsx(DSText, { as: `h${String(headingLevel)}`, id: tableId, variant: "body-sm", tone: "muted", className: "mb-1", children: "Row by row" }), _jsxs("table", { "aria-labelledby": tableId, className: "w-full border-collapse text-body-sm text-foreground", children: [_jsx("thead", { children: _jsxs("tr", { className: "border-b border-border text-left text-muted-foreground", children: [_jsx("th", { scope: "col", className: "py-2 pr-3 font-semibold", children: "Row" }), _jsx("th", { scope: "col", className: "py-2 pr-3 font-semibold", children: "In the sheet" }), _jsx("th", { scope: "col", className: "py-2 pr-3 font-semibold", children: "Outcome" }), _jsx("th", { scope: "col", className: "py-2 font-semibold", children: "Why" })] }) }), _jsx("tbody", { children: orderRows(rows).map((row) => (_jsxs("tr", { className: "border-b border-border", children: [_jsx("td", { className: "py-2 pr-3 tabular-nums", children: row.line }), _jsx("td", { className: "py-2 pr-3 [overflow-wrap:anywhere]", children: row.label }), _jsx("td", { className: "py-2 pr-3", children: _jsx(DSStatusBadge, { tone: OUTCOME_TONE[row.outcome], children: OUTCOME_WORD[row.outcome] }) }), _jsx("td", { className: "py-2 text-muted-foreground [overflow-wrap:anywhere]", children: row.outcome === 'rejected' ? reasonFor(row) : '' })] }, row.line))) })] })] })), kind !== null && !keepsAcceptedRows(kind) && rows !== null && rows.length > 0 && (_jsx(DSText, { as: "p", variant: "body-sm", tone: "muted", children: "Nothing was imported, so nothing needs undoing." }))] }));
46
46
  }
@@ -5,7 +5,7 @@ export interface FileFact {
5
5
  /** Size in bytes. Zero is a real answer and a rejected one. */
6
6
  size: number;
7
7
  /**
8
- * The MIME type the browser guessed. Often `''` — Windows hands over an empty
8
+ * The MIME type the browser guessed. Often `''`, Windows hands over an empty
9
9
  * type for `.csv` more often than not, which is why the extension is checked
10
10
  * as well and why an empty type is never on its own a rejection.
11
11
  */
@@ -21,8 +21,8 @@ export interface AcceptSpec {
21
21
  /**
22
22
  * The ceiling, in bytes.
23
23
  *
24
- * 10 MB, and it is a DECISION rather than a measurement: the documents this
25
- * slot exists for are a KYC certificate, a proof of address, a signed mandate —
24
+ * 10 MB and it is a DECISION rather than a measurement: the documents this
25
+ * slot exists for are a KYC certificate, a proof of address, a signed mandate,
26
26
  * scans, a few pages each. A phone camera photograph of an ID is comfortably
27
27
  * inside it and a 40-page scanned contract at 300 dpi is not, which is the line
28
28
  * that wants drawing. A caller with a different ceiling passes one.
@@ -36,7 +36,7 @@ export declare function extensionOf(name: string): string;
36
36
  * A size as a person reads it.
37
37
  *
38
38
  * 1024-BASED, LABELLED KB/MB. Not the SI kilobyte. The number a person will
39
- * compare this against is the one their file manager showed them, and Windows
39
+ * compare this against is the one their file manager showed them and Windows
40
40
  * Explorer, macOS's Get Info and every mail client divide by 1024. Being
41
41
  * correct about SI here would mean telling somebody their 9.8 MB file is 10.2
42
42
  * MB and over a 10 MB limit.
@@ -49,7 +49,7 @@ export type RejectionReason = 'type' | 'size' | 'empty';
49
49
  *
50
50
  * ORDER MATTERS AND IT IS EMPTY, TYPE, SIZE. A 0-byte `.exe` is refused for
51
51
  * being empty rather than for being an `.exe`, because "this file is empty" is
52
- * the fact that will actually help — a failed export and a wrong file are
52
+ * the fact that will actually help, a failed export and a wrong file are
53
53
  * different mistakes with different fixes.
54
54
  */
55
55
  export declare function checkFile(file: FileFact, spec: AcceptSpec, maxBytes?: number): RejectionReason | null;
@@ -58,17 +58,17 @@ export declare function checkFile(file: FileFact, spec: AcceptSpec, maxBytes?: n
58
58
  *
59
59
  * Every one of these names the FILE and the LIMIT, because a message that says
60
60
  * only "invalid file" leaves somebody to guess which of the two things they got
61
- * wrong, and they will guess the other one.
61
+ * wrong and they will guess the other one.
62
62
  */
63
63
  export declare function rejectionMessage(reason: RejectionReason, file: FileFact, spec: AcceptSpec, maxBytes?: number): string;
64
- /** `.pdf, .png or .jpg` — an Oxford-free list, because this is a sentence and not a spec. */
64
+ /** `.pdf, .png or .jpg`, an Oxford-free list, because this is a sentence and not a spec. */
65
65
  export declare function listKinds(spec: AcceptSpec): string;
66
66
  /**
67
67
  * Where the slot is.
68
68
  *
69
69
  * `offline` is a STATE and not an error, which is the distinction the story's
70
70
  * AC asks for. An upload that cannot start because the connection is gone is
71
- * not a rejected file — nothing about the file is wrong, and telling somebody
71
+ * not a rejected file, nothing about the file is wrong and telling somebody
72
72
  * to try a different one would be the wrong instruction.
73
73
  */
74
74
  export type UploadPhase = 'empty' | 'chosen' | 'uploading' | 'uploaded' | 'error' | 'offline';
@@ -79,7 +79,7 @@ export declare function clampProgress(percent: number): number;
79
79
  /**
80
80
  * What a screen reader is told while an upload runs.
81
81
  *
82
- * COARSE ON PURPOSE — every ten percent, and only then. A live region that
82
+ * COARSE ON PURPOSE, every ten percent and only then. A live region that
83
83
  * updates on every progress event interrupts itself into silence on some screen
84
84
  * readers and into a stutter on the rest; the caller sends whatever it has and
85
85
  * this decides whether it is worth saying.
@@ -87,9 +87,9 @@ export declare function clampProgress(percent: number): number;
87
87
  export declare function progressWorthAnnouncing(previous: number | null, next: number): boolean;
88
88
  /** "Uploading statement.pdf, 40 percent." */
89
89
  export declare function announceProgress(name: string, percent: number): string;
90
- /** An earlier file in the same slot: what it was, when it landed, and who put it there. */
90
+ /** An earlier file in the same slot: what it was, when it landed and who put it there. */
91
91
  export interface FileVersion extends FileFact {
92
- /** When it was uploaded. An instant, unlike a calendar date — see `../date-picker/date-picker.ts`. */
92
+ /** When it was uploaded. An instant, unlike a calendar date, see `../date-picker/date-picker.ts`. */
93
93
  uploadedAt: Date;
94
94
  /** Who uploaded it, as the audit trail names them. */
95
95
  actor: string;
@@ -97,9 +97,9 @@ export interface FileVersion extends FileFact {
97
97
  /**
98
98
  * Prior versions, newest first.
99
99
  *
100
- * NEWEST FIRST, and a stable tie-break by name so two versions uploaded in the
100
+ * NEWEST FIRST and a stable tie-break by name so two versions uploaded in the
101
101
  * same second do not swap places between renders. Sorting a copy rather than
102
- * the caller's array: this is handed a prop, and sorting a prop in place
102
+ * the caller's array: this is handed a prop and sorting a prop in place
103
103
  * mutates the caller's state from inside a render.
104
104
  */
105
105
  export declare function orderVersions(versions: readonly FileVersion[]): FileVersion[];
@@ -90,4 +90,4 @@ export function describeVersion(version) {
90
90
  export const FILE_UPLOAD_HEADING_LEVELS = [2, 3, 4, 5, 6];
91
91
  export const FILE_UPLOAD_DEFAULT_HEADING_LEVEL = 3;
92
92
  export const FILE_UPLOAD_NEEDS_A_LABEL = 'A file slot with no accessible name is announced as an unlabelled group. Pass aria-label or ' +
93
- 'aria-labelledby — "Proof of address", "Signed mandate", "Company registration".';
93
+ 'aria-labelledby, for example "Proof of address", "Signed mandate" or "Company registration".';
@@ -1,7 +1,9 @@
1
1
  import { type ComponentProps } from 'react';
2
2
  import { type AcceptSpec, type FileFact, type FileUploadHeadingLevel, type FileVersion, type RejectionReason, type UploadPhase } from '../file-upload';
3
3
  export type DSFileUploadProps = Omit<ComponentProps<'div'>, 'onChange' | 'onDrop' | 'onDragEnter' | 'onDragOver' | 'onDragLeave' | 'role'> & {
4
- /** What the slot is for — "Proof of address". Names the group; the button names itself. */
4
+ /** What the slot is for, "Proof of address". The group reads "Proof of address
5
+ * upload" and the button "Choose file, Proof of address", so neither repeats
6
+ * the name of a slot or form section the upload sits inside. */
5
7
  'aria-label': string;
6
8
  /** Where the slot is. Controlled: the caller owns the upload, so it owns the phase. */
7
9
  phase: UploadPhase;
@@ -81,7 +81,7 @@ export function DSFileUpload({ phase, accept, maxBytes = FILE_UPLOAD_MAX_BYTES,
81
81
  : phase === 'uploaded' && file !== null
82
82
  ? announceProgress(file.name, 100)
83
83
  : '';
84
- return (_jsxs("div", { role: "group", className: cn('flex flex-col gap-3', className), ...props, children: [_jsxs("div", { "data-dragging": over || undefined, onDragEnter: (event) => {
84
+ return (_jsxs("div", { role: "group", className: cn('flex flex-col gap-3', className), ...props, "aria-label": `${label} upload`, children: [_jsxs("div", { "data-dragging": over || undefined, onDragEnter: (event) => {
85
85
  if (!carries(event))
86
86
  return;
87
87
  event.preventDefault();
@@ -100,10 +100,10 @@ export function DSFileUpload({ phase, accept, maxBytes = FILE_UPLOAD_MAX_BYTES,
100
100
  if (depth.current === 0)
101
101
  setOver(false);
102
102
  }, onDrop: onDrop, className: cn('flex flex-col items-center gap-3 rounded-card border border-dashed p-6 text-center transition-control', over
103
- ? 'border-primary bg-accent'
103
+ ? 'border-solid border-primary bg-accent'
104
104
  : open
105
105
  ? 'border-input bg-card'
106
- : 'border-disabled-border bg-disabled'), children: [_jsx(Icon, { "aria-hidden": "true", className: "size-6 text-muted-foreground" }), file === null ? (_jsxs(DSText, { as: "p", id: hintId, variant: "caption", tone: "muted", children: ["Drop a file here, or choose one. ", listKinds(accept), ", up to", ' ', formatFileSize(maxBytes), "."] })) : (_jsxs(DSText, { as: "p", variant: "caption", tone: "default", children: [_jsx("span", { className: "font-semibold", children: file.name }), " \u00B7 ", formatFileSize(file.size)] })), _jsxs("div", { className: "flex flex-wrap items-center justify-center gap-2", children: [_jsx(DSButton, { variant: "outline", asChild: true, disabled: !open, children: _jsxs("label", { htmlFor: inputId, className: cn('focusable-within', open ? 'cursor-pointer' : 'cursor-not-allowed'), children: [file === null ? 'Choose file' : 'Replace file', _jsx("input", { ref: input, id: inputId, type: "file", accept: acceptAttribute(accept), className: "sr-only", "aria-label": `${file === null ? 'Choose file' : 'Replace file'}, ${label}`, ...(open ? {} : { 'aria-disabled': true }), ...(uploading ? { 'aria-busy': true } : {}), "aria-describedby": describedBy, ...(invalid === undefined ? {} : { 'aria-invalid': invalid }), onClick: (event) => {
106
+ : 'border-disabled-border bg-disabled'), children: [_jsx(Icon, { "aria-hidden": "true", className: "size-6 text-muted-foreground" }), file === null ? (_jsxs(DSText, { as: "p", id: hintId, variant: "body-sm", tone: "muted", children: ["Drop a file here, or choose one. ", listKinds(accept), ", up to ", formatFileSize(maxBytes), "."] })) : (_jsxs(DSText, { as: "p", variant: "body-sm", tone: "default", className: "max-w-full [overflow-wrap:anywhere]", children: [_jsx("span", { className: "font-semibold", children: file.name }), " \u00B7 ", formatFileSize(file.size)] })), _jsxs("div", { className: "flex flex-wrap items-center justify-center gap-2", children: [_jsx(DSButton, { variant: "outline", asChild: true, disabled: !open, children: _jsxs("label", { htmlFor: inputId, className: cn('focusable-within', open ? 'cursor-pointer' : 'cursor-not-allowed'), children: [file === null ? 'Choose file' : 'Replace file', _jsx("input", { ref: input, id: inputId, type: "file", accept: acceptAttribute(accept), className: "sr-only", "aria-label": `${file === null ? 'Choose file' : 'Replace file'}, ${label}`, ...(open ? {} : { 'aria-disabled': true }), ...(uploading ? { 'aria-busy': true } : {}), "aria-describedby": describedBy, ...(invalid === undefined ? {} : { 'aria-invalid': invalid }), onClick: (event) => {
107
107
  if (!open)
108
108
  event.preventDefault();
109
109
  }, onChange: (event) => {
@@ -113,5 +113,5 @@ export function DSFileUpload({ phase, accept, maxBytes = FILE_UPLOAD_MAX_BYTES,
113
113
  } })] }) }), onRemove !== undefined && file !== null && open && (_jsx(DSIconButton, { variant: "ghost", size: "sm", label: aiAttachmentRemoveLabel(file.name), icon: _jsx(X, { "aria-hidden": true }), onClick: () => {
114
114
  onRemove();
115
115
  input.current?.focus();
116
- } }))] })] }), uploading && (_jsxs("div", { className: "flex items-center gap-3", children: [_jsx(DSMeter, { value: percent, max: 100, label: `Uploading ${file?.name ?? label}`, className: "min-w-0 flex-1" }), _jsxs(DSText, { as: "span", variant: "caption", tone: "muted", children: [String(percent), "%"] })] })), _jsx("p", { id: statusId, className: "sr-only", "aria-live": "polite", children: status }), message !== null && (_jsx(DSHelperText, { id: messageId, tone: "error", announce: true, children: message })), versions.length > 0 && (_jsxs("div", { children: [_jsx(DSText, { as: `h${String(headingLevel)}`, id: versionsId, variant: "caption", tone: "muted", className: "mb-1", children: "Earlier versions" }), _jsx("ul", { "aria-labelledby": versionsId, className: "flex flex-col gap-1", children: orderVersions(versions).map((version) => (_jsx("li", { className: "text-body-sm text-muted-foreground", children: describeVersion(version) }, `${version.name}-${String(version.uploadedAt.getTime())}`))) })] }))] }));
116
+ } }))] })] }), uploading && (_jsxs("div", { className: "flex items-center gap-3", children: [_jsx(DSMeter, { value: percent, max: 100, label: `Uploading ${file?.name ?? label}`, className: "min-w-0 flex-1" }), _jsxs(DSText, { as: "span", variant: "body-sm", tone: "muted", children: [String(percent), "%"] })] })), _jsx("p", { id: statusId, className: "sr-only", "aria-live": "polite", children: status }), message !== null && (_jsx(DSHelperText, { id: messageId, tone: "error", announce: true, children: message })), versions.length > 0 && (_jsxs("div", { children: [_jsx(DSText, { as: `h${String(headingLevel)}`, id: versionsId, variant: "body-sm", tone: "muted", className: "mb-1", children: "Earlier versions" }), _jsx("ul", { "aria-labelledby": versionsId, className: "flex flex-col gap-1", children: orderVersions(versions).map((version) => (_jsx("li", { className: "text-body-sm text-muted-foreground", children: describeVersion(version) }, `${version.name}-${String(version.uploadedAt.getTime())}`))) })] }))] }));
117
117
  }
@@ -1,5 +1,5 @@
1
1
  import type { Forwarded } from '../props';
2
- /** How a count names what it counts — "1 vehicle", "1 284 vehicles". */
2
+ /** How a count names what it counts, "1 vehicle", "1 284 vehicles". */
3
3
  export interface FilterBarNoun {
4
4
  one: string;
5
5
  other: string;
@@ -26,14 +26,14 @@ export type FilterBarFocusTarget = {
26
26
  *
27
27
  * The one that took its place, else the one before it, else "Add filter".
28
28
  * A `removedIndex` of `undefined` means focus was on something else that also
29
- * went — "Clear" — and goes to "Add filter", which is the next thing to do. */
29
+ * went, "Clear" and goes to "Add filter", which is the next thing to do. */
30
30
  export declare function filterBarFocusAfterRemoval(removedIndex: number | undefined, remaining: number): FilterBarFocusTarget;
31
31
  export declare const FILTER_BAR_COUNT_INK = "muted-foreground";
32
32
  export type FilterBarCountInkRole = typeof FILTER_BAR_COUNT_INK;
33
33
  export interface FilterBarResolvedSpec {
34
34
  countInk: FilterBarCountInkRole;
35
35
  }
36
- /** The bar paints nothing of its own — it is a row on the page, not a panel —
36
+ /** The bar paints nothing of its own, it is a row on the page, not a panel,
37
37
  * so its one role is the quiet ink the count is set in. */
38
38
  export declare function filterBarSpec(): FilterBarResolvedSpec;
39
39
  /** The props every Filter Bar implementation accepts. */
@@ -42,7 +42,7 @@ export interface FilterBarContract {
42
42
  resultCount?: Forwarded<number>;
43
43
  /** How the count names what it counts. */
44
44
  resultNoun?: Forwarded<FilterBarNoun>;
45
- /** The saved view the filters started from — "All vehicles", "Declined this week". */
45
+ /** The saved view the filters started from, "All vehicles", "Declined this week". */
46
46
  viewName?: Forwarded<string>;
47
47
  /** Whether the saved-views menu is showing, forwarded to its trigger's `aria-expanded`. */
48
48
  viewExpanded?: Forwarded<boolean>;
@@ -15,12 +15,12 @@ export type DSFilterBarProps = Omit<ComponentProps<'div'>, 'role' | 'aria-label'
15
15
  clearLabel?: string;
16
16
  /** Reports a press on the saved-view trigger, with the trigger itself; absent hides the view. */
17
17
  onViewPress?: (trigger: HTMLButtonElement) => void;
18
- /** Names what the view trigger holds — the facet's own name, beside `viewName`. */
18
+ /** Names what the view trigger holds, the facet's own name, beside `viewName`. */
19
19
  viewLabel?: string;
20
20
  /** Reports a press on "Save view"; absent hides the control, so pass it only while the filters differ from the view. */
21
21
  onSaveView?: () => void;
22
22
  /** The save control's text. */
23
23
  saveViewLabel?: string;
24
24
  };
25
- /** The row holding a saved view, the filters applied on it, and the count they leave. */
25
+ /** The row holding a saved view, the filters applied on it and the count they leave. */
26
26
  export declare function DSFilterBar({ children, label, resultCount, resultNoun, viewName, viewExpanded, viewLabel, onViewPress, onSaveView, saveViewLabel, addFilterExpanded, addFilterLabel, onAddFilter, onClear, clearLabel, className, ...props }: DSFilterBarProps): import("react/jsx-runtime").JSX.Element;
@@ -6,6 +6,7 @@ import { FILTER_CHIP_ATTR } from '../../filter-chip/filter-chip';
6
6
  import { DSButton } from '../../button/web/ds-button';
7
7
  import { DSFacetButton } from '../../facet-button/web/ds-facet-button';
8
8
  import { cn } from '../../lib/cn';
9
+ import { DSText } from '../../text/web/ds-text';
9
10
  const COUNT_INK = {
10
11
  'muted-foreground': 'text-muted-foreground',
11
12
  };
@@ -58,5 +59,5 @@ export function DSFilterBar({ children, label = 'Filters', resultCount, resultNo
58
59
  onViewPress(event.currentTarget);
59
60
  } })), children, _jsxs(DSButton, { ref: addRef, variant: "ghost", size: "sm", "aria-haspopup": "menu", "aria-expanded": addFilterExpanded ?? false, onClick: (event) => {
60
61
  onAddFilter(event.currentTarget);
61
- }, children: [_jsx(Plus, { "aria-hidden": true, className: "size-4" }), addFilterLabel] }), showsClear && (_jsx(DSButton, { variant: "ghost", size: "sm", onClick: onClear, children: clearLabel })), _jsxs("div", { className: "ms-auto flex flex-wrap items-center gap-2", children: [_jsx("span", { role: "status", className: cn('text-body-sm tabular-nums', COUNT_INK[spec.countInk]), children: resultCount === undefined ? '' : filterBarResultLabel(resultCount, resultNoun) }), onSaveView !== undefined && (_jsx(DSButton, { variant: "outline", size: "sm", onClick: onSaveView, children: saveViewLabel }))] })] }));
62
+ }, children: [_jsx(Plus, { "aria-hidden": true, className: "size-4" }), addFilterLabel] }), showsClear && (_jsx(DSButton, { variant: "ghost", size: "sm", onClick: onClear, children: clearLabel })), _jsxs("div", { className: "ms-auto flex flex-wrap items-center gap-2", children: [_jsx(DSText, { as: "span", variant: "body-sm", role: "status", className: cn('tabular-nums', COUNT_INK[spec.countInk]), children: resultCount === undefined ? '' : filterBarResultLabel(resultCount, resultNoun) }), onSaveView !== undefined && (_jsx(DSButton, { variant: "outline", size: "sm", onClick: onSaveView, children: saveViewLabel }))] })] }));
62
63
  }
@@ -1,14 +1,14 @@
1
1
  import type { Forwarded } from '../props';
2
- /** The resting ink — the control is a neutral thing to press. */
2
+ /** The resting ink, the control is a neutral thing to press. */
3
3
  export declare const FILTER_BUTTON_INK = "foreground";
4
4
  export declare const FILTER_BUTTON_ACTIVE_INK = "accent-foreground";
5
- /** The faint ground under an active control. Read as `accent` — this package's
5
+ /** The faint ground under an active control. Read as `accent`, this package's
6
6
  * established "a brand tint, not a brand fill" role, the same one a hovered
7
7
  * control takes. A full `primary` fill here would outrank the page's actual
8
8
  * primary action, which is never what a filter is. */
9
9
  export declare const FILTER_BUTTON_ACTIVE_SURFACE = "accent";
10
- /** The edge, in both states. It does not move with the count — the ink and the
11
- * ground already carry the state, and a third channel saying the same thing is
10
+ /** The edge, in both states. It does not move with the count, the ink and the
11
+ * ground already carry the state and a third channel saying the same thing is
12
12
  * how a control starts shouting. */
13
13
  export declare const FILTER_BUTTON_BORDER = "input";
14
14
  export type FilterButtonInkRole = typeof FILTER_BUTTON_INK | typeof FILTER_BUTTON_ACTIVE_INK;
@@ -18,7 +18,7 @@ export interface FilterButtonResolvedSpec {
18
18
  /** Whether anything is filtering. Derived from the count, never passed in. */
19
19
  active: boolean;
20
20
  ink: FilterButtonInkRole;
21
- /** The tint under an active control. `undefined` at rest — absent rather than
21
+ /** The tint under an active control. `undefined` at rest, absent rather than
22
22
  * a "transparent" member, so an adapter cannot paint a ground by forgetting
23
23
  * to check. */
24
24
  surface?: FilterButtonSurfaceRole;
@@ -26,7 +26,7 @@ export interface FilterButtonResolvedSpec {
26
26
  }
27
27
  /** A count that is negative, fractional or not a number at all is treated as
28
28
  * none. Guarded here rather than in each adapter: a filter count arrives from
29
- * a list's own state, and `-1` for "not loaded yet" is a real thing screens do.
29
+ * a list's own state and `-1` for "not loaded yet" is a real thing screens do.
30
30
  * It must read as the resting control, never as a control claiming "-1 filter". */
31
31
  export declare function filterCount(count: number): number;
32
32
  /** Resolved recipe for a given count. The one function an adapter calls. */
@@ -35,7 +35,7 @@ export declare function filterButtonSpec(count: number): FilterButtonResolvedSpe
35
35
  *
36
36
  * ENGLISH LIVES HERE AND IS OVERRIDABLE, which is the honest shape for a
37
37
  * package with no translation layer. A caller that needs another language
38
- * passes `children` and this is not called — the contract is the STATE, and
38
+ * passes `children` and this is not called, the contract is the STATE and
39
39
  * the words are the caller's when they need to be. Exported and pure so the
40
40
  * pluralisation is tested directly rather than through a rendered button. */
41
41
  export declare function filterButtonLabel(count: number): string;
@@ -1,7 +1,7 @@
1
1
  import type { ComponentProps, ReactNode } from 'react';
2
2
  import { type FilterButtonContract } from '../filter-button';
3
3
  export type DSFilterButtonProps = Omit<ComponentProps<'button'>, 'children' | 'aria-expanded'> & FilterButtonContract & {
4
- /** Replaces the derived label. For a caller translating it — see
4
+ /** Replaces the derived label. For a caller translating it, see
5
5
  * `filterButtonLabel` on why English lives in the contract and is
6
6
  * overridable rather than absent. */
7
7
  children?: ReactNode;
@@ -9,20 +9,20 @@ export type FilterChipSegment = (typeof FILTER_CHIP_SEGMENTS)[number];
9
9
  export declare const FILTER_CHIP_MAX_LISTED = 2;
10
10
  /** The longest listed value text before it is summarised anyway.
11
11
  *
12
- * Two depot names can be longer than six statuses, and a count limit alone
12
+ * Two depot names can be longer than six statuses and a count limit alone
13
13
  * lets "Cape Town Harbour Depot, Johannesburg North Depot" push the remove
14
14
  * control off a phone-width bar. Characters rather than pixels because the
15
15
  * contract has no fonts; the adapter still truncates as the last resort. */
16
16
  export declare const FILTER_CHIP_MAX_VALUE_CHARS = 32;
17
17
  /** The attribute every chip root carries, so a bar holding several can find
18
- * them again — to move focus to a neighbour after one is removed. */
18
+ * them again, to move focus to a neighbour after one is removed. */
19
19
  export declare const FILTER_CHIP_ATTR = "data-filter-chip";
20
- /** What the value segment shows, and `undefined` when there is no value yet.
20
+ /** What the value segment shows and `undefined` when there is no value yet.
21
21
  *
22
22
  * Blank strings are dropped first: a value the server sent as `''` is not a
23
- * value the reader chose, and counting it would say "2 statuses" over one. */
23
+ * value the reader chose and counting it would say "2 statuses" over one. */
24
24
  export declare function filterChipValueSummary(values: readonly string[], noun?: string, maxListed?: number): string | undefined;
25
- /** Dots kept in front of a counted label summary — "● ● ● 5 labels". */
25
+ /** Dots kept in front of a counted label summary, "● ● ● 5 labels". */
26
26
  export declare const FILTER_CHIP_LABEL_DOTS_MAX = 3;
27
27
  /** The noun a counted label summary uses when the caller gives none. */
28
28
  export declare const FILTER_CHIP_LABEL_NOUN = "labels";
@@ -37,20 +37,20 @@ export type FilterChipLabelSegment = {
37
37
  dots: readonly LabelItem[];
38
38
  text: string;
39
39
  };
40
- /** The words a label filter's values read as — each label's whole text, "Region / Gauteng". */
40
+ /** The words a label filter's values read as, each label's whole text, "Region / Gauteng". */
41
41
  export declare function filterChipLabelValues(labels: readonly LabelItem[]): string[];
42
42
  /** Decides how a label filter's value segment is drawn, by the same rule every value segment keeps. */
43
43
  export declare function filterChipLabelSegment(labels: readonly LabelItem[], noun?: string, maxListed?: number): FilterChipLabelSegment;
44
44
  /** What the value segment shows before anything is chosen. */
45
45
  export declare const FILTER_CHIP_PLACEHOLDER = "any value";
46
- /** The whole filter as one sentence — the group's accessible name, carrying
46
+ /** The whole filter as one sentence, the group's accessible name, carrying
47
47
  * every value even when the segment shows a count. */
48
48
  export declare function filterChipLabel(field: string, operator: string, values: readonly string[], placeholder?: string): string;
49
49
  /** What the remove control is called. Named after the field, never "Remove"
50
50
  * alone: a bar with four chips would otherwise offer four identical controls. */
51
51
  export declare function filterChipRemoveLabel(field: string): string;
52
52
  export type FilterChipKeyAction = 'remove';
53
- /** What a key pressed on the chip does, and `undefined` for everything else. */
53
+ /** What a key pressed on the chip does and `undefined` for everything else. */
54
54
  export declare function filterChipKeyAction(key: string): FilterChipKeyAction | undefined;
55
55
  export declare const FILTER_CHIP_SURFACE = "background";
56
56
  export declare const FILTER_CHIP_BORDER = "input";
@@ -67,7 +67,7 @@ export interface FilterChipResolvedSpec {
67
67
  surface: FilterChipSurfaceRole;
68
68
  border: FilterChipBorderRole;
69
69
  rule: FilterChipRuleRole;
70
- /** The field and the operator — the sentence's frame, quieter than its answer. */
70
+ /** The field and the operator, the sentence's frame, quieter than its answer. */
71
71
  frameInk: FilterChipInkRole;
72
72
  /** The value, in body ink while one is chosen and quiet while it is not. */
73
73
  valueInk: FilterChipInkRole;
@@ -76,9 +76,9 @@ export interface FilterChipResolvedSpec {
76
76
  export declare function filterChipSpec(hasValue: boolean): FilterChipResolvedSpec;
77
77
  /** The props every Filter Chip implementation accepts. */
78
78
  export interface FilterChipContract {
79
- /** The field the filter tests — "Status", "Depot", "Vehicle group". */
79
+ /** The field the filter tests, "Status", "Depot", "Vehicle group". */
80
80
  field: string;
81
- /** The comparison — "is", "is not", "is any of", "before". */
81
+ /** The comparison, "is", "is not", "is any of", "before". */
82
82
  operator: string;
83
83
  /** Every value the filter holds, in the order the caller wants them read. Ignored when `valueLabels` is given. */
84
84
  values: readonly string[];
@@ -92,6 +92,6 @@ export interface FilterChipContract {
92
92
  placeholder?: Forwarded<string>;
93
93
  /** Which segment's popup is currently showing, forwarded to that segment's `aria-expanded`. */
94
94
  expanded?: Forwarded<FilterChipSegment>;
95
- /** Blocks every segment and the remove control, and dims the chip. */
95
+ /** Blocks every segment and the remove control and dims the chip. */
96
96
  disabled?: Forwarded<boolean>;
97
97
  }
@@ -7,7 +7,7 @@ export type DSFilterChipProps = Omit<ComponentProps<'span'>, 'children' | 'role'
7
7
  onOperatorPress?: (trigger: HTMLButtonElement) => void;
8
8
  /** Reports a press on the value segment, with the segment itself. */
9
9
  onValuePress?: (trigger: HTMLButtonElement) => void;
10
- /** Reports that the reader asked to take the filter away — by the × or by Backspace. */
10
+ /** Reports that the reader asked to take the filter away, by the × or by Backspace. */
11
11
  onRemove?: () => void;
12
12
  /** Names the remove control; defaults to "Remove <field> filter". */
13
13
  removeLabel?: string;
@@ -14,7 +14,7 @@ const INK = {
14
14
  const HOVER = {
15
15
  muted: 'state-layer',
16
16
  };
17
- const SEGMENT = 'inline-flex min-w-0 items-center px-2.5 focusable focus-visible:-outline-offset-2 focus-visible:shadow-none cursor-pointer disabled:cursor-not-allowed';
17
+ const SEGMENT = 'inline-flex min-w-0 items-center px-2 focusable focus-visible:-outline-offset-2 focus-visible:shadow-none cursor-pointer disabled:cursor-not-allowed';
18
18
  const END_START = 'rounded-s-full';
19
19
  const END_END = 'rounded-e-full';
20
20
  const DISABLED_PILL = 'bg-disabled border-disabled-border';
@@ -40,12 +40,12 @@ export function DSFilterChip({ field, operator, values: plainValues, valueLabels
40
40
  }
41
41
  function segment(which, content, ink, onPress, extra) {
42
42
  if (onPress === undefined) {
43
- return (_jsx("span", { "data-segment": which, className: cn('inline-flex min-w-0 items-center px-2.5', isDisabled ? DISABLED_INK : INK[ink], extra), children: content }));
43
+ return (_jsx("span", { "data-segment": which, className: cn('inline-flex min-w-0 items-center px-2', isDisabled ? DISABLED_INK : INK[ink], extra), children: content }));
44
44
  }
45
45
  return (_jsx("button", { type: "button", "data-segment": which, disabled: isDisabled, "aria-haspopup": popup, "aria-expanded": expanded === which, onClick: (event) => {
46
46
  onPress(event.currentTarget);
47
47
  }, className: cn(SEGMENT, HOVER[spec.hoverSurface], isDisabled ? DISABLED_INK : INK[ink], extra), children: content }));
48
48
  }
49
- const rule = (_jsx("span", { "aria-hidden": true, className: cn('my-1.5 w-px shrink-0', isDisabled ? DISABLED_RULE : RULE[spec.rule]) }));
50
- return (_jsxs("span", { [FILTER_CHIP_ATTR]: '', className: cn('inline-flex min-h-9 max-w-full items-stretch overflow-hidden rounded-full border text-body-sm pointer-coarse:min-h-touch', isDisabled ? DISABLED_PILL : cn(SURFACE[spec.surface], BORDER[spec.border]), className), ...props, role: "group", "aria-label": filterChipLabel(field, operator, values, placeholder), "aria-disabled": isDisabled || undefined, onKeyDown: onKeyDown, children: [segment('field', field, spec.frameInk, onFieldPress, cn('shrink-0 ps-3 font-medium', END_START)), rule, segment('operator', operator, spec.frameInk, onOperatorPress, 'shrink-0'), rule, segment('value', labelSegment === undefined || labelSegment.kind === 'empty' ? (_jsx("span", { className: "truncate", children: summary ?? placeholder })) : labelSegment.kind === 'listed' ? (_jsx("span", { className: "flex min-w-0 items-center gap-1.5", children: labelSegment.labels.map((label, i) => (_jsxs("span", { className: "flex min-w-0 items-center gap-1.5", children: [_jsx(DSLabelDot, { colour: label.colour, size: "sm" }), _jsxs("span", { className: "truncate", children: [labelText(label), i < labelSegment.labels.length - 1 ? ',' : ''] })] }, label.id))) })) : (_jsxs("span", { className: "flex min-w-0 items-center gap-1.5", children: [_jsx("span", { className: "flex shrink-0 items-center gap-0.5", children: labelSegment.dots.map((label) => (_jsx(DSLabelDot, { colour: label.colour, size: "sm" }, label.id))) }), _jsx("span", { className: "truncate", children: labelSegment.text })] })), spec.valueInk, onValuePress, cn('max-w-60', onRemove === undefined && cn('pe-3', END_END))), onRemove !== undefined && (_jsxs(_Fragment, { children: [rule, _jsx("button", { type: "button", disabled: isDisabled, "aria-label": removeLabel ?? filterChipRemoveLabel(field), onClick: onRemove, className: cn(SEGMENT, 'shrink-0 justify-center ps-2 pe-2.5 pointer-coarse:min-w-touch', END_END, HOVER[spec.hoverSurface], isDisabled ? DISABLED_INK : INK[spec.frameInk]), children: _jsx(X, { "aria-hidden": true, className: "size-3.5" }) })] }))] }));
49
+ const rule = (_jsx("span", { "aria-hidden": true, className: cn('my-2 w-px shrink-0', isDisabled ? DISABLED_RULE : RULE[spec.rule]) }));
50
+ return (_jsxs("span", { [FILTER_CHIP_ATTR]: '', className: cn('inline-flex min-h-9 max-w-full items-stretch overflow-hidden rounded-full border text-body-sm pointer-coarse:min-h-touch', isDisabled ? DISABLED_PILL : cn(SURFACE[spec.surface], BORDER[spec.border], 'chip-rest-filter'), className), ...props, role: "group", "aria-label": filterChipLabel(field, operator, values, placeholder), "aria-disabled": isDisabled || undefined, onKeyDown: onKeyDown, children: [segment('field', field, spec.frameInk, onFieldPress, cn('shrink-0 ps-3 font-medium', END_START)), rule, segment('operator', operator, spec.frameInk, onOperatorPress, 'shrink-0'), rule, segment('value', labelSegment === undefined || labelSegment.kind === 'empty' ? (_jsx("span", { className: "truncate", children: summary ?? placeholder })) : labelSegment.kind === 'listed' ? (_jsx("span", { className: "flex min-w-0 items-center gap-2", children: labelSegment.labels.map((label, i) => (_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [_jsx(DSLabelDot, { colour: label.colour, size: "sm" }), _jsxs("span", { className: "truncate", children: [labelText(label), i < labelSegment.labels.length - 1 ? ',' : ''] })] }, label.id))) })) : (_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [_jsx("span", { className: "flex shrink-0 items-center gap-1", children: labelSegment.dots.map((label) => (_jsx(DSLabelDot, { colour: label.colour, size: "sm" }, label.id))) }), _jsx("span", { className: "truncate", children: labelSegment.text })] })), spec.valueInk, onValuePress, cn('max-w-60', onRemove === undefined && cn('pe-3', END_END))), onRemove !== undefined && (_jsxs(_Fragment, { children: [rule, _jsx("button", { type: "button", disabled: isDisabled, "aria-label": removeLabel ?? filterChipRemoveLabel(field), onClick: onRemove, className: cn(SEGMENT, 'shrink-0 justify-center ps-2 pe-3 pointer-coarse:min-w-touch', END_END, HOVER[spec.hoverSurface], isDisabled ? DISABLED_INK : INK[spec.frameInk]), children: _jsx(X, { "aria-hidden": true, className: "size-3.5" }) })] }))] }));
51
51
  }
@@ -10,4 +10,7 @@ export interface FilterPopoverContract {
10
10
  options: readonly string[];
11
11
  /** The values ticked now. */
12
12
  chosen: readonly string[];
13
+ /** The trigger cannot be pressed: the list behind it is loading or locked.
14
+ * The count still shows, so a narrowed list never reads as a whole one. */
15
+ disabled?: boolean;
13
16
  }
@@ -1,7 +1,7 @@
1
1
  import { type FilterPopoverContract } from '../filter-popover';
2
2
  export type DSFilterPopoverProps = FilterPopoverContract & {
3
- /** The new ticked values. Called as each box is ticked, and with none on Clear. */
3
+ /** The new ticked values. Called as each box is ticked and with none on Clear. */
4
4
  onChosenChange: (next: readonly string[]) => void;
5
5
  };
6
6
  /** A filter button that opens a panel of checkboxes for one field, applying each tick at once, with a way to clear them all. */
7
- export declare function DSFilterPopover({ noun, legend, options, chosen, onChosenChange, }: DSFilterPopoverProps): import("react/jsx-runtime").JSX.Element;
7
+ export declare function DSFilterPopover({ noun, legend, options, chosen, disabled, onChosenChange, }: DSFilterPopoverProps): import("react/jsx-runtime").JSX.Element;
@@ -1,16 +1,21 @@
1
1
  import { jsx as _jsx } from "react/jsx-runtime";
2
- import { useState } from 'react';
2
+ import { useEffect, useState } from 'react';
3
3
  import { filterPopoverToggle } from '../filter-popover';
4
4
  import { DSButton } from '../../button/web/ds-button';
5
5
  import { DSCheckOption } from '../../check-option/web/ds-check-option';
6
6
  import { DSFilterButton } from '../../filter-button/web/ds-filter-button';
7
7
  import { DSFormFieldGroup } from '../../form-field-group/web/ds-form-field-group';
8
8
  import { DSPopover } from '../../popover/web/ds-popover';
9
- export function DSFilterPopover({ noun, legend, options, chosen, onChosenChange, }) {
9
+ export function DSFilterPopover({ noun, legend, options, chosen, disabled = false, onChosenChange, }) {
10
10
  const [open, setOpen] = useState(false);
11
- return (_jsx(DSPopover, { open: open, label: `Filter ${noun}`, onRequestClose: () => {
11
+ useEffect(() => {
12
+ if (disabled)
12
13
  setOpen(false);
13
- }, trigger: _jsx(DSFilterButton, { count: chosen.length, expanded: open, className: "min-h-8", onClick: () => {
14
+ }, [disabled]);
15
+ const shown = open && !disabled;
16
+ return (_jsx(DSPopover, { open: shown, label: `Filter ${noun}`, onRequestClose: () => {
17
+ setOpen(false);
18
+ }, trigger: _jsx(DSFilterButton, { count: chosen.length, expanded: shown, className: "min-h-10.5", disabled: disabled, onClick: () => {
14
19
  setOpen((was) => !was);
15
20
  } }), footer: _jsx(DSButton, { variant: "ghost", size: "sm", disabled: chosen.length === 0, onClick: () => {
16
21
  onChosenChange([]);
@@ -2,11 +2,11 @@ import type { Forwarded } from '../props';
2
2
  import type { TokenRole } from '../token-roles';
3
3
  export declare const FORM_FIELD_GROUP_COLUMNS: readonly [1, 2];
4
4
  export type FormFieldGroupColumns = (typeof FORM_FIELD_GROUP_COLUMNS)[number];
5
- /** `spacingUnit * 2`. The gap between rows AND the gutter between columns —
5
+ /** `spacingUnit * 2`. The gap between rows AND the gutter between columns,
6
6
  * one value, because a grid whose two axes disagree reads as a mistake. */
7
7
  export declare const FORM_FIELD_GROUP_GAP_PX: 16;
8
8
  /** `spacingUnit / 2`. The description sits tight under its legend: they are one
9
- * block, and a gap here would read as two. */
9
+ * block and a gap here would read as two. */
10
10
  export declare const FORM_FIELD_GROUP_DESCRIPTION_GAP_PX: 4;
11
11
  /** `minRowWidth`. Below this the children stack. Mirrors the
12
12
  * `--container-field-row` token the adapter queries against. */
@@ -32,7 +32,7 @@ export interface FormFieldGroupResolvedSpec {
32
32
  descriptionInk: FormFieldGroupDescriptionInkRole;
33
33
  gap: number;
34
34
  descriptionGap: number;
35
- /** The width this group's row splits at — a field's or a card's, per `row`. */
35
+ /** The width this group's row splits at, a field's or a card's, per `row`. */
36
36
  minRowWidth: number;
37
37
  row: FormFieldGroupRow;
38
38
  columns: FormFieldGroupColumns;
@@ -58,13 +58,13 @@ export declare function formFieldGroupSays(line: FormFieldGroupLine): string | u
58
58
  export declare function formFieldGroupMessageSpec({ helper, error, }?: Pick<FormFieldGroupContract, 'helper' | 'error'>): FormFieldGroupMessageSpec;
59
59
  export interface FormFieldGroupContract {
60
60
  /** A line under the group explaining the rule its fields share. Replaced by
61
- * `error` when there is one — see the note above. */
61
+ * `error` when there is one, see the note above. */
62
62
  helper?: Forwarded<FormFieldGroupLine>;
63
63
  /** What the group as a whole got wrong. Marks the fieldset invalid and names
64
64
  * it as the fieldset's description, so a reader hears it on the way in. */
65
65
  error?: Forwarded<FormFieldGroupLine>;
66
- /** Names the group. Optional — a pair of name fields under a card's own
67
- * heading needs no second one — but a group with no legend and no
66
+ /** Names the group. Optional, a pair of name fields under a card's own
67
+ * heading needs no second one, but a group with no legend and no
68
68
  * `aria-label` is a grouping only sighted readers can see. */
69
69
  legend?: Forwarded<FormFieldGroupLine>;
70
70
  /** Explains it, under the legend. */
@@ -73,7 +73,7 @@ export interface FormFieldGroupContract {
73
73
  * every width. Defaults to 2. */
74
74
  columns?: Forwarded<FormFieldGroupColumns>;
75
75
  /** What is in the row, which is what decides how much room "room" is. Fields
76
- * split at 360, option cards at 732 — see `FORM_FIELD_GROUP_ROWS`. Defaults
76
+ * split at 360, option cards at 732, see `FORM_FIELD_GROUP_ROWS`. Defaults
77
77
  * to `field`, so every group that exists keeps its threshold. Does nothing
78
78
  * when `columns` is 1, which never splits. */
79
79
  row?: Forwarded<FormFieldGroupRow>;
@@ -27,7 +27,7 @@ export function DSFormFieldGroup({ legend: legendLine, description: descriptionL
27
27
  ]
28
28
  .filter((id) => id !== undefined && id !== '')
29
29
  .join(' ') || undefined;
30
- return (_jsxs("fieldset", { className: cn('@container m-0 min-w-0 border-0 p-0', className), ...(message.invalid ? { 'aria-invalid': true } : {}), ...(describedBy === undefined ? {} : { 'aria-describedby': describedBy }), ...props, children: [legend !== undefined && (_jsx("legend", { className: "float-none mb-0 block w-full p-0", children: _jsx(DSText, { variant: "label", className: LEGEND_INK[spec.legendInk], children: legend }) })), description !== undefined && (_jsx(DSText, { as: "p", id: descriptionId, variant: "caption", className: cn('m-0', DESCRIPTION_INK[spec.descriptionInk]), style: { marginBlockStart: spec.descriptionGap }, children: description })), _jsx("div", { className: cn('grid grid-cols-1', spec.columns === 2 &&
30
+ return (_jsxs("fieldset", { className: cn('@container m-0 min-w-0 border-0 p-0', className), ...(message.invalid ? { 'aria-invalid': true } : {}), ...(describedBy === undefined ? {} : { 'aria-describedby': describedBy }), ...props, children: [legend !== undefined && (_jsx("legend", { className: "float-none mb-0 block w-full p-0", children: _jsx(DSText, { variant: "label-md", className: LEGEND_INK[spec.legendInk], children: legend }) })), description !== undefined && (_jsx(DSText, { as: "p", id: descriptionId, variant: "body-sm", className: cn('m-0', DESCRIPTION_INK[spec.descriptionInk]), style: { marginBlockStart: spec.descriptionGap }, children: description })), _jsx("div", { className: cn('grid grid-cols-1', spec.columns === 2 &&
31
31
  (spec.row === 'card' ? '@card-row:grid-cols-2' : '@field-row:grid-cols-2')), style: {
32
32
  gap: spec.gap,
33
33
  marginBlockStart: legend !== undefined || description !== undefined ? spec.gap : 0,
@@ -5,7 +5,7 @@ export type FormSectionHeadingLevel = (typeof FORM_SECTION_HEADING_LEVELS)[numbe
5
5
  /** Directly under the page's own title. */
6
6
  export declare const FORM_SECTION_DEFAULT_HEADING_LEVEL = 2;
7
7
  /** The heading is a title at either level. */
8
- export declare const FORM_SECTION_TITLE_VARIANT: "title";
8
+ export declare const FORM_SECTION_TITLE_VARIANT: "heading-lg";
9
9
  /** The element the heading is drawn as, for a level. */
10
10
  export declare function formSectionHeading(level?: FormSectionHeadingLevel): 'h2' | 'h3';
11
11
  /** The props every Form Section implementation accepts. */
@@ -1,6 +1,6 @@
1
1
  export const FORM_SECTION_HEADING_LEVELS = [2, 3];
2
2
  export const FORM_SECTION_DEFAULT_HEADING_LEVEL = 2;
3
- export const FORM_SECTION_TITLE_VARIANT = 'title';
3
+ export const FORM_SECTION_TITLE_VARIANT = 'heading-lg';
4
4
  export function formSectionHeading(level = FORM_SECTION_DEFAULT_HEADING_LEVEL) {
5
5
  return level === 3 ? 'h3' : 'h2';
6
6
  }
@@ -1,4 +1,4 @@
1
- import type { ComponentProps, ReactNode } from 'react';
1
+ import { type ComponentProps, type ReactNode } from 'react';
2
2
  import { type FormSectionContract } from '../form-section';
3
3
  export type DSFormSectionProps = Omit<ComponentProps<'section'>, 'title' | 'children'> & FormSectionContract & {
4
4
  /** A quiet choice about the whole section, on the heading's baseline at the far end. */
@@ -6,5 +6,5 @@ export type DSFormSectionProps = Omit<ComponentProps<'section'>, 'title' | 'chil
6
6
  /** The section's fields. */
7
7
  children: ReactNode;
8
8
  };
9
- /** A titled part of a form: a heading, an optional quiet action beside it, and its fields. */
9
+ /** A titled part of a form: a heading, an optional quiet action beside it and its fields. */
10
10
  export declare function DSFormSection({ title, headingLevel, action, children, className, ...props }: DSFormSectionProps): import("react/jsx-runtime").JSX.Element;
@@ -1,7 +1,9 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { useId } from 'react';
2
3
  import { FORM_SECTION_TITLE_VARIANT, formSectionHeading, } from '../form-section';
3
4
  import { DSText } from '../../text/web/ds-text';
4
5
  import { cn } from '../../lib/cn';
5
6
  export function DSFormSection({ title, headingLevel, action, children, className, ...props }) {
6
- return (_jsxs("section", { className: cn('flex flex-col gap-4', className), ...props, children: [_jsxs("div", { className: "flex items-baseline justify-between gap-4", children: [_jsx(DSText, { as: formSectionHeading(headingLevel), variant: FORM_SECTION_TITLE_VARIANT, children: title }), action] }), children] }));
7
+ const headingId = useId();
8
+ return (_jsxs("section", { className: cn('form-section-surface flex flex-col gap-4', className), ...props, "aria-labelledby": props['aria-label'] ? undefined : (props['aria-labelledby'] ?? headingId), children: [_jsxs("div", { className: "flex flex-wrap items-baseline justify-between gap-x-4 gap-y-1", children: [_jsx(DSText, { id: headingId, as: formSectionHeading(headingLevel), variant: FORM_SECTION_TITLE_VARIANT, className: "form-section-title min-w-0 break-words", children: title }), action] }), children] }));
7
9
  }