@tfn-design/design-system 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (749) hide show
  1. package/README.md +2 -2
  2. package/dist/accordion/accordion.d.ts +1 -1
  3. package/dist/accordion/accordion.js +1 -1
  4. package/dist/accordion/web/ds-accordion.js +5 -4
  5. package/dist/account-password-field/account-password-field.js +1 -1
  6. package/dist/account-switcher/account-switcher.d.ts +11 -4
  7. package/dist/account-switcher/account-switcher.js +2 -1
  8. package/dist/account-switcher/web/ds-account-switcher.js +12 -4
  9. package/dist/ai-attachment/ai-attachment.d.ts +1 -1
  10. package/dist/ai-attachment/ai-attachment.js +1 -1
  11. package/dist/ai-attachment/web/ds-ai-attachment.js +1 -1
  12. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.js +2 -2
  13. package/dist/ai-composer/ai-composer.d.ts +1 -1
  14. package/dist/ai-composer/ai-composer.js +1 -1
  15. package/dist/ai-composer/native/ds-ai-composer.js +4 -2
  16. package/dist/ai-composer/web/ds-ai-composer.js +2 -3
  17. package/dist/ai-confirmation/ai-confirmation.d.ts +19 -3
  18. package/dist/ai-confirmation/ai-confirmation.js +18 -3
  19. package/dist/ai-confirmation/native/ds-ai-confirmation.js +18 -13
  20. package/dist/ai-confirmation/web/ds-ai-confirmation.d.ts +1 -1
  21. package/dist/ai-confirmation/web/ds-ai-confirmation.js +22 -11
  22. package/dist/ai-context-scope/ai-context-scope.d.ts +10 -2
  23. package/dist/ai-context-scope/ai-context-scope.js +11 -2
  24. package/dist/ai-context-scope/native/ds-ai-context-scope.js +4 -3
  25. package/dist/ai-context-scope/web/ds-ai-context-scope.js +19 -5
  26. package/dist/ai-conversation-list/ai-conversation-list.d.ts +16 -0
  27. package/dist/ai-conversation-list/ai-conversation-list.js +8 -0
  28. package/dist/ai-conversation-list/web/ds-ai-conversation-list.d.ts +10 -6
  29. package/dist/ai-conversation-list/web/ds-ai-conversation-list.js +89 -47
  30. package/dist/ai-diff/ai-diff.d.ts +13 -1
  31. package/dist/ai-diff/ai-diff.js +12 -1
  32. package/dist/ai-diff/native/ds-ai-diff.d.ts +1 -1
  33. package/dist/ai-diff/native/ds-ai-diff.js +4 -6
  34. package/dist/ai-diff/web/ds-ai-diff.d.ts +0 -4
  35. package/dist/ai-diff/web/ds-ai-diff.js +16 -9
  36. package/dist/ai-draft-panel/ai-draft-panel.d.ts +2 -0
  37. package/dist/ai-draft-panel/ai-draft-panel.js +5 -0
  38. package/dist/ai-draft-panel/web/ds-ai-draft-panel.d.ts +3 -1
  39. package/dist/ai-draft-panel/web/ds-ai-draft-panel.js +4 -4
  40. package/dist/ai-empty-state/native/ds-ai-empty-state.js +2 -2
  41. package/dist/ai-empty-state/web/ds-ai-empty-state.js +3 -1
  42. package/dist/ai-error-state/ai-error-state.d.ts +2 -2
  43. package/dist/ai-error-state/ai-error-state.js +2 -2
  44. package/dist/ai-error-state/native/ds-ai-error-state.d.ts +5 -1
  45. package/dist/ai-error-state/native/ds-ai-error-state.js +2 -1
  46. package/dist/ai-error-state/web/ds-ai-error-state.d.ts +5 -1
  47. package/dist/ai-error-state/web/ds-ai-error-state.js +3 -2
  48. package/dist/ai-label/native/ds-ai-label.js +2 -1
  49. package/dist/ai-label/web/ds-ai-label.js +1 -1
  50. package/dist/ai-message/ai-message.d.ts +1 -1
  51. package/dist/ai-message/ai-message.js +1 -1
  52. package/dist/ai-message/native/ds-ai-message.js +4 -3
  53. package/dist/ai-message/web/ds-ai-message-markdown.js +3 -3
  54. package/dist/ai-message/web/ds-ai-message.js +4 -3
  55. package/dist/ai-message-actions/ai-message-actions.d.ts +1 -1
  56. package/dist/ai-message-actions/ai-message-actions.js +1 -1
  57. package/dist/ai-message-actions/native/ds-ai-message-actions.js +1 -1
  58. package/dist/ai-message-actions/web/ds-ai-message-actions.js +1 -1
  59. package/dist/ai-plan/ai-plan.d.ts +1 -1
  60. package/dist/ai-plan/ai-plan.js +1 -1
  61. package/dist/ai-plan/web/ds-ai-plan.js +2 -2
  62. package/dist/ai-side-nav/web/ds-ai-side-nav.js +4 -3
  63. package/dist/ai-summary-card/native/ds-ai-summary-card.js +2 -1
  64. package/dist/ai-summary-card/web/ds-ai-summary-card.js +2 -1
  65. package/dist/ai-thread/web/ds-ai-thread.js +1 -1
  66. package/dist/ai-tool-call/ai-tool-call.d.ts +1 -1
  67. package/dist/ai-tool-call/ai-tool-call.js +1 -1
  68. package/dist/ai-tool-call/native/ds-ai-tool-call.js +3 -2
  69. package/dist/ai-tool-call/web/ds-ai-tool-call.js +4 -3
  70. package/dist/alert/native/ds-alert.js +4 -4
  71. package/dist/alert/web/ds-alert.js +5 -5
  72. package/dist/ambient-gradient/ambient-gradient.d.ts +1 -1
  73. package/dist/amount/amount.d.ts +1 -1
  74. package/dist/amount/amount.js +3 -2
  75. package/dist/amount/native/ds-amount.js +1 -1
  76. package/dist/amount/web/ds-amount.js +1 -1
  77. package/dist/amount-cell/amount-cell.d.ts +5 -2
  78. package/dist/amount-cell/web/ds-amount-cell.d.ts +1 -1
  79. package/dist/amount-cell/web/ds-amount-cell.js +7 -1
  80. package/dist/amount-entry/amount-entry.d.ts +28 -2
  81. package/dist/amount-entry/amount-entry.js +19 -12
  82. package/dist/amount-entry/native/ds-amount-entry.d.ts +1 -1
  83. package/dist/amount-entry/native/ds-amount-entry.js +5 -4
  84. package/dist/amount-entry/web/ds-amount-entry.d.ts +1 -1
  85. package/dist/amount-entry/web/ds-amount-entry.js +5 -4
  86. package/dist/app-shell/app-shell.d.ts +2 -0
  87. package/dist/app-shell/web/ds-app-shell.js +26 -3
  88. package/dist/approval-chain/approval-chain.d.ts +6 -2
  89. package/dist/approval-chain/approval-chain.js +4 -4
  90. package/dist/approval-chain/native/ds-approval-chain.js +16 -9
  91. package/dist/approval-chain/web/ds-approval-chain.d.ts +7 -1
  92. package/dist/approval-chain/web/ds-approval-chain.js +12 -11
  93. package/dist/auth-shell/web/ds-auth-shell.d.ts +5 -1
  94. package/dist/auth-shell/web/ds-auth-shell.js +5 -2
  95. package/dist/balance-header/balance-header.d.ts +8 -4
  96. package/dist/balance-header/native/ds-balance-header.d.ts +3 -3
  97. package/dist/balance-header/native/ds-balance-header.js +11 -4
  98. package/dist/balance-header/web/ds-balance-header.d.ts +1 -1
  99. package/dist/balance-header/web/ds-balance-header.js +7 -4
  100. package/dist/bar-chart/bar-chart.d.ts +46 -5
  101. package/dist/bar-chart/bar-chart.js +64 -6
  102. package/dist/bar-chart/web/ds-bar-chart.d.ts +21 -4
  103. package/dist/bar-chart/web/ds-bar-chart.js +121 -50
  104. package/dist/bottom-nav/bottom-nav.d.ts +8 -3
  105. package/dist/bottom-nav/bottom-nav.js +2 -2
  106. package/dist/bottom-nav/web/ds-bottom-nav.js +2 -2
  107. package/dist/box-plot/box-plot.d.ts +150 -0
  108. package/dist/box-plot/box-plot.js +124 -0
  109. package/dist/box-plot/web/ds-box-plot.d.ts +8 -0
  110. package/dist/box-plot/web/ds-box-plot.js +57 -0
  111. package/dist/brand-lockup/native/ds-brand-lockup.js +1 -1
  112. package/dist/brand-provider/brand-provider.d.ts +29 -0
  113. package/dist/brand-provider/brand-provider.js +9 -0
  114. package/dist/brand-provider/native/ds-brand-provider.d.ts +11 -0
  115. package/dist/brand-provider/native/ds-brand-provider.js +18 -0
  116. package/dist/brand-provider/web/ds-brand-provider.d.ts +10 -0
  117. package/dist/brand-provider/web/ds-brand-provider.js +20 -0
  118. package/dist/bullet-chart/bullet-chart.d.ts +12 -7
  119. package/dist/bullet-chart/bullet-chart.js +5 -4
  120. package/dist/bullet-chart/web/ds-bullet-chart.d.ts +1 -1
  121. package/dist/bullet-chart/web/ds-bullet-chart.js +9 -4
  122. package/dist/button/button.d.ts +1 -1
  123. package/dist/button/native/ds-button.js +2 -2
  124. package/dist/button/web/ds-button.js +1 -1
  125. package/dist/button-group/button-group.d.ts +1 -1
  126. package/dist/button-group/web/ds-button-group.d.ts +2 -2
  127. package/dist/calendar/calendar.d.ts +13 -2
  128. package/dist/calendar/calendar.js +4 -3
  129. package/dist/calendar/web/ds-calendar.d.ts +1 -1
  130. package/dist/calendar/web/ds-calendar.js +6 -5
  131. package/dist/card-carousel/native/ds-card-carousel.js +1 -1
  132. package/dist/card-carousel/web/ds-card-carousel.js +2 -2
  133. package/dist/chart/chart.d.ts +180 -64
  134. package/dist/chart/chart.js +367 -118
  135. package/dist/chart/web/ds-chart.d.ts +17 -7
  136. package/dist/chart/web/ds-chart.js +85 -108
  137. package/dist/check-option/check-option.d.ts +1 -1
  138. package/dist/check-option/check-option.js +1 -1
  139. package/dist/check-option/web/ds-check-option.d.ts +6 -1
  140. package/dist/check-option/web/ds-check-option.js +10 -6
  141. package/dist/checkbox/checkbox.d.ts +2 -2
  142. package/dist/checkbox/checkbox.js +2 -2
  143. package/dist/checkbox/native/ds-checkbox.js +1 -1
  144. package/dist/checkbox/web/checkbox-mark.js +1 -1
  145. package/dist/checkbox/web/ds-checkbox.d.ts +2 -2
  146. package/dist/checkbox/web/ds-checkbox.js +17 -6
  147. package/dist/chip/chip.d.ts +11 -11
  148. package/dist/chip/chip.js +5 -3
  149. package/dist/chip/native/ds-chip.js +1 -1
  150. package/dist/chip/web/ds-chip.js +6 -6
  151. package/dist/code-block/web/ds-code-block.js +3 -3
  152. package/dist/column-picker/web/ds-column-picker.js +2 -1
  153. package/dist/combobox/combobox.d.ts +2 -2
  154. package/dist/combobox/web/ds-combobox.js +4 -2
  155. package/dist/command-palette/command-palette.d.ts +4 -0
  156. package/dist/comment-thread/comment-thread.d.ts +2 -2
  157. package/dist/comment-thread/comment-thread.js +2 -2
  158. package/dist/comment-thread/native/ds-comment-thread.js +10 -9
  159. package/dist/comment-thread/web/ds-comment-thread.js +11 -10
  160. package/dist/condition-builder/condition-builder.d.ts +96 -4
  161. package/dist/condition-builder/condition-builder.js +68 -28
  162. package/dist/condition-builder/web/ds-condition-builder.d.ts +4 -2
  163. package/dist/condition-builder/web/ds-condition-builder.js +97 -57
  164. package/dist/context-switcher/context-switcher.d.ts +10 -1
  165. package/dist/context-switcher/context-switcher.js +5 -2
  166. package/dist/context-switcher/web/ds-context-switcher.d.ts +1 -1
  167. package/dist/context-switcher/web/ds-context-switcher.js +4 -3
  168. package/dist/coordinate-field/coordinate-field.d.ts +46 -5
  169. package/dist/coordinate-field/coordinate-field.js +35 -18
  170. package/dist/coordinate-field/native/ds-coordinate-field.d.ts +1 -1
  171. package/dist/coordinate-field/native/ds-coordinate-field.js +9 -8
  172. package/dist/coordinate-field/web/ds-coordinate-field.d.ts +1 -1
  173. package/dist/coordinate-field/web/ds-coordinate-field.js +10 -9
  174. package/dist/copy-field/copy-field.d.ts +23 -9
  175. package/dist/copy-field/copy-field.js +11 -6
  176. package/dist/copy-field/web/ds-copy-field.d.ts +1 -1
  177. package/dist/copy-field/web/ds-copy-field.js +6 -5
  178. package/dist/copy.d.ts +8 -0
  179. package/dist/copy.js +7 -0
  180. package/dist/count-badge/web/ds-count-badge.js +1 -1
  181. package/dist/countdown/native/ds-countdown.js +1 -1
  182. package/dist/countdown/web/ds-countdown.js +1 -1
  183. package/dist/dashboard-shell/dashboard-shell.d.ts +4 -2
  184. package/dist/data-table/web/data-table-theme.css +340 -52
  185. package/dist/data-table/web/ds-data-table.d.ts +43 -1
  186. package/dist/data-table/web/ds-data-table.js +165 -17
  187. package/dist/date-field/web/ds-date-field.d.ts +1 -1
  188. package/dist/date-field/web/ds-date-field.js +6 -5
  189. package/dist/date-input/date-input.d.ts +26 -5
  190. package/dist/date-input/date-input.js +34 -2
  191. package/dist/date-input/web/ds-date-input.js +13 -4
  192. package/dist/date-picker/date-picker.d.ts +38 -67
  193. package/dist/date-picker/date-picker.js +26 -60
  194. package/dist/date-picker/web/ds-date-picker.d.ts +13 -6
  195. package/dist/date-picker/web/ds-date-picker.js +41 -10
  196. package/dist/date-range-picker/web/ds-date-range-picker.d.ts +10 -4
  197. package/dist/date-range-picker/web/ds-date-range-picker.js +8 -5
  198. package/dist/day-picker/day-picker.d.ts +1 -1
  199. package/dist/day-picker/web/ds-day-picker.js +1 -1
  200. package/dist/delta/delta.d.ts +15 -1
  201. package/dist/delta/delta.js +20 -0
  202. package/dist/delta/native/ds-delta.d.ts +5 -2
  203. package/dist/delta/native/ds-delta.js +4 -3
  204. package/dist/delta/web/ds-delta.d.ts +5 -2
  205. package/dist/delta/web/ds-delta.js +4 -3
  206. package/dist/description-list/description-list.d.ts +4 -2
  207. package/dist/description-list/native/ds-description-list.d.ts +2 -2
  208. package/dist/description-list/native/ds-description-list.js +49 -27
  209. package/dist/description-list/web/ds-description-list.d.ts +2 -2
  210. package/dist/description-list/web/ds-description-list.js +40 -17
  211. package/dist/dialog/dialog.d.ts +12 -1
  212. package/dist/dialog/web/ds-dialog.d.ts +1 -1
  213. package/dist/dialog/web/ds-dialog.js +5 -3
  214. package/dist/diverging-bar-chart/diverging-bar-chart.d.ts +2 -1
  215. package/dist/diverging-bar-chart/diverging-bar-chart.js +2 -1
  216. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.d.ts +1 -1
  217. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.js +28 -5
  218. package/dist/donut-chart/donut-chart.d.ts +7 -1
  219. package/dist/donut-chart/donut-chart.js +4 -0
  220. package/dist/donut-chart/web/ds-donut-chart.d.ts +4 -1
  221. package/dist/donut-chart/web/ds-donut-chart.js +43 -24
  222. package/dist/drawer/drawer.d.ts +42 -5
  223. package/dist/drawer/drawer.js +10 -4
  224. package/dist/drawer/native/ds-drawer.d.ts +1 -1
  225. package/dist/drawer/native/ds-drawer.js +17 -7
  226. package/dist/drawer/web/ds-drawer.d.ts +1 -1
  227. package/dist/drawer/web/ds-drawer.js +32 -17
  228. package/dist/dropdown-menu/dropdown-menu.d.ts +10 -5
  229. package/dist/dropdown-menu/dropdown-menu.js +13 -4
  230. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.d.ts +4 -2
  231. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.js +6 -6
  232. package/dist/dropdown-menu/web/ds-dropdown-menu.d.ts +5 -2
  233. package/dist/dropdown-menu/web/ds-dropdown-menu.js +2 -2
  234. package/dist/dumbbell-chart/dumbbell-chart.d.ts +10 -9
  235. package/dist/dumbbell-chart/dumbbell-chart.js +18 -4
  236. package/dist/dumbbell-chart/web/ds-dumbbell-chart.d.ts +4 -1
  237. package/dist/dumbbell-chart/web/ds-dumbbell-chart.js +13 -3
  238. package/dist/editable-row/editable-row.d.ts +5 -1
  239. package/dist/editable-row/editable-row.js +7 -1
  240. package/dist/editable-row/web/ds-editable-row.js +7 -5
  241. package/dist/empty-state/empty-state.d.ts +39 -0
  242. package/dist/empty-state/empty-state.js +21 -0
  243. package/dist/empty-state/web/ds-empty-state.d.ts +19 -8
  244. package/dist/empty-state/web/ds-empty-state.js +15 -3
  245. package/dist/environment-banner/environment-banner.d.ts +1 -1
  246. package/dist/environment-banner/environment-banner.js +1 -1
  247. package/dist/environment-banner/web/ds-environment-banner.js +3 -3
  248. package/dist/evaluation-trace/evaluation-trace.d.ts +1 -1
  249. package/dist/evaluation-trace/evaluation-trace.js +1 -1
  250. package/dist/evaluation-trace/web/ds-evaluation-trace.js +1 -1
  251. package/dist/event-row/web/ds-event-row.d.ts +1 -1
  252. package/dist/event-row/web/ds-event-row.js +2 -1
  253. package/dist/facet-button/facet-button.d.ts +9 -1
  254. package/dist/facet-button/facet-button.js +2 -2
  255. package/dist/facet-button/web/ds-facet-button.d.ts +1 -1
  256. package/dist/facet-button/web/ds-facet-button.js +9 -5
  257. package/dist/facet-menu/facet-menu.d.ts +1 -1
  258. package/dist/facet-menu/facet-menu.js +2 -1
  259. package/dist/facet-menu/web/ds-facet-menu.js +1 -1
  260. package/dist/fact/native/ds-fact.d.ts +4 -1
  261. package/dist/file-dropzone/file-dropzone.d.ts +54 -5
  262. package/dist/file-dropzone/file-dropzone.js +38 -20
  263. package/dist/file-dropzone/web/ds-file-dropzone.d.ts +1 -1
  264. package/dist/file-dropzone/web/ds-file-dropzone.js +16 -15
  265. package/dist/file-field/file-field.d.ts +26 -5
  266. package/dist/file-field/file-field.js +18 -8
  267. package/dist/file-field/web/ds-file-field.d.ts +5 -2
  268. package/dist/file-field/web/ds-file-field.js +6 -5
  269. package/dist/file-import/file-import.d.ts +50 -4
  270. package/dist/file-import/file-import.js +30 -11
  271. package/dist/file-import/web/ds-file-import.d.ts +7 -3
  272. package/dist/file-import/web/ds-file-import.js +11 -10
  273. package/dist/file-upload/file-upload.d.ts +64 -15
  274. package/dist/file-upload/file-upload.js +44 -30
  275. package/dist/file-upload/web/ds-file-upload.d.ts +11 -2
  276. package/dist/file-upload/web/ds-file-upload.js +17 -12
  277. package/dist/filter-bar/web/ds-filter-bar.js +1 -1
  278. package/dist/filter-button/filter-button.d.ts +5 -4
  279. package/dist/filter-button/filter-button.js +1 -1
  280. package/dist/filter-chip/web/ds-filter-chip.js +2 -2
  281. package/dist/filter-popover/web/ds-filter-popover.js +2 -1
  282. package/dist/form-field-group/form-field-group.d.ts +7 -2
  283. package/dist/form-field-group/form-field-group.js +2 -0
  284. package/dist/form-field-group/web/ds-form-field-group.js +2 -1
  285. package/dist/form-section/form-section.d.ts +4 -2
  286. package/dist/form-section/form-section.js +1 -1
  287. package/dist/funnel/funnel.d.ts +2 -1
  288. package/dist/funnel/web/ds-funnel.d.ts +1 -1
  289. package/dist/funnel/web/ds-funnel.js +22 -12
  290. package/dist/gauge/gauge.d.ts +6 -1
  291. package/dist/gauge/gauge.js +9 -1
  292. package/dist/gauge/web/ds-gauge.d.ts +8 -3
  293. package/dist/gauge/web/ds-gauge.js +26 -15
  294. package/dist/geo/geo.d.ts +15 -0
  295. package/dist/geo/geo.js +112 -0
  296. package/dist/geofence-editor/geofence-editor.d.ts +14 -5
  297. package/dist/geofence-editor/geofence-editor.js +32 -7
  298. package/dist/geofence-editor/web/ds-geofence-editor.d.ts +18 -3
  299. package/dist/geofence-editor/web/ds-geofence-editor.js +28 -13
  300. package/dist/group-header/web/ds-group-header.d.ts +1 -1
  301. package/dist/heatmap/heatmap-calendar.d.ts +95 -0
  302. package/dist/heatmap/heatmap-calendar.js +130 -0
  303. package/dist/heatmap/heatmap.d.ts +35 -8
  304. package/dist/heatmap/heatmap.js +61 -7
  305. package/dist/heatmap/web/ds-heatmap-calendar.d.ts +22 -0
  306. package/dist/heatmap/web/ds-heatmap-calendar.js +33 -0
  307. package/dist/heatmap/web/ds-heatmap.d.ts +21 -1
  308. package/dist/heatmap/web/ds-heatmap.js +59 -31
  309. package/dist/helper-text/native/ds-helper-text.js +2 -2
  310. package/dist/helper-text/web/ds-helper-text.js +2 -2
  311. package/dist/histogram/histogram.d.ts +2 -3
  312. package/dist/histogram/web/ds-histogram.d.ts +1 -1
  313. package/dist/histogram/web/ds-histogram.js +8 -2
  314. package/dist/icon/icon.d.ts +11 -0
  315. package/dist/icon/icon.js +52 -0
  316. package/dist/icon/native/ds-icon-provider.d.ts +6 -1
  317. package/dist/icon/native/ds-icon-provider.js +4 -2
  318. package/dist/icon/native/icon-direction.d.ts +10 -0
  319. package/dist/icon/native/icon-direction.js +6 -0
  320. package/dist/icon/native/use-icon-size.d.ts +6 -0
  321. package/dist/icon/native/use-icon-size.js +12 -0
  322. package/dist/icon/web/ds-icon-provider.d.ts +3 -1
  323. package/dist/icon/web/ds-icon-provider.js +1 -0
  324. package/dist/icon/web/icon-direction.css +45 -0
  325. package/dist/icon-button/icon-button.d.ts +6 -0
  326. package/dist/icon-button/native/ds-icon-button.d.ts +1 -1
  327. package/dist/icon-button/native/ds-icon-button.js +2 -1
  328. package/dist/icon-button/web/ds-icon-button.d.ts +1 -1
  329. package/dist/icon-button/web/ds-icon-button.js +8 -5
  330. package/dist/icon-frame/icon-frame.d.ts +2 -2
  331. package/dist/icon-frame/native/ds-icon-frame.js +3 -3
  332. package/dist/icon-frame/web/ds-icon-frame.js +3 -3
  333. package/dist/ident/ident.d.ts +2 -0
  334. package/dist/ident/ident.js +5 -0
  335. package/dist/ident/native/ds-ident.d.ts +30 -0
  336. package/dist/ident/native/ds-ident.js +13 -0
  337. package/dist/index.d.ts +88 -65
  338. package/dist/index.js +47 -36
  339. package/dist/inline-edit/inline-edit.d.ts +34 -4
  340. package/dist/inline-edit/inline-edit.js +19 -7
  341. package/dist/inline-edit/web/ds-inline-edit.d.ts +1 -1
  342. package/dist/inline-edit/web/ds-inline-edit.js +13 -8
  343. package/dist/input/input.d.ts +18 -5
  344. package/dist/input/input.js +17 -13
  345. package/dist/input/native/ds-input.js +1 -1
  346. package/dist/input/web/ds-input.d.ts +7 -1
  347. package/dist/input/web/ds-input.js +11 -9
  348. package/dist/interaction.d.ts +7 -5
  349. package/dist/interaction.js +1 -1
  350. package/dist/json-viewer/web/ds-json-viewer.js +1 -1
  351. package/dist/key-value-editor/key-value-editor.d.ts +57 -3
  352. package/dist/key-value-editor/key-value-editor.js +56 -26
  353. package/dist/key-value-editor/web/ds-key-value-editor.d.ts +1 -1
  354. package/dist/key-value-editor/web/ds-key-value-editor.js +15 -16
  355. package/dist/keypad/keypad.d.ts +21 -11
  356. package/dist/keypad/keypad.js +16 -10
  357. package/dist/keypad/native/ds-keypad.d.ts +1 -1
  358. package/dist/keypad/native/ds-keypad.js +10 -8
  359. package/dist/keypad/web/ds-keypad.d.ts +1 -1
  360. package/dist/keypad/web/ds-keypad.js +5 -4
  361. package/dist/label-picker/label-picker.d.ts +34 -4
  362. package/dist/label-picker/label-picker.js +28 -17
  363. package/dist/label-picker/native/ds-label-picker.d.ts +1 -1
  364. package/dist/label-picker/native/ds-label-picker.js +11 -10
  365. package/dist/label-picker/web/ds-label-picker.d.ts +1 -1
  366. package/dist/label-picker/web/ds-label-picker.js +11 -10
  367. package/dist/labeled-field/labeled-field.d.ts +17 -2
  368. package/dist/labeled-field/labeled-field.js +7 -5
  369. package/dist/labeled-field/web/ds-labeled-field.d.ts +1 -1
  370. package/dist/labeled-field/web/ds-labeled-field.js +6 -2
  371. package/dist/leaderboard/leaderboard.d.ts +4 -3
  372. package/dist/leaderboard/leaderboard.js +4 -1
  373. package/dist/leaderboard/web/ds-leaderboard.d.ts +1 -1
  374. package/dist/leaderboard/web/ds-leaderboard.js +8 -3
  375. package/dist/legend/legend.d.ts +4 -0
  376. package/dist/legend/legend.js +1 -0
  377. package/dist/legend/web/ds-legend.js +18 -11
  378. package/dist/lib/chart-context.d.ts +23 -3
  379. package/dist/lib/chart-context.js +9 -3
  380. package/dist/lib/chart-finish.d.ts +13 -6
  381. package/dist/lib/chart-finish.js +8 -2
  382. package/dist/lib/chart-library.d.ts +1 -1
  383. package/dist/lib/chart-series.d.ts +7 -4
  384. package/dist/lib/chart-series.js +2 -4
  385. package/dist/lib/chart-ticks.d.ts +11 -0
  386. package/dist/lib/chart-ticks.js +11 -0
  387. package/dist/lib/chart-value.d.ts +1 -1
  388. package/dist/lib/chart-value.js +3 -1
  389. package/dist/lib/cn.d.ts +1 -0
  390. package/dist/lib/cn.js +7 -2
  391. package/dist/lib/time-of-day.d.ts +21 -0
  392. package/dist/lib/time-of-day.js +37 -0
  393. package/dist/lib/web/chart-finish.d.ts +1 -1
  394. package/dist/lib/web/chart-finish.js +1 -1
  395. package/dist/lib/web/density.d.ts +1 -0
  396. package/dist/lib/web/density.js +7 -0
  397. package/dist/lib/web/focus-habits.js +20 -8
  398. package/dist/lib/web/focus-trap.d.ts +10 -0
  399. package/dist/lib/web/focus-trap.js +4 -1
  400. package/dist/lib/web/live-announcer.d.ts +2 -0
  401. package/dist/lib/web/live-announcer.js +2 -1
  402. package/dist/lib/web/touch-target.d.ts +4 -4
  403. package/dist/lib/web/touch-target.js +3 -3
  404. package/dist/lib/web/use-anchored-surface.js +3 -2
  405. package/dist/lib/web/use-overlay.js +7 -1
  406. package/dist/list-page/list-page.d.ts +2 -1
  407. package/dist/list-page/web/ds-list-page.js +1 -5
  408. package/dist/list-row/list-row.d.ts +6 -6
  409. package/dist/list-row/list-row.js +4 -5
  410. package/dist/list-row/native/ds-list-row.js +7 -2
  411. package/dist/list-row/web/ds-list-row-group.d.ts +6 -2
  412. package/dist/list-row/web/ds-list-row-group.js +4 -2
  413. package/dist/list-row/web/ds-list-row.js +9 -9
  414. package/dist/loading-screen/native/ds-loading-screen.js +1 -1
  415. package/dist/log-viewer/log-viewer.d.ts +2 -2
  416. package/dist/log-viewer/log-viewer.js +1 -1
  417. package/dist/log-viewer/web/ds-log-viewer.js +6 -5
  418. package/dist/map/map.d.ts +5 -0
  419. package/dist/map/map.js +2 -0
  420. package/dist/map/web/ds-map.js +9 -3
  421. package/dist/map-banner/native/ds-map-banner.js +3 -3
  422. package/dist/map-banner/web/ds-map-banner.js +4 -4
  423. package/dist/map-controls/map-controls.d.ts +3 -5
  424. package/dist/map-controls/map-controls.js +4 -4
  425. package/dist/map-controls/native/ds-map-controls.js +1 -1
  426. package/dist/map-controls/web/ds-map-controls.js +1 -1
  427. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.js +3 -2
  428. package/dist/map-heatmap-layer/map-heatmap-layer.d.ts +1 -1
  429. package/dist/map-layers/map-layers.d.ts +1 -1
  430. package/dist/map-layers/map-layers.js +1 -1
  431. package/dist/map-layers/native/ds-map-layers.d.ts +4 -2
  432. package/dist/map-layers/native/ds-map-layers.js +5 -4
  433. package/dist/map-layers/web/ds-map-layers.js +4 -4
  434. package/dist/map-list/map-list.d.ts +2 -1
  435. package/dist/map-list/web/ds-map-list.d.ts +1 -1
  436. package/dist/map-list/web/ds-map-list.js +19 -16
  437. package/dist/map-marker/map-marker.d.ts +5 -0
  438. package/dist/map-marker/map-marker.js +6 -0
  439. package/dist/map-marker/web/ds-map-marker.d.ts +12 -3
  440. package/dist/map-marker/web/ds-map-marker.js +18 -8
  441. package/dist/map-search/map-search.d.ts +9 -0
  442. package/dist/map-search/map-search.js +13 -0
  443. package/dist/map-search/native/ds-map-search.d.ts +10 -3
  444. package/dist/map-search/native/ds-map-search.js +32 -19
  445. package/dist/map-search/web/ds-map-search.d.ts +8 -3
  446. package/dist/map-search/web/ds-map-search.js +37 -27
  447. package/dist/map-search-area/native/ds-map-search-area.js +2 -1
  448. package/dist/map-search-area/web/ds-map-search-area.js +2 -1
  449. package/dist/map-sheet/native/ds-map-sheet.js +1 -1
  450. package/dist/map-sheet/web/ds-map-sheet.js +2 -2
  451. package/dist/map-summary/map-summary.d.ts +2 -1
  452. package/dist/map-summary/web/ds-map-summary.d.ts +2 -2
  453. package/dist/map-summary/web/ds-map-summary.js +18 -9
  454. package/dist/mention-input/mention-input.d.ts +23 -2
  455. package/dist/mention-input/mention-input.js +15 -8
  456. package/dist/mention-input/native/ds-mention-input.d.ts +1 -1
  457. package/dist/mention-input/native/ds-mention-input.js +6 -9
  458. package/dist/mention-input/web/ds-mention-input.d.ts +1 -1
  459. package/dist/mention-input/web/ds-mention-input.js +6 -5
  460. package/dist/menu-button/web/ds-menu-button.d.ts +2 -2
  461. package/dist/menu-button/web/ds-menu-button.js +9 -4
  462. package/dist/meter/meter.d.ts +5 -2
  463. package/dist/meter/meter.js +2 -1
  464. package/dist/meter/native/ds-meter.d.ts +2 -2
  465. package/dist/meter/native/ds-meter.js +13 -3
  466. package/dist/meter/web/ds-meter.d.ts +1 -1
  467. package/dist/meter/web/ds-meter.js +16 -9
  468. package/dist/metric/metric.d.ts +13 -9
  469. package/dist/metric/native/ds-metric.d.ts +1 -1
  470. package/dist/metric/native/ds-metric.js +26 -16
  471. package/dist/metric/web/ds-metric.d.ts +1 -1
  472. package/dist/metric/web/ds-metric.js +21 -5
  473. package/dist/metric-card/metric-card.d.ts +4 -3
  474. package/dist/metric-card/web/ds-metric-card.d.ts +1 -1
  475. package/dist/metric-card/web/ds-metric-card.js +4 -2
  476. package/dist/month-picker/web/ds-month-picker.js +2 -1
  477. package/dist/month-strip/web/ds-month-strip.js +1 -1
  478. package/dist/motion.d.ts +18 -3
  479. package/dist/motion.js +3 -1
  480. package/dist/multi-select/multi-select.d.ts +39 -9
  481. package/dist/multi-select/multi-select.js +35 -22
  482. package/dist/multi-select/web/ds-multi-select.d.ts +1 -1
  483. package/dist/multi-select/web/ds-multi-select.js +42 -24
  484. package/dist/native.d.ts +12 -0
  485. package/dist/native.js +8 -0
  486. package/dist/notification-list/native/ds-notification-list.d.ts +1 -1
  487. package/dist/notification-list/native/ds-notification-list.js +14 -7
  488. package/dist/notification-list/notification-list.d.ts +2 -1
  489. package/dist/notification-list/web/ds-notification-list.d.ts +1 -1
  490. package/dist/notification-list/web/ds-notification-list.js +10 -4
  491. package/dist/number-field/native/ds-number-field.js +1 -1
  492. package/dist/number-field/web/ds-number-field.js +1 -1
  493. package/dist/otp/native/ds-otp-field.js +3 -21
  494. package/dist/otp/native/ds-otp.js +3 -3
  495. package/dist/otp/otp.d.ts +3 -3
  496. package/dist/otp/web/ds-otp.js +3 -3
  497. package/dist/overflow-menu/web/ds-overflow-menu.js +7 -2
  498. package/dist/page-head/web/ds-page-head.js +2 -2
  499. package/dist/panel/native/ds-panel.js +1 -1
  500. package/dist/panel/panel.d.ts +1 -1
  501. package/dist/panel/web/ds-panel.d.ts +3 -1
  502. package/dist/panel/web/ds-panel.js +3 -2
  503. package/dist/password-feedback/web/ds-password-feedback.d.ts +1 -1
  504. package/dist/password-feedback/web/ds-password-feedback.js +3 -3
  505. package/dist/password-input/web/ds-password-input.d.ts +7 -2
  506. package/dist/password-input/web/ds-password-input.js +28 -3
  507. package/dist/password-requirements/password-requirements.d.ts +12 -2
  508. package/dist/password-requirements/password-requirements.js +6 -8
  509. package/dist/password-requirements/web/ds-password-requirements.js +5 -5
  510. package/dist/password-strength/web/ds-password-strength.js +2 -2
  511. package/dist/payment-card/native/ds-payment-card.d.ts +1 -1
  512. package/dist/payment-card/native/ds-payment-card.js +1 -1
  513. package/dist/payment-card/web/ds-payment-card.d.ts +1 -1
  514. package/dist/payment-card/web/ds-payment-card.js +1 -1
  515. package/dist/people-cell/people-cell.d.ts +5 -2
  516. package/dist/people-cell/web/ds-people-cell.d.ts +1 -1
  517. package/dist/people-cell/web/ds-people-cell.js +6 -2
  518. package/dist/person-cell/person-cell.d.ts +5 -2
  519. package/dist/person-cell/web/ds-person-cell.d.ts +1 -1
  520. package/dist/person-cell/web/ds-person-cell.js +11 -1
  521. package/dist/phone-field/native/ds-phone-field.js +2 -2
  522. package/dist/phone-field/phone-field.d.ts +35 -0
  523. package/dist/phone-field/phone-field.js +38 -0
  524. package/dist/phone-field/web/ds-phone-field.d.ts +31 -3
  525. package/dist/phone-field/web/ds-phone-field.js +45 -8
  526. package/dist/place-card/native/ds-place-card.d.ts +7 -3
  527. package/dist/place-card/native/ds-place-card.js +32 -21
  528. package/dist/place-card/place-card.d.ts +12 -6
  529. package/dist/place-card/place-card.js +6 -3
  530. package/dist/place-card/web/ds-place-card.d.ts +5 -3
  531. package/dist/place-card/web/ds-place-card.js +39 -27
  532. package/dist/plan-chart/plan-chart.d.ts +2 -3
  533. package/dist/plan-chart/web/ds-plan-chart.d.ts +1 -1
  534. package/dist/plan-chart/web/ds-plan-chart.js +34 -6
  535. package/dist/popover/popover.d.ts +7 -3
  536. package/dist/popover/web/ds-popover.d.ts +5 -1
  537. package/dist/popover/web/ds-popover.js +4 -2
  538. package/dist/priority-indicator/native/ds-priority-indicator.js +4 -4
  539. package/dist/priority-indicator/priority-indicator.d.ts +3 -3
  540. package/dist/priority-indicator/priority-indicator.js +3 -3
  541. package/dist/priority-indicator/web/ds-priority-indicator.js +4 -4
  542. package/dist/profile-card/profile-card.d.ts +2 -1
  543. package/dist/profile-card/web/ds-profile-card.d.ts +2 -2
  544. package/dist/profile-card/web/ds-profile-card.js +16 -3
  545. package/dist/progress-bar/native/ds-progress-bar.js +2 -1
  546. package/dist/progress-bar/web/ds-progress-bar.js +2 -1
  547. package/dist/progress-cell/progress-cell.d.ts +8 -3
  548. package/dist/progress-cell/progress-cell.js +1 -1
  549. package/dist/progress-cell/web/ds-progress-cell.d.ts +5 -2
  550. package/dist/progress-cell/web/ds-progress-cell.js +6 -2
  551. package/dist/progress-ring/native/ds-progress-ring.js +16 -11
  552. package/dist/progress-ring/progress-ring.d.ts +8 -4
  553. package/dist/progress-ring/progress-ring.js +7 -3
  554. package/dist/progress-ring/web/ds-progress-ring.js +16 -10
  555. package/dist/proportion-bar/native/ds-proportion-bar.d.ts +2 -2
  556. package/dist/proportion-bar/native/ds-proportion-bar.js +18 -7
  557. package/dist/proportion-bar/proportion-bar.d.ts +10 -3
  558. package/dist/proportion-bar/proportion-bar.js +6 -1
  559. package/dist/proportion-bar/web/ds-proportion-bar.d.ts +1 -1
  560. package/dist/proportion-bar/web/ds-proportion-bar.js +21 -14
  561. package/dist/quick-actions/native/ds-quick-actions.js +17 -2
  562. package/dist/quick-actions/quick-actions.d.ts +32 -2
  563. package/dist/quick-actions/quick-actions.js +9 -1
  564. package/dist/quick-actions/web/ds-quick-actions.js +20 -6
  565. package/dist/radar-chart/radar-chart.d.ts +11 -3
  566. package/dist/radar-chart/radar-chart.js +21 -3
  567. package/dist/radar-chart/web/ds-radar-chart.d.ts +1 -1
  568. package/dist/radar-chart/web/ds-radar-chart.js +34 -22
  569. package/dist/radial-progress/native/ds-radial-progress.d.ts +6 -2
  570. package/dist/radial-progress/native/ds-radial-progress.js +34 -11
  571. package/dist/radial-progress/radial-progress.d.ts +11 -2
  572. package/dist/radial-progress/radial-progress.js +9 -0
  573. package/dist/radial-progress/web/ds-radial-progress.d.ts +6 -2
  574. package/dist/radial-progress/web/ds-radial-progress.js +24 -10
  575. package/dist/radio/radio.d.ts +4 -4
  576. package/dist/radio/radio.js +4 -4
  577. package/dist/radio/web/ds-radio.d.ts +6 -2
  578. package/dist/radio/web/ds-radio.js +22 -10
  579. package/dist/radio-group/radio-group.d.ts +41 -5
  580. package/dist/radio-group/radio-group.js +5 -0
  581. package/dist/radio-group/web/ds-radio-group.d.ts +1 -1
  582. package/dist/radio-group/web/ds-radio-group.js +7 -2
  583. package/dist/rating-badge/rating-badge.d.ts +8 -2
  584. package/dist/rating-badge/rating-badge.js +5 -0
  585. package/dist/rating-badge/web/ds-rating-badge.d.ts +2 -2
  586. package/dist/rating-badge/web/ds-rating-badge.js +6 -4
  587. package/dist/recipient-select/recipient-select.d.ts +7 -0
  588. package/dist/recipient-select/recipient-select.js +3 -0
  589. package/dist/recipient-select/web/ds-recipient-select.js +4 -4
  590. package/dist/record-panel/record-panel.d.ts +17 -2
  591. package/dist/record-panel/web/ds-record-panel.d.ts +48 -13
  592. package/dist/record-panel/web/ds-record-panel.js +27 -18
  593. package/dist/reorder-list/reorder-list.d.ts +3 -0
  594. package/dist/reorder-list/web/ds-reorder-list.d.ts +6 -1
  595. package/dist/reorder-list/web/ds-reorder-list.js +6 -4
  596. package/dist/resend-control/native/ds-resend-control.d.ts +24 -0
  597. package/dist/resend-control/native/ds-resend-control.js +73 -0
  598. package/dist/resend-control/resend-control.d.ts +2 -0
  599. package/dist/resend-control/resend-control.js +2 -0
  600. package/dist/resend-control/web/ds-resend-control.js +3 -3
  601. package/dist/route-fields/route-fields.d.ts +79 -0
  602. package/dist/route-fields/route-fields.js +71 -0
  603. package/dist/route-fields/web/ds-route-fields.d.ts +5 -0
  604. package/dist/route-fields/web/ds-route-fields.js +83 -0
  605. package/dist/route-line/web/ds-route-line.js +2 -2
  606. package/dist/save-bar/save-bar.d.ts +1 -1
  607. package/dist/save-bar/save-bar.js +1 -1
  608. package/dist/save-bar/web/ds-save-bar.js +2 -2
  609. package/dist/scanner/scanner.d.ts +1 -1
  610. package/dist/scanner/scanner.js +2 -1
  611. package/dist/scatter-chart/scatter-chart.d.ts +2 -3
  612. package/dist/scatter-chart/web/ds-scatter-chart.d.ts +1 -1
  613. package/dist/scatter-chart/web/ds-scatter-chart.js +13 -4
  614. package/dist/schedule-chart/schedule-chart.d.ts +187 -0
  615. package/dist/schedule-chart/schedule-chart.js +285 -0
  616. package/dist/schedule-chart/web/ds-schedule-chart.d.ts +24 -0
  617. package/dist/schedule-chart/web/ds-schedule-chart.js +143 -0
  618. package/dist/segmented-control/native/ds-segmented-control.d.ts +1 -1
  619. package/dist/segmented-control/native/ds-segmented-control.js +1 -1
  620. package/dist/segmented-control/segmented-control.d.ts +7 -0
  621. package/dist/segmented-control/web/ds-segmented-control.d.ts +1 -1
  622. package/dist/segmented-control/web/ds-segmented-control.js +4 -3
  623. package/dist/select/native/ds-select.js +6 -3
  624. package/dist/select/select.d.ts +5 -0
  625. package/dist/select/web/ds-select.d.ts +14 -1
  626. package/dist/select/web/ds-select.js +22 -12
  627. package/dist/settings-directory/native/ds-settings-directory.js +1 -1
  628. package/dist/settings-directory/web/ds-settings-directory.js +1 -1
  629. package/dist/settings-row/web/ds-settings-row.d.ts +3 -1
  630. package/dist/settings-row/web/ds-settings-row.js +2 -2
  631. package/dist/sheet/web/ds-sheet.js +3 -3
  632. package/dist/side-nav/side-nav.d.ts +2 -1
  633. package/dist/side-nav/web/ds-side-nav-collapse.d.ts +4 -1
  634. package/dist/side-nav/web/ds-side-nav-collapse.js +6 -3
  635. package/dist/side-nav/web/ds-side-nav-header.js +1 -1
  636. package/dist/side-nav/web/ds-side-nav-primary.js +1 -1
  637. package/dist/side-nav/web/ds-side-nav-profile.js +1 -1
  638. package/dist/side-nav/web/ds-side-nav.d.ts +1 -1
  639. package/dist/side-nav/web/ds-side-nav.js +3 -3
  640. package/dist/skeleton/skeleton.d.ts +20 -0
  641. package/dist/skeleton/skeleton.js +4 -0
  642. package/dist/slider/native/ds-slider.js +1 -1
  643. package/dist/small-multiples/small-multiples.d.ts +3 -4
  644. package/dist/small-multiples/small-multiples.js +2 -1
  645. package/dist/small-multiples/web/ds-small-multiples.d.ts +1 -1
  646. package/dist/small-multiples/web/ds-small-multiples.js +8 -2
  647. package/dist/sparkline/sparkline.d.ts +19 -7
  648. package/dist/sparkline/sparkline.js +42 -17
  649. package/dist/sparkline/web/ds-sparkline.d.ts +1 -1
  650. package/dist/sparkline/web/ds-sparkline.js +4 -3
  651. package/dist/split-pane/web/ds-split-pane.js +2 -2
  652. package/dist/stat-tile/native/ds-stat-tile.d.ts +3 -3
  653. package/dist/stat-tile/native/ds-stat-tile.js +14 -7
  654. package/dist/stat-tile/stat-tile.d.ts +14 -8
  655. package/dist/stat-tile/web/ds-stat-tile.d.ts +4 -2
  656. package/dist/stat-tile/web/ds-stat-tile.js +8 -5
  657. package/dist/state-message/web/ds-state-message.d.ts +6 -2
  658. package/dist/state-message/web/ds-state-message.js +5 -2
  659. package/dist/status-badge/native/ds-status-badge.js +3 -3
  660. package/dist/status-badge/status-badge.d.ts +3 -3
  661. package/dist/status-badge/status-badge.js +1 -1
  662. package/dist/status-badge/web/ds-status-badge.js +4 -4
  663. package/dist/status-cell/status-cell.d.ts +5 -2
  664. package/dist/status-cell/web/ds-status-cell.d.ts +6 -2
  665. package/dist/status-cell/web/ds-status-cell.js +7 -2
  666. package/dist/status-control/web/ds-status-control.js +3 -3
  667. package/dist/status-dot/native/ds-status-dot.js +1 -1
  668. package/dist/status-dot/status-dot.d.ts +2 -2
  669. package/dist/status-dot/status-dot.js +2 -2
  670. package/dist/status-dot/web/ds-status-dot.js +2 -2
  671. package/dist/stepper-form/stepper-form.d.ts +27 -4
  672. package/dist/stepper-form/stepper-form.js +17 -9
  673. package/dist/stepper-form/web/ds-stepper-form.d.ts +1 -1
  674. package/dist/stepper-form/web/ds-stepper-form.js +7 -5
  675. package/dist/stick-chart/stick-chart.d.ts +2 -1
  676. package/dist/stick-chart/stick-chart.js +2 -1
  677. package/dist/stick-chart/web/ds-stick-chart.d.ts +1 -1
  678. package/dist/stick-chart/web/ds-stick-chart.js +17 -3
  679. package/dist/switch/native/ds-switch.js +1 -1
  680. package/dist/system-state/native/ds-system-state.d.ts +29 -0
  681. package/dist/system-state/native/ds-system-state.js +68 -0
  682. package/dist/system-state/system-state.js +4 -3
  683. package/dist/system-state/web/ds-system-state.js +2 -2
  684. package/dist/table-toolbar/web/ds-table-toolbar.js +1 -1
  685. package/dist/tabs/tabs.d.ts +5 -0
  686. package/dist/tabs/tabs.js +2 -0
  687. package/dist/tabs/web/ds-tabs.js +2 -2
  688. package/dist/task-shell/task-shell.d.ts +15 -6
  689. package/dist/task-shell/task-shell.js +5 -2
  690. package/dist/task-shell/web/ds-task-shell.d.ts +21 -6
  691. package/dist/task-shell/web/ds-task-shell.js +52 -18
  692. package/dist/text/native/ds-text.js +1 -1
  693. package/dist/text/text.d.ts +1 -1
  694. package/dist/text/text.js +1 -1
  695. package/dist/text/web/ds-text.js +1 -1
  696. package/dist/textarea/native/ds-textarea.d.ts +1 -1
  697. package/dist/textarea/native/ds-textarea.js +9 -8
  698. package/dist/textarea/web/ds-textarea.d.ts +1 -1
  699. package/dist/textarea/web/ds-textarea.js +8 -7
  700. package/dist/time-field/time-field.d.ts +37 -0
  701. package/dist/time-field/time-field.js +23 -0
  702. package/dist/time-field/web/ds-time-field.d.ts +8 -0
  703. package/dist/time-field/web/ds-time-field.js +28 -0
  704. package/dist/time-range/time-range.d.ts +35 -26
  705. package/dist/time-range/time-range.js +28 -46
  706. package/dist/time-range/web/ds-time-range.d.ts +1 -1
  707. package/dist/time-range/web/ds-time-range.js +9 -6
  708. package/dist/timeline/native/ds-timeline.d.ts +2 -2
  709. package/dist/timeline/native/ds-timeline.js +21 -7
  710. package/dist/timeline/timeline.d.ts +2 -1
  711. package/dist/timeline/web/ds-timeline.d.ts +2 -2
  712. package/dist/timeline/web/ds-timeline.js +18 -9
  713. package/dist/toast/native/ds-toast.js +1 -1
  714. package/dist/toggle-group/native/ds-toggle-group.js +1 -1
  715. package/dist/token-roles.d.ts +1 -1
  716. package/dist/token-roles.js +18 -0
  717. package/dist/tone.d.ts +4 -4
  718. package/dist/tone.js +1 -5
  719. package/dist/toolbar/toolbar.d.ts +19 -7
  720. package/dist/toolbar/toolbar.js +4 -3
  721. package/dist/toolbar/web/ds-toolbar.d.ts +5 -2
  722. package/dist/toolbar/web/ds-toolbar.js +3 -3
  723. package/dist/track-bars/track-bars.d.ts +3 -4
  724. package/dist/track-bars/web/ds-track-bars.d.ts +1 -1
  725. package/dist/track-bars/web/ds-track-bars.js +9 -3
  726. package/dist/tree/tree.d.ts +1 -1
  727. package/dist/tree/tree.js +1 -1
  728. package/dist/tree/web/ds-tree.js +2 -2
  729. package/dist/treemap/treemap.d.ts +2 -3
  730. package/dist/treemap/web/ds-treemap.d.ts +1 -1
  731. package/dist/treemap/web/ds-treemap.js +14 -3
  732. package/dist/two-line-cell/two-line-cell.d.ts +5 -2
  733. package/dist/two-line-cell/web/ds-two-line-cell.d.ts +1 -1
  734. package/dist/two-line-cell/web/ds-two-line-cell.js +5 -1
  735. package/dist/vehicle-marker/vehicle-marker.d.ts +5 -4
  736. package/dist/vehicle-marker/vehicle-marker.js +3 -3
  737. package/dist/vehicle-marker/web/ds-vehicle-marker.js +9 -6
  738. package/dist/waterfall-chart/waterfall-chart.d.ts +10 -5
  739. package/dist/waterfall-chart/waterfall-chart.js +17 -12
  740. package/dist/waterfall-chart/web/ds-waterfall-chart.d.ts +7 -2
  741. package/dist/waterfall-chart/web/ds-waterfall-chart.js +49 -11
  742. package/dist/web.d.ts +20 -5
  743. package/dist/web.js +10 -2
  744. package/dist/week-schedule/web/ds-week-schedule.d.ts +1 -1
  745. package/dist/week-schedule/web/ds-week-schedule.js +4 -4
  746. package/dist/week-schedule/week-schedule.d.ts +23 -4
  747. package/dist/week-schedule/week-schedule.js +19 -13
  748. package/forced-colors.css +8 -5
  749. package/package.json +10 -15
