@tfn-design/design-system 0.2.0 → 0.4.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 (1161) hide show
  1. package/README.md +4 -4
  2. package/dist/accordion/accordion.d.ts +3 -3
  3. package/dist/accordion/accordion.js +1 -1
  4. package/dist/accordion/web/ds-accordion.d.ts +10 -3
  5. package/dist/accordion/web/ds-accordion.js +35 -5
  6. package/dist/account-password-field/account-password-field.d.ts +4 -4
  7. package/dist/account-password-field/account-password-field.js +1 -1
  8. package/dist/account-password-field/web/ds-account-password-field.d.ts +2 -2
  9. package/dist/account-password-field/web/ds-account-password-field.js +1 -1
  10. package/dist/account-switcher/account-switcher.d.ts +17 -10
  11. package/dist/account-switcher/account-switcher.js +2 -1
  12. package/dist/account-switcher/web/ds-account-switcher.d.ts +5 -5
  13. package/dist/account-switcher/web/ds-account-switcher.js +15 -7
  14. package/dist/action-toast/action-toast.d.ts +12 -12
  15. package/dist/action-toast/web/ds-action-toast.d.ts +5 -5
  16. package/dist/action-toast/web/ds-action-toast.js +9 -4
  17. package/dist/ai-assist-field/ai-assist-field.d.ts +8 -6
  18. package/dist/ai-assist-field/ai-assist-field.js +12 -2
  19. package/dist/ai-assist-field/web/ds-ai-assist-field.d.ts +1 -1
  20. package/dist/ai-assist-field/web/ds-ai-assist-field.js +9 -8
  21. package/dist/ai-attachment/ai-attachment.d.ts +1 -1
  22. package/dist/ai-attachment/ai-attachment.js +1 -1
  23. package/dist/ai-attachment/web/ds-ai-attachment.js +2 -1
  24. package/dist/ai-branch-switcher/ai-branch-switcher.d.ts +3 -0
  25. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.d.ts +1 -1
  26. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.js +8 -5
  27. package/dist/ai-citation/ai-citation.d.ts +8 -8
  28. package/dist/ai-citation/native/ds-ai-citation.js +5 -5
  29. package/dist/ai-citation/web/ds-ai-citation.js +6 -5
  30. package/dist/ai-composer/ai-composer.d.ts +3 -3
  31. package/dist/ai-composer/ai-composer.js +1 -1
  32. package/dist/ai-composer/native/ds-ai-composer.js +7 -4
  33. package/dist/ai-composer/web/ds-ai-composer.d.ts +1 -1
  34. package/dist/ai-composer/web/ds-ai-composer.js +4 -5
  35. package/dist/ai-confirmation/ai-confirmation.d.ts +27 -11
  36. package/dist/ai-confirmation/ai-confirmation.js +18 -3
  37. package/dist/ai-confirmation/native/ds-ai-confirmation.js +19 -14
  38. package/dist/ai-confirmation/web/ds-ai-confirmation.d.ts +2 -2
  39. package/dist/ai-confirmation/web/ds-ai-confirmation.js +24 -12
  40. package/dist/ai-context-scope/ai-context-scope.d.ts +14 -6
  41. package/dist/ai-context-scope/ai-context-scope.js +11 -2
  42. package/dist/ai-context-scope/native/ds-ai-context-scope.d.ts +1 -1
  43. package/dist/ai-context-scope/native/ds-ai-context-scope.js +9 -5
  44. package/dist/ai-context-scope/web/ds-ai-context-scope.d.ts +2 -2
  45. package/dist/ai-context-scope/web/ds-ai-context-scope.js +28 -4
  46. package/dist/ai-conversation-list/ai-conversation-list.d.ts +21 -5
  47. package/dist/ai-conversation-list/ai-conversation-list.js +8 -0
  48. package/dist/ai-conversation-list/web/ds-ai-conversation-list.d.ts +11 -7
  49. package/dist/ai-conversation-list/web/ds-ai-conversation-list.js +92 -49
  50. package/dist/ai-diff/ai-diff.d.ts +15 -3
  51. package/dist/ai-diff/ai-diff.js +12 -1
  52. package/dist/ai-diff/native/ds-ai-diff.d.ts +1 -1
  53. package/dist/ai-diff/native/ds-ai-diff.js +6 -7
  54. package/dist/ai-diff/web/ds-ai-diff.d.ts +0 -4
  55. package/dist/ai-diff/web/ds-ai-diff.js +17 -9
  56. package/dist/ai-draft-panel/ai-draft-panel.d.ts +5 -3
  57. package/dist/ai-draft-panel/ai-draft-panel.js +8 -3
  58. package/dist/ai-draft-panel/web/ds-ai-draft-panel.d.ts +5 -3
  59. package/dist/ai-draft-panel/web/ds-ai-draft-panel.js +5 -4
  60. package/dist/ai-empty-state/native/ds-ai-empty-state.d.ts +1 -1
  61. package/dist/ai-empty-state/native/ds-ai-empty-state.js +4 -3
  62. package/dist/ai-empty-state/web/ds-ai-empty-state.d.ts +1 -1
  63. package/dist/ai-empty-state/web/ds-ai-empty-state.js +4 -1
  64. package/dist/ai-error-state/ai-error-state.d.ts +2 -2
  65. package/dist/ai-error-state/ai-error-state.js +2 -2
  66. package/dist/ai-error-state/native/ds-ai-error-state.d.ts +5 -1
  67. package/dist/ai-error-state/native/ds-ai-error-state.js +4 -2
  68. package/dist/ai-error-state/web/ds-ai-error-state.d.ts +5 -1
  69. package/dist/ai-error-state/web/ds-ai-error-state.js +4 -2
  70. package/dist/ai-feedback/ai-feedback.d.ts +1 -1
  71. package/dist/ai-feedback/ai-feedback.js +1 -1
  72. package/dist/ai-feedback/web/ds-ai-feedback.js +3 -2
  73. package/dist/ai-label/ai-label.d.ts +5 -5
  74. package/dist/ai-label/native/ds-ai-label.js +7 -5
  75. package/dist/ai-label/web/ds-ai-label.js +4 -4
  76. package/dist/ai-message/ai-message.d.ts +4 -4
  77. package/dist/ai-message/ai-message.js +1 -1
  78. package/dist/ai-message/native/ds-ai-message.d.ts +1 -1
  79. package/dist/ai-message/native/ds-ai-message.js +14 -11
  80. package/dist/ai-message/web/ds-ai-message-markdown.js +6 -6
  81. package/dist/ai-message/web/ds-ai-message.d.ts +2 -2
  82. package/dist/ai-message/web/ds-ai-message.js +6 -4
  83. package/dist/ai-message-actions/ai-message-actions.d.ts +2 -2
  84. package/dist/ai-message-actions/ai-message-actions.js +1 -1
  85. package/dist/ai-message-actions/native/ds-ai-message-actions.js +3 -2
  86. package/dist/ai-message-actions/web/ds-ai-message-actions.js +1 -1
  87. package/dist/ai-message-actions/web/use-ai-clipboard.d.ts +1 -1
  88. package/dist/ai-plan/ai-plan.d.ts +5 -5
  89. package/dist/ai-plan/ai-plan.js +1 -1
  90. package/dist/ai-plan/web/ds-ai-plan.js +4 -3
  91. package/dist/ai-reasoning/ai-reasoning.d.ts +1 -1
  92. package/dist/ai-side-nav/ai-side-nav.d.ts +19 -19
  93. package/dist/ai-side-nav/web/ds-ai-side-nav.d.ts +9 -9
  94. package/dist/ai-side-nav/web/ds-ai-side-nav.js +6 -4
  95. package/dist/ai-suggestions/native/ds-ai-suggestions.js +1 -1
  96. package/dist/ai-suggestions/web/ds-ai-suggestions.js +1 -1
  97. package/dist/ai-summary-card/ai-summary-card.d.ts +8 -8
  98. package/dist/ai-summary-card/native/ds-ai-summary-card.d.ts +1 -1
  99. package/dist/ai-summary-card/native/ds-ai-summary-card.js +4 -3
  100. package/dist/ai-summary-card/web/ds-ai-summary-card.d.ts +1 -1
  101. package/dist/ai-summary-card/web/ds-ai-summary-card.js +3 -1
  102. package/dist/ai-thinking/native/ds-ai-thinking.js +3 -2
  103. package/dist/ai-thinking/web/ds-ai-thinking.js +1 -1
  104. package/dist/ai-thread/ai-thread.d.ts +3 -3
  105. package/dist/ai-thread/native/ds-ai-thread-panel.js +2 -1
  106. package/dist/ai-thread/native/ds-ai-thread.d.ts +2 -2
  107. package/dist/ai-thread/native/ds-ai-thread.js +4 -2
  108. package/dist/ai-thread/web/ds-ai-thread.d.ts +2 -2
  109. package/dist/ai-thread/web/ds-ai-thread.js +1 -1
  110. package/dist/ai-tool-call/ai-tool-call.d.ts +7 -7
  111. package/dist/ai-tool-call/ai-tool-call.js +1 -1
  112. package/dist/ai-tool-call/native/ds-ai-tool-call.d.ts +1 -1
  113. package/dist/ai-tool-call/native/ds-ai-tool-call.js +7 -6
  114. package/dist/ai-tool-call/web/ds-ai-tool-call.d.ts +1 -1
  115. package/dist/ai-tool-call/web/ds-ai-tool-call.js +6 -4
  116. package/dist/alert/alert.d.ts +9 -9
  117. package/dist/alert/alert.js +1 -1
  118. package/dist/alert/native/ds-alert.js +13 -15
  119. package/dist/alert/web/ds-alert.js +27 -17
  120. package/dist/ambient-gradient/ambient-gradient.d.ts +12 -12
  121. package/dist/ambient-gradient/native/ambient-gradient-provider.d.ts +1 -1
  122. package/dist/ambient-gradient/native/ds-ambient-gradient.d.ts +1 -1
  123. package/dist/ambient-gradient/web/ds-ambient-gradient.d.ts +1 -1
  124. package/dist/amount/amount.d.ts +26 -26
  125. package/dist/amount/amount.js +7 -5
  126. package/dist/amount/native/ds-amount.js +3 -2
  127. package/dist/amount/web/ds-amount.js +2 -2
  128. package/dist/amount-cell/amount-cell.d.ts +5 -2
  129. package/dist/amount-cell/web/ds-amount-cell.d.ts +1 -1
  130. package/dist/amount-cell/web/ds-amount-cell.js +8 -2
  131. package/dist/amount-entry/amount-entry.d.ts +36 -10
  132. package/dist/amount-entry/amount-entry.js +19 -12
  133. package/dist/amount-entry/native/ds-amount-entry.d.ts +1 -1
  134. package/dist/amount-entry/native/ds-amount-entry.js +7 -5
  135. package/dist/amount-entry/web/ds-amount-entry.d.ts +1 -1
  136. package/dist/amount-entry/web/ds-amount-entry.js +6 -4
  137. package/dist/app-shell/app-shell.d.ts +11 -9
  138. package/dist/app-shell/app-shell.js +1 -1
  139. package/dist/app-shell/web/ds-app-shell.d.ts +24 -6
  140. package/dist/app-shell/web/ds-app-shell.js +28 -4
  141. package/dist/approval-chain/approval-chain.d.ts +18 -14
  142. package/dist/approval-chain/approval-chain.js +4 -4
  143. package/dist/approval-chain/native/ds-approval-chain.d.ts +1 -1
  144. package/dist/approval-chain/native/ds-approval-chain.js +21 -12
  145. package/dist/approval-chain/web/ds-approval-chain.d.ts +8 -2
  146. package/dist/approval-chain/web/ds-approval-chain.js +17 -15
  147. package/dist/auth-shell/auth-shell.d.ts +4 -4
  148. package/dist/auth-shell/web/ds-auth-shell.d.ts +28 -6
  149. package/dist/auth-shell/web/ds-auth-shell.js +30 -2
  150. package/dist/avatar/avatar.d.ts +2 -2
  151. package/dist/avatar/native/ds-avatar.js +3 -2
  152. package/dist/avatar-group/avatar-group.d.ts +3 -3
  153. package/dist/avatar-group/native/ds-avatar-group.js +3 -2
  154. package/dist/avatar-group/web/ds-avatar-group.js +2 -2
  155. package/dist/balance-header/balance-header.d.ts +14 -10
  156. package/dist/balance-header/native/ds-balance-header.d.ts +4 -4
  157. package/dist/balance-header/native/ds-balance-header.js +13 -5
  158. package/dist/balance-header/web/ds-balance-header.d.ts +2 -2
  159. package/dist/balance-header/web/ds-balance-header.js +8 -4
  160. package/dist/bank-logo/bank-logo.d.ts +187 -0
  161. package/dist/bank-logo/bank-logo.js +151 -0
  162. package/dist/bank-logo/native/ds-bank-logo.d.ts +7 -0
  163. package/dist/bank-logo/native/ds-bank-logo.js +43 -0
  164. package/dist/bank-logo/web/ds-bank-logo.d.ts +10 -0
  165. package/dist/bank-logo/web/ds-bank-logo.js +27 -0
  166. package/dist/bar-chart/bar-chart.d.ts +108 -19
  167. package/dist/bar-chart/bar-chart.js +140 -5
  168. package/dist/bar-chart/web/ds-bar-chart.d.ts +26 -8
  169. package/dist/bar-chart/web/ds-bar-chart.js +182 -52
  170. package/dist/bottom-nav/bottom-nav.d.ts +35 -23
  171. package/dist/bottom-nav/bottom-nav.js +3 -2
  172. package/dist/bottom-nav/native/bottom-nav-icon-weight.d.ts +6 -0
  173. package/dist/bottom-nav/native/bottom-nav-icon-weight.js +6 -0
  174. package/dist/bottom-nav/native/ds-bottom-nav.d.ts +8 -8
  175. package/dist/bottom-nav/native/ds-bottom-nav.js +26 -17
  176. package/dist/bottom-nav/web/ds-bottom-nav.d.ts +16 -0
  177. package/dist/bottom-nav/web/ds-bottom-nav.js +31 -0
  178. package/dist/box-plot/box-plot.d.ts +150 -0
  179. package/dist/box-plot/box-plot.js +124 -0
  180. package/dist/box-plot/web/ds-box-plot.d.ts +8 -0
  181. package/dist/box-plot/web/ds-box-plot.js +57 -0
  182. package/dist/brand-lockup/brand-lockup.d.ts +41 -35
  183. package/dist/brand-lockup/brand-lockup.js +1 -1
  184. package/dist/brand-lockup/native/ds-brand-lockup.d.ts +7 -7
  185. package/dist/brand-lockup/native/ds-brand-lockup.js +6 -4
  186. package/dist/brand-lockup/web/ds-brand-lockup.d.ts +8 -8
  187. package/dist/brand-lockup/web/ds-brand-lockup.js +6 -4
  188. package/dist/brand-provider/brand-provider.d.ts +29 -0
  189. package/dist/brand-provider/brand-provider.js +9 -0
  190. package/dist/brand-provider/native/ds-brand-provider.d.ts +11 -0
  191. package/dist/brand-provider/native/ds-brand-provider.js +18 -0
  192. package/dist/brand-provider/web/ds-brand-provider.d.ts +10 -0
  193. package/dist/brand-provider/web/ds-brand-provider.js +20 -0
  194. package/dist/breadcrumbs/breadcrumbs.d.ts +4 -4
  195. package/dist/breadcrumbs/web/ds-breadcrumbs.d.ts +1 -1
  196. package/dist/bulk-action-bar/bulk-action-bar.d.ts +6 -6
  197. package/dist/bulk-action-bar/web/ds-bulk-action-bar.d.ts +4 -4
  198. package/dist/bulk-action-bar/web/ds-bulk-action-bar.js +2 -1
  199. package/dist/bullet-chart/bullet-chart.d.ts +87 -0
  200. package/dist/bullet-chart/bullet-chart.js +61 -0
  201. package/dist/bullet-chart/web/ds-bullet-chart.d.ts +8 -0
  202. package/dist/bullet-chart/web/ds-bullet-chart.js +36 -0
  203. package/dist/button/button.d.ts +37 -37
  204. package/dist/button/button.js +14 -14
  205. package/dist/button/native/ds-button.js +12 -13
  206. package/dist/button/web/ds-button.d.ts +3 -3
  207. package/dist/button/web/ds-button.js +41 -24
  208. package/dist/button-group/button-group.d.ts +2 -2
  209. package/dist/button-group/web/ds-button-group.d.ts +3 -3
  210. package/dist/button-group/web/ds-button-group.js +1 -1
  211. package/dist/calendar/calendar.d.ts +27 -16
  212. package/dist/calendar/calendar.js +4 -3
  213. package/dist/calendar/web/ds-calendar.d.ts +9 -5
  214. package/dist/calendar/web/ds-calendar.js +13 -10
  215. package/dist/card-carousel/card-carousel.d.ts +5 -5
  216. package/dist/card-carousel/native/ds-card-carousel.js +2 -2
  217. package/dist/card-carousel/web/ds-card-carousel.js +4 -2
  218. package/dist/chart/chart.d.ts +298 -102
  219. package/dist/chart/chart.js +482 -133
  220. package/dist/chart/web/ds-chart.d.ts +31 -19
  221. package/dist/chart/web/ds-chart.js +137 -87
  222. package/dist/check-option/check-option.d.ts +9 -11
  223. package/dist/check-option/check-option.js +1 -3
  224. package/dist/check-option/web/ds-check-option.d.ts +10 -5
  225. package/dist/check-option/web/ds-check-option.js +14 -9
  226. package/dist/checkbox/checkbox.d.ts +3 -3
  227. package/dist/checkbox/checkbox.js +2 -2
  228. package/dist/checkbox/native/ds-checkbox.js +1 -1
  229. package/dist/checkbox/web/checkbox-mark.js +1 -1
  230. package/dist/checkbox/web/ds-checkbox.d.ts +2 -2
  231. package/dist/checkbox/web/ds-checkbox.js +19 -12
  232. package/dist/chip/chip-wash.d.ts +5 -5
  233. package/dist/chip/chip.d.ts +16 -16
  234. package/dist/chip/chip.js +5 -3
  235. package/dist/chip/native/ds-chip.d.ts +1 -1
  236. package/dist/chip/native/ds-chip.js +6 -5
  237. package/dist/chip/web/ds-chip.d.ts +2 -2
  238. package/dist/chip/web/ds-chip.js +41 -8
  239. package/dist/code-block/code-block.d.ts +10 -10
  240. package/dist/code-block/web/ds-code-block.js +5 -4
  241. package/dist/code-block/web/use-code-block-clipboard.d.ts +1 -1
  242. package/dist/column-picker/web/ds-column-picker.d.ts +3 -1
  243. package/dist/column-picker/web/ds-column-picker.js +3 -2
  244. package/dist/combobox/combobox.d.ts +26 -12
  245. package/dist/combobox/combobox.js +2 -5
  246. package/dist/combobox/web/ds-combobox.d.ts +2 -2
  247. package/dist/combobox/web/ds-combobox.js +48 -14
  248. package/dist/command-palette/command-palette.d.ts +34 -30
  249. package/dist/command-palette/web/ds-command-palette.d.ts +3 -3
  250. package/dist/command-palette/web/ds-command-palette.js +9 -7
  251. package/dist/comment-thread/comment-thread.d.ts +13 -13
  252. package/dist/comment-thread/comment-thread.js +2 -2
  253. package/dist/comment-thread/native/ds-comment-thread.d.ts +1 -1
  254. package/dist/comment-thread/native/ds-comment-thread.js +22 -19
  255. package/dist/comment-thread/web/ds-comment-thread.d.ts +1 -1
  256. package/dist/comment-thread/web/ds-comment-thread.js +19 -17
  257. package/dist/condition-builder/condition-builder.d.ts +114 -22
  258. package/dist/condition-builder/condition-builder.js +68 -28
  259. package/dist/condition-builder/web/ds-condition-builder.d.ts +4 -2
  260. package/dist/condition-builder/web/ds-condition-builder.js +97 -57
  261. package/dist/context-menu/context-menu.d.ts +4 -4
  262. package/dist/context-menu/web/ds-context-menu.d.ts +1 -1
  263. package/dist/context-menu/web/ds-context-menu.js +2 -2
  264. package/dist/context-switcher/context-switcher.d.ts +10 -1
  265. package/dist/context-switcher/context-switcher.js +5 -2
  266. package/dist/context-switcher/web/ds-context-switcher.d.ts +1 -1
  267. package/dist/context-switcher/web/ds-context-switcher.js +4 -3
  268. package/dist/coordinate-field/coordinate-field.d.ts +56 -15
  269. package/dist/coordinate-field/coordinate-field.js +35 -18
  270. package/dist/coordinate-field/native/ds-coordinate-field.d.ts +2 -2
  271. package/dist/coordinate-field/native/ds-coordinate-field.js +10 -9
  272. package/dist/coordinate-field/web/ds-coordinate-field.d.ts +2 -2
  273. package/dist/coordinate-field/web/ds-coordinate-field.js +10 -9
  274. package/dist/copy-field/copy-field.d.ts +30 -16
  275. package/dist/copy-field/copy-field.js +11 -6
  276. package/dist/copy-field/web/ds-copy-field.d.ts +2 -2
  277. package/dist/copy-field/web/ds-copy-field.js +10 -9
  278. package/dist/copy.d.ts +8 -0
  279. package/dist/copy.js +7 -0
  280. package/dist/count-badge/count-badge.d.ts +9 -9
  281. package/dist/count-badge/native/ds-count-badge.js +3 -2
  282. package/dist/count-badge/web/ds-count-badge.js +4 -4
  283. package/dist/countdown/native/ds-countdown.js +3 -2
  284. package/dist/countdown/web/ds-countdown.js +2 -1
  285. package/dist/dashboard-shell/dashboard-shell.d.ts +6 -4
  286. package/dist/dashboard-shell/web/ds-dashboard-shell.d.ts +4 -4
  287. package/dist/data-table/data-table-license.d.ts +3 -3
  288. package/dist/data-table/data-table-store.d.ts +5 -5
  289. package/dist/data-table/url-state.d.ts +6 -6
  290. package/dist/data-table/web/data-table-parts.d.ts +2 -2
  291. package/dist/data-table/web/data-table-theme.css +420 -70
  292. package/dist/data-table/web/ds-data-table-skeleton-chip.d.ts +2 -2
  293. package/dist/data-table/web/ds-data-table.d.ts +47 -3
  294. package/dist/data-table/web/ds-data-table.js +167 -14
  295. package/dist/date-field/web/ds-date-field.d.ts +2 -2
  296. package/dist/date-field/web/ds-date-field.js +6 -5
  297. package/dist/date-input/date-input.d.ts +71 -15
  298. package/dist/date-input/date-input.js +64 -5
  299. package/dist/date-input/web/ds-date-input.d.ts +2 -2
  300. package/dist/date-input/web/ds-date-input.js +43 -8
  301. package/dist/date-picker/date-picker.d.ts +55 -84
  302. package/dist/date-picker/date-picker.js +27 -61
  303. package/dist/date-picker/web/ds-date-picker.d.ts +24 -11
  304. package/dist/date-picker/web/ds-date-picker.js +47 -15
  305. package/dist/date-range-picker/web/ds-date-range-picker.d.ts +10 -4
  306. package/dist/date-range-picker/web/ds-date-range-picker.js +40 -7
  307. package/dist/day-picker/day-picker.d.ts +9 -3
  308. package/dist/day-picker/day-picker.js +1 -1
  309. package/dist/day-picker/web/ds-day-picker.d.ts +3 -3
  310. package/dist/day-picker/web/ds-day-picker.js +16 -4
  311. package/dist/delta/delta.d.ts +34 -4
  312. package/dist/delta/delta.js +50 -1
  313. package/dist/delta/native/ds-delta.d.ts +5 -2
  314. package/dist/delta/native/ds-delta.js +12 -6
  315. package/dist/delta/web/ds-delta.d.ts +5 -2
  316. package/dist/delta/web/ds-delta.js +9 -5
  317. package/dist/description-list/description-list.d.ts +6 -4
  318. package/dist/description-list/native/ds-description-list.d.ts +4 -4
  319. package/dist/description-list/native/ds-description-list.js +54 -29
  320. package/dist/description-list/web/ds-description-list.d.ts +4 -4
  321. package/dist/description-list/web/ds-description-list.js +40 -15
  322. package/dist/dialog/dialog.d.ts +21 -10
  323. package/dist/dialog/native/ds-dialog.d.ts +1 -1
  324. package/dist/dialog/native/ds-dialog.js +2 -1
  325. package/dist/dialog/web/ds-dialog.d.ts +13 -5
  326. package/dist/dialog/web/ds-dialog.js +11 -11
  327. package/dist/diverging-bar-chart/diverging-bar-chart.d.ts +25 -9
  328. package/dist/diverging-bar-chart/diverging-bar-chart.js +26 -3
  329. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.d.ts +2 -2
  330. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.js +53 -15
  331. package/dist/divider/divider.d.ts +2 -2
  332. package/dist/divider/web/ds-divider.d.ts +1 -1
  333. package/dist/divider/web/ds-divider.js +2 -2
  334. package/dist/donut-chart/donut-chart.d.ts +26 -4
  335. package/dist/donut-chart/donut-chart.js +23 -2
  336. package/dist/donut-chart/web/ds-donut-chart.d.ts +6 -1
  337. package/dist/donut-chart/web/ds-donut-chart.js +50 -23
  338. package/dist/drawer/drawer.d.ts +51 -14
  339. package/dist/drawer/drawer.js +10 -4
  340. package/dist/drawer/native/ds-drawer.d.ts +4 -4
  341. package/dist/drawer/native/ds-drawer.js +20 -9
  342. package/dist/drawer/web/ds-drawer.d.ts +4 -4
  343. package/dist/drawer/web/ds-drawer.js +35 -18
  344. package/dist/dropdown-menu/dropdown-menu.d.ts +26 -21
  345. package/dist/dropdown-menu/dropdown-menu.js +14 -5
  346. package/dist/dropdown-menu/native/ds-dropdown-menu.d.ts +2 -2
  347. package/dist/dropdown-menu/native/ds-dropdown-menu.js +4 -3
  348. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.d.ts +9 -7
  349. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.js +11 -10
  350. package/dist/dropdown-menu/web/ds-dropdown-menu.d.ts +9 -6
  351. package/dist/dropdown-menu/web/ds-dropdown-menu.js +2 -2
  352. package/dist/dumbbell-chart/dumbbell-chart.d.ts +40 -0
  353. package/dist/dumbbell-chart/dumbbell-chart.js +33 -0
  354. package/dist/dumbbell-chart/web/ds-dumbbell-chart.d.ts +16 -0
  355. package/dist/dumbbell-chart/web/ds-dumbbell-chart.js +30 -0
  356. package/dist/editable-row/editable-row.d.ts +12 -3
  357. package/dist/editable-row/editable-row.js +7 -1
  358. package/dist/editable-row/web/ds-editable-row.d.ts +2 -2
  359. package/dist/editable-row/web/ds-editable-row.js +8 -6
  360. package/dist/empty-state/empty-state.d.ts +44 -5
  361. package/dist/empty-state/empty-state.js +22 -1
  362. package/dist/empty-state/native/ds-empty-state.d.ts +3 -3
  363. package/dist/empty-state/native/ds-empty-state.js +1 -1
  364. package/dist/empty-state/web/ds-empty-state.d.ts +26 -15
  365. package/dist/empty-state/web/ds-empty-state.js +16 -10
  366. package/dist/environment-banner/environment-banner.d.ts +10 -10
  367. package/dist/environment-banner/environment-banner.js +1 -1
  368. package/dist/environment-banner/web/ds-environment-banner.d.ts +2 -2
  369. package/dist/environment-banner/web/ds-environment-banner.js +7 -5
  370. package/dist/evaluation-trace/evaluation-trace.d.ts +4 -4
  371. package/dist/evaluation-trace/evaluation-trace.js +1 -1
  372. package/dist/evaluation-trace/web/ds-evaluation-trace.d.ts +1 -1
  373. package/dist/evaluation-trace/web/ds-evaluation-trace.js +8 -7
  374. package/dist/event-row/web/ds-event-row.d.ts +1 -1
  375. package/dist/event-row/web/ds-event-row.js +4 -2
  376. package/dist/facet-button/facet-button.d.ts +12 -4
  377. package/dist/facet-button/facet-button.js +2 -2
  378. package/dist/facet-button/web/ds-facet-button.d.ts +2 -2
  379. package/dist/facet-button/web/ds-facet-button.js +13 -15
  380. package/dist/facet-menu/facet-menu.d.ts +1 -1
  381. package/dist/facet-menu/facet-menu.js +2 -1
  382. package/dist/facet-menu/web/ds-facet-menu-row.d.ts +1 -1
  383. package/dist/facet-menu/web/ds-facet-menu.js +5 -4
  384. package/dist/fact/fact.d.ts +2 -2
  385. package/dist/fact/fact.js +1 -1
  386. package/dist/fact/native/ds-fact.d.ts +4 -1
  387. package/dist/fact/native/ds-fact.js +3 -2
  388. package/dist/field-rules/field-rules.d.ts +9 -9
  389. package/dist/figure/figure.d.ts +1 -1
  390. package/dist/figure/figure.js +1 -1
  391. package/dist/figure/native/ds-figure.js +4 -3
  392. package/dist/file-dropzone/file-dropzone.d.ts +64 -15
  393. package/dist/file-dropzone/file-dropzone.js +38 -20
  394. package/dist/file-dropzone/web/ds-file-dropzone.d.ts +3 -3
  395. package/dist/file-dropzone/web/ds-file-dropzone.js +17 -15
  396. package/dist/file-field/file-field.d.ts +30 -9
  397. package/dist/file-field/file-field.js +18 -8
  398. package/dist/file-field/web/ds-file-field.d.ts +9 -6
  399. package/dist/file-field/web/ds-file-field.js +8 -6
  400. package/dist/file-import/file-import.d.ts +58 -12
  401. package/dist/file-import/file-import.js +31 -12
  402. package/dist/file-import/web/ds-file-import.d.ts +9 -5
  403. package/dist/file-import/web/ds-file-import.js +11 -10
  404. package/dist/file-upload/file-upload.d.ts +74 -25
  405. package/dist/file-upload/file-upload.js +45 -31
  406. package/dist/file-upload/web/ds-file-upload.d.ts +14 -3
  407. package/dist/file-upload/web/ds-file-upload.js +18 -13
  408. package/dist/filter-bar/filter-bar.d.ts +4 -4
  409. package/dist/filter-bar/web/ds-filter-bar.d.ts +2 -2
  410. package/dist/filter-bar/web/ds-filter-bar.js +3 -2
  411. package/dist/filter-button/filter-button.d.ts +10 -9
  412. package/dist/filter-button/filter-button.js +1 -1
  413. package/dist/filter-button/web/ds-filter-button.d.ts +1 -1
  414. package/dist/filter-chip/filter-chip.d.ts +12 -12
  415. package/dist/filter-chip/web/ds-filter-chip.d.ts +1 -1
  416. package/dist/filter-chip/web/ds-filter-chip.js +4 -4
  417. package/dist/filter-popover/filter-popover.d.ts +3 -0
  418. package/dist/filter-popover/web/ds-filter-popover.d.ts +2 -2
  419. package/dist/filter-popover/web/ds-filter-popover.js +11 -5
  420. package/dist/form-field-group/form-field-group.d.ts +13 -8
  421. package/dist/form-field-group/form-field-group.js +2 -0
  422. package/dist/form-field-group/web/ds-form-field-group.js +3 -2
  423. package/dist/form-section/form-section.d.ts +4 -2
  424. package/dist/form-section/form-section.js +1 -1
  425. package/dist/form-section/web/ds-form-section.d.ts +2 -2
  426. package/dist/form-section/web/ds-form-section.js +3 -1
  427. package/dist/freshness-indicator/freshness-indicator.d.ts +4 -1
  428. package/dist/freshness-indicator/freshness-indicator.js +8 -2
  429. package/dist/freshness-indicator/web/ds-freshness-indicator.d.ts +1 -1
  430. package/dist/freshness-indicator/web/ds-freshness-indicator.js +4 -2
  431. package/dist/funnel/funnel.d.ts +6 -5
  432. package/dist/funnel/web/ds-funnel.d.ts +4 -4
  433. package/dist/funnel/web/ds-funnel.js +38 -35
  434. package/dist/gauge/gauge.d.ts +15 -4
  435. package/dist/gauge/gauge.js +20 -2
  436. package/dist/gauge/web/ds-gauge.d.ts +13 -3
  437. package/dist/gauge/web/ds-gauge.js +29 -11
  438. package/dist/geo/geo.d.ts +30 -15
  439. package/dist/geo/geo.js +112 -0
  440. package/dist/geofence-editor/geofence-editor.d.ts +22 -13
  441. package/dist/geofence-editor/geofence-editor.js +32 -7
  442. package/dist/geofence-editor/web/ds-geofence-editor.d.ts +24 -9
  443. package/dist/geofence-editor/web/ds-geofence-editor.js +46 -31
  444. package/dist/glass.d.ts +15 -15
  445. package/dist/glass.js +1 -1
  446. package/dist/gradient-card/gradient-card.d.ts +3 -3
  447. package/dist/gradient-card/web/ds-gradient-card.d.ts +2 -2
  448. package/dist/gradient-card/web/ds-gradient-card.js +1 -1
  449. package/dist/group-header/group-header.d.ts +1 -1
  450. package/dist/group-header/web/ds-group-header.d.ts +2 -2
  451. package/dist/group-header/web/ds-group-header.js +1 -1
  452. package/dist/heading/heading.d.ts +18 -0
  453. package/dist/heading/heading.js +14 -0
  454. package/dist/heading/native/ds-heading.d.ts +5 -0
  455. package/dist/heading/native/ds-heading.js +9 -0
  456. package/dist/heading/web/ds-heading.d.ts +5 -0
  457. package/dist/heading/web/ds-heading.js +10 -0
  458. package/dist/heatmap/heatmap-calendar.d.ts +95 -0
  459. package/dist/heatmap/heatmap-calendar.js +130 -0
  460. package/dist/heatmap/heatmap.d.ts +44 -6
  461. package/dist/heatmap/heatmap.js +63 -3
  462. package/dist/heatmap/web/ds-heatmap-calendar.d.ts +22 -0
  463. package/dist/heatmap/web/ds-heatmap-calendar.js +33 -0
  464. package/dist/heatmap/web/ds-heatmap.d.ts +24 -4
  465. package/dist/heatmap/web/ds-heatmap.js +72 -31
  466. package/dist/helper-text/helper-text.d.ts +13 -13
  467. package/dist/helper-text/helper-text.js +4 -4
  468. package/dist/helper-text/native/ds-helper-text.d.ts +1 -1
  469. package/dist/helper-text/native/ds-helper-text.js +2 -2
  470. package/dist/helper-text/web/ds-helper-text.d.ts +1 -1
  471. package/dist/helper-text/web/ds-helper-text.js +2 -2
  472. package/dist/histogram/histogram.d.ts +67 -0
  473. package/dist/histogram/histogram.js +79 -0
  474. package/dist/histogram/web/ds-histogram.d.ts +10 -0
  475. package/dist/histogram/web/ds-histogram.js +39 -0
  476. package/dist/hover-card/hover-card.d.ts +1 -1
  477. package/dist/hover-card/web/ds-hover-card.d.ts +1 -1
  478. package/dist/hover-card/web/ds-hover-card.js +3 -2
  479. package/dist/icon/icon.d.ts +11 -0
  480. package/dist/icon/icon.js +52 -0
  481. package/dist/icon/native/ds-icon-provider.d.ts +6 -1
  482. package/dist/icon/native/ds-icon-provider.js +4 -2
  483. package/dist/icon/native/icon-direction.d.ts +10 -0
  484. package/dist/icon/native/icon-direction.js +6 -0
  485. package/dist/icon/native/use-icon-size.d.ts +6 -0
  486. package/dist/icon/native/use-icon-size.js +12 -0
  487. package/dist/icon/web/ds-icon-provider.d.ts +3 -1
  488. package/dist/icon/web/ds-icon-provider.js +3 -1
  489. package/dist/icon/web/icon-direction.css +45 -0
  490. package/dist/icon-button/icon-button.d.ts +14 -8
  491. package/dist/icon-button/icon-button.js +1 -1
  492. package/dist/icon-button/native/ds-icon-button.d.ts +1 -1
  493. package/dist/icon-button/native/ds-icon-button.js +4 -3
  494. package/dist/icon-button/web/ds-icon-button.d.ts +2 -2
  495. package/dist/icon-button/web/ds-icon-button.js +11 -8
  496. package/dist/icon-frame/icon-frame.d.ts +25 -11
  497. package/dist/icon-frame/icon-frame.js +6 -2
  498. package/dist/icon-frame/native/ds-icon-frame.d.ts +1 -1
  499. package/dist/icon-frame/native/ds-icon-frame.js +26 -9
  500. package/dist/icon-frame/web/ds-icon-frame.d.ts +2 -2
  501. package/dist/icon-frame/web/ds-icon-frame.js +27 -8
  502. package/dist/icon-toggle-group/web/ds-icon-toggle-group.d.ts +5 -1
  503. package/dist/icon-toggle-group/web/ds-icon-toggle-group.js +2 -2
  504. package/dist/ident/ident.d.ts +6 -4
  505. package/dist/ident/ident.js +5 -0
  506. package/dist/ident/native/ds-ident.d.ts +30 -0
  507. package/dist/ident/native/ds-ident.js +13 -0
  508. package/dist/ident/web/ds-ident.js +1 -1
  509. package/dist/impersonation-banner/impersonation-banner.d.ts +2 -2
  510. package/dist/impersonation-banner/impersonation-banner.js +2 -2
  511. package/dist/impersonation-banner/web/ds-impersonation-banner.d.ts +5 -5
  512. package/dist/impersonation-banner/web/ds-impersonation-banner.js +2 -1
  513. package/dist/index.d.ts +124 -73
  514. package/dist/index.js +69 -44
  515. package/dist/inline-edit/inline-edit.d.ts +39 -9
  516. package/dist/inline-edit/inline-edit.js +19 -7
  517. package/dist/inline-edit/web/ds-inline-edit.d.ts +3 -3
  518. package/dist/inline-edit/web/ds-inline-edit.js +18 -11
  519. package/dist/input/input.d.ts +26 -13
  520. package/dist/input/input.js +18 -14
  521. package/dist/input/native/ds-input.js +3 -4
  522. package/dist/input/web/ds-input.d.ts +9 -3
  523. package/dist/input/web/ds-input.js +21 -16
  524. package/dist/interaction.d.ts +13 -11
  525. package/dist/interaction.js +3 -3
  526. package/dist/json-viewer/json-viewer.d.ts +17 -17
  527. package/dist/json-viewer/web/ds-json-viewer.d.ts +1 -1
  528. package/dist/json-viewer/web/ds-json-viewer.js +4 -3
  529. package/dist/kanban-board/kanban-board.d.ts +13 -13
  530. package/dist/kanban-board/web/ds-kanban-board.d.ts +1 -1
  531. package/dist/kanban-board/web/ds-kanban-board.js +6 -5
  532. package/dist/kbd/kbd.d.ts +6 -6
  533. package/dist/kbd/web/ds-kbd.js +2 -2
  534. package/dist/key-value-editor/key-value-editor.d.ts +72 -13
  535. package/dist/key-value-editor/key-value-editor.js +56 -26
  536. package/dist/key-value-editor/web/ds-key-value-editor.d.ts +2 -2
  537. package/dist/key-value-editor/web/ds-key-value-editor.js +18 -16
  538. package/dist/keypad/keypad.d.ts +25 -15
  539. package/dist/keypad/keypad.js +16 -10
  540. package/dist/keypad/native/ds-keypad.d.ts +1 -1
  541. package/dist/keypad/native/ds-keypad.js +13 -10
  542. package/dist/keypad/web/ds-keypad.d.ts +1 -1
  543. package/dist/keypad/web/ds-keypad.js +6 -5
  544. package/dist/label/label.d.ts +28 -28
  545. package/dist/label/label.js +6 -6
  546. package/dist/label/native/ds-label-group.js +5 -3
  547. package/dist/label/native/ds-label.d.ts +2 -2
  548. package/dist/label/native/ds-label.js +18 -13
  549. package/dist/label/web/ds-label-group.js +4 -3
  550. package/dist/label/web/ds-label.d.ts +2 -2
  551. package/dist/label/web/ds-label.js +17 -13
  552. package/dist/label-picker/label-picker.d.ts +43 -13
  553. package/dist/label-picker/label-picker.js +28 -17
  554. package/dist/label-picker/native/ds-label-picker.d.ts +1 -1
  555. package/dist/label-picker/native/ds-label-picker.js +16 -12
  556. package/dist/label-picker/web/ds-label-picker.d.ts +1 -1
  557. package/dist/label-picker/web/ds-label-picker.js +16 -14
  558. package/dist/labeled-divider/web/ds-labeled-divider.js +2 -1
  559. package/dist/labeled-field/labeled-field.d.ts +23 -8
  560. package/dist/labeled-field/labeled-field.js +7 -5
  561. package/dist/labeled-field/web/ds-labeled-field.d.ts +5 -5
  562. package/dist/labeled-field/web/ds-labeled-field.js +6 -2
  563. package/dist/leaderboard/leaderboard.d.ts +54 -0
  564. package/dist/leaderboard/leaderboard.js +38 -0
  565. package/dist/leaderboard/web/ds-leaderboard.d.ts +14 -0
  566. package/dist/leaderboard/web/ds-leaderboard.js +21 -0
  567. package/dist/legend/legend.d.ts +32 -3
  568. package/dist/legend/legend.js +5 -0
  569. package/dist/legend/web/ds-legend.d.ts +5 -2
  570. package/dist/legend/web/ds-legend.js +42 -26
  571. package/dist/lib/chart-context.d.ts +52 -0
  572. package/dist/lib/chart-context.js +24 -0
  573. package/dist/lib/chart-curve.js +7 -1
  574. package/dist/lib/chart-finish.d.ts +37 -20
  575. package/dist/lib/chart-finish.js +32 -23
  576. package/dist/lib/chart-hue.d.ts +4 -3
  577. package/dist/lib/chart-hue.js +1 -1
  578. package/dist/lib/chart-library.d.ts +2 -2
  579. package/dist/lib/chart-library.js +1 -1
  580. package/dist/lib/chart-palette.d.ts +7 -7
  581. package/dist/lib/chart-series.d.ts +58 -10
  582. package/dist/lib/chart-series.js +44 -4
  583. package/dist/lib/chart-table.d.ts +14 -0
  584. package/dist/lib/chart-table.js +14 -0
  585. package/dist/lib/chart-ticks.d.ts +35 -0
  586. package/dist/lib/chart-ticks.js +44 -0
  587. package/dist/lib/chart-value.d.ts +2 -0
  588. package/dist/lib/chart-value.js +8 -0
  589. package/dist/lib/cn.d.ts +3 -0
  590. package/dist/lib/cn.js +27 -24
  591. package/dist/lib/focus-order.d.ts +2 -2
  592. package/dist/lib/ink-child.d.ts +1 -1
  593. package/dist/lib/native/glass.d.ts +3 -3
  594. package/dist/lib/native/glass.js +1 -1
  595. package/dist/lib/native/text.d.ts +5 -0
  596. package/dist/lib/native/text.js +6 -0
  597. package/dist/lib/native/use-large-text.d.ts +3 -0
  598. package/dist/lib/native/use-large-text.js +9 -0
  599. package/dist/lib/overlay-stack.d.ts +11 -11
  600. package/dist/lib/sets-type.d.ts +1 -0
  601. package/dist/lib/sets-type.js +5 -0
  602. package/dist/lib/time-of-day.d.ts +21 -0
  603. package/dist/lib/time-of-day.js +37 -0
  604. package/dist/lib/use-theme-epoch.d.ts +4 -4
  605. package/dist/lib/use-theme-epoch.native.d.ts +7 -7
  606. package/dist/lib/web/assign-ref.d.ts +4 -0
  607. package/dist/lib/web/assign-ref.js +6 -0
  608. package/dist/lib/web/chart-figures.d.ts +25 -0
  609. package/dist/lib/web/chart-figures.js +25 -0
  610. package/dist/lib/web/chart-finish.d.ts +21 -7
  611. package/dist/lib/web/chart-finish.js +17 -3
  612. package/dist/lib/web/density.d.ts +1 -0
  613. package/dist/lib/web/density.js +12 -5
  614. package/dist/lib/web/focus-habits.js +20 -8
  615. package/dist/lib/web/focus-trap.d.ts +13 -3
  616. package/dist/lib/web/focus-trap.js +4 -1
  617. package/dist/lib/web/live-announcer.d.ts +2 -0
  618. package/dist/lib/web/live-announcer.js +2 -1
  619. package/dist/lib/web/map-glass.js +2 -2
  620. package/dist/lib/web/scroll-lock.d.ts +1 -1
  621. package/dist/lib/web/touch-target.d.ts +4 -4
  622. package/dist/lib/web/touch-target.js +3 -3
  623. package/dist/lib/web/use-anchored-surface.d.ts +6 -6
  624. package/dist/lib/web/use-anchored-surface.js +3 -2
  625. package/dist/lib/web/use-chart-points.d.ts +23 -0
  626. package/dist/lib/web/use-chart-points.js +58 -0
  627. package/dist/lib/web/use-overlay.d.ts +3 -3
  628. package/dist/lib/web/use-overlay.js +7 -1
  629. package/dist/list-page/list-page.d.ts +2 -1
  630. package/dist/list-page/web/ds-list-page.js +1 -5
  631. package/dist/list-row/list-row.d.ts +11 -11
  632. package/dist/list-row/list-row.js +4 -5
  633. package/dist/list-row/native/ds-list-row.js +11 -3
  634. package/dist/list-row/web/ds-list-row-group.d.ts +17 -0
  635. package/dist/list-row/web/ds-list-row-group.js +7 -0
  636. package/dist/list-row/web/ds-list-row.d.ts +15 -3
  637. package/dist/list-row/web/ds-list-row.js +18 -11
  638. package/dist/loading-screen/loading-screen.d.ts +10 -10
  639. package/dist/loading-screen/native/ds-loading-screen.d.ts +1 -1
  640. package/dist/loading-screen/native/ds-loading-screen.js +4 -3
  641. package/dist/loading-screen/web/ds-loading-screen.d.ts +1 -1
  642. package/dist/loading-screen/web/ds-loading-screen.js +3 -3
  643. package/dist/loading-state/loading-state.d.ts +9 -9
  644. package/dist/loading-state/web/ds-loading-state.js +1 -1
  645. package/dist/log-viewer/log-viewer.d.ts +22 -22
  646. package/dist/log-viewer/log-viewer.js +15 -3
  647. package/dist/log-viewer/web/ds-log-viewer.js +18 -8
  648. package/dist/map/map.d.ts +23 -18
  649. package/dist/map/map.js +4 -2
  650. package/dist/map/web/ds-map-fence.d.ts +2 -2
  651. package/dist/map/web/ds-map-fence.js +14 -13
  652. package/dist/map/web/ds-map-popup.d.ts +2 -2
  653. package/dist/map/web/ds-map-popup.js +1 -1
  654. package/dist/map/web/ds-map.d.ts +3 -3
  655. package/dist/map/web/ds-map.js +12 -5
  656. package/dist/map/web/map-provider.d.ts +7 -7
  657. package/dist/map-banner/map-banner.d.ts +4 -4
  658. package/dist/map-banner/map-banner.js +1 -1
  659. package/dist/map-banner/native/ds-map-banner.js +5 -5
  660. package/dist/map-banner/web/ds-map-banner.js +6 -5
  661. package/dist/map-controls/map-controls.d.ts +9 -11
  662. package/dist/map-controls/map-controls.js +5 -5
  663. package/dist/map-controls/native/ds-map-controls.d.ts +1 -1
  664. package/dist/map-controls/native/ds-map-controls.js +5 -4
  665. package/dist/map-controls/web/ds-map-controls.d.ts +1 -1
  666. package/dist/map-controls/web/ds-map-controls.js +4 -4
  667. package/dist/map-draw-toolbar/map-draw-toolbar.d.ts +3 -3
  668. package/dist/map-draw-toolbar/map-draw-toolbar.js +1 -1
  669. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.d.ts +1 -1
  670. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.js +5 -3
  671. package/dist/map-heatmap-layer/map-heatmap-layer.d.ts +25 -8
  672. package/dist/map-heatmap-layer/map-heatmap-layer.js +4 -0
  673. package/dist/map-heatmap-layer/web/ds-map-heatmap-layer.d.ts +19 -7
  674. package/dist/map-heatmap-layer/web/ds-map-heatmap-layer.js +15 -11
  675. package/dist/map-layers/map-layers.d.ts +2 -2
  676. package/dist/map-layers/map-layers.js +2 -2
  677. package/dist/map-layers/native/ds-map-layers.d.ts +5 -3
  678. package/dist/map-layers/native/ds-map-layers.js +8 -7
  679. package/dist/map-layers/web/ds-map-layers.d.ts +2 -2
  680. package/dist/map-layers/web/ds-map-layers.js +9 -8
  681. package/dist/map-list/map-list.d.ts +3 -2
  682. package/dist/map-list/web/ds-map-list.d.ts +1 -1
  683. package/dist/map-list/web/ds-map-list.js +19 -16
  684. package/dist/map-marker/map-marker.d.ts +7 -2
  685. package/dist/map-marker/map-marker.js +6 -0
  686. package/dist/map-marker/web/ds-map-marker.d.ts +13 -4
  687. package/dist/map-marker/web/ds-map-marker.js +21 -10
  688. package/dist/map-search/map-search.d.ts +11 -2
  689. package/dist/map-search/map-search.js +14 -1
  690. package/dist/map-search/native/ds-map-search.d.ts +11 -4
  691. package/dist/map-search/native/ds-map-search.js +33 -20
  692. package/dist/map-search/web/ds-map-search.d.ts +9 -4
  693. package/dist/map-search/web/ds-map-search.js +46 -29
  694. package/dist/map-search-area/map-search-area.d.ts +1 -1
  695. package/dist/map-search-area/map-search-area.js +1 -1
  696. package/dist/map-search-area/native/ds-map-search-area.d.ts +1 -1
  697. package/dist/map-search-area/native/ds-map-search-area.js +3 -2
  698. package/dist/map-search-area/web/ds-map-search-area.d.ts +1 -1
  699. package/dist/map-search-area/web/ds-map-search-area.js +4 -2
  700. package/dist/map-sheet/map-sheet.d.ts +7 -7
  701. package/dist/map-sheet/map-sheet.js +1 -1
  702. package/dist/map-sheet/native/ds-map-sheet.js +3 -3
  703. package/dist/map-sheet/web/ds-map-sheet.d.ts +1 -1
  704. package/dist/map-sheet/web/ds-map-sheet.js +15 -7
  705. package/dist/map-summary/map-summary.d.ts +2 -1
  706. package/dist/map-summary/web/ds-map-summary.d.ts +2 -2
  707. package/dist/map-summary/web/ds-map-summary.js +20 -8
  708. package/dist/measure.d.ts +3 -3
  709. package/dist/mention-input/mention-input.d.ts +36 -15
  710. package/dist/mention-input/mention-input.js +15 -8
  711. package/dist/mention-input/native/ds-mention-input.d.ts +2 -2
  712. package/dist/mention-input/native/ds-mention-input.js +11 -11
  713. package/dist/mention-input/web/ds-mention-input.d.ts +4 -4
  714. package/dist/mention-input/web/ds-mention-input.js +12 -9
  715. package/dist/menu-button/web/ds-menu-button.d.ts +2 -2
  716. package/dist/menu-button/web/ds-menu-button.js +14 -3
  717. package/dist/merchant-avatar/merchant-avatar.d.ts +6 -3
  718. package/dist/merchant-avatar/merchant-avatar.js +8 -0
  719. package/dist/merchant-avatar/native/ds-merchant-avatar.js +10 -9
  720. package/dist/merchant-avatar/web/ds-merchant-avatar.js +8 -8
  721. package/dist/meter/meter.d.ts +13 -6
  722. package/dist/meter/meter.js +7 -1
  723. package/dist/meter/native/ds-meter.d.ts +2 -2
  724. package/dist/meter/native/ds-meter.js +18 -6
  725. package/dist/meter/web/ds-meter.d.ts +8 -2
  726. package/dist/meter/web/ds-meter.js +22 -8
  727. package/dist/metric/metric.d.ts +17 -13
  728. package/dist/metric/native/ds-metric.d.ts +1 -1
  729. package/dist/metric/native/ds-metric.js +31 -19
  730. package/dist/metric/web/ds-metric.d.ts +1 -1
  731. package/dist/metric/web/ds-metric.js +22 -5
  732. package/dist/metric-card/metric-card.d.ts +61 -0
  733. package/dist/metric-card/metric-card.js +18 -0
  734. package/dist/metric-card/web/ds-metric-card.d.ts +24 -0
  735. package/dist/metric-card/web/ds-metric-card.js +19 -0
  736. package/dist/month-picker/month-picker.d.ts +2 -0
  737. package/dist/month-picker/web/ds-month-picker.d.ts +1 -1
  738. package/dist/month-picker/web/ds-month-picker.js +6 -4
  739. package/dist/month-strip/month-strip.d.ts +2 -0
  740. package/dist/month-strip/web/ds-month-strip.d.ts +3 -3
  741. package/dist/month-strip/web/ds-month-strip.js +12 -7
  742. package/dist/morph/morph.d.ts +10 -10
  743. package/dist/morph/native/ds-morph.d.ts +1 -1
  744. package/dist/morph/native/morph-provider.d.ts +2 -2
  745. package/dist/morph/web/ds-morph.d.ts +4 -4
  746. package/dist/motion.d.ts +50 -35
  747. package/dist/motion.js +15 -13
  748. package/dist/multi-select/multi-select.d.ts +47 -17
  749. package/dist/multi-select/multi-select.js +35 -22
  750. package/dist/multi-select/web/ds-multi-select.d.ts +1 -1
  751. package/dist/multi-select/web/ds-multi-select.js +47 -28
  752. package/dist/native.d.ts +18 -0
  753. package/dist/native.js +11 -0
  754. package/dist/notification-list/native/ds-notification-list.d.ts +2 -2
  755. package/dist/notification-list/native/ds-notification-list.js +19 -9
  756. package/dist/notification-list/notification-list.d.ts +6 -5
  757. package/dist/notification-list/web/ds-notification-list.d.ts +2 -2
  758. package/dist/notification-list/web/ds-notification-list.js +16 -9
  759. package/dist/number-field/native/ds-number-field.js +16 -8
  760. package/dist/number-field/number-field.d.ts +7 -7
  761. package/dist/number-field/web/ds-number-field.js +9 -8
  762. package/dist/otp/native/ds-otp-field.d.ts +1 -1
  763. package/dist/otp/native/ds-otp-field.js +11 -23
  764. package/dist/otp/native/ds-otp.js +4 -4
  765. package/dist/otp/otp.d.ts +17 -13
  766. package/dist/otp/web/ds-otp-field.d.ts +2 -2
  767. package/dist/otp/web/ds-otp-field.js +6 -1
  768. package/dist/otp/web/ds-otp.d.ts +1 -1
  769. package/dist/otp/web/ds-otp.js +6 -6
  770. package/dist/overflow-menu/web/ds-overflow-menu.js +14 -3
  771. package/dist/page-head/page-head.d.ts +4 -4
  772. package/dist/page-head/web/ds-page-head.d.ts +5 -3
  773. package/dist/page-head/web/ds-page-head.js +6 -2
  774. package/dist/pagination/web/ds-pagination.js +2 -1
  775. package/dist/panel/native/ds-panel.js +7 -4
  776. package/dist/panel/panel.d.ts +15 -15
  777. package/dist/panel/panel.js +7 -7
  778. package/dist/panel/web/ds-panel.d.ts +9 -5
  779. package/dist/panel/web/ds-panel.js +5 -3
  780. package/dist/password-feedback/password-feedback.d.ts +3 -3
  781. package/dist/password-feedback/web/ds-password-feedback.d.ts +1 -1
  782. package/dist/password-feedback/web/ds-password-feedback.js +5 -5
  783. package/dist/password-input/web/ds-password-input.d.ts +7 -2
  784. package/dist/password-input/web/ds-password-input.js +28 -3
  785. package/dist/password-requirements/password-requirements.d.ts +17 -7
  786. package/dist/password-requirements/password-requirements.js +6 -8
  787. package/dist/password-requirements/web/ds-password-requirements.js +5 -5
  788. package/dist/password-strength/password-strength.d.ts +5 -5
  789. package/dist/password-strength/web/ds-password-strength.d.ts +2 -2
  790. package/dist/password-strength/web/ds-password-strength.js +6 -4
  791. package/dist/payment-card/native/ds-payment-card.d.ts +1 -1
  792. package/dist/payment-card/native/ds-payment-card.js +6 -3
  793. package/dist/payment-card/payment-card.d.ts +2 -2
  794. package/dist/payment-card/web/ds-payment-card.d.ts +1 -1
  795. package/dist/payment-card/web/ds-payment-card.js +3 -2
  796. package/dist/people-cell/people-cell.d.ts +5 -2
  797. package/dist/people-cell/web/ds-people-cell.d.ts +1 -1
  798. package/dist/people-cell/web/ds-people-cell.js +7 -3
  799. package/dist/person-cell/person-cell.d.ts +6 -3
  800. package/dist/person-cell/web/ds-person-cell.d.ts +1 -1
  801. package/dist/person-cell/web/ds-person-cell.js +11 -1
  802. package/dist/phone-field/native/ds-phone-field.d.ts +1 -1
  803. package/dist/phone-field/native/ds-phone-field.js +7 -5
  804. package/dist/phone-field/phone-field.d.ts +48 -12
  805. package/dist/phone-field/phone-field.js +39 -1
  806. package/dist/phone-field/web/ds-phone-field.d.ts +33 -5
  807. package/dist/phone-field/web/ds-phone-field.js +58 -14
  808. package/dist/place-card/native/ds-place-card.d.ts +7 -3
  809. package/dist/place-card/native/ds-place-card.js +44 -25
  810. package/dist/place-card/place-card.d.ts +30 -24
  811. package/dist/place-card/place-card.js +6 -3
  812. package/dist/place-card/web/ds-place-card.d.ts +5 -3
  813. package/dist/place-card/web/ds-place-card.js +54 -32
  814. package/dist/plan-chart/plan-chart.d.ts +67 -0
  815. package/dist/plan-chart/plan-chart.js +42 -0
  816. package/dist/plan-chart/web/ds-plan-chart.d.ts +10 -0
  817. package/dist/plan-chart/web/ds-plan-chart.js +63 -0
  818. package/dist/popover/native/ds-popover.d.ts +1 -1
  819. package/dist/popover/popover.d.ts +9 -5
  820. package/dist/popover/web/ds-popover.d.ts +6 -2
  821. package/dist/popover/web/ds-popover.js +6 -4
  822. package/dist/presence-indicator/native/ds-presence-indicator.js +4 -3
  823. package/dist/presence-indicator/presence-indicator.d.ts +3 -3
  824. package/dist/presence-indicator/web/ds-presence-indicator.js +2 -2
  825. package/dist/price-pin/native/ds-price-pin.js +3 -2
  826. package/dist/price-pin/price-pin.d.ts +7 -7
  827. package/dist/price-pin/web/ds-price-pin.js +2 -2
  828. package/dist/priority-indicator/native/ds-priority-indicator.d.ts +1 -1
  829. package/dist/priority-indicator/native/ds-priority-indicator.js +7 -6
  830. package/dist/priority-indicator/priority-indicator.d.ts +8 -8
  831. package/dist/priority-indicator/priority-indicator.js +3 -3
  832. package/dist/priority-indicator/web/ds-priority-indicator.d.ts +1 -1
  833. package/dist/priority-indicator/web/ds-priority-indicator.js +5 -5
  834. package/dist/profile-card/profile-card.d.ts +3 -2
  835. package/dist/profile-card/web/ds-profile-card.d.ts +3 -3
  836. package/dist/profile-card/web/ds-profile-card.js +20 -5
  837. package/dist/progress-bar/native/ds-progress-bar.d.ts +1 -1
  838. package/dist/progress-bar/native/ds-progress-bar.js +3 -2
  839. package/dist/progress-bar/progress-bar.d.ts +8 -8
  840. package/dist/progress-bar/web/ds-progress-bar.d.ts +1 -1
  841. package/dist/progress-bar/web/ds-progress-bar.js +6 -5
  842. package/dist/progress-cell/progress-cell.d.ts +8 -3
  843. package/dist/progress-cell/progress-cell.js +2 -2
  844. package/dist/progress-cell/web/ds-progress-cell.d.ts +5 -2
  845. package/dist/progress-cell/web/ds-progress-cell.js +9 -2
  846. package/dist/progress-ring/native/ds-progress-ring.js +18 -11
  847. package/dist/progress-ring/progress-ring.d.ts +13 -9
  848. package/dist/progress-ring/progress-ring.js +7 -3
  849. package/dist/progress-ring/web/ds-progress-ring.d.ts +8 -2
  850. package/dist/progress-ring/web/ds-progress-ring.js +23 -11
  851. package/dist/promo-banner/web/ds-promo-banner.js +2 -1
  852. package/dist/proportion-bar/native/ds-proportion-bar.d.ts +2 -2
  853. package/dist/proportion-bar/native/ds-proportion-bar.js +21 -9
  854. package/dist/proportion-bar/proportion-bar.d.ts +13 -6
  855. package/dist/proportion-bar/proportion-bar.js +6 -1
  856. package/dist/proportion-bar/web/ds-proportion-bar.d.ts +1 -1
  857. package/dist/proportion-bar/web/ds-proportion-bar.js +21 -14
  858. package/dist/props.d.ts +2 -2
  859. package/dist/provider-button/provider-button.d.ts +6 -6
  860. package/dist/provider-button/web/ds-provider-button.d.ts +8 -8
  861. package/dist/qr-code/qr-code.d.ts +12 -12
  862. package/dist/qr-code/qr-matrix.d.ts +4 -4
  863. package/dist/qr-code/qr-matrix.js +1 -1
  864. package/dist/quick-actions/native/ds-quick-actions.js +19 -3
  865. package/dist/quick-actions/quick-actions.d.ts +34 -4
  866. package/dist/quick-actions/quick-actions.js +9 -1
  867. package/dist/quick-actions/web/ds-quick-actions.js +24 -7
  868. package/dist/radar-chart/radar-chart.d.ts +37 -12
  869. package/dist/radar-chart/radar-chart.js +41 -10
  870. package/dist/radar-chart/web/ds-radar-chart.d.ts +1 -1
  871. package/dist/radar-chart/web/ds-radar-chart.js +40 -41
  872. package/dist/radial-progress/native/ds-radial-progress.d.ts +6 -2
  873. package/dist/radial-progress/native/ds-radial-progress.js +51 -30
  874. package/dist/radial-progress/radial-progress.d.ts +21 -12
  875. package/dist/radial-progress/radial-progress.js +10 -1
  876. package/dist/radial-progress/web/ds-radial-progress.d.ts +6 -2
  877. package/dist/radial-progress/web/ds-radial-progress.js +41 -25
  878. package/dist/radio/radio.d.ts +15 -15
  879. package/dist/radio/radio.js +4 -4
  880. package/dist/radio/web/ds-radio.d.ts +7 -3
  881. package/dist/radio/web/ds-radio.js +29 -13
  882. package/dist/radio-group/radio-group.d.ts +44 -8
  883. package/dist/radio-group/radio-group.js +5 -0
  884. package/dist/radio-group/web/ds-radio-group.d.ts +3 -3
  885. package/dist/radio-group/web/ds-radio-group.js +7 -2
  886. package/dist/rating-badge/rating-badge.d.ts +8 -2
  887. package/dist/rating-badge/rating-badge.js +9 -1
  888. package/dist/rating-badge/web/ds-rating-badge.d.ts +2 -2
  889. package/dist/rating-badge/web/ds-rating-badge.js +6 -4
  890. package/dist/recipient-select/recipient-select.d.ts +15 -4
  891. package/dist/recipient-select/recipient-select.js +3 -0
  892. package/dist/recipient-select/web/ds-recipient-select.d.ts +2 -2
  893. package/dist/recipient-select/web/ds-recipient-select.js +6 -5
  894. package/dist/record-panel/record-panel.d.ts +18 -3
  895. package/dist/record-panel/web/ds-record-panel.d.ts +48 -13
  896. package/dist/record-panel/web/ds-record-panel.js +33 -16
  897. package/dist/recovery-actions/web/ds-recovery-actions.d.ts +1 -1
  898. package/dist/recovery-shell/web/ds-recovery-shell.js +1 -1
  899. package/dist/relative-time/native/ds-relative-time.js +2 -1
  900. package/dist/relative-time/relative-time.d.ts +4 -4
  901. package/dist/reorder-list/reorder-list.d.ts +5 -2
  902. package/dist/reorder-list/web/ds-reorder-list.d.ts +6 -1
  903. package/dist/reorder-list/web/ds-reorder-list.js +7 -4
  904. package/dist/resend-control/native/ds-resend-control.d.ts +24 -0
  905. package/dist/resend-control/native/ds-resend-control.js +73 -0
  906. package/dist/resend-control/resend-control.d.ts +5 -3
  907. package/dist/resend-control/resend-control.js +2 -0
  908. package/dist/resend-control/web/ds-resend-control.js +3 -3
  909. package/dist/route-fields/route-fields.d.ts +79 -0
  910. package/dist/route-fields/route-fields.js +71 -0
  911. package/dist/route-fields/web/ds-route-fields.d.ts +5 -0
  912. package/dist/route-fields/web/ds-route-fields.js +83 -0
  913. package/dist/route-line/route-line.d.ts +4 -4
  914. package/dist/route-line/web/ds-route-line.js +3 -3
  915. package/dist/route-stops/route-stops.d.ts +1 -1
  916. package/dist/route-stops/web/ds-route-stops.js +6 -3
  917. package/dist/row-actions-cell/web/ds-row-actions-cell.d.ts +4 -2
  918. package/dist/row-actions-cell/web/ds-row-actions-cell.js +2 -2
  919. package/dist/rule-summary/rule-summary.d.ts +8 -8
  920. package/dist/rule-summary/web/ds-rule-summary.d.ts +5 -5
  921. package/dist/rule-summary/web/ds-rule-summary.js +3 -2
  922. package/dist/save-bar/save-bar.d.ts +4 -4
  923. package/dist/save-bar/save-bar.js +2 -2
  924. package/dist/save-bar/web/ds-save-bar.js +3 -2
  925. package/dist/scale.d.ts +19 -19
  926. package/dist/scanner/native/ds-scanner.d.ts +5 -5
  927. package/dist/scanner/native/ds-scanner.js +4 -4
  928. package/dist/scanner/scanner.d.ts +21 -14
  929. package/dist/scanner/scanner.js +14 -9
  930. package/dist/scatter-chart/scatter-chart.d.ts +47 -0
  931. package/dist/scatter-chart/scatter-chart.js +15 -0
  932. package/dist/scatter-chart/web/ds-scatter-chart.d.ts +9 -0
  933. package/dist/scatter-chart/web/ds-scatter-chart.js +43 -0
  934. package/dist/schedule-chart/schedule-chart.d.ts +187 -0
  935. package/dist/schedule-chart/schedule-chart.js +285 -0
  936. package/dist/schedule-chart/web/ds-schedule-chart.d.ts +24 -0
  937. package/dist/schedule-chart/web/ds-schedule-chart.js +143 -0
  938. package/dist/scrim.d.ts +2 -2
  939. package/dist/scrim.js +1 -1
  940. package/dist/search-field/search-field.d.ts +3 -3
  941. package/dist/search-field/web/ds-search-field.d.ts +1 -1
  942. package/dist/search-field/web/ds-search-field.js +25 -6
  943. package/dist/section/native/ds-section.d.ts +5 -0
  944. package/dist/section/native/ds-section.js +9 -0
  945. package/dist/section/section-context.d.ts +1 -0
  946. package/dist/section/section-context.js +2 -0
  947. package/dist/section/section.d.ts +9 -0
  948. package/dist/section/section.js +8 -0
  949. package/dist/section/web/ds-section.d.ts +5 -0
  950. package/dist/section/web/ds-section.js +8 -0
  951. package/dist/section-nav/section-nav.d.ts +7 -7
  952. package/dist/section-nav/web/ds-section-nav.d.ts +2 -2
  953. package/dist/section-nav/web/ds-section-nav.js +2 -2
  954. package/dist/segmented-control/native/ds-segmented-control.d.ts +1 -1
  955. package/dist/segmented-control/native/ds-segmented-control.js +22 -10
  956. package/dist/segmented-control/segmented-control.d.ts +12 -5
  957. package/dist/segmented-control/web/ds-segmented-control.d.ts +1 -1
  958. package/dist/segmented-control/web/ds-segmented-control.js +4 -3
  959. package/dist/select/native/ds-select.d.ts +3 -3
  960. package/dist/select/native/ds-select.js +12 -8
  961. package/dist/select/select.d.ts +19 -14
  962. package/dist/select/web/ds-select-option-labels.d.ts +1 -1
  963. package/dist/select/web/ds-select-option-labels.js +2 -1
  964. package/dist/select/web/ds-select.d.ts +23 -10
  965. package/dist/select/web/ds-select.js +57 -22
  966. package/dist/settings-directory/native/ds-settings-directory.js +4 -2
  967. package/dist/settings-directory/web/ds-settings-directory.js +2 -1
  968. package/dist/settings-row/native/ds-settings-row.d.ts +2 -2
  969. package/dist/settings-row/native/ds-settings-row.js +4 -3
  970. package/dist/settings-row/settings-row.d.ts +3 -3
  971. package/dist/settings-row/web/ds-settings-row-group.d.ts +17 -0
  972. package/dist/settings-row/web/ds-settings-row-group.js +7 -0
  973. package/dist/settings-row/web/ds-settings-row.d.ts +7 -3
  974. package/dist/settings-row/web/ds-settings-row.js +4 -3
  975. package/dist/setup-guide/setup-guide.d.ts +19 -15
  976. package/dist/setup-guide/setup-guide.js +1 -0
  977. package/dist/setup-guide/web/ds-setup-guide.d.ts +5 -2
  978. package/dist/setup-guide/web/ds-setup-guide.js +12 -17
  979. package/dist/sheet/native/ds-sheet.d.ts +2 -2
  980. package/dist/sheet/native/ds-sheet.js +2 -2
  981. package/dist/sheet/sheet.d.ts +15 -15
  982. package/dist/sheet/sheet.js +2 -2
  983. package/dist/sheet/web/ds-sheet.d.ts +3 -3
  984. package/dist/sheet/web/ds-sheet.js +6 -4
  985. package/dist/side-nav/side-nav.d.ts +39 -38
  986. package/dist/side-nav/web/ds-side-nav-collapse.d.ts +4 -1
  987. package/dist/side-nav/web/ds-side-nav-collapse.js +6 -3
  988. package/dist/side-nav/web/ds-side-nav-header.d.ts +1 -1
  989. package/dist/side-nav/web/ds-side-nav-header.js +1 -1
  990. package/dist/side-nav/web/ds-side-nav-menu.d.ts +4 -4
  991. package/dist/side-nav/web/ds-side-nav-notifications.d.ts +3 -3
  992. package/dist/side-nav/web/ds-side-nav-notifications.js +2 -1
  993. package/dist/side-nav/web/ds-side-nav-primary.d.ts +2 -2
  994. package/dist/side-nav/web/ds-side-nav-primary.js +2 -2
  995. package/dist/side-nav/web/ds-side-nav-profile.d.ts +2 -2
  996. package/dist/side-nav/web/ds-side-nav-profile.js +3 -2
  997. package/dist/side-nav/web/ds-side-nav-search.d.ts +1 -1
  998. package/dist/side-nav/web/ds-side-nav-search.js +1 -1
  999. package/dist/side-nav/web/ds-side-nav.d.ts +12 -12
  1000. package/dist/side-nav/web/ds-side-nav.js +10 -9
  1001. package/dist/skeleton/native/ds-skeleton.js +10 -8
  1002. package/dist/skeleton/skeleton.d.ts +45 -25
  1003. package/dist/skeleton/skeleton.js +19 -15
  1004. package/dist/skeleton/web/ds-skeleton.js +44 -20
  1005. package/dist/slider/native/ds-slider.js +4 -3
  1006. package/dist/slider/slider.d.ts +6 -6
  1007. package/dist/slider/web/ds-slider.js +2 -2
  1008. package/dist/small-multiples/small-multiples.d.ts +48 -0
  1009. package/dist/small-multiples/small-multiples.js +41 -0
  1010. package/dist/small-multiples/web/ds-small-multiples.d.ts +10 -0
  1011. package/dist/small-multiples/web/ds-small-multiples.js +27 -0
  1012. package/dist/sparkline/sparkline.d.ts +26 -10
  1013. package/dist/sparkline/sparkline.js +44 -19
  1014. package/dist/sparkline/web/ds-sparkline.d.ts +1 -1
  1015. package/dist/sparkline/web/ds-sparkline.js +4 -5
  1016. package/dist/spinner/spinner.d.ts +3 -3
  1017. package/dist/split-pane/split-pane.d.ts +13 -13
  1018. package/dist/split-pane/web/ds-split-pane.d.ts +2 -2
  1019. package/dist/split-pane/web/ds-split-pane.js +4 -4
  1020. package/dist/stat-tile/native/ds-stat-tile.d.ts +4 -4
  1021. package/dist/stat-tile/native/ds-stat-tile.js +18 -13
  1022. package/dist/stat-tile/stat-tile.d.ts +26 -18
  1023. package/dist/stat-tile/stat-tile.js +5 -4
  1024. package/dist/stat-tile/web/ds-stat-tile.d.ts +8 -3
  1025. package/dist/stat-tile/web/ds-stat-tile.js +10 -6
  1026. package/dist/state-message/state-message.d.ts +1 -1
  1027. package/dist/state-message/state-message.js +7 -1
  1028. package/dist/state-message/web/ds-state-message.d.ts +6 -2
  1029. package/dist/state-message/web/ds-state-message.js +5 -2
  1030. package/dist/status-badge/native/ds-status-badge.js +5 -5
  1031. package/dist/status-badge/status-badge.d.ts +6 -6
  1032. package/dist/status-badge/status-badge.js +1 -1
  1033. package/dist/status-badge/web/ds-status-badge.d.ts +6 -6
  1034. package/dist/status-badge/web/ds-status-badge.js +5 -5
  1035. package/dist/status-cell/status-cell.d.ts +5 -2
  1036. package/dist/status-cell/web/ds-status-cell.d.ts +6 -2
  1037. package/dist/status-cell/web/ds-status-cell.js +9 -3
  1038. package/dist/status-control/status-control.d.ts +11 -9
  1039. package/dist/status-control/status-control.js +1 -1
  1040. package/dist/status-control/web/ds-status-control.d.ts +1 -1
  1041. package/dist/status-control/web/ds-status-control.js +6 -6
  1042. package/dist/status-dot/native/ds-status-dot.d.ts +1 -1
  1043. package/dist/status-dot/native/ds-status-dot.js +5 -3
  1044. package/dist/status-dot/status-dot.d.ts +13 -13
  1045. package/dist/status-dot/status-dot.js +2 -2
  1046. package/dist/status-dot/web/ds-status-dot.d.ts +1 -1
  1047. package/dist/status-dot/web/ds-status-dot.js +6 -4
  1048. package/dist/status-vocabularies.d.ts +2 -2
  1049. package/dist/stepper-form/stepper-form.d.ts +34 -11
  1050. package/dist/stepper-form/stepper-form.js +17 -9
  1051. package/dist/stepper-form/web/ds-stepper-form.d.ts +4 -4
  1052. package/dist/stepper-form/web/ds-stepper-form.js +9 -6
  1053. package/dist/steps/steps.d.ts +20 -7
  1054. package/dist/steps/steps.js +2 -1
  1055. package/dist/steps/web/ds-steps.d.ts +1 -1
  1056. package/dist/steps/web/ds-steps.js +58 -15
  1057. package/dist/stick-chart/stick-chart.d.ts +4 -3
  1058. package/dist/stick-chart/stick-chart.js +2 -1
  1059. package/dist/stick-chart/web/ds-stick-chart.d.ts +3 -3
  1060. package/dist/stick-chart/web/ds-stick-chart.js +29 -12
  1061. package/dist/switch/native/ds-switch.js +1 -1
  1062. package/dist/switch/switch.d.ts +2 -2
  1063. package/dist/switch/web/ds-switch.js +1 -1
  1064. package/dist/system-state/native/ds-system-state.d.ts +29 -0
  1065. package/dist/system-state/native/ds-system-state.js +68 -0
  1066. package/dist/system-state/system-state.d.ts +1 -1
  1067. package/dist/system-state/system-state.js +4 -3
  1068. package/dist/system-state/web/ds-system-state.d.ts +1 -1
  1069. package/dist/system-state/web/ds-system-state.js +3 -2
  1070. package/dist/table-toolbar/web/ds-table-toolbar.d.ts +3 -4
  1071. package/dist/table-toolbar/web/ds-table-toolbar.js +20 -4
  1072. package/dist/tabs/tabs.d.ts +15 -6
  1073. package/dist/tabs/tabs.js +15 -4
  1074. package/dist/tabs/web/ds-tabs.d.ts +1 -1
  1075. package/dist/tabs/web/ds-tabs.js +9 -6
  1076. package/dist/task/web/ds-task-editor.d.ts +3 -3
  1077. package/dist/task/web/ds-task-editor.js +2 -2
  1078. package/dist/task-shell/task-shell.d.ts +31 -18
  1079. package/dist/task-shell/task-shell.js +7 -3
  1080. package/dist/task-shell/web/ds-task-shell.d.ts +28 -13
  1081. package/dist/task-shell/web/ds-task-shell.js +57 -16
  1082. package/dist/text/native/ds-text.d.ts +5 -1
  1083. package/dist/text/native/ds-text.js +12 -10
  1084. package/dist/text/text.d.ts +88 -46
  1085. package/dist/text/text.js +76 -41
  1086. package/dist/text/web/ds-text.d.ts +1 -1
  1087. package/dist/text/web/ds-text.js +16 -10
  1088. package/dist/textarea/native/ds-textarea.d.ts +1 -1
  1089. package/dist/textarea/native/ds-textarea.js +15 -13
  1090. package/dist/textarea/web/ds-textarea.d.ts +1 -1
  1091. package/dist/textarea/web/ds-textarea.js +17 -14
  1092. package/dist/time-field/time-field.d.ts +37 -0
  1093. package/dist/time-field/time-field.js +23 -0
  1094. package/dist/time-field/web/ds-time-field.d.ts +8 -0
  1095. package/dist/time-field/web/ds-time-field.js +28 -0
  1096. package/dist/time-range/time-range.d.ts +40 -27
  1097. package/dist/time-range/time-range.js +28 -46
  1098. package/dist/time-range/web/ds-time-range.d.ts +1 -1
  1099. package/dist/time-range/web/ds-time-range.js +28 -11
  1100. package/dist/timeline/native/ds-timeline.d.ts +3 -3
  1101. package/dist/timeline/native/ds-timeline.js +25 -9
  1102. package/dist/timeline/timeline.d.ts +11 -10
  1103. package/dist/timeline/web/ds-timeline.d.ts +5 -5
  1104. package/dist/timeline/web/ds-timeline.js +19 -9
  1105. package/dist/toast/native/ds-toast.js +1 -1
  1106. package/dist/toast/toast.d.ts +4 -4
  1107. package/dist/toggle-group/native/ds-toggle-group.js +1 -1
  1108. package/dist/toggle-group/toggle-group.d.ts +6 -6
  1109. package/dist/token-roles.d.ts +2 -2
  1110. package/dist/token-roles.js +39 -4
  1111. package/dist/tone.d.ts +13 -13
  1112. package/dist/tone.js +2 -6
  1113. package/dist/toolbar/toolbar.d.ts +21 -9
  1114. package/dist/toolbar/toolbar.js +4 -3
  1115. package/dist/toolbar/web/ds-toolbar.d.ts +6 -3
  1116. package/dist/toolbar/web/ds-toolbar.js +3 -3
  1117. package/dist/tooltip/tooltip.d.ts +11 -11
  1118. package/dist/tooltip/tooltip.js +4 -4
  1119. package/dist/tooltip/web/ds-tooltip.d.ts +4 -4
  1120. package/dist/tooltip/web/ds-tooltip.js +1 -1
  1121. package/dist/track-bars/track-bars.d.ts +48 -0
  1122. package/dist/track-bars/track-bars.js +22 -0
  1123. package/dist/track-bars/web/ds-track-bars.d.ts +8 -0
  1124. package/dist/track-bars/web/ds-track-bars.js +30 -0
  1125. package/dist/trail-line/trail-line.d.ts +12 -12
  1126. package/dist/trail-line/trail-line.js +1 -1
  1127. package/dist/trail-line/web/ds-trail-line.d.ts +2 -2
  1128. package/dist/trail-line/web/ds-trail-line.js +13 -12
  1129. package/dist/tree/tree.d.ts +12 -12
  1130. package/dist/tree/tree.js +1 -1
  1131. package/dist/tree/web/ds-tree.d.ts +1 -1
  1132. package/dist/tree/web/ds-tree.js +7 -6
  1133. package/dist/treemap/treemap.d.ts +39 -0
  1134. package/dist/treemap/treemap.js +74 -0
  1135. package/dist/treemap/web/ds-treemap.d.ts +14 -0
  1136. package/dist/treemap/web/ds-treemap.js +40 -0
  1137. package/dist/trip-replay/trip-replay.d.ts +12 -12
  1138. package/dist/trip-replay/web/ds-trip-replay.d.ts +1 -1
  1139. package/dist/trip-replay/web/ds-trip-replay.js +2 -1
  1140. package/dist/two-line-cell/two-line-cell.d.ts +5 -2
  1141. package/dist/two-line-cell/web/ds-two-line-cell.d.ts +1 -1
  1142. package/dist/two-line-cell/web/ds-two-line-cell.js +6 -2
  1143. package/dist/value-row/native/ds-value-row.js +7 -2
  1144. package/dist/value-row/value-row.d.ts +3 -3
  1145. package/dist/vehicle-marker/vehicle-marker.d.ts +15 -14
  1146. package/dist/vehicle-marker/vehicle-marker.js +3 -3
  1147. package/dist/vehicle-marker/web/ds-vehicle-marker.d.ts +1 -1
  1148. package/dist/vehicle-marker/web/ds-vehicle-marker.js +11 -6
  1149. package/dist/waterfall-chart/waterfall-chart.d.ts +60 -0
  1150. package/dist/waterfall-chart/waterfall-chart.js +49 -0
  1151. package/dist/waterfall-chart/web/ds-waterfall-chart.d.ts +19 -0
  1152. package/dist/waterfall-chart/web/ds-waterfall-chart.js +69 -0
  1153. package/dist/web.d.ts +56 -7
  1154. package/dist/web.js +28 -3
  1155. package/dist/week-schedule/web/ds-week-schedule.d.ts +2 -2
  1156. package/dist/week-schedule/web/ds-week-schedule.js +7 -6
  1157. package/dist/week-schedule/week-schedule.d.ts +27 -8
  1158. package/dist/week-schedule/week-schedule.js +24 -15
  1159. package/forced-colors.css +43 -40
  1160. package/package.json +12 -17
  1161. package/styles.css +2 -2
