@tfn-design/design-system 0.3.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (751) hide show
  1. package/README.md +2 -2
  2. package/dist/accordion/accordion.d.ts +1 -1
  3. package/dist/accordion/accordion.js +1 -1
  4. package/dist/accordion/web/ds-accordion.js +5 -4
  5. package/dist/account-password-field/account-password-field.js +1 -1
  6. package/dist/account-switcher/account-switcher.d.ts +11 -4
  7. package/dist/account-switcher/account-switcher.js +2 -1
  8. package/dist/account-switcher/web/ds-account-switcher.js +12 -4
  9. package/dist/ai-attachment/ai-attachment.d.ts +1 -1
  10. package/dist/ai-attachment/ai-attachment.js +1 -1
  11. package/dist/ai-attachment/web/ds-ai-attachment.js +1 -1
  12. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.js +2 -2
  13. package/dist/ai-composer/ai-composer.d.ts +1 -1
  14. package/dist/ai-composer/ai-composer.js +1 -1
  15. package/dist/ai-composer/native/ds-ai-composer.js +4 -2
  16. package/dist/ai-composer/web/ds-ai-composer.js +2 -3
  17. package/dist/ai-confirmation/ai-confirmation.d.ts +19 -3
  18. package/dist/ai-confirmation/ai-confirmation.js +18 -3
  19. package/dist/ai-confirmation/native/ds-ai-confirmation.js +18 -13
  20. package/dist/ai-confirmation/web/ds-ai-confirmation.d.ts +1 -1
  21. package/dist/ai-confirmation/web/ds-ai-confirmation.js +22 -11
  22. package/dist/ai-context-scope/ai-context-scope.d.ts +10 -2
  23. package/dist/ai-context-scope/ai-context-scope.js +11 -2
  24. package/dist/ai-context-scope/native/ds-ai-context-scope.js +4 -3
  25. package/dist/ai-context-scope/web/ds-ai-context-scope.js +19 -5
  26. package/dist/ai-conversation-list/ai-conversation-list.d.ts +16 -0
  27. package/dist/ai-conversation-list/ai-conversation-list.js +8 -0
  28. package/dist/ai-conversation-list/web/ds-ai-conversation-list.d.ts +10 -6
  29. package/dist/ai-conversation-list/web/ds-ai-conversation-list.js +89 -47
  30. package/dist/ai-diff/ai-diff.d.ts +13 -1
  31. package/dist/ai-diff/ai-diff.js +12 -1
  32. package/dist/ai-diff/native/ds-ai-diff.d.ts +1 -1
  33. package/dist/ai-diff/native/ds-ai-diff.js +4 -6
  34. package/dist/ai-diff/web/ds-ai-diff.d.ts +0 -4
  35. package/dist/ai-diff/web/ds-ai-diff.js +16 -9
  36. package/dist/ai-draft-panel/ai-draft-panel.d.ts +2 -0
  37. package/dist/ai-draft-panel/ai-draft-panel.js +5 -0
  38. package/dist/ai-draft-panel/web/ds-ai-draft-panel.d.ts +3 -1
  39. package/dist/ai-draft-panel/web/ds-ai-draft-panel.js +4 -4
  40. package/dist/ai-empty-state/native/ds-ai-empty-state.js +2 -2
  41. package/dist/ai-empty-state/web/ds-ai-empty-state.js +3 -1
  42. package/dist/ai-error-state/ai-error-state.d.ts +2 -2
  43. package/dist/ai-error-state/ai-error-state.js +2 -2
  44. package/dist/ai-error-state/native/ds-ai-error-state.d.ts +5 -1
  45. package/dist/ai-error-state/native/ds-ai-error-state.js +2 -1
  46. package/dist/ai-error-state/web/ds-ai-error-state.d.ts +5 -1
  47. package/dist/ai-error-state/web/ds-ai-error-state.js +3 -2
  48. package/dist/ai-label/native/ds-ai-label.js +2 -1
  49. package/dist/ai-label/web/ds-ai-label.js +1 -1
  50. package/dist/ai-message/ai-message.d.ts +1 -1
  51. package/dist/ai-message/ai-message.js +1 -1
  52. package/dist/ai-message/native/ds-ai-message.js +4 -3
  53. package/dist/ai-message/web/ds-ai-message-markdown.js +3 -3
  54. package/dist/ai-message/web/ds-ai-message.js +4 -3
  55. package/dist/ai-message-actions/ai-message-actions.d.ts +1 -1
  56. package/dist/ai-message-actions/ai-message-actions.js +1 -1
  57. package/dist/ai-message-actions/native/ds-ai-message-actions.js +1 -1
  58. package/dist/ai-message-actions/web/ds-ai-message-actions.js +1 -1
  59. package/dist/ai-plan/ai-plan.d.ts +1 -1
  60. package/dist/ai-plan/ai-plan.js +1 -1
  61. package/dist/ai-plan/web/ds-ai-plan.js +2 -2
  62. package/dist/ai-side-nav/web/ds-ai-side-nav.js +4 -3
  63. package/dist/ai-summary-card/native/ds-ai-summary-card.js +2 -1
  64. package/dist/ai-summary-card/web/ds-ai-summary-card.js +2 -1
  65. package/dist/ai-thread/web/ds-ai-thread.js +1 -1
  66. package/dist/ai-tool-call/ai-tool-call.d.ts +1 -1
  67. package/dist/ai-tool-call/ai-tool-call.js +1 -1
  68. package/dist/ai-tool-call/native/ds-ai-tool-call.js +3 -2
  69. package/dist/ai-tool-call/web/ds-ai-tool-call.js +4 -3
  70. package/dist/alert/native/ds-alert.js +4 -4
  71. package/dist/alert/web/ds-alert.js +5 -5
  72. package/dist/ambient-gradient/ambient-gradient.d.ts +1 -1
  73. package/dist/amount/amount.d.ts +1 -1
  74. package/dist/amount/amount.js +3 -2
  75. package/dist/amount/native/ds-amount.js +1 -1
  76. package/dist/amount/web/ds-amount.js +1 -1
  77. package/dist/amount-cell/amount-cell.d.ts +5 -2
  78. package/dist/amount-cell/web/ds-amount-cell.d.ts +1 -1
  79. package/dist/amount-cell/web/ds-amount-cell.js +7 -1
  80. package/dist/amount-entry/amount-entry.d.ts +28 -2
  81. package/dist/amount-entry/amount-entry.js +19 -12
  82. package/dist/amount-entry/native/ds-amount-entry.d.ts +1 -1
  83. package/dist/amount-entry/native/ds-amount-entry.js +5 -4
  84. package/dist/amount-entry/web/ds-amount-entry.d.ts +1 -1
  85. package/dist/amount-entry/web/ds-amount-entry.js +5 -4
  86. package/dist/app-shell/app-shell.d.ts +2 -0
  87. package/dist/app-shell/web/ds-app-shell.js +26 -3
  88. package/dist/approval-chain/approval-chain.d.ts +6 -2
  89. package/dist/approval-chain/approval-chain.js +4 -4
  90. package/dist/approval-chain/native/ds-approval-chain.js +16 -9
  91. package/dist/approval-chain/web/ds-approval-chain.d.ts +7 -1
  92. package/dist/approval-chain/web/ds-approval-chain.js +12 -11
  93. package/dist/auth-shell/web/ds-auth-shell.d.ts +5 -1
  94. package/dist/auth-shell/web/ds-auth-shell.js +5 -2
  95. package/dist/balance-header/balance-header.d.ts +8 -4
  96. package/dist/balance-header/native/ds-balance-header.d.ts +3 -3
  97. package/dist/balance-header/native/ds-balance-header.js +11 -4
  98. package/dist/balance-header/web/ds-balance-header.d.ts +1 -1
  99. package/dist/balance-header/web/ds-balance-header.js +7 -4
  100. package/dist/bar-chart/bar-chart.d.ts +46 -5
  101. package/dist/bar-chart/bar-chart.js +64 -6
  102. package/dist/bar-chart/web/ds-bar-chart.d.ts +21 -4
  103. package/dist/bar-chart/web/ds-bar-chart.js +121 -50
  104. package/dist/bottom-nav/bottom-nav.d.ts +8 -3
  105. package/dist/bottom-nav/bottom-nav.js +2 -2
  106. package/dist/bottom-nav/web/ds-bottom-nav.js +2 -2
  107. package/dist/box-plot/box-plot.d.ts +150 -0
  108. package/dist/box-plot/box-plot.js +124 -0
  109. package/dist/box-plot/web/ds-box-plot.d.ts +8 -0
  110. package/dist/box-plot/web/ds-box-plot.js +57 -0
  111. package/dist/brand-lockup/native/ds-brand-lockup.js +1 -1
  112. package/dist/brand-provider/brand-provider.d.ts +29 -0
  113. package/dist/brand-provider/brand-provider.js +9 -0
  114. package/dist/brand-provider/native/ds-brand-provider.d.ts +11 -0
  115. package/dist/brand-provider/native/ds-brand-provider.js +18 -0
  116. package/dist/brand-provider/web/ds-brand-provider.d.ts +10 -0
  117. package/dist/brand-provider/web/ds-brand-provider.js +20 -0
  118. package/dist/bullet-chart/bullet-chart.d.ts +12 -7
  119. package/dist/bullet-chart/bullet-chart.js +5 -4
  120. package/dist/bullet-chart/web/ds-bullet-chart.d.ts +1 -1
  121. package/dist/bullet-chart/web/ds-bullet-chart.js +9 -4
  122. package/dist/button/button.d.ts +1 -1
  123. package/dist/button/native/ds-button.js +2 -2
  124. package/dist/button/web/ds-button.js +1 -1
  125. package/dist/button-group/button-group.d.ts +1 -1
  126. package/dist/button-group/web/ds-button-group.d.ts +2 -2
  127. package/dist/calendar/calendar.d.ts +13 -2
  128. package/dist/calendar/calendar.js +4 -3
  129. package/dist/calendar/web/ds-calendar.d.ts +1 -1
  130. package/dist/calendar/web/ds-calendar.js +6 -5
  131. package/dist/card-carousel/native/ds-card-carousel.js +1 -1
  132. package/dist/card-carousel/web/ds-card-carousel.js +2 -2
  133. package/dist/chart/chart.d.ts +180 -64
  134. package/dist/chart/chart.js +367 -118
  135. package/dist/chart/web/ds-chart.d.ts +17 -7
  136. package/dist/chart/web/ds-chart.js +85 -108
  137. package/dist/check-option/check-option.d.ts +1 -1
  138. package/dist/check-option/check-option.js +1 -1
  139. package/dist/check-option/web/ds-check-option.d.ts +6 -1
  140. package/dist/check-option/web/ds-check-option.js +10 -6
  141. package/dist/checkbox/checkbox.d.ts +2 -2
  142. package/dist/checkbox/checkbox.js +2 -2
  143. package/dist/checkbox/native/ds-checkbox.js +1 -1
  144. package/dist/checkbox/web/checkbox-mark.js +1 -1
  145. package/dist/checkbox/web/ds-checkbox.d.ts +2 -2
  146. package/dist/checkbox/web/ds-checkbox.js +17 -6
  147. package/dist/chip/chip.d.ts +11 -11
  148. package/dist/chip/chip.js +5 -3
  149. package/dist/chip/native/ds-chip.js +1 -1
  150. package/dist/chip/web/ds-chip.js +6 -6
  151. package/dist/code-block/web/ds-code-block.js +3 -3
  152. package/dist/column-picker/web/ds-column-picker.js +2 -1
  153. package/dist/combobox/combobox.d.ts +2 -2
  154. package/dist/combobox/web/ds-combobox.js +4 -2
  155. package/dist/command-palette/command-palette.d.ts +4 -0
  156. package/dist/comment-thread/comment-thread.d.ts +2 -2
  157. package/dist/comment-thread/comment-thread.js +2 -2
  158. package/dist/comment-thread/native/ds-comment-thread.js +10 -9
  159. package/dist/comment-thread/web/ds-comment-thread.js +11 -10
  160. package/dist/condition-builder/condition-builder.d.ts +96 -4
  161. package/dist/condition-builder/condition-builder.js +68 -28
  162. package/dist/condition-builder/web/ds-condition-builder.d.ts +4 -2
  163. package/dist/condition-builder/web/ds-condition-builder.js +97 -57
  164. package/dist/context-switcher/context-switcher.d.ts +10 -1
  165. package/dist/context-switcher/context-switcher.js +5 -2
  166. package/dist/context-switcher/web/ds-context-switcher.d.ts +1 -1
  167. package/dist/context-switcher/web/ds-context-switcher.js +4 -3
  168. package/dist/coordinate-field/coordinate-field.d.ts +46 -5
  169. package/dist/coordinate-field/coordinate-field.js +35 -18
  170. package/dist/coordinate-field/native/ds-coordinate-field.d.ts +1 -1
  171. package/dist/coordinate-field/native/ds-coordinate-field.js +9 -8
  172. package/dist/coordinate-field/web/ds-coordinate-field.d.ts +1 -1
  173. package/dist/coordinate-field/web/ds-coordinate-field.js +10 -9
  174. package/dist/copy-field/copy-field.d.ts +23 -9
  175. package/dist/copy-field/copy-field.js +11 -6
  176. package/dist/copy-field/web/ds-copy-field.d.ts +1 -1
  177. package/dist/copy-field/web/ds-copy-field.js +6 -5
  178. package/dist/copy.d.ts +8 -0
  179. package/dist/copy.js +7 -0
  180. package/dist/count-badge/web/ds-count-badge.js +1 -1
  181. package/dist/countdown/native/ds-countdown.js +1 -1
  182. package/dist/countdown/web/ds-countdown.js +1 -1
  183. package/dist/dashboard-shell/dashboard-shell.d.ts +4 -2
  184. package/dist/data-table/web/data-table-theme.css +340 -52
  185. package/dist/data-table/web/ds-data-table.d.ts +43 -1
  186. package/dist/data-table/web/ds-data-table.js +165 -17
  187. package/dist/date-field/web/ds-date-field.d.ts +1 -1
  188. package/dist/date-field/web/ds-date-field.js +6 -5
  189. package/dist/date-input/date-input.d.ts +26 -5
  190. package/dist/date-input/date-input.js +34 -2
  191. package/dist/date-input/web/ds-date-input.js +13 -4
  192. package/dist/date-picker/date-picker.d.ts +38 -67
  193. package/dist/date-picker/date-picker.js +26 -60
  194. package/dist/date-picker/web/ds-date-picker.d.ts +13 -6
  195. package/dist/date-picker/web/ds-date-picker.js +41 -10
  196. package/dist/date-range-picker/web/ds-date-range-picker.d.ts +10 -4
  197. package/dist/date-range-picker/web/ds-date-range-picker.js +8 -5
  198. package/dist/day-picker/day-picker.d.ts +1 -1
  199. package/dist/day-picker/web/ds-day-picker.js +1 -1
  200. package/dist/delta/delta.d.ts +15 -1
  201. package/dist/delta/delta.js +20 -0
  202. package/dist/delta/native/ds-delta.d.ts +5 -2
  203. package/dist/delta/native/ds-delta.js +4 -3
  204. package/dist/delta/web/ds-delta.d.ts +5 -2
  205. package/dist/delta/web/ds-delta.js +4 -3
  206. package/dist/description-list/description-list.d.ts +4 -2
  207. package/dist/description-list/native/ds-description-list.d.ts +2 -2
  208. package/dist/description-list/native/ds-description-list.js +49 -27
  209. package/dist/description-list/web/ds-description-list.d.ts +2 -2
  210. package/dist/description-list/web/ds-description-list.js +40 -17
  211. package/dist/dialog/dialog.d.ts +12 -1
  212. package/dist/dialog/web/ds-dialog.d.ts +1 -1
  213. package/dist/dialog/web/ds-dialog.js +5 -3
  214. package/dist/diverging-bar-chart/diverging-bar-chart.d.ts +2 -1
  215. package/dist/diverging-bar-chart/diverging-bar-chart.js +2 -1
  216. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.d.ts +1 -1
  217. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.js +28 -5
  218. package/dist/donut-chart/donut-chart.d.ts +7 -1
  219. package/dist/donut-chart/donut-chart.js +4 -0
  220. package/dist/donut-chart/web/ds-donut-chart.d.ts +4 -1
  221. package/dist/donut-chart/web/ds-donut-chart.js +43 -24
  222. package/dist/drawer/drawer.d.ts +42 -5
  223. package/dist/drawer/drawer.js +10 -4
  224. package/dist/drawer/native/ds-drawer.d.ts +1 -1
  225. package/dist/drawer/native/ds-drawer.js +17 -7
  226. package/dist/drawer/web/ds-drawer.d.ts +1 -1
  227. package/dist/drawer/web/ds-drawer.js +32 -17
  228. package/dist/dropdown-menu/dropdown-menu.d.ts +10 -5
  229. package/dist/dropdown-menu/dropdown-menu.js +13 -4
  230. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.d.ts +4 -2
  231. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.js +6 -6
  232. package/dist/dropdown-menu/web/ds-dropdown-menu.d.ts +5 -2
  233. package/dist/dropdown-menu/web/ds-dropdown-menu.js +2 -2
  234. package/dist/dumbbell-chart/dumbbell-chart.d.ts +10 -9
  235. package/dist/dumbbell-chart/dumbbell-chart.js +18 -4
  236. package/dist/dumbbell-chart/web/ds-dumbbell-chart.d.ts +4 -1
  237. package/dist/dumbbell-chart/web/ds-dumbbell-chart.js +13 -3
  238. package/dist/editable-row/editable-row.d.ts +5 -1
  239. package/dist/editable-row/editable-row.js +7 -1
  240. package/dist/editable-row/web/ds-editable-row.js +7 -5
  241. package/dist/empty-state/empty-state.d.ts +39 -0
  242. package/dist/empty-state/empty-state.js +21 -0
  243. package/dist/empty-state/web/ds-empty-state.d.ts +19 -8
  244. package/dist/empty-state/web/ds-empty-state.js +15 -3
  245. package/dist/environment-banner/environment-banner.d.ts +1 -1
  246. package/dist/environment-banner/environment-banner.js +1 -1
  247. package/dist/environment-banner/web/ds-environment-banner.js +3 -3
  248. package/dist/evaluation-trace/evaluation-trace.d.ts +1 -1
  249. package/dist/evaluation-trace/evaluation-trace.js +1 -1
  250. package/dist/evaluation-trace/web/ds-evaluation-trace.js +1 -1
  251. package/dist/event-row/web/ds-event-row.d.ts +1 -1
  252. package/dist/event-row/web/ds-event-row.js +2 -1
  253. package/dist/facet-button/facet-button.d.ts +9 -1
  254. package/dist/facet-button/facet-button.js +2 -2
  255. package/dist/facet-button/web/ds-facet-button.d.ts +1 -1
  256. package/dist/facet-button/web/ds-facet-button.js +9 -5
  257. package/dist/facet-menu/facet-menu.d.ts +1 -1
  258. package/dist/facet-menu/facet-menu.js +2 -1
  259. package/dist/facet-menu/web/ds-facet-menu.js +1 -1
  260. package/dist/fact/native/ds-fact.d.ts +4 -1
  261. package/dist/file-dropzone/file-dropzone.d.ts +54 -5
  262. package/dist/file-dropzone/file-dropzone.js +38 -20
  263. package/dist/file-dropzone/web/ds-file-dropzone.d.ts +1 -1
  264. package/dist/file-dropzone/web/ds-file-dropzone.js +16 -15
  265. package/dist/file-field/file-field.d.ts +26 -5
  266. package/dist/file-field/file-field.js +18 -8
  267. package/dist/file-field/web/ds-file-field.d.ts +5 -2
  268. package/dist/file-field/web/ds-file-field.js +6 -5
  269. package/dist/file-import/file-import.d.ts +50 -4
  270. package/dist/file-import/file-import.js +30 -11
  271. package/dist/file-import/web/ds-file-import.d.ts +7 -3
  272. package/dist/file-import/web/ds-file-import.js +11 -10
  273. package/dist/file-upload/file-upload.d.ts +64 -15
  274. package/dist/file-upload/file-upload.js +44 -30
  275. package/dist/file-upload/web/ds-file-upload.d.ts +11 -2
  276. package/dist/file-upload/web/ds-file-upload.js +17 -12
  277. package/dist/filter-bar/web/ds-filter-bar.js +1 -1
  278. package/dist/filter-button/filter-button.d.ts +5 -4
  279. package/dist/filter-button/filter-button.js +1 -1
  280. package/dist/filter-chip/web/ds-filter-chip.js +2 -2
  281. package/dist/filter-popover/web/ds-filter-popover.js +2 -1
  282. package/dist/form-field-group/form-field-group.d.ts +7 -2
  283. package/dist/form-field-group/form-field-group.js +2 -0
  284. package/dist/form-field-group/web/ds-form-field-group.js +2 -1
  285. package/dist/form-section/form-section.d.ts +4 -2
  286. package/dist/form-section/form-section.js +1 -1
  287. package/dist/funnel/funnel.d.ts +2 -1
  288. package/dist/funnel/web/ds-funnel.d.ts +1 -1
  289. package/dist/funnel/web/ds-funnel.js +22 -12
  290. package/dist/gauge/gauge.d.ts +6 -1
  291. package/dist/gauge/gauge.js +9 -1
  292. package/dist/gauge/web/ds-gauge.d.ts +8 -3
  293. package/dist/gauge/web/ds-gauge.js +26 -15
  294. package/dist/geo/geo.d.ts +15 -0
  295. package/dist/geo/geo.js +112 -0
  296. package/dist/geofence-editor/geofence-editor.d.ts +14 -5
  297. package/dist/geofence-editor/geofence-editor.js +32 -7
  298. package/dist/geofence-editor/web/ds-geofence-editor.d.ts +18 -3
  299. package/dist/geofence-editor/web/ds-geofence-editor.js +28 -13
  300. package/dist/group-header/web/ds-group-header.d.ts +1 -1
  301. package/dist/heatmap/heatmap-calendar.d.ts +95 -0
  302. package/dist/heatmap/heatmap-calendar.js +130 -0
  303. package/dist/heatmap/heatmap.d.ts +35 -8
  304. package/dist/heatmap/heatmap.js +61 -7
  305. package/dist/heatmap/web/ds-heatmap-calendar.d.ts +22 -0
  306. package/dist/heatmap/web/ds-heatmap-calendar.js +33 -0
  307. package/dist/heatmap/web/ds-heatmap.d.ts +21 -1
  308. package/dist/heatmap/web/ds-heatmap.js +59 -31
  309. package/dist/helper-text/native/ds-helper-text.js +2 -2
  310. package/dist/helper-text/web/ds-helper-text.js +2 -2
  311. package/dist/histogram/histogram.d.ts +2 -3
  312. package/dist/histogram/web/ds-histogram.d.ts +1 -1
  313. package/dist/histogram/web/ds-histogram.js +8 -2
  314. package/dist/icon/icon.d.ts +11 -0
  315. package/dist/icon/icon.js +52 -0
  316. package/dist/icon/native/ds-icon-provider.d.ts +6 -1
  317. package/dist/icon/native/ds-icon-provider.js +4 -2
  318. package/dist/icon/native/icon-direction.d.ts +10 -0
  319. package/dist/icon/native/icon-direction.js +6 -0
  320. package/dist/icon/native/use-icon-size.d.ts +6 -0
  321. package/dist/icon/native/use-icon-size.js +12 -0
  322. package/dist/icon/web/ds-icon-provider.d.ts +3 -1
  323. package/dist/icon/web/ds-icon-provider.js +1 -0
  324. package/dist/icon/web/icon-direction.css +45 -0
  325. package/dist/icon-button/icon-button.d.ts +6 -0
  326. package/dist/icon-button/native/ds-icon-button.d.ts +1 -1
  327. package/dist/icon-button/native/ds-icon-button.js +2 -1
  328. package/dist/icon-button/web/ds-icon-button.d.ts +1 -1
  329. package/dist/icon-button/web/ds-icon-button.js +8 -5
  330. package/dist/icon-frame/icon-frame.d.ts +2 -2
  331. package/dist/icon-frame/native/ds-icon-frame.js +3 -3
  332. package/dist/icon-frame/web/ds-icon-frame.js +3 -3
  333. package/dist/ident/ident.d.ts +2 -0
  334. package/dist/ident/ident.js +5 -0
  335. package/dist/ident/native/ds-ident.d.ts +30 -0
  336. package/dist/ident/native/ds-ident.js +13 -0
  337. package/dist/index.d.ts +88 -65
  338. package/dist/index.js +47 -36
  339. package/dist/inline-edit/inline-edit.d.ts +34 -4
  340. package/dist/inline-edit/inline-edit.js +19 -7
  341. package/dist/inline-edit/web/ds-inline-edit.d.ts +1 -1
  342. package/dist/inline-edit/web/ds-inline-edit.js +13 -8
  343. package/dist/input/input.d.ts +18 -5
  344. package/dist/input/input.js +17 -13
  345. package/dist/input/native/ds-input.js +1 -1
  346. package/dist/input/web/ds-input.d.ts +7 -1
  347. package/dist/input/web/ds-input.js +11 -9
  348. package/dist/interaction.d.ts +7 -5
  349. package/dist/interaction.js +1 -1
  350. package/dist/json-viewer/web/ds-json-viewer.js +1 -1
  351. package/dist/key-value-editor/key-value-editor.d.ts +57 -3
  352. package/dist/key-value-editor/key-value-editor.js +56 -26
  353. package/dist/key-value-editor/web/ds-key-value-editor.d.ts +1 -1
  354. package/dist/key-value-editor/web/ds-key-value-editor.js +15 -16
  355. package/dist/keypad/keypad.d.ts +21 -11
  356. package/dist/keypad/keypad.js +16 -10
  357. package/dist/keypad/native/ds-keypad.d.ts +1 -1
  358. package/dist/keypad/native/ds-keypad.js +10 -8
  359. package/dist/keypad/web/ds-keypad.d.ts +1 -1
  360. package/dist/keypad/web/ds-keypad.js +5 -4
  361. package/dist/label-picker/label-picker.d.ts +34 -4
  362. package/dist/label-picker/label-picker.js +28 -17
  363. package/dist/label-picker/native/ds-label-picker.d.ts +1 -1
  364. package/dist/label-picker/native/ds-label-picker.js +11 -10
  365. package/dist/label-picker/web/ds-label-picker.d.ts +1 -1
  366. package/dist/label-picker/web/ds-label-picker.js +11 -10
  367. package/dist/labeled-field/labeled-field.d.ts +17 -2
  368. package/dist/labeled-field/labeled-field.js +7 -5
  369. package/dist/labeled-field/web/ds-labeled-field.d.ts +1 -1
  370. package/dist/labeled-field/web/ds-labeled-field.js +6 -2
  371. package/dist/leaderboard/leaderboard.d.ts +4 -3
  372. package/dist/leaderboard/leaderboard.js +4 -1
  373. package/dist/leaderboard/web/ds-leaderboard.d.ts +1 -1
  374. package/dist/leaderboard/web/ds-leaderboard.js +8 -3
  375. package/dist/legend/legend.d.ts +4 -0
  376. package/dist/legend/legend.js +1 -0
  377. package/dist/legend/web/ds-legend.js +18 -11
  378. package/dist/lib/chart-context.d.ts +23 -3
  379. package/dist/lib/chart-context.js +9 -3
  380. package/dist/lib/chart-finish.d.ts +13 -6
  381. package/dist/lib/chart-finish.js +8 -2
  382. package/dist/lib/chart-library.d.ts +1 -1
  383. package/dist/lib/chart-series.d.ts +7 -4
  384. package/dist/lib/chart-series.js +2 -4
  385. package/dist/lib/chart-ticks.d.ts +11 -0
  386. package/dist/lib/chart-ticks.js +11 -0
  387. package/dist/lib/chart-value.d.ts +1 -1
  388. package/dist/lib/chart-value.js +3 -1
  389. package/dist/lib/cn.d.ts +1 -0
  390. package/dist/lib/cn.js +7 -2
  391. package/dist/lib/native/animated.d.ts +4 -5
  392. package/dist/lib/native/animated.js +3 -4
  393. package/dist/lib/time-of-day.d.ts +21 -0
  394. package/dist/lib/time-of-day.js +37 -0
  395. package/dist/lib/web/chart-finish.d.ts +1 -1
  396. package/dist/lib/web/chart-finish.js +1 -1
  397. package/dist/lib/web/density.d.ts +1 -0
  398. package/dist/lib/web/density.js +7 -0
  399. package/dist/lib/web/focus-habits.js +20 -8
  400. package/dist/lib/web/focus-trap.d.ts +10 -0
  401. package/dist/lib/web/focus-trap.js +4 -1
  402. package/dist/lib/web/live-announcer.d.ts +2 -0
  403. package/dist/lib/web/live-announcer.js +2 -1
  404. package/dist/lib/web/touch-target.d.ts +4 -4
  405. package/dist/lib/web/touch-target.js +3 -3
  406. package/dist/lib/web/use-anchored-surface.js +3 -2
  407. package/dist/lib/web/use-overlay.js +7 -1
  408. package/dist/list-page/list-page.d.ts +2 -1
  409. package/dist/list-page/web/ds-list-page.js +1 -5
  410. package/dist/list-row/list-row.d.ts +6 -6
  411. package/dist/list-row/list-row.js +4 -5
  412. package/dist/list-row/native/ds-list-row.js +7 -2
  413. package/dist/list-row/web/ds-list-row-group.d.ts +6 -2
  414. package/dist/list-row/web/ds-list-row-group.js +4 -2
  415. package/dist/list-row/web/ds-list-row.js +9 -9
  416. package/dist/loading-screen/native/ds-loading-screen.js +1 -1
  417. package/dist/log-viewer/log-viewer.d.ts +2 -2
  418. package/dist/log-viewer/log-viewer.js +1 -1
  419. package/dist/log-viewer/web/ds-log-viewer.js +6 -5
  420. package/dist/map/map.d.ts +5 -0
  421. package/dist/map/map.js +2 -0
  422. package/dist/map/web/ds-map.js +9 -3
  423. package/dist/map-banner/native/ds-map-banner.js +3 -3
  424. package/dist/map-banner/web/ds-map-banner.js +4 -4
  425. package/dist/map-controls/map-controls.d.ts +3 -5
  426. package/dist/map-controls/map-controls.js +4 -4
  427. package/dist/map-controls/native/ds-map-controls.js +1 -1
  428. package/dist/map-controls/web/ds-map-controls.js +1 -1
  429. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.js +3 -2
  430. package/dist/map-heatmap-layer/map-heatmap-layer.d.ts +1 -1
  431. package/dist/map-layers/map-layers.d.ts +1 -1
  432. package/dist/map-layers/map-layers.js +1 -1
  433. package/dist/map-layers/native/ds-map-layers.d.ts +4 -2
  434. package/dist/map-layers/native/ds-map-layers.js +5 -4
  435. package/dist/map-layers/web/ds-map-layers.js +4 -4
  436. package/dist/map-list/map-list.d.ts +2 -1
  437. package/dist/map-list/web/ds-map-list.d.ts +1 -1
  438. package/dist/map-list/web/ds-map-list.js +19 -16
  439. package/dist/map-marker/map-marker.d.ts +5 -0
  440. package/dist/map-marker/map-marker.js +6 -0
  441. package/dist/map-marker/web/ds-map-marker.d.ts +12 -3
  442. package/dist/map-marker/web/ds-map-marker.js +18 -8
  443. package/dist/map-search/map-search.d.ts +9 -0
  444. package/dist/map-search/map-search.js +13 -0
  445. package/dist/map-search/native/ds-map-search.d.ts +10 -3
  446. package/dist/map-search/native/ds-map-search.js +32 -19
  447. package/dist/map-search/web/ds-map-search.d.ts +8 -3
  448. package/dist/map-search/web/ds-map-search.js +37 -27
  449. package/dist/map-search-area/native/ds-map-search-area.js +2 -1
  450. package/dist/map-search-area/web/ds-map-search-area.js +2 -1
  451. package/dist/map-sheet/native/ds-map-sheet.js +1 -1
  452. package/dist/map-sheet/web/ds-map-sheet.js +2 -2
  453. package/dist/map-summary/map-summary.d.ts +2 -1
  454. package/dist/map-summary/web/ds-map-summary.d.ts +2 -2
  455. package/dist/map-summary/web/ds-map-summary.js +18 -9
  456. package/dist/mention-input/mention-input.d.ts +23 -2
  457. package/dist/mention-input/mention-input.js +15 -8
  458. package/dist/mention-input/native/ds-mention-input.d.ts +1 -1
  459. package/dist/mention-input/native/ds-mention-input.js +6 -9
  460. package/dist/mention-input/web/ds-mention-input.d.ts +1 -1
  461. package/dist/mention-input/web/ds-mention-input.js +6 -5
  462. package/dist/menu-button/web/ds-menu-button.d.ts +2 -2
  463. package/dist/menu-button/web/ds-menu-button.js +9 -4
  464. package/dist/meter/meter.d.ts +5 -2
  465. package/dist/meter/meter.js +2 -1
  466. package/dist/meter/native/ds-meter.d.ts +2 -2
  467. package/dist/meter/native/ds-meter.js +13 -3
  468. package/dist/meter/web/ds-meter.d.ts +1 -1
  469. package/dist/meter/web/ds-meter.js +16 -9
  470. package/dist/metric/metric.d.ts +13 -9
  471. package/dist/metric/native/ds-metric.d.ts +1 -1
  472. package/dist/metric/native/ds-metric.js +26 -16
  473. package/dist/metric/web/ds-metric.d.ts +1 -1
  474. package/dist/metric/web/ds-metric.js +21 -5
  475. package/dist/metric-card/metric-card.d.ts +4 -3
  476. package/dist/metric-card/web/ds-metric-card.d.ts +1 -1
  477. package/dist/metric-card/web/ds-metric-card.js +4 -2
  478. package/dist/month-picker/web/ds-month-picker.js +2 -1
  479. package/dist/month-strip/web/ds-month-strip.js +1 -1
  480. package/dist/motion.d.ts +18 -3
  481. package/dist/motion.js +3 -1
  482. package/dist/multi-select/multi-select.d.ts +39 -9
  483. package/dist/multi-select/multi-select.js +35 -22
  484. package/dist/multi-select/web/ds-multi-select.d.ts +1 -1
  485. package/dist/multi-select/web/ds-multi-select.js +42 -24
  486. package/dist/native.d.ts +12 -0
  487. package/dist/native.js +8 -0
  488. package/dist/notification-list/native/ds-notification-list.d.ts +1 -1
  489. package/dist/notification-list/native/ds-notification-list.js +14 -7
  490. package/dist/notification-list/notification-list.d.ts +2 -1
  491. package/dist/notification-list/web/ds-notification-list.d.ts +1 -1
  492. package/dist/notification-list/web/ds-notification-list.js +10 -4
  493. package/dist/number-field/native/ds-number-field.js +1 -1
  494. package/dist/number-field/web/ds-number-field.js +1 -1
  495. package/dist/otp/native/ds-otp-field.js +3 -21
  496. package/dist/otp/native/ds-otp.js +3 -3
  497. package/dist/otp/otp.d.ts +3 -3
  498. package/dist/otp/web/ds-otp.js +3 -3
  499. package/dist/overflow-menu/web/ds-overflow-menu.js +7 -2
  500. package/dist/page-head/web/ds-page-head.js +2 -2
  501. package/dist/panel/native/ds-panel.js +1 -1
  502. package/dist/panel/panel.d.ts +1 -1
  503. package/dist/panel/web/ds-panel.d.ts +3 -1
  504. package/dist/panel/web/ds-panel.js +3 -2
  505. package/dist/password-feedback/web/ds-password-feedback.d.ts +1 -1
  506. package/dist/password-feedback/web/ds-password-feedback.js +3 -3
  507. package/dist/password-input/web/ds-password-input.d.ts +7 -2
  508. package/dist/password-input/web/ds-password-input.js +28 -3
  509. package/dist/password-requirements/password-requirements.d.ts +12 -2
  510. package/dist/password-requirements/password-requirements.js +6 -8
  511. package/dist/password-requirements/web/ds-password-requirements.js +5 -5
  512. package/dist/password-strength/web/ds-password-strength.js +2 -2
  513. package/dist/payment-card/native/ds-payment-card.d.ts +1 -1
  514. package/dist/payment-card/native/ds-payment-card.js +1 -1
  515. package/dist/payment-card/web/ds-payment-card.d.ts +1 -1
  516. package/dist/payment-card/web/ds-payment-card.js +1 -1
  517. package/dist/people-cell/people-cell.d.ts +5 -2
  518. package/dist/people-cell/web/ds-people-cell.d.ts +1 -1
  519. package/dist/people-cell/web/ds-people-cell.js +6 -2
  520. package/dist/person-cell/person-cell.d.ts +5 -2
  521. package/dist/person-cell/web/ds-person-cell.d.ts +1 -1
  522. package/dist/person-cell/web/ds-person-cell.js +11 -1
  523. package/dist/phone-field/native/ds-phone-field.js +2 -2
  524. package/dist/phone-field/phone-field.d.ts +35 -0
  525. package/dist/phone-field/phone-field.js +38 -0
  526. package/dist/phone-field/web/ds-phone-field.d.ts +31 -3
  527. package/dist/phone-field/web/ds-phone-field.js +45 -8
  528. package/dist/place-card/native/ds-place-card.d.ts +7 -3
  529. package/dist/place-card/native/ds-place-card.js +32 -21
  530. package/dist/place-card/place-card.d.ts +12 -6
  531. package/dist/place-card/place-card.js +6 -3
  532. package/dist/place-card/web/ds-place-card.d.ts +5 -3
  533. package/dist/place-card/web/ds-place-card.js +39 -27
  534. package/dist/plan-chart/plan-chart.d.ts +2 -3
  535. package/dist/plan-chart/web/ds-plan-chart.d.ts +1 -1
  536. package/dist/plan-chart/web/ds-plan-chart.js +34 -6
  537. package/dist/popover/popover.d.ts +7 -3
  538. package/dist/popover/web/ds-popover.d.ts +5 -1
  539. package/dist/popover/web/ds-popover.js +4 -2
  540. package/dist/priority-indicator/native/ds-priority-indicator.js +4 -4
  541. package/dist/priority-indicator/priority-indicator.d.ts +3 -3
  542. package/dist/priority-indicator/priority-indicator.js +3 -3
  543. package/dist/priority-indicator/web/ds-priority-indicator.js +4 -4
  544. package/dist/profile-card/profile-card.d.ts +2 -1
  545. package/dist/profile-card/web/ds-profile-card.d.ts +2 -2
  546. package/dist/profile-card/web/ds-profile-card.js +16 -3
  547. package/dist/progress-bar/native/ds-progress-bar.js +2 -1
  548. package/dist/progress-bar/web/ds-progress-bar.js +2 -1
  549. package/dist/progress-cell/progress-cell.d.ts +8 -3
  550. package/dist/progress-cell/progress-cell.js +1 -1
  551. package/dist/progress-cell/web/ds-progress-cell.d.ts +5 -2
  552. package/dist/progress-cell/web/ds-progress-cell.js +6 -2
  553. package/dist/progress-ring/native/ds-progress-ring.js +16 -11
  554. package/dist/progress-ring/progress-ring.d.ts +8 -4
  555. package/dist/progress-ring/progress-ring.js +7 -3
  556. package/dist/progress-ring/web/ds-progress-ring.js +16 -10
  557. package/dist/proportion-bar/native/ds-proportion-bar.d.ts +2 -2
  558. package/dist/proportion-bar/native/ds-proportion-bar.js +18 -7
  559. package/dist/proportion-bar/proportion-bar.d.ts +10 -3
  560. package/dist/proportion-bar/proportion-bar.js +6 -1
  561. package/dist/proportion-bar/web/ds-proportion-bar.d.ts +1 -1
  562. package/dist/proportion-bar/web/ds-proportion-bar.js +21 -14
  563. package/dist/quick-actions/native/ds-quick-actions.js +17 -2
  564. package/dist/quick-actions/quick-actions.d.ts +32 -2
  565. package/dist/quick-actions/quick-actions.js +9 -1
  566. package/dist/quick-actions/web/ds-quick-actions.js +20 -6
  567. package/dist/radar-chart/radar-chart.d.ts +11 -3
  568. package/dist/radar-chart/radar-chart.js +21 -3
  569. package/dist/radar-chart/web/ds-radar-chart.d.ts +1 -1
  570. package/dist/radar-chart/web/ds-radar-chart.js +34 -22
  571. package/dist/radial-progress/native/ds-radial-progress.d.ts +6 -2
  572. package/dist/radial-progress/native/ds-radial-progress.js +34 -11
  573. package/dist/radial-progress/radial-progress.d.ts +11 -2
  574. package/dist/radial-progress/radial-progress.js +9 -0
  575. package/dist/radial-progress/web/ds-radial-progress.d.ts +6 -2
  576. package/dist/radial-progress/web/ds-radial-progress.js +24 -10
  577. package/dist/radio/radio.d.ts +4 -4
  578. package/dist/radio/radio.js +4 -4
  579. package/dist/radio/web/ds-radio.d.ts +6 -2
  580. package/dist/radio/web/ds-radio.js +22 -10
  581. package/dist/radio-group/radio-group.d.ts +41 -5
  582. package/dist/radio-group/radio-group.js +5 -0
  583. package/dist/radio-group/web/ds-radio-group.d.ts +1 -1
  584. package/dist/radio-group/web/ds-radio-group.js +7 -2
  585. package/dist/rating-badge/rating-badge.d.ts +8 -2
  586. package/dist/rating-badge/rating-badge.js +5 -0
  587. package/dist/rating-badge/web/ds-rating-badge.d.ts +2 -2
  588. package/dist/rating-badge/web/ds-rating-badge.js +6 -4
  589. package/dist/recipient-select/recipient-select.d.ts +7 -0
  590. package/dist/recipient-select/recipient-select.js +3 -0
  591. package/dist/recipient-select/web/ds-recipient-select.js +4 -4
  592. package/dist/record-panel/record-panel.d.ts +17 -2
  593. package/dist/record-panel/web/ds-record-panel.d.ts +48 -13
  594. package/dist/record-panel/web/ds-record-panel.js +27 -18
  595. package/dist/reorder-list/reorder-list.d.ts +3 -0
  596. package/dist/reorder-list/web/ds-reorder-list.d.ts +6 -1
  597. package/dist/reorder-list/web/ds-reorder-list.js +6 -4
  598. package/dist/resend-control/native/ds-resend-control.d.ts +24 -0
  599. package/dist/resend-control/native/ds-resend-control.js +73 -0
  600. package/dist/resend-control/resend-control.d.ts +2 -0
  601. package/dist/resend-control/resend-control.js +2 -0
  602. package/dist/resend-control/web/ds-resend-control.js +3 -3
  603. package/dist/route-fields/route-fields.d.ts +79 -0
  604. package/dist/route-fields/route-fields.js +71 -0
  605. package/dist/route-fields/web/ds-route-fields.d.ts +5 -0
  606. package/dist/route-fields/web/ds-route-fields.js +83 -0
  607. package/dist/route-line/web/ds-route-line.js +2 -2
  608. package/dist/save-bar/save-bar.d.ts +1 -1
  609. package/dist/save-bar/save-bar.js +1 -1
  610. package/dist/save-bar/web/ds-save-bar.js +2 -2
  611. package/dist/scanner/scanner.d.ts +1 -1
  612. package/dist/scanner/scanner.js +2 -1
  613. package/dist/scatter-chart/scatter-chart.d.ts +2 -3
  614. package/dist/scatter-chart/web/ds-scatter-chart.d.ts +1 -1
  615. package/dist/scatter-chart/web/ds-scatter-chart.js +13 -4
  616. package/dist/schedule-chart/schedule-chart.d.ts +187 -0
  617. package/dist/schedule-chart/schedule-chart.js +285 -0
  618. package/dist/schedule-chart/web/ds-schedule-chart.d.ts +24 -0
  619. package/dist/schedule-chart/web/ds-schedule-chart.js +143 -0
  620. package/dist/segmented-control/native/ds-segmented-control.d.ts +1 -1
  621. package/dist/segmented-control/native/ds-segmented-control.js +1 -1
  622. package/dist/segmented-control/segmented-control.d.ts +7 -0
  623. package/dist/segmented-control/web/ds-segmented-control.d.ts +1 -1
  624. package/dist/segmented-control/web/ds-segmented-control.js +4 -3
  625. package/dist/select/native/ds-select.js +6 -3
  626. package/dist/select/select.d.ts +5 -0
  627. package/dist/select/web/ds-select.d.ts +14 -1
  628. package/dist/select/web/ds-select.js +22 -12
  629. package/dist/settings-directory/native/ds-settings-directory.js +1 -1
  630. package/dist/settings-directory/web/ds-settings-directory.js +1 -1
  631. package/dist/settings-row/web/ds-settings-row.d.ts +3 -1
  632. package/dist/settings-row/web/ds-settings-row.js +2 -2
  633. package/dist/sheet/web/ds-sheet.js +3 -3
  634. package/dist/side-nav/side-nav.d.ts +2 -1
  635. package/dist/side-nav/web/ds-side-nav-collapse.d.ts +4 -1
  636. package/dist/side-nav/web/ds-side-nav-collapse.js +6 -3
  637. package/dist/side-nav/web/ds-side-nav-header.js +1 -1
  638. package/dist/side-nav/web/ds-side-nav-primary.js +1 -1
  639. package/dist/side-nav/web/ds-side-nav-profile.js +1 -1
  640. package/dist/side-nav/web/ds-side-nav.d.ts +1 -1
  641. package/dist/side-nav/web/ds-side-nav.js +3 -3
  642. package/dist/skeleton/skeleton.d.ts +20 -0
  643. package/dist/skeleton/skeleton.js +4 -0
  644. package/dist/slider/native/ds-slider.js +1 -1
  645. package/dist/small-multiples/small-multiples.d.ts +3 -4
  646. package/dist/small-multiples/small-multiples.js +2 -1
  647. package/dist/small-multiples/web/ds-small-multiples.d.ts +1 -1
  648. package/dist/small-multiples/web/ds-small-multiples.js +8 -2
  649. package/dist/sparkline/sparkline.d.ts +19 -7
  650. package/dist/sparkline/sparkline.js +42 -17
  651. package/dist/sparkline/web/ds-sparkline.d.ts +1 -1
  652. package/dist/sparkline/web/ds-sparkline.js +4 -3
  653. package/dist/split-pane/web/ds-split-pane.js +2 -2
  654. package/dist/stat-tile/native/ds-stat-tile.d.ts +3 -3
  655. package/dist/stat-tile/native/ds-stat-tile.js +14 -7
  656. package/dist/stat-tile/stat-tile.d.ts +14 -8
  657. package/dist/stat-tile/web/ds-stat-tile.d.ts +4 -2
  658. package/dist/stat-tile/web/ds-stat-tile.js +8 -5
  659. package/dist/state-message/web/ds-state-message.d.ts +6 -2
  660. package/dist/state-message/web/ds-state-message.js +5 -2
  661. package/dist/status-badge/native/ds-status-badge.js +3 -3
  662. package/dist/status-badge/status-badge.d.ts +3 -3
  663. package/dist/status-badge/status-badge.js +1 -1
  664. package/dist/status-badge/web/ds-status-badge.js +4 -4
  665. package/dist/status-cell/status-cell.d.ts +5 -2
  666. package/dist/status-cell/web/ds-status-cell.d.ts +6 -2
  667. package/dist/status-cell/web/ds-status-cell.js +7 -2
  668. package/dist/status-control/web/ds-status-control.js +3 -3
  669. package/dist/status-dot/native/ds-status-dot.js +1 -1
  670. package/dist/status-dot/status-dot.d.ts +2 -2
  671. package/dist/status-dot/status-dot.js +2 -2
  672. package/dist/status-dot/web/ds-status-dot.js +2 -2
  673. package/dist/stepper-form/stepper-form.d.ts +27 -4
  674. package/dist/stepper-form/stepper-form.js +17 -9
  675. package/dist/stepper-form/web/ds-stepper-form.d.ts +1 -1
  676. package/dist/stepper-form/web/ds-stepper-form.js +7 -5
  677. package/dist/stick-chart/stick-chart.d.ts +2 -1
  678. package/dist/stick-chart/stick-chart.js +2 -1
  679. package/dist/stick-chart/web/ds-stick-chart.d.ts +1 -1
  680. package/dist/stick-chart/web/ds-stick-chart.js +17 -3
  681. package/dist/switch/native/ds-switch.js +1 -1
  682. package/dist/system-state/native/ds-system-state.d.ts +29 -0
  683. package/dist/system-state/native/ds-system-state.js +68 -0
  684. package/dist/system-state/system-state.js +4 -3
  685. package/dist/system-state/web/ds-system-state.js +2 -2
  686. package/dist/table-toolbar/web/ds-table-toolbar.js +1 -1
  687. package/dist/tabs/tabs.d.ts +5 -0
  688. package/dist/tabs/tabs.js +2 -0
  689. package/dist/tabs/web/ds-tabs.js +2 -2
  690. package/dist/task-shell/task-shell.d.ts +15 -6
  691. package/dist/task-shell/task-shell.js +5 -2
  692. package/dist/task-shell/web/ds-task-shell.d.ts +21 -6
  693. package/dist/task-shell/web/ds-task-shell.js +52 -18
  694. package/dist/text/native/ds-text.js +1 -1
  695. package/dist/text/text.d.ts +1 -1
  696. package/dist/text/text.js +1 -1
  697. package/dist/text/web/ds-text.js +1 -1
  698. package/dist/textarea/native/ds-textarea.d.ts +1 -1
  699. package/dist/textarea/native/ds-textarea.js +9 -8
  700. package/dist/textarea/web/ds-textarea.d.ts +1 -1
  701. package/dist/textarea/web/ds-textarea.js +8 -7
  702. package/dist/time-field/time-field.d.ts +37 -0
  703. package/dist/time-field/time-field.js +23 -0
  704. package/dist/time-field/web/ds-time-field.d.ts +8 -0
  705. package/dist/time-field/web/ds-time-field.js +28 -0
  706. package/dist/time-range/time-range.d.ts +35 -26
  707. package/dist/time-range/time-range.js +28 -46
  708. package/dist/time-range/web/ds-time-range.d.ts +1 -1
  709. package/dist/time-range/web/ds-time-range.js +9 -6
  710. package/dist/timeline/native/ds-timeline.d.ts +2 -2
  711. package/dist/timeline/native/ds-timeline.js +21 -7
  712. package/dist/timeline/timeline.d.ts +2 -1
  713. package/dist/timeline/web/ds-timeline.d.ts +2 -2
  714. package/dist/timeline/web/ds-timeline.js +18 -9
  715. package/dist/toast/native/ds-toast.js +1 -1
  716. package/dist/toggle-group/native/ds-toggle-group.js +1 -1
  717. package/dist/token-roles.d.ts +1 -1
  718. package/dist/token-roles.js +18 -0
  719. package/dist/tone.d.ts +4 -4
  720. package/dist/tone.js +1 -5
  721. package/dist/toolbar/toolbar.d.ts +19 -7
  722. package/dist/toolbar/toolbar.js +4 -3
  723. package/dist/toolbar/web/ds-toolbar.d.ts +5 -2
  724. package/dist/toolbar/web/ds-toolbar.js +3 -3
  725. package/dist/track-bars/track-bars.d.ts +3 -4
  726. package/dist/track-bars/web/ds-track-bars.d.ts +1 -1
  727. package/dist/track-bars/web/ds-track-bars.js +9 -3
  728. package/dist/tree/tree.d.ts +1 -1
  729. package/dist/tree/tree.js +1 -1
  730. package/dist/tree/web/ds-tree.js +2 -2
  731. package/dist/treemap/treemap.d.ts +2 -3
  732. package/dist/treemap/web/ds-treemap.d.ts +1 -1
  733. package/dist/treemap/web/ds-treemap.js +14 -3
  734. package/dist/two-line-cell/two-line-cell.d.ts +5 -2
  735. package/dist/two-line-cell/web/ds-two-line-cell.d.ts +1 -1
  736. package/dist/two-line-cell/web/ds-two-line-cell.js +5 -1
  737. package/dist/vehicle-marker/vehicle-marker.d.ts +5 -4
  738. package/dist/vehicle-marker/vehicle-marker.js +3 -3
  739. package/dist/vehicle-marker/web/ds-vehicle-marker.js +9 -6
  740. package/dist/waterfall-chart/waterfall-chart.d.ts +10 -5
  741. package/dist/waterfall-chart/waterfall-chart.js +17 -12
  742. package/dist/waterfall-chart/web/ds-waterfall-chart.d.ts +7 -2
  743. package/dist/waterfall-chart/web/ds-waterfall-chart.js +49 -11
  744. package/dist/web.d.ts +20 -5
  745. package/dist/web.js +10 -2
  746. package/dist/week-schedule/web/ds-week-schedule.d.ts +1 -1
  747. package/dist/week-schedule/web/ds-week-schedule.js +4 -4
  748. package/dist/week-schedule/week-schedule.d.ts +23 -4
  749. package/dist/week-schedule/week-schedule.js +19 -13
  750. package/forced-colors.css +8 -5
  751. package/package.json +10 -15
