@tfn-design/design-system 0.3.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 (749) hide show
  1. package/README.md +2 -2
  2. package/dist/accordion/accordion.d.ts +1 -1
  3. package/dist/accordion/accordion.js +1 -1
  4. package/dist/accordion/web/ds-accordion.js +5 -4
  5. package/dist/account-password-field/account-password-field.js +1 -1
  6. package/dist/account-switcher/account-switcher.d.ts +11 -4
  7. package/dist/account-switcher/account-switcher.js +2 -1
  8. package/dist/account-switcher/web/ds-account-switcher.js +12 -4
  9. package/dist/ai-attachment/ai-attachment.d.ts +1 -1
  10. package/dist/ai-attachment/ai-attachment.js +1 -1
  11. package/dist/ai-attachment/web/ds-ai-attachment.js +1 -1
  12. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.js +2 -2
  13. package/dist/ai-composer/ai-composer.d.ts +1 -1
  14. package/dist/ai-composer/ai-composer.js +1 -1
  15. package/dist/ai-composer/native/ds-ai-composer.js +4 -2
  16. package/dist/ai-composer/web/ds-ai-composer.js +2 -3
  17. package/dist/ai-confirmation/ai-confirmation.d.ts +19 -3
  18. package/dist/ai-confirmation/ai-confirmation.js +18 -3
  19. package/dist/ai-confirmation/native/ds-ai-confirmation.js +18 -13
  20. package/dist/ai-confirmation/web/ds-ai-confirmation.d.ts +1 -1
  21. package/dist/ai-confirmation/web/ds-ai-confirmation.js +22 -11
  22. package/dist/ai-context-scope/ai-context-scope.d.ts +10 -2
  23. package/dist/ai-context-scope/ai-context-scope.js +11 -2
  24. package/dist/ai-context-scope/native/ds-ai-context-scope.js +4 -3
  25. package/dist/ai-context-scope/web/ds-ai-context-scope.js +19 -5
  26. package/dist/ai-conversation-list/ai-conversation-list.d.ts +16 -0
  27. package/dist/ai-conversation-list/ai-conversation-list.js +8 -0
  28. package/dist/ai-conversation-list/web/ds-ai-conversation-list.d.ts +10 -6
  29. package/dist/ai-conversation-list/web/ds-ai-conversation-list.js +89 -47
  30. package/dist/ai-diff/ai-diff.d.ts +13 -1
  31. package/dist/ai-diff/ai-diff.js +12 -1
  32. package/dist/ai-diff/native/ds-ai-diff.d.ts +1 -1
  33. package/dist/ai-diff/native/ds-ai-diff.js +4 -6
  34. package/dist/ai-diff/web/ds-ai-diff.d.ts +0 -4
  35. package/dist/ai-diff/web/ds-ai-diff.js +16 -9
  36. package/dist/ai-draft-panel/ai-draft-panel.d.ts +2 -0
  37. package/dist/ai-draft-panel/ai-draft-panel.js +5 -0
  38. package/dist/ai-draft-panel/web/ds-ai-draft-panel.d.ts +3 -1
  39. package/dist/ai-draft-panel/web/ds-ai-draft-panel.js +4 -4
  40. package/dist/ai-empty-state/native/ds-ai-empty-state.js +2 -2
  41. package/dist/ai-empty-state/web/ds-ai-empty-state.js +3 -1
  42. package/dist/ai-error-state/ai-error-state.d.ts +2 -2
  43. package/dist/ai-error-state/ai-error-state.js +2 -2
  44. package/dist/ai-error-state/native/ds-ai-error-state.d.ts +5 -1
  45. package/dist/ai-error-state/native/ds-ai-error-state.js +2 -1
  46. package/dist/ai-error-state/web/ds-ai-error-state.d.ts +5 -1
  47. package/dist/ai-error-state/web/ds-ai-error-state.js +3 -2
  48. package/dist/ai-label/native/ds-ai-label.js +2 -1
  49. package/dist/ai-label/web/ds-ai-label.js +1 -1
  50. package/dist/ai-message/ai-message.d.ts +1 -1
  51. package/dist/ai-message/ai-message.js +1 -1
  52. package/dist/ai-message/native/ds-ai-message.js +4 -3
  53. package/dist/ai-message/web/ds-ai-message-markdown.js +3 -3
  54. package/dist/ai-message/web/ds-ai-message.js +4 -3
  55. package/dist/ai-message-actions/ai-message-actions.d.ts +1 -1
  56. package/dist/ai-message-actions/ai-message-actions.js +1 -1
  57. package/dist/ai-message-actions/native/ds-ai-message-actions.js +1 -1
  58. package/dist/ai-message-actions/web/ds-ai-message-actions.js +1 -1
  59. package/dist/ai-plan/ai-plan.d.ts +1 -1
  60. package/dist/ai-plan/ai-plan.js +1 -1
  61. package/dist/ai-plan/web/ds-ai-plan.js +2 -2
  62. package/dist/ai-side-nav/web/ds-ai-side-nav.js +4 -3
  63. package/dist/ai-summary-card/native/ds-ai-summary-card.js +2 -1
  64. package/dist/ai-summary-card/web/ds-ai-summary-card.js +2 -1
  65. package/dist/ai-thread/web/ds-ai-thread.js +1 -1
  66. package/dist/ai-tool-call/ai-tool-call.d.ts +1 -1
  67. package/dist/ai-tool-call/ai-tool-call.js +1 -1
  68. package/dist/ai-tool-call/native/ds-ai-tool-call.js +3 -2
  69. package/dist/ai-tool-call/web/ds-ai-tool-call.js +4 -3
  70. package/dist/alert/native/ds-alert.js +4 -4
  71. package/dist/alert/web/ds-alert.js +5 -5
  72. package/dist/ambient-gradient/ambient-gradient.d.ts +1 -1
  73. package/dist/amount/amount.d.ts +1 -1
  74. package/dist/amount/amount.js +3 -2
  75. package/dist/amount/native/ds-amount.js +1 -1
  76. package/dist/amount/web/ds-amount.js +1 -1
  77. package/dist/amount-cell/amount-cell.d.ts +5 -2
  78. package/dist/amount-cell/web/ds-amount-cell.d.ts +1 -1
  79. package/dist/amount-cell/web/ds-amount-cell.js +7 -1
  80. package/dist/amount-entry/amount-entry.d.ts +28 -2
  81. package/dist/amount-entry/amount-entry.js +19 -12
  82. package/dist/amount-entry/native/ds-amount-entry.d.ts +1 -1
  83. package/dist/amount-entry/native/ds-amount-entry.js +5 -4
  84. package/dist/amount-entry/web/ds-amount-entry.d.ts +1 -1
  85. package/dist/amount-entry/web/ds-amount-entry.js +5 -4
  86. package/dist/app-shell/app-shell.d.ts +2 -0
  87. package/dist/app-shell/web/ds-app-shell.js +26 -3
  88. package/dist/approval-chain/approval-chain.d.ts +6 -2
  89. package/dist/approval-chain/approval-chain.js +4 -4
  90. package/dist/approval-chain/native/ds-approval-chain.js +16 -9
  91. package/dist/approval-chain/web/ds-approval-chain.d.ts +7 -1
  92. package/dist/approval-chain/web/ds-approval-chain.js +12 -11
  93. package/dist/auth-shell/web/ds-auth-shell.d.ts +5 -1
  94. package/dist/auth-shell/web/ds-auth-shell.js +5 -2
  95. package/dist/balance-header/balance-header.d.ts +8 -4
  96. package/dist/balance-header/native/ds-balance-header.d.ts +3 -3
  97. package/dist/balance-header/native/ds-balance-header.js +11 -4
  98. package/dist/balance-header/web/ds-balance-header.d.ts +1 -1
  99. package/dist/balance-header/web/ds-balance-header.js +7 -4
  100. package/dist/bar-chart/bar-chart.d.ts +46 -5
  101. package/dist/bar-chart/bar-chart.js +64 -6
  102. package/dist/bar-chart/web/ds-bar-chart.d.ts +21 -4
  103. package/dist/bar-chart/web/ds-bar-chart.js +121 -50
  104. package/dist/bottom-nav/bottom-nav.d.ts +8 -3
  105. package/dist/bottom-nav/bottom-nav.js +2 -2
  106. package/dist/bottom-nav/web/ds-bottom-nav.js +2 -2
  107. package/dist/box-plot/box-plot.d.ts +150 -0
  108. package/dist/box-plot/box-plot.js +124 -0
  109. package/dist/box-plot/web/ds-box-plot.d.ts +8 -0
  110. package/dist/box-plot/web/ds-box-plot.js +57 -0
  111. package/dist/brand-lockup/native/ds-brand-lockup.js +1 -1
  112. package/dist/brand-provider/brand-provider.d.ts +29 -0
  113. package/dist/brand-provider/brand-provider.js +9 -0
  114. package/dist/brand-provider/native/ds-brand-provider.d.ts +11 -0
  115. package/dist/brand-provider/native/ds-brand-provider.js +18 -0
  116. package/dist/brand-provider/web/ds-brand-provider.d.ts +10 -0
  117. package/dist/brand-provider/web/ds-brand-provider.js +20 -0
  118. package/dist/bullet-chart/bullet-chart.d.ts +12 -7
  119. package/dist/bullet-chart/bullet-chart.js +5 -4
  120. package/dist/bullet-chart/web/ds-bullet-chart.d.ts +1 -1
  121. package/dist/bullet-chart/web/ds-bullet-chart.js +9 -4
  122. package/dist/button/button.d.ts +1 -1
  123. package/dist/button/native/ds-button.js +2 -2
  124. package/dist/button/web/ds-button.js +1 -1
  125. package/dist/button-group/button-group.d.ts +1 -1
  126. package/dist/button-group/web/ds-button-group.d.ts +2 -2
  127. package/dist/calendar/calendar.d.ts +13 -2
  128. package/dist/calendar/calendar.js +4 -3
  129. package/dist/calendar/web/ds-calendar.d.ts +1 -1
  130. package/dist/calendar/web/ds-calendar.js +6 -5
  131. package/dist/card-carousel/native/ds-card-carousel.js +1 -1
  132. package/dist/card-carousel/web/ds-card-carousel.js +2 -2
  133. package/dist/chart/chart.d.ts +180 -64
  134. package/dist/chart/chart.js +367 -118
  135. package/dist/chart/web/ds-chart.d.ts +17 -7
  136. package/dist/chart/web/ds-chart.js +85 -108
  137. package/dist/check-option/check-option.d.ts +1 -1
  138. package/dist/check-option/check-option.js +1 -1
  139. package/dist/check-option/web/ds-check-option.d.ts +6 -1
  140. package/dist/check-option/web/ds-check-option.js +10 -6
  141. package/dist/checkbox/checkbox.d.ts +2 -2
  142. package/dist/checkbox/checkbox.js +2 -2
  143. package/dist/checkbox/native/ds-checkbox.js +1 -1
  144. package/dist/checkbox/web/checkbox-mark.js +1 -1
  145. package/dist/checkbox/web/ds-checkbox.d.ts +2 -2
  146. package/dist/checkbox/web/ds-checkbox.js +17 -6
  147. package/dist/chip/chip.d.ts +11 -11
  148. package/dist/chip/chip.js +5 -3
  149. package/dist/chip/native/ds-chip.js +1 -1
  150. package/dist/chip/web/ds-chip.js +6 -6
  151. package/dist/code-block/web/ds-code-block.js +3 -3
  152. package/dist/column-picker/web/ds-column-picker.js +2 -1
  153. package/dist/combobox/combobox.d.ts +2 -2
  154. package/dist/combobox/web/ds-combobox.js +4 -2
  155. package/dist/command-palette/command-palette.d.ts +4 -0
  156. package/dist/comment-thread/comment-thread.d.ts +2 -2
  157. package/dist/comment-thread/comment-thread.js +2 -2
  158. package/dist/comment-thread/native/ds-comment-thread.js +10 -9
  159. package/dist/comment-thread/web/ds-comment-thread.js +11 -10
  160. package/dist/condition-builder/condition-builder.d.ts +96 -4
  161. package/dist/condition-builder/condition-builder.js +68 -28
  162. package/dist/condition-builder/web/ds-condition-builder.d.ts +4 -2
  163. package/dist/condition-builder/web/ds-condition-builder.js +97 -57
  164. package/dist/context-switcher/context-switcher.d.ts +10 -1
  165. package/dist/context-switcher/context-switcher.js +5 -2
  166. package/dist/context-switcher/web/ds-context-switcher.d.ts +1 -1
  167. package/dist/context-switcher/web/ds-context-switcher.js +4 -3
  168. package/dist/coordinate-field/coordinate-field.d.ts +46 -5
  169. package/dist/coordinate-field/coordinate-field.js +35 -18
  170. package/dist/coordinate-field/native/ds-coordinate-field.d.ts +1 -1
  171. package/dist/coordinate-field/native/ds-coordinate-field.js +9 -8
  172. package/dist/coordinate-field/web/ds-coordinate-field.d.ts +1 -1
  173. package/dist/coordinate-field/web/ds-coordinate-field.js +10 -9
  174. package/dist/copy-field/copy-field.d.ts +23 -9
  175. package/dist/copy-field/copy-field.js +11 -6
  176. package/dist/copy-field/web/ds-copy-field.d.ts +1 -1
  177. package/dist/copy-field/web/ds-copy-field.js +6 -5
  178. package/dist/copy.d.ts +8 -0
  179. package/dist/copy.js +7 -0
  180. package/dist/count-badge/web/ds-count-badge.js +1 -1
  181. package/dist/countdown/native/ds-countdown.js +1 -1
  182. package/dist/countdown/web/ds-countdown.js +1 -1
  183. package/dist/dashboard-shell/dashboard-shell.d.ts +4 -2
  184. package/dist/data-table/web/data-table-theme.css +340 -52
  185. package/dist/data-table/web/ds-data-table.d.ts +43 -1
  186. package/dist/data-table/web/ds-data-table.js +165 -17
  187. package/dist/date-field/web/ds-date-field.d.ts +1 -1
  188. package/dist/date-field/web/ds-date-field.js +6 -5
  189. package/dist/date-input/date-input.d.ts +26 -5
  190. package/dist/date-input/date-input.js +34 -2
  191. package/dist/date-input/web/ds-date-input.js +13 -4
  192. package/dist/date-picker/date-picker.d.ts +38 -67
  193. package/dist/date-picker/date-picker.js +26 -60
  194. package/dist/date-picker/web/ds-date-picker.d.ts +13 -6
  195. package/dist/date-picker/web/ds-date-picker.js +41 -10
  196. package/dist/date-range-picker/web/ds-date-range-picker.d.ts +10 -4
  197. package/dist/date-range-picker/web/ds-date-range-picker.js +8 -5
  198. package/dist/day-picker/day-picker.d.ts +1 -1
  199. package/dist/day-picker/web/ds-day-picker.js +1 -1
  200. package/dist/delta/delta.d.ts +15 -1
  201. package/dist/delta/delta.js +20 -0
  202. package/dist/delta/native/ds-delta.d.ts +5 -2
  203. package/dist/delta/native/ds-delta.js +4 -3
  204. package/dist/delta/web/ds-delta.d.ts +5 -2
  205. package/dist/delta/web/ds-delta.js +4 -3
  206. package/dist/description-list/description-list.d.ts +4 -2
  207. package/dist/description-list/native/ds-description-list.d.ts +2 -2
  208. package/dist/description-list/native/ds-description-list.js +49 -27
  209. package/dist/description-list/web/ds-description-list.d.ts +2 -2
  210. package/dist/description-list/web/ds-description-list.js +40 -17
  211. package/dist/dialog/dialog.d.ts +12 -1
  212. package/dist/dialog/web/ds-dialog.d.ts +1 -1
  213. package/dist/dialog/web/ds-dialog.js +5 -3
  214. package/dist/diverging-bar-chart/diverging-bar-chart.d.ts +2 -1
  215. package/dist/diverging-bar-chart/diverging-bar-chart.js +2 -1
  216. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.d.ts +1 -1
  217. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.js +28 -5
  218. package/dist/donut-chart/donut-chart.d.ts +7 -1
  219. package/dist/donut-chart/donut-chart.js +4 -0
  220. package/dist/donut-chart/web/ds-donut-chart.d.ts +4 -1
  221. package/dist/donut-chart/web/ds-donut-chart.js +43 -24
  222. package/dist/drawer/drawer.d.ts +42 -5
  223. package/dist/drawer/drawer.js +10 -4
  224. package/dist/drawer/native/ds-drawer.d.ts +1 -1
  225. package/dist/drawer/native/ds-drawer.js +17 -7
  226. package/dist/drawer/web/ds-drawer.d.ts +1 -1
  227. package/dist/drawer/web/ds-drawer.js +32 -17
  228. package/dist/dropdown-menu/dropdown-menu.d.ts +10 -5
  229. package/dist/dropdown-menu/dropdown-menu.js +13 -4
  230. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.d.ts +4 -2
  231. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.js +6 -6
  232. package/dist/dropdown-menu/web/ds-dropdown-menu.d.ts +5 -2
  233. package/dist/dropdown-menu/web/ds-dropdown-menu.js +2 -2
  234. package/dist/dumbbell-chart/dumbbell-chart.d.ts +10 -9
  235. package/dist/dumbbell-chart/dumbbell-chart.js +18 -4
  236. package/dist/dumbbell-chart/web/ds-dumbbell-chart.d.ts +4 -1
  237. package/dist/dumbbell-chart/web/ds-dumbbell-chart.js +13 -3
  238. package/dist/editable-row/editable-row.d.ts +5 -1
  239. package/dist/editable-row/editable-row.js +7 -1
  240. package/dist/editable-row/web/ds-editable-row.js +7 -5
  241. package/dist/empty-state/empty-state.d.ts +39 -0
  242. package/dist/empty-state/empty-state.js +21 -0
  243. package/dist/empty-state/web/ds-empty-state.d.ts +19 -8
  244. package/dist/empty-state/web/ds-empty-state.js +15 -3
  245. package/dist/environment-banner/environment-banner.d.ts +1 -1
  246. package/dist/environment-banner/environment-banner.js +1 -1
  247. package/dist/environment-banner/web/ds-environment-banner.js +3 -3
  248. package/dist/evaluation-trace/evaluation-trace.d.ts +1 -1
  249. package/dist/evaluation-trace/evaluation-trace.js +1 -1
  250. package/dist/evaluation-trace/web/ds-evaluation-trace.js +1 -1
  251. package/dist/event-row/web/ds-event-row.d.ts +1 -1
  252. package/dist/event-row/web/ds-event-row.js +2 -1
  253. package/dist/facet-button/facet-button.d.ts +9 -1
  254. package/dist/facet-button/facet-button.js +2 -2
  255. package/dist/facet-button/web/ds-facet-button.d.ts +1 -1
  256. package/dist/facet-button/web/ds-facet-button.js +9 -5
  257. package/dist/facet-menu/facet-menu.d.ts +1 -1
  258. package/dist/facet-menu/facet-menu.js +2 -1
  259. package/dist/facet-menu/web/ds-facet-menu.js +1 -1
  260. package/dist/fact/native/ds-fact.d.ts +4 -1
  261. package/dist/file-dropzone/file-dropzone.d.ts +54 -5
  262. package/dist/file-dropzone/file-dropzone.js +38 -20
  263. package/dist/file-dropzone/web/ds-file-dropzone.d.ts +1 -1
  264. package/dist/file-dropzone/web/ds-file-dropzone.js +16 -15
  265. package/dist/file-field/file-field.d.ts +26 -5
  266. package/dist/file-field/file-field.js +18 -8
  267. package/dist/file-field/web/ds-file-field.d.ts +5 -2
  268. package/dist/file-field/web/ds-file-field.js +6 -5
  269. package/dist/file-import/file-import.d.ts +50 -4
  270. package/dist/file-import/file-import.js +30 -11
  271. package/dist/file-import/web/ds-file-import.d.ts +7 -3
  272. package/dist/file-import/web/ds-file-import.js +11 -10
  273. package/dist/file-upload/file-upload.d.ts +64 -15
  274. package/dist/file-upload/file-upload.js +44 -30
  275. package/dist/file-upload/web/ds-file-upload.d.ts +11 -2
  276. package/dist/file-upload/web/ds-file-upload.js +17 -12
  277. package/dist/filter-bar/web/ds-filter-bar.js +1 -1
  278. package/dist/filter-button/filter-button.d.ts +5 -4
  279. package/dist/filter-button/filter-button.js +1 -1
  280. package/dist/filter-chip/web/ds-filter-chip.js +2 -2
  281. package/dist/filter-popover/web/ds-filter-popover.js +2 -1
  282. package/dist/form-field-group/form-field-group.d.ts +7 -2
  283. package/dist/form-field-group/form-field-group.js +2 -0
  284. package/dist/form-field-group/web/ds-form-field-group.js +2 -1
  285. package/dist/form-section/form-section.d.ts +4 -2
  286. package/dist/form-section/form-section.js +1 -1
  287. package/dist/funnel/funnel.d.ts +2 -1
  288. package/dist/funnel/web/ds-funnel.d.ts +1 -1
  289. package/dist/funnel/web/ds-funnel.js +22 -12
  290. package/dist/gauge/gauge.d.ts +6 -1
  291. package/dist/gauge/gauge.js +9 -1
  292. package/dist/gauge/web/ds-gauge.d.ts +8 -3
  293. package/dist/gauge/web/ds-gauge.js +26 -15
  294. package/dist/geo/geo.d.ts +15 -0
  295. package/dist/geo/geo.js +112 -0
  296. package/dist/geofence-editor/geofence-editor.d.ts +14 -5
  297. package/dist/geofence-editor/geofence-editor.js +32 -7
  298. package/dist/geofence-editor/web/ds-geofence-editor.d.ts +18 -3
  299. package/dist/geofence-editor/web/ds-geofence-editor.js +28 -13
  300. package/dist/group-header/web/ds-group-header.d.ts +1 -1
  301. package/dist/heatmap/heatmap-calendar.d.ts +95 -0
  302. package/dist/heatmap/heatmap-calendar.js +130 -0
  303. package/dist/heatmap/heatmap.d.ts +35 -8
  304. package/dist/heatmap/heatmap.js +61 -7
  305. package/dist/heatmap/web/ds-heatmap-calendar.d.ts +22 -0
  306. package/dist/heatmap/web/ds-heatmap-calendar.js +33 -0
  307. package/dist/heatmap/web/ds-heatmap.d.ts +21 -1
  308. package/dist/heatmap/web/ds-heatmap.js +59 -31
  309. package/dist/helper-text/native/ds-helper-text.js +2 -2
  310. package/dist/helper-text/web/ds-helper-text.js +2 -2
  311. package/dist/histogram/histogram.d.ts +2 -3
  312. package/dist/histogram/web/ds-histogram.d.ts +1 -1
  313. package/dist/histogram/web/ds-histogram.js +8 -2
  314. package/dist/icon/icon.d.ts +11 -0
  315. package/dist/icon/icon.js +52 -0
  316. package/dist/icon/native/ds-icon-provider.d.ts +6 -1
  317. package/dist/icon/native/ds-icon-provider.js +4 -2
  318. package/dist/icon/native/icon-direction.d.ts +10 -0
  319. package/dist/icon/native/icon-direction.js +6 -0
  320. package/dist/icon/native/use-icon-size.d.ts +6 -0
  321. package/dist/icon/native/use-icon-size.js +12 -0
  322. package/dist/icon/web/ds-icon-provider.d.ts +3 -1
  323. package/dist/icon/web/ds-icon-provider.js +1 -0
  324. package/dist/icon/web/icon-direction.css +45 -0
  325. package/dist/icon-button/icon-button.d.ts +6 -0
  326. package/dist/icon-button/native/ds-icon-button.d.ts +1 -1
  327. package/dist/icon-button/native/ds-icon-button.js +2 -1
  328. package/dist/icon-button/web/ds-icon-button.d.ts +1 -1
  329. package/dist/icon-button/web/ds-icon-button.js +8 -5
  330. package/dist/icon-frame/icon-frame.d.ts +2 -2
  331. package/dist/icon-frame/native/ds-icon-frame.js +3 -3
  332. package/dist/icon-frame/web/ds-icon-frame.js +3 -3
  333. package/dist/ident/ident.d.ts +2 -0
  334. package/dist/ident/ident.js +5 -0
  335. package/dist/ident/native/ds-ident.d.ts +30 -0
  336. package/dist/ident/native/ds-ident.js +13 -0
  337. package/dist/index.d.ts +88 -65
  338. package/dist/index.js +47 -36
  339. package/dist/inline-edit/inline-edit.d.ts +34 -4
  340. package/dist/inline-edit/inline-edit.js +19 -7
  341. package/dist/inline-edit/web/ds-inline-edit.d.ts +1 -1
  342. package/dist/inline-edit/web/ds-inline-edit.js +13 -8
  343. package/dist/input/input.d.ts +18 -5
  344. package/dist/input/input.js +17 -13
  345. package/dist/input/native/ds-input.js +1 -1
  346. package/dist/input/web/ds-input.d.ts +7 -1
  347. package/dist/input/web/ds-input.js +11 -9
  348. package/dist/interaction.d.ts +7 -5
  349. package/dist/interaction.js +1 -1
  350. package/dist/json-viewer/web/ds-json-viewer.js +1 -1
  351. package/dist/key-value-editor/key-value-editor.d.ts +57 -3
  352. package/dist/key-value-editor/key-value-editor.js +56 -26
  353. package/dist/key-value-editor/web/ds-key-value-editor.d.ts +1 -1
  354. package/dist/key-value-editor/web/ds-key-value-editor.js +15 -16
  355. package/dist/keypad/keypad.d.ts +21 -11
  356. package/dist/keypad/keypad.js +16 -10
  357. package/dist/keypad/native/ds-keypad.d.ts +1 -1
  358. package/dist/keypad/native/ds-keypad.js +10 -8
  359. package/dist/keypad/web/ds-keypad.d.ts +1 -1
  360. package/dist/keypad/web/ds-keypad.js +5 -4
  361. package/dist/label-picker/label-picker.d.ts +34 -4
  362. package/dist/label-picker/label-picker.js +28 -17
  363. package/dist/label-picker/native/ds-label-picker.d.ts +1 -1
  364. package/dist/label-picker/native/ds-label-picker.js +11 -10
  365. package/dist/label-picker/web/ds-label-picker.d.ts +1 -1
  366. package/dist/label-picker/web/ds-label-picker.js +11 -10
  367. package/dist/labeled-field/labeled-field.d.ts +17 -2
  368. package/dist/labeled-field/labeled-field.js +7 -5
  369. package/dist/labeled-field/web/ds-labeled-field.d.ts +1 -1
  370. package/dist/labeled-field/web/ds-labeled-field.js +6 -2
  371. package/dist/leaderboard/leaderboard.d.ts +4 -3
  372. package/dist/leaderboard/leaderboard.js +4 -1
  373. package/dist/leaderboard/web/ds-leaderboard.d.ts +1 -1
  374. package/dist/leaderboard/web/ds-leaderboard.js +8 -3
  375. package/dist/legend/legend.d.ts +4 -0
  376. package/dist/legend/legend.js +1 -0
  377. package/dist/legend/web/ds-legend.js +18 -11
  378. package/dist/lib/chart-context.d.ts +23 -3
  379. package/dist/lib/chart-context.js +9 -3
  380. package/dist/lib/chart-finish.d.ts +13 -6
  381. package/dist/lib/chart-finish.js +8 -2
  382. package/dist/lib/chart-library.d.ts +1 -1
  383. package/dist/lib/chart-series.d.ts +7 -4
  384. package/dist/lib/chart-series.js +2 -4
  385. package/dist/lib/chart-ticks.d.ts +11 -0
  386. package/dist/lib/chart-ticks.js +11 -0
  387. package/dist/lib/chart-value.d.ts +1 -1
  388. package/dist/lib/chart-value.js +3 -1
  389. package/dist/lib/cn.d.ts +1 -0
  390. package/dist/lib/cn.js +7 -2
  391. package/dist/lib/time-of-day.d.ts +21 -0
  392. package/dist/lib/time-of-day.js +37 -0
  393. package/dist/lib/web/chart-finish.d.ts +1 -1
  394. package/dist/lib/web/chart-finish.js +1 -1
  395. package/dist/lib/web/density.d.ts +1 -0
  396. package/dist/lib/web/density.js +7 -0
  397. package/dist/lib/web/focus-habits.js +20 -8
  398. package/dist/lib/web/focus-trap.d.ts +10 -0
  399. package/dist/lib/web/focus-trap.js +4 -1
  400. package/dist/lib/web/live-announcer.d.ts +2 -0
  401. package/dist/lib/web/live-announcer.js +2 -1
  402. package/dist/lib/web/touch-target.d.ts +4 -4
  403. package/dist/lib/web/touch-target.js +3 -3
  404. package/dist/lib/web/use-anchored-surface.js +3 -2
  405. package/dist/lib/web/use-overlay.js +7 -1
  406. package/dist/list-page/list-page.d.ts +2 -1
  407. package/dist/list-page/web/ds-list-page.js +1 -5
  408. package/dist/list-row/list-row.d.ts +6 -6
  409. package/dist/list-row/list-row.js +4 -5
  410. package/dist/list-row/native/ds-list-row.js +7 -2
  411. package/dist/list-row/web/ds-list-row-group.d.ts +6 -2
  412. package/dist/list-row/web/ds-list-row-group.js +4 -2
  413. package/dist/list-row/web/ds-list-row.js +9 -9
  414. package/dist/loading-screen/native/ds-loading-screen.js +1 -1
  415. package/dist/log-viewer/log-viewer.d.ts +2 -2
  416. package/dist/log-viewer/log-viewer.js +1 -1
  417. package/dist/log-viewer/web/ds-log-viewer.js +6 -5
  418. package/dist/map/map.d.ts +5 -0
  419. package/dist/map/map.js +2 -0
  420. package/dist/map/web/ds-map.js +9 -3
  421. package/dist/map-banner/native/ds-map-banner.js +3 -3
  422. package/dist/map-banner/web/ds-map-banner.js +4 -4
  423. package/dist/map-controls/map-controls.d.ts +3 -5
  424. package/dist/map-controls/map-controls.js +4 -4
  425. package/dist/map-controls/native/ds-map-controls.js +1 -1
  426. package/dist/map-controls/web/ds-map-controls.js +1 -1
  427. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.js +3 -2
  428. package/dist/map-heatmap-layer/map-heatmap-layer.d.ts +1 -1
  429. package/dist/map-layers/map-layers.d.ts +1 -1
  430. package/dist/map-layers/map-layers.js +1 -1
  431. package/dist/map-layers/native/ds-map-layers.d.ts +4 -2
  432. package/dist/map-layers/native/ds-map-layers.js +5 -4
  433. package/dist/map-layers/web/ds-map-layers.js +4 -4
  434. package/dist/map-list/map-list.d.ts +2 -1
  435. package/dist/map-list/web/ds-map-list.d.ts +1 -1
  436. package/dist/map-list/web/ds-map-list.js +19 -16
  437. package/dist/map-marker/map-marker.d.ts +5 -0
  438. package/dist/map-marker/map-marker.js +6 -0
  439. package/dist/map-marker/web/ds-map-marker.d.ts +12 -3
  440. package/dist/map-marker/web/ds-map-marker.js +18 -8
  441. package/dist/map-search/map-search.d.ts +9 -0
  442. package/dist/map-search/map-search.js +13 -0
  443. package/dist/map-search/native/ds-map-search.d.ts +10 -3
  444. package/dist/map-search/native/ds-map-search.js +32 -19
  445. package/dist/map-search/web/ds-map-search.d.ts +8 -3
  446. package/dist/map-search/web/ds-map-search.js +37 -27
  447. package/dist/map-search-area/native/ds-map-search-area.js +2 -1
  448. package/dist/map-search-area/web/ds-map-search-area.js +2 -1
  449. package/dist/map-sheet/native/ds-map-sheet.js +1 -1
  450. package/dist/map-sheet/web/ds-map-sheet.js +2 -2
  451. package/dist/map-summary/map-summary.d.ts +2 -1
  452. package/dist/map-summary/web/ds-map-summary.d.ts +2 -2
  453. package/dist/map-summary/web/ds-map-summary.js +18 -9
  454. package/dist/mention-input/mention-input.d.ts +23 -2
  455. package/dist/mention-input/mention-input.js +15 -8
  456. package/dist/mention-input/native/ds-mention-input.d.ts +1 -1
  457. package/dist/mention-input/native/ds-mention-input.js +6 -9
  458. package/dist/mention-input/web/ds-mention-input.d.ts +1 -1
  459. package/dist/mention-input/web/ds-mention-input.js +6 -5
  460. package/dist/menu-button/web/ds-menu-button.d.ts +2 -2
  461. package/dist/menu-button/web/ds-menu-button.js +9 -4
  462. package/dist/meter/meter.d.ts +5 -2
  463. package/dist/meter/meter.js +2 -1
  464. package/dist/meter/native/ds-meter.d.ts +2 -2
  465. package/dist/meter/native/ds-meter.js +13 -3
  466. package/dist/meter/web/ds-meter.d.ts +1 -1
  467. package/dist/meter/web/ds-meter.js +16 -9
  468. package/dist/metric/metric.d.ts +13 -9
  469. package/dist/metric/native/ds-metric.d.ts +1 -1
  470. package/dist/metric/native/ds-metric.js +26 -16
  471. package/dist/metric/web/ds-metric.d.ts +1 -1
  472. package/dist/metric/web/ds-metric.js +21 -5
  473. package/dist/metric-card/metric-card.d.ts +4 -3
  474. package/dist/metric-card/web/ds-metric-card.d.ts +1 -1
  475. package/dist/metric-card/web/ds-metric-card.js +4 -2
  476. package/dist/month-picker/web/ds-month-picker.js +2 -1
  477. package/dist/month-strip/web/ds-month-strip.js +1 -1
  478. package/dist/motion.d.ts +18 -3
  479. package/dist/motion.js +3 -1
  480. package/dist/multi-select/multi-select.d.ts +39 -9
  481. package/dist/multi-select/multi-select.js +35 -22
  482. package/dist/multi-select/web/ds-multi-select.d.ts +1 -1
  483. package/dist/multi-select/web/ds-multi-select.js +42 -24
  484. package/dist/native.d.ts +12 -0
  485. package/dist/native.js +8 -0
  486. package/dist/notification-list/native/ds-notification-list.d.ts +1 -1
  487. package/dist/notification-list/native/ds-notification-list.js +14 -7
  488. package/dist/notification-list/notification-list.d.ts +2 -1
  489. package/dist/notification-list/web/ds-notification-list.d.ts +1 -1
  490. package/dist/notification-list/web/ds-notification-list.js +10 -4
  491. package/dist/number-field/native/ds-number-field.js +1 -1
  492. package/dist/number-field/web/ds-number-field.js +1 -1
  493. package/dist/otp/native/ds-otp-field.js +3 -21
  494. package/dist/otp/native/ds-otp.js +3 -3
  495. package/dist/otp/otp.d.ts +3 -3
  496. package/dist/otp/web/ds-otp.js +3 -3
  497. package/dist/overflow-menu/web/ds-overflow-menu.js +7 -2
  498. package/dist/page-head/web/ds-page-head.js +2 -2
  499. package/dist/panel/native/ds-panel.js +1 -1
  500. package/dist/panel/panel.d.ts +1 -1
  501. package/dist/panel/web/ds-panel.d.ts +3 -1
  502. package/dist/panel/web/ds-panel.js +3 -2
  503. package/dist/password-feedback/web/ds-password-feedback.d.ts +1 -1
  504. package/dist/password-feedback/web/ds-password-feedback.js +3 -3
  505. package/dist/password-input/web/ds-password-input.d.ts +7 -2
  506. package/dist/password-input/web/ds-password-input.js +28 -3
  507. package/dist/password-requirements/password-requirements.d.ts +12 -2
  508. package/dist/password-requirements/password-requirements.js +6 -8
  509. package/dist/password-requirements/web/ds-password-requirements.js +5 -5
  510. package/dist/password-strength/web/ds-password-strength.js +2 -2
  511. package/dist/payment-card/native/ds-payment-card.d.ts +1 -1
  512. package/dist/payment-card/native/ds-payment-card.js +1 -1
  513. package/dist/payment-card/web/ds-payment-card.d.ts +1 -1
  514. package/dist/payment-card/web/ds-payment-card.js +1 -1
  515. package/dist/people-cell/people-cell.d.ts +5 -2
  516. package/dist/people-cell/web/ds-people-cell.d.ts +1 -1
  517. package/dist/people-cell/web/ds-people-cell.js +6 -2
  518. package/dist/person-cell/person-cell.d.ts +5 -2
  519. package/dist/person-cell/web/ds-person-cell.d.ts +1 -1
  520. package/dist/person-cell/web/ds-person-cell.js +11 -1
  521. package/dist/phone-field/native/ds-phone-field.js +2 -2
  522. package/dist/phone-field/phone-field.d.ts +35 -0
  523. package/dist/phone-field/phone-field.js +38 -0
  524. package/dist/phone-field/web/ds-phone-field.d.ts +31 -3
  525. package/dist/phone-field/web/ds-phone-field.js +45 -8
  526. package/dist/place-card/native/ds-place-card.d.ts +7 -3
  527. package/dist/place-card/native/ds-place-card.js +32 -21
  528. package/dist/place-card/place-card.d.ts +12 -6
  529. package/dist/place-card/place-card.js +6 -3
  530. package/dist/place-card/web/ds-place-card.d.ts +5 -3
  531. package/dist/place-card/web/ds-place-card.js +39 -27
  532. package/dist/plan-chart/plan-chart.d.ts +2 -3
  533. package/dist/plan-chart/web/ds-plan-chart.d.ts +1 -1
  534. package/dist/plan-chart/web/ds-plan-chart.js +34 -6
  535. package/dist/popover/popover.d.ts +7 -3
  536. package/dist/popover/web/ds-popover.d.ts +5 -1
  537. package/dist/popover/web/ds-popover.js +4 -2
  538. package/dist/priority-indicator/native/ds-priority-indicator.js +4 -4
  539. package/dist/priority-indicator/priority-indicator.d.ts +3 -3
  540. package/dist/priority-indicator/priority-indicator.js +3 -3
  541. package/dist/priority-indicator/web/ds-priority-indicator.js +4 -4
  542. package/dist/profile-card/profile-card.d.ts +2 -1
  543. package/dist/profile-card/web/ds-profile-card.d.ts +2 -2
  544. package/dist/profile-card/web/ds-profile-card.js +16 -3
  545. package/dist/progress-bar/native/ds-progress-bar.js +2 -1
  546. package/dist/progress-bar/web/ds-progress-bar.js +2 -1
  547. package/dist/progress-cell/progress-cell.d.ts +8 -3
  548. package/dist/progress-cell/progress-cell.js +1 -1
  549. package/dist/progress-cell/web/ds-progress-cell.d.ts +5 -2
  550. package/dist/progress-cell/web/ds-progress-cell.js +6 -2
  551. package/dist/progress-ring/native/ds-progress-ring.js +16 -11
  552. package/dist/progress-ring/progress-ring.d.ts +8 -4
  553. package/dist/progress-ring/progress-ring.js +7 -3
  554. package/dist/progress-ring/web/ds-progress-ring.js +16 -10
  555. package/dist/proportion-bar/native/ds-proportion-bar.d.ts +2 -2
  556. package/dist/proportion-bar/native/ds-proportion-bar.js +18 -7
  557. package/dist/proportion-bar/proportion-bar.d.ts +10 -3
  558. package/dist/proportion-bar/proportion-bar.js +6 -1
  559. package/dist/proportion-bar/web/ds-proportion-bar.d.ts +1 -1
  560. package/dist/proportion-bar/web/ds-proportion-bar.js +21 -14
  561. package/dist/quick-actions/native/ds-quick-actions.js +17 -2
  562. package/dist/quick-actions/quick-actions.d.ts +32 -2
  563. package/dist/quick-actions/quick-actions.js +9 -1
  564. package/dist/quick-actions/web/ds-quick-actions.js +20 -6
  565. package/dist/radar-chart/radar-chart.d.ts +11 -3
  566. package/dist/radar-chart/radar-chart.js +21 -3
  567. package/dist/radar-chart/web/ds-radar-chart.d.ts +1 -1
  568. package/dist/radar-chart/web/ds-radar-chart.js +34 -22
  569. package/dist/radial-progress/native/ds-radial-progress.d.ts +6 -2
  570. package/dist/radial-progress/native/ds-radial-progress.js +34 -11
  571. package/dist/radial-progress/radial-progress.d.ts +11 -2
  572. package/dist/radial-progress/radial-progress.js +9 -0
  573. package/dist/radial-progress/web/ds-radial-progress.d.ts +6 -2
  574. package/dist/radial-progress/web/ds-radial-progress.js +24 -10
  575. package/dist/radio/radio.d.ts +4 -4
  576. package/dist/radio/radio.js +4 -4
  577. package/dist/radio/web/ds-radio.d.ts +6 -2
  578. package/dist/radio/web/ds-radio.js +22 -10
  579. package/dist/radio-group/radio-group.d.ts +41 -5
  580. package/dist/radio-group/radio-group.js +5 -0
  581. package/dist/radio-group/web/ds-radio-group.d.ts +1 -1
  582. package/dist/radio-group/web/ds-radio-group.js +7 -2
  583. package/dist/rating-badge/rating-badge.d.ts +8 -2
  584. package/dist/rating-badge/rating-badge.js +5 -0
  585. package/dist/rating-badge/web/ds-rating-badge.d.ts +2 -2
  586. package/dist/rating-badge/web/ds-rating-badge.js +6 -4
  587. package/dist/recipient-select/recipient-select.d.ts +7 -0
  588. package/dist/recipient-select/recipient-select.js +3 -0
  589. package/dist/recipient-select/web/ds-recipient-select.js +4 -4
  590. package/dist/record-panel/record-panel.d.ts +17 -2
  591. package/dist/record-panel/web/ds-record-panel.d.ts +48 -13
  592. package/dist/record-panel/web/ds-record-panel.js +27 -18
  593. package/dist/reorder-list/reorder-list.d.ts +3 -0
  594. package/dist/reorder-list/web/ds-reorder-list.d.ts +6 -1
  595. package/dist/reorder-list/web/ds-reorder-list.js +6 -4
  596. package/dist/resend-control/native/ds-resend-control.d.ts +24 -0
  597. package/dist/resend-control/native/ds-resend-control.js +73 -0
  598. package/dist/resend-control/resend-control.d.ts +2 -0
  599. package/dist/resend-control/resend-control.js +2 -0
  600. package/dist/resend-control/web/ds-resend-control.js +3 -3
  601. package/dist/route-fields/route-fields.d.ts +79 -0
  602. package/dist/route-fields/route-fields.js +71 -0
  603. package/dist/route-fields/web/ds-route-fields.d.ts +5 -0
  604. package/dist/route-fields/web/ds-route-fields.js +83 -0
  605. package/dist/route-line/web/ds-route-line.js +2 -2
  606. package/dist/save-bar/save-bar.d.ts +1 -1
  607. package/dist/save-bar/save-bar.js +1 -1
  608. package/dist/save-bar/web/ds-save-bar.js +2 -2
  609. package/dist/scanner/scanner.d.ts +1 -1
  610. package/dist/scanner/scanner.js +2 -1
  611. package/dist/scatter-chart/scatter-chart.d.ts +2 -3
  612. package/dist/scatter-chart/web/ds-scatter-chart.d.ts +1 -1
  613. package/dist/scatter-chart/web/ds-scatter-chart.js +13 -4
  614. package/dist/schedule-chart/schedule-chart.d.ts +187 -0
  615. package/dist/schedule-chart/schedule-chart.js +285 -0
  616. package/dist/schedule-chart/web/ds-schedule-chart.d.ts +24 -0
  617. package/dist/schedule-chart/web/ds-schedule-chart.js +143 -0
  618. package/dist/segmented-control/native/ds-segmented-control.d.ts +1 -1
  619. package/dist/segmented-control/native/ds-segmented-control.js +1 -1
  620. package/dist/segmented-control/segmented-control.d.ts +7 -0
  621. package/dist/segmented-control/web/ds-segmented-control.d.ts +1 -1
  622. package/dist/segmented-control/web/ds-segmented-control.js +4 -3
  623. package/dist/select/native/ds-select.js +6 -3
  624. package/dist/select/select.d.ts +5 -0
  625. package/dist/select/web/ds-select.d.ts +14 -1
  626. package/dist/select/web/ds-select.js +22 -12
  627. package/dist/settings-directory/native/ds-settings-directory.js +1 -1
  628. package/dist/settings-directory/web/ds-settings-directory.js +1 -1
  629. package/dist/settings-row/web/ds-settings-row.d.ts +3 -1
  630. package/dist/settings-row/web/ds-settings-row.js +2 -2
  631. package/dist/sheet/web/ds-sheet.js +3 -3
  632. package/dist/side-nav/side-nav.d.ts +2 -1
  633. package/dist/side-nav/web/ds-side-nav-collapse.d.ts +4 -1
  634. package/dist/side-nav/web/ds-side-nav-collapse.js +6 -3
  635. package/dist/side-nav/web/ds-side-nav-header.js +1 -1
  636. package/dist/side-nav/web/ds-side-nav-primary.js +1 -1
  637. package/dist/side-nav/web/ds-side-nav-profile.js +1 -1
  638. package/dist/side-nav/web/ds-side-nav.d.ts +1 -1
  639. package/dist/side-nav/web/ds-side-nav.js +3 -3
  640. package/dist/skeleton/skeleton.d.ts +20 -0
  641. package/dist/skeleton/skeleton.js +4 -0
  642. package/dist/slider/native/ds-slider.js +1 -1
  643. package/dist/small-multiples/small-multiples.d.ts +3 -4
  644. package/dist/small-multiples/small-multiples.js +2 -1
  645. package/dist/small-multiples/web/ds-small-multiples.d.ts +1 -1
  646. package/dist/small-multiples/web/ds-small-multiples.js +8 -2
  647. package/dist/sparkline/sparkline.d.ts +19 -7
  648. package/dist/sparkline/sparkline.js +42 -17
  649. package/dist/sparkline/web/ds-sparkline.d.ts +1 -1
  650. package/dist/sparkline/web/ds-sparkline.js +4 -3
  651. package/dist/split-pane/web/ds-split-pane.js +2 -2
  652. package/dist/stat-tile/native/ds-stat-tile.d.ts +3 -3
  653. package/dist/stat-tile/native/ds-stat-tile.js +14 -7
  654. package/dist/stat-tile/stat-tile.d.ts +14 -8
  655. package/dist/stat-tile/web/ds-stat-tile.d.ts +4 -2
  656. package/dist/stat-tile/web/ds-stat-tile.js +8 -5
  657. package/dist/state-message/web/ds-state-message.d.ts +6 -2
  658. package/dist/state-message/web/ds-state-message.js +5 -2
  659. package/dist/status-badge/native/ds-status-badge.js +3 -3
  660. package/dist/status-badge/status-badge.d.ts +3 -3
  661. package/dist/status-badge/status-badge.js +1 -1
  662. package/dist/status-badge/web/ds-status-badge.js +4 -4
  663. package/dist/status-cell/status-cell.d.ts +5 -2
  664. package/dist/status-cell/web/ds-status-cell.d.ts +6 -2
  665. package/dist/status-cell/web/ds-status-cell.js +7 -2
  666. package/dist/status-control/web/ds-status-control.js +3 -3
  667. package/dist/status-dot/native/ds-status-dot.js +1 -1
  668. package/dist/status-dot/status-dot.d.ts +2 -2
  669. package/dist/status-dot/status-dot.js +2 -2
  670. package/dist/status-dot/web/ds-status-dot.js +2 -2
  671. package/dist/stepper-form/stepper-form.d.ts +27 -4
  672. package/dist/stepper-form/stepper-form.js +17 -9
  673. package/dist/stepper-form/web/ds-stepper-form.d.ts +1 -1
  674. package/dist/stepper-form/web/ds-stepper-form.js +7 -5
  675. package/dist/stick-chart/stick-chart.d.ts +2 -1
  676. package/dist/stick-chart/stick-chart.js +2 -1
  677. package/dist/stick-chart/web/ds-stick-chart.d.ts +1 -1
  678. package/dist/stick-chart/web/ds-stick-chart.js +17 -3
  679. package/dist/switch/native/ds-switch.js +1 -1
  680. package/dist/system-state/native/ds-system-state.d.ts +29 -0
  681. package/dist/system-state/native/ds-system-state.js +68 -0
  682. package/dist/system-state/system-state.js +4 -3
  683. package/dist/system-state/web/ds-system-state.js +2 -2
  684. package/dist/table-toolbar/web/ds-table-toolbar.js +1 -1
  685. package/dist/tabs/tabs.d.ts +5 -0
  686. package/dist/tabs/tabs.js +2 -0
  687. package/dist/tabs/web/ds-tabs.js +2 -2
  688. package/dist/task-shell/task-shell.d.ts +15 -6
  689. package/dist/task-shell/task-shell.js +5 -2
  690. package/dist/task-shell/web/ds-task-shell.d.ts +21 -6
  691. package/dist/task-shell/web/ds-task-shell.js +52 -18
  692. package/dist/text/native/ds-text.js +1 -1
  693. package/dist/text/text.d.ts +1 -1
  694. package/dist/text/text.js +1 -1
  695. package/dist/text/web/ds-text.js +1 -1
  696. package/dist/textarea/native/ds-textarea.d.ts +1 -1
  697. package/dist/textarea/native/ds-textarea.js +9 -8
  698. package/dist/textarea/web/ds-textarea.d.ts +1 -1
  699. package/dist/textarea/web/ds-textarea.js +8 -7
  700. package/dist/time-field/time-field.d.ts +37 -0
  701. package/dist/time-field/time-field.js +23 -0
  702. package/dist/time-field/web/ds-time-field.d.ts +8 -0
  703. package/dist/time-field/web/ds-time-field.js +28 -0
  704. package/dist/time-range/time-range.d.ts +35 -26
  705. package/dist/time-range/time-range.js +28 -46
  706. package/dist/time-range/web/ds-time-range.d.ts +1 -1
  707. package/dist/time-range/web/ds-time-range.js +9 -6
  708. package/dist/timeline/native/ds-timeline.d.ts +2 -2
  709. package/dist/timeline/native/ds-timeline.js +21 -7
  710. package/dist/timeline/timeline.d.ts +2 -1
  711. package/dist/timeline/web/ds-timeline.d.ts +2 -2
  712. package/dist/timeline/web/ds-timeline.js +18 -9
  713. package/dist/toast/native/ds-toast.js +1 -1
  714. package/dist/toggle-group/native/ds-toggle-group.js +1 -1
  715. package/dist/token-roles.d.ts +1 -1
  716. package/dist/token-roles.js +18 -0
  717. package/dist/tone.d.ts +4 -4
  718. package/dist/tone.js +1 -5
  719. package/dist/toolbar/toolbar.d.ts +19 -7
  720. package/dist/toolbar/toolbar.js +4 -3
  721. package/dist/toolbar/web/ds-toolbar.d.ts +5 -2
  722. package/dist/toolbar/web/ds-toolbar.js +3 -3
  723. package/dist/track-bars/track-bars.d.ts +3 -4
  724. package/dist/track-bars/web/ds-track-bars.d.ts +1 -1
  725. package/dist/track-bars/web/ds-track-bars.js +9 -3
  726. package/dist/tree/tree.d.ts +1 -1
  727. package/dist/tree/tree.js +1 -1
  728. package/dist/tree/web/ds-tree.js +2 -2
  729. package/dist/treemap/treemap.d.ts +2 -3
  730. package/dist/treemap/web/ds-treemap.d.ts +1 -1
  731. package/dist/treemap/web/ds-treemap.js +14 -3
  732. package/dist/two-line-cell/two-line-cell.d.ts +5 -2
  733. package/dist/two-line-cell/web/ds-two-line-cell.d.ts +1 -1
  734. package/dist/two-line-cell/web/ds-two-line-cell.js +5 -1
  735. package/dist/vehicle-marker/vehicle-marker.d.ts +5 -4
  736. package/dist/vehicle-marker/vehicle-marker.js +3 -3
  737. package/dist/vehicle-marker/web/ds-vehicle-marker.js +9 -6
  738. package/dist/waterfall-chart/waterfall-chart.d.ts +10 -5
  739. package/dist/waterfall-chart/waterfall-chart.js +17 -12
  740. package/dist/waterfall-chart/web/ds-waterfall-chart.d.ts +7 -2
  741. package/dist/waterfall-chart/web/ds-waterfall-chart.js +49 -11
  742. package/dist/web.d.ts +20 -5
  743. package/dist/web.js +10 -2
  744. package/dist/week-schedule/web/ds-week-schedule.d.ts +1 -1
  745. package/dist/week-schedule/web/ds-week-schedule.js +4 -4
  746. package/dist/week-schedule/week-schedule.d.ts +23 -4
  747. package/dist/week-schedule/week-schedule.js +19 -13
  748. package/forced-colors.css +8 -5
  749. package/package.json +10 -15