@@ -1,5 +1,5 @@
1
1
  import { type ComponentProps, type ReactNode } from 'react';
2
- import { type FileFieldFile, type FileFieldRejection } from '../file-field';
2
+ import { type FileFieldCopy, type FileFieldFile, type FileFieldRejection } from '../file-field';
3
3
  /** What the caller says is happening to the file. See the contract: this
4
4
  * component does not upload, so every one of these is passed in. */
5
5
  export type DSFileFieldStatus = {
@@ -22,7 +22,7 @@ export type DSFileFieldStatus = {
22
22
  message: string;
23
23
  };
24
24
  export type DSFileFieldProps = Omit<ComponentProps<'div'>, 'children' | 'onSelect'> & {
25
- /** The words on the button — "Import CSV", "Attach licence disc". */
25
+ /** The words on the button, "Import CSV", "Attach licence disc". */
26
26
  label: string;
27
27
  /** HTML `accept`: `.csv,text/csv`, `image/*`. Set on the input AND checked
28
28
  * against the chosen file, because the attribute only filters the picker. */
@@ -33,7 +33,7 @@ export type DSFileFieldProps = Omit<ComponentProps<'div'>, 'children' | 'onSelec
33
33
  * `accept` and `maxBytes`. */
34
34
  onSelect: (file: File) => void;
35
35
  /** A file that did not pass. Gives the reason so a caller can word its own
36
- * message; the component says nothing on its own — see `rejection`. */
36
+ * message; the component says nothing on its own, see `rejection`. */
37
37
  onReject?: (reason: FileFieldRejection, file: File) => void;
38
38
  /** Where the caller has got to. */
39
39
  status?: DSFileFieldStatus;
@@ -41,7 +41,7 @@ export type DSFileFieldProps = Omit<ComponentProps<'div'>, 'children' | 'onSelec
41
41
  * the wording: only it knows whether "10 MB" or "ten pages" is the useful
42
42
  * thing to say. `false`, `null` and `''` mean nothing was refused. */
43
43
  rejection?: ReactNode;
44
- /** A line under the button when nothing has happened yet — "CSV, up to 10 MB". */
44
+ /** A line under the button when nothing has happened yet, "CSV, up to 10 MB". */
45
45
  hint?: ReactNode;
46
46
  /** Clears the chosen file. Its absence removes the control, which is right for
47
47
  * a field whose file cannot be taken back. */
@@ -49,6 +49,9 @@ export type DSFileFieldProps = Omit<ComponentProps<'div'>, 'children' | 'onSelec
49
49
  /** Offered only on `failed`. Its absence leaves the failure stated and final. */
50
50
  onRetry?: () => void;
51
51
  disabled?: boolean;
52
+ /** Replaces any of the words the field says itself (see `FileFieldCopy`).
53
+ * A `done` status's own `message` wins over `copy.uploaded`. */
54
+ copy?: Partial<FileFieldCopy>;
52
55
  };
53
- /** A file chosen from the machine, and what happens to it afterwards. */
54
- export declare function DSFileField({ label, accept, maxBytes, onSelect, onReject, status, rejection, hint, onRemove, onRetry, disabled, className, ...props }: DSFileFieldProps): import("react/jsx-runtime").JSX.Element;
56
+ /** A file chosen from the machine and what happens to it afterwards. */
57
+ export declare function DSFileField({ label, accept, maxBytes, onSelect, onReject, status, rejection, hint, onRemove, onRetry, disabled, copy, className, ...props }: DSFileFieldProps): import("react/jsx-runtime").JSX.Element;
@@ -1,7 +1,7 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { useId, useRef, useState } from 'react';
3
3
  import { Upload, X, RotateCcw } from 'lucide-react';
4
- import { fileFieldFormatSize, fileFieldNameParts, fileFieldPercent, fileFieldProgressText, fileFieldRejects, fileFieldSays, fileFieldSpec, } from '../file-field';
4
+ import { FILE_FIELD_COPY, fileFieldFormatSize, fileFieldNameParts, fileFieldPercent, fileFieldProgressText, fileFieldRejects, fileFieldSays, fileFieldSpec, } from '../file-field';
5
5
  import { DSButton } from '../../button/web/ds-button';
6
6
  import { DSHelperText } from '../../helper-text/web/ds-helper-text';
7
7
  import { DSIconButton } from '../../icon-button/web/ds-icon-button';
@@ -9,12 +9,14 @@ import { DSIdent } from '../../ident/web/ds-ident';
9
9
  import { DSMeter } from '../../meter/web/ds-meter';
10
10
  import { DSSpinner } from '../../spinner/web/ds-spinner';
11
11
  import { cn } from '../../lib/cn';
12
+ import { DSText } from '../../text/web/ds-text';
12
13
  const NAME_INK = { foreground: 'text-foreground' };
13
14
  const META_INK = {
14
15
  'muted-foreground': 'text-muted-foreground',
15
16
  };
16
- export function DSFileField({ label, accept, maxBytes, onSelect, onReject, status = { kind: 'idle' }, rejection, hint, onRemove, onRetry, disabled = false, className, ...props }) {
17
+ export function DSFileField({ label, accept, maxBytes, onSelect, onReject, status = { kind: 'idle' }, rejection, hint, onRemove, onRetry, disabled = false, copy, className, ...props }) {
17
18
  const spec = fileFieldSpec();
19
+ const words = { ...FILE_FIELD_COPY, ...copy };
18
20
  const inputId = useId();
19
21
  const inputRef = useRef(null);
20
22
  const file = status.kind === 'idle' ? undefined : status.file;
@@ -50,12 +52,12 @@ export function DSFileField({ label, accept, maxBytes, onSelect, onReject, statu
50
52
  setRefusals((count) => count + 1);
51
53
  }
52
54
  event.target.value = '';
53
- } })] }) }), hinted && _jsx(DSHelperText, { id: lineId, children: hint }), refused && (_jsx(DSHelperText, { id: lineId, tone: "error", announce: true, children: rejection }, refusals)), file !== undefined && name !== undefined && (_jsxs("div", { className: "flex flex-col gap-2 rounded-card border border-border bg-card p-3", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsxs(DSIdent, { className: cn('flex min-w-0', NAME_INK[spec.nameInk]), title: file.name, children: [_jsx("span", { className: "min-w-0 truncate", children: name.stem }), name.extension !== '' && _jsx("span", { className: "shrink-0", children: name.extension })] }), _jsx("span", { className: cn('shrink-0 text-body-sm', META_INK[spec.metaInk]), children: busy
54
- ? fileFieldProgressText(status.sent, status.total)
55
- : fileFieldFormatSize(file.size) }), busy && percent === undefined && (_jsx(DSSpinner, { label: `Uploading ${file.name}`, className: "ms-auto" })), onRemove !== undefined && !busy && (_jsx(DSIconButton, { variant: "ghost", size: "sm", label: `Remove ${file.name}`, icon: _jsx(X, { "aria-hidden": true }), onClick: () => {
55
+ } })] }) }), hinted && _jsx(DSHelperText, { id: lineId, children: hint }), refused && (_jsx(DSHelperText, { id: lineId, tone: "error", announce: true, children: rejection }, refusals)), file !== undefined && name !== undefined && (_jsxs("div", { className: "flex flex-col gap-2 rounded-card border border-border bg-card p-3", children: [_jsxs("div", { className: "flex min-w-0 items-center gap-2", children: [_jsxs(DSIdent, { className: cn('flex min-w-0', NAME_INK[spec.nameInk]), title: file.name, children: [_jsx("span", { className: "min-w-0 truncate", children: name.stem }), name.extension !== '' && _jsx("span", { className: "shrink-0", children: name.extension })] }), _jsx(DSText, { as: "span", variant: "body-sm", className: cn('shrink-0', META_INK[spec.metaInk]), children: busy
56
+ ? fileFieldProgressText(status.sent, status.total, words)
57
+ : fileFieldFormatSize(file.size, words) }), busy && percent === undefined && (_jsx(DSSpinner, { label: words.uploading(file.name), className: "ms-auto" })), onRemove !== undefined && !busy && (_jsx(DSIconButton, { variant: "ghost", size: "sm", label: words.remove(file.name), icon: _jsx(X, { "aria-hidden": true }), onClick: () => {
56
58
  onRemove();
57
59
  focusPicker();
58
- }, disabled: disabled, className: "ms-auto shrink-0" }))] }), busy && percent !== undefined && (_jsx(DSMeter, { value: percent, max: 100, label: `Uploading ${file.name}` })), status.kind === 'done' && (_jsx(DSHelperText, { tone: "success", announce: true, children: status.message ?? 'Uploaded.' })), status.kind === 'failed' && (_jsxs("div", { className: "flex items-start gap-2", children: [_jsx(DSHelperText, { tone: "error", announce: true, className: "min-w-0 flex-1", children: status.message }), onRetry !== undefined && (_jsx(DSIconButton, { variant: "ghost", size: "sm", label: `Retry uploading ${file.name}`, icon: _jsx(RotateCcw, { "aria-hidden": true }), onClick: () => {
60
+ }, disabled: disabled, className: "ms-auto shrink-0" }))] }), busy && percent !== undefined && (_jsx(DSMeter, { value: percent, max: 100, label: words.uploading(file.name) })), status.kind === 'done' && (_jsx(DSHelperText, { tone: "success", announce: true, children: status.message ?? words.uploaded })), status.kind === 'failed' && (_jsxs("div", { className: "flex items-start gap-2", children: [_jsx(DSHelperText, { tone: "error", announce: true, className: "min-w-0 flex-1", children: status.message }), onRetry !== undefined && (_jsx(DSIconButton, { variant: "ghost", size: "sm", label: words.retry(file.name), icon: _jsx(RotateCcw, { "aria-hidden": true }), onClick: () => {
59
61
  onRetry();
60
62
  focusPicker();
61
63
  }, disabled: disabled, className: "shrink-0" }))] }))] }))] }));
