@tfn-design/design-system 0.3.0 → 0.4.1

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 (751) 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/native/animated.d.ts +4 -5
  392. package/dist/lib/native/animated.js +3 -4
  393. package/dist/lib/time-of-day.d.ts +21 -0
  394. package/dist/lib/time-of-day.js +37 -0
  395. package/dist/lib/web/chart-finish.d.ts +1 -1
  396. package/dist/lib/web/chart-finish.js +1 -1
  397. package/dist/lib/web/density.d.ts +1 -0
  398. package/dist/lib/web/density.js +7 -0
  399. package/dist/lib/web/focus-habits.js +20 -8
  400. package/dist/lib/web/focus-trap.d.ts +10 -0
  401. package/dist/lib/web/focus-trap.js +4 -1
  402. package/dist/lib/web/live-announcer.d.ts +2 -0
  403. package/dist/lib/web/live-announcer.js +2 -1
  404. package/dist/lib/web/touch-target.d.ts +4 -4
  405. package/dist/lib/web/touch-target.js +3 -3
  406. package/dist/lib/web/use-anchored-surface.js +3 -2
  407. package/dist/lib/web/use-overlay.js +7 -1
  408. package/dist/list-page/list-page.d.ts +2 -1
  409. package/dist/list-page/web/ds-list-page.js +1 -5
  410. package/dist/list-row/list-row.d.ts +6 -6
  411. package/dist/list-row/list-row.js +4 -5
  412. package/dist/list-row/native/ds-list-row.js +7 -2
  413. package/dist/list-row/web/ds-list-row-group.d.ts +6 -2
  414. package/dist/list-row/web/ds-list-row-group.js +4 -2
  415. package/dist/list-row/web/ds-list-row.js +9 -9
  416. package/dist/loading-screen/native/ds-loading-screen.js +1 -1
  417. package/dist/log-viewer/log-viewer.d.ts +2 -2
  418. package/dist/log-viewer/log-viewer.js +1 -1
  419. package/dist/log-viewer/web/ds-log-viewer.js +6 -5
  420. package/dist/map/map.d.ts +5 -0
  421. package/dist/map/map.js +2 -0
  422. package/dist/map/web/ds-map.js +9 -3
  423. package/dist/map-banner/native/ds-map-banner.js +3 -3
  424. package/dist/map-banner/web/ds-map-banner.js +4 -4
  425. package/dist/map-controls/map-controls.d.ts +3 -5
  426. package/dist/map-controls/map-controls.js +4 -4
  427. package/dist/map-controls/native/ds-map-controls.js +1 -1
  428. package/dist/map-controls/web/ds-map-controls.js +1 -1
  429. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.js +3 -2
  430. package/dist/map-heatmap-layer/map-heatmap-layer.d.ts +1 -1
  431. package/dist/map-layers/map-layers.d.ts +1 -1
  432. package/dist/map-layers/map-layers.js +1 -1
  433. package/dist/map-layers/native/ds-map-layers.d.ts +4 -2
  434. package/dist/map-layers/native/ds-map-layers.js +5 -4
  435. package/dist/map-layers/web/ds-map-layers.js +4 -4
  436. package/dist/map-list/map-list.d.ts +2 -1
  437. package/dist/map-list/web/ds-map-list.d.ts +1 -1
  438. package/dist/map-list/web/ds-map-list.js +19 -16
  439. package/dist/map-marker/map-marker.d.ts +5 -0
  440. package/dist/map-marker/map-marker.js +6 -0
  441. package/dist/map-marker/web/ds-map-marker.d.ts +12 -3
  442. package/dist/map-marker/web/ds-map-marker.js +18 -8
  443. package/dist/map-search/map-search.d.ts +9 -0
  444. package/dist/map-search/map-search.js +13 -0
  445. package/dist/map-search/native/ds-map-search.d.ts +10 -3
  446. package/dist/map-search/native/ds-map-search.js +32 -19
  447. package/dist/map-search/web/ds-map-search.d.ts +8 -3
  448. package/dist/map-search/web/ds-map-search.js +37 -27
  449. package/dist/map-search-area/native/ds-map-search-area.js +2 -1
  450. package/dist/map-search-area/web/ds-map-search-area.js +2 -1
  451. package/dist/map-sheet/native/ds-map-sheet.js +1 -1
  452. package/dist/map-sheet/web/ds-map-sheet.js +2 -2
  453. package/dist/map-summary/map-summary.d.ts +2 -1
  454. package/dist/map-summary/web/ds-map-summary.d.ts +2 -2
  455. package/dist/map-summary/web/ds-map-summary.js +18 -9
  456. package/dist/mention-input/mention-input.d.ts +23 -2
  457. package/dist/mention-input/mention-input.js +15 -8
  458. package/dist/mention-input/native/ds-mention-input.d.ts +1 -1
  459. package/dist/mention-input/native/ds-mention-input.js +6 -9
  460. package/dist/mention-input/web/ds-mention-input.d.ts +1 -1
  461. package/dist/mention-input/web/ds-mention-input.js +6 -5
  462. package/dist/menu-button/web/ds-menu-button.d.ts +2 -2
  463. package/dist/menu-button/web/ds-menu-button.js +9 -4
  464. package/dist/meter/meter.d.ts +5 -2
  465. package/dist/meter/meter.js +2 -1
  466. package/dist/meter/native/ds-meter.d.ts +2 -2
  467. package/dist/meter/native/ds-meter.js +13 -3
  468. package/dist/meter/web/ds-meter.d.ts +1 -1
  469. package/dist/meter/web/ds-meter.js +16 -9
  470. package/dist/metric/metric.d.ts +13 -9
  471. package/dist/metric/native/ds-metric.d.ts +1 -1
  472. package/dist/metric/native/ds-metric.js +26 -16
  473. package/dist/metric/web/ds-metric.d.ts +1 -1
  474. package/dist/metric/web/ds-metric.js +21 -5
  475. package/dist/metric-card/metric-card.d.ts +4 -3
  476. package/dist/metric-card/web/ds-metric-card.d.ts +1 -1
  477. package/dist/metric-card/web/ds-metric-card.js +4 -2
  478. package/dist/month-picker/web/ds-month-picker.js +2 -1
  479. package/dist/month-strip/web/ds-month-strip.js +1 -1
  480. package/dist/motion.d.ts +18 -3
  481. package/dist/motion.js +3 -1
  482. package/dist/multi-select/multi-select.d.ts +39 -9
  483. package/dist/multi-select/multi-select.js +35 -22
  484. package/dist/multi-select/web/ds-multi-select.d.ts +1 -1
  485. package/dist/multi-select/web/ds-multi-select.js +42 -24
  486. package/dist/native.d.ts +12 -0
  487. package/dist/native.js +8 -0
  488. package/dist/notification-list/native/ds-notification-list.d.ts +1 -1
  489. package/dist/notification-list/native/ds-notification-list.js +14 -7
  490. package/dist/notification-list/notification-list.d.ts +2 -1
  491. package/dist/notification-list/web/ds-notification-list.d.ts +1 -1
  492. package/dist/notification-list/web/ds-notification-list.js +10 -4
  493. package/dist/number-field/native/ds-number-field.js +1 -1
  494. package/dist/number-field/web/ds-number-field.js +1 -1
  495. package/dist/otp/native/ds-otp-field.js +3 -21
  496. package/dist/otp/native/ds-otp.js +3 -3
  497. package/dist/otp/otp.d.ts +3 -3
  498. package/dist/otp/web/ds-otp.js +3 -3
  499. package/dist/overflow-menu/web/ds-overflow-menu.js +7 -2
  500. package/dist/page-head/web/ds-page-head.js +2 -2
  501. package/dist/panel/native/ds-panel.js +1 -1
  502. package/dist/panel/panel.d.ts +1 -1
  503. package/dist/panel/web/ds-panel.d.ts +3 -1
  504. package/dist/panel/web/ds-panel.js +3 -2
  505. package/dist/password-feedback/web/ds-password-feedback.d.ts +1 -1
  506. package/dist/password-feedback/web/ds-password-feedback.js +3 -3
  507. package/dist/password-input/web/ds-password-input.d.ts +7 -2
  508. package/dist/password-input/web/ds-password-input.js +28 -3
  509. package/dist/password-requirements/password-requirements.d.ts +12 -2
  510. package/dist/password-requirements/password-requirements.js +6 -8
  511. package/dist/password-requirements/web/ds-password-requirements.js +5 -5
  512. package/dist/password-strength/web/ds-password-strength.js +2 -2
  513. package/dist/payment-card/native/ds-payment-card.d.ts +1 -1
  514. package/dist/payment-card/native/ds-payment-card.js +1 -1
  515. package/dist/payment-card/web/ds-payment-card.d.ts +1 -1
  516. package/dist/payment-card/web/ds-payment-card.js +1 -1
  517. package/dist/people-cell/people-cell.d.ts +5 -2
  518. package/dist/people-cell/web/ds-people-cell.d.ts +1 -1
  519. package/dist/people-cell/web/ds-people-cell.js +6 -2
  520. package/dist/person-cell/person-cell.d.ts +5 -2
  521. package/dist/person-cell/web/ds-person-cell.d.ts +1 -1
  522. package/dist/person-cell/web/ds-person-cell.js +11 -1
  523. package/dist/phone-field/native/ds-phone-field.js +2 -2
  524. package/dist/phone-field/phone-field.d.ts +35 -0
  525. package/dist/phone-field/phone-field.js +38 -0
  526. package/dist/phone-field/web/ds-phone-field.d.ts +31 -3
  527. package/dist/phone-field/web/ds-phone-field.js +45 -8
  528. package/dist/place-card/native/ds-place-card.d.ts +7 -3
  529. package/dist/place-card/native/ds-place-card.js +32 -21
  530. package/dist/place-card/place-card.d.ts +12 -6
  531. package/dist/place-card/place-card.js +6 -3
  532. package/dist/place-card/web/ds-place-card.d.ts +5 -3
  533. package/dist/place-card/web/ds-place-card.js +39 -27
  534. package/dist/plan-chart/plan-chart.d.ts +2 -3
  535. package/dist/plan-chart/web/ds-plan-chart.d.ts +1 -1
  536. package/dist/plan-chart/web/ds-plan-chart.js +34 -6
  537. package/dist/popover/popover.d.ts +7 -3
  538. package/dist/popover/web/ds-popover.d.ts +5 -1
  539. package/dist/popover/web/ds-popover.js +4 -2
  540. package/dist/priority-indicator/native/ds-priority-indicator.js +4 -4
  541. package/dist/priority-indicator/priority-indicator.d.ts +3 -3
  542. package/dist/priority-indicator/priority-indicator.js +3 -3
  543. package/dist/priority-indicator/web/ds-priority-indicator.js +4 -4
  544. package/dist/profile-card/profile-card.d.ts +2 -1
  545. package/dist/profile-card/web/ds-profile-card.d.ts +2 -2
  546. package/dist/profile-card/web/ds-profile-card.js +16 -3
  547. package/dist/progress-bar/native/ds-progress-bar.js +2 -1
  548. package/dist/progress-bar/web/ds-progress-bar.js +2 -1
  549. package/dist/progress-cell/progress-cell.d.ts +8 -3
  550. package/dist/progress-cell/progress-cell.js +1 -1
  551. package/dist/progress-cell/web/ds-progress-cell.d.ts +5 -2
  552. package/dist/progress-cell/web/ds-progress-cell.js +6 -2
  553. package/dist/progress-ring/native/ds-progress-ring.js +16 -11
  554. package/dist/progress-ring/progress-ring.d.ts +8 -4
  555. package/dist/progress-ring/progress-ring.js +7 -3
  556. package/dist/progress-ring/web/ds-progress-ring.js +16 -10
  557. package/dist/proportion-bar/native/ds-proportion-bar.d.ts +2 -2
  558. package/dist/proportion-bar/native/ds-proportion-bar.js +18 -7
  559. package/dist/proportion-bar/proportion-bar.d.ts +10 -3
  560. package/dist/proportion-bar/proportion-bar.js +6 -1
  561. package/dist/proportion-bar/web/ds-proportion-bar.d.ts +1 -1
  562. package/dist/proportion-bar/web/ds-proportion-bar.js +21 -14
  563. package/dist/quick-actions/native/ds-quick-actions.js +17 -2
  564. package/dist/quick-actions/quick-actions.d.ts +32 -2
  565. package/dist/quick-actions/quick-actions.js +9 -1
  566. package/dist/quick-actions/web/ds-quick-actions.js +20 -6
  567. package/dist/radar-chart/radar-chart.d.ts +11 -3
  568. package/dist/radar-chart/radar-chart.js +21 -3
  569. package/dist/radar-chart/web/ds-radar-chart.d.ts +1 -1
  570. package/dist/radar-chart/web/ds-radar-chart.js +34 -22
  571. package/dist/radial-progress/native/ds-radial-progress.d.ts +6 -2
  572. package/dist/radial-progress/native/ds-radial-progress.js +34 -11
  573. package/dist/radial-progress/radial-progress.d.ts +11 -2
  574. package/dist/radial-progress/radial-progress.js +9 -0
  575. package/dist/radial-progress/web/ds-radial-progress.d.ts +6 -2
  576. package/dist/radial-progress/web/ds-radial-progress.js +24 -10
  577. package/dist/radio/radio.d.ts +4 -4
  578. package/dist/radio/radio.js +4 -4
  579. package/dist/radio/web/ds-radio.d.ts +6 -2
  580. package/dist/radio/web/ds-radio.js +22 -10
  581. package/dist/radio-group/radio-group.d.ts +41 -5
  582. package/dist/radio-group/radio-group.js +5 -0
  583. package/dist/radio-group/web/ds-radio-group.d.ts +1 -1
  584. package/dist/radio-group/web/ds-radio-group.js +7 -2
  585. package/dist/rating-badge/rating-badge.d.ts +8 -2
  586. package/dist/rating-badge/rating-badge.js +5 -0
  587. package/dist/rating-badge/web/ds-rating-badge.d.ts +2 -2
  588. package/dist/rating-badge/web/ds-rating-badge.js +6 -4
  589. package/dist/recipient-select/recipient-select.d.ts +7 -0
  590. package/dist/recipient-select/recipient-select.js +3 -0
  591. package/dist/recipient-select/web/ds-recipient-select.js +4 -4
  592. package/dist/record-panel/record-panel.d.ts +17 -2
  593. package/dist/record-panel/web/ds-record-panel.d.ts +48 -13
  594. package/dist/record-panel/web/ds-record-panel.js +27 -18
  595. package/dist/reorder-list/reorder-list.d.ts +3 -0
  596. package/dist/reorder-list/web/ds-reorder-list.d.ts +6 -1
  597. package/dist/reorder-list/web/ds-reorder-list.js +6 -4
  598. package/dist/resend-control/native/ds-resend-control.d.ts +24 -0
  599. package/dist/resend-control/native/ds-resend-control.js +73 -0
  600. package/dist/resend-control/resend-control.d.ts +2 -0
  601. package/dist/resend-control/resend-control.js +2 -0
  602. package/dist/resend-control/web/ds-resend-control.js +3 -3
  603. package/dist/route-fields/route-fields.d.ts +79 -0
  604. package/dist/route-fields/route-fields.js +71 -0
  605. package/dist/route-fields/web/ds-route-fields.d.ts +5 -0
  606. package/dist/route-fields/web/ds-route-fields.js +83 -0
  607. package/dist/route-line/web/ds-route-line.js +2 -2
  608. package/dist/save-bar/save-bar.d.ts +1 -1
  609. package/dist/save-bar/save-bar.js +1 -1
  610. package/dist/save-bar/web/ds-save-bar.js +2 -2
  611. package/dist/scanner/scanner.d.ts +1 -1
  612. package/dist/scanner/scanner.js +2 -1
  613. package/dist/scatter-chart/scatter-chart.d.ts +2 -3
  614. package/dist/scatter-chart/web/ds-scatter-chart.d.ts +1 -1
  615. package/dist/scatter-chart/web/ds-scatter-chart.js +13 -4
  616. package/dist/schedule-chart/schedule-chart.d.ts +187 -0
  617. package/dist/schedule-chart/schedule-chart.js +285 -0
  618. package/dist/schedule-chart/web/ds-schedule-chart.d.ts +24 -0
  619. package/dist/schedule-chart/web/ds-schedule-chart.js +143 -0
  620. package/dist/segmented-control/native/ds-segmented-control.d.ts +1 -1
  621. package/dist/segmented-control/native/ds-segmented-control.js +1 -1
  622. package/dist/segmented-control/segmented-control.d.ts +7 -0
  623. package/dist/segmented-control/web/ds-segmented-control.d.ts +1 -1
  624. package/dist/segmented-control/web/ds-segmented-control.js +4 -3
  625. package/dist/select/native/ds-select.js +6 -3
  626. package/dist/select/select.d.ts +5 -0
  627. package/dist/select/web/ds-select.d.ts +14 -1
  628. package/dist/select/web/ds-select.js +22 -12
  629. package/dist/settings-directory/native/ds-settings-directory.js +1 -1
  630. package/dist/settings-directory/web/ds-settings-directory.js +1 -1
  631. package/dist/settings-row/web/ds-settings-row.d.ts +3 -1
  632. package/dist/settings-row/web/ds-settings-row.js +2 -2
  633. package/dist/sheet/web/ds-sheet.js +3 -3
  634. package/dist/side-nav/side-nav.d.ts +2 -1
  635. package/dist/side-nav/web/ds-side-nav-collapse.d.ts +4 -1
  636. package/dist/side-nav/web/ds-side-nav-collapse.js +6 -3
  637. package/dist/side-nav/web/ds-side-nav-header.js +1 -1
  638. package/dist/side-nav/web/ds-side-nav-primary.js +1 -1
  639. package/dist/side-nav/web/ds-side-nav-profile.js +1 -1
  640. package/dist/side-nav/web/ds-side-nav.d.ts +1 -1
  641. package/dist/side-nav/web/ds-side-nav.js +3 -3
  642. package/dist/skeleton/skeleton.d.ts +20 -0
  643. package/dist/skeleton/skeleton.js +4 -0
  644. package/dist/slider/native/ds-slider.js +1 -1
  645. package/dist/small-multiples/small-multiples.d.ts +3 -4
  646. package/dist/small-multiples/small-multiples.js +2 -1
  647. package/dist/small-multiples/web/ds-small-multiples.d.ts +1 -1
  648. package/dist/small-multiples/web/ds-small-multiples.js +8 -2
  649. package/dist/sparkline/sparkline.d.ts +19 -7
  650. package/dist/sparkline/sparkline.js +42 -17
  651. package/dist/sparkline/web/ds-sparkline.d.ts +1 -1
  652. package/dist/sparkline/web/ds-sparkline.js +4 -3
  653. package/dist/split-pane/web/ds-split-pane.js +2 -2
  654. package/dist/stat-tile/native/ds-stat-tile.d.ts +3 -3
  655. package/dist/stat-tile/native/ds-stat-tile.js +14 -7
  656. package/dist/stat-tile/stat-tile.d.ts +14 -8
  657. package/dist/stat-tile/web/ds-stat-tile.d.ts +4 -2
  658. package/dist/stat-tile/web/ds-stat-tile.js +8 -5
  659. package/dist/state-message/web/ds-state-message.d.ts +6 -2
  660. package/dist/state-message/web/ds-state-message.js +5 -2
  661. package/dist/status-badge/native/ds-status-badge.js +3 -3
  662. package/dist/status-badge/status-badge.d.ts +3 -3
  663. package/dist/status-badge/status-badge.js +1 -1
  664. package/dist/status-badge/web/ds-status-badge.js +4 -4
  665. package/dist/status-cell/status-cell.d.ts +5 -2
  666. package/dist/status-cell/web/ds-status-cell.d.ts +6 -2
  667. package/dist/status-cell/web/ds-status-cell.js +7 -2
  668. package/dist/status-control/web/ds-status-control.js +3 -3
  669. package/dist/status-dot/native/ds-status-dot.js +1 -1
  670. package/dist/status-dot/status-dot.d.ts +2 -2
  671. package/dist/status-dot/status-dot.js +2 -2
  672. package/dist/status-dot/web/ds-status-dot.js +2 -2
  673. package/dist/stepper-form/stepper-form.d.ts +27 -4
  674. package/dist/stepper-form/stepper-form.js +17 -9
  675. package/dist/stepper-form/web/ds-stepper-form.d.ts +1 -1
  676. package/dist/stepper-form/web/ds-stepper-form.js +7 -5
  677. package/dist/stick-chart/stick-chart.d.ts +2 -1
  678. package/dist/stick-chart/stick-chart.js +2 -1
  679. package/dist/stick-chart/web/ds-stick-chart.d.ts +1 -1
  680. package/dist/stick-chart/web/ds-stick-chart.js +17 -3
  681. package/dist/switch/native/ds-switch.js +1 -1
  682. package/dist/system-state/native/ds-system-state.d.ts +29 -0
  683. package/dist/system-state/native/ds-system-state.js +68 -0
  684. package/dist/system-state/system-state.js +4 -3
  685. package/dist/system-state/web/ds-system-state.js +2 -2
  686. package/dist/table-toolbar/web/ds-table-toolbar.js +1 -1
  687. package/dist/tabs/tabs.d.ts +5 -0
  688. package/dist/tabs/tabs.js +2 -0
  689. package/dist/tabs/web/ds-tabs.js +2 -2
  690. package/dist/task-shell/task-shell.d.ts +15 -6
  691. package/dist/task-shell/task-shell.js +5 -2
  692. package/dist/task-shell/web/ds-task-shell.d.ts +21 -6
  693. package/dist/task-shell/web/ds-task-shell.js +52 -18
  694. package/dist/text/native/ds-text.js +1 -1
  695. package/dist/text/text.d.ts +1 -1
  696. package/dist/text/text.js +1 -1
  697. package/dist/text/web/ds-text.js +1 -1
  698. package/dist/textarea/native/ds-textarea.d.ts +1 -1
  699. package/dist/textarea/native/ds-textarea.js +9 -8
  700. package/dist/textarea/web/ds-textarea.d.ts +1 -1
  701. package/dist/textarea/web/ds-textarea.js +8 -7
  702. package/dist/time-field/time-field.d.ts +37 -0
  703. package/dist/time-field/time-field.js +23 -0
  704. package/dist/time-field/web/ds-time-field.d.ts +8 -0
  705. package/dist/time-field/web/ds-time-field.js +28 -0
  706. package/dist/time-range/time-range.d.ts +35 -26
  707. package/dist/time-range/time-range.js +28 -46
  708. package/dist/time-range/web/ds-time-range.d.ts +1 -1
  709. package/dist/time-range/web/ds-time-range.js +9 -6
  710. package/dist/timeline/native/ds-timeline.d.ts +2 -2
  711. package/dist/timeline/native/ds-timeline.js +21 -7
  712. package/dist/timeline/timeline.d.ts +2 -1
  713. package/dist/timeline/web/ds-timeline.d.ts +2 -2
  714. package/dist/timeline/web/ds-timeline.js +18 -9
  715. package/dist/toast/native/ds-toast.js +1 -1
  716. package/dist/toggle-group/native/ds-toggle-group.js +1 -1
  717. package/dist/token-roles.d.ts +1 -1
  718. package/dist/token-roles.js +18 -0
  719. package/dist/tone.d.ts +4 -4
  720. package/dist/tone.js +1 -5
  721. package/dist/toolbar/toolbar.d.ts +19 -7
  722. package/dist/toolbar/toolbar.js +4 -3
  723. package/dist/toolbar/web/ds-toolbar.d.ts +5 -2
  724. package/dist/toolbar/web/ds-toolbar.js +3 -3
  725. package/dist/track-bars/track-bars.d.ts +3 -4
  726. package/dist/track-bars/web/ds-track-bars.d.ts +1 -1
  727. package/dist/track-bars/web/ds-track-bars.js +9 -3
  728. package/dist/tree/tree.d.ts +1 -1
  729. package/dist/tree/tree.js +1 -1
  730. package/dist/tree/web/ds-tree.js +2 -2
  731. package/dist/treemap/treemap.d.ts +2 -3
  732. package/dist/treemap/web/ds-treemap.d.ts +1 -1
  733. package/dist/treemap/web/ds-treemap.js +14 -3
  734. package/dist/two-line-cell/two-line-cell.d.ts +5 -2
  735. package/dist/two-line-cell/web/ds-two-line-cell.d.ts +1 -1
  736. package/dist/two-line-cell/web/ds-two-line-cell.js +5 -1
  737. package/dist/vehicle-marker/vehicle-marker.d.ts +5 -4
  738. package/dist/vehicle-marker/vehicle-marker.js +3 -3
  739. package/dist/vehicle-marker/web/ds-vehicle-marker.js +9 -6
  740. package/dist/waterfall-chart/waterfall-chart.d.ts +10 -5
  741. package/dist/waterfall-chart/waterfall-chart.js +17 -12
  742. package/dist/waterfall-chart/web/ds-waterfall-chart.d.ts +7 -2
  743. package/dist/waterfall-chart/web/ds-waterfall-chart.js +49 -11
  744. package/dist/web.d.ts +20 -5
  745. package/dist/web.js +10 -2
  746. package/dist/week-schedule/web/ds-week-schedule.d.ts +1 -1
  747. package/dist/week-schedule/web/ds-week-schedule.js +4 -4
  748. package/dist/week-schedule/week-schedule.d.ts +23 -4
  749. package/dist/week-schedule/week-schedule.js +19 -13
  750. package/forced-colors.css +8 -5
  751. package/package.json +10 -15