@@ -1,10 +1,13 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { useEffect } from 'react';
2
3
  import { View } from 'react-native';
3
4
  import { TriangleAlert } from 'lucide-react-native';
4
5
  import { styled } from 'nativewind';
5
6
  import { meterChipPlacement, meterShowsStartMark, meterSpec, meterValueText, meterTargetPercent, meterWarns, } from '../meter';
6
7
  import { cn } from '../../lib/cn';
7
8
  import { DSText } from '../../text/native/ds-text';
9
+ import { DSSkeleton } from '../../skeleton/native/ds-skeleton';
10
+ import { announce } from '../../lib/native/announce';
8
11
  const WarningIcon = styled(TriangleAlert, {
9
12
  className: { target: 'style', nativeStyleMapping: { color: 'color' } },
10
13
  });
@@ -14,8 +17,8 @@ const TRACK = {
14
17
  const FILL = {
15
18
  'chart-accent': 'bg-chart-accent',
16
19
  };
17
- const WARNING_FILL = { warning: 'bg-warning' };
18
- const WARNING_INK = { warning: 'text-warning' };
20
+ const WARNING_FILL = { warning: 'bg-chart-needs-you' };
21
+ const WARNING_INK = { warning: 'text-chart-needs-you-ink' };
19
22
  const HEIGHT = {
20
23
  sm: 'h-1',
21
24
  md: 'h-2.5',
@@ -26,7 +29,11 @@ const START_MARK = {
26
29
  md: 'min-w-2.5',
27
30
  lg: 'min-w-3.5',
28
31
  };
29
- export function DSMeter({ value, max, label, size = 'sm', startMark, valueLabel, valueText, warnAt, target, className, testID, ...props }) {
32
+ export function DSMeter({ value, max, label, size = 'sm', startMark, valueLabel, valueText, warnAt, target, loading = false, loadingLabel, className, testID, ...props }) {
33
+ useEffect(() => {
34
+ if (loading && loadingLabel)
35
+ announce(loadingLabel);
36
+ }, [loading, loadingLabel]);
30
37
  const spec = meterSpec(value, max);
31
38
  const aim = meterTargetPercent(target, spec);
32
39
  const warns = meterWarns(warnAt, spec);
@@ -34,6 +41,9 @@ export function DSMeter({ value, max, label, size = 'sm', startMark, valueLabel,
34
41
  const marked = meterShowsStartMark(startMark, spec);
35
42
  const fillWidth = `${String(spec.percent)}%`;
36
43
  const chip = valueLabel === undefined ? undefined : meterChipPlacement(spec.percent);
44
+ if (loading) {
45
+ return (_jsx(View, { accessibilityRole: "progressbar", accessibilityLabel: label, accessibilityState: { busy: loading }, "aria-busy": loading, className: cn('w-full overflow-hidden rounded-full', HEIGHT[size], chip !== undefined && 'my-2', className), testID: testID, ...props, children: _jsx(DSSkeleton, { className: "h-full w-full rounded-full" }) }));
46
+ }
37
47
  return (_jsxs(View, { accessibilityRole: "progressbar", accessibilityLabel: label, accessibilityValue: {
38
48
  min: 0,
39
49
  max: spec.max,
@@ -8,4 +8,4 @@ export type DSMeterProps = Omit<ComponentProps<'div'>, 'role' | 'aria-label' | '
8
8
  hue?: ChartHue;
9
9
  };
10
10
  /** A horizontal bar showing one value against its maximum. */
11
- export declare function DSMeter({ value, max, label, size, startMark, valueLabel, valueText, warnAt, target, hue, className, ...props }: DSMeterProps): import("react/jsx-runtime").JSX.Element;
11
+ export declare function DSMeter({ value, max, label, size, startMark, valueLabel, valueText, warnAt, target, hue, loading, loadingLabel, className, ...props }: DSMeterProps): import("react/jsx-runtime").JSX.Element;
@@ -1,17 +1,20 @@
1
- import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
1
+ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { TriangleAlert } from 'lucide-react';
3
3
  import { meterChipPlacement, meterShowsStartMark, meterSpec, meterValueText, meterTargetPercent, meterWarns, } from '../meter';
4
4
  import { CHART_SERIES_BG, chartSeriesSlot } from '../../lib/chart-series';
5
5
  import { cn } from '../../lib/cn';
6
6
  import { DSText } from '../../text/web/ds-text';
7
+ import { DSSkeleton } from '../../skeleton/web/ds-skeleton';
8
+ import { loadingSpoken } from '../../skeleton/skeleton';
9
+ import { SpokenRegion } from '../../lib/web/spoken-region';
7
10
  const TRACK = {
8
11
  track: 'meter-track',
9
12
  };
10
13
  const FILL = {
11
14
  'chart-accent': 'meter-fill',
12
15
  };
13
- const WARNING_FILL = { warning: 'bg-warning' };
14
- const WARNING_INK = { warning: 'text-warning' };
16
+ const WARNING_FILL = { warning: 'bg-chart-needs-you' };
17
+ const WARNING_INK = { warning: 'text-chart-needs-you-ink' };
15
18
  const HEIGHT = {
16
19
  sm: 'h-1',
17
20
  md: 'h-2.5',
@@ -22,16 +25,20 @@ const START_MARK = {
22
25
  md: 'min-w-2.5',
23
26
  lg: 'min-w-3.5',
24
27
  };
25
- export function DSMeter({ value, max, label, size = 'sm', startMark, valueLabel, valueText, warnAt, target, hue, className, ...props }) {
28
+ export function DSMeter({ value, max, label, size = 'sm', startMark, valueLabel, valueText, warnAt, target, hue, loading = false, loadingLabel, className, ...props }) {
26
29
  const spec = meterSpec(value, max);
27
30
  const aim = meterTargetPercent(target, spec);
28
31
  const warns = meterWarns(warnAt, spec);
29
32
  const marked = meterShowsStartMark(startMark, spec);
30
33
  const chip = valueLabel === undefined ? undefined : meterChipPlacement(spec.percent);
31
34
  const spoken = meterValueText(valueText, valueLabel);
32
- return (_jsxs("div", { role: "progressbar", "aria-label": label, "aria-valuemin": 0, "aria-valuemax": spec.max, "aria-valuenow": spec.value, ...(spoken === undefined ? {} : { 'aria-valuetext': spoken }), ...(warns ? { 'data-tone': 'warning' } : {}), "data-forced-colors": "meter", className: cn('relative w-full rounded-full', HEIGHT[size], chip !== undefined && 'my-2', chip === undefined && aim === undefined && 'overflow-hidden', TRACK[spec.track], className), ...props, children: [_jsx("div", { className: cn('h-full rounded-full meter-sheen', warns
33
- ? WARNING_FILL.warning
34
- : hue === undefined
35
- ? FILL[spec.fill]
36
- : CHART_SERIES_BG[chartSeriesSlot(hue)], marked && START_MARK[size]), style: { width: `${String(spec.percent)}%` } }), aim !== undefined && (_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute inset-y-0 w-0", style: { left: `${String(aim)}%` }, "data-meter-target": "", children: _jsx("span", { className: "bg-card-foreground absolute -inset-y-1 w-0.5 -translate-x-1/2 rounded-full" }) })), chip !== undefined && (_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute inset-y-0 w-0", style: { left: `${String(chip.left)}%` }, children: _jsxs(DSText, { as: "span", variant: "label-sm", className: "bg-card text-card-foreground shadow-low border-border-subtle absolute top-1/2 inline-flex min-h-5.5 items-center gap-1 rounded-full border px-2 whitespace-nowrap tabular-nums", style: { transform: `translate(-${String(chip.shift)}%, -50%)` }, children: [warns && _jsx(TriangleAlert, { "aria-hidden": true, className: cn('size-3', WARNING_INK.warning) }), valueLabel] }) }))] }));
35
+ const status = _jsx(SpokenRegion, { text: loadingSpoken(loading, loadingLabel) });
36
+ if (loading) {
37
+ return (_jsxs(_Fragment, { children: [_jsx("div", { role: "progressbar", "aria-label": label, "aria-busy": true, className: cn('relative w-full overflow-hidden rounded-full', HEIGHT[size], chip !== undefined && 'my-2', className), ...props, children: _jsx(DSSkeleton, { className: "h-full w-full rounded-full" }) }), status] }));
38
+ }
39
+ return (_jsxs(_Fragment, { children: [_jsxs("div", { role: "progressbar", "aria-label": label, "aria-valuemin": 0, "aria-valuemax": spec.max, "aria-valuenow": spec.value, ...(spoken === undefined ? {} : { 'aria-valuetext': spoken }), ...(warns ? { 'data-tone': 'warning' } : {}), "data-forced-colors": "meter", className: cn('relative w-full rounded-full', HEIGHT[size], chip !== undefined && 'my-2', chip === undefined && aim === undefined && 'overflow-hidden', TRACK[spec.track], className), ...props, children: [_jsx("div", { className: cn('h-full rounded-full meter-sheen', warns
40
+ ? WARNING_FILL.warning
41
+ : hue === undefined
42
+ ? FILL[spec.fill]
43
+ : CHART_SERIES_BG[chartSeriesSlot(hue)], marked && START_MARK[size]), style: { width: `${String(spec.percent)}%` } }), aim !== undefined && (_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute inset-y-0 w-0", style: { left: `${String(aim)}%` }, "data-meter-target": "", children: _jsx("span", { className: "bg-card-foreground absolute -inset-y-1 w-0.5 -translate-x-1/2 rounded-full" }) })), chip !== undefined && (_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute inset-y-0 w-0", style: { left: `${String(chip.left)}%` }, children: _jsxs(DSText, { as: "span", variant: "label-sm", className: "bg-card text-card-foreground shadow-low border-border-subtle absolute top-1/2 inline-flex min-h-5.5 items-center gap-1 rounded-full border px-2 whitespace-nowrap tabular-nums", style: { transform: `translate(-${String(chip.shift)}%, -50%)` }, children: [warns && _jsx(TriangleAlert, { "aria-hidden": true, className: cn('size-3', WARNING_INK.warning) }), valueLabel] }) }))] }), status] }));
37
44
  }
@@ -1,4 +1,5 @@
1
1
  import type { Forwarded } from '../props';
2
+ import type { Loadable } from '../skeleton/skeleton';
2
3
  export declare const METRIC_SIZES: readonly ["sm", "md", "lg"];
3
4
  export type MetricSize = (typeof METRIC_SIZES)[number];
4
5
  export type MetricScaleStep = 'heading-lg' | 'numeral' | 'display';
@@ -20,11 +21,8 @@ declare const METRIC_INK: "foreground";
20
21
  export type MetricInkRole = typeof METRIC_INK;
21
22
  declare const METRIC_QUALIFIER_INK: "muted-foreground";
22
23
  export type MetricQualifierInkRole = typeof METRIC_QUALIFIER_INK;
23
- /**
24
- * The props every Metric implementation must accept. Web only, see the
25
- * header for why no native counterpart exists for this row.
26
- */
27
- export interface MetricContract {
24
+ /** A Metric's data: the figure and how it is set. */
25
+ export interface MetricFields {
28
26
  /** `.numeral` (bare) vs. `.numeral-sm`, see the header for the size-scale
29
27
  * derivation. Optional; `metricSpec` defaults to `'md'`. */
30
28
  size?: Forwarded<MetricSize>;
@@ -34,11 +32,17 @@ export interface MetricContract {
34
32
  /** `.qual`, see the header on why it is optional, quiet and nested rather
35
33
  * than a sibling. */
36
34
  qualifier?: Forwarded<string>;
37
- /** When the figure changes, the digits that changed roll to their new value
38
- * and the figure takes a brief tint. For a total a person's own action
35
+ /** When the figure changes, the digits that changed rise into place and the
36
+ * figure takes a brief tint. The new figure is drawn on the first frame;
37
+ * nothing in between is ever shown. For a total a person's own action
39
38
  * moved, never for a feed that ticks on its own. */
40
39
  roll?: Forwarded<boolean>;
41
40
  }
41
+ /**
42
+ * The props every Metric implementation must accept: its data while ready and
43
+ * nothing but `loading` while the figure is on its way.
44
+ */
45
+ export type MetricContract = Loadable<MetricFields>;
42
46
  export interface MetricResolvedSpec {
43
47
  scale: MetricScaleStep;
44
48
  ink: MetricInkRole;
@@ -55,9 +59,9 @@ export interface MetricGlyph {
55
59
  key: string;
56
60
  /** The character as printed. */
57
61
  char: string;
58
- /** 0–9 for a digit that sits on a reel; `undefined` for anything printed. */
62
+ /** 0–9 for a digit that sits in a window; `undefined` for anything printed. */
59
63
  digit: number | undefined;
60
64
  }
61
- /** The figure, split into what rolls and what is printed. */
65
+ /** The figure, split into the digits that move and what is printed. */
62
66
  export declare function metricGlyphs(figure: string | number): MetricGlyph[];
63
67
  export {};
@@ -2,4 +2,4 @@ import { type TextProps } from 'react-native';
2
2
  import { type MetricContract } from '../metric';
3
3
  export type DSMetricProps = TextProps & MetricContract;
4
4
  /** A headline number with its label and an optional qualifier. */
5
- export declare function DSMetric({ size, children, qualifier, roll, className, ...props }: DSMetricProps): import("react/jsx-runtime").JSX.Element;
5
+ export declare function DSMetric({ loading, loadingLabel, size, children, qualifier, roll, className, ...props }: DSMetricProps): import("react/jsx-runtime").JSX.Element;
@@ -3,10 +3,12 @@ import { useEffect, useRef, useState } from 'react';
3
3
  import { Animated, View } from 'react-native';
4
4
  import { Text } from '../../lib/native/text';
5
5
  import { metricGlyphs, metricSpec, } from '../metric';
6
- import { springPhysics } from '../../motion';
6
+ import { DIGIT_ARRIVAL, springPhysics } from '../../motion';
7
7
  import { cn } from '../../lib/cn';
8
8
  import { useReducedMotion } from '../../lib/native/use-reduced-motion';
9
9
  import { DSText } from '../../text/native/ds-text';
10
+ import { DSSkeleton } from '../../skeleton/native/ds-skeleton';
11
+ import { announce } from '../../lib/native/announce';
10
12
  const SCALE = {
11
13
  'heading-lg': 'text-heading-lg',
12
14
  numeral: 'text-numeral',
@@ -18,19 +20,19 @@ const INK = {
18
20
  const QUALIFIER_INK = {
19
21
  'muted-foreground': 'text-muted-foreground',
20
22
  };
21
- const REEL = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];
22
- function Reel({ digit, line, reduced, className, }) {
23
- const offset = useRef(new Animated.Value(-digit * line)).current;
24
- const placedAt = useRef(line);
23
+ const SKELETON = {
24
+ 'heading-lg': { fits: 'heading-lg', className: 'w-16' },
25
+ numeral: { className: 'h-8 w-24' },
26
+ display: { fits: 'display', className: 'w-48' },
27
+ };
28
+ function Digit({ char, line, arrives, reduced, className, }) {
29
+ const [rises] = useState(arrives && !reduced);
30
+ const offset = useRef(new Animated.Value(rises ? line * DIGIT_ARRIVAL : 0)).current;
25
31
  useEffect(() => {
26
- const to = -digit * line;
27
- if (reduced || placedAt.current !== line) {
28
- placedAt.current = line;
29
- offset.setValue(to);
32
+ if (!rises)
30
33
  return undefined;
31
- }
32
34
  const spring = Animated.spring(offset, {
33
- toValue: to,
35
+ toValue: 0,
34
36
  ...springPhysics('precise'),
35
37
  useNativeDriver: true,
36
38
  });
@@ -38,12 +40,12 @@ function Reel({ digit, line, reduced, className, }) {
38
40
  return () => {
39
41
  spring.stop();
40
42
  };
41
- }, [digit, line, reduced, offset]);
42
- return (_jsx(View, { style: { height: line, overflow: 'hidden' }, children: _jsx(Animated.View, { style: { transform: [{ translateY: offset }] }, children: REEL.map((n) => (_jsx(Text, { className: cn('font-sans', className), style: { height: line }, children: n }, n))) }) }));
43
+ }, [rises, offset]);
44
+ return (_jsx(View, { style: { height: line, overflow: 'hidden' }, children: _jsx(Animated.View, { style: { transform: [{ translateY: offset }] }, children: _jsx(Text, { className: cn('font-sans', className), style: { height: line }, children: char }) }) }));
43
45
  }
44
- export function DSMetric({ size = 'md', children, qualifier, roll = false, className, ...props }) {
46
+ export function DSMetric({ loading = false, loadingLabel, size = 'md', children, qualifier, roll = false, className, ...props }) {
45
47
  const spec = metricSpec(size);
46
- const figure = String(children);
48
+ const figure = children === undefined ? '' : String(children);
47
49
  const type = cn('font-bold tracking-numeral tabular-nums', SCALE[spec.scale], INK[spec.ink]);
48
50
  const reduced = useReducedMotion();
49
51
  const [seen, setSeen] = useState(figure);
@@ -53,11 +55,19 @@ export function DSMetric({ size = 'md', children, qualifier, roll = false, class
53
55
  setSeen(figure);
54
56
  setChanges((n) => n + 1);
55
57
  }
58
+ useEffect(() => {
59
+ if (loading && loadingLabel)
60
+ announce(loadingLabel);
61
+ }, [loading, loadingLabel]);
56
62
  const qualifierText = qualifier === undefined ? null : (_jsx(DSText, { variant: "body-md", className: cn('tracking-normal', QUALIFIER_INK[spec.qualifierInk]), children: ` ${qualifier}` }));
63
+ if (loading) {
64
+ const bar = SKELETON[spec.scale];
65
+ return (_jsxs(View, { accessibilityState: { busy: true }, "aria-busy": true, testID: props.testID, className: cn('flex-row items-center gap-2 self-start', className), children: [_jsx(DSSkeleton, { ...(bar.fits === undefined ? {} : { fits: bar.fits }), className: bar.className }), qualifier !== undefined && (_jsx(DSText, { variant: "body-md", className: QUALIFIER_INK[spec.qualifierInk], children: qualifier }))] }));
66
+ }
57
67
  if (!roll) {
58
68
  return (_jsxs(Text, { className: cn('font-sans', type, className), ...props, children: [children, qualifierText] }));
59
69
  }
60
70
  return (_jsxs(View, { accessible: true, accessibilityRole: "text", accessibilityLabel: qualifier === undefined ? figure : `${figure} ${qualifier}`, testID: props.testID, className: cn('flex-row items-baseline self-start', className), children: [changes > 0 && (_jsx(View, { pointerEvents: "none", className: cn('bg-accent absolute -inset-x-1 inset-y-0 rounded-xs', !reduced && 'animate-value-flash', reduced && 'opacity-0') }, changes)), _jsx(Text, { "aria-hidden": true, importantForAccessibility: "no-hide-descendants", className: cn('font-sans', type, 'absolute opacity-0'), onLayout: (event) => {
61
71
  setLine(event.nativeEvent.layout.height);
62
- }, children: "0" }), _jsx(View, { importantForAccessibility: "no-hide-descendants", className: "flex-row", children: metricGlyphs(figure).map((glyph) => glyph.digit === undefined || line === 0 ? (_jsx(Text, { className: cn('font-sans', type), children: glyph.char }, glyph.key)) : (_jsx(Reel, { digit: glyph.digit, line: line, reduced: reduced, className: type }, glyph.key))) }), qualifierText] }));
72
+ }, children: "0" }), _jsx(View, { importantForAccessibility: "no-hide-descendants", className: "flex-row", children: metricGlyphs(figure).map((glyph) => glyph.digit === undefined || line === 0 ? (_jsx(Text, { className: cn('font-sans', type), children: glyph.char }, glyph.key)) : (_jsx(Digit, { char: glyph.char, line: line, arrives: changes > 0, reduced: reduced, className: type }, `${glyph.key}:${String(glyph.digit)}`))) }), qualifierText] }));
63
73
  }
@@ -2,4 +2,4 @@ import { type ComponentProps, type ReactNode } from 'react';
2
2
  import { type MetricContract } from '../metric';
3
3
  export type DSMetricProps = ComponentProps<'span'> & MetricContract;
4
4
  /** A headline number with its label and an optional qualifier. */
5
- export declare function DSMetric({ size, children, qualifier, roll, className, ...props }: DSMetricProps): ReactNode;
5
+ export declare function DSMetric({ loading, loadingLabel, size, children, qualifier, roll, className, ...props }: DSMetricProps): ReactNode;
@@ -1,8 +1,11 @@
1
- import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
1
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
2
2
  import { useState } from 'react';
3
3
  import { metricGlyphs, metricSpec, } from '../metric';
4
4
  import { cn } from '../../lib/cn';
5
5
  import { DSText } from '../../text/web/ds-text';
6
+ import { DSSkeleton } from '../../skeleton/web/ds-skeleton';
7
+ import { loadingSpoken } from '../../skeleton/skeleton';
8
+ import { SpokenRegion } from '../../lib/web/spoken-region';
6
9
  const SCALE = {
7
10
  'heading-lg': 'text-heading-lg',
8
11
  numeral: 'text-numeral',
@@ -14,16 +17,29 @@ const INK = {
14
17
  const QUALIFIER_INK = {
15
18
  'muted-foreground': 'text-muted-foreground',
16
19
  };
17
- const REEL = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9];
20
+ const SKELETON = {
21
+ 'heading-lg': { fits: 'heading-lg', className: 'w-16' },
22
+ numeral: { className: 'h-8 w-24' },
23
+ display: { fits: 'display', className: 'w-48' },
24
+ };
18
25
  const LINE = { height: '1lh' };
19
- export function DSMetric({ size = 'md', children, qualifier, roll = false, className, ...props }) {
26
+ function Digit({ char, arrives }) {
27
+ const [rises] = useState(arrives);
28
+ return (_jsx("span", { className: cn('block', rises && 'animate-digit-in'), style: LINE, children: char }));
29
+ }
30
+ export function DSMetric({ loading = false, loadingLabel, size = 'md', children, qualifier, roll = false, className, ...props }) {
20
31
  const spec = metricSpec(size);
21
- const figure = String(children);
32
+ const figure = children === undefined ? '' : String(children);
22
33
  const [seen, setSeen] = useState(figure);
23
34
  const [changes, setChanges] = useState(0);
24
35
  if (roll && seen !== figure) {
25
36
  setSeen(figure);
26
37
  setChanges((n) => n + 1);
27
38
  }
28
- return (_jsxs("span", { className: cn('metric-figure font-bold tracking-numeral tabular-nums', roll && 'relative isolate inline-flex items-baseline', SCALE[spec.scale], INK[spec.ink], className), ...props, children: [roll ? (_jsxs(_Fragment, { children: [changes > 0 && (_jsx("span", { "aria-hidden": true, className: "bg-accent animate-value-flash absolute -inset-1 z-(--layer-behind) rounded-xs" }, changes)), _jsx("span", { className: "sr-only", children: figure }), _jsx("span", { "aria-hidden": true, className: "inline-flex", children: metricGlyphs(figure).map((glyph) => glyph.digit === undefined ? (_jsx("span", { className: "whitespace-pre", children: glyph.char }, glyph.key)) : (_jsx("span", { className: "inline-block overflow-hidden", style: LINE, children: _jsx("span", { className: "transition-spring flex flex-col", style: { transform: `translateY(calc(-${String(glyph.digit)} * 1lh))` }, children: REEL.map((n) => (_jsx("span", { className: "block", style: LINE, children: n }, n))) }) }, glyph.key))) })] })) : (children), qualifier !== undefined && (_jsx(DSText, { as: "span", variant: "body-md", className: cn('tracking-normal', QUALIFIER_INK[spec.qualifierInk]), children: ` ${qualifier}` }))] }));
39
+ const status = loadingLabel === undefined ? null : _jsx(SpokenRegion, { text: loadingSpoken(loading, loadingLabel) });
40
+ if (loading) {
41
+ const bar = SKELETON[spec.scale];
42
+ return (_jsxs(_Fragment, { children: [status, _jsxs("span", { "aria-busy": true, className: cn('metric-figure inline-flex items-baseline gap-2', className), ...props, children: [_jsx(DSSkeleton, { ...(bar.fits === undefined ? {} : { fits: bar.fits }), className: cn('inline-flex self-center', bar.className) }), qualifier !== undefined && (_jsx(DSText, { as: "span", variant: "body-md", className: QUALIFIER_INK[spec.qualifierInk], children: qualifier }))] })] }));
43
+ }
44
+ return (_jsxs(_Fragment, { children: [status, _jsxs("span", { className: cn('metric-figure font-bold tracking-numeral tabular-nums', roll && 'relative isolate inline-flex items-baseline', SCALE[spec.scale], INK[spec.ink], className), ...props, children: [roll ? (_jsxs(_Fragment, { children: [changes > 0 && (_jsx("span", { "aria-hidden": true, className: "bg-accent animate-value-flash absolute -inset-1 z-(--layer-behind) rounded-xs" }, changes)), _jsx("span", { className: "sr-only", children: figure }), _jsx("span", { "aria-hidden": true, className: "inline-flex", children: metricGlyphs(figure).map((glyph) => glyph.digit === undefined ? (_jsx("span", { className: "whitespace-pre", children: glyph.char }, glyph.key)) : (_jsx("span", { className: "inline-block overflow-hidden", style: LINE, children: _jsx(Digit, { char: glyph.char, arrives: changes > 0 }, glyph.digit) }, glyph.key))) })] })) : (children), qualifier !== undefined && (_jsx(DSText, { as: "span", variant: "body-md", className: cn('tracking-normal', QUALIFIER_INK[spec.qualifierInk]), children: ` ${qualifier}` }))] })] }));
29
45
  }
@@ -1,5 +1,6 @@
1
1
  import type { Forwarded } from '../props';
2
2
  import type { DeltaSentiment } from '../delta/delta';
3
+ import type { LoadingContract } from '../skeleton/skeleton';
3
4
  export declare const METRIC_CARD_STATES: readonly ["ready", "loading", "empty", "failed"];
4
5
  export type MetricCardState = (typeof METRIC_CARD_STATES)[number];
5
6
  declare const METRIC_CARD_SURFACE: "card";
@@ -13,12 +14,12 @@ export type MetricCardQuietInkRole = typeof METRIC_CARD_QUIET_INK;
13
14
  /** The line's height in pixels. Tall enough to show a month's shape, short
14
15
  * enough that three cards sit in a row above the fold. */
15
16
  export declare const METRIC_CARD_CHART_HEIGHT_PX = 96;
16
- export interface MetricCardContract {
17
+ export interface MetricCardContract extends Pick<LoadingContract, 'loadingLabel'> {
17
18
  /** What the figure is: "Fuel spend". */
18
19
  label: string;
19
- /** The figure, formatted by the caller: "R 412 380". */
20
+ /** The figure, formatted by the caller: "R177 300". */
20
21
  figure: string;
21
- /** How it moved against the period before, sign and words included: "↑ 8.2%". */
22
+ /** How it moved against the period before, sign and words included: "↑ 3.1%". */
22
23
  delta?: Forwarded<string>;
23
24
  /** Whether that move is good or bad news for this figure. More spend is bad; more litres may be good. */
24
25
  deltaSentiment?: Forwarded<DeltaSentiment>;
@@ -21,4 +21,4 @@ export type DSMetricCardProps = Omit<ComponentProps<'section'>, 'children' | 'ti
21
21
  pointLabel?: (index: number) => string;
22
22
  };
23
23
  /** A figure, how it moved and the line of the period against the period before, with when it was last true and where to go next. */
24
- export declare function DSMetricCard({ label, figure, delta, deltaSentiment, values, compare, compareLabel, startLabel, endLabel, chartLabel, state, emptyLabel, failedLabel, headingLevel, actions, link, updatedAt, updatedLabel, onRetry, retryLabel, formatValue, pointLabel, className, ...props }: DSMetricCardProps): import("react/jsx-runtime").JSX.Element;
24
+ export declare function DSMetricCard({ label, figure, delta, deltaSentiment, values, compare, compareLabel, startLabel, endLabel, chartLabel, state, loadingLabel, emptyLabel, failedLabel, headingLevel, actions, link, updatedAt, updatedLabel, onRetry, retryLabel, formatValue, pointLabel, className, ...props }: DSMetricCardProps): import("react/jsx-runtime").JSX.Element;
@@ -7,11 +7,13 @@ import { DSDelta } from '../../delta/web/ds-delta';
7
7
  import { DSFreshnessIndicator } from '../../freshness-indicator/web/ds-freshness-indicator';
8
8
  import { DSMetric } from '../../metric/web/ds-metric';
9
9
  import { DSSkeleton } from '../../skeleton/web/ds-skeleton';
10
+ import { loadingSpoken } from '../../skeleton/skeleton';
11
+ import { SpokenRegion } from '../../lib/web/spoken-region';
10
12
  import { DSText } from '../../text/web/ds-text';
11
13
  import { METRIC_CARD_CHART_HEIGHT_PX, metricCardSpec, } from '../metric-card';
12
14
  const HEADINGS = { 2: 'h2', 3: 'h3', 4: 'h4' };
13
- export function DSMetricCard({ label, figure, delta, deltaSentiment, values, compare, compareLabel, startLabel, endLabel, chartLabel, state = 'ready', emptyLabel, failedLabel, headingLevel = 2, actions, link, updatedAt, updatedLabel, onRetry, retryLabel, formatValue, pointLabel, className, ...props }) {
15
+ export function DSMetricCard({ label, figure, delta, deltaSentiment, values, compare, compareLabel, startLabel, endLabel, chartLabel, state = 'ready', loadingLabel, emptyLabel, failedLabel, headingLevel = 2, actions, link, updatedAt, updatedLabel, onRetry, retryLabel, formatValue, pointLabel, className, ...props }) {
14
16
  const spec = metricCardSpec({ state, failedLabel });
15
17
  const headingId = useId();
16
- return (_jsxs("section", { "aria-labelledby": headingId, "aria-busy": state === 'loading' || undefined, className: cn('bg-card border-border rounded-card flex min-w-0 flex-col gap-3 border p-5', className), ...props, children: [_jsxs("header", { className: "flex min-h-8 items-center justify-between gap-2", children: [_jsx(DSText, { as: HEADINGS[headingLevel], id: headingId, variant: "body-sm-strong", className: "card-title text-card-foreground", children: label }), actions] }), _jsx("div", { className: "flex min-h-9 flex-wrap items-baseline gap-x-2", children: spec.showFigure ? (_jsxs(_Fragment, { children: [_jsx(DSMetric, { size: "md", className: "whitespace-nowrap", children: figure }), delta === undefined ? null : _jsx(DSDelta, { sentiment: deltaSentiment, children: delta })] })) : state === 'loading' ? (_jsx(DSSkeleton, { fits: "heading-lg", className: "w-32" })) : null }), spec.showChart ? (_jsx(DSChart, { values: state === 'empty' ? [] : values, ...(compare === undefined || state === 'empty' ? {} : { compare }), ...(compareLabel === undefined ? {} : { compareLabel }), label: chartLabel, height: METRIC_CARD_CHART_HEIGHT_PX, startLabel: startLabel, endLabel: endLabel, emptyLabel: emptyLabel, scrub: true, ...(formatValue === undefined ? {} : { formatValue }), ...(pointLabel === undefined ? {} : { pointLabel }) })) : state === 'loading' ? (_jsxs("div", { className: "flex flex-col gap-2", "aria-hidden": true, children: [_jsx(DSSkeleton, { className: "w-full rounded-xs", style: { height: METRIC_CARD_CHART_HEIGHT_PX } }), _jsx(DSSkeleton, { fits: "body-xs", className: "w-16" })] })) : (_jsxs("div", { role: "alert", className: "border-border flex flex-col items-center justify-center gap-1 rounded-xs border border-dashed", style: { height: METRIC_CARD_CHART_HEIGHT_PX + 24 }, children: [_jsx(DSText, { variant: "body-sm-strong", children: spec.failedLabel }), onRetry === undefined || retryLabel === undefined ? null : (_jsx(DSButton, { variant: "link", size: "sm", onClick: onRetry, children: retryLabel }))] })), updatedAt === undefined && link === undefined ? null : (_jsxs("footer", { className: "border-border flex items-center justify-between gap-2 border-t pt-3", children: [updatedAt === undefined ? (_jsx("span", {})) : (_jsx(DSFreshnessIndicator, { at: updatedAt, className: "min-w-0", ...(updatedLabel === undefined ? {} : { label: updatedLabel }) })), link === undefined ? null : _jsx("span", { className: "shrink-0 whitespace-nowrap", children: link })] }))] }));
18
+ return (_jsxs(_Fragment, { children: [_jsx(SpokenRegion, { text: loadingSpoken(state === 'loading', loadingLabel) }), _jsxs("section", { "aria-labelledby": headingId, "aria-busy": state === 'loading' || undefined, className: cn('bg-card border-border rounded-card flex min-w-0 flex-col gap-3 border p-5', className), ...props, children: [_jsxs("header", { className: "flex min-h-8 items-center justify-between gap-2", children: [_jsx(DSText, { as: HEADINGS[headingLevel], id: headingId, variant: "body-sm-strong", className: "card-title text-card-foreground", children: label }), state === 'loading' ? null : actions] }), _jsx("div", { className: "flex min-h-9 flex-wrap items-baseline gap-x-2", children: spec.showFigure ? (_jsxs(_Fragment, { children: [_jsx(DSMetric, { size: "md", className: "whitespace-nowrap", children: figure }), delta === undefined ? null : _jsx(DSDelta, { sentiment: deltaSentiment, children: delta })] })) : state === 'loading' ? (_jsx(DSSkeleton, { fits: "heading-lg", className: "w-32" })) : null }), spec.showChart ? (_jsx(DSChart, { values: state === 'empty' ? [] : values, ...(compare === undefined || state === 'empty' ? {} : { compare }), ...(compareLabel === undefined ? {} : { compareLabel }), label: chartLabel, height: METRIC_CARD_CHART_HEIGHT_PX, startLabel: startLabel, endLabel: endLabel, emptyLabel: emptyLabel, scrub: true, ...(formatValue === undefined ? {} : { formatValue }), ...(pointLabel === undefined ? {} : { pointLabel }) })) : state === 'loading' ? (_jsxs("div", { className: "flex flex-col gap-2", "aria-hidden": true, children: [_jsx(DSSkeleton, { className: "h-(--line-h) w-full rounded-xs", style: { '--line-h': `${String(METRIC_CARD_CHART_HEIGHT_PX)}px` } }), _jsx(DSSkeleton, { fits: "body-xs", className: "w-16" })] })) : (_jsxs("div", { role: "alert", className: "border-border flex flex-col items-center justify-center gap-1 rounded-xs border border-dashed", style: { height: METRIC_CARD_CHART_HEIGHT_PX + 24 }, children: [_jsx(DSText, { variant: "body-sm-strong", children: spec.failedLabel }), onRetry === undefined || retryLabel === undefined ? null : (_jsx(DSButton, { variant: "link", size: "sm", onClick: onRetry, children: retryLabel }))] })), updatedAt === undefined && link === undefined ? null : (_jsxs("footer", { className: "border-border flex items-center justify-between gap-2 border-t pt-3", children: [updatedAt === undefined ? (_jsx("span", {})) : (_jsx(DSFreshnessIndicator, { at: updatedAt, className: "min-w-0", ...(updatedLabel === undefined ? {} : { label: updatedLabel }) })), link === undefined ? null : _jsx("span", { className: "shrink-0 whitespace-nowrap", children: link })] }))] })] }));
17
19
  }
@@ -8,7 +8,8 @@ export function DSMonthPicker({ value, min, max, label, disabled = false, onValu
8
8
  const canBack = monthCanStep(value, -1, min, max);
9
9
  const canForward = monthCanStep(value, 1, min, max);
10
10
  const arrow = (allowed, delta) => ({
11
- ...(disabled ? { disabled: true } : allowed ? {} : { 'aria-disabled': true }),
11
+ disabled: disabled || !allowed,
12
+ focusableWhenDisabled: !disabled,
12
13
  onClick: () => {
13
14
  if (allowed && !disabled)
14
15
  onValueChange(monthStep(value, delta));
@@ -26,7 +26,7 @@ export function DSMonthStrip({ value, from, to, label, onValueChange, disabled =
26
26
  refs.current[next]?.focus();
27
27
  }
28
28
  }
29
- return (_jsx("div", { ...props, role: "radiogroup", "aria-label": label, "aria-disabled": disabled || undefined, onKeyDown: onKeyDown, className: cn('flex max-w-full gap-1 overflow-x-auto pb-1', className), children: months.map((month, index) => {
29
+ return (_jsx("div", { ...props, role: "radiogroup", "aria-label": label, "aria-disabled": disabled || undefined, onKeyDown: onKeyDown, className: cn('-my-1 -ms-1 flex max-w-[calc(100%+--spacing(1))] gap-1 overflow-x-auto p-1 pb-2 scroll-px-1', className), children: months.map((month, index) => {
30
30
  const selected = month === value;
31
31
  return (_jsxs("button", { ref: (node) => {
32
32
  refs.current[index] = node;
package/dist/motion.d.ts CHANGED
@@ -5,7 +5,7 @@
5
5
  * component, which is why this is a class list and not a component list and
6
6
  * why the browser test says so rather than claiming to sweep 305 components.
7
7
  */
8
- export declare const MOTION_BEARING_CLASSES: readonly ["transition-control", "press-nudge", "transition-spring", "transition-spring-calm", "animate-fade-in", "animate-slide-in", "animate-slide-in-left", "animate-slide-in-top", "animate-slide-in-bottom", "animate-answer", "animate-sheet-in", "animate-alert-in", "animate-toast-in", "animate-toast-part", "animate-takeover-in", "animate-fade-out", "animate-slide-out", "animate-slide-out-left", "animate-slide-out-top", "animate-slide-out-bottom", "animate-sheet-out", "animate-toast-out", "animate-takeover-out", "animate-pulse-soft", "animate-row-settle", "animate-value-flash", "animate-reveal-x", "animate-rise-y", "animate-rise-x", "animate-draw-arc", "animate-shimmer", "animate-orbit-x", "animate-orbit-y"];
8
+ export declare const MOTION_BEARING_CLASSES: readonly ["transition-control", "transition-spring", "transition-spring-calm", "animate-fade-in", "animate-slide-in", "animate-slide-in-left", "animate-slide-in-top", "animate-slide-in-bottom", "animate-answer", "animate-sheet-in", "animate-alert-in", "animate-toast-in", "animate-toast-part", "animate-takeover-in", "animate-fade-out", "animate-slide-out", "animate-slide-out-left", "animate-slide-out-top", "animate-slide-out-bottom", "animate-sheet-out", "animate-toast-out", "animate-takeover-out", "animate-pulse-soft", "animate-row-settle", "animate-value-flash", "animate-digit-in", "animate-reveal-x", "animate-rise-y", "animate-rise-x", "animate-draw-arc", "animate-shimmer", "animate-orbit-x", "animate-orbit-y"];
9
9
  export type MotionBearingClass = (typeof MOTION_BEARING_CLASSES)[number];
10
10
  /**
11
11
  * The classes the guard does NOT bring to an instant, each with its reason.
@@ -40,7 +40,7 @@ export type ReducedMotionSwap = keyof typeof REDUCED_MOTION_SWAPS;
40
40
  */
41
41
  export declare const REDUCED_MOTION_CEILING_MS = 1;
42
42
  /**
43
- * `DESIGN.md`: "Entrances run at `base`, exits at `fast`."
43
+ * `DESIGN.md`: "Entrances run at `base`, exits a step below at `out`."
44
44
  *
45
45
  * Read off `theme.css`'s `--animate-*` declarations by `motion.test.ts` rather
46
46
  * than restated here as values, what this holds is the RULE and its exceptions.
@@ -60,6 +60,7 @@ export declare const MOTION_RULE_EXCEPTIONS: {
60
60
  readonly 'pulse-soft': "a loop, not an arrival. It runs at the scene duration and repeats.";
61
61
  readonly 'row-settle': "a hold, a row that has just arrived, keeping its tint before letting go. It runs at `linger` and settles forwards.";
62
62
  readonly 'value-flash': "a trace, not an arrival, a figure that a refresh just changed takes a tint and releases it. Nobody is waiting on it, so it runs at `scene-short`, by opacity alone.";
63
+ readonly 'digit-in': "a digit that changed rising a third of a line into its own window. It is the new digit from its first frame, so it is not an arrival anyone waits on; it runs on the precise spring’s curve and length, the motion a phone runs for real.";
63
64
  readonly 'reveal-x': "a chart drawing itself in, once, on a first load, the one reveal allowed past 300ms, because the motion is the reading order. It runs at `expressive`.";
64
65
  readonly 'rise-y': "a bar rising from its baseline, staggered in reading order out of the same 500ms budget as `reveal-x`, so each bar runs at `slow` rather than `base`.";
65
66
  readonly 'rise-x': "the horizontal bar’s rise, `rise-y` turned on its side, staggered the same way out of the same budget, so it runs at `slow`.";
@@ -85,7 +86,7 @@ export declare const TRANSFORM_ONLY_ENTRANCES: readonly ["alert-in", "toast-in"]
85
86
  * THE SPRINGS and the rules every animated component in this package keeps.
86
87
  *
87
88
  * Shared vocabulary rather than a component, beside `interaction.ts` and
88
- * `scale.ts`: a sort, a ticker and a sheet all need the same two springs and
89
+ * `scale.ts`: a changed digit, a marker and a sheet all need the same two springs and
89
90
  * defining them on whichever component happened to need one first is how the
90
91
  * press scales ended up living on the button.
91
92
  *
@@ -156,6 +157,20 @@ export declare const SPRING_CURVE_SAMPLES = 24;
156
157
  * length.
157
158
  */
158
159
  export declare function springCurve(name?: SpringName): number[];
160
+ /**
161
+ * How far below its window a digit that changed starts, as a fraction of the
162
+ * figure's line, before it rises into place (`animate-digit-in` on the web, the
163
+ * precise spring on native).
164
+ *
165
+ * WHY A RISE AND NOT A REEL. A reel of ten digits turning from 2 to 8 shows 3 to
166
+ * 7 on its way, so a figure read mid-turn is a sum that never existed: a top-up
167
+ * from R1 299 to R1 301 drew R1 355 for a few frames. A rise draws the new digit
168
+ * from its first frame and only moves it, so every frame shows the true figure
169
+ * (rule 1). A third of a line is enough to read as "this digit changed" and
170
+ * little enough that the digit is legible on the first frame, clipped at its
171
+ * foot rather than missing.
172
+ */
173
+ export declare const DIGIT_ARRIVAL = 0.35;
159
174
  /** The ceiling, in milliseconds, for motion a person is waiting on. */
160
175
  export declare const INTERACTIVE_MOTION_CEILING_MS = 300;
161
176
  export declare const BUSY_MOTION = "animate-busy";
package/dist/motion.js CHANGED
@@ -1,6 +1,5 @@
1
1
  export const MOTION_BEARING_CLASSES = [
2
2
  'transition-control',
3
- 'press-nudge',
4
3
  'transition-spring',
5
4
  'transition-spring-calm',
6
5
  'animate-fade-in',
@@ -25,6 +24,7 @@ export const MOTION_BEARING_CLASSES = [
25
24
  'animate-pulse-soft',
26
25
  'animate-row-settle',
27
26
  'animate-value-flash',
27
+ 'animate-digit-in',
28
28
  'animate-reveal-x',
29
29
  'animate-rise-y',
30
30
  'animate-rise-x',
@@ -65,6 +65,7 @@ export const MOTION_RULE_EXCEPTIONS = {
65
65
  'pulse-soft': 'a loop, not an arrival. It runs at the scene duration and repeats.',
66
66
  'row-settle': 'a hold, a row that has just arrived, keeping its tint before letting go. It runs at `linger` and settles forwards.',
67
67
  'value-flash': 'a trace, not an arrival, a figure that a refresh just changed takes a tint and releases it. Nobody is waiting on it, so it runs at `scene-short`, by opacity alone.',
68
+ 'digit-in': 'a digit that changed rising a third of a line into its own window. It is the new digit from its first frame, so it is not an arrival anyone waits on; it runs on the precise spring’s curve and length, the motion a phone runs for real.',
68
69
  'reveal-x': 'a chart drawing itself in, once, on a first load, the one reveal allowed past 300ms, because the motion is the reading order. It runs at `expressive`.',
69
70
  'rise-y': 'a bar rising from its baseline, staggered in reading order out of the same 500ms budget as `reveal-x`, so each bar runs at `slow` rather than `base`.',
70
71
  'rise-x': 'the horizontal bar’s rise, `rise-y` turned on its side, staggered the same way out of the same budget, so it runs at `slow`.',
@@ -121,6 +122,7 @@ export function springCurve(name = 'precise') {
121
122
  points[SPRING_CURVE_SAMPLES] = 1;
122
123
  return points;
123
124
  }
125
+ export const DIGIT_ARRIVAL = 0.35;
124
126
  export const INTERACTIVE_MOTION_CEILING_MS = 300;
125
127
  export const BUSY_MOTION = 'animate-busy';
126
128
  export const BUSY_MOTION_STILL = 'animate-busy-still';
@@ -18,14 +18,39 @@ export declare function multiSelectVisible(options: readonly MultiSelectOption[]
18
18
  export declare function multiSelectToggle(value: readonly string[], key: string): string[];
19
19
  /** How much of what is visible is already chosen. */
20
20
  export type MultiSelectAllState = 'none' | 'some' | 'all';
21
+ /** The visible rows the select-all row acts on: every one but an unavailable one. */
22
+ export declare function multiSelectChoosable(visible: readonly MultiSelectOption[]): readonly MultiSelectOption[];
21
23
  export declare function multiSelectAllState(value: readonly string[], visible: readonly MultiSelectOption[]): MultiSelectAllState;
22
- /** The value after the select-all row: every visible row in, or, when they
23
- * already all are, every visible row out. Nothing outside the visible rows is
24
+ /** The value after the select-all row: every visible row that can be chosen
25
+ * in, or, when they already all are, those rows out. Nothing outside them is
24
26
  * touched either way. */
25
27
  export declare function multiSelectToggleAll(value: readonly string[], visible: readonly MultiSelectOption[]): string[];
28
+ /** The words the field draws itself, so a screen can swap any of them.
29
+ * Defaults are English, held here and not in the adapter. */
30
+ export interface MultiSelectCopy {
31
+ /** The line shown when nothing matches, when no `emptyLabel` is given. */
32
+ noMatches: string;
33
+ /** The line shown while loading, when no `loadingLabel` is given. */
34
+ loading: string;
35
+ /** The select-all row while not every result is chosen, given how many. */
36
+ selectAll: (count: number) => string;
37
+ /** The select-all row once every result is chosen, given how many. */
38
+ clearAll: (count: number) => string;
39
+ /** The fold's words, given how many chips are hidden. */
40
+ more: (hidden: number) => string;
41
+ /** The fold's words once it is open. */
42
+ showFewer: string;
43
+ /** What is said about the field's contents beside its name, given how many are chosen. */
44
+ summary: (count: number) => string;
45
+ /** Names a chip's remove control, given its words. */
46
+ remove: (name: string) => string;
47
+ /** Names a chosen label's remove control, given its name. */
48
+ removeLabel: (name: string) => string;
49
+ }
50
+ export declare const MULTI_SELECT_COPY: MultiSelectCopy;
26
51
  /** What the select-all row says. It names the count and the direction, so what
27
52
  * it will do is written on it. */
28
- export declare function multiSelectAllLabel(state: MultiSelectAllState, count: number): string;
53
+ export declare function multiSelectAllLabel(state: MultiSelectAllState, count: number, copy?: MultiSelectCopy): string;
29
54
  /** Whether the select-all row is offered. Not for one row, "Select all 1
30
55
  * result" is the row beneath it said twice. */
31
56
  export declare function multiSelectOffersAll(visibleCount: number): boolean;
@@ -42,14 +67,14 @@ export declare function multiSelectChips<T>(chosen: readonly T[], max?: number,
42
67
  hidden: number;
43
68
  };
44
69
  /** The fold's own words. */
45
- export declare function multiSelectMoreLabel(hidden: number): string;
70
+ export declare function multiSelectMoreLabel(hidden: number, copy?: MultiSelectCopy): string;
46
71
  /** What is announced about the field's contents beside its name. */
47
- export declare function multiSelectSummary(count: number): string;
72
+ export declare function multiSelectSummary(count: number, copy?: MultiSelectCopy): string;
48
73
  /** How many rows the list is showing, the select-all row included. The arrow
49
74
  * keys move over this count. */
50
- export declare function multiSelectRowCount(visibleCount: number): number;
75
+ export declare function multiSelectRowCount(visibleCount: number, choosableCount?: number): number;
51
76
  /** Clamp a target row into range. */
52
- export declare function multiSelectMoveIndex(visibleCount: number, to: number): number;
77
+ export declare function multiSelectMoveIndex(visibleCount: number, to: number, choosableCount?: number): number;
53
78
  /** What Enter on the active row means. */
54
79
  export type MultiSelectCommit = {
55
80
  kind: 'all';
@@ -82,17 +107,22 @@ export interface MultiSelectContract {
82
107
  maxChips?: Forwarded<number>;
83
108
  /** Shows the list's loading row in place of results. */
84
109
  loading?: Forwarded<boolean>;
85
- /** The line shown when nothing matches. */
110
+ /** The line shown when nothing matches. Wins over `copy.noMatches`. */
86
111
  emptyLabel?: Forwarded<string>;
87
- /** The line shown while loading. */
112
+ /** The line shown while loading. Wins over `copy.loading`. */
88
113
  loadingLabel?: Forwarded<string>;
89
114
  placeholder?: Forwarded<string>;
90
115
  /** Paints the invalid border. */
91
116
  invalid?: Forwarded<boolean>;
92
117
  /** Blocks the field and dims it. */
93
118
  disabled?: Forwarded<boolean>;
119
+ /** Shows the chosen values to read but not change: the chips lose their
120
+ * remove controls, the list never opens and nothing typed is taken. */
121
+ readOnly?: Forwarded<boolean>;
94
122
  /** Whether the list is open. The field holds this itself when it is omitted. */
95
123
  open?: Forwarded<boolean>;
96
124
  /** Told the list opened or closed. */
97
125
  onOpenChange?: (open: boolean) => void;
126
+ /** Replaces any of the words the field draws itself (see `MultiSelectCopy`). */
127
+ copy?: Partial<MultiSelectCopy>;
98
128
  }