@@ -9,18 +9,18 @@ export interface ImportRow {
9
9
  * "row 118" is the only instruction that gets them to the right line.
10
10
  */
11
11
  line: number;
12
- /** How the row identifies itself — a registration, a name, an account number. */
12
+ /** How the row identifies itself, a registration, a name, an account number. */
13
13
  label: string;
14
14
  outcome: RowOutcome;
15
15
  /** Why it was rejected. Required in practice for `rejected`; see `rowsMissingReasons`. */
16
16
  reason?: string;
17
17
  }
18
- /** How many of each, and how many altogether. */
18
+ /** How many of each and how many altogether. */
19
19
  export interface ImportSummary {
20
20
  accepted: number;
21
21
  rejected: number;
22
22
  skipped: number;
23
- /** Every row read, blanks included — the number the person's sheet has. */
23
+ /** Every row read, blanks included, the number the person's sheet has. */
24
24
  total: number;
25
25
  }
26
26
  /** What this package will read as a bulk import. */
@@ -31,21 +31,67 @@ export declare function summarise(rows: readonly ImportRow[]): ImportSummary;
31
31
  * The shape of the outcome, which is what decides the wording and the tone.
32
32
  *
33
33
  * `partial` is the interesting one and the one the AC names: some rows landed
34
- * and some did not, and both facts have to be on screen at once.
34
+ * and some did not and both facts have to be on screen at once.
35
35
  */
