@tfn-design/design-system 0.2.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1161) hide show
  1. package/README.md +4 -4
  2. package/dist/accordion/accordion.d.ts +3 -3
  3. package/dist/accordion/accordion.js +1 -1
  4. package/dist/accordion/web/ds-accordion.d.ts +10 -3
  5. package/dist/accordion/web/ds-accordion.js +35 -5
  6. package/dist/account-password-field/account-password-field.d.ts +4 -4
  7. package/dist/account-password-field/account-password-field.js +1 -1
  8. package/dist/account-password-field/web/ds-account-password-field.d.ts +2 -2
  9. package/dist/account-password-field/web/ds-account-password-field.js +1 -1
  10. package/dist/account-switcher/account-switcher.d.ts +17 -10
  11. package/dist/account-switcher/account-switcher.js +2 -1
  12. package/dist/account-switcher/web/ds-account-switcher.d.ts +5 -5
  13. package/dist/account-switcher/web/ds-account-switcher.js +15 -7
  14. package/dist/action-toast/action-toast.d.ts +12 -12
  15. package/dist/action-toast/web/ds-action-toast.d.ts +5 -5
  16. package/dist/action-toast/web/ds-action-toast.js +9 -4
  17. package/dist/ai-assist-field/ai-assist-field.d.ts +8 -6
  18. package/dist/ai-assist-field/ai-assist-field.js +12 -2
  19. package/dist/ai-assist-field/web/ds-ai-assist-field.d.ts +1 -1
  20. package/dist/ai-assist-field/web/ds-ai-assist-field.js +9 -8
  21. package/dist/ai-attachment/ai-attachment.d.ts +1 -1
  22. package/dist/ai-attachment/ai-attachment.js +1 -1
  23. package/dist/ai-attachment/web/ds-ai-attachment.js +2 -1
  24. package/dist/ai-branch-switcher/ai-branch-switcher.d.ts +3 -0
  25. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.d.ts +1 -1
  26. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.js +8 -5
  27. package/dist/ai-citation/ai-citation.d.ts +8 -8
  28. package/dist/ai-citation/native/ds-ai-citation.js +5 -5
  29. package/dist/ai-citation/web/ds-ai-citation.js +6 -5
  30. package/dist/ai-composer/ai-composer.d.ts +3 -3
  31. package/dist/ai-composer/ai-composer.js +1 -1
  32. package/dist/ai-composer/native/ds-ai-composer.js +7 -4
  33. package/dist/ai-composer/web/ds-ai-composer.d.ts +1 -1
  34. package/dist/ai-composer/web/ds-ai-composer.js +4 -5
  35. package/dist/ai-confirmation/ai-confirmation.d.ts +27 -11
  36. package/dist/ai-confirmation/ai-confirmation.js +18 -3
  37. package/dist/ai-confirmation/native/ds-ai-confirmation.js +19 -14
  38. package/dist/ai-confirmation/web/ds-ai-confirmation.d.ts +2 -2
  39. package/dist/ai-confirmation/web/ds-ai-confirmation.js +24 -12
  40. package/dist/ai-context-scope/ai-context-scope.d.ts +14 -6
  41. package/dist/ai-context-scope/ai-context-scope.js +11 -2
  42. package/dist/ai-context-scope/native/ds-ai-context-scope.d.ts +1 -1
  43. package/dist/ai-context-scope/native/ds-ai-context-scope.js +9 -5
  44. package/dist/ai-context-scope/web/ds-ai-context-scope.d.ts +2 -2
  45. package/dist/ai-context-scope/web/ds-ai-context-scope.js +28 -4
  46. package/dist/ai-conversation-list/ai-conversation-list.d.ts +21 -5
  47. package/dist/ai-conversation-list/ai-conversation-list.js +8 -0
  48. package/dist/ai-conversation-list/web/ds-ai-conversation-list.d.ts +11 -7
  49. package/dist/ai-conversation-list/web/ds-ai-conversation-list.js +92 -49
  50. package/dist/ai-diff/ai-diff.d.ts +15 -3
  51. package/dist/ai-diff/ai-diff.js +12 -1
  52. package/dist/ai-diff/native/ds-ai-diff.d.ts +1 -1
  53. package/dist/ai-diff/native/ds-ai-diff.js +6 -7
  54. package/dist/ai-diff/web/ds-ai-diff.d.ts +0 -4
  55. package/dist/ai-diff/web/ds-ai-diff.js +17 -9
  56. package/dist/ai-draft-panel/ai-draft-panel.d.ts +5 -3
  57. package/dist/ai-draft-panel/ai-draft-panel.js +8 -3
  58. package/dist/ai-draft-panel/web/ds-ai-draft-panel.d.ts +5 -3
  59. package/dist/ai-draft-panel/web/ds-ai-draft-panel.js +5 -4
  60. package/dist/ai-empty-state/native/ds-ai-empty-state.d.ts +1 -1
  61. package/dist/ai-empty-state/native/ds-ai-empty-state.js +4 -3
  62. package/dist/ai-empty-state/web/ds-ai-empty-state.d.ts +1 -1
  63. package/dist/ai-empty-state/web/ds-ai-empty-state.js +4 -1
  64. package/dist/ai-error-state/ai-error-state.d.ts +2 -2
  65. package/dist/ai-error-state/ai-error-state.js +2 -2
  66. package/dist/ai-error-state/native/ds-ai-error-state.d.ts +5 -1
  67. package/dist/ai-error-state/native/ds-ai-error-state.js +4 -2
  68. package/dist/ai-error-state/web/ds-ai-error-state.d.ts +5 -1
  69. package/dist/ai-error-state/web/ds-ai-error-state.js +4 -2
  70. package/dist/ai-feedback/ai-feedback.d.ts +1 -1
  71. package/dist/ai-feedback/ai-feedback.js +1 -1
  72. package/dist/ai-feedback/web/ds-ai-feedback.js +3 -2
  73. package/dist/ai-label/ai-label.d.ts +5 -5
  74. package/dist/ai-label/native/ds-ai-label.js +7 -5
  75. package/dist/ai-label/web/ds-ai-label.js +4 -4
  76. package/dist/ai-message/ai-message.d.ts +4 -4
  77. package/dist/ai-message/ai-message.js +1 -1
  78. package/dist/ai-message/native/ds-ai-message.d.ts +1 -1
  79. package/dist/ai-message/native/ds-ai-message.js +14 -11
  80. package/dist/ai-message/web/ds-ai-message-markdown.js +6 -6
  81. package/dist/ai-message/web/ds-ai-message.d.ts +2 -2
  82. package/dist/ai-message/web/ds-ai-message.js +6 -4
  83. package/dist/ai-message-actions/ai-message-actions.d.ts +2 -2
  84. package/dist/ai-message-actions/ai-message-actions.js +1 -1
  85. package/dist/ai-message-actions/native/ds-ai-message-actions.js +3 -2
  86. package/dist/ai-message-actions/web/ds-ai-message-actions.js +1 -1
  87. package/dist/ai-message-actions/web/use-ai-clipboard.d.ts +1 -1
  88. package/dist/ai-plan/ai-plan.d.ts +5 -5
  89. package/dist/ai-plan/ai-plan.js +1 -1
  90. package/dist/ai-plan/web/ds-ai-plan.js +4 -3
  91. package/dist/ai-reasoning/ai-reasoning.d.ts +1 -1
  92. package/dist/ai-side-nav/ai-side-nav.d.ts +19 -19
  93. package/dist/ai-side-nav/web/ds-ai-side-nav.d.ts +9 -9
  94. package/dist/ai-side-nav/web/ds-ai-side-nav.js +6 -4
  95. package/dist/ai-suggestions/native/ds-ai-suggestions.js +1 -1
  96. package/dist/ai-suggestions/web/ds-ai-suggestions.js +1 -1
  97. package/dist/ai-summary-card/ai-summary-card.d.ts +8 -8
  98. package/dist/ai-summary-card/native/ds-ai-summary-card.d.ts +1 -1
  99. package/dist/ai-summary-card/native/ds-ai-summary-card.js +4 -3
  100. package/dist/ai-summary-card/web/ds-ai-summary-card.d.ts +1 -1
  101. package/dist/ai-summary-card/web/ds-ai-summary-card.js +3 -1
  102. package/dist/ai-thinking/native/ds-ai-thinking.js +3 -2
  103. package/dist/ai-thinking/web/ds-ai-thinking.js +1 -1
  104. package/dist/ai-thread/ai-thread.d.ts +3 -3
  105. package/dist/ai-thread/native/ds-ai-thread-panel.js +2 -1
  106. package/dist/ai-thread/native/ds-ai-thread.d.ts +2 -2
  107. package/dist/ai-thread/native/ds-ai-thread.js +4 -2
  108. package/dist/ai-thread/web/ds-ai-thread.d.ts +2 -2
  109. package/dist/ai-thread/web/ds-ai-thread.js +1 -1
  110. package/dist/ai-tool-call/ai-tool-call.d.ts +7 -7
  111. package/dist/ai-tool-call/ai-tool-call.js +1 -1
  112. package/dist/ai-tool-call/native/ds-ai-tool-call.d.ts +1 -1
  113. package/dist/ai-tool-call/native/ds-ai-tool-call.js +7 -6
  114. package/dist/ai-tool-call/web/ds-ai-tool-call.d.ts +1 -1
  115. package/dist/ai-tool-call/web/ds-ai-tool-call.js +6 -4
  116. package/dist/alert/alert.d.ts +9 -9
  117. package/dist/alert/alert.js +1 -1
  118. package/dist/alert/native/ds-alert.js +13 -15
  119. package/dist/alert/web/ds-alert.js +27 -17
  120. package/dist/ambient-gradient/ambient-gradient.d.ts +12 -12
  121. package/dist/ambient-gradient/native/ambient-gradient-provider.d.ts +1 -1
  122. package/dist/ambient-gradient/native/ds-ambient-gradient.d.ts +1 -1
  123. package/dist/ambient-gradient/web/ds-ambient-gradient.d.ts +1 -1
  124. package/dist/amount/amount.d.ts +26 -26
  125. package/dist/amount/amount.js +7 -5
  126. package/dist/amount/native/ds-amount.js +3 -2
  127. package/dist/amount/web/ds-amount.js +2 -2
  128. package/dist/amount-cell/amount-cell.d.ts +5 -2
  129. package/dist/amount-cell/web/ds-amount-cell.d.ts +1 -1
  130. package/dist/amount-cell/web/ds-amount-cell.js +8 -2
  131. package/dist/amount-entry/amount-entry.d.ts +36 -10
  132. package/dist/amount-entry/amount-entry.js +19 -12
  133. package/dist/amount-entry/native/ds-amount-entry.d.ts +1 -1
  134. package/dist/amount-entry/native/ds-amount-entry.js +7 -5
  135. package/dist/amount-entry/web/ds-amount-entry.d.ts +1 -1
  136. package/dist/amount-entry/web/ds-amount-entry.js +6 -4
  137. package/dist/app-shell/app-shell.d.ts +11 -9
  138. package/dist/app-shell/app-shell.js +1 -1
  139. package/dist/app-shell/web/ds-app-shell.d.ts +24 -6
  140. package/dist/app-shell/web/ds-app-shell.js +28 -4
  141. package/dist/approval-chain/approval-chain.d.ts +18 -14
  142. package/dist/approval-chain/approval-chain.js +4 -4
  143. package/dist/approval-chain/native/ds-approval-chain.d.ts +1 -1
  144. package/dist/approval-chain/native/ds-approval-chain.js +21 -12
  145. package/dist/approval-chain/web/ds-approval-chain.d.ts +8 -2
  146. package/dist/approval-chain/web/ds-approval-chain.js +17 -15
  147. package/dist/auth-shell/auth-shell.d.ts +4 -4
  148. package/dist/auth-shell/web/ds-auth-shell.d.ts +28 -6
  149. package/dist/auth-shell/web/ds-auth-shell.js +30 -2
  150. package/dist/avatar/avatar.d.ts +2 -2
  151. package/dist/avatar/native/ds-avatar.js +3 -2
  152. package/dist/avatar-group/avatar-group.d.ts +3 -3
  153. package/dist/avatar-group/native/ds-avatar-group.js +3 -2
  154. package/dist/avatar-group/web/ds-avatar-group.js +2 -2
  155. package/dist/balance-header/balance-header.d.ts +14 -10
  156. package/dist/balance-header/native/ds-balance-header.d.ts +4 -4
  157. package/dist/balance-header/native/ds-balance-header.js +13 -5
  158. package/dist/balance-header/web/ds-balance-header.d.ts +2 -2
  159. package/dist/balance-header/web/ds-balance-header.js +8 -4
  160. package/dist/bank-logo/bank-logo.d.ts +187 -0
  161. package/dist/bank-logo/bank-logo.js +151 -0
  162. package/dist/bank-logo/native/ds-bank-logo.d.ts +7 -0
  163. package/dist/bank-logo/native/ds-bank-logo.js +43 -0
  164. package/dist/bank-logo/web/ds-bank-logo.d.ts +10 -0
  165. package/dist/bank-logo/web/ds-bank-logo.js +27 -0
  166. package/dist/bar-chart/bar-chart.d.ts +108 -19
  167. package/dist/bar-chart/bar-chart.js +140 -5
  168. package/dist/bar-chart/web/ds-bar-chart.d.ts +26 -8
  169. package/dist/bar-chart/web/ds-bar-chart.js +182 -52
  170. package/dist/bottom-nav/bottom-nav.d.ts +35 -23
  171. package/dist/bottom-nav/bottom-nav.js +3 -2
  172. package/dist/bottom-nav/native/bottom-nav-icon-weight.d.ts +6 -0
  173. package/dist/bottom-nav/native/bottom-nav-icon-weight.js +6 -0
  174. package/dist/bottom-nav/native/ds-bottom-nav.d.ts +8 -8
  175. package/dist/bottom-nav/native/ds-bottom-nav.js +26 -17
  176. package/dist/bottom-nav/web/ds-bottom-nav.d.ts +16 -0
  177. package/dist/bottom-nav/web/ds-bottom-nav.js +31 -0
  178. package/dist/box-plot/box-plot.d.ts +150 -0
  179. package/dist/box-plot/box-plot.js +124 -0
  180. package/dist/box-plot/web/ds-box-plot.d.ts +8 -0
  181. package/dist/box-plot/web/ds-box-plot.js +57 -0
  182. package/dist/brand-lockup/brand-lockup.d.ts +41 -35
  183. package/dist/brand-lockup/brand-lockup.js +1 -1
  184. package/dist/brand-lockup/native/ds-brand-lockup.d.ts +7 -7
  185. package/dist/brand-lockup/native/ds-brand-lockup.js +6 -4
  186. package/dist/brand-lockup/web/ds-brand-lockup.d.ts +8 -8
  187. package/dist/brand-lockup/web/ds-brand-lockup.js +6 -4
  188. package/dist/brand-provider/brand-provider.d.ts +29 -0
  189. package/dist/brand-provider/brand-provider.js +9 -0
  190. package/dist/brand-provider/native/ds-brand-provider.d.ts +11 -0
  191. package/dist/brand-provider/native/ds-brand-provider.js +18 -0
  192. package/dist/brand-provider/web/ds-brand-provider.d.ts +10 -0
  193. package/dist/brand-provider/web/ds-brand-provider.js +20 -0
  194. package/dist/breadcrumbs/breadcrumbs.d.ts +4 -4
  195. package/dist/breadcrumbs/web/ds-breadcrumbs.d.ts +1 -1
  196. package/dist/bulk-action-bar/bulk-action-bar.d.ts +6 -6
  197. package/dist/bulk-action-bar/web/ds-bulk-action-bar.d.ts +4 -4
  198. package/dist/bulk-action-bar/web/ds-bulk-action-bar.js +2 -1
  199. package/dist/bullet-chart/bullet-chart.d.ts +87 -0
  200. package/dist/bullet-chart/bullet-chart.js +61 -0
  201. package/dist/bullet-chart/web/ds-bullet-chart.d.ts +8 -0
  202. package/dist/bullet-chart/web/ds-bullet-chart.js +36 -0
  203. package/dist/button/button.d.ts +37 -37
  204. package/dist/button/button.js +14 -14
  205. package/dist/button/native/ds-button.js +12 -13
  206. package/dist/button/web/ds-button.d.ts +3 -3
  207. package/dist/button/web/ds-button.js +41 -24
  208. package/dist/button-group/button-group.d.ts +2 -2
  209. package/dist/button-group/web/ds-button-group.d.ts +3 -3
  210. package/dist/button-group/web/ds-button-group.js +1 -1
  211. package/dist/calendar/calendar.d.ts +27 -16
  212. package/dist/calendar/calendar.js +4 -3
  213. package/dist/calendar/web/ds-calendar.d.ts +9 -5
  214. package/dist/calendar/web/ds-calendar.js +13 -10
  215. package/dist/card-carousel/card-carousel.d.ts +5 -5
  216. package/dist/card-carousel/native/ds-card-carousel.js +2 -2
  217. package/dist/card-carousel/web/ds-card-carousel.js +4 -2
  218. package/dist/chart/chart.d.ts +298 -102
  219. package/dist/chart/chart.js +482 -133
  220. package/dist/chart/web/ds-chart.d.ts +31 -19
  221. package/dist/chart/web/ds-chart.js +137 -87
  222. package/dist/check-option/check-option.d.ts +9 -11
  223. package/dist/check-option/check-option.js +1 -3
  224. package/dist/check-option/web/ds-check-option.d.ts +10 -5
  225. package/dist/check-option/web/ds-check-option.js +14 -9
  226. package/dist/checkbox/checkbox.d.ts +3 -3
  227. package/dist/checkbox/checkbox.js +2 -2
  228. package/dist/checkbox/native/ds-checkbox.js +1 -1
  229. package/dist/checkbox/web/checkbox-mark.js +1 -1
  230. package/dist/checkbox/web/ds-checkbox.d.ts +2 -2
  231. package/dist/checkbox/web/ds-checkbox.js +19 -12
  232. package/dist/chip/chip-wash.d.ts +5 -5
  233. package/dist/chip/chip.d.ts +16 -16
  234. package/dist/chip/chip.js +5 -3
  235. package/dist/chip/native/ds-chip.d.ts +1 -1
  236. package/dist/chip/native/ds-chip.js +6 -5
  237. package/dist/chip/web/ds-chip.d.ts +2 -2
  238. package/dist/chip/web/ds-chip.js +41 -8
  239. package/dist/code-block/code-block.d.ts +10 -10
  240. package/dist/code-block/web/ds-code-block.js +5 -4
  241. package/dist/code-block/web/use-code-block-clipboard.d.ts +1 -1
  242. package/dist/column-picker/web/ds-column-picker.d.ts +3 -1
  243. package/dist/column-picker/web/ds-column-picker.js +3 -2
  244. package/dist/combobox/combobox.d.ts +26 -12
  245. package/dist/combobox/combobox.js +2 -5
  246. package/dist/combobox/web/ds-combobox.d.ts +2 -2
  247. package/dist/combobox/web/ds-combobox.js +48 -14
  248. package/dist/command-palette/command-palette.d.ts +34 -30
  249. package/dist/command-palette/web/ds-command-palette.d.ts +3 -3
  250. package/dist/command-palette/web/ds-command-palette.js +9 -7
  251. package/dist/comment-thread/comment-thread.d.ts +13 -13
  252. package/dist/comment-thread/comment-thread.js +2 -2
  253. package/dist/comment-thread/native/ds-comment-thread.d.ts +1 -1
  254. package/dist/comment-thread/native/ds-comment-thread.js +22 -19
  255. package/dist/comment-thread/web/ds-comment-thread.d.ts +1 -1
  256. package/dist/comment-thread/web/ds-comment-thread.js +19 -17
  257. package/dist/condition-builder/condition-builder.d.ts +114 -22
  258. package/dist/condition-builder/condition-builder.js +68 -28
  259. package/dist/condition-builder/web/ds-condition-builder.d.ts +4 -2
  260. package/dist/condition-builder/web/ds-condition-builder.js +97 -57
  261. package/dist/context-menu/context-menu.d.ts +4 -4
  262. package/dist/context-menu/web/ds-context-menu.d.ts +1 -1
  263. package/dist/context-menu/web/ds-context-menu.js +2 -2
  264. package/dist/context-switcher/context-switcher.d.ts +10 -1
  265. package/dist/context-switcher/context-switcher.js +5 -2
  266. package/dist/context-switcher/web/ds-context-switcher.d.ts +1 -1
  267. package/dist/context-switcher/web/ds-context-switcher.js +4 -3
  268. package/dist/coordinate-field/coordinate-field.d.ts +56 -15
  269. package/dist/coordinate-field/coordinate-field.js +35 -18
  270. package/dist/coordinate-field/native/ds-coordinate-field.d.ts +2 -2
  271. package/dist/coordinate-field/native/ds-coordinate-field.js +10 -9
  272. package/dist/coordinate-field/web/ds-coordinate-field.d.ts +2 -2
  273. package/dist/coordinate-field/web/ds-coordinate-field.js +10 -9
  274. package/dist/copy-field/copy-field.d.ts +30 -16
  275. package/dist/copy-field/copy-field.js +11 -6
  276. package/dist/copy-field/web/ds-copy-field.d.ts +2 -2
  277. package/dist/copy-field/web/ds-copy-field.js +10 -9
  278. package/dist/copy.d.ts +8 -0
  279. package/dist/copy.js +7 -0
  280. package/dist/count-badge/count-badge.d.ts +9 -9
  281. package/dist/count-badge/native/ds-count-badge.js +3 -2
  282. package/dist/count-badge/web/ds-count-badge.js +4 -4
  283. package/dist/countdown/native/ds-countdown.js +3 -2
  284. package/dist/countdown/web/ds-countdown.js +2 -1
  285. package/dist/dashboard-shell/dashboard-shell.d.ts +6 -4
  286. package/dist/dashboard-shell/web/ds-dashboard-shell.d.ts +4 -4
  287. package/dist/data-table/data-table-license.d.ts +3 -3
  288. package/dist/data-table/data-table-store.d.ts +5 -5
  289. package/dist/data-table/url-state.d.ts +6 -6
  290. package/dist/data-table/web/data-table-parts.d.ts +2 -2
  291. package/dist/data-table/web/data-table-theme.css +420 -70
  292. package/dist/data-table/web/ds-data-table-skeleton-chip.d.ts +2 -2
  293. package/dist/data-table/web/ds-data-table.d.ts +47 -3
  294. package/dist/data-table/web/ds-data-table.js +167 -14
  295. package/dist/date-field/web/ds-date-field.d.ts +2 -2
  296. package/dist/date-field/web/ds-date-field.js +6 -5
  297. package/dist/date-input/date-input.d.ts +71 -15
  298. package/dist/date-input/date-input.js +64 -5
  299. package/dist/date-input/web/ds-date-input.d.ts +2 -2
  300. package/dist/date-input/web/ds-date-input.js +43 -8
  301. package/dist/date-picker/date-picker.d.ts +55 -84
  302. package/dist/date-picker/date-picker.js +27 -61
  303. package/dist/date-picker/web/ds-date-picker.d.ts +24 -11
  304. package/dist/date-picker/web/ds-date-picker.js +47 -15
  305. package/dist/date-range-picker/web/ds-date-range-picker.d.ts +10 -4
  306. package/dist/date-range-picker/web/ds-date-range-picker.js +40 -7
  307. package/dist/day-picker/day-picker.d.ts +9 -3
  308. package/dist/day-picker/day-picker.js +1 -1
  309. package/dist/day-picker/web/ds-day-picker.d.ts +3 -3
  310. package/dist/day-picker/web/ds-day-picker.js +16 -4
  311. package/dist/delta/delta.d.ts +34 -4
  312. package/dist/delta/delta.js +50 -1
  313. package/dist/delta/native/ds-delta.d.ts +5 -2
  314. package/dist/delta/native/ds-delta.js +12 -6
  315. package/dist/delta/web/ds-delta.d.ts +5 -2
  316. package/dist/delta/web/ds-delta.js +9 -5
  317. package/dist/description-list/description-list.d.ts +6 -4
  318. package/dist/description-list/native/ds-description-list.d.ts +4 -4
  319. package/dist/description-list/native/ds-description-list.js +54 -29
  320. package/dist/description-list/web/ds-description-list.d.ts +4 -4
  321. package/dist/description-list/web/ds-description-list.js +40 -15
  322. package/dist/dialog/dialog.d.ts +21 -10
  323. package/dist/dialog/native/ds-dialog.d.ts +1 -1
  324. package/dist/dialog/native/ds-dialog.js +2 -1
  325. package/dist/dialog/web/ds-dialog.d.ts +13 -5
  326. package/dist/dialog/web/ds-dialog.js +11 -11
  327. package/dist/diverging-bar-chart/diverging-bar-chart.d.ts +25 -9
  328. package/dist/diverging-bar-chart/diverging-bar-chart.js +26 -3
  329. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.d.ts +2 -2
  330. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.js +53 -15
  331. package/dist/divider/divider.d.ts +2 -2
  332. package/dist/divider/web/ds-divider.d.ts +1 -1
  333. package/dist/divider/web/ds-divider.js +2 -2
  334. package/dist/donut-chart/donut-chart.d.ts +26 -4
  335. package/dist/donut-chart/donut-chart.js +23 -2
  336. package/dist/donut-chart/web/ds-donut-chart.d.ts +6 -1
  337. package/dist/donut-chart/web/ds-donut-chart.js +50 -23
  338. package/dist/drawer/drawer.d.ts +51 -14
  339. package/dist/drawer/drawer.js +10 -4
  340. package/dist/drawer/native/ds-drawer.d.ts +4 -4
  341. package/dist/drawer/native/ds-drawer.js +20 -9
  342. package/dist/drawer/web/ds-drawer.d.ts +4 -4
  343. package/dist/drawer/web/ds-drawer.js +35 -18
  344. package/dist/dropdown-menu/dropdown-menu.d.ts +26 -21
  345. package/dist/dropdown-menu/dropdown-menu.js +14 -5
  346. package/dist/dropdown-menu/native/ds-dropdown-menu.d.ts +2 -2
  347. package/dist/dropdown-menu/native/ds-dropdown-menu.js +4 -3
  348. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.d.ts +9 -7
  349. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.js +11 -10
  350. package/dist/dropdown-menu/web/ds-dropdown-menu.d.ts +9 -6
  351. package/dist/dropdown-menu/web/ds-dropdown-menu.js +2 -2
  352. package/dist/dumbbell-chart/dumbbell-chart.d.ts +40 -0
  353. package/dist/dumbbell-chart/dumbbell-chart.js +33 -0
  354. package/dist/dumbbell-chart/web/ds-dumbbell-chart.d.ts +16 -0
  355. package/dist/dumbbell-chart/web/ds-dumbbell-chart.js +30 -0
  356. package/dist/editable-row/editable-row.d.ts +12 -3
  357. package/dist/editable-row/editable-row.js +7 -1
  358. package/dist/editable-row/web/ds-editable-row.d.ts +2 -2
  359. package/dist/editable-row/web/ds-editable-row.js +8 -6
  360. package/dist/empty-state/empty-state.d.ts +44 -5
  361. package/dist/empty-state/empty-state.js +22 -1
  362. package/dist/empty-state/native/ds-empty-state.d.ts +3 -3
  363. package/dist/empty-state/native/ds-empty-state.js +1 -1
  364. package/dist/empty-state/web/ds-empty-state.d.ts +26 -15
  365. package/dist/empty-state/web/ds-empty-state.js +16 -10
  366. package/dist/environment-banner/environment-banner.d.ts +10 -10
  367. package/dist/environment-banner/environment-banner.js +1 -1
  368. package/dist/environment-banner/web/ds-environment-banner.d.ts +2 -2
  369. package/dist/environment-banner/web/ds-environment-banner.js +7 -5
  370. package/dist/evaluation-trace/evaluation-trace.d.ts +4 -4
  371. package/dist/evaluation-trace/evaluation-trace.js +1 -1
  372. package/dist/evaluation-trace/web/ds-evaluation-trace.d.ts +1 -1
  373. package/dist/evaluation-trace/web/ds-evaluation-trace.js +8 -7
  374. package/dist/event-row/web/ds-event-row.d.ts +1 -1
  375. package/dist/event-row/web/ds-event-row.js +4 -2
  376. package/dist/facet-button/facet-button.d.ts +12 -4
  377. package/dist/facet-button/facet-button.js +2 -2
  378. package/dist/facet-button/web/ds-facet-button.d.ts +2 -2
  379. package/dist/facet-button/web/ds-facet-button.js +13 -15
  380. package/dist/facet-menu/facet-menu.d.ts +1 -1
  381. package/dist/facet-menu/facet-menu.js +2 -1
  382. package/dist/facet-menu/web/ds-facet-menu-row.d.ts +1 -1
  383. package/dist/facet-menu/web/ds-facet-menu.js +5 -4
  384. package/dist/fact/fact.d.ts +2 -2
  385. package/dist/fact/fact.js +1 -1
  386. package/dist/fact/native/ds-fact.d.ts +4 -1
  387. package/dist/fact/native/ds-fact.js +3 -2
  388. package/dist/field-rules/field-rules.d.ts +9 -9
  389. package/dist/figure/figure.d.ts +1 -1
  390. package/dist/figure/figure.js +1 -1
  391. package/dist/figure/native/ds-figure.js +4 -3
  392. package/dist/file-dropzone/file-dropzone.d.ts +64 -15
  393. package/dist/file-dropzone/file-dropzone.js +38 -20
  394. package/dist/file-dropzone/web/ds-file-dropzone.d.ts +3 -3
  395. package/dist/file-dropzone/web/ds-file-dropzone.js +17 -15
  396. package/dist/file-field/file-field.d.ts +30 -9
  397. package/dist/file-field/file-field.js +18 -8
  398. package/dist/file-field/web/ds-file-field.d.ts +9 -6
  399. package/dist/file-field/web/ds-file-field.js +8 -6
  400. package/dist/file-import/file-import.d.ts +58 -12
  401. package/dist/file-import/file-import.js +31 -12
  402. package/dist/file-import/web/ds-file-import.d.ts +9 -5
  403. package/dist/file-import/web/ds-file-import.js +11 -10
  404. package/dist/file-upload/file-upload.d.ts +74 -25
  405. package/dist/file-upload/file-upload.js +45 -31
  406. package/dist/file-upload/web/ds-file-upload.d.ts +14 -3
  407. package/dist/file-upload/web/ds-file-upload.js +18 -13
  408. package/dist/filter-bar/filter-bar.d.ts +4 -4
  409. package/dist/filter-bar/web/ds-filter-bar.d.ts +2 -2
  410. package/dist/filter-bar/web/ds-filter-bar.js +3 -2
  411. package/dist/filter-button/filter-button.d.ts +10 -9
  412. package/dist/filter-button/filter-button.js +1 -1
  413. package/dist/filter-button/web/ds-filter-button.d.ts +1 -1
  414. package/dist/filter-chip/filter-chip.d.ts +12 -12
  415. package/dist/filter-chip/web/ds-filter-chip.d.ts +1 -1
  416. package/dist/filter-chip/web/ds-filter-chip.js +4 -4
  417. package/dist/filter-popover/filter-popover.d.ts +3 -0
  418. package/dist/filter-popover/web/ds-filter-popover.d.ts +2 -2
  419. package/dist/filter-popover/web/ds-filter-popover.js +11 -5
  420. package/dist/form-field-group/form-field-group.d.ts +13 -8
  421. package/dist/form-field-group/form-field-group.js +2 -0
  422. package/dist/form-field-group/web/ds-form-field-group.js +3 -2
  423. package/dist/form-section/form-section.d.ts +4 -2
  424. package/dist/form-section/form-section.js +1 -1
  425. package/dist/form-section/web/ds-form-section.d.ts +2 -2
  426. package/dist/form-section/web/ds-form-section.js +3 -1
  427. package/dist/freshness-indicator/freshness-indicator.d.ts +4 -1
  428. package/dist/freshness-indicator/freshness-indicator.js +8 -2
  429. package/dist/freshness-indicator/web/ds-freshness-indicator.d.ts +1 -1
  430. package/dist/freshness-indicator/web/ds-freshness-indicator.js +4 -2
  431. package/dist/funnel/funnel.d.ts +6 -5
  432. package/dist/funnel/web/ds-funnel.d.ts +4 -4
  433. package/dist/funnel/web/ds-funnel.js +38 -35
  434. package/dist/gauge/gauge.d.ts +15 -4
  435. package/dist/gauge/gauge.js +20 -2
  436. package/dist/gauge/web/ds-gauge.d.ts +13 -3
  437. package/dist/gauge/web/ds-gauge.js +29 -11
  438. package/dist/geo/geo.d.ts +30 -15
  439. package/dist/geo/geo.js +112 -0
  440. package/dist/geofence-editor/geofence-editor.d.ts +22 -13
  441. package/dist/geofence-editor/geofence-editor.js +32 -7
  442. package/dist/geofence-editor/web/ds-geofence-editor.d.ts +24 -9
  443. package/dist/geofence-editor/web/ds-geofence-editor.js +46 -31
  444. package/dist/glass.d.ts +15 -15
  445. package/dist/glass.js +1 -1
  446. package/dist/gradient-card/gradient-card.d.ts +3 -3
  447. package/dist/gradient-card/web/ds-gradient-card.d.ts +2 -2
  448. package/dist/gradient-card/web/ds-gradient-card.js +1 -1
  449. package/dist/group-header/group-header.d.ts +1 -1
  450. package/dist/group-header/web/ds-group-header.d.ts +2 -2
  451. package/dist/group-header/web/ds-group-header.js +1 -1
  452. package/dist/heading/heading.d.ts +18 -0
  453. package/dist/heading/heading.js +14 -0
  454. package/dist/heading/native/ds-heading.d.ts +5 -0
  455. package/dist/heading/native/ds-heading.js +9 -0
  456. package/dist/heading/web/ds-heading.d.ts +5 -0
  457. package/dist/heading/web/ds-heading.js +10 -0
  458. package/dist/heatmap/heatmap-calendar.d.ts +95 -0
  459. package/dist/heatmap/heatmap-calendar.js +130 -0
  460. package/dist/heatmap/heatmap.d.ts +44 -6
  461. package/dist/heatmap/heatmap.js +63 -3
  462. package/dist/heatmap/web/ds-heatmap-calendar.d.ts +22 -0
  463. package/dist/heatmap/web/ds-heatmap-calendar.js +33 -0
  464. package/dist/heatmap/web/ds-heatmap.d.ts +24 -4
  465. package/dist/heatmap/web/ds-heatmap.js +72 -31
  466. package/dist/helper-text/helper-text.d.ts +13 -13
  467. package/dist/helper-text/helper-text.js +4 -4
  468. package/dist/helper-text/native/ds-helper-text.d.ts +1 -1
  469. package/dist/helper-text/native/ds-helper-text.js +2 -2
  470. package/dist/helper-text/web/ds-helper-text.d.ts +1 -1
  471. package/dist/helper-text/web/ds-helper-text.js +2 -2
  472. package/dist/histogram/histogram.d.ts +67 -0
  473. package/dist/histogram/histogram.js +79 -0
  474. package/dist/histogram/web/ds-histogram.d.ts +10 -0
  475. package/dist/histogram/web/ds-histogram.js +39 -0
  476. package/dist/hover-card/hover-card.d.ts +1 -1
  477. package/dist/hover-card/web/ds-hover-card.d.ts +1 -1
  478. package/dist/hover-card/web/ds-hover-card.js +3 -2
  479. package/dist/icon/icon.d.ts +11 -0
  480. package/dist/icon/icon.js +52 -0
  481. package/dist/icon/native/ds-icon-provider.d.ts +6 -1
  482. package/dist/icon/native/ds-icon-provider.js +4 -2
  483. package/dist/icon/native/icon-direction.d.ts +10 -0
  484. package/dist/icon/native/icon-direction.js +6 -0
  485. package/dist/icon/native/use-icon-size.d.ts +6 -0
  486. package/dist/icon/native/use-icon-size.js +12 -0
  487. package/dist/icon/web/ds-icon-provider.d.ts +3 -1
  488. package/dist/icon/web/ds-icon-provider.js +3 -1
  489. package/dist/icon/web/icon-direction.css +45 -0
  490. package/dist/icon-button/icon-button.d.ts +14 -8
  491. package/dist/icon-button/icon-button.js +1 -1
  492. package/dist/icon-button/native/ds-icon-button.d.ts +1 -1
  493. package/dist/icon-button/native/ds-icon-button.js +4 -3
  494. package/dist/icon-button/web/ds-icon-button.d.ts +2 -2
  495. package/dist/icon-button/web/ds-icon-button.js +11 -8
  496. package/dist/icon-frame/icon-frame.d.ts +25 -11
  497. package/dist/icon-frame/icon-frame.js +6 -2
  498. package/dist/icon-frame/native/ds-icon-frame.d.ts +1 -1
  499. package/dist/icon-frame/native/ds-icon-frame.js +26 -9
  500. package/dist/icon-frame/web/ds-icon-frame.d.ts +2 -2
  501. package/dist/icon-frame/web/ds-icon-frame.js +27 -8
  502. package/dist/icon-toggle-group/web/ds-icon-toggle-group.d.ts +5 -1
  503. package/dist/icon-toggle-group/web/ds-icon-toggle-group.js +2 -2
  504. package/dist/ident/ident.d.ts +6 -4
  505. package/dist/ident/ident.js +5 -0
  506. package/dist/ident/native/ds-ident.d.ts +30 -0
  507. package/dist/ident/native/ds-ident.js +13 -0
  508. package/dist/ident/web/ds-ident.js +1 -1
  509. package/dist/impersonation-banner/impersonation-banner.d.ts +2 -2
  510. package/dist/impersonation-banner/impersonation-banner.js +2 -2
  511. package/dist/impersonation-banner/web/ds-impersonation-banner.d.ts +5 -5
  512. package/dist/impersonation-banner/web/ds-impersonation-banner.js +2 -1
  513. package/dist/index.d.ts +124 -73
  514. package/dist/index.js +69 -44
  515. package/dist/inline-edit/inline-edit.d.ts +39 -9
  516. package/dist/inline-edit/inline-edit.js +19 -7
  517. package/dist/inline-edit/web/ds-inline-edit.d.ts +3 -3
  518. package/dist/inline-edit/web/ds-inline-edit.js +18 -11
  519. package/dist/input/input.d.ts +26 -13
  520. package/dist/input/input.js +18 -14
  521. package/dist/input/native/ds-input.js +3 -4
  522. package/dist/input/web/ds-input.d.ts +9 -3
  523. package/dist/input/web/ds-input.js +21 -16
  524. package/dist/interaction.d.ts +13 -11
  525. package/dist/interaction.js +3 -3
  526. package/dist/json-viewer/json-viewer.d.ts +17 -17
  527. package/dist/json-viewer/web/ds-json-viewer.d.ts +1 -1
  528. package/dist/json-viewer/web/ds-json-viewer.js +4 -3
  529. package/dist/kanban-board/kanban-board.d.ts +13 -13
  530. package/dist/kanban-board/web/ds-kanban-board.d.ts +1 -1
  531. package/dist/kanban-board/web/ds-kanban-board.js +6 -5
  532. package/dist/kbd/kbd.d.ts +6 -6
  533. package/dist/kbd/web/ds-kbd.js +2 -2
  534. package/dist/key-value-editor/key-value-editor.d.ts +72 -13
  535. package/dist/key-value-editor/key-value-editor.js +56 -26
  536. package/dist/key-value-editor/web/ds-key-value-editor.d.ts +2 -2
  537. package/dist/key-value-editor/web/ds-key-value-editor.js +18 -16
  538. package/dist/keypad/keypad.d.ts +25 -15
  539. package/dist/keypad/keypad.js +16 -10
  540. package/dist/keypad/native/ds-keypad.d.ts +1 -1
  541. package/dist/keypad/native/ds-keypad.js +13 -10
  542. package/dist/keypad/web/ds-keypad.d.ts +1 -1
  543. package/dist/keypad/web/ds-keypad.js +6 -5
  544. package/dist/label/label.d.ts +28 -28
  545. package/dist/label/label.js +6 -6
  546. package/dist/label/native/ds-label-group.js +5 -3
  547. package/dist/label/native/ds-label.d.ts +2 -2
  548. package/dist/label/native/ds-label.js +18 -13
  549. package/dist/label/web/ds-label-group.js +4 -3
  550. package/dist/label/web/ds-label.d.ts +2 -2
  551. package/dist/label/web/ds-label.js +17 -13
  552. package/dist/label-picker/label-picker.d.ts +43 -13
  553. package/dist/label-picker/label-picker.js +28 -17
  554. package/dist/label-picker/native/ds-label-picker.d.ts +1 -1
  555. package/dist/label-picker/native/ds-label-picker.js +16 -12
  556. package/dist/label-picker/web/ds-label-picker.d.ts +1 -1
  557. package/dist/label-picker/web/ds-label-picker.js +16 -14
  558. package/dist/labeled-divider/web/ds-labeled-divider.js +2 -1
  559. package/dist/labeled-field/labeled-field.d.ts +23 -8
  560. package/dist/labeled-field/labeled-field.js +7 -5
  561. package/dist/labeled-field/web/ds-labeled-field.d.ts +5 -5
  562. package/dist/labeled-field/web/ds-labeled-field.js +6 -2
  563. package/dist/leaderboard/leaderboard.d.ts +54 -0
  564. package/dist/leaderboard/leaderboard.js +38 -0
  565. package/dist/leaderboard/web/ds-leaderboard.d.ts +14 -0
  566. package/dist/leaderboard/web/ds-leaderboard.js +21 -0
  567. package/dist/legend/legend.d.ts +32 -3
  568. package/dist/legend/legend.js +5 -0
  569. package/dist/legend/web/ds-legend.d.ts +5 -2
  570. package/dist/legend/web/ds-legend.js +42 -26
  571. package/dist/lib/chart-context.d.ts +52 -0
  572. package/dist/lib/chart-context.js +24 -0
  573. package/dist/lib/chart-curve.js +7 -1
  574. package/dist/lib/chart-finish.d.ts +37 -20
  575. package/dist/lib/chart-finish.js +32 -23
  576. package/dist/lib/chart-hue.d.ts +4 -3
  577. package/dist/lib/chart-hue.js +1 -1
  578. package/dist/lib/chart-library.d.ts +2 -2
  579. package/dist/lib/chart-library.js +1 -1
  580. package/dist/lib/chart-palette.d.ts +7 -7
  581. package/dist/lib/chart-series.d.ts +58 -10
  582. package/dist/lib/chart-series.js +44 -4
  583. package/dist/lib/chart-table.d.ts +14 -0
  584. package/dist/lib/chart-table.js +14 -0
  585. package/dist/lib/chart-ticks.d.ts +35 -0
  586. package/dist/lib/chart-ticks.js +44 -0
  587. package/dist/lib/chart-value.d.ts +2 -0
  588. package/dist/lib/chart-value.js +8 -0
  589. package/dist/lib/cn.d.ts +3 -0
  590. package/dist/lib/cn.js +27 -24
  591. package/dist/lib/focus-order.d.ts +2 -2
  592. package/dist/lib/ink-child.d.ts +1 -1
  593. package/dist/lib/native/glass.d.ts +3 -3
  594. package/dist/lib/native/glass.js +1 -1
  595. package/dist/lib/native/text.d.ts +5 -0
  596. package/dist/lib/native/text.js +6 -0
  597. package/dist/lib/native/use-large-text.d.ts +3 -0
  598. package/dist/lib/native/use-large-text.js +9 -0
  599. package/dist/lib/overlay-stack.d.ts +11 -11
  600. package/dist/lib/sets-type.d.ts +1 -0
  601. package/dist/lib/sets-type.js +5 -0
  602. package/dist/lib/time-of-day.d.ts +21 -0
  603. package/dist/lib/time-of-day.js +37 -0
  604. package/dist/lib/use-theme-epoch.d.ts +4 -4
  605. package/dist/lib/use-theme-epoch.native.d.ts +7 -7
  606. package/dist/lib/web/assign-ref.d.ts +4 -0
  607. package/dist/lib/web/assign-ref.js +6 -0
  608. package/dist/lib/web/chart-figures.d.ts +25 -0
  609. package/dist/lib/web/chart-figures.js +25 -0
  610. package/dist/lib/web/chart-finish.d.ts +21 -7
  611. package/dist/lib/web/chart-finish.js +17 -3
  612. package/dist/lib/web/density.d.ts +1 -0
  613. package/dist/lib/web/density.js +12 -5
  614. package/dist/lib/web/focus-habits.js +20 -8
  615. package/dist/lib/web/focus-trap.d.ts +13 -3
  616. package/dist/lib/web/focus-trap.js +4 -1
  617. package/dist/lib/web/live-announcer.d.ts +2 -0
  618. package/dist/lib/web/live-announcer.js +2 -1
  619. package/dist/lib/web/map-glass.js +2 -2
  620. package/dist/lib/web/scroll-lock.d.ts +1 -1
  621. package/dist/lib/web/touch-target.d.ts +4 -4
  622. package/dist/lib/web/touch-target.js +3 -3
  623. package/dist/lib/web/use-anchored-surface.d.ts +6 -6
  624. package/dist/lib/web/use-anchored-surface.js +3 -2
  625. package/dist/lib/web/use-chart-points.d.ts +23 -0
  626. package/dist/lib/web/use-chart-points.js +58 -0
  627. package/dist/lib/web/use-overlay.d.ts +3 -3
  628. package/dist/lib/web/use-overlay.js +7 -1
  629. package/dist/list-page/list-page.d.ts +2 -1
  630. package/dist/list-page/web/ds-list-page.js +1 -5
  631. package/dist/list-row/list-row.d.ts +11 -11
  632. package/dist/list-row/list-row.js +4 -5
  633. package/dist/list-row/native/ds-list-row.js +11 -3
  634. package/dist/list-row/web/ds-list-row-group.d.ts +17 -0
  635. package/dist/list-row/web/ds-list-row-group.js +7 -0
  636. package/dist/list-row/web/ds-list-row.d.ts +15 -3
  637. package/dist/list-row/web/ds-list-row.js +18 -11
  638. package/dist/loading-screen/loading-screen.d.ts +10 -10
  639. package/dist/loading-screen/native/ds-loading-screen.d.ts +1 -1
  640. package/dist/loading-screen/native/ds-loading-screen.js +4 -3
  641. package/dist/loading-screen/web/ds-loading-screen.d.ts +1 -1
  642. package/dist/loading-screen/web/ds-loading-screen.js +3 -3
  643. package/dist/loading-state/loading-state.d.ts +9 -9
  644. package/dist/loading-state/web/ds-loading-state.js +1 -1
  645. package/dist/log-viewer/log-viewer.d.ts +22 -22
  646. package/dist/log-viewer/log-viewer.js +15 -3
  647. package/dist/log-viewer/web/ds-log-viewer.js +18 -8
  648. package/dist/map/map.d.ts +23 -18
  649. package/dist/map/map.js +4 -2
  650. package/dist/map/web/ds-map-fence.d.ts +2 -2
  651. package/dist/map/web/ds-map-fence.js +14 -13
  652. package/dist/map/web/ds-map-popup.d.ts +2 -2
  653. package/dist/map/web/ds-map-popup.js +1 -1
  654. package/dist/map/web/ds-map.d.ts +3 -3
  655. package/dist/map/web/ds-map.js +12 -5
  656. package/dist/map/web/map-provider.d.ts +7 -7
  657. package/dist/map-banner/map-banner.d.ts +4 -4
  658. package/dist/map-banner/map-banner.js +1 -1
  659. package/dist/map-banner/native/ds-map-banner.js +5 -5
  660. package/dist/map-banner/web/ds-map-banner.js +6 -5
  661. package/dist/map-controls/map-controls.d.ts +9 -11
  662. package/dist/map-controls/map-controls.js +5 -5
  663. package/dist/map-controls/native/ds-map-controls.d.ts +1 -1
  664. package/dist/map-controls/native/ds-map-controls.js +5 -4
  665. package/dist/map-controls/web/ds-map-controls.d.ts +1 -1
  666. package/dist/map-controls/web/ds-map-controls.js +4 -4
  667. package/dist/map-draw-toolbar/map-draw-toolbar.d.ts +3 -3
  668. package/dist/map-draw-toolbar/map-draw-toolbar.js +1 -1
  669. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.d.ts +1 -1
  670. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.js +5 -3
  671. package/dist/map-heatmap-layer/map-heatmap-layer.d.ts +25 -8
  672. package/dist/map-heatmap-layer/map-heatmap-layer.js +4 -0
  673. package/dist/map-heatmap-layer/web/ds-map-heatmap-layer.d.ts +19 -7
  674. package/dist/map-heatmap-layer/web/ds-map-heatmap-layer.js +15 -11
  675. package/dist/map-layers/map-layers.d.ts +2 -2
  676. package/dist/map-layers/map-layers.js +2 -2
  677. package/dist/map-layers/native/ds-map-layers.d.ts +5 -3
  678. package/dist/map-layers/native/ds-map-layers.js +8 -7
  679. package/dist/map-layers/web/ds-map-layers.d.ts +2 -2
  680. package/dist/map-layers/web/ds-map-layers.js +9 -8
  681. package/dist/map-list/map-list.d.ts +3 -2
  682. package/dist/map-list/web/ds-map-list.d.ts +1 -1
  683. package/dist/map-list/web/ds-map-list.js +19 -16
  684. package/dist/map-marker/map-marker.d.ts +7 -2
  685. package/dist/map-marker/map-marker.js +6 -0
  686. package/dist/map-marker/web/ds-map-marker.d.ts +13 -4
  687. package/dist/map-marker/web/ds-map-marker.js +21 -10
  688. package/dist/map-search/map-search.d.ts +11 -2
  689. package/dist/map-search/map-search.js +14 -1
  690. package/dist/map-search/native/ds-map-search.d.ts +11 -4
  691. package/dist/map-search/native/ds-map-search.js +33 -20
  692. package/dist/map-search/web/ds-map-search.d.ts +9 -4
  693. package/dist/map-search/web/ds-map-search.js +46 -29
  694. package/dist/map-search-area/map-search-area.d.ts +1 -1
  695. package/dist/map-search-area/map-search-area.js +1 -1
  696. package/dist/map-search-area/native/ds-map-search-area.d.ts +1 -1
  697. package/dist/map-search-area/native/ds-map-search-area.js +3 -2
  698. package/dist/map-search-area/web/ds-map-search-area.d.ts +1 -1
  699. package/dist/map-search-area/web/ds-map-search-area.js +4 -2
  700. package/dist/map-sheet/map-sheet.d.ts +7 -7
  701. package/dist/map-sheet/map-sheet.js +1 -1
  702. package/dist/map-sheet/native/ds-map-sheet.js +3 -3
  703. package/dist/map-sheet/web/ds-map-sheet.d.ts +1 -1
  704. package/dist/map-sheet/web/ds-map-sheet.js +15 -7
  705. package/dist/map-summary/map-summary.d.ts +2 -1
  706. package/dist/map-summary/web/ds-map-summary.d.ts +2 -2
  707. package/dist/map-summary/web/ds-map-summary.js +20 -8
  708. package/dist/measure.d.ts +3 -3
  709. package/dist/mention-input/mention-input.d.ts +36 -15
  710. package/dist/mention-input/mention-input.js +15 -8
  711. package/dist/mention-input/native/ds-mention-input.d.ts +2 -2
  712. package/dist/mention-input/native/ds-mention-input.js +11 -11
  713. package/dist/mention-input/web/ds-mention-input.d.ts +4 -4
  714. package/dist/mention-input/web/ds-mention-input.js +12 -9
  715. package/dist/menu-button/web/ds-menu-button.d.ts +2 -2
  716. package/dist/menu-button/web/ds-menu-button.js +14 -3
  717. package/dist/merchant-avatar/merchant-avatar.d.ts +6 -3
  718. package/dist/merchant-avatar/merchant-avatar.js +8 -0
  719. package/dist/merchant-avatar/native/ds-merchant-avatar.js +10 -9
  720. package/dist/merchant-avatar/web/ds-merchant-avatar.js +8 -8
  721. package/dist/meter/meter.d.ts +13 -6
  722. package/dist/meter/meter.js +7 -1
  723. package/dist/meter/native/ds-meter.d.ts +2 -2
  724. package/dist/meter/native/ds-meter.js +18 -6
  725. package/dist/meter/web/ds-meter.d.ts +8 -2
  726. package/dist/meter/web/ds-meter.js +22 -8
  727. package/dist/metric/metric.d.ts +17 -13
  728. package/dist/metric/native/ds-metric.d.ts +1 -1
  729. package/dist/metric/native/ds-metric.js +31 -19
  730. package/dist/metric/web/ds-metric.d.ts +1 -1
  731. package/dist/metric/web/ds-metric.js +22 -5
  732. package/dist/metric-card/metric-card.d.ts +61 -0
  733. package/dist/metric-card/metric-card.js +18 -0
  734. package/dist/metric-card/web/ds-metric-card.d.ts +24 -0
  735. package/dist/metric-card/web/ds-metric-card.js +19 -0
  736. package/dist/month-picker/month-picker.d.ts +2 -0
  737. package/dist/month-picker/web/ds-month-picker.d.ts +1 -1
  738. package/dist/month-picker/web/ds-month-picker.js +6 -4
  739. package/dist/month-strip/month-strip.d.ts +2 -0
  740. package/dist/month-strip/web/ds-month-strip.d.ts +3 -3
  741. package/dist/month-strip/web/ds-month-strip.js +12 -7
  742. package/dist/morph/morph.d.ts +10 -10
  743. package/dist/morph/native/ds-morph.d.ts +1 -1
  744. package/dist/morph/native/morph-provider.d.ts +2 -2
  745. package/dist/morph/web/ds-morph.d.ts +4 -4
  746. package/dist/motion.d.ts +50 -35
  747. package/dist/motion.js +15 -13
  748. package/dist/multi-select/multi-select.d.ts +47 -17
  749. package/dist/multi-select/multi-select.js +35 -22
  750. package/dist/multi-select/web/ds-multi-select.d.ts +1 -1
  751. package/dist/multi-select/web/ds-multi-select.js +47 -28
  752. package/dist/native.d.ts +18 -0
  753. package/dist/native.js +11 -0
  754. package/dist/notification-list/native/ds-notification-list.d.ts +2 -2
  755. package/dist/notification-list/native/ds-notification-list.js +19 -9
  756. package/dist/notification-list/notification-list.d.ts +6 -5
  757. package/dist/notification-list/web/ds-notification-list.d.ts +2 -2
  758. package/dist/notification-list/web/ds-notification-list.js +16 -9
  759. package/dist/number-field/native/ds-number-field.js +16 -8
  760. package/dist/number-field/number-field.d.ts +7 -7
  761. package/dist/number-field/web/ds-number-field.js +9 -8
  762. package/dist/otp/native/ds-otp-field.d.ts +1 -1
  763. package/dist/otp/native/ds-otp-field.js +11 -23
  764. package/dist/otp/native/ds-otp.js +4 -4
  765. package/dist/otp/otp.d.ts +17 -13
  766. package/dist/otp/web/ds-otp-field.d.ts +2 -2
  767. package/dist/otp/web/ds-otp-field.js +6 -1
  768. package/dist/otp/web/ds-otp.d.ts +1 -1
  769. package/dist/otp/web/ds-otp.js +6 -6
  770. package/dist/overflow-menu/web/ds-overflow-menu.js +14 -3
  771. package/dist/page-head/page-head.d.ts +4 -4
  772. package/dist/page-head/web/ds-page-head.d.ts +5 -3
  773. package/dist/page-head/web/ds-page-head.js +6 -2
  774. package/dist/pagination/web/ds-pagination.js +2 -1
  775. package/dist/panel/native/ds-panel.js +7 -4
  776. package/dist/panel/panel.d.ts +15 -15
  777. package/dist/panel/panel.js +7 -7
  778. package/dist/panel/web/ds-panel.d.ts +9 -5
  779. package/dist/panel/web/ds-panel.js +5 -3
  780. package/dist/password-feedback/password-feedback.d.ts +3 -3
  781. package/dist/password-feedback/web/ds-password-feedback.d.ts +1 -1
  782. package/dist/password-feedback/web/ds-password-feedback.js +5 -5
  783. package/dist/password-input/web/ds-password-input.d.ts +7 -2
  784. package/dist/password-input/web/ds-password-input.js +28 -3
  785. package/dist/password-requirements/password-requirements.d.ts +17 -7
  786. package/dist/password-requirements/password-requirements.js +6 -8
  787. package/dist/password-requirements/web/ds-password-requirements.js +5 -5
  788. package/dist/password-strength/password-strength.d.ts +5 -5
  789. package/dist/password-strength/web/ds-password-strength.d.ts +2 -2
  790. package/dist/password-strength/web/ds-password-strength.js +6 -4
  791. package/dist/payment-card/native/ds-payment-card.d.ts +1 -1
  792. package/dist/payment-card/native/ds-payment-card.js +6 -3
  793. package/dist/payment-card/payment-card.d.ts +2 -2
  794. package/dist/payment-card/web/ds-payment-card.d.ts +1 -1
  795. package/dist/payment-card/web/ds-payment-card.js +3 -2
  796. package/dist/people-cell/people-cell.d.ts +5 -2
  797. package/dist/people-cell/web/ds-people-cell.d.ts +1 -1
  798. package/dist/people-cell/web/ds-people-cell.js +7 -3
  799. package/dist/person-cell/person-cell.d.ts +6 -3
  800. package/dist/person-cell/web/ds-person-cell.d.ts +1 -1
  801. package/dist/person-cell/web/ds-person-cell.js +11 -1
  802. package/dist/phone-field/native/ds-phone-field.d.ts +1 -1
  803. package/dist/phone-field/native/ds-phone-field.js +7 -5
  804. package/dist/phone-field/phone-field.d.ts +48 -12
  805. package/dist/phone-field/phone-field.js +39 -1
  806. package/dist/phone-field/web/ds-phone-field.d.ts +33 -5
  807. package/dist/phone-field/web/ds-phone-field.js +58 -14
  808. package/dist/place-card/native/ds-place-card.d.ts +7 -3
  809. package/dist/place-card/native/ds-place-card.js +44 -25
  810. package/dist/place-card/place-card.d.ts +30 -24
  811. package/dist/place-card/place-card.js +6 -3
  812. package/dist/place-card/web/ds-place-card.d.ts +5 -3
  813. package/dist/place-card/web/ds-place-card.js +54 -32
  814. package/dist/plan-chart/plan-chart.d.ts +67 -0
  815. package/dist/plan-chart/plan-chart.js +42 -0
  816. package/dist/plan-chart/web/ds-plan-chart.d.ts +10 -0
  817. package/dist/plan-chart/web/ds-plan-chart.js +63 -0
  818. package/dist/popover/native/ds-popover.d.ts +1 -1
  819. package/dist/popover/popover.d.ts +9 -5
  820. package/dist/popover/web/ds-popover.d.ts +6 -2
  821. package/dist/popover/web/ds-popover.js +6 -4
  822. package/dist/presence-indicator/native/ds-presence-indicator.js +4 -3
  823. package/dist/presence-indicator/presence-indicator.d.ts +3 -3
  824. package/dist/presence-indicator/web/ds-presence-indicator.js +2 -2
  825. package/dist/price-pin/native/ds-price-pin.js +3 -2
  826. package/dist/price-pin/price-pin.d.ts +7 -7
  827. package/dist/price-pin/web/ds-price-pin.js +2 -2
  828. package/dist/priority-indicator/native/ds-priority-indicator.d.ts +1 -1
  829. package/dist/priority-indicator/native/ds-priority-indicator.js +7 -6
  830. package/dist/priority-indicator/priority-indicator.d.ts +8 -8
  831. package/dist/priority-indicator/priority-indicator.js +3 -3
  832. package/dist/priority-indicator/web/ds-priority-indicator.d.ts +1 -1
  833. package/dist/priority-indicator/web/ds-priority-indicator.js +5 -5
  834. package/dist/profile-card/profile-card.d.ts +3 -2
  835. package/dist/profile-card/web/ds-profile-card.d.ts +3 -3
  836. package/dist/profile-card/web/ds-profile-card.js +20 -5
  837. package/dist/progress-bar/native/ds-progress-bar.d.ts +1 -1
  838. package/dist/progress-bar/native/ds-progress-bar.js +3 -2
  839. package/dist/progress-bar/progress-bar.d.ts +8 -8
  840. package/dist/progress-bar/web/ds-progress-bar.d.ts +1 -1
  841. package/dist/progress-bar/web/ds-progress-bar.js +6 -5
  842. package/dist/progress-cell/progress-cell.d.ts +8 -3
  843. package/dist/progress-cell/progress-cell.js +2 -2
  844. package/dist/progress-cell/web/ds-progress-cell.d.ts +5 -2
  845. package/dist/progress-cell/web/ds-progress-cell.js +9 -2
  846. package/dist/progress-ring/native/ds-progress-ring.js +18 -11
  847. package/dist/progress-ring/progress-ring.d.ts +13 -9
  848. package/dist/progress-ring/progress-ring.js +7 -3
  849. package/dist/progress-ring/web/ds-progress-ring.d.ts +8 -2
  850. package/dist/progress-ring/web/ds-progress-ring.js +23 -11
  851. package/dist/promo-banner/web/ds-promo-banner.js +2 -1
  852. package/dist/proportion-bar/native/ds-proportion-bar.d.ts +2 -2
  853. package/dist/proportion-bar/native/ds-proportion-bar.js +21 -9
  854. package/dist/proportion-bar/proportion-bar.d.ts +13 -6
  855. package/dist/proportion-bar/proportion-bar.js +6 -1
  856. package/dist/proportion-bar/web/ds-proportion-bar.d.ts +1 -1
  857. package/dist/proportion-bar/web/ds-proportion-bar.js +21 -14
  858. package/dist/props.d.ts +2 -2
  859. package/dist/provider-button/provider-button.d.ts +6 -6
  860. package/dist/provider-button/web/ds-provider-button.d.ts +8 -8
  861. package/dist/qr-code/qr-code.d.ts +12 -12
  862. package/dist/qr-code/qr-matrix.d.ts +4 -4
  863. package/dist/qr-code/qr-matrix.js +1 -1
  864. package/dist/quick-actions/native/ds-quick-actions.js +19 -3
  865. package/dist/quick-actions/quick-actions.d.ts +34 -4
  866. package/dist/quick-actions/quick-actions.js +9 -1
  867. package/dist/quick-actions/web/ds-quick-actions.js +24 -7
  868. package/dist/radar-chart/radar-chart.d.ts +37 -12
  869. package/dist/radar-chart/radar-chart.js +41 -10
  870. package/dist/radar-chart/web/ds-radar-chart.d.ts +1 -1
  871. package/dist/radar-chart/web/ds-radar-chart.js +40 -41
  872. package/dist/radial-progress/native/ds-radial-progress.d.ts +6 -2
  873. package/dist/radial-progress/native/ds-radial-progress.js +51 -30
  874. package/dist/radial-progress/radial-progress.d.ts +21 -12
  875. package/dist/radial-progress/radial-progress.js +10 -1
  876. package/dist/radial-progress/web/ds-radial-progress.d.ts +6 -2
  877. package/dist/radial-progress/web/ds-radial-progress.js +41 -25
  878. package/dist/radio/radio.d.ts +15 -15
  879. package/dist/radio/radio.js +4 -4
  880. package/dist/radio/web/ds-radio.d.ts +7 -3
  881. package/dist/radio/web/ds-radio.js +29 -13
  882. package/dist/radio-group/radio-group.d.ts +44 -8
  883. package/dist/radio-group/radio-group.js +5 -0
  884. package/dist/radio-group/web/ds-radio-group.d.ts +3 -3
  885. package/dist/radio-group/web/ds-radio-group.js +7 -2
  886. package/dist/rating-badge/rating-badge.d.ts +8 -2
  887. package/dist/rating-badge/rating-badge.js +9 -1
  888. package/dist/rating-badge/web/ds-rating-badge.d.ts +2 -2
  889. package/dist/rating-badge/web/ds-rating-badge.js +6 -4
  890. package/dist/recipient-select/recipient-select.d.ts +15 -4
  891. package/dist/recipient-select/recipient-select.js +3 -0
  892. package/dist/recipient-select/web/ds-recipient-select.d.ts +2 -2
  893. package/dist/recipient-select/web/ds-recipient-select.js +6 -5
  894. package/dist/record-panel/record-panel.d.ts +18 -3
  895. package/dist/record-panel/web/ds-record-panel.d.ts +48 -13
  896. package/dist/record-panel/web/ds-record-panel.js +33 -16
  897. package/dist/recovery-actions/web/ds-recovery-actions.d.ts +1 -1
  898. package/dist/recovery-shell/web/ds-recovery-shell.js +1 -1
  899. package/dist/relative-time/native/ds-relative-time.js +2 -1
  900. package/dist/relative-time/relative-time.d.ts +4 -4
  901. package/dist/reorder-list/reorder-list.d.ts +5 -2
  902. package/dist/reorder-list/web/ds-reorder-list.d.ts +6 -1
  903. package/dist/reorder-list/web/ds-reorder-list.js +7 -4
  904. package/dist/resend-control/native/ds-resend-control.d.ts +24 -0
  905. package/dist/resend-control/native/ds-resend-control.js +73 -0
  906. package/dist/resend-control/resend-control.d.ts +5 -3
  907. package/dist/resend-control/resend-control.js +2 -0
  908. package/dist/resend-control/web/ds-resend-control.js +3 -3
  909. package/dist/route-fields/route-fields.d.ts +79 -0
  910. package/dist/route-fields/route-fields.js +71 -0
  911. package/dist/route-fields/web/ds-route-fields.d.ts +5 -0
  912. package/dist/route-fields/web/ds-route-fields.js +83 -0
  913. package/dist/route-line/route-line.d.ts +4 -4
  914. package/dist/route-line/web/ds-route-line.js +3 -3
  915. package/dist/route-stops/route-stops.d.ts +1 -1
  916. package/dist/route-stops/web/ds-route-stops.js +6 -3
  917. package/dist/row-actions-cell/web/ds-row-actions-cell.d.ts +4 -2
  918. package/dist/row-actions-cell/web/ds-row-actions-cell.js +2 -2
  919. package/dist/rule-summary/rule-summary.d.ts +8 -8
  920. package/dist/rule-summary/web/ds-rule-summary.d.ts +5 -5
  921. package/dist/rule-summary/web/ds-rule-summary.js +3 -2
  922. package/dist/save-bar/save-bar.d.ts +4 -4
  923. package/dist/save-bar/save-bar.js +2 -2
  924. package/dist/save-bar/web/ds-save-bar.js +3 -2
  925. package/dist/scale.d.ts +19 -19
  926. package/dist/scanner/native/ds-scanner.d.ts +5 -5
  927. package/dist/scanner/native/ds-scanner.js +4 -4
  928. package/dist/scanner/scanner.d.ts +21 -14
  929. package/dist/scanner/scanner.js +14 -9
  930. package/dist/scatter-chart/scatter-chart.d.ts +47 -0
  931. package/dist/scatter-chart/scatter-chart.js +15 -0
  932. package/dist/scatter-chart/web/ds-scatter-chart.d.ts +9 -0
  933. package/dist/scatter-chart/web/ds-scatter-chart.js +43 -0
  934. package/dist/schedule-chart/schedule-chart.d.ts +187 -0
  935. package/dist/schedule-chart/schedule-chart.js +285 -0
  936. package/dist/schedule-chart/web/ds-schedule-chart.d.ts +24 -0
  937. package/dist/schedule-chart/web/ds-schedule-chart.js +143 -0
  938. package/dist/scrim.d.ts +2 -2
  939. package/dist/scrim.js +1 -1
  940. package/dist/search-field/search-field.d.ts +3 -3
  941. package/dist/search-field/web/ds-search-field.d.ts +1 -1
  942. package/dist/search-field/web/ds-search-field.js +25 -6
  943. package/dist/section/native/ds-section.d.ts +5 -0
  944. package/dist/section/native/ds-section.js +9 -0
  945. package/dist/section/section-context.d.ts +1 -0
  946. package/dist/section/section-context.js +2 -0
  947. package/dist/section/section.d.ts +9 -0
  948. package/dist/section/section.js +8 -0
  949. package/dist/section/web/ds-section.d.ts +5 -0
  950. package/dist/section/web/ds-section.js +8 -0
  951. package/dist/section-nav/section-nav.d.ts +7 -7
  952. package/dist/section-nav/web/ds-section-nav.d.ts +2 -2
  953. package/dist/section-nav/web/ds-section-nav.js +2 -2
  954. package/dist/segmented-control/native/ds-segmented-control.d.ts +1 -1
  955. package/dist/segmented-control/native/ds-segmented-control.js +22 -10
  956. package/dist/segmented-control/segmented-control.d.ts +12 -5
  957. package/dist/segmented-control/web/ds-segmented-control.d.ts +1 -1
  958. package/dist/segmented-control/web/ds-segmented-control.js +4 -3
  959. package/dist/select/native/ds-select.d.ts +3 -3
  960. package/dist/select/native/ds-select.js +12 -8
  961. package/dist/select/select.d.ts +19 -14
  962. package/dist/select/web/ds-select-option-labels.d.ts +1 -1
  963. package/dist/select/web/ds-select-option-labels.js +2 -1
  964. package/dist/select/web/ds-select.d.ts +23 -10
  965. package/dist/select/web/ds-select.js +57 -22
  966. package/dist/settings-directory/native/ds-settings-directory.js +4 -2
  967. package/dist/settings-directory/web/ds-settings-directory.js +2 -1
  968. package/dist/settings-row/native/ds-settings-row.d.ts +2 -2
  969. package/dist/settings-row/native/ds-settings-row.js +4 -3
  970. package/dist/settings-row/settings-row.d.ts +3 -3
  971. package/dist/settings-row/web/ds-settings-row-group.d.ts +17 -0
  972. package/dist/settings-row/web/ds-settings-row-group.js +7 -0
  973. package/dist/settings-row/web/ds-settings-row.d.ts +7 -3
  974. package/dist/settings-row/web/ds-settings-row.js +4 -3
  975. package/dist/setup-guide/setup-guide.d.ts +19 -15
  976. package/dist/setup-guide/setup-guide.js +1 -0
  977. package/dist/setup-guide/web/ds-setup-guide.d.ts +5 -2
  978. package/dist/setup-guide/web/ds-setup-guide.js +12 -17
  979. package/dist/sheet/native/ds-sheet.d.ts +2 -2
  980. package/dist/sheet/native/ds-sheet.js +2 -2
  981. package/dist/sheet/sheet.d.ts +15 -15
  982. package/dist/sheet/sheet.js +2 -2
  983. package/dist/sheet/web/ds-sheet.d.ts +3 -3
  984. package/dist/sheet/web/ds-sheet.js +6 -4
  985. package/dist/side-nav/side-nav.d.ts +39 -38
  986. package/dist/side-nav/web/ds-side-nav-collapse.d.ts +4 -1
  987. package/dist/side-nav/web/ds-side-nav-collapse.js +6 -3
  988. package/dist/side-nav/web/ds-side-nav-header.d.ts +1 -1
  989. package/dist/side-nav/web/ds-side-nav-header.js +1 -1
  990. package/dist/side-nav/web/ds-side-nav-menu.d.ts +4 -4
  991. package/dist/side-nav/web/ds-side-nav-notifications.d.ts +3 -3
  992. package/dist/side-nav/web/ds-side-nav-notifications.js +2 -1
  993. package/dist/side-nav/web/ds-side-nav-primary.d.ts +2 -2
  994. package/dist/side-nav/web/ds-side-nav-primary.js +2 -2
  995. package/dist/side-nav/web/ds-side-nav-profile.d.ts +2 -2
  996. package/dist/side-nav/web/ds-side-nav-profile.js +3 -2
  997. package/dist/side-nav/web/ds-side-nav-search.d.ts +1 -1
  998. package/dist/side-nav/web/ds-side-nav-search.js +1 -1
  999. package/dist/side-nav/web/ds-side-nav.d.ts +12 -12
  1000. package/dist/side-nav/web/ds-side-nav.js +10 -9
  1001. package/dist/skeleton/native/ds-skeleton.js +10 -8
  1002. package/dist/skeleton/skeleton.d.ts +45 -25
  1003. package/dist/skeleton/skeleton.js +19 -15
  1004. package/dist/skeleton/web/ds-skeleton.js +44 -20
  1005. package/dist/slider/native/ds-slider.js +4 -3
  1006. package/dist/slider/slider.d.ts +6 -6
  1007. package/dist/slider/web/ds-slider.js +2 -2
  1008. package/dist/small-multiples/small-multiples.d.ts +48 -0
  1009. package/dist/small-multiples/small-multiples.js +41 -0
  1010. package/dist/small-multiples/web/ds-small-multiples.d.ts +10 -0
  1011. package/dist/small-multiples/web/ds-small-multiples.js +27 -0
  1012. package/dist/sparkline/sparkline.d.ts +26 -10
  1013. package/dist/sparkline/sparkline.js +44 -19
  1014. package/dist/sparkline/web/ds-sparkline.d.ts +1 -1
  1015. package/dist/sparkline/web/ds-sparkline.js +4 -5
  1016. package/dist/spinner/spinner.d.ts +3 -3
  1017. package/dist/split-pane/split-pane.d.ts +13 -13
  1018. package/dist/split-pane/web/ds-split-pane.d.ts +2 -2
  1019. package/dist/split-pane/web/ds-split-pane.js +4 -4
  1020. package/dist/stat-tile/native/ds-stat-tile.d.ts +4 -4
  1021. package/dist/stat-tile/native/ds-stat-tile.js +18 -13
  1022. package/dist/stat-tile/stat-tile.d.ts +26 -18
  1023. package/dist/stat-tile/stat-tile.js +5 -4
  1024. package/dist/stat-tile/web/ds-stat-tile.d.ts +8 -3
  1025. package/dist/stat-tile/web/ds-stat-tile.js +10 -6
  1026. package/dist/state-message/state-message.d.ts +1 -1
  1027. package/dist/state-message/state-message.js +7 -1
  1028. package/dist/state-message/web/ds-state-message.d.ts +6 -2
  1029. package/dist/state-message/web/ds-state-message.js +5 -2
  1030. package/dist/status-badge/native/ds-status-badge.js +5 -5
  1031. package/dist/status-badge/status-badge.d.ts +6 -6
  1032. package/dist/status-badge/status-badge.js +1 -1
  1033. package/dist/status-badge/web/ds-status-badge.d.ts +6 -6
  1034. package/dist/status-badge/web/ds-status-badge.js +5 -5
  1035. package/dist/status-cell/status-cell.d.ts +5 -2
  1036. package/dist/status-cell/web/ds-status-cell.d.ts +6 -2
  1037. package/dist/status-cell/web/ds-status-cell.js +9 -3
  1038. package/dist/status-control/status-control.d.ts +11 -9
  1039. package/dist/status-control/status-control.js +1 -1
  1040. package/dist/status-control/web/ds-status-control.d.ts +1 -1
  1041. package/dist/status-control/web/ds-status-control.js +6 -6
  1042. package/dist/status-dot/native/ds-status-dot.d.ts +1 -1
  1043. package/dist/status-dot/native/ds-status-dot.js +5 -3
  1044. package/dist/status-dot/status-dot.d.ts +13 -13
  1045. package/dist/status-dot/status-dot.js +2 -2
  1046. package/dist/status-dot/web/ds-status-dot.d.ts +1 -1
  1047. package/dist/status-dot/web/ds-status-dot.js +6 -4
  1048. package/dist/status-vocabularies.d.ts +2 -2
  1049. package/dist/stepper-form/stepper-form.d.ts +34 -11
  1050. package/dist/stepper-form/stepper-form.js +17 -9
  1051. package/dist/stepper-form/web/ds-stepper-form.d.ts +4 -4
  1052. package/dist/stepper-form/web/ds-stepper-form.js +9 -6
  1053. package/dist/steps/steps.d.ts +20 -7
  1054. package/dist/steps/steps.js +2 -1
  1055. package/dist/steps/web/ds-steps.d.ts +1 -1
  1056. package/dist/steps/web/ds-steps.js +58 -15
  1057. package/dist/stick-chart/stick-chart.d.ts +4 -3
  1058. package/dist/stick-chart/stick-chart.js +2 -1
  1059. package/dist/stick-chart/web/ds-stick-chart.d.ts +3 -3
  1060. package/dist/stick-chart/web/ds-stick-chart.js +29 -12
  1061. package/dist/switch/native/ds-switch.js +1 -1
  1062. package/dist/switch/switch.d.ts +2 -2
  1063. package/dist/switch/web/ds-switch.js +1 -1
  1064. package/dist/system-state/native/ds-system-state.d.ts +29 -0
  1065. package/dist/system-state/native/ds-system-state.js +68 -0
  1066. package/dist/system-state/system-state.d.ts +1 -1
  1067. package/dist/system-state/system-state.js +4 -3
  1068. package/dist/system-state/web/ds-system-state.d.ts +1 -1
  1069. package/dist/system-state/web/ds-system-state.js +3 -2
  1070. package/dist/table-toolbar/web/ds-table-toolbar.d.ts +3 -4
  1071. package/dist/table-toolbar/web/ds-table-toolbar.js +20 -4
  1072. package/dist/tabs/tabs.d.ts +15 -6
  1073. package/dist/tabs/tabs.js +15 -4
  1074. package/dist/tabs/web/ds-tabs.d.ts +1 -1
  1075. package/dist/tabs/web/ds-tabs.js +9 -6
  1076. package/dist/task/web/ds-task-editor.d.ts +3 -3
  1077. package/dist/task/web/ds-task-editor.js +2 -2
  1078. package/dist/task-shell/task-shell.d.ts +31 -18
  1079. package/dist/task-shell/task-shell.js +7 -3
  1080. package/dist/task-shell/web/ds-task-shell.d.ts +28 -13
  1081. package/dist/task-shell/web/ds-task-shell.js +57 -16
  1082. package/dist/text/native/ds-text.d.ts +5 -1
  1083. package/dist/text/native/ds-text.js +12 -10
  1084. package/dist/text/text.d.ts +88 -46
  1085. package/dist/text/text.js +76 -41
  1086. package/dist/text/web/ds-text.d.ts +1 -1
  1087. package/dist/text/web/ds-text.js +16 -10
  1088. package/dist/textarea/native/ds-textarea.d.ts +1 -1
  1089. package/dist/textarea/native/ds-textarea.js +15 -13
  1090. package/dist/textarea/web/ds-textarea.d.ts +1 -1
  1091. package/dist/textarea/web/ds-textarea.js +17 -14
  1092. package/dist/time-field/time-field.d.ts +37 -0
  1093. package/dist/time-field/time-field.js +23 -0
  1094. package/dist/time-field/web/ds-time-field.d.ts +8 -0
  1095. package/dist/time-field/web/ds-time-field.js +28 -0
  1096. package/dist/time-range/time-range.d.ts +40 -27
  1097. package/dist/time-range/time-range.js +28 -46
  1098. package/dist/time-range/web/ds-time-range.d.ts +1 -1
  1099. package/dist/time-range/web/ds-time-range.js +28 -11
  1100. package/dist/timeline/native/ds-timeline.d.ts +3 -3
  1101. package/dist/timeline/native/ds-timeline.js +25 -9
  1102. package/dist/timeline/timeline.d.ts +11 -10
  1103. package/dist/timeline/web/ds-timeline.d.ts +5 -5
  1104. package/dist/timeline/web/ds-timeline.js +19 -9
  1105. package/dist/toast/native/ds-toast.js +1 -1
  1106. package/dist/toast/toast.d.ts +4 -4
  1107. package/dist/toggle-group/native/ds-toggle-group.js +1 -1
  1108. package/dist/toggle-group/toggle-group.d.ts +6 -6
  1109. package/dist/token-roles.d.ts +2 -2
  1110. package/dist/token-roles.js +39 -4
  1111. package/dist/tone.d.ts +13 -13
  1112. package/dist/tone.js +2 -6
  1113. package/dist/toolbar/toolbar.d.ts +21 -9
  1114. package/dist/toolbar/toolbar.js +4 -3
  1115. package/dist/toolbar/web/ds-toolbar.d.ts +6 -3
  1116. package/dist/toolbar/web/ds-toolbar.js +3 -3
  1117. package/dist/tooltip/tooltip.d.ts +11 -11
  1118. package/dist/tooltip/tooltip.js +4 -4
  1119. package/dist/tooltip/web/ds-tooltip.d.ts +4 -4
  1120. package/dist/tooltip/web/ds-tooltip.js +1 -1
  1121. package/dist/track-bars/track-bars.d.ts +48 -0
  1122. package/dist/track-bars/track-bars.js +22 -0
  1123. package/dist/track-bars/web/ds-track-bars.d.ts +8 -0
  1124. package/dist/track-bars/web/ds-track-bars.js +30 -0
  1125. package/dist/trail-line/trail-line.d.ts +12 -12
  1126. package/dist/trail-line/trail-line.js +1 -1
  1127. package/dist/trail-line/web/ds-trail-line.d.ts +2 -2
  1128. package/dist/trail-line/web/ds-trail-line.js +13 -12
  1129. package/dist/tree/tree.d.ts +12 -12
  1130. package/dist/tree/tree.js +1 -1
  1131. package/dist/tree/web/ds-tree.d.ts +1 -1
  1132. package/dist/tree/web/ds-tree.js +7 -6
  1133. package/dist/treemap/treemap.d.ts +39 -0
  1134. package/dist/treemap/treemap.js +74 -0
  1135. package/dist/treemap/web/ds-treemap.d.ts +14 -0
  1136. package/dist/treemap/web/ds-treemap.js +40 -0
  1137. package/dist/trip-replay/trip-replay.d.ts +12 -12
  1138. package/dist/trip-replay/web/ds-trip-replay.d.ts +1 -1
  1139. package/dist/trip-replay/web/ds-trip-replay.js +2 -1
  1140. package/dist/two-line-cell/two-line-cell.d.ts +5 -2
  1141. package/dist/two-line-cell/web/ds-two-line-cell.d.ts +1 -1
  1142. package/dist/two-line-cell/web/ds-two-line-cell.js +6 -2
  1143. package/dist/value-row/native/ds-value-row.js +7 -2
  1144. package/dist/value-row/value-row.d.ts +3 -3
  1145. package/dist/vehicle-marker/vehicle-marker.d.ts +15 -14
  1146. package/dist/vehicle-marker/vehicle-marker.js +3 -3
  1147. package/dist/vehicle-marker/web/ds-vehicle-marker.d.ts +1 -1
  1148. package/dist/vehicle-marker/web/ds-vehicle-marker.js +11 -6
  1149. package/dist/waterfall-chart/waterfall-chart.d.ts +60 -0
  1150. package/dist/waterfall-chart/waterfall-chart.js +49 -0
  1151. package/dist/waterfall-chart/web/ds-waterfall-chart.d.ts +19 -0
  1152. package/dist/waterfall-chart/web/ds-waterfall-chart.js +69 -0
  1153. package/dist/web.d.ts +56 -7
  1154. package/dist/web.js +28 -3
  1155. package/dist/week-schedule/web/ds-week-schedule.d.ts +2 -2
  1156. package/dist/week-schedule/web/ds-week-schedule.js +7 -6
  1157. package/dist/week-schedule/week-schedule.d.ts +27 -8
  1158. package/dist/week-schedule/week-schedule.js +24 -15
  1159. package/forced-colors.css +43 -40
  1160. package/package.json +12 -17
  1161. package/styles.css +2 -2