@@ -32,7 +32,7 @@ const SHAPE = {
32
32
  between: 'rounded-full',
33
33
  };
34
34
  const CONTROL = cn('focusable rounded-control transition-control state-layer-press', HOVER_TINT[CALENDAR_HOVER_TINT_PERCENT]);
35
- export function DSCalendar({ year, month, range = { from: null, to: null }, weekStart = CALENDAR_WEEK_START, today, min, max, onSelectDate, onMonthChange, monthsOpen = false, onMonthsOpenChange, previousLabel, nextLabel, arrows = 'both', selectionAppearance = 'neutral', pressedRange, className, ...props }) {
35
+ export function DSCalendar({ year, month, range = { from: null, to: null }, weekStart = CALENDAR_WEEK_START, today, todayMark = 'ring', min, max, onSelectDate, onMonthChange, monthsOpen = false, onMonthsOpenChange, previousLabel, nextLabel, arrows = 'both', selectionAppearance = 'neutral', pressedRange, className, ...props }) {
36
36
  const headingId = useId();
37
37
  const rows = monthGrid({
38
38
  year,
@@ -115,15 +115,15 @@ export function DSCalendar({ year, month, range = { from: null, to: null }, week
115
115
  }, className: cn(CONTROL, 'px-2 text-body-sm', TARGET_MIN_HEIGHT[CALENDAR_TARGET], current
116
116
  ? cn(TINT[CALENDAR_SELECTED_TINT_PERCENT], INK[CALENDAR_SELECTED_INK], 'font-semibold', FORCED_SELECTED)
117
117
  : INK[CALENDAR_DAY_INK]), children: name }, name));
118
- }) })) : (_jsxs("table", { ref: gridRef, role: "grid", "aria-labelledby": headingId, onKeyDown: onGridKeyDown, className: "w-full table-fixed border-separate border-spacing-0", children: [_jsx("thead", { children: _jsx("tr", { children: weekdayHeadings(weekStart).map((short, column) => (_jsxs("th", { scope: "col", className: "h-8 p-0 text-body-xs text-muted-foreground", children: [_jsx("span", { "aria-hidden": true, children: short }), _jsx("span", { className: "sr-only", children: CALENDAR_WEEKDAY_NAMES[(column + weekStart) % 7] })] }, short))) }) }), _jsx("tbody", { children: rows.map((row, rowIndex) => (_jsx("tr", { children: row.map((cell, cellIndex) => cell === null ? (_jsx("td", { "aria-hidden": true, className: "p-0" }, cellIndex)) : (_jsx(Day, { branded: selectionAppearance === 'brand', cell: cell, pressed: daySelection(cell.date, pressedRange ?? range) !== 'none', tabbable: cell.date === stop, onPress: () => {
118
+ }) })) : (_jsxs("table", { ref: gridRef, role: "grid", "aria-labelledby": headingId, onKeyDown: onGridKeyDown, className: "w-full table-fixed border-separate border-spacing-0", children: [_jsx("thead", { children: _jsx("tr", { children: weekdayHeadings(weekStart).map((short, column) => (_jsxs("th", { scope: "col", className: "h-8 p-0 text-body-xs text-muted-foreground", children: [_jsx("span", { "aria-hidden": true, children: short }), _jsx("span", { className: "sr-only", children: CALENDAR_WEEKDAY_NAMES[(column + weekStart) % 7] })] }, short))) }) }), _jsx("tbody", { children: rows.map((row, rowIndex) => (_jsx("tr", { children: row.map((cell, cellIndex) => cell === null ? (_jsx("td", { "aria-hidden": true, className: "p-0" }, cellIndex)) : (_jsx(Day, { branded: selectionAppearance === 'brand', cell: cell, todayMark: todayMark, pressed: daySelection(cell.date, pressedRange ?? range) !== 'none', tabbable: cell.date === stop, onPress: () => {
119
119
  setActive(cell.date);
120
120
  onSelectDate(cell.date);
121
121
  }, onFocus: () => {
122
122
  setActive(cell.date);
123
123
  } }, cell.date))) }, rowIndex))) })] })), _jsx("span", { "aria-live": "polite", className: "sr-only", children: said })] }));
124
124
  }
125
- function Day({ cell, branded, pressed, tabbable, onPress, onFocus, }) {
126
- const spec = calendarDaySpec(cell);
125
+ function Day({ cell, todayMark, branded, pressed, tabbable, onPress, onFocus, }) {
126
+ const spec = calendarDaySpec(cell, todayMark);
127
127
  const endpoint = cell.selection === 'start' || cell.selection === 'end' || cell.selection === 'only';
128
128
  return (_jsx("td", { className: cn('p-0 text-center align-middle', !branded && spec.bandTint !== undefined ? TINT[spec.bandTint] : undefined, branded &&
129
129
  cell.selection === 'between' &&
@@ -134,5 +134,6 @@ function Day({ cell, branded, pressed, tabbable, onPress, onFocus, }) {
134
134
  'bg-linear-to-r from-primary/10 from-50% to-transparent to-50%'), children: _jsx("button", { type: "button", "data-date": cell.date, tabIndex: tabbable ? 0 : -1, "aria-disabled": cell.disabled || undefined, "aria-label": calendarDayLabel(cell.date), "aria-current": cell.today ? 'date' : undefined, "aria-pressed": pressed, onFocus: onFocus, onClick: () => {
135
135
  if (!cell.disabled)
136
136
  onPress();
137
- }, className: cn('focusable flex w-full items-center justify-center text-body-sm tabular-nums transition-control', TARGET_HEIGHT[CALENDAR_TARGET], branded ? 'rounded-full' : SHAPE[cell.selection], branded && endpoint ? 'bg-primary text-primary-foreground' : INK[spec.ink], branded && endpoint && 'mx-auto w-11 max-w-full compact:w-8', cell.disabled ? 'cursor-default' : 'cursor-pointer state-layer-press', cell.disabled && 'line-through', branded || spec.tint === undefined ? undefined : TINT[spec.tint], spec.hoverTint === undefined ? undefined : HOVER_TINT[spec.hoverTint], spec.emphasised && 'font-semibold', endpoint && FORCED_SELECTED, spec.ring === undefined ? undefined : TODAY_RING[spec.ring]), children: cell.day }) }));
137
+ }, className: cn('focusable flex w-full items-center justify-center text-body-sm tabular-nums transition-control', TARGET_HEIGHT[CALENDAR_TARGET], branded ? 'rounded-full' : SHAPE[cell.selection], branded && endpoint ? 'bg-primary text-primary-foreground' : INK[spec.ink], branded && endpoint && 'mx-auto w-11 max-w-full compact:w-8', cell.disabled ? 'cursor-default' : 'cursor-pointer state-layer-press', cell.disabled && 'line-through', branded || spec.tint === undefined ? undefined : TINT[spec.tint], spec.hoverTint === undefined ? undefined : HOVER_TINT[spec.hoverTint], spec.emphasised && 'font-semibold', endpoint && FORCED_SELECTED, spec.ring === undefined ? undefined : TODAY_RING[spec.ring], spec.dot === true &&
138
+ 'relative after:absolute after:inset-x-0 after:bottom-1 after:mx-auto after:size-1 after:rounded-full after:bg-current compact:after:bottom-0.5'), children: cell.day }) }));
138
139
  }
@@ -86,7 +86,7 @@ export function DSCardCarousel({ index, onIndexChange, label, noun = CARD_CAROUS
86
86
  move(at - 1);
87
87
  }, className: "flex-row items-center justify-center", children: pages.map((_, i) => (_jsx(Pressable, { onPress: () => {
88
88
  move(i);
89
- }, hitSlop: 8, style: ({ pressed }) => pressed && Platform.OS === 'ios' && !reduced
89
+ }, tabIndex: -1, hitSlop: 8, style: ({ pressed }) => pressed && Platform.OS === 'ios' && !reduced
90
90
  ? { transform: [{ scale: PRESS_SCALES.firm }] }
91
91
  : null, className: "size-7 items-center justify-center rounded-full android:ripple-primary", children: _jsx(View, { className: cn('size-2 rounded-full', i === at ? 'bg-primary' : 'border border-muted-foreground') }) }, `${String(i)}|${epoch}`))) }))] }));