36
36
  export type ImportResultKind = 'nothing-to-import' | 'all-accepted' | 'partial' | 'all-rejected';
37
37
  export declare function resultKind(summary: ImportSummary): ImportResultKind;
38
- /** The tone a result is drawn in — the package's own status vocabulary. */
38
+ /** The tone a result is drawn in, the package's own status vocabulary. */
39
39
  export declare function resultTone(kind: ImportResultKind): 'success' | 'warning' | 'danger' | 'info';
40
40
  /** Whether the accepted rows of this result are kept. */
41
41
  export declare function keepsAcceptedRows(kind: ImportResultKind): boolean;
42
- /** "396 of 400 rows imported. 4 rejected, 0 blank rows skipped." */
43
- export declare function announceSummary(summary: ImportSummary): string;
42
+ /** The words the importer says itself, so a locale can replace them.
43
+ * Defaults are English, held here and not in the adapter. The upload slot
44
+ * inside it takes its own words (`FileUploadCopy`), through `uploadCopy`. */
45
+ export interface FileImportCopy {
46
+ /** The template link's words. */
47
+ downloadTemplate: string;
48
+ /** Beside the template link. */
49
+ templateHint: string;
50
+ /** Names the upload slot inside the importer. */
51
+ spreadsheet: string;
52
+ /** A count of rows, given how many: "1 row", "4 rows". */
53
+ rows: (count: number) => string;
54
+ /** The summary when the file had no rows at all. */
55
+ noRows: string;
56
+ /** The summary when every row was blank, given the rows counted. */
57
+ allBlank: (rows: string) => string;
58
+ /** The summary's first sentence, given how many landed and the rows counted. */
59
+ imported: (accepted: number, rows: string) => string;
60
+ /** Added to the summary when rows were rejected, given the rows counted. */
61
+ rejected: (rows: string) => string;
62
+ /** Added to the summary when rows were blank, given the rows counted. */
63
+ skipped: (rows: string) => string;
64
+ /** Under a part success, given how many landed. */
65
+ kept: (accepted: number) => string;
66
+ /** Heads the table. */
67
+ rowByRow: string;
68
+ /** The line number column. */
69
+ columnRow: string;
70
+ /** The row's own label column. */
71
+ columnLabel: string;
72
+ /** The outcome column. */
73
+ columnOutcome: string;
74
+ /** The reason column. */
75
+ columnWhy: string;
76
+ /** The outcome word for a row that landed. */
77
+ outcomeAccepted: string;
78
+ /** The outcome word for a row that was rejected. */
79
+ outcomeRejected: string;
80
+ /** The outcome word for a blank row. */
81
+ outcomeSkipped: string;
82
+ /** A rejected row's reason when the caller gave none. */
83
+ noReason: string;
84
+ /** Under a result where nothing landed. */
85
+ nothingImported: string;
86
+ }
87
+ export declare const FILE_IMPORT_COPY: FileImportCopy;
88
+ /** "396 of 400 rows imported. 4 rows rejected." Pass the screen's copy to use its words. */
89
+ export declare function announceSummary(summary: ImportSummary, copy?: FileImportCopy): string;
44
90
  /**
45
91
  * The rows, in the file's own order.
46
92
  *
47
- * NOT rejected-first. The instinct is to float the failures to the top, and it
48
- * is wrong here: the person is going back to a spreadsheet, and a list that
93
+ * NOT rejected-first. The instinct is to float the failures to the top and it
94
+ * is wrong here: the person is going back to a spreadsheet and a list that
49
95
  * runs 118, 204, 7, 9 is a list they have to re-sort in their head before they
50
96
  * can work down it. `rejectedRows` is there for the summary; the table stays in
51
97
  * line order.
@@ -59,12 +105,12 @@ export declare function rejectedRows(rows: readonly ImportRow[]): ImportRow[];
59
105
  * A development-time check rather than a runtime one: "rejected" with no reason
60
106
  * is a row that tells somebody they are wrong and not how, which is the single
61
107
  * most useless thing an importer can print. The adapter renders a placeholder
62
- * rather than an empty cell, and this is how a caller finds out it is doing so.
108
+ * rather than an empty cell and this is how a caller finds out it is doing so.
63
109
  */