@@ -1,19 +1,53 @@
1
1
  import { CHART_HUES } from '../lib/chart-hue';
2
2
  import { chartCurveSegments } from '../lib/chart-curve';
3
- export const CHART_KINDS = ['line', 'bar', 'grouped-bar'];
4
- export const CHART_MAX_SERIES = 4;
3
+ import { formatChartValue } from '../lib/chart-value';
4
+ import { CHART_GLYPH_PX, clean, niceStep } from '../lib/chart-ticks';
5
+ export { CHART_AXIS_GAP_PX, CHART_GLYPH_PX, CHART_MIN_LABEL_SPACING_PX, axisGutter, categorySpacing, labelStride, } from '../lib/chart-ticks';
6
+ export const CHART_KINDS = ['line', 'stacked-area'];
7
+ import { CHART_MAX_SERIES } from '../lib/chart-series';
8
+ export { CHART_MAX_SERIES };
5
9
  export const CHART_FILL_PATTERNS = ['solid', 'hatch', 'dots', 'cross'];
6
10
  export const CHART_LINE_DASHES = ['solid', 'dashed', 'dotted', 'dash-dot'];
7
11
  export const CHART_MARKERS = ['circle', 'square', 'triangle', 'diamond'];
8
- const SERIES_SPECS = [
9
- { ink: 'chart-series-1', pattern: 'solid', dash: 'solid', marker: 'circle' },
10
- { ink: 'chart-series-2', pattern: 'hatch', dash: 'dashed', marker: 'square' },
11
- { ink: 'chart-series-3', pattern: 'dots', dash: 'dotted', marker: 'triangle' },
12
- { ink: 'chart-series-4', pattern: 'cross', dash: 'dash-dot', marker: 'diamond' },
12
+ const SERIES_TEXTURES = [
13
+ { pattern: 'solid', dash: 'solid', marker: 'circle' },
14
+ { pattern: 'hatch', dash: 'dashed', marker: 'square' },
15
+ { pattern: 'dots', dash: 'dotted', marker: 'triangle' },
16
+ { pattern: 'cross', dash: 'dash-dot', marker: 'diamond' },
17
+ ];
18
+ export const CHART_TEXTURE_COUNT = SERIES_TEXTURES.length;
19
+ const SERIES_INKS = [
20
+ 'chart-series-1',
21
+ 'chart-series-2',
22
+ 'chart-series-3',
23
+ 'chart-series-4',
24
+ 'chart-series-5',
25
+ 'chart-series-6',
13
26
  ];
14
27
  export function chartSeriesSpec(index) {
15
- const at = ((index % CHART_MAX_SERIES) + CHART_MAX_SERIES) % CHART_MAX_SERIES;
16
- return SERIES_SPECS[at] ?? SERIES_SPECS[0];
28
+ const slots = SERIES_INKS.length;
29
+ const ink = SERIES_INKS[((index % slots) + slots) % slots] ?? SERIES_INKS[0];
30
+ const row = ((index % CHART_TEXTURE_COUNT) + CHART_TEXTURE_COUNT) % CHART_TEXTURE_COUNT;
31
+ return { ink, ...(SERIES_TEXTURES[row] ?? SERIES_TEXTURES[0]) };
32
+ }
33
+ export const CHART_PLAIN_LOOK = {
34
+ pattern: 'solid',
35
+ dash: 'solid',
36
+ marker: 'circle',
37
+ };
38
+ export const CHART_COMPARISON_LOOK = { ink: 'chart-comparison', ...CHART_PLAIN_LOOK };
39
+ export function chartSeriesLooks(series, texture = false) {
40
+ let slot = 0;
41
+ return series.map((s) => {
42
+ if (s.comparison === true)
43
+ return CHART_COMPARISON_LOOK;
44
+ const look = chartSeriesSpec(slot);
45
+ slot += 1;
46
+ return texture ? look : { ink: look.ink, ...CHART_PLAIN_LOOK };
47
+ });
48
+ }
49
+ export function chartDrawsWash(series, area = true) {
50
+ return area && series.filter((s) => s.comparison !== true).length === 1;
17
51
  }
18
52
  export const CHART_DASH_ARRAYS = {
19
53
  solid: undefined,
@@ -21,7 +55,7 @@ export const CHART_DASH_ARRAYS = {
21
55
  dotted: '1 4',
22
56
  'dash-dot': '9 3 1 3',
23
57
  };
24
- const CHART_GRID_ROLE = 'border';
58
+ const CHART_GRID_ROLE = 'border-subtle';
25
59
  const CHART_AXIS_ROLE = 'muted-foreground';
26
60
  export function chartSpec() {
27
61
  return { grid: CHART_GRID_ROLE, axis: CHART_AXIS_ROLE };
@@ -30,30 +64,65 @@ export const CHART_BODY_HEIGHT_STEP = 80;
30
64
  export const CHART_AXIS_BAND_PX = 24;
31
65
  export const CHART_TOP_PAD_PX = 8;
32
66
  export const CHART_RIGHT_PAD_PX = 8;
33
- export const CHART_MIN_LABEL_SPACING_PX = 44;
34
- export const CHART_GLYPH_PX = 8;
35
- export const CHART_AXIS_GAP_PX = 8;
67
+ const REFERENCE_LABEL_GAP_PX = 4;
68
+ const REFERENCE_LABEL_CAP_PX = 10;
69
+ const REFERENCE_LABEL_CLEAR_PX = 6;
70
+ export function chartReferenceLabelPlace(ruleY, label, plotWidth, lines) {
71
+ const width = label.length * CHART_GLYPH_PX;
72
+ const above = ruleY - REFERENCE_LABEL_GAP_PX;
73
+ const below = ruleY + REFERENCE_LABEL_GAP_PX + REFERENCE_LABEL_CAP_PX;
74
+ const places = [
75
+ { x: plotWidth, y: above, anchor: 'end' },
76
+ { x: plotWidth, y: below, anchor: 'end' },
77
+ { x: 0, y: above, anchor: 'start' },
78
+ { x: 0, y: below, anchor: 'start' },
79
+ ];
80
+ const crossed = (place) => {
81
+ const left = (place.anchor === 'end' ? place.x - width : place.x) - REFERENCE_LABEL_CLEAR_PX;
82
+ const right = (place.anchor === 'end' ? place.x : place.x + width) + REFERENCE_LABEL_CLEAR_PX;
83
+ const top = place.y - REFERENCE_LABEL_CAP_PX - REFERENCE_LABEL_CLEAR_PX;
84
+ const bottom = place.y + REFERENCE_LABEL_CLEAR_PX;
85
+ const inside = (p) => p.x >= left && p.x <= right && p.y >= top && p.y <= bottom;
86
+ return lines.some((points) => points.some((p, i) => {
87
+ if (inside(p))
88
+ return true;
89
+ const next = points[i + 1];
90
+ if (next === undefined)
91
+ return false;
92
+ const steps = Math.ceil(Math.hypot(next.x - p.x, next.y - p.y) / CHART_GLYPH_PX);
93
+ for (let k = 1; k < steps; k++) {
94
+ const t = k / steps;
95
+ if (inside({ x: p.x + (next.x - p.x) * t, y: p.y + (next.y - p.y) * t }))
96
+ return true;
97
+ }
98
+ return false;
99
+ }));
100
+ };
101
+ return places.find((place) => !crossed(place)) ?? places[0];
102
+ }
36
103
  export const CHART_CATEGORY_BASELINE_PX = 6;
37
- export const CHART_THIN_BAR_PX = 6;
38
104
  export const CHART_TICK_TARGET = 4;
39
105
  function readings(series) {
40
106
  return series.flatMap((s) => s.values.filter((v) => v !== null && Number.isFinite(v)));
41
107
  }
42
- function niceStep(rough) {
43
- const magnitude = 10 ** Math.floor(Math.log10(rough));
44
- const residual = rough / magnitude;
45
- const nice = residual <= 1 ? 1 : residual <= 2 ? 2 : residual <= 2.5 ? 2.5 : residual <= 5 ? 5 : 10;
46
- return nice * magnitude;
47
- }
48
- function clean(value, step = 1) {
49
- if (Math.abs(value) < Math.abs(step) * 1e-6)
50
- return 0;
51
- return Number(value.toPrecision(12));
108
+ function extent(series) {
109
+ return [
110
+ ...readings(series),
111
+ ...series.flatMap((s) => s.comparison === true || s.band === undefined
112
+ ? []
113
+ : [...s.band.low, ...s.band.high].filter((v) => v !== null && Number.isFinite(v))),
114
+ ];
52
115
  }
53
- export function chartScale(series, target = CHART_TICK_TARGET) {
54
- const values = readings(series);
55
- let lo = Math.min(0, ...values);
56
- let hi = Math.max(0, ...values);
116
+ export function chartScale(series, target = CHART_TICK_TARGET, reach = [], range = {}) {
117
+ const values = [...extent(series), ...reach.filter((v) => Number.isFinite(v))];
118
+ const min = range.min !== undefined && Number.isFinite(range.min) ? range.min : undefined;
119
+ const max = range.max !== undefined && Number.isFinite(range.max) ? range.max : undefined;
120
+ let lo = Math.min(min ?? 0, ...values);
121
+ let hi = Math.max(...(min === undefined ? [0] : []), ...(max === undefined ? [] : [max]), ...values);
122
+ if (!Number.isFinite(lo))
123
+ lo = 0;
124
+ if (!Number.isFinite(hi))
125
+ hi = lo;
57
126
  if (lo === hi) {
58
127
  hi = lo + 1;
59
128
  }
@@ -66,24 +135,20 @@ export function chartScale(series, target = CHART_TICK_TARGET) {
66
135
  ticks.push(clean(lo + i * step, step));
67
136
  return { min: lo, max: hi, step, ticks };
68
137
  }
138
+ export function chartRangeFor(kind, range) {
139
+ if (range === undefined)
140
+ return {};
141
+ return kind === 'line' ? range : range.max === undefined ? {} : { max: range.max };
142
+ }
69
143
  export function valueY(value, scale, height) {
70
144
  const span = scale.max - scale.min;
71
145
  return height - ((value - scale.min) / span) * height;
72
146
  }
73
- const GROUP_SHARE = 0.7;
74
- const BAR_GAP_PX = 2;
75
- export function bandLayout(categoryCount, seriesCount, width) {
147
+ export function bandLayout(categoryCount, width) {
76
148
  const band = width / Math.max(1, categoryCount);
77
- const bars = Math.max(1, seriesCount);
78
- const group = band * GROUP_SHARE;
79
- const gap = bars > 1 ? BAR_GAP_PX : 0;
80
- const barWidth = Math.max(1, (group - gap * (bars - 1)) / bars);
81
- const inset = (band - (barWidth * bars + gap * (bars - 1))) / 2;
82
149
  return {
83
150
  band,
84
- barWidth,
85
151
  centre: (index) => index * band + band / 2,
86
- barX: (index, series) => index * band + inset + series * (barWidth + gap),
87
152
  };
88
153
  }
89
154
  export function chartCategoryAt(x, band, count) {
@@ -102,7 +167,7 @@ export function chartCategoryStep(current, step, count) {
102
167
  return step < 0 ? count - 1 : 0;
103
168
  return Math.min(count - 1, Math.max(0, current + step));
104
169
  }
105
- export function chartSeriesPaths(values, x, y, baseline) {
170
+ export function chartSeriesPaths(values, x, y, baseline, projectFrom) {
106
171
  const runs = [];
107
172
  let run = [];
108
173
  const close = () => {
@@ -117,76 +182,167 @@ export function chartSeriesPaths(values, x, y, baseline) {
117
182
  run.push({ index, point: [round2(x(index)), round2(y(value))] });
118
183
  }
119
184
  close();
185
+ const split = projectFrom !== undefined && Number.isFinite(projectFrom) ? projectFrom : undefined;
120
186
  let line = '';
121
187
  let area = '';
188
+ let projection = '';
189
+ let end;
122
190
  const lone = [];
191
+ const add = (current, d) => `${current}${current === '' ? '' : ' '}${d}`;
192
+ const pointOf = (p) => `${String(p.point[0])},${String(p.point[1])}`;
123
193
  for (const points of runs) {
124
194
  const first = points[0];
125
195
  const last = points.at(-1);
126
196
  if (first === undefined || last === undefined)
127
197
  continue;
198
+ const measured = split === undefined ? points.length : points.filter((p) => p.index < split).length;
199
+ const expected = points.length - measured;
200
+ if (expected > 0)
201
+ end = last.index;
128
202
  if (points.length === 1) {
129
203
  lone.push(first.index);
130
204
  continue;
131
205
  }
132
- const d = `M${String(first.point[0])},${String(first.point[1])} ${chartCurveSegments(points.map((p) => p.point)).join(' ')}`;
133
- line += `${line === '' ? '' : ' '}${d}`;
134
- area += `${area === '' ? '' : ' '}${d} L${String(last.point[0])},${String(baseline)} L${String(first.point[0])},${String(baseline)} Z`;
135
- }
136
- return { line, area, lone };
137
- }
138
- export const CHART_BAR_RADIUS_PX = 6;
139
- export function chartBarRadius(width, length) {
140
- return Math.max(0, Math.min(width / 2, CHART_BAR_RADIUS_PX, length));
141
- }
142
- export function chartBarPath(x, y, width, length, up) {
143
- if (!(width > 0) || !(length > 0))
144
- return '';
145
- const r = round2(chartBarRadius(width, length));
146
- const right = round2(x + width);
147
- const bottom = round2(y + length);
148
- if (up) {
149
- return `M${String(x)},${String(bottom)} V${String(round2(y + r))} Q${String(x)},${String(y)} ${String(round2(x + r))},${String(y)} H${String(round2(right - r))} Q${String(right)},${String(y)} ${String(right)},${String(round2(y + r))} V${String(bottom)} Z`;
206
+ const segments = chartCurveSegments(points.map((p) => p.point));
207
+ if (measured >= 2) {
208
+ const measuredEnd = points[measured - 1] ?? last;
209
+ const d = `M${pointOf(first)} ${segments.slice(0, measured - 1).join(' ')}`;
210
+ line = add(line, d);
211
+ area = add(area, `${d} L${String(measuredEnd.point[0])},${String(baseline)} L${String(first.point[0])},${String(baseline)} Z`);
212
+ }
213
+ if (expected > 0) {
214
+ const from = Math.max(0, measured - 1);
215
+ const start = points[from] ?? first;
216
+ projection = add(projection, `M${pointOf(start)} ${segments.slice(from).join(' ')}`);
217
+ }
150
218
  }
151
- return `M${String(x)},${String(y)} V${String(round2(bottom - r))} Q${String(x)},${String(bottom)} ${String(round2(x + r))},${String(bottom)} H${String(round2(right - r))} Q${String(right)},${String(bottom)} ${String(right)},${String(round2(bottom - r))} V${String(y)} Z`;
152
- }
153
- export function labelStride(categoryCount, plotWidth, minSpacing = CHART_MIN_LABEL_SPACING_PX) {
154
- if (categoryCount <= 0 || plotWidth <= 0)
155
- return 1;
156
- const band = plotWidth / categoryCount;
157
- return Math.max(1, Math.ceil(minSpacing / band));
219
+ return { line, area, lone, projection, end };
158
220
  }
159
- export function categorySpacing(categories) {
160
- const widest = Math.max(0, ...categories.map((category) => category.length));
161
- return Math.max(CHART_MIN_LABEL_SPACING_PX, widest * CHART_GLYPH_PX + 12);
221
+ export function chartBandPath(band, x, y) {
222
+ const runs = [];
223
+ let run = [];
224
+ const close = () => {
225
+ if (run.length > 0)
226
+ runs.push(run);
227
+ run = [];
228
+ };
229
+ const length = Math.max(band.low.length, band.high.length);
230
+ for (let i = 0; i < length; i += 1) {
231
+ const [lo, hi] = [band.low[i] ?? null, band.high[i] ?? null];
232
+ if (lo === null || hi === null) {
233
+ close();
234
+ continue;
235
+ }
236
+ const px = round2(x(i));
237
+ run.push({ high: [px, round2(y(Math.max(lo, hi)))], low: [px, round2(y(Math.min(lo, hi)))] });
238
+ }
239
+ close();
240
+ return runs
241
+ .filter((points) => points.length >= 2)
242
+ .map((points) => {
243
+ const upper = points.map((p) => p.high);
244
+ const lower = points.map((p) => p.low).reverse();
245
+ const start = upper[0];
246
+ const turn = lower[0];
247
+ if (start === undefined || turn === undefined)
248
+ return '';
249
+ return `M${String(start[0])},${String(start[1])} ${chartCurveSegments(upper).join(' ')} L${String(turn[0])},${String(turn[1])} ${chartCurveSegments(lower).join(' ')} Z`;
250
+ })
251
+ .join(' ');
162
252
  }
163
- export function axisGutter(labels) {
164
- const widest = Math.max(1, ...labels.map((label) => label.length));
165
- return widest * CHART_GLYPH_PX + CHART_AXIS_GAP_PX;
253
+ export function cleanBand(categories, band) {
254
+ const at = (values, i) => {
255
+ const value = values[i];
256
+ return value === undefined || value === null || !Number.isFinite(value) ? null : value;
257
+ };
258
+ const low = [];
259
+ const high = [];
260
+ for (let i = 0; i < categories.length; i += 1) {
261
+ const [a, b] = [at(band.low, i), at(band.high, i)];
262
+ if (a === null || b === null) {
263
+ low.push(null);
264
+ high.push(null);
265
+ }
266
+ else {
267
+ low.push(Math.min(a, b));
268
+ high.push(Math.max(a, b));
269
+ }
270
+ }
271
+ return { low, high };
166
272
  }
167
- export function visibleSeries(categories, series) {
168
- return series.slice(0, CHART_MAX_SERIES).map((s) => ({
273
+ export function allSeries(categories, series) {
274
+ return series.map((s) => ({
169
275
  label: s.label,
276
+ ...(s.comparison === true ? { comparison: true } : {}),
170
277
  values: categories.map((_, i) => {
171
278
  const value = s.values[i];
172
279
  return value === undefined || value === null || !Number.isFinite(value) ? null : value;
173
280
  }),
281
+ ...(s.comparison !== true && s.band !== undefined ? { band: cleanBand(categories, s.band) } : {}),
174
282
  }));
175
283
  }
284
+ export function visibleSeries(categories, series) {
285
+ return allSeries(categories, series.slice(0, CHART_MAX_SERIES));
286
+ }
287
+ export function chartSeriesCapNote(count) {
288
+ return count > CHART_MAX_SERIES
289
+ ? `Showing ${String(CHART_MAX_SERIES)} of ${String(count)} series. The table has them all.`
290
+ : '';
291
+ }
176
292
  export function isChartEmpty(categories, series) {
177
293
  return categories.length === 0 || readings(visibleSeries(categories, series)).length === 0;
178
294
  }
295
+ export function chartSeriesCapIssue(count) {
296
+ return `${String(count)} series given and only ${String(CHART_MAX_SERIES)} are drawn. More than six is a table, the rest are in the data table.`;
297
+ }
298
+ export function chartForecastIssues(chart) {
299
+ const issues = [];
300
+ const { kind, categories, series } = chart;
301
+ const banded = series.filter((s) => s.band !== undefined);
302
+ if (banded.some((s) => s.comparison === true)) {
303
+ issues.push('A comparison is read against and has no range. Its band is not drawn.');
304
+ }
305
+ if (banded.some((s) => s.comparison !== true) && kind !== 'line') {
306
+ issues.push('Only a line chart has a band.');
307
+ }
308
+ if (banded.some((s) => s.comparison !== true) && (chart.bandLabel ?? '').trim() === '') {
309
+ issues.push('A series with a band needs bandLabel, or nothing in the legend, readout or table says what the pale range is.');
310
+ }
311
+ for (const s of banded) {
312
+ const { low, high } = s.band ?? { low: [], high: [] };
313
+ if (low.length !== categories.length || high.length !== categories.length) {
314
+ issues.push(`"${s.label}" has a band of ${String(low.length)} lows and ${String(high.length)} highs for ${String(categories.length)} categories.`);
315
+ }
316
+ }
317
+ if (chart.projectFrom !== undefined) {
318
+ if (kind !== 'line')
319
+ issues.push('Only a line chart can project.');
320
+ if (!Number.isInteger(chart.projectFrom) || chart.projectFrom < 1 || chart.projectFrom >= categories.length) {
321
+ issues.push(`projectFrom ${String(chart.projectFrom)} is not a category after the first. Leave it out to draw everything as measured.`);
322
+ }
323
+ if ((chart.projectionLabel ?? '').trim() === '' || (chart.projectionMarkerLabel ?? '').trim() === '') {
324
+ issues.push('A projecting chart needs projectionLabel and projectionMarkerLabel, or the dashes and the marker have no words.');
325
+ }
326
+ }
327
+ if (chart.valueRange?.min !== undefined && kind !== 'line') {
328
+ issues.push('Only a line chart can start its axis away from zero. A stacked area is always drawn from zero.');
329
+ }
330
+ return issues;
331
+ }
179
332
  export function chartIssues(chart) {
180
333
  const issues = [];
181
334
  const { kind, categories, series } = chart;
182
- if (series.length > CHART_MAX_SERIES) {
183
- issues.push(`${String(series.length)} series given and only ${String(CHART_MAX_SERIES)} are drawn. More than four is a table.`);
335
+ issues.push(...chartForecastIssues(chart));
336
+ if (series.length > CHART_MAX_SERIES)
337
+ issues.push(chartSeriesCapIssue(series.length));
338
+ if (kind === 'stacked-area' && series.length < 2) {
339
+ issues.push('A stacked area shows a whole made of parts. Use line for one series.');
184
340
  }
185
- if (kind === 'bar' && series.length > 1) {
186
- issues.push('A bar chart takes one series. Use grouped-bar to compare several.');
341
+ if (kind === 'stacked-area' && series.some((s) => s.comparison === true)) {
342
+ issues.push('A stacked area stacks parts, and a comparison is not one. Use line to read against it.');
187
343
  }
188
- if (kind === 'grouped-bar' && series.length < 2) {
189
- issues.push('A grouped bar chart compares two series or more. Use bar for one.');
344
+ if (kind === 'stacked-area' && series.some((s) => s.values.some((v) => v !== null && v < 0))) {
345
+ issues.push('A stacked area cannot stack a negative part. Use line, or diverging bars.');
190
346
  }
191
347
  for (const s of series) {
192
348
  if (s.label.trim() === '')
@@ -200,19 +356,14 @@ export function chartIssues(chart) {
200
356
  }
201
357
  return issues;
202
358
  }
203
- const EN_ZA = new Intl.NumberFormat('en-ZA', { maximumFractionDigits: 2 });
204
- const NEGATIVE_ZERO = /^-0(?:[.,]0*)?$/;
205
- export function formatChartValue(value) {
206
- const text = EN_ZA.format(value);
207
- return NEGATIVE_ZERO.test(text) ? text.slice(1) : text;
208
- }
359
+ export { formatChartValue };
209
360
  const KIND_WORDS = {
210
361
  line: 'Line chart',
211
- bar: 'Bar chart',
212
- 'grouped-bar': 'Grouped bar chart',
362
+ 'stacked-area': 'Stacked area chart',
213
363
  };
214
- export function describeChart(chart, format = formatChartValue) {
364
+ export function describeChart(chart, format = formatChartValue, formatRange = chartBandRangeDefault, formatForecast) {
215
365
  const { kind, categories } = chart;
366
+ const split = chartProjectionIndex(chart.projectFrom, categories.length);
216
367
  const series = visibleSeries(categories, chart.series);
217
368
  const first = categories[0];
218
369
  const last = categories[categories.length - 1];
@@ -224,8 +375,9 @@ export function describeChart(chart, format = formatChartValue) {
224
375
  let h = null;
225
376
  let l = null;
226
377
  let readingCount = 0;
378
+ const projects = split !== undefined && s.comparison !== true;
227
379
  for (const [i, value] of s.values.entries()) {
228
- if (value === null)
380
+ if (value === null || (projects && i >= split))
229
381
  continue;
230
382
  readingCount++;
231
383
  const at = categories[i] ?? '';
@@ -247,16 +399,99 @@ export function describeChart(chart, format = formatChartValue) {
247
399
  else {
248
400
  sentences.push(`${s.label}: highest ${format(h.value)} in ${h.at}, lowest ${format(l.value)} in ${l.at}.`);
249
401
  }
402
+ sentences.push(...describeForecast(s, categories, chart, split, format, formatRange, formatForecast));
250
403
  }
251
404
  return sentences.join(' ');
252
405
  }
253
- export function tableToggleLabel(open) {
254
- return open ? 'Hide the table' : 'Show as a table';
406
+ export function chartBandRangeDefault(low, high) {
407
+ return `${low} – ${high}`;
408
+ }
409
+ export function chartProjectionIndex(projectFrom, count) {
410
+ return projectFrom !== undefined && Number.isInteger(projectFrom) && projectFrom >= 1 && projectFrom < count
411
+ ? projectFrom
412
+ : undefined;
413
+ }
414
+ function describeForecast(s, categories, chart, split, format, formatRange, formatForecast) {
415
+ if (s.comparison === true)
416
+ return [];
417
+ const band = s.band === undefined ? undefined : cleanBand(categories, s.band);
418
+ const bandWord = (chart.bandLabel ?? '').trim() === '' ? undefined : chart.bandLabel;
419
+ const sentences = [];
420
+ const projectionWord = (chart.projectionLabel ?? '').trim() === '' ? undefined : chart.projectionLabel;
421
+ if (split !== undefined && projectionWord !== undefined) {
422
+ const at = s.values.findLastIndex((v, i) => v !== null && i >= split);
423
+ const value = s.values[at] ?? null;
424
+ if (value !== null) {
425
+ const low = band?.low[at] ?? null;
426
+ const high = band?.high[at] ?? null;
427
+ const ranged = bandWord !== undefined && low !== null && high !== null;
428
+ const at_ = categories[at] ?? '';
429
+ sentences.push(formatForecast === undefined
430
+ ? `${s.label}: ${projectionWord} ${format(value)} in ${at_}${ranged ? `, ${bandWord} ${formatRange(format(low), format(high))}` : ''}.`
431
+ : formatForecast({
432
+ series: s.label,
433
+ projectionLabel: projectionWord,
434
+ value: format(value),
435
+ at: at_,
436
+ ...(ranged ? { bandLabel: bandWord, low: format(low), high: format(high) } : {}),
437
+ }));
438
+ }
439
+ return sentences;
440
+ }
441
+ if (band !== undefined && bandWord !== undefined) {
442
+ const lows = band.low.filter((v) => v !== null);
443
+ const highs = band.high.filter((v) => v !== null);
444
+ if (lows.length > 0 && highs.length > 0) {
445
+ sentences.push(`${s.label}: ${bandWord} ${formatRange(format(Math.min(...lows)), format(Math.max(...highs)))}.`);
446
+ }
447
+ }
448
+ return sentences;
449
+ }
450
+ export function chartIsExpected(series, index, split) {
451
+ return split !== undefined && series.comparison !== true && index >= split;
255
452
  }
453
+ export function chartBandAt(series, index) {
454
+ const low = series.band?.low[index] ?? null;
455
+ const high = series.band?.high[index] ?? null;
456
+ return low === null || high === null || !Number.isFinite(low) || !Number.isFinite(high)
457
+ ? undefined
458
+ : { low: Math.min(low, high), high: Math.max(low, high) };
459
+ }
460
+ export function chartReadingRows(series, index, words, format, formatRange = chartBandRangeDefault) {
461
+ const split = words.projectFrom;
462
+ const projectionWord = (words.projectionLabel ?? '').trim() === '' ? undefined : words.projectionLabel;
463
+ const bandWord = (words.bandLabel ?? '').trim() === '' ? undefined : words.bandLabel;
464
+ const lines = series.filter((s) => s.comparison !== true).length;
465
+ return series.flatMap((s, j) => {
466
+ const value = s.values[index] ?? null;
467
+ const expected = projectionWord !== undefined && chartIsExpected(s, index, split) && value !== null;
468
+ const label = expected ? (lines === 1 ? projectionWord : `${s.label} ${projectionWord}`) : s.label;
469
+ const rows = [
470
+ { kind: 'series', series: j, label, text: value === null ? 'no figure' : format(value), missing: value === null, expected },
471
+ ];
472
+ const band = chartBandAt(s, index);
473
+ if (band !== undefined && bandWord !== undefined && s.comparison !== true) {
474
+ rows.push({
475
+ kind: 'band',
476
+ series: j,
477
+ label: lines === 1 ? bandWord : `${s.label} ${bandWord}`,
478
+ text: formatRange(format(band.low), format(band.high)),
479
+ missing: false,
480
+ expected: false,
481
+ });
482
+ }
483
+ return rows;
484
+ });
485
+ }
486
+ export { tableToggleLabel } from '../lib/chart-table';
256
487
  export const CHART_TREND_KIND = 'trend';
257
488
  export const CHART_VIEWBOX = { width: 100, height: 100 };
258
489
  export const CHART_PLOT_INSET = 2;
259
490
  export { CHART_HUES };
491
+ export const CHART_COMPARE_NEEDS_A_LABEL = 'A chart given compare needs compareLabel, or the readout says two figures with nothing to tell them apart. Name the period before: "Last month".';
492
+ export function chartCompareNeedsALabel(compare, compareLabel) {
493
+ return compare !== undefined && compare.length > 0 && (compareLabel === undefined || compareLabel.trim() === '');
494
+ }
260
495
  export const CHART_SHAPES = ['line', 'mountain', 'silhouette'];
261
496
  const TREND_WIDTH = CHART_VIEWBOX.width;
262
497
  const TREND_HEIGHT = CHART_VIEWBOX.height;
@@ -268,13 +503,15 @@ function round2(n) {
268
503
  function pointsToPath(points) {
269
504
  return points.map(([x, y], i) => `${i === 0 ? 'M' : 'L'}${String(x)},${String(y)}`).join(' ');
270
505
  }
271
- export function chartTrendSpec({ values, projectFrom, series = 1 }) {
506
+ export function chartTrendSpec({ values, projectFrom, series = 1, compare = [], }) {
272
507
  const kept = values.flatMap((v, index) => (Number.isFinite(v) ? [{ v, index }] : []));
273
508
  const finite = kept.map(({ v }) => v);
509
+ const before = compare.flatMap((v, index) => (Number.isFinite(v) ? [{ v, index }] : []));
274
510
  if (finite.length === 0) {
275
511
  return {
276
512
  empty: true,
277
513
  max: 0,
514
+ zero: TREND_BOTTOM,
278
515
  last: undefined,
279
516
  line: '',
280
517
  area: '',
@@ -285,61 +522,103 @@ export function chartTrendSpec({ values, projectFrom, series = 1 }) {
285
522
  curveProjection: '',
286
523
  lastY: 0,
287
524
  points: [],
525
+ lone: [],
288
526
  head: undefined,
289
527
  series,
528
+ compare: '',
529
+ comparePoints: [],
290
530
  };
291
531
  }
292
- const max = Math.max(0, ...finite);
293
- const lastIndex = finite.length - 1;
294
- const x = (i) => lastIndex === 0 ? TREND_WIDTH : round2((i / lastIndex) * TREND_WIDTH);
295
- const y = (v) => max === 0
532
+ const max = Math.max(0, ...finite, ...before.map(({ v }) => v));
533
+ const span = Math.max(values.length, compare.length) - 1;
534
+ const at = (index) => (span === 0 ? TREND_WIDTH : round2((index / span) * TREND_WIDTH));
535
+ const min = Math.min(0, ...finite, ...before.map(({ v }) => v));
536
+ const y = (v) => max === min
296
537
  ? TREND_BOTTOM
297
- : round2(TREND_BOTTOM - (Math.max(0, v) / max) * (TREND_BOTTOM - TREND_TOP));
298
- const points = finite.map((v, i) => [x(i), y(v)]);
299
- const only = points.at(0) ?? [0, TREND_BOTTOM];
300
- const drawn = points.length === 1 ? [[0, only[1]], only] : points;
301
- const split = projectFrom !== undefined && projectFrom > 0 && projectFrom < drawn.length
302
- ? projectFrom
303
- : undefined;
304
- const measured = split === undefined ? drawn : drawn.slice(0, split);
305
- const projected = split === undefined ? [] : drawn.slice(split - 1);
306
- const first = measured.at(0) ?? only;
307
- const lastDrawn = measured.at(-1) ?? only;
308
- const end = drawn.at(-1) ?? only;
309
- const segments = chartCurveSegments(drawn);
310
- const cut = split === undefined ? segments.length : split - 1;
311
- const move = ([px, py]) => `M${String(px)},${String(py)}`;
312
- const curve = `${move(first)}${segments
313
- .slice(0, cut)
314
- .map((c) => ` ${c}`)
315
- .join('')}`;
316
- const projectionStart = drawn[cut] ?? lastDrawn;
317
- const placed = kept.map(({ v, index }, i) => {
318
- const [px, py] = points[i] ?? only;
319
- return { x: px, y: py, value: v, index };
320
- });
538
+ : round2(TREND_BOTTOM - ((v - min) / (max - min)) * (TREND_BOTTOM - TREND_TOP));
539
+ const placed = kept.map(({ v, index }) => ({ x: at(index), y: y(v), value: v, index }));
540
+ const single = span === 0;
541
+ const slots = single
542
+ ? [finite[0] ?? 0, finite[0] ?? 0]
543
+ : values.map((v) => (Number.isFinite(v) ? v : null));
544
+ const x = single ? (i) => i * TREND_WIDTH : at;
545
+ const split = chartProjectionIndex(projectFrom, slots.length);
546
+ const curved = chartSeriesPaths(slots, x, y, TREND_BOTTOM, split);
547
+ const bleed = chartSeriesPaths(slots, x, y, TREND_HEIGHT, split);
548
+ const straight = trendStraightPaths(slots, x, y, split);
549
+ const dots = curved.lone
550
+ .map((i) => {
551
+ const point = `${String(round2(x(i)))},${String(y(slots[i] ?? 0))}`;
552
+ return `M${point} L${point}`;
553
+ })
554
+ .join(' ');
555
+ const withDots = (d) => [d, dots].filter((part) => part !== '').join(' ');
556
+ const compareDrawn = before.map(({ v, index }) => [at(index), y(v)]);
557
+ const comparePoints = before.map(({ v, index }) => ({ x: at(index), y: y(v), value: v, index }));
558
+ const compareFirst = compareDrawn.at(0);
559
+ const compareCurve = compareDrawn.length > 1 && compareFirst !== undefined
560
+ ? `M${String(compareFirst[0])},${String(compareFirst[1])}${chartCurveSegments(compareDrawn)
561
+ .map((c) => ` ${c}`)
562
+ .join('')}`
563
+ : '';
564
+ const lastPlaced = placed.at(-1);
565
+ const measuredHead = split === undefined ? lastPlaced : [...placed].reverse().find((p) => p.index < split);
321
566
  return {
322
567
  empty: false,
323
568
  max,
569
+ zero: y(0),
324
570
  last: finite.at(-1),
325
- line: pointsToPath(measured),
326
- area: `${pointsToPath(measured)} L${String(lastDrawn[0])},${String(TREND_BOTTOM)} L${String(first[0])},${String(TREND_BOTTOM)} Z`,
327
- projection: projected.length > 1 ? pointsToPath(projected) : '',
328
- curve,
329
- curveArea: `${curve} L${String(lastDrawn[0])},${String(TREND_BOTTOM)} L${String(first[0])},${String(TREND_BOTTOM)} Z`,
330
- curveBleed: `${curve} L${String(lastDrawn[0])},${String(TREND_HEIGHT)} L${String(first[0])},${String(TREND_HEIGHT)} Z`,
331
- curveProjection: projected.length > 1
332
- ? `${move(projectionStart)}${segments
333
- .slice(cut)
334
- .map((c) => ` ${c}`)
335
- .join('')}`
336
- : '',
337
- lastY: end[1],
571
+ line: withDots(straight.line),
572
+ area: straight.area,
573
+ projection: straight.projection,
574
+ curve: withDots(curved.line),
575
+ curveArea: curved.area,
576
+ curveBleed: bleed.area,
577
+ curveProjection: curved.projection,
578
+ lastY: lastPlaced?.y ?? 0,
338
579
  points: placed,
339
- head: placed[split === undefined ? placed.length - 1 : Math.min(split - 1, placed.length - 1)],
580
+ lone: single ? [] : placed.filter((p) => curved.lone.includes(p.index)),
581
+ head: measuredHead ?? lastPlaced,
340
582
  series,
583
+ compare: compareCurve,
584
+ comparePoints,
341
585
  };
342
586
  }
587
+ function trendStraightPaths(values, x, y, split) {
588
+ const runs = [];
589
+ let run = [];
590
+ for (const [index, value] of values.entries()) {
591
+ if (value === null) {
592
+ if (run.length > 0)
593
+ runs.push(run);
594
+ run = [];
595
+ }
596
+ else {
597
+ run.push([index, round2(x(index)), y(value)]);
598
+ }
599
+ }
600
+ if (run.length > 0)
601
+ runs.push(run);
602
+ const lines = [];
603
+ const areas = [];
604
+ const projections = [];
605
+ const path = (points) => pointsToPath(points.map(([, px, py]) => [px, py]));
606
+ for (const points of runs) {
607
+ if (points.length < 2)
608
+ continue;
609
+ const measured = split === undefined ? points.length : points.filter(([i]) => i < split).length;
610
+ const solid = points.slice(0, measured);
611
+ const first = solid[0];
612
+ const last = solid.at(-1);
613
+ if (solid.length > 1 && first !== undefined && last !== undefined) {
614
+ lines.push(path(solid));
615
+ areas.push(`${path(solid)} L${String(last[1])},${String(TREND_BOTTOM)} L${String(first[1])},${String(TREND_BOTTOM)} Z`);
616
+ }
617
+ if (measured < points.length)
618
+ projections.push(path(points.slice(Math.max(0, measured - 1))));
619
+ }
620
+ return { line: lines.join(' '), area: areas.join(' '), projection: projections.join(' ') };
621
+ }
343
622
  export { chartCurveSegments } from '../lib/chart-curve';
344
623
  export function chartNearest(points, fraction) {
345
624
  const target = Math.min(1, Math.max(0, fraction)) * TREND_WIDTH;
@@ -359,3 +638,73 @@ export function chartStep(points, from, step) {
359
638
  const next = Math.min(points.length - 1, Math.max(0, (at === -1 ? 0 : at) + step));
360
639
  return points[next];
361
640
  }
641
+ export function chartOverReference(series, references, options = {}) {
642
+ if (references.length === 0)
643
+ return [];
644
+ const limit = Math.min(...references.map((r) => r.value));
645
+ const happened = (index) => options.projectFrom === undefined || index < options.projectFrom;
646
+ if (options.kind === 'stacked-area') {
647
+ const parts = series.filter((s) => s.comparison !== true);
648
+ const top = chartStack(parts).at(-1);
649
+ if (top === undefined)
650
+ return [];
651
+ const j = series.findIndex((s) => s === parts.at(-1));
652
+ return top.values.flatMap((value, index) => value !== null && value > limit && happened(index) ? [{ series: j, index, value }] : []);
653
+ }
654
+ return series.flatMap((s, j) => s.comparison === true
655
+ ? []
656
+ : s.values.flatMap((value, index) => value !== null && value > limit && happened(index) ? [{ series: j, index, value }] : []));
657
+ }
658
+ function listWords(words) {
659
+ if (words.length < 2)
660
+ return words.join('');
661
+ return `${words.slice(0, -1).join(', ')} and ${words.at(-1) ?? ''}`;
662
+ }
663
+ export function describeMarks(references, events, categories, formatValue, series = [], options = {}) {
664
+ const lowest = references.reduce((low, r) => (low === undefined || r.value < low.value ? r : low), undefined);
665
+ const names = (marks) => [...new Set(marks.map((o) => o.index))]
666
+ .sort((a, b) => a - b)
667
+ .flatMap((i) => (categories[i] === undefined ? [] : [categories[i] ?? '']));
668
+ const over = names(chartOverReference(series, references, options));
669
+ const expected = options.projectFrom === undefined
670
+ ? []
671
+ : names(chartOverReference(series, references, { ...options, projectFrom: undefined }).filter((o) => options.projectFrom !== undefined && o.index >= options.projectFrom));
672
+ const lowered = lowest === undefined ? '' : `${lowest.label.charAt(0).toLowerCase()}${lowest.label.slice(1)}`;
673
+ const said = [
674
+ ...references.map((r) => `${r.label}: ${formatValue(r.value)}.`),
675
+ ...(lowest !== undefined && over.length > 0 ? [`Over the ${lowered} in ${listWords(over)}.`] : []),
676
+ ...(lowest !== undefined && expected.length > 0
677
+ ? [`Expected to pass the ${lowered} in ${listWords(expected)}.`]
678
+ : []),
679
+ ...events.flatMap((e) => (categories[e.index] === undefined ? [] : [`${e.label}, ${categories[e.index] ?? ''}.`])),
680
+ ];
681
+ return said.join(' ');
682
+ }
683
+ export function chartStack(series) {
684
+ const length = Math.max(0, ...series.map((s) => s.values.length));
685
+ const below = Array.from({ length }, () => 0);
686
+ return series.map((s) => ({
687
+ label: s.label,
688
+ values: below.map((under, i) => {
689
+ const v = s.values[i];
690
+ const top = under + (v === null || v === undefined || !Number.isFinite(v) ? 0 : Math.max(0, v));
691
+ below[i] = top;
692
+ return top;
693
+ }),
694
+ }));
695
+ }
696
+ export function chartStackPaths(tops, x, y, baseline) {
697
+ const edge = (values) => values.map((v, i) => [round2(x(i)), v === null ? baseline : round2(y(v))]);
698
+ return tops.map((top, j) => {
699
+ const upper = edge(top.values);
700
+ const lower = j === 0 ? upper.map(([px]) => [px, baseline]) : edge(tops[j - 1]?.values ?? []);
701
+ const first = upper[0];
702
+ const back = [...lower].reverse();
703
+ const start = back[0];
704
+ if (first === undefined || start === undefined)
705
+ return { line: '', band: '' };
706
+ const line = `M${String(first[0])},${String(first[1])} ${chartCurveSegments(upper).join(' ')}`;
707
+ const band = `${line} L${String(start[0])},${String(start[1])} ${chartCurveSegments(back).join(' ')} Z`;
708
+ return { line, band };
709
+ });
710
+ }