@@ -1,13 +1,28 @@
1
1
  import { type ComponentProps } from 'react';
2
2
  import { type BarChartBar, type BarChartContract } from '../bar-chart';
3
- export type DSBarChartProps = Omit<ComponentProps<'div'>, 'role' | 'aria-label' | 'children'> & BarChartContract & {
3
+ type ShareWords = {
4
+ share?: false | undefined;
5
+ noReadingsLabel?: string;
6
+ } | {
7
+ share: true;
8
+ /** What a bar with no readings says in its place, such as "No fills".
9
+ * Required for a share chart. */
10
+ noReadingsLabel: string;
11
+ };
12
+ export type DSBarChartProps = Omit<ComponentProps<'div'>, 'role' | 'aria-label' | 'children' | 'title'> & Omit<BarChartContract, 'share'> & ShareWords & {
4
13
  /** What the chart is OF. Names the figure, or the slider when `scrub` is
5
14
  * on, for a screen reader. */
6
15
  label: string;
16
+ /** A short name drawn above the chart, "Northwind Depot". For small
17
+ * multiples, where three charts side by side are told apart by nothing
18
+ * else; a chart alone in a panel leaves it to the panel's title. */
19
+ title?: string;
7
20
  /** The chart's height in pixels. Vertical bars default to 200; horizontal
8
21
  * ones to 32 per category. */
9
22
  height?: number;
10
- /** Writes each bar's total at its end. */
23
+ /** Writes each bar's total at its end. In a share chart every bar ends at
24
+ * 100 per cent, so it writes each part's percent inside the part instead,
25
+ * where the part has room for it. */
11
26
  valueLabels?: boolean;
12
27
  /** The index of a category to draw at full strength while the rest step
13
28
  * back, today's bar, the depot being discussed. */
@@ -28,11 +43,13 @@ export type DSBarChartProps = Omit<ComponentProps<'div'>, 'role' | 'aria-label'
28
43
  * arrow keys once the plot has focus, shows its figures. */
29
44
  scrub?: boolean;
30
45
  /** How a value is written in labels, the readout and to a screen reader.
31
- * Defaults to the number in the reader's locale. */
46
+ * Defaults to the number in the reader's locale. In a share chart it
47
+ * writes the figure beside each percent ("64%, 8 300 L"). */
32
48
  formatValue?: (value: number) => string;
33
49
  /** Told which bar is being inspected and `undefined` when the reader lets
34
50
  * go. */
35
51
  onScrub?: (bar: BarChartBar | undefined) => void;
36
52
  };
37
53
  /** A quantity per category, drawn as bars from zero, stacked when there are several series. */
38
- export declare function DSBarChart({ categories, series, orientation, hiddenKeys, label, height, valueLabels, highlight, legend, onHiddenKeysChange, emptyLabel, reveal, scrub, formatValue, onScrub, className, ...props }: DSBarChartProps): import("react/jsx-runtime").JSX.Element;
54
+ export declare function DSBarChart({ categories, series, orientation, hiddenKeys, share, max, noReadingsLabel, label, title, height, valueLabels, highlight, legend, onHiddenKeysChange, emptyLabel, reveal, scrub, formatValue, onScrub, loading, loadingLabel, className, ...props }: DSBarChartProps): import("react/jsx-runtime").JSX.Element;
55
+ export {};
@@ -1,14 +1,21 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
2
- import { useEffect, useId, useRef, useState, } from 'react';
3
- import { BAR_CHART_CAP_RADIUS_PX, BAR_CHART_LIFT_PX, BAR_CHART_VIEWBOX, barChartCapKey, barChartCapPath, barChartCapRadii, barChartAxisTicks, barChartGapped, BAR_CHART_EDGE, barChartEdgePath, barChartNarrow, barChartKeyStep, barChartNearest, barChartSpec, barChartStep, } from '../bar-chart';
4
- import { axisGutter } from '../../lib/chart-ticks';
2
+ import { useEffect, useRef, useState, } from 'react';
3
+ import { BAR_CHART_BAND_GAP, BAR_CHART_CAP_RADIUS_PX, BAR_CHART_LIFT_PX, BAR_CHART_MIN_BANDS, BAR_CHART_VIEWBOX, barChartCapKey, barChartCapPath, barChartCapRadii, barChartAxisTicks, barChartGapped, BAR_CHART_EDGE, barChartEdgePath, barChartNarrow, barChartKeyStep, barChartLabelFits, barChartNearest, barChartSpec, barChartStep, } from '../bar-chart';
4
+ import { axisGutter, labelStride } from '../../lib/chart-ticks';
5
+ import { DSButton } from '../../button/web/ds-button';
5
6
  import { DSLegend } from '../../legend/web/ds-legend';
7
+ import { CHART_TABLE_CLASSES as T } from '../../lib/chart-table';
8
+ import { ChartFigures, useChartFigures } from '../../lib/web/chart-figures';
9
+ import { SpokenRegion } from '../../lib/web/spoken-region';
6
10
  import { cn } from '../../lib/cn';
7
11
  import { CHART_ACCENT, CHART_QUIET, CHART_SERIES_BG, CHART_SERIES_FILL, CHART_SERIES_STROKE, chartSeriesSlot, } from '../../lib/chart-series';
8
- import { chartFinishStagger, chartFinishSvgId } from '../../lib/chart-finish';
12
+ import { chartFinishStagger } from '../../lib/chart-finish';
9
13
  import { chartShare } from '../../lib/chart-ticks';
10
- import { CHART_FINISH_ORNAMENT, CHART_FINISH_READOUT, FillSheenGradient, useChartFinishBox, useChartFinishTween, } from '../../lib/web/chart-finish';
14
+ import { CHART_FINISH_READOUT, useChartFinishBox, useChartFinishTween, } from '../../lib/web/chart-finish';
15
+ import { LOADING_ROWS, loadingSpoken } from '../../skeleton/skeleton';
16
+ import { DSSkeleton } from '../../skeleton/web/ds-skeleton';
11
17
  import { DSText } from '../../text/web/ds-text';
18
+ import { formatChartValue } from '../../lib/chart-value';
12
19
  const fillOf = (hue) => CHART_SERIES_FILL[chartSeriesSlot(hue)];
13
20
  const strokeOf = (hue) => CHART_SERIES_STROKE[chartSeriesSlot(hue)];
14
21
  const swatchOf = (hue) => CHART_SERIES_BG[chartSeriesSlot(hue)];
@@ -19,13 +26,35 @@ const LABEL_GUTTER_PX = 72;
19
26
  const TICK_OVERHANG_PX = 24;
20
27
  const TICK_HEADROOM = 'pt-2';
21
28
  const ROW_PX = 32;
22
- export function DSBarChart({ categories, series, orientation = 'vertical', hiddenKeys = [], label, height, valueLabels = false, highlight, legend, onHiddenKeysChange, emptyLabel = 'No data', reveal = false, scrub = false, formatValue = (value) => value.toLocaleString(), onScrub, className, ...props }) {
23
- const spec = barChartSpec({ categories, series, orientation, hiddenKeys });
29
+ const CATEGORY_ROW = 'text-muted-foreground mt-2 flex text-center text-body-xs';
30
+ const NAME_COLUMN = 'text-muted-foreground flex w-32 shrink-0 flex-col text-right text-body-xs';
31
+ const SKELETON_RISE = ['h-3/5', 'h-4/5', 'h-1/2', 'h-3/4', 'h-2/3', 'h-2/5'];
32
+ const SKELETON_RUN = ['w-3/5', 'w-4/5', 'w-1/2', 'w-3/4', 'w-2/3', 'w-2/5'];
33
+ function BarChartSkeleton({ vertical, names, height, endLabels, }) {
34
+ const share = Math.min(1, names.length / BAR_CHART_MIN_BANDS) * (1 - BAR_CHART_BAND_GAP);
35
+ const thickness = { '--bar-skeleton': `${String(share * 100)}%` };
36
+ const headroom = endLabels ? 'pt-5' : TICK_HEADROOM;
37
+ const name = (text, placeholder) => text === undefined ? (_jsx(DSSkeleton, { fits: "body-xs", className: placeholder })) : (_jsx("span", { className: "line-clamp-2 min-w-0 break-words", children: text }));
38
+ if (vertical) {
39
+ return (_jsxs("div", { className: "flex w-full", children: [_jsx("div", { className: cn('flex w-10 shrink-0 flex-col justify-between pr-2', headroom), style: { height }, children: Array.from({ length: 4 }, (_, i) => (_jsx(DSSkeleton, { fits: "body-xs", className: "w-full" }, i))) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: cn('flex w-full', headroom), style: { height }, children: names.map((_, i) => (_jsx("span", { className: "flex h-full min-w-0 flex-1 items-end justify-center", children: _jsx(DSSkeleton, { className: cn('w-(--bar-skeleton) rounded-b-none', SKELETON_RISE[i % SKELETON_RISE.length]), style: thickness }) }, i))) }), _jsx("div", { "aria-hidden": true, className: CATEGORY_ROW, children: names.map((text, i) => (_jsx("span", { className: "flex min-w-0 flex-1 justify-center px-1", children: name(text, 'w-3/4') }, i))) })] })] }));
40
+ }
41
+ return (_jsxs("div", { className: "flex w-full gap-3", children: [_jsx("div", { "aria-hidden": true, className: NAME_COLUMN, style: { height }, children: names.map((text, i) => (_jsx("span", { className: "flex min-h-0 flex-1 items-center justify-end", children: name(text, 'w-20') }, i))) }), _jsxs("div", { className: "min-w-0 flex-1", style: { paddingRight: endLabels ? LABEL_GUTTER_PX : TICK_OVERHANG_PX }, children: [_jsx("div", { className: "flex flex-col", style: { height }, children: names.map((_, i) => (_jsx("span", { className: "flex min-h-0 flex-1 items-center", children: _jsx(DSSkeleton, { className: cn('h-(--bar-skeleton) rounded-s-none', SKELETON_RUN[i % SKELETON_RUN.length]), style: thickness }) }, i))) }), _jsx("div", { className: "flex h-5 justify-between pt-1", children: Array.from({ length: 4 }, (_, i) => (_jsx(DSSkeleton, { fits: "body-xs", className: "w-8" }, i))) })] })] }));
42
+ }
43
+ export function DSBarChart({ categories, series, orientation = 'vertical', hiddenKeys = [], share = false, max, noReadingsLabel, label, title, height, valueLabels = false, highlight, legend, onHiddenKeysChange, emptyLabel = 'No data', reveal = false, scrub = false, formatValue = formatChartValue, onScrub, loading = false, loadingLabel, className, ...props }) {
44
+ const spec = barChartSpec({
45
+ categories,
46
+ series,
47
+ orientation,
48
+ hiddenKeys,
49
+ share,
50
+ ...(max === undefined ? {} : { max }),
51
+ });
52
+ const figures = useChartFigures();
24
53
  const vertical = spec.orientation === 'vertical';
25
54
  const boxHeight = height ?? (vertical ? 200 : Math.max(1, categories.length) * ROW_PX);
26
55
  const plotRef = useRef(null);
27
56
  const [active, setActive] = useState(undefined);
28
- const box = useChartFinishBox(plotRef, !spec.empty);
57
+ const box = useChartFinishBox(plotRef, !spec.empty && !loading);
29
58
  const [capPx, setCapPx] = useState(BAR_CHART_CAP_RADIUS_PX);
30
59
  const [widthPx, setWidthPx] = useState(0);
31
60
  useEffect(() => {
@@ -55,25 +84,36 @@ export function DSBarChart({ categories, series, orientation = 'vertical', hidde
55
84
  };
56
85
  }, [box.width, box.height]);
57
86
  const track = useChartFinishTween(vertical ? 'y' : 'x');
58
- const sheenId = chartFinishSvgId('bar-sheen', useId());
59
87
  function inspect(next) {
60
88
  if (next?.index === active?.index)
61
89
  return;
62
90
  setActive(next);
63
91
  onScrub?.(next);
64
92
  }
93
+ function part(segment) {
94
+ if (segment.value === undefined)
95
+ return 'no data';
96
+ return share && segment.share !== undefined
97
+ ? `${String(segment.share)}%, ${formatValue(segment.value)}`
98
+ : formatValue(segment.value);
99
+ }
100
+ function nothing() {
101
+ return noReadingsLabel ?? '';
102
+ }
65
103
  function total(bar) {
66
104
  if (bar.total === undefined)
67
105
  return 'No data';
106
+ if (bar.noReadings)
107
+ return nothing();
68
108
  return bar.clamped
69
109
  ? `${formatValue(bar.total)}, below zero, drawn at zero`
70
110
  : formatValue(bar.total);
71
111
  }
72
112
  function describe(bar) {
113
+ if (bar.noReadings)
114
+ return `${bar.category}: ${nothing()}`;
73
115
  const parts = bar.segments.length > 1 && !bar.missing
74
- ? ` (${bar.segments
75
- .map((s) => `${s.label} ${s.value === undefined ? 'no data' : formatValue(s.value)}`)
76
- .join(', ')})`
116
+ ? ` (${bar.segments.map((s) => `${s.label} ${part(s)}`).join(', ')})`
77
117
  : '';
78
118
  return `${bar.category}: ${total(bar)}${parts}`;
79
119
  }
@@ -105,7 +145,8 @@ export function DSBarChart({ categories, series, orientation = 'vertical', hidde
105
145
  const scrubbing = scrub && !spec.empty;
106
146
  const reported = active ?? spec.bars.at(0);
107
147
  const emphasis = active?.index ?? highlight;
108
- const multi = spec.bars.some((b) => b.segments.length > 1);
148
+ const multi = share || spec.bars.some((b) => b.segments.length > 1);
149
+ const endLabels = valueLabels && !share;
109
150
  const single = !multi;
110
151
  const thicknessPx = (() => {
111
152
  const bar = spec.bars.at(0);
@@ -125,7 +166,7 @@ export function DSBarChart({ categories, series, orientation = 'vertical', hidde
125
166
  : box.width > 0
126
167
  ? (BAR_CHART_LIFT_PX / box.width) * BAR_CHART_VIEWBOX.width
127
168
  : 0;
128
- const tickText = (tick) => formatValue(tick);
169
+ const tickText = (tick) => (share ? `${String(tick)}%` : formatValue(tick));
129
170
  const shownTicks = barChartAxisTicks(spec.ticks, spec.ticks.map(tickText), spec.orientation, vertical ? box.height : box.width);
130
171
  const axisWidth = axisGutter(spec.ticks.map(tickText));
131
172
  const tickShare = (tick) => spec.max === 0 ? 0 : chartShare(tick, { min: 0, max: spec.max });
@@ -144,9 +185,16 @@ export function DSBarChart({ categories, series, orientation = 'vertical', hidde
144
185
  return bar.end > 60 ? '-translate-x-full -translate-y-1/2 -ml-2' : '-translate-y-1/2 ml-2';
145
186
  };
146
187
  const showLegend = legend ?? spec.series.length >= 2;
147
- const legendNode = showLegend && (_jsx(DSLegend, { label: `${label} series`, items: spec.series.map((s) => ({ key: s.key, label: s.label, series: s.series })), palette: "calm", hiddenKeys: hiddenKeys, ...(onHiddenKeysChange === undefined ? {} : { onHiddenKeysChange }) }));
188
+ const legendItems = spec.series.map((s) => ({ key: s.key, label: s.label, series: s.series }));
189
+ const legendNode = showLegend && (_jsx(DSLegend, { label: `${label} series`, items: legendItems, palette: "calm", hiddenKeys: hiddenKeys, ...(onHiddenKeysChange === undefined ? {} : { onHiddenKeysChange }) }));
190
+ const titleNode = title === undefined || title.trim() === '' ? null : (_jsx(DSText, { as: "span", variant: "label-md", "aria-hidden": true, "data-bar-title": "", className: "truncate text-foreground", children: title }));
191
+ if (loading) {
192
+ const count = categories.length > 0 ? categories.length : vertical ? SKELETON_RISE.length : LOADING_ROWS;
193
+ const names = categories.length > 0 ? categories : Array.from({ length: count }, () => undefined);
194
+ return (_jsxs("div", { className: cn('flex w-full flex-col gap-2', className), ...props, children: [_jsx(SpokenRegion, { text: loadingSpoken(loading, loadingLabel) }), titleNode, _jsxs("div", { "aria-busy": true, className: "flex w-full flex-col gap-2", "data-chart-loading": "", children: [showLegend && (_jsx("div", { className: cn('flex items-center', onHiddenKeysChange === undefined ? 'min-h-6' : 'min-h-8 pointer-coarse:min-h-touch'), children: legendItems.length > 0 ? (_jsx(DSLegend, { label: `${label} series`, items: legendItems, palette: "calm", hiddenKeys: hiddenKeys })) : (_jsxs("div", { className: "flex gap-4", children: [_jsx(DSSkeleton, { fits: "body-xs", className: "w-16" }), _jsx(DSSkeleton, { fits: "body-xs", className: "w-12" })] })) })), _jsx(BarChartSkeleton, { vertical: vertical, names: names, height: vertical ? boxHeight : (height ?? count * ROW_PX), endLabels: valueLabels && !share })] })] }));
195
+ }
148
196
  if (spec.empty) {
149
- return (_jsxs("div", { className: cn('flex w-full flex-col gap-2', className), ...props, children: [legendNode, _jsx("div", { role: "img", "aria-label": `${label}: ${emptyLabel}`, className: "border-border text-muted-foreground flex w-full items-center justify-center rounded-xs border border-dashed", style: { height: boxHeight }, children: _jsx("span", { className: "bg-muted rounded-xs px-3 py-2 text-body-sm", children: emptyLabel }) })] }));
197
+ return (_jsxs("div", { className: cn('flex w-full flex-col gap-2', className), ...props, children: [_jsx(SpokenRegion, { text: loadingSpoken(loading, loadingLabel) }), titleNode, legendNode, _jsx("div", { role: "img", "aria-label": `${label}: ${emptyLabel}`, className: "border-border text-muted-foreground flex w-full items-center justify-center rounded-xs border border-dashed", style: { height: boxHeight }, children: _jsx("span", { className: "bg-muted rounded-xs px-3 py-2 text-body-sm", children: emptyLabel }) })] }));
150
198
  }
151
199
  const plot = (_jsxs("div", { ref: plotRef, className: cn('relative h-full w-full', scrubbing && 'focusable cursor-crosshair touch-pan-y rounded-xs'), ...(scrubbing && reported !== undefined
152
200
  ? {
@@ -172,38 +220,55 @@ export function DSBarChart({ categories, series, orientation = 'vertical', hidde
172
220
  .filter((tick) => tick > 0)
173
221
  .map((tick) => (_jsx("div", { "aria-hidden": true, "data-bar-grid": "", className: cn('bg-border-subtle pointer-events-none absolute', vertical ? 'inset-x-0 h-px' : 'inset-y-0 w-px'), style: vertical
174
222
  ? { top: `${String(100 - tickShare(tick))}%` }
175
- : { left: `${String(tickShare(tick))}%` } }, tick))), _jsx("div", { "aria-hidden": true, className: cn('bg-border pointer-events-none absolute', vertical ? 'inset-x-0 bottom-0 h-px' : 'inset-y-0 left-0 w-px') }), _jsxs("svg", { ...(scrubbing ? { 'aria-hidden': true } : { role: 'img', 'aria-label': label }), width: "100%", height: "100%", className: "absolute inset-0 h-full w-full overflow-visible", viewBox: `0 0 ${String(BAR_CHART_VIEWBOX.width)} ${String(BAR_CHART_VIEWBOX.height)}`, preserveAspectRatio: "none", children: [_jsx("defs", { children: _jsx(FillSheenGradient, { id: sheenId, upright: vertical }) }), spec.bars.map((bar, i) => {
176
- const cap = barChartCapKey(bar);
177
- const lifted = active?.index === bar.index && lift > 0;
178
- const steppedBack = emphasis !== undefined && emphasis !== bar.index;
179
- return (_jsx("g", { ref: track(String(bar.index), bar.end), className: cn('transform-fill', vertical ? 'origin-bottom' : 'origin-left', reveal && (vertical ? 'animate-rise-y' : 'animate-rise-x')), style: {
180
- ...(reveal
181
- ? { animationDelay: `${String(chartFinishStagger(i, spec.bars.length))}ms` }
182
- : {}),
183
- ...(lifted
184
- ? {
185
- transform: vertical
186
- ? `translateY(${String(-lift)}px)`
187
- : `translateX(${String(lift)}px)`,
188
- }
189
- : {}),
190
- }, children: barChartGapped(bar.segments, spec.orientation, box).map((segment) => {
191
- const drawn = barChartNarrow(segment, spec.orientation, widthPx, box);
192
- const d = barChartCapPath(drawn, spec.orientation, segment.key === cap ? rx : 0, segment.key === cap ? ry : 0);
193
- const [fill, edgeInk] = single && emphasis === bar.index
194
- ? [CHART_ACCENT.fill, CHART_ACCENT.stroke]
195
- : single
196
- ? steppedBack || segment.series === 1
197
- ? [SOFT_FILL, CHART_QUIET.stroke]
198
- : [fillOf(segment.series), strokeOf(segment.series)]
199
- : [fillOf(segment.series), strokeOf(segment.series)];
200
- const edge = barChartEdgePath(drawn, spec.orientation, segment.key === cap ? rx : 0, segment.key === cap ? ry : 0, box);
201
- return (_jsxs("g", { children: [_jsx("path", { d: d, "data-stepped-back": steppedBack ? '' : undefined, className: cn(fill, !single && steppedBack && 'opacity-45'), style: { fillOpacity: 'var(--chart-bar-body, 1)' } }), edge !== '' && (_jsx("path", { d: edge, "data-bar-mark": "", "data-forced-colors": "mark", fill: "none", vectorEffect: "non-scaling-stroke", strokeWidth: BAR_CHART_EDGE.weightPx, strokeLinecap: "round", className: edgeInk, style: { strokeOpacity: 'var(--chart-bar-mark, 0)' } })), _jsx("path", { d: d, fill: `url(#${sheenId})`, className: cn(CHART_FINISH_ORNAMENT, !single && steppedBack && 'opacity-45'), style: { fillOpacity: 'calc(1 - var(--chart-bar-mark, 0))' } })] }, segment.key));
202
- }) }, bar.index));
203
- })] }), valueLabels &&
223
+ : { left: `${String(tickShare(tick))}%` } }, tick))), _jsx("div", { "aria-hidden": true, className: cn('bg-border pointer-events-none absolute', vertical ? 'inset-x-0 bottom-0 h-px' : 'inset-y-0 left-0 w-px') }), _jsx("svg", { ...(scrubbing ? { 'aria-hidden': true } : { role: 'img', 'aria-label': label }), width: "100%", height: "100%", className: "absolute inset-0 h-full w-full overflow-visible", viewBox: `0 0 ${String(BAR_CHART_VIEWBOX.width)} ${String(BAR_CHART_VIEWBOX.height)}`, preserveAspectRatio: "none", children: spec.bars.map((bar, i) => {
224
+ const cap = barChartCapKey(bar);
225
+ const lifted = active?.index === bar.index && lift > 0;
226
+ const steppedBack = emphasis !== undefined && emphasis !== bar.index;
227
+ return (_jsx("g", { ref: track(String(bar.index), bar.end), className: cn('transform-fill', vertical ? 'origin-bottom' : 'origin-left', reveal && (vertical ? 'animate-rise-y' : 'animate-rise-x')), style: {
228
+ ...(reveal
229
+ ? { animationDelay: `${String(chartFinishStagger(i, spec.bars.length))}ms` }
230
+ : {}),
231
+ ...(lifted
232
+ ? {
233
+ transform: vertical
234
+ ? `translateY(${String(-lift)}px)`
235
+ : `translateX(${String(lift)}px)`,
236
+ }
237
+ : {}),
238
+ }, children: barChartGapped(bar.segments, spec.orientation, box).map((segment) => {
239
+ const drawn = barChartNarrow(segment, spec.orientation, widthPx, box);
240
+ const d = barChartCapPath(drawn, spec.orientation, segment.key === cap ? rx : 0, segment.key === cap ? ry : 0);
241
+ const [fill, edgeInk] = single && emphasis === bar.index
242
+ ? [CHART_ACCENT.fill, CHART_ACCENT.stroke]
243
+ : single
244
+ ? steppedBack || segment.series === 1
245
+ ? [SOFT_FILL, CHART_QUIET.stroke]
246
+ : [fillOf(segment.series), strokeOf(segment.series)]
247
+ : [fillOf(segment.series), strokeOf(segment.series)];
248
+ const edge = barChartEdgePath(drawn, spec.orientation, segment.key === cap ? rx : 0, segment.key === cap ? ry : 0, box);
249
+ return (_jsxs("g", { children: [_jsx("path", { d: d, "data-stepped-back": steppedBack ? '' : undefined, className: cn(fill, !single && steppedBack && 'opacity-45'), style: { fillOpacity: 'var(--chart-bar-body, 1)' } }), edge !== '' && (_jsx("path", { d: edge, "data-bar-mark": "", "data-forced-colors": "mark", fill: "none", vectorEffect: "non-scaling-stroke", strokeWidth: BAR_CHART_EDGE.weightPx, strokeLinecap: "round", className: edgeInk, style: { strokeOpacity: 'var(--chart-bar-mark, 0)' } }))] }, segment.key));
250
+ }) }, bar.index));
251
+ }) }), endLabels &&
204
252
  spec.bars.map((bar) => bar.missing ? null : (_jsx(DSText, { as: "span", variant: "body-xs", "aria-hidden": true, className: cn('text-muted-foreground pointer-events-none absolute whitespace-nowrap tabular-nums', vertical ? '-translate-x-1/2 -translate-y-full pb-1' : '-translate-y-1/2 pl-1', active?.index === bar.index && 'opacity-0'), style: vertical
205
253
  ? { left: `${String(bar.centre)}%`, top: `${String(100 - bar.end)}%` }
206
- : { left: `${String(bar.end)}%`, top: `${String(bar.centre)}%` }, children: bar.total === undefined ? '' : formatValue(bar.total) }, bar.index))), scrubbing && active !== undefined && (_jsxs("div", { "aria-hidden": true, className: cn(CHART_FINISH_READOUT, 'absolute z-(--layer-raised) flex flex-col gap-1 px-3 py-2 whitespace-nowrap', readoutClass(active)), style: beside(active)
254
+ : { left: `${String(bar.end)}%`, top: `${String(bar.centre)}%` }, children: bar.total === undefined ? '' : formatValue(bar.total) }, bar.index))), share &&
255
+ valueLabels &&
256
+ spec.bars.map((bar) => barChartGapped(bar.segments, spec.orientation, box).map((segment) => {
257
+ const text = segment.share === undefined ? '' : `${String(segment.share)}%`;
258
+ const drawn = barChartNarrow(segment, spec.orientation, widthPx, box);
259
+ if (!barChartLabelFits(drawn, text, box))
260
+ return null;
261
+ return (_jsx(DSText, { as: "span", variant: "body-xs", "aria-hidden": true, "data-bar-part-label": "", className: "bg-card text-card-foreground pointer-events-none absolute -translate-x-1/2 -translate-y-1/2 rounded-xs px-1 whitespace-nowrap tabular-nums", style: {
262
+ left: `${String(drawn.x + drawn.width / 2)}%`,
263
+ top: `${String(drawn.y + drawn.height / 2)}%`,
264
+ }, children: text }, `${String(bar.index)}-${segment.key}`));
265
+ })), share &&
266
+ spec.bars.map((bar) => bar.noReadings ? (_jsx(DSText, { as: "span", variant: "body-xs", "aria-hidden": true, "data-bar-no-readings": "", className: cn('text-muted-foreground pointer-events-none absolute text-center', vertical ? '-translate-x-1/2 bottom-2 px-1' : '-translate-y-1/2 pl-2'), style: vertical
267
+ ? {
268
+ left: `${String(bar.centre)}%`,
269
+ width: `${String(BAR_CHART_VIEWBOX.width / Math.max(1, spec.bars.length))}%`,
270
+ }
271
+ : { left: 0, top: `${String(bar.centre)}%` }, children: nothing() }, `none-${String(bar.index)}`)) : null), scrubbing && active !== undefined && (_jsxs("div", { "aria-hidden": true, className: cn(CHART_FINISH_READOUT, 'absolute z-(--layer-raised) flex flex-col gap-1 px-3 py-2 whitespace-nowrap', readoutClass(active)), style: beside(active)
207
272
  ? {
208
273
  left: `${String(active.centre > BAR_CHART_VIEWBOX.width / 2
209
274
  ? barChartNarrow(active, spec.orientation, widthPx, box).x
@@ -215,11 +280,17 @@ export function DSBarChart({ categories, series, orientation = 'vertical', hidde
215
280
  ? { left: `${String(active.centre)}%`, bottom: `${String(active.end)}%` }
216
281
  : { left: `${String(active.end)}%`, top: `${String(active.centre)}%` }, children: [_jsx(DSText, { as: "span", variant: "label-sm", className: "text-muted-foreground", children: active.category }), _jsx("span", { className: "text-body-sm-strong tabular-nums", children: total(active) }), multi &&
217
282
  !active.missing &&
218
- active.segments.map((segment) => (_jsxs("span", { className: "flex items-center gap-2 text-body-xs tabular-nums", children: [_jsx("span", { "data-forced-colors": "mark", className: cn('size-2 shrink-0 rounded-xxs', swatchOf(segment.series)) }), _jsx("span", { className: "text-muted-foreground", children: segment.label }), _jsx("span", { children: segment.value === undefined ? 'No data' : formatValue(segment.value) })] }, segment.key)))] }))] }));
283
+ !active.noReadings &&
284
+ active.segments.map((segment) => (_jsxs("span", { className: "flex items-center gap-2 text-body-xs tabular-nums", children: [_jsx("span", { "data-forced-colors": "mark", className: cn('size-2 shrink-0 rounded-xxs', swatchOf(segment.series)) }), _jsx("span", { className: "text-muted-foreground", children: segment.label }), _jsx("span", { children: segment.value === undefined ? 'No data' : part(segment) })] }, segment.key)))] }))] }));
219
285
  const axisLabels = (_jsx(_Fragment, { children: shownTicks.map((tick) => (_jsx(DSText, { as: "span", variant: "body-xs", "data-bar-tick": "", className: cn('text-muted-foreground pointer-events-none absolute whitespace-nowrap tabular-nums', vertical
220
286
  ? 'right-0 translate-y-1/2 pr-2'
221
287
  : 'top-0 -translate-x-1/2 pt-1'), style: vertical ? { bottom: `${String(tickShare(tick))}%` } : { left: `${String(tickShare(tick))}%` }, children: tickText(tick) }, tick))) }));
222
- const spoken = !scrubbing && (_jsx("ul", { className: "sr-only", children: spec.bars.map((bar) => (_jsx("li", { children: describe(bar) }, bar.index))) }));
223
- const categoryLabel = (bar) => (_jsx("span", { className: cn('line-clamp-2 min-w-0 break-words', emphasis === bar.index && 'text-foreground font-semibold'), title: bar.category, children: bar.category }, bar.index));
224
- return (_jsxs("div", { className: cn('flex w-full flex-col gap-2', className), ...props, children: [legendNode, vertical ? (_jsxs("div", { className: "flex w-full", children: [_jsx("div", { "aria-hidden": true, className: cn('relative shrink-0', valueLabels ? 'pt-5' : TICK_HEADROOM), style: { height: boxHeight, width: axisWidth }, children: _jsx("div", { className: "relative h-full w-full", children: axisLabels }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: cn('w-full', valueLabels ? 'pt-5' : TICK_HEADROOM), style: { height: boxHeight }, children: plot }), _jsx("div", { "aria-hidden": true, className: "text-muted-foreground mt-2 flex text-center text-body-xs", children: spec.bars.map((bar) => (_jsx("span", { className: "flex min-w-0 flex-1 justify-center px-1", children: categoryLabel(bar) }, bar.index))) })] })] })) : (_jsxs("div", { className: "flex w-full gap-3", children: [_jsx("div", { "aria-hidden": true, className: "text-muted-foreground flex w-32 shrink-0 flex-col text-right text-body-xs", style: { height: boxHeight }, children: spec.bars.map((bar) => (_jsx("span", { className: "flex min-h-0 flex-1 items-center justify-end", children: categoryLabel(bar) }, bar.index))) }), _jsxs("div", { className: "min-w-0 flex-1", style: { paddingRight: valueLabels ? LABEL_GUTTER_PX : TICK_OVERHANG_PX }, children: [_jsx("div", { style: { height: boxHeight }, children: plot }), _jsx("div", { "aria-hidden": true, className: "relative h-5 w-full", children: axisLabels })] })] })), spoken] }));
288
+ const stride = vertical ? labelStride(spec.bars.length, box.width) : 1;
289
+ const categoryLabel = (bar) => (_jsx("span", { className: cn(stride > 1 ? 'whitespace-nowrap' : 'line-clamp-2 min-w-0 break-words', emphasis === bar.index && 'text-foreground font-semibold'), title: bar.category, children: bar.category }, bar.index));
290
+ return (_jsxs("div", { className: cn('flex w-full flex-col gap-2', className), ...props, children: [_jsx(SpokenRegion, { text: loadingSpoken(loading, loadingLabel) }), titleNode, legendNode, vertical ? (_jsxs("div", { className: "flex w-full", children: [_jsx("div", { "aria-hidden": true, className: cn('relative shrink-0', endLabels ? 'pt-5' : TICK_HEADROOM), style: { height: boxHeight, width: axisWidth }, children: _jsx("div", { className: "relative h-full w-full", children: axisLabels }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("div", { className: cn('w-full', endLabels ? 'pt-5' : TICK_HEADROOM), style: { height: boxHeight }, children: plot }), _jsx("div", { "aria-hidden": true, className: CATEGORY_ROW, children: spec.bars.map((bar) => (_jsx("span", { className: "flex min-w-0 flex-1 justify-center px-1", "data-bar-chart-name": "", children: bar.index % stride === 0 && categoryLabel(bar) }, bar.index))) })] })] })) : (_jsxs("div", { className: "flex w-full gap-3", children: [_jsx("div", { "aria-hidden": true, className: NAME_COLUMN, style: { height: boxHeight }, children: spec.bars.map((bar) => (_jsx("span", { className: "flex min-h-0 flex-1 items-center justify-end", children: categoryLabel(bar) }, bar.index))) }), _jsxs("div", { className: "min-w-0 flex-1", style: { paddingRight: endLabels ? LABEL_GUTTER_PX : TICK_OVERHANG_PX }, children: [_jsx("div", { style: { height: boxHeight }, children: plot }), _jsx("div", { "aria-hidden": true, className: "relative h-5 w-full", children: axisLabels })] })] })), _jsx("div", { children: _jsx(DSButton, { variant: "link", quiet: true, labelSize: "sm", ...figures.toggle, children: figures.label }) }), _jsxs(ChartFigures, { figures: figures, caption: label, children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { scope: "col", className: T.columnHead, children: label }), spec.series
291
+ .filter((s) => !s.hidden)
292
+ .map((s) => (_jsx("th", { scope: "col", className: T.figureHead, children: s.label }, s.key)))] }) }), _jsx("tbody", { children: categories.map((category, index) => {
293
+ const bar = spec.bars.find((b) => b.index === index);
294
+ return (_jsxs("tr", { className: T.row, children: [_jsx("th", { scope: "row", className: T.rowHead, children: category }), bar === undefined || bar.missing || bar.noReadings ? (_jsx("td", { colSpan: Math.max(1, spec.series.filter((s) => !s.hidden).length), className: T.figure, children: bar?.noReadings === true ? nothing() : 'No data' })) : (bar.segments.map((segment) => (_jsx("td", { className: T.figure, children: segment.value === undefined ? 'No data' : part(segment) }, segment.key))))] }, index));
295
+ }) })] })] }));
225
296
  }
@@ -43,6 +43,7 @@ export type BottomNavRestIconRole = 'muted-foreground';
43
43
  export type BottomNavCurrentIconRole = 'primary-driver';
44
44
  export type BottomNavIconRole = BottomNavRestIconRole | BottomNavCurrentIconRole;
45
45
  export type BottomNavCurrentWashRole = 'accent';
46
+ /** @deprecated The current item has no edge since the soft pill; nothing sets one. */
46
47
  export type BottomNavCurrentEdgeRole = 'primary';
47
48
  export type BottomNavContainerSurfaceRole = 'card';
48
49
  export type BottomNavContainerBorderRole = 'border';
@@ -50,7 +51,8 @@ export interface BottomNavItemSpec {
50
51
  ink: BottomNavIconRole;
51
52
  /** The circle behind the current item's icon: the selection tint. */
52
53
  wash?: BottomNavCurrentWashRole;
53
- /** The circle's one pixel edge on the current item, in the brand ink. */
54
+ /** @deprecated Never set: the current item is told by the pill and the ink
55
+ * alone. Kept so a caller that reads it still compiles. */
54
56
  edge?: BottomNavCurrentEdgeRole;
55
57
  }
56
58
  export interface BottomNavResolvedSpec {
@@ -116,8 +118,11 @@ export declare const BOTTOM_NAV_ICON_SIZE = 24;
116
118
  * semibold label and at 1.5 it read lighter than its own word. The adapter
117
119
  * sets it once for the whole bar; a caller never sets a stroke. */
118
120
  export declare const BOTTOM_NAV_ICON_STROKE = 1.75;
119
- export declare const BOTTOM_NAV_ICON_ROLES: readonly ["muted-foreground", "primary"];
121
+ /** The icon inks the bar paints: resting, then current. */
122
+ export declare const BOTTOM_NAV_ICON_ROLES: readonly ["muted-foreground", "primary-driver"];
120
123
  export declare const BOTTOM_NAV_CURRENT_WASH_ROLES: readonly ["accent"];
124
+ /** @deprecated The current item has no edge; `bottomNavItemSpec` never sets one. */
121
125
  export declare const BOTTOM_NAV_CURRENT_EDGE_ROLES: readonly ["primary"];
122
- export declare const BOTTOM_NAV_CONTAINER_SURFACE_ROLES: readonly ["background"];
126
+ /** The bar's fill, the card, as `bottomNavSpec` paints it. */
127
+ export declare const BOTTOM_NAV_CONTAINER_SURFACE_ROLES: readonly ["card"];
123
128
  export declare const BOTTOM_NAV_CONTAINER_BORDER_ROLES: readonly ["border"];
@@ -36,11 +36,11 @@ export const BOTTOM_NAV_ICON_SIZE = 24;
36
36
  export const BOTTOM_NAV_ICON_STROKE = 1.75;
37
37
  export const BOTTOM_NAV_ICON_ROLES = [
38
38
  'muted-foreground',
39
- 'primary',
39
+ 'primary-driver',
40
40
  ];
41
41
  export const BOTTOM_NAV_CURRENT_WASH_ROLES = ['accent'];
42
42
  export const BOTTOM_NAV_CURRENT_EDGE_ROLES = ['primary'];
43
43
  export const BOTTOM_NAV_CONTAINER_SURFACE_ROLES = [
44
- 'background',
44
+ 'card',
45
45
  ];
46
46
  export const BOTTOM_NAV_CONTAINER_BORDER_ROLES = ['border'];
@@ -24,8 +24,8 @@ export function DSBottomNav({ state = BOTTOM_NAV_DEFAULT_STATE, items, current,
24
24
  const count = bottomNavCount(item.count);
25
25
  return (_jsxs("button", { type: "button", "aria-label": bottomNavItemName(item), ...(isCurrent ? { 'aria-current': 'page' } : {}), onClick: () => {
26
26
  onCurrentChange(item.key);
27
- }, className: "group flex min-w-0 flex-1 cursor-pointer flex-col items-center justify-center gap-1 pb-1 outline-none", children: [_jsx("span", { className: cn('relative flex h-8 w-14 items-center justify-center rounded-full transition-control', itemSpec.wash === undefined
28
- ? 'group-hover:bg-accent group-active:bg-accent'
27
+ }, className: "group flex min-w-0 flex-auto cursor-pointer flex-col items-center justify-center gap-1 pb-1 outline-none", children: [_jsx("span", { className: cn('relative flex h-8 w-full max-w-14 items-center justify-center rounded-full transition-control', itemSpec.wash === undefined
28
+ ? 'group-hover:bg-foreground/4 group-active:bg-surface-pressed'
29
29
  : WASH[itemSpec.wash], 'group-focus-visible:outline-solid group-focus-visible:outline-2 group-focus-visible:outline-offset-2 group-focus-visible:outline-ring', INK[itemSpec.ink]), children: _jsxs("span", { "aria-hidden": true, className: "relative flex size-10 items-center justify-center", children: [item.icon, count !== undefined && (_jsx(DSCountBadge, { count: count, max: BOTTOM_NAV_COUNT_MAX, overBar: true, className: "absolute top-0 right-0" }))] }) }), _jsx(DSText, { as: "span", variant: "label-sm", "aria-hidden": true, className: cn('max-w-full truncate font-semibold transition-control', INK[itemSpec.ink]), children: item.label })] }, item.key));
30
30
  }) }) }) }));
31
31
  }
@@ -0,0 +1,150 @@
1
+ import { type ChartTicks } from '../lib/chart-ticks';
2
+ import type { Forwarded } from '../props';
3
+ import type { LoadingContract } from '../skeleton/skeleton';
4
+ /** How many boxes beyond the box a reading may sit and still be inside a whisker. */
5
+ export declare const BOX_PLOT_WHISKER_IQR = 1.5;
6
+ /** About how many round steps the value axis has. */
7
+ export declare const BOX_PLOT_TARGET_TICKS = 4;
8
+ /** One reading, optionally named: the vehicle it came from. The name shows in
9
+ * the readout and the table when the reading is an outlier. */
10
+ export interface BoxPlotReading {
11
+ value: number;
12
+ /** What the reading is of: "GP 14 KX". */
13
+ label?: Forwarded<string>;
14
+ }
15
+ /** A reading as the caller may write it: the figure alone, or named. */
16
+ export type BoxPlotReadingInput = number | BoxPlotReading;
17
+ /** The five figures of a box and the outliers beyond its whiskers, done already. */
18
+ export interface BoxPlotFigures {
19
+ /** The low whisker's end: the lowest reading that is not an outlier. */
20
+ min: number;
21
+ q1: number;
22
+ median: number;
23
+ q3: number;
24
+ /** The high whisker's end: the highest reading that is not an outlier. */
25
+ max: number;
26
+ /** The readings beyond the whiskers. */
27
+ outliers?: Forwarded<readonly BoxPlotReadingInput[]>;
28
+ }
29
+ export interface BoxPlotGroup {
30
+ /** The group's name: "Light delivery vans". */
31
+ label: string;
32
+ /** Every reading in the group: the chart works out the box. */
33
+ readings?: Forwarded<readonly BoxPlotReadingInput[]>;
34
+ /** The figures, when the caller has them. Wins over `readings`. */
35
+ figures?: Forwarded<BoxPlotFigures>;
36
+ }
37
+ /** Words for the key under the chart, one for each mark. Required: this package owns no copy. */
38
+ export interface BoxPlotKeyLabels {
39
+ /** The box: "Middle half of vehicles". */
40
+ box: string;
41
+ /** The tick in the box: "Median". */
42
+ median: string;
43
+ /** The thin lines: "Usual range". */
44
+ whiskers: string;
45
+ /** One dot beyond them: "Outlier". */
46
+ outlier: string;
47
+ /** Several: "Outliers". */
48
+ outliers: string;
49
+ }
50
+ /** The table's column words. Required, for the same reason. */
51
+ export interface BoxPlotTableLabels {
52
+ /** The first column: "Vehicle group". */
53
+ group: string;
54
+ min: string;
55
+ q1: string;
56
+ median: string;
57
+ q3: string;
58
+ max: string;
59
+ /** The column listing every outlier: "Outliers". */
60
+ outliers: string;
61
+ }
62
+ export interface BoxPlotContract extends LoadingContract {
63
+ /** What the chart shows: "Fuel use per 100 km, by vehicle group". */
64
+ label: string;
65
+ groups: readonly BoxPlotGroup[];
66
+ keyLabels: BoxPlotKeyLabels;
67
+ tableLabels: BoxPlotTableLabels;
68
+ /** What the chart says when there are no groups. Required, this package owns no copy. */
69
+ emptyLabel: string;
70
+ /** The word for an outlier that needs a look: "Worth a look". Given, the dots take the "needs you" mark and the word is in the key, the readout and the table. */
71
+ flagOutliers?: Forwarded<string>;
72
+ /** A line to hold the groups against: the fleet's target. Drawn dashed, with its name. */
73
+ reference?: Forwarded<number>;
74
+ /** The reference's name beside its line: "Fleet target, 12". Needed when `reference` is set. */
75
+ referenceLabel?: Forwarded<string>;
76
+ /** Writes a row's readout in the caller's language. Defaults to "Median 11.2, middle half 10.1 to 12.6, 2 outliers". */
77
+ formatReadout?: Forwarded<(row: BoxPlotRowReadout) => string>;
78
+ /** Keep the name for a screen reader but do not draw it, when a panel around the chart already shows its title. */
79
+ labelHidden?: Forwarded<boolean>;
80
+ }
81
+ export interface BoxPlotOutlier {
82
+ value: number;
83
+ label: string | undefined;
84
+ /** Place along the axis, 0–100. */
85
+ at: number;
86
+ }
87
+ export interface BoxPlotStats {
88
+ min: number;
89
+ q1: number;
90
+ median: number;
91
+ q3: number;
92
+ max: number;
93
+ }
94
+ export interface BoxPlotRow {
95
+ label: string;
96
+ /** No usable figures: the row keeps its place and says so. */
97
+ missing: boolean;
98
+ stats: BoxPlotStats | undefined;
99
+ /** Where each of the five figures falls along the axis, 0–100. */
100
+ at: BoxPlotStats | undefined;
101
+ /** Ascending by value. */
102
+ outliers: BoxPlotOutlier[];
103
+ }
104
+ export interface BoxPlotResolvedSpec {
105
+ empty: boolean;
106
+ rows: BoxPlotRow[];
107
+ scale: ChartTicks;
108
+ /** The reference line's place along the axis, 0–100, when there is one. */
109
+ referenceAt: number | undefined;
110
+ /** How many outliers there are in all. */
111
+ outlierCount: number;
112
+ }
113
+ /** What a row's readout is told: the figures as numbers and the words. */
114
+ export interface BoxPlotRowReadout {
115
+ group: string;
116
+ stats: BoxPlotStats;
117
+ outliers: readonly {
118
+ value: number;
119
+ label: string | undefined;
120
+ }[];
121
+ /** The flag word, when the caller flags outliers and this group has some. */
122
+ flag: string | undefined;
123
+ }
124
+ /** The value at share `p` (0 to 1) of a list sorted ascending, by linear
125
+ * interpolation between the two readings either side: position `p * (n - 1)`.
126
+ * `p = 0.5` of 1, 2, 3, 4 is 2.5. An empty list has none. */
127
+ export declare function boxPlotQuantile(sorted: readonly number[], p: number): number | undefined;
128
+ export interface BoxPlotSummary extends BoxPlotStats {
129
+ outliers: {
130
+ value: number;
131
+ label: string | undefined;
132
+ }[];
133
+ }
134
+ /** The box, whiskers and outliers of a list of readings: quartiles by linear
135
+ * interpolation, whiskers at the most extreme readings within 1.5 IQR of the
136
+ * box, every reading beyond them an outlier. No finite reading has no summary. */
137
+ export declare function boxPlotSummary(readings: readonly BoxPlotReadingInput[]): BoxPlotSummary | undefined;
138
+ /** The round axis that holds every mark: not forced to zero, snapped outward to a round step. */
139
+ export declare function boxPlotScale(lo: number, hi: number): ChartTicks;
140
+ /** Works out every row's box, whiskers and outliers and the one axis they share. */
141
+ export declare function boxPlotSpec(groups: readonly BoxPlotGroup[], options?: {
142
+ reference?: number | undefined;
143
+ }): BoxPlotResolvedSpec;
144
+ export declare const BOX_PLOT_REFERENCE_NEEDS_A_LABEL = "A box plot with a reference needs referenceLabel, or the dashed line has no name. Pass the words for it: \"Fleet target, 12\".";
145
+ /** True when a reference is drawn and nothing names it. */
146
+ export declare function boxPlotNeedsReferenceLabel(reference: number | undefined, referenceLabel: string | undefined): boolean;
147
+ export declare function boxPlotFlag(flagOutliers: string | undefined): string | undefined;
148
+ /** What one row says: "Median 11.2, middle half 10.1 to 12.6, 2 outliers". Outliers
149
+ * that carry a name are listed after, "GP 14 KX 31.4", and the flag word ends the line. */
150
+ export declare function boxPlotReadout(row: BoxPlotRowReadout, words: Pick<BoxPlotKeyLabels, 'box' | 'median' | 'outlier' | 'outliers'>, format: (value: number) => string): string;