64
110
  export declare function rowsMissingReasons(rows: readonly ImportRow[]): ImportRow[];
65
111
  /** What a rejected row's reason cell says when the caller gave no reason. */
66
- export declare const UNSTATED_REASON = "No reason given";
112
+ export declare const UNSTATED_REASON: string;
67
113
  /** The reason to show for a row: the caller's, or the placeholder. */
68
- export declare function reasonFor(row: ImportRow): string;
114
+ export declare function reasonFor(row: ImportRow, copy?: Pick<FileImportCopy, 'noReason'>): string;
69
115
  /** The same reminder every grouped control in this package carries. */
70
116
  export declare const FILE_IMPORT_NEEDS_A_LABEL: string;
@@ -36,18 +36,37 @@ export function resultTone(kind) {
36
36
  export function keepsAcceptedRows(kind) {
37
37
  return kind === 'all-accepted' || kind === 'partial';
38
38
  }
39
- export function announceSummary(summary) {
40
- const rows = (count) => `${String(count)} ${count === 1 ? 'row' : 'rows'}`;
39
+ export const FILE_IMPORT_COPY = {
40
+ downloadTemplate: 'Download template',
41
+ templateHint: 'Start from the template. Its columns are the ones this reads.',
42
+ spreadsheet: 'Spreadsheet',
43
+ rows: (count) => `${String(count)} ${count === 1 ? 'row' : 'rows'}`,
44
+ noRows: 'The file has no rows.',
45
+ allBlank: (rows) => `Nothing to import. All ${rows} are blank.`,
46
+ imported: (accepted, rows) => `${String(accepted)} of ${rows} imported.`,
47
+ rejected: (rows) => `${rows} rejected.`,
48
+ skipped: (rows) => `${rows} blank and skipped.`,
49
+ kept: (accepted) => `The ${String(accepted)} that worked have been kept. Fix the rows below in your sheet and import those again.`,
50
+ rowByRow: 'Row by row',
51
+ columnRow: 'Row',
52
+ columnLabel: 'In the sheet',
53
+ columnOutcome: 'Outcome',
54
+ columnWhy: 'Why',
55
+ outcomeAccepted: 'Imported',
56
+ outcomeRejected: 'Rejected',
57
+ outcomeSkipped: 'Blank',
58
+ noReason: 'No reason given',
59
+ nothingImported: 'Nothing was imported, so nothing needs undoing.',
60
+ };
61
+ export function announceSummary(summary, copy = FILE_IMPORT_COPY) {
41
62
  if (resultKind(summary) === 'nothing-to-import') {
42
- return summary.total === 0
43
- ? 'The file has no rows.'
44
- : `Nothing to import. All ${rows(summary.skipped)} are blank.`;
63
+ return summary.total === 0 ? copy.noRows : copy.allBlank(copy.rows(summary.skipped));
45
64
  }
46
- const parts = [`${String(summary.accepted)} of ${rows(summary.total)} imported.`];
65
+ const parts = [copy.imported(summary.accepted, copy.rows(summary.total))];
47
66
  if (summary.rejected > 0)
48
- parts.push(`${rows(summary.rejected)} rejected.`);
67
+ parts.push(copy.rejected(copy.rows(summary.rejected)));
49
68
  if (summary.skipped > 0)
50
- parts.push(`${rows(summary.skipped)} blank and skipped.`);
69
+ parts.push(copy.skipped(copy.rows(summary.skipped)));
51
70
  return parts.join(' ');
52
71
  }
53
72
  export function orderRows(rows) {
@@ -59,10 +78,10 @@ export function rejectedRows(rows) {
59
78
  export function rowsMissingReasons(rows) {
60
79
  return rejectedRows(rows).filter((row) => (row.reason ?? '').trim() === '');
61
80
  }
62
- export const UNSTATED_REASON = 'No reason given';
63
- export function reasonFor(row) {
81
+ export const UNSTATED_REASON = FILE_IMPORT_COPY.noReason;
82
+ export function reasonFor(row, copy = FILE_IMPORT_COPY) {
64
83
  const reason = (row.reason ?? '').trim();
65
- return reason === '' ? UNSTATED_REASON : reason;
84
+ return reason === '' ? copy.noReason : reason;
66
85
  }
67
86
  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".';
87
+ 'aria-labelledby, for example "Import vehicles", "Import drivers" or "Import cost centres".';
@@ -1,8 +1,8 @@
1
1
  import { type ComponentProps } from 'react';
2
- import { type FileFact, type FileUploadHeadingLevel, type RejectionReason, type UploadPhase } from '../../file-upload/file-upload';
3
- import { type ImportRow } from '../file-import';
2
+ import { type FileFact, type FileUploadCopy, type FileUploadHeadingLevel, type RejectionReason, type UploadPhase } from '../../file-upload/file-upload';
3
+ import { type FileImportCopy, 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,9 +20,13 @@ 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
+ /** Replaces any of the words the importer says itself (see `FileImportCopy`). */
27
+ copy?: Partial<FileImportCopy>;
28
+ /** Replaces any of the words the upload slot inside it says (see `FileUploadCopy`). */
29
+ uploadCopy?: Partial<FileUploadCopy>;
26
30
  };
27
31
  /** A bulk import: download the template, upload the sheet, read what happened row by row. */
28
- export declare function DSFileImport({ phase, templateHref, templateName, file, progress, error, rows, maxBytes, onFileAccepted, onFileRejected, headingLevel, className, ...props }: DSFileImportProps): import("react/jsx-runtime").JSX.Element;
32
+ export declare function DSFileImport({ phase, templateHref, templateName, file, progress, error, rows, maxBytes, onFileAccepted, onFileRejected, headingLevel, copy, uploadCopy, className, ...props }: DSFileImportProps): import("react/jsx-runtime").JSX.Element;
@@ -8,29 +8,30 @@ import { DSFileUpload } from '../../file-upload/web/ds-file-upload';
8
8
  import { cn } from '../../lib/cn';
9
9
  import { announceLive } from '../../lib/web/live-announcer';
10
10
  import { FILE_UPLOAD_DEFAULT_HEADING_LEVEL, } from '../../file-upload/file-upload';
11
- import { IMPORT_ACCEPT, announceSummary, keepsAcceptedRows, orderRows, reasonFor, resultKind, resultTone, summarise, } from '../file-import';
11
+ import { FILE_IMPORT_COPY, IMPORT_ACCEPT, announceSummary, keepsAcceptedRows, orderRows, reasonFor, resultKind, resultTone, summarise, } from '../file-import';
12
12
  const OUTCOME_TONE = {
13
13
  accepted: 'success',
14
14
  rejected: 'error',
15
15
  skipped: 'neutral',
16
16
  };
17
- const OUTCOME_WORD = {
18
- accepted: 'Imported',
19
- rejected: 'Rejected',
20
- skipped: 'Blank',
21
- };
22
17
  const SUMMARY_SURFACE = {
23
18
  success: 'border-success-surface bg-success-surface',
24
19
  warning: 'border-warning-surface bg-warning-surface',
25
- danger: 'border-destructive-surface bg-destructive-surface',
20
+ danger: 'border-error-surface bg-error-surface',
26
21
  info: 'border-info-surface bg-info-surface',
27
22
  };
28
- export function DSFileImport({ phase, templateHref, templateName, file = null, progress = 0, error, rows = null, maxBytes, onFileAccepted, onFileRejected, headingLevel = FILE_UPLOAD_DEFAULT_HEADING_LEVEL, className, ...props }) {
23
+ export function DSFileImport({ phase, templateHref, templateName, file = null, progress = 0, error, rows = null, maxBytes, onFileAccepted, onFileRejected, headingLevel = FILE_UPLOAD_DEFAULT_HEADING_LEVEL, copy, uploadCopy, className, ...props }) {
24
+ const words = { ...FILE_IMPORT_COPY, ...copy };
25
+ const outcomeWord = {
26
+ accepted: words.outcomeAccepted,
27
+ rejected: words.outcomeRejected,
28
+ skipped: words.outcomeSkipped,
29
+ };
29
30
  const summaryId = useId();
30
31
  const tableId = useId();
31
32
  const summary = rows === null ? null : summarise(rows);
32
33
  const kind = summary === null ? null : resultKind(summary);
33
- const said = rows === null ? null : announceSummary(summarise(rows));
34
+ const said = rows === null ? null : announceSummary(summarise(rows), words);
34
35
  const lastSaid = useRef(null);
35
36
  useEffect(() => {
36
37
  if (said === null || phase !== 'uploaded') {
@@ -42,5 +43,5 @@ export function DSFileImport({ phase, templateHref, templateName, file = null, p
42
43
  lastSaid.current = said;
43
44
  announceLive(said);
44
45
  }, [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." }))] }));
46
+ 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" }), words.downloadTemplate] }) }), _jsx(DSText, { as: "span", variant: "body-sm", tone: "muted", children: words.templateHint })] }), _jsx(DSFileUpload, { "aria-label": words.spreadsheet, headingLevel: headingLevel, phase: phase, accept: IMPORT_ACCEPT, file: file, progress: progress, ...(error === undefined ? {} : { error }), ...(maxBytes === undefined ? {} : { maxBytes }), onFileAccepted: onFileAccepted, ...(onFileRejected === undefined ? {} : { onFileRejected }), ...(uploadCopy === undefined ? {} : { copy: uploadCopy }) }), 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, words) }), kind === 'partial' && (_jsx(DSText, { as: "p", variant: "body-sm", tone: "muted", className: "mt-1", children: words.kept(summary.accepted) }))] })), 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: words.rowByRow }), _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: words.columnRow }), _jsx("th", { scope: "col", className: "py-2 pr-3 font-semibold", children: words.columnLabel }), _jsx("th", { scope: "col", className: "py-2 pr-3 font-semibold", children: words.columnOutcome }), _jsx("th", { scope: "col", className: "py-2 font-semibold", children: words.columnWhy })] }) }), _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: outcomeWord[row.outcome] }) }), _jsx("td", { className: "py-2 text-muted-foreground [overflow-wrap:anywhere]", children: row.outcome === 'rejected' ? reasonFor(row, words) : '' })] }, row.line))) })] })] })), kind !== null && !keepsAcceptedRows(kind) && rows !== null && rows.length > 0 && (_jsx(DSText, { as: "p", variant: "body-sm", tone: "muted", children: words.nothingImported }))] }));
46
47
  }
@@ -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.
@@ -33,15 +33,16 @@ export declare function acceptAttribute(spec: AcceptSpec): string;
33
33
  /** The lower-case extension of a file name, dot included, or `''` where there is none. */
34
34
  export declare function extensionOf(name: string): string;
35
35
  /**
36
- * A size as a person reads it.
36
+ * A size as a person reads it, `1.4 MB`, and "Size unknown" for a number that
37
+ * is not one.
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
40
- * Explorer, macOS's Get Info and every mail client divide by 1024. Being
41
- * correct about SI here would mean telling somebody their 9.8 MB file is 10.2
42
- * MB and over a 10 MB limit.
39
+ * NOT A FORMATTER OF ITS OWN. This slot used to keep one that said "1023
40
+ * bytes", "1.0 KB" and a dash for an unknown size, while the file field beside
41
+ * it said "1023 B", "1 KB" and "Size unknown". Every file control now reads
42
+ * sizes through `fileFieldFormatSize`, so a limit and a size cannot come from
43
+ * two definitions. The name stays for the callers that already use it.
43
44
  */
44
- export declare function formatFileSize(bytes: number): string;
45
+ export declare const formatFileSize: (bytes: number) => string;
45
46
  /** Why a chosen file cannot be used. */
46
47
  export type RejectionReason = 'type' | 'size' | 'empty';
47
48
  /**
@@ -49,26 +50,73 @@ export type RejectionReason = 'type' | 'size' | 'empty';
49
50
  *
50
51
  * ORDER MATTERS AND IT IS EMPTY, TYPE, SIZE. A 0-byte `.exe` is refused for
51
52
  * 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
53
+ * the fact that will actually help, a failed export and a wrong file are
53
54
  * different mistakes with different fixes.
54
55
  */
55
56
  export declare function checkFile(file: FileFact, spec: AcceptSpec, maxBytes?: number): RejectionReason | null;
57
+ /** The words the upload slot says itself, so a locale can replace them.
58
+ * Defaults are English, held here and not in the adapter. */
59
+ export interface FileUploadCopy {
60
+ /** Names the slot's group, given its `aria-label`. */
61
+ group: (label: string) => string;
62
+ /** Under the icon while there is no file, given the kinds and the limit. */
63
+ hint: (kinds: string, limit: string) => string;
64
+ /** The picker's words while there is no file. */
65
+ choose: string;
66
+ /** The picker's words once there is one. */
67
+ replace: string;
68
+ /** The picker's name, given its words and the slot's label. */
69
+ picker: (action: string, label: string) => string;
70
+ /** Names the remove control, given the file's name. */
71
+ remove: (name: string) => string;
72
+ /** Names the progress bar, given the file's name. */
73
+ uploading: (name: string) => string;
74
+ /** Beside the bar, given the whole percent. */
75
+ percent: (percent: number) => string;
76
+ /** Said as the upload moves, given the file's name and a whole percent. */
77
+ uploadingStatus: (name: string, percent: number) => string;
78
+ /** Said when the upload has finished, given the file's name. */
79
+ uploadedStatus: (name: string) => string;
80
+ /** On `error` when the caller gave no `error` of its own. */
81
+ failed: string;
82
+ /** On `offline`. */
83
+ offline: string;
84
+ /** Heads the list of earlier versions. */
85
+ earlierVersions: string;
86
+ /** Refusal: the file is empty, given its name. */
87
+ emptyFile: (name: string) => string;
88
+ /** Refusal: the file is a kind this does not take, given its name and the kinds it would
89
+ * take with their article (`a PDF or PNG`), or `anotherKind` when the slot names none. */
90
+ wrongKind: (name: string, kinds: string) => string;
91
+ /** Refusal: the file is too large, given its name, its size and the limit. */
92
+ tooLarge: (name: string, size: string, limit: string) => string;
93
+ /** The kinds when the slot names none. */
94
+ anyKind: string;
95
+ /** Joins the kinds, given all but the last (already joined) and the last. */
96
+ kindsOr: (rest: string, last: string) => string;
97
+ /** The kinds with their article: "a PDF", "an XLSX". A kind is read out letter by letter,
98
+ * so the article follows the sound of its first letter, not its spelling. */
99
+ aKind: (kinds: string) => string;
100
+ /** What to ask for when the slot names no kinds. */
101
+ anotherKind: string;
102
+ }
103
+ export declare const FILE_UPLOAD_COPY: FileUploadCopy;
56
104
  /**
57
105
  * What to put on screen when a file is refused.
58
106
  *
59
- * Every one of these names the FILE and the LIMIT, because a message that says
60
- * only "invalid file" leaves somebody to guess which of the two things they got
61
- * wrong, and they will guess the other one.
107
+ * Every one of these names the FILE and what will work, because a message that
108
+ * says only "invalid file" leaves somebody to guess which of the two things
109
+ * they got wrong and they will guess the other one.
62
110
  */
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. */
65
- export declare function listKinds(spec: AcceptSpec): string;
111
+ export declare function rejectionMessage(reason: RejectionReason, file: FileFact, spec: AcceptSpec, maxBytes?: number, copy?: FileUploadCopy): string;
112
+ /** `PDF, PNG or JPG`, an Oxford-free list, because this is a sentence and not a spec. */
113
+ export declare function listKinds(spec: AcceptSpec, copy?: FileUploadCopy): string;
66
114
  /**
67
115
  * Where the slot is.
68
116
  *
69
117
  * `offline` is a STATE and not an error, which is the distinction the story's
70
118
  * 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
119
+ * not a rejected file, nothing about the file is wrong and telling somebody
72
120
  * to try a different one would be the wrong instruction.
73
121
  */
74
122
  export type UploadPhase = 'empty' | 'chosen' | 'uploading' | 'uploaded' | 'error' | 'offline';
@@ -79,17 +127,17 @@ export declare function clampProgress(percent: number): number;
79
127
  /**
80
128
  * What a screen reader is told while an upload runs.
81
129
  *
82
- * COARSE ON PURPOSE — every ten percent, and only then. A live region that
130
+ * COARSE ON PURPOSE, every ten percent and only then. A live region that
83
131
  * updates on every progress event interrupts itself into silence on some screen
84
132
  * readers and into a stutter on the rest; the caller sends whatever it has and
85
133
  * this decides whether it is worth saying.
86
134
  */
87
135
  export declare function progressWorthAnnouncing(previous: number | null, next: number): boolean;
88
136
  /** "Uploading statement.pdf, 40 percent." */
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. */
137
+ export declare function announceProgress(name: string, percent: number, copy?: FileUploadCopy): string;
138
+ /** An earlier file in the same slot: what it was, when it landed and who put it there. */
91
139
  export interface FileVersion extends FileFact {
92
- /** When it was uploaded. An instant, unlike a calendar date — see `../date-picker/date-picker.ts`. */
140
+ /** When it was uploaded. An instant, unlike a calendar date, see `../date-picker/date-picker.ts`. */
93
141
  uploadedAt: Date;
94
142
  /** Who uploaded it, as the audit trail names them. */
95
143
  actor: string;
@@ -97,13 +145,14 @@ export interface FileVersion extends FileFact {
97
145
  /**
98
146
  * Prior versions, newest first.
99
147
  *
100
- * NEWEST FIRST, and a stable tie-break by name so two versions uploaded in the
148
+ * NEWEST FIRST and a stable tie-break by name so two versions uploaded in the
101
149
  * 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
150
+ * the caller's array: this is handed a prop and sorting a prop in place
103
151
  * mutates the caller's state from inside a render.
104
152
  */
105
153
  export declare function orderVersions(versions: readonly FileVersion[]): FileVersion[];
106
- /** "statement.pdf · 1.4 MB · 12 August 2026 · Thembi Maseko" */
154
+ /** "statement.pdf · 1.4 MB · 12 Aug 2026 · Thembi Maseko": the date as every
155
+ * record shows one, day first with the month short. */
107
156
  export declare function describeVersion(version: FileVersion): string;
108
157
  /** The heading levels the "Earlier versions" title may take: it sits inside a
109
158
  * caller's own page, so the caller says where in the outline it belongs. */