92
92
  }
@@ -74,14 +74,14 @@ export function DSCardCarousel({ index, onIndexChange, label, noun = CARD_CAROUS
74
74
  onIndexChange(hit);
75
75
  };
76
76
  const lower = noun.toLocaleLowerCase();
77
- return (_jsxs("div", { ...props, role: "region", "aria-roledescription": "carousel", "aria-label": label, onKeyDown: onKeyDown, className: cn('flex flex-col gap-3', className), children: [_jsxs("div", { ref: track, tabIndex: 0, onScroll: onScroll, onClick: onTrackClick, className: "relative flex snap-x snap-mandatory overflow-x-auto overscroll-x-contain rounded-card focusable", children: [_jsx("div", { "aria-hidden": true, className: "w-1/12 shrink-0" }), pages.map((page, i) => (_jsx("div", { "data-slide": true, role: "group", "aria-roledescription": "slide", "aria-label": cardCarouselPageLabel(i, count, noun), "aria-current": i === at ? 'true' : undefined, inert: i !== at, className: cn('shrink-0 basis-5/6 snap-center px-2 transition-control', i !== at && 'cursor-pointer opacity-70'), children: page }, i))), _jsx("div", { "aria-hidden": true, className: "w-1/12 shrink-0" })] }), count > 1 && (_jsxs("div", { className: "flex items-center justify-center gap-2", children: [_jsx(DSIconButton, { variant: "ghost", size: "sm", label: `Previous ${lower}`, icon: _jsx(ChevronLeft, { "aria-hidden": true }), "aria-disabled": at === 0 || undefined, className: END, onClick: () => {
77
+ return (_jsxs("div", { ...props, role: "region", "aria-roledescription": "carousel", "aria-label": label, onKeyDown: onKeyDown, className: cn('flex flex-col gap-3', className), children: [_jsxs("div", { ref: track, tabIndex: 0, onScroll: onScroll, onClick: onTrackClick, className: "relative flex snap-x snap-mandatory overflow-x-auto overscroll-x-contain rounded-card focusable", children: [_jsx("div", { "aria-hidden": true, className: "w-1/12 shrink-0" }), pages.map((page, i) => (_jsx("div", { "data-slide": true, role: "group", "aria-roledescription": "slide", "aria-label": cardCarouselPageLabel(i, count, noun), "aria-current": i === at ? 'true' : undefined, inert: i !== at, className: cn('shrink-0 basis-5/6 snap-center px-2 transition-control', i !== at && 'cursor-pointer opacity-70'), children: page }, i))), _jsx("div", { "aria-hidden": true, className: "w-1/12 shrink-0" })] }), count > 1 && (_jsxs("div", { className: "flex items-center justify-center gap-2", children: [_jsx(DSIconButton, { variant: "ghost", size: "sm", label: `Previous ${lower}`, icon: _jsx(ChevronLeft, { "aria-hidden": true }), disabled: at === 0, focusableWhenDisabled: true, className: END, onClick: () => {
78
78
  if (!(at === 0))
79
79
  onIndexChange(at - 1);
80
80
  } }), _jsx("div", { className: "flex items-center", children: pages.map((_, i) => (_jsx("button", { type: "button", "aria-label": cardCarouselPageLabel(i, count, noun), "aria-current": i === at ? 'true' : undefined, onClick: () => {
81
81
  onIndexChange(i);
82
82
  }, className: cn('flex size-6 items-center justify-center rounded-full focusable', COARSE_POINTER_ICON_TARGET), children: _jsx("span", { "aria-hidden": true, className: cn('size-2 rounded-full transition-control', i === at
83
83
  ? 'bg-primary forced-color-adjust-none forced-colors:bg-[Highlight]'
84
- : 'border border-muted-foreground') }) }, i))) }), _jsx(DSIconButton, { variant: "ghost", size: "sm", label: `Next ${lower}`, icon: _jsx(ChevronRight, { "aria-hidden": true }), "aria-disabled": at === count - 1 || undefined, className: END, onClick: () => {
84
+ : 'border border-muted-foreground') }) }, i))) }), _jsx(DSIconButton, { variant: "ghost", size: "sm", label: `Next ${lower}`, icon: _jsx(ChevronRight, { "aria-hidden": true }), disabled: at === count - 1, focusableWhenDisabled: true, className: END, onClick: () => {
85
85
  if (!(at === count - 1))
86
86
  onIndexChange(at + 1);
87
87
  } })] })), _jsx("span", { "aria-live": "polite", "aria-atomic": "true", className: "sr-only", children: spoken })] }));
@@ -1,9 +1,10 @@
1
1
  import type { Forwarded } from '../props';
2
+ import type { LoadingContract } from '../skeleton/skeleton';
2
3
  import { CHART_HUES } from '../lib/chart-hue';
3
4
  import type { ChartHue } from '../lib/chart-hue';
4
5
  import { formatChartValue } from '../lib/chart-value';
5
- export { CHART_AXIS_GAP_PX, CHART_GLYPH_PX, axisGutter } from '../lib/chart-ticks';
6
- export declare const CHART_KINDS: readonly ["line", "bar", "grouped-bar", "stacked-area"];
6
+ export { CHART_AXIS_GAP_PX, CHART_GLYPH_PX, CHART_MIN_LABEL_SPACING_PX, axisGutter, categorySpacing, labelStride, } from '../lib/chart-ticks';
7
+ export declare const CHART_KINDS: readonly ["line", "stacked-area"];
7
8
  export type ChartKind = (typeof CHART_KINDS)[number];
8
9
  import { CHART_MAX_SERIES } from '../lib/chart-series';
9
10
  export { CHART_MAX_SERIES };
@@ -15,6 +16,22 @@ export interface ChartSeries {
15
16
  /** One value per category, in category order. `null` is "no reading", which
16
17
  * is not zero: a line breaks over it and the table says so. */
17
18
  values: readonly (number | null)[];
19
+ /** The range the line sits in, as a low and a high per category. Line charts only; ignored on a comparison. */
20
+ band?: ChartBand | undefined;
21
+ }
22
+ /** The lowest and highest reading at each category, in category order. A
23
+ * category with either missing has no band there, and a low above its high is
24
+ * read the other way round rather than drawn inside out. */
25
+ export interface ChartBand {
26
+ low: readonly (number | null)[];
27
+ high: readonly (number | null)[];
28
+ }
29
+ /** The ends the value axis may be told to keep to. See `chartScale`. */
30
+ export interface ChartValueRange {
31
+ /** Where the axis starts. A line chart only: a stacked area is a whole, so it always starts at zero. */
32
+ min?: number | undefined;
33
+ /** Where the axis ends, so several small charts can share one ruler. */
34
+ max?: number | undefined;
18
35
  }
19
36
  /** A value the series are read against, a limit or a budget, drawn across the plot. */
20
37
  export interface ChartReference {
@@ -29,7 +46,7 @@ export interface ChartEvent {
29
46
  label: string;
30
47
  }
31
48
  /** The props every chart implementation must accept. */
32
- export interface ChartContract {
49
+ export interface ChartContract extends LoadingContract {
33
50
  kind: ChartKind;
34
51
  /** What the chart shows, the picture's accessible name and the table's
35
52
  * caption. A dashboard panel's own heading usually says the same thing;
@@ -44,8 +61,6 @@ export interface ChartContract {
44
61
  * empty chart that says nothing reads as a broken one and the reason it is
45
62
  * empty is the caller's to state ("No fills recorded this month"). */
46
63
  emptyDescription: string;
47
- /** First load. Renders the skeleton in the chart's own frame. */
48
- loading?: boolean | undefined;
49
64
  /** A caller's own sentence, when it has a better one than the generated
50
65
  * highest/lowest summary, "Spend has risen every month since March." */
51
66
  summary?: string | undefined;
@@ -61,6 +76,16 @@ export interface ChartContract {
61
76
  events?: readonly ChartEvent[] | undefined;
62
77
  /** The index of the one series that is the story; the others are drawn quiet, as context. Line charts only. */
63
78
  emphasis?: number | undefined;
79
+ /** The first category that is expected rather than measured. Line charts only. Needs `projectionLabel` and `projectionMarkerLabel`. */
80
+ projectFrom?: number | undefined;
81
+ /** The word for what is expected, in the legend, the readout, the table and the summary: "Expected". Required with `projectFrom`. */
82
+ projectionLabel?: string | undefined;
83
+ /** The word on the marker where measuring stops: "Today". Required with `projectFrom`. */
84
+ projectionMarkerLabel?: string | undefined;
85
+ /** The word for the range a band covers, in the legend, the readout, the table and the summary: "Likely range", "Lowest to highest paid". Required when a series has a band. */
86
+ bandLabel?: string | undefined;
87
+ /** Where the value axis starts and ends. Default: from zero to the highest figure. */
88
+ valueRange?: ChartValueRange | undefined;
64
89
  }
65
90
  export declare const CHART_FILL_PATTERNS: readonly ["solid", "hatch", "dots", "cross"];
66
91
  export type ChartFillPattern = (typeof CHART_FILL_PATTERNS)[number];
@@ -129,13 +154,20 @@ export declare const CHART_AXIS_BAND_PX = 24;
129
154
  export declare const CHART_TOP_PAD_PX = 8;
130
155
  /** Right edge, so the last marker is not cut in half. */
131
156
  export declare const CHART_RIGHT_PAD_PX = 8;
132
- /** The narrowest a category name may be given before names are thinned. */
133
- export declare const CHART_MIN_LABEL_SPACING_PX = 44;
157
+ /** Where a reference's word is set: its x, its baseline and which way it runs from x. */
158
+ export interface ChartReferenceLabelPlace {
159
+ x: number;
160
+ y: number;
161
+ anchor: 'start' | 'end';
162
+ }
163
+ /** Where a reference's word goes so no line crosses it. `lines` are the drawn
164
+ * lines, each the points it passes through in plot pixels. */
165
+ export declare function chartReferenceLabelPlace(ruleY: number, label: string, plotWidth: number, lines: readonly (readonly {
166
+ x: number;
167
+ y: number;
168
+ }[])[]): ChartReferenceLabelPlace;
134
169
  /** How far above the bottom of the axis band a category name sits. */
135
170
  export declare const CHART_CATEGORY_BASELINE_PX = 6;
136
- /** Below this bar width a patterned bar's edge is thinned, so the pattern,
137
- * the channel that is not colour, still has room inside it. */
138
- export declare const CHART_THIN_BAR_PX = 6;
139
171
  /** How many gridlines to aim for. The scale picks a round step near it. */
140
172
  export declare const CHART_TICK_TARGET = 4;
141
173
  export interface ChartScale {
@@ -146,31 +178,35 @@ export interface ChartScale {
146
178
  ticks: number[];
147
179
  }
148
180
  /**
149
- * The value axis. ALWAYS INCLUDES ZERO: a bar's length is its value and a bar
150
- * chart whose axis starts at 31 000 draws February as a third of August when it
151
- * was nine tenths of it. Lines share the rule so a line and a bar chart of the
152
- * same figures look like the same figures.
181
+ * The value axis. INCLUDES ZERO UNLESS TOLD OTHERWISE: a bar's length is its
182
+ * value and a bar chart whose axis starts at 31 000 draws February as a third
183
+ * of August when it was nine tenths of it. Lines share the rule so a line and a
184
+ * bar chart of the same figures look like the same figures.
185
+ *
186
+ * `range` is the one way out. `min` starts the axis there instead of at zero,
187
+ * for a line that is a range (a price per litre) rather than a quantity, and
188
+ * `max` ends it there, so a row of small charts can share one ruler. NEITHER
189
+ * CLIPS A READING: a figure or a band edge beyond the range pulls the axis out
190
+ * to reach it, because a chart that cuts off its own data is worse than two
191
+ * charts with different rulers. With a `min` given, zero is no longer forced
192
+ * into the other end either.
153
193
  */
154
194
  export declare function chartScale(series: readonly ChartSeries[], target?: number,
155
195
  /** Values the scale must reach that are not readings, a reference's. */
156
- reach?: readonly number[]): ChartScale;
196
+ reach?: readonly number[], range?: ChartValueRange): ChartScale;
197
+ /** The range a chart of this `kind` may use: a line may start where it likes,
198
+ * every other kind is drawn from zero whatever it is asked. */
199
+ export declare function chartRangeFor(kind: ChartKind, range: ChartValueRange | undefined): ChartValueRange;
157
200
  /** Where `value` sits, in pixels from the top of a plot `height` tall. */
158
201
  export declare function valueY(value: number, scale: ChartScale, height: number): number;
159
202
  export interface BandLayout {
160
203
  /** The width of one category's slot. */
161
204
  band: number;
162
- /** The width of one bar. */
163
- barWidth: number;
164
- /** The centre of category `index`, where a line's point and a name sit. */
205
+ /** The centre of category `index`, where a point and a name sit. */
165
206
  centre: (index: number) => number;
166
- /** The left edge of series `series`'s bar in category `index`. */
167
- barX: (index: number, series: number) => number;
168
207
  }
169
- /**
170
- * Category slots across a plot `width` wide. A single series is a group of one,
171
- * so a bar chart and a grouped bar chart are the same arithmetic.
172
- */
173
- export declare function bandLayout(categoryCount: number, seriesCount: number, width: number): BandLayout;
208
+ /** Category slots across a plot `width` wide, one point at the centre of each. */
209
+ export declare function bandLayout(categoryCount: number, width: number): BandLayout;
174
210
  /** The category under an x position in the plot, clamped to the ends: what a
175
211
  * pointer is over. `undefined` when there is nothing to land on. */
176
212
  export declare function chartCategoryAt(x: number, band: number, count: number): number | undefined;
@@ -180,52 +216,46 @@ export declare function chartCategoryAt(x: number, band: number, count: number):
180
216
  * wraps: a chart is a run in order, not a ring. */
181
217
  export declare function chartCategoryStep(current: number | undefined, step: number, count: number): number | undefined;
182
218
  export interface ChartSeriesPaths {
183
- /** The smooth line, one `M` per unbroken run of two or more readings. */
219
+ /** The smooth line, one `M` per unbroken run of two or more readings. With a
220
+ * projection, only the measured part of it. */
184
221
  line: string;
185
222
  /** The same runs closed down to the baseline, for the wash under the line. */
186
223
  area: string;
187
224
  /** Readings with no neighbour either side: a line cannot show them, so they
188
225
  * are drawn as marks. */
189
226
  lone: number[];
227
+ /** The expected part, the dashed run, or `''` without a projection. It starts
228
+ * ON the last measured point, so the dashes pick up where the solid line
229
+ * stops with no gap. */
230
+ projection: string;
231
+ /** Where the expected run ends, the last reading from `projectFrom` on, for the
232
+ * end dot. `undefined` without a projection. */
233
+ end: number | undefined;
190
234
  }
191
235
  /**
192
236
  * The path of one line series. A null breaks the line (joining across a missing
193
237
  * month would draw a reading nobody took) and each unbroken run is a monotone
194
238
  * curve through its points, so the line never rises above the higher of two
195
239
  * neighbours or falls below the lower.
240
+ *
241
+ * `projectFrom` splits it into the measured line and the expected one. ONE
242
+ * CURVE IS FITTED THROUGH THE WHOLE RUN and then cut at the boundary, so the
243
+ * dashes continue the solid line's own tangent: two curves fitted apart leave
244
+ * a kink exactly where the tense changes (the trend does the same).
196
245
  */
197
- export declare function chartSeriesPaths(values: readonly (number | null)[], x: (index: number) => number, y: (value: number) => number, baseline: number): ChartSeriesPaths;
198
- /** The corner radius of a bar `width` wide and `length` long: a full round cap
199
- * on a thin bar, capped so a wide one is still a bar and never a pill and
200
- * never more than the bar is long. */
201
- export declare const CHART_BAR_RADIUS_PX = 6;
202
- /** The reading edge's weight in pixels, the bar chart's `BAR_CHART_EDGE` weight. */
203
- export declare const CHART_BAR_EDGE_PX = 3;
204
- export declare function chartBarRadius(width: number, length: number): number;
205
- /**
206
- * A bar as a path, rounded at the end away from the baseline and flat where it
207
- * stands on it. `up` is true for a bar rising above its baseline. A bar of no
208
- * length has no path.
209
- */
210
- export declare function chartBarPath(x: number, y: number, width: number, length: number, up: boolean): string;
211
- /** A bar's far end as an open path, `inset` in from the end so a stroke of
212
- * twice that weight lands its outer edge on the value. It follows the same
213
- * rounded corners as `chartBarPath`. The reading edge a pack turns on with
214
- * `--chart-bar-mark` (TFN does, so these bars match the bar chart's). `''`
215
- * for a bar with no length. */
216
- export declare function chartBarEdgePath(x: number, y: number, width: number, length: number, up: boolean, inset: number): string;
217
- /**
218
- * Show every `n`th category name. Twenty-four hours at phone width do not fit
219
- * side by side and names drawn over each other are worse than names left out,
220
- * the table still has every one. The first category is always named.
221
- */
222
- export declare function labelStride(categoryCount: number, plotWidth: number, minSpacing?: number): number;
223
- /** The spacing category names need: the floor, or the widest name plus a gap,
224
- * whichever is more. "September" does not fit where "Sep" does. */
225
- export declare function categorySpacing(categories: readonly string[]): number;
246
+ export declare function chartSeriesPaths(values: readonly (number | null)[], x: (index: number) => number, y: (value: number) => number, baseline: number, projectFrom?: number): ChartSeriesPaths;
247
+ /** One band as a closed path: the high edge left to right, then the low edge
248
+ * back, each smoothed like the line so the band hugs it. A run of fewer than
249
+ * two categories has no width to draw, so it has no path. A category with a
250
+ * null at either end breaks the band, as a null breaks a line. */
251
+ export declare function chartBandPath(band: ChartBand, x: (index: number) => number, y: (value: number) => number): string;
252
+ /** A band cleaned to one low and high per category: a gap in either end is a
253
+ * gap in both (half a range is not a range), and a non-number is a gap. */
254
+ export declare function cleanBand(categories: readonly string[], band: ChartBand): ChartBand;
226
255
  /** Every series, cleaned: each padded or cut to one value per category, so a
227
256
  * short array is a gap rather than a crash. Not capped, the data table is the
228
- * one place that shows all of them. */
257
+ * one place that shows all of them. A comparison's band is dropped here: it is
258
+ * read against and has no range of its own to draw or to tell. */
229
259
  export declare function allSeries(categories: readonly string[], series: readonly ChartSeries[]): ChartSeries[];
230
260
  /** The series a chart draws: the first six, cleaned as `allSeries` does. */
231
261
  export declare function visibleSeries(categories: readonly string[], series: readonly ChartSeries[]): ChartSeries[];
@@ -236,20 +266,82 @@ export declare function chartSeriesCapNote(count: number): string;
236
266
  export declare function isChartEmpty(categories: readonly string[], series: readonly ChartSeries[]): boolean;
237
267
  /** What a builder is told, in development, when a chart is given more series than it draws. */
238
268
  export declare function chartSeriesCapIssue(count: number): string;
269
+ /** What is wrong with a chart's band, forecast and value range, in words a builder can act on. */
270
+ export declare function chartForecastIssues(chart: Pick<ChartContract, 'kind' | 'categories' | 'series'> & Partial<Pick<ChartContract, 'projectFrom' | 'projectionLabel' | 'projectionMarkerLabel' | 'bandLabel' | 'valueRange'>>): string[];
239
271
  /**
240
272
  * What is wrong with a chart's data, in words a builder can act on. Empty when
241
273
  * nothing is. The adapter draws what it can either way, a dashboard widget that
242
274
  * throws takes the dashboard with it and the stories and tests assert this is
243
275
  * empty for every chart they render.
244
276
  */
245
- export declare function chartIssues(chart: Pick<ChartContract, 'kind' | 'categories' | 'series'>): string[];
277
+ export declare function chartIssues(chart: Pick<ChartContract, 'kind' | 'categories' | 'series'> & Partial<Pick<ChartContract, 'projectFrom' | 'projectionLabel' | 'projectionMarkerLabel' | 'bandLabel' | 'valueRange'>>): string[];
246
278
  export { formatChartValue };
247
279
  /**
248
280
  * The text summary, rule 3. The span, then each series' highest and lowest,
249
281
  * with the category each fell in. Plain sentences in the order a person asks
250
282
  * the questions: what is this, over what and where did it peak.
251
283
  */
252
- export declare function describeChart(chart: Pick<ChartContract, 'kind' | 'categories' | 'series'>, format?: (value: number) => string): string;
284
+ export declare function describeChart(chart: Pick<ChartContract, 'kind' | 'categories' | 'series'> & Partial<Pick<ChartContract, 'projectFrom' | 'projectionLabel' | 'bandLabel'>>, format?: (value: number) => string, formatRange?: (low: string, high: string) => string, formatForecast?: (forecast: ChartForecastSentence) => string): string;
285
+ /** The default way a range is joined, "low – high". Language-neutral on
286
+ * purpose: a caller whose language joins them with a word passes
287
+ * `formatRange`. */
288
+ export declare function chartBandRangeDefault(low: string, high: string): string;
289
+ /** Where a series is expected to end, every part already formatted, for the
290
+ * caller to say in their own words. `low` and `high` are there when the
291
+ * series has a band at that category and `bandLabel` names it. */
292
+ export interface ChartForecastSentence {
293
+ /** The series' label: "Fuel spend". */
294
+ series: string;
295
+ /** The caller's word for what is expected: `projectionLabel`. */
296
+ projectionLabel: string;
297
+ /** The expected figure at the last category: "R556 700". */
298
+ value: string;
299
+ /** The category it is expected at: "31". */
300
+ at: string;
301
+ /** The caller's word for the band: `bandLabel`. */
302
+ bandLabel?: string | undefined;
303
+ low?: string | undefined;
304
+ high?: string | undefined;
305
+ }
306
+ /** `projectFrom` when it names a category after the first and before the end of
307
+ * the chart, else `undefined`: out of range draws the whole line as measured. */
308
+ export declare function chartProjectionIndex(projectFrom: number | undefined, count: number): number | undefined;
309
+ /** The words and figure formats a reading is told in. All of them the caller's. */
310
+ export interface ChartReadingWords {
311
+ /** The boundary, as `chartProjectionIndex` resolved it. */
312
+ projectFrom?: number | undefined;
313
+ projectionLabel?: string | undefined;
314
+ bandLabel?: string | undefined;
315
+ }
316
+ /** True when `index` of `series` is expected rather than measured: past the
317
+ * boundary, on a series that is not a comparison. */
318
+ export declare function chartIsExpected(series: Pick<ChartSeries, 'comparison'>, index: number, split: number | undefined): boolean;
319
+ /** The band of `series` at `index`, or `undefined` where it has none. */
320
+ export declare function chartBandAt(series: ChartSeries, index: number): {
321
+ low: number;
322
+ high: number;
323
+ } | undefined;
324
+ /** One line of a readout: a word and what it says, for a series or for its band. */
325
+ export interface ChartReadingRow {
326
+ kind: 'series' | 'band';
327
+ /** The series this row belongs to, an index into the drawn series. */
328
+ series: number;
329
+ label: string;
330
+ text: string;
331
+ /** True when there is no figure to read at this category. */
332
+ missing: boolean;
333
+ /** True for a series row that is expected rather than measured. */
334
+ expected: boolean;
335
+ }
336
+ /**
337
+ * What the readout says at one category, row by row. A measured figure is
338
+ * "Fuel spend R48 200"; an expected one takes the caller's word for it, so
339
+ * "Expected R572 000" when it is the only line drawn and "Fuel spend Expected
340
+ * R572 000" among several; and a band follows its series as its own row,
341
+ * "Likely range R550 000 to R594 000". The tooltip draws the rows and the
342
+ * slider speaks them, so what is seen and what is heard are the same words.
343
+ */
344
+ export declare function chartReadingRows(series: readonly ChartSeries[], index: number, words: ChartReadingWords, format: (value: number) => string, formatRange?: (low: string, high: string) => string): ChartReadingRow[];
253
345
  export { tableToggleLabel } from '../lib/chart-table';
254
346
  /** The kind that selects the trend. Optional on the props: a call site that
255
347
  * passes `values` and no `kind` draws a trend. */
@@ -271,8 +363,9 @@ export declare function chartCompareNeedsALabel(compare: readonly number[] | und
271
363
  export interface ChartTrendContract {
272
364
  /** `'trend'`, or absent. */
273
365
  kind?: Forwarded<typeof CHART_TREND_KIND>;
274
- /** The samples, evenly spaced, oldest first. Empty renders the empty state
275
- * rather than nothing, see `ChartTrendSpec.empty`. */
366
+ /** The samples, evenly spaced, oldest first. A non-finite sample (NaN, an
367
+ * unreported hour) is a hole: it keeps its slot and the line breaks there.
368
+ * Empty renders the empty state rather than nothing, see `ChartTrendSpec.empty`. */
276
369
  values: readonly number[];
277
370
  /** The index from which the line is drawn dotted: the part of the period
278
371
  * that has not happened yet. The SAME series, not a second one, a
@@ -295,9 +388,8 @@ export interface ChartPoint {
295
388
  x: number;
296
389
  y: number;
297
390
  value: number;
298
- /** Where this sample sits in the caller's OWN `values` array, not in the
299
- * cleaned list, so the caller's labels for that index still line up after
300
- * a hole has been dropped. */
391
+ /** Where this sample sits in the caller's OWN `values` array, so the
392
+ * caller's labels for that index line up whatever holes come before it. */
301
393
  index: number;
302
394
  }
303
395
  export interface ChartTrendSpec {
@@ -307,6 +399,9 @@ export interface ChartTrendSpec {
307
399
  empty: boolean;
308
400
  /** The top of the domain. `0` when every sample is zero, the flat case. */
309
401
  max: number;
402
+ /** Where zero sits, down the drawing (0 at the top, 100 at the bottom). The floor, unless a
403
+ * reading is under zero. The one hairline a trend draws, since it has no value axis. */
404
+ zero: number;
310
405
  /** The last finite sample, for the value label the adapter holds at the
311
406
  * right edge. `undefined` when `empty`. */
312
407
  last: number | undefined;
@@ -335,6 +430,10 @@ export interface ChartTrendSpec {
335
430
  * `empty`. A single sample is one point, at the right edge where its flat
336
431
  * line ends. */
337
432
  points: readonly ChartPoint[];
433
+ /** Samples with a hole on both sides. The line marks each with a dot of no
434
+ * length; an adapter draws a visible dot on each as well, the full chart's
435
+ * mark for a lone reading. Empty when `empty`. */
436
+ lone: readonly ChartPoint[];
338
437
  /** The last MEASURED sample, where the solid line ends and a projection,
339
438
  * if any, begins. What the live end marker sits on. `undefined` when
340
439
  * `empty`. */
@@ -368,8 +467,25 @@ export declare function chartNearest(points: readonly ChartPoint[], fraction: nu
368
467
  * and a step left at the last, which is where a reader expects each to begin.
369
468
  */
370
469
  export declare function chartStep(points: readonly ChartPoint[], from: ChartPoint | undefined, step: number): ChartPoint | undefined;
470
+ export interface ChartOverReference {
471
+ series: number;
472
+ index: number;
473
+ value: number;
474
+ }
475
+ /** The samples above the lowest reference, in series and category order. Empty
476
+ * without a reference. On a `stacked-area` chart the reader reads the top of
477
+ * the stack, so the stack's total is what the limit judges, not each part.
478
+ * `projectFrom` keeps expected samples out: a forecast has not passed anything
479
+ * yet, so the caller says those separately (see `describeMarks`). */
480
+ export declare function chartOverReference(series: readonly ChartSeries[], references: readonly ChartReference[], options?: {
481
+ kind?: ChartKind;
482
+ projectFrom?: number | undefined;
483
+ }): ChartOverReference[];
371
484
  /** The sentences a chart's references and events add to its summary, so what the picture marks is also said. */
372
- export declare function describeMarks(references: readonly ChartReference[], events: readonly ChartEvent[], categories: readonly string[], formatValue: (value: number) => string): string;
485
+ export declare function describeMarks(references: readonly ChartReference[], events: readonly ChartEvent[], categories: readonly string[], formatValue: (value: number) => string, series?: readonly ChartSeries[], options?: {
486
+ kind?: ChartKind;
487
+ projectFrom?: number | undefined;
488
+ }): string;
373
489
  /** The running top of each series, oldest series at the bottom. A hole stacks as zero; a negative as zero. */
374
490
  export declare function chartStack(series: readonly ChartSeries[]): ChartSeries[];
375
491
  /** Each band as a closed path from its top edge back along the one under it, and its top edge alone as a line. */