@@ -2,8 +2,8 @@ import { CHART_HUES } from '../lib/chart-hue';
2
2
  import { chartCurveSegments } from '../lib/chart-curve';
3
3
  import { formatChartValue } from '../lib/chart-value';
4
4
  import { CHART_GLYPH_PX, clean, niceStep } from '../lib/chart-ticks';
5
- export { CHART_AXIS_GAP_PX, CHART_GLYPH_PX, axisGutter } from '../lib/chart-ticks';
6
- export const CHART_KINDS = ['line', 'bar', 'grouped-bar', 'stacked-area'];
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
7
  import { CHART_MAX_SERIES } from '../lib/chart-series';
8
8
  export { CHART_MAX_SERIES };
9
9
  export const CHART_FILL_PATTERNS = ['solid', 'hatch', 'dots', 'cross'];
@@ -64,17 +64,65 @@ export const CHART_BODY_HEIGHT_STEP = 80;
64
64
  export const CHART_AXIS_BAND_PX = 24;
65
65
  export const CHART_TOP_PAD_PX = 8;
66
66
  export const CHART_RIGHT_PAD_PX = 8;
67
- export const CHART_MIN_LABEL_SPACING_PX = 44;
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
+ }
68
103
  export const CHART_CATEGORY_BASELINE_PX = 6;
69
- export const CHART_THIN_BAR_PX = 6;
70
104
  export const CHART_TICK_TARGET = 4;
71
105
  function readings(series) {
72
106
  return series.flatMap((s) => s.values.filter((v) => v !== null && Number.isFinite(v)));
73
107
  }
74
- export function chartScale(series, target = CHART_TICK_TARGET, reach = []) {
75
- const values = [...readings(series), ...reach.filter((v) => Number.isFinite(v))];
76
- let lo = Math.min(0, ...values);
77
- let hi = Math.max(0, ...values);
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
+ ];
115
+ }
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;
78
126
  if (lo === hi) {
79
127
  hi = lo + 1;
80
128
  }
@@ -87,24 +135,20 @@ export function chartScale(series, target = CHART_TICK_TARGET, reach = []) {
87
135
  ticks.push(clean(lo + i * step, step));
88
136
  return { min: lo, max: hi, step, ticks };
89
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
+ }
90
143
  export function valueY(value, scale, height) {
91
144
  const span = scale.max - scale.min;
92
145
  return height - ((value - scale.min) / span) * height;
93
146
  }
94
- const GROUP_SHARE = 0.7;
95
- const BAR_GAP_PX = 2;
96
- export function bandLayout(categoryCount, seriesCount, width) {
147
+ export function bandLayout(categoryCount, width) {
97
148
  const band = width / Math.max(1, categoryCount);
98
- const bars = Math.max(1, seriesCount);
99
- const group = band * GROUP_SHARE;
100
- const gap = bars > 1 ? BAR_GAP_PX : 0;
101
- const barWidth = Math.max(1, (group - gap * (bars - 1)) / bars);
102
- const inset = (band - (barWidth * bars + gap * (bars - 1))) / 2;
103
149
  return {
104
150
  band,
105
- barWidth,
106
151
  centre: (index) => index * band + band / 2,
107
- barX: (index, series) => index * band + inset + series * (barWidth + gap),
108
152
  };
109
153
  }
110
154
  export function chartCategoryAt(x, band, count) {
@@ -123,7 +167,7 @@ export function chartCategoryStep(current, step, count) {
123
167
  return step < 0 ? count - 1 : 0;
124
168
  return Math.min(count - 1, Math.max(0, current + step));
125
169
  }
126
- export function chartSeriesPaths(values, x, y, baseline) {
170
+ export function chartSeriesPaths(values, x, y, baseline, projectFrom) {
127
171
  const runs = [];
128
172
  let run = [];
129
173
  const close = () => {
@@ -138,59 +182,93 @@ export function chartSeriesPaths(values, x, y, baseline) {
138
182
  run.push({ index, point: [round2(x(index)), round2(y(value))] });
139
183
  }
140
184
  close();
185
+ const split = projectFrom !== undefined && Number.isFinite(projectFrom) ? projectFrom : undefined;
141
186
  let line = '';
142
187
  let area = '';
188
+ let projection = '';
189
+ let end;
143
190
  const lone = [];
191
+ const add = (current, d) => `${current}${current === '' ? '' : ' '}${d}`;
192
+ const pointOf = (p) => `${String(p.point[0])},${String(p.point[1])}`;
144
193
  for (const points of runs) {
145
194
  const first = points[0];
146
195
  const last = points.at(-1);
147
196
  if (first === undefined || last === undefined)
148
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;
149
202
  if (points.length === 1) {
150
203
  lone.push(first.index);
151
204
  continue;
152
205
  }
153
- const d = `M${String(first.point[0])},${String(first.point[1])} ${chartCurveSegments(points.map((p) => p.point)).join(' ')}`;
154
- line += `${line === '' ? '' : ' '}${d}`;
155
- area += `${area === '' ? '' : ' '}${d} L${String(last.point[0])},${String(baseline)} L${String(first.point[0])},${String(baseline)} 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
+ }
218
+ }
219
+ return { line, area, lone, projection, end };
220
+ }
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)))] });
156
238
  }
157
- return { line, area, lone };
158
- }
159
- export const CHART_BAR_RADIUS_PX = 6;
160
- export const CHART_BAR_EDGE_PX = 3;
161
- export function chartBarRadius(width, length) {
162
- return Math.max(0, Math.min(width / 2, CHART_BAR_RADIUS_PX, length));
163
- }
164
- export function chartBarPath(x, y, width, length, up) {
165
- if (!(width > 0) || !(length > 0))
166
- return '';
167
- const r = round2(chartBarRadius(width, length));
168
- const right = round2(x + width);
169
- const bottom = round2(y + length);
170
- if (up) {
171
- 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`;
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(' ');
252
+ }
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
+ }
172
270
  }
173
- 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`;
174
- }
175
- export function chartBarEdgePath(x, y, width, length, up, inset) {
176
- if (!(width > 0) || !(length > 0))
177
- return '';
178
- const i = Math.min(inset, width / 2, length / 2);
179
- const r = Math.max(0, round2(chartBarRadius(width, length) - i));
180
- const [left, right] = [round2(x + i), round2(x + width - i)];
181
- const end = up ? round2(y + i) : round2(y + length - i);
182
- const toward = up ? 1 : -1;
183
- return `M${String(left)},${String(round2(end + toward * r))} Q${String(left)},${String(end)} ${String(round2(left + r))},${String(end)} H${String(round2(right - r))} Q${String(right)},${String(end)} ${String(right)},${String(round2(end + toward * r))}`;
184
- }
185
- export function labelStride(categoryCount, plotWidth, minSpacing = CHART_MIN_LABEL_SPACING_PX) {
186
- if (categoryCount <= 0 || plotWidth <= 0)
187
- return 1;
188
- const band = plotWidth / categoryCount;
189
- return Math.max(1, Math.ceil(minSpacing / band));
190
- }
191
- export function categorySpacing(categories) {
192
- const widest = Math.max(0, ...categories.map((category) => category.length));
193
- return Math.max(CHART_MIN_LABEL_SPACING_PX, widest * CHART_GLYPH_PX + 12);
271
+ return { low, high };
194
272
  }
195
273
  export function allSeries(categories, series) {
196
274
  return series.map((s) => ({
@@ -200,6 +278,7 @@ export function allSeries(categories, series) {
200
278
  const value = s.values[i];
201
279
  return value === undefined || value === null || !Number.isFinite(value) ? null : value;
202
280
  }),
281
+ ...(s.comparison !== true && s.band !== undefined ? { band: cleanBand(categories, s.band) } : {}),
203
282
  }));
204
283
  }
205
284
  export function visibleSeries(categories, series) {
@@ -216,17 +295,46 @@ export function isChartEmpty(categories, series) {
216
295
  export function chartSeriesCapIssue(count) {
217
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.`;
218
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
+ }
219
332
  export function chartIssues(chart) {
220
333
  const issues = [];
221
334
  const { kind, categories, series } = chart;
335
+ issues.push(...chartForecastIssues(chart));
222
336
  if (series.length > CHART_MAX_SERIES)
223
337
  issues.push(chartSeriesCapIssue(series.length));
224
- if (kind === 'bar' && series.length > 1) {
225
- issues.push('A bar chart takes one series. Use grouped-bar to compare several.');
226
- }
227
- if (kind === 'grouped-bar' && series.length < 2) {
228
- issues.push('A grouped bar chart compares two series or more. Use bar for one.');
229
- }
230
338
  if (kind === 'stacked-area' && series.length < 2) {
231
339
  issues.push('A stacked area shows a whole made of parts. Use line for one series.');
232
340
  }
@@ -251,12 +359,11 @@ export function chartIssues(chart) {
251
359
  export { formatChartValue };
252
360
  const KIND_WORDS = {
253
361
  line: 'Line chart',
254
- bar: 'Bar chart',
255
- 'grouped-bar': 'Grouped bar chart',
256
362
  'stacked-area': 'Stacked area chart',
257
363
  };
258
- export function describeChart(chart, format = formatChartValue) {
364
+ export function describeChart(chart, format = formatChartValue, formatRange = chartBandRangeDefault, formatForecast) {
259
365
  const { kind, categories } = chart;
366
+ const split = chartProjectionIndex(chart.projectFrom, categories.length);
260
367
  const series = visibleSeries(categories, chart.series);
261
368
  const first = categories[0];
262
369
  const last = categories[categories.length - 1];
@@ -268,8 +375,9 @@ export function describeChart(chart, format = formatChartValue) {
268
375
  let h = null;
269
376
  let l = null;
270
377
  let readingCount = 0;
378
+ const projects = split !== undefined && s.comparison !== true;
271
379
  for (const [i, value] of s.values.entries()) {
272
- if (value === null)
380
+ if (value === null || (projects && i >= split))
273
381
  continue;
274
382
  readingCount++;
275
383
  const at = categories[i] ?? '';
@@ -291,9 +399,90 @@ export function describeChart(chart, format = formatChartValue) {
291
399
  else {
292
400
  sentences.push(`${s.label}: highest ${format(h.value)} in ${h.at}, lowest ${format(l.value)} in ${l.at}.`);
293
401
  }
402
+ sentences.push(...describeForecast(s, categories, chart, split, format, formatRange, formatForecast));
294
403
  }
295
404
  return sentences.join(' ');
296
405
  }
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;
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
+ }
297
486
  export { tableToggleLabel } from '../lib/chart-table';
298
487
  export const CHART_TREND_KIND = 'trend';
299
488
  export const CHART_VIEWBOX = { width: 100, height: 100 };
@@ -322,6 +511,7 @@ export function chartTrendSpec({ values, projectFrom, series = 1, compare = [],
322
511
  return {
323
512
  empty: true,
324
513
  max: 0,
514
+ zero: TREND_BOTTOM,
325
515
  last: undefined,
326
516
  line: '',
327
517
  area: '',
@@ -332,6 +522,7 @@ export function chartTrendSpec({ values, projectFrom, series = 1, compare = [],
332
522
  curveProjection: '',
333
523
  lastY: 0,
334
524
  points: [],
525
+ lone: [],
335
526
  head: undefined,
336
527
  series,
337
528
  compare: '',
@@ -339,72 +530,95 @@ export function chartTrendSpec({ values, projectFrom, series = 1, compare = [],
339
530
  };
340
531
  }
341
532
  const max = Math.max(0, ...finite, ...before.map(({ v }) => v));
342
- const lastIndex = finite.length - 1;
343
- const span = before.length > 0 ? Math.max(values.length, compare.length) - 1 : undefined;
344
- const at = (index) => (span === 0 ? TREND_WIDTH : round2((index / (span ?? 1)) * TREND_WIDTH));
345
- const x = (i) => span !== undefined
346
- ? at(kept[i]?.index ?? i)
347
- : lastIndex === 0
348
- ? TREND_WIDTH
349
- : round2((i / lastIndex) * TREND_WIDTH);
350
- const y = (v) => max === 0
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
351
537
  ? TREND_BOTTOM
352
- : round2(TREND_BOTTOM - (Math.max(0, v) / max) * (TREND_BOTTOM - TREND_TOP));
353
- const points = finite.map((v, i) => [x(i), y(v)]);
354
- const only = points.at(0) ?? [0, TREND_BOTTOM];
355
- const drawn = points.length === 1 ? [[0, only[1]], only] : points;
356
- const split = projectFrom !== undefined && projectFrom > 0 && projectFrom < drawn.length
357
- ? projectFrom
358
- : undefined;
359
- const measured = split === undefined ? drawn : drawn.slice(0, split);
360
- const projected = split === undefined ? [] : drawn.slice(split - 1);
361
- const first = measured.at(0) ?? only;
362
- const lastDrawn = measured.at(-1) ?? only;
363
- const end = drawn.at(-1) ?? only;
364
- const segments = chartCurveSegments(drawn);
365
- const cut = split === undefined ? segments.length : split - 1;
366
- const move = ([px, py]) => `M${String(px)},${String(py)}`;
367
- const curve = `${move(first)}${segments
368
- .slice(0, cut)
369
- .map((c) => ` ${c}`)
370
- .join('')}`;
371
- const projectionStart = drawn[cut] ?? lastDrawn;
372
- const placed = kept.map(({ v, index }, i) => {
373
- const [px, py] = points[i] ?? only;
374
- return { x: px, y: py, value: v, index };
375
- });
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)]);
376
557
  const comparePoints = before.map(({ v, index }) => ({ x: at(index), y: y(v), value: v, index }));
377
- const compareDrawn = comparePoints.map((p) => [p.x, p.y]);
378
558
  const compareFirst = compareDrawn.at(0);
379
559
  const compareCurve = compareDrawn.length > 1 && compareFirst !== undefined
380
- ? `${move(compareFirst)}${chartCurveSegments(compareDrawn)
560
+ ? `M${String(compareFirst[0])},${String(compareFirst[1])}${chartCurveSegments(compareDrawn)
381
561
  .map((c) => ` ${c}`)
382
562
  .join('')}`
383
563
  : '';
564
+ const lastPlaced = placed.at(-1);
565
+ const measuredHead = split === undefined ? lastPlaced : [...placed].reverse().find((p) => p.index < split);
384
566
  return {
385
567
  empty: false,
386
568
  max,
569
+ zero: y(0),
387
570
  last: finite.at(-1),
388
- line: pointsToPath(measured),
389
- area: `${pointsToPath(measured)} L${String(lastDrawn[0])},${String(TREND_BOTTOM)} L${String(first[0])},${String(TREND_BOTTOM)} Z`,
390
- projection: projected.length > 1 ? pointsToPath(projected) : '',
391
- curve,
392
- curveArea: `${curve} L${String(lastDrawn[0])},${String(TREND_BOTTOM)} L${String(first[0])},${String(TREND_BOTTOM)} Z`,
393
- curveBleed: `${curve} L${String(lastDrawn[0])},${String(TREND_HEIGHT)} L${String(first[0])},${String(TREND_HEIGHT)} Z`,
394
- curveProjection: projected.length > 1
395
- ? `${move(projectionStart)}${segments
396
- .slice(cut)
397
- .map((c) => ` ${c}`)
398
- .join('')}`
399
- : '',
400
- 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,
401
579
  points: placed,
402
- 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,
403
582
  series,
404
583
  compare: compareCurve,
405
584
  comparePoints,
406
585
  };
407
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
+ }
408
622
  export { chartCurveSegments } from '../lib/chart-curve';
409
623
  export function chartNearest(points, fraction) {
410
624
  const target = Math.min(1, Math.max(0, fraction)) * TREND_WIDTH;
@@ -424,9 +638,44 @@ export function chartStep(points, from, step) {
424
638
  const next = Math.min(points.length - 1, Math.max(0, (at === -1 ? 0 : at) + step));
425
639
  return points[next];
426
640
  }
427
- export function describeMarks(references, events, categories, formatValue) {
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)}`;
428
673
  const said = [
429
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
+ : []),
430
679
  ...events.flatMap((e) => (categories[e.index] === undefined ? [] : [`${e.label}, ${categories[e.index] ?? ''}.`])),
431
680
  ];
432
681
  return said.join(' ');