@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
@@ -0,0 +1,124 @@
1
+ import { chartShare, clean, niceStep } from '../lib/chart-ticks';
2
+ export const BOX_PLOT_WHISKER_IQR = 1.5;
3
+ export const BOX_PLOT_TARGET_TICKS = 4;
4
+ export function boxPlotQuantile(sorted, p) {
5
+ if (sorted.length === 0)
6
+ return undefined;
7
+ const position = Math.min(1, Math.max(0, p)) * (sorted.length - 1);
8
+ const below = Math.floor(position);
9
+ const above = Math.ceil(position);
10
+ const low = sorted[below] ?? 0;
11
+ const high = sorted[above] ?? low;
12
+ return low + (high - low) * (position - below);
13
+ }
14
+ const named = (reading) => typeof reading === 'number' ? { value: reading, label: undefined } : { value: reading.value, label: reading.label };
15
+ const finite = (readings) => readings.map(named).filter((r) => Number.isFinite(r.value));
16
+ export function boxPlotSummary(readings) {
17
+ const kept = finite(readings).toSorted((a, b) => a.value - b.value);
18
+ if (kept.length === 0)
19
+ return undefined;
20
+ const values = kept.map((r) => r.value);
21
+ const q1 = boxPlotQuantile(values, 0.25) ?? 0;
22
+ const median = boxPlotQuantile(values, 0.5) ?? 0;
23
+ const q3 = boxPlotQuantile(values, 0.75) ?? 0;
24
+ const reach = (q3 - q1) * BOX_PLOT_WHISKER_IQR;
25
+ const low = q1 - reach;
26
+ const high = q3 + reach;
27
+ const inside = kept.filter((r) => r.value >= low && r.value <= high);
28
+ const min = inside[0]?.value ?? q1;
29
+ const max = inside[inside.length - 1]?.value ?? q3;
30
+ return { min, q1, median, q3, max, outliers: kept.filter((r) => r.value < low || r.value > high) };
31
+ }
32
+ function figuresOf(group) {
33
+ if (group.figures !== undefined) {
34
+ const { min, q1, median, q3, max } = group.figures;
35
+ const ordered = [min, q1, median, q3, max].every((v) => Number.isFinite(v)) &&
36
+ min <= q1 &&
37
+ q1 <= median &&
38
+ median <= q3 &&
39
+ q3 <= max;
40
+ if (!ordered)
41
+ return undefined;
42
+ return {
43
+ min,
44
+ q1,
45
+ median,
46
+ q3,
47
+ max,
48
+ outliers: finite(group.figures.outliers ?? []).toSorted((a, b) => a.value - b.value),
49
+ };
50
+ }
51
+ return boxPlotSummary(group.readings ?? []);
52
+ }
53
+ export function boxPlotScale(lo, hi) {
54
+ const span = hi - lo > 0 ? hi - lo : Math.max(Math.abs(hi), 1);
55
+ const step = niceStep(span / BOX_PLOT_TARGET_TICKS);
56
+ let min = Math.floor(lo / step + 1e-9) * step;
57
+ const max = Math.ceil(hi / step - 1e-9) * step;
58
+ if (max === min)
59
+ min -= step;
60
+ const count = Math.round((max - min) / step);
61
+ return {
62
+ min: clean(min, step),
63
+ max: clean(max, step),
64
+ ticks: Array.from({ length: count + 1 }, (_, i) => clean(min + i * step, step)),
65
+ };
66
+ }
67
+ export function boxPlotSpec(groups, options = {}) {
68
+ const reference = options.reference !== undefined && Number.isFinite(options.reference) ? options.reference : undefined;
69
+ const summaries = groups.map(figuresOf);
70
+ const marks = summaries.flatMap((s) => (s === undefined ? [] : [s.min, s.max, ...s.outliers.map((o) => o.value)]));
71
+ if (marks.length === 0) {
72
+ return { empty: true, rows: [], scale: boxPlotScale(0, 1), referenceAt: undefined, outlierCount: 0 };
73
+ }
74
+ const scale = boxPlotScale(Math.min(...marks, reference ?? Infinity), Math.max(...marks, reference ?? -Infinity));
75
+ const place = (v) => Math.min(100, Math.max(0, chartShare(v, scale)));
76
+ const rows = groups.map((group, i) => {
77
+ const s = summaries[i];
78
+ if (s === undefined)
79
+ return { label: group.label, missing: true, stats: undefined, at: undefined, outliers: [] };
80
+ const { outliers, ...stats } = s;
81
+ return {
82
+ label: group.label,
83
+ missing: false,
84
+ stats,
85
+ at: {
86
+ min: place(stats.min),
87
+ q1: place(stats.q1),
88
+ median: place(stats.median),
89
+ q3: place(stats.q3),
90
+ max: place(stats.max),
91
+ },
92
+ outliers: outliers.map((o) => ({ value: o.value, label: o.label, at: place(o.value) })),
93
+ };
94
+ });
95
+ return {
96
+ empty: false,
97
+ rows,
98
+ scale,
99
+ referenceAt: reference === undefined ? undefined : place(reference),
100
+ outlierCount: rows.reduce((sum, row) => sum + row.outliers.length, 0),
101
+ };
102
+ }
103
+ export const BOX_PLOT_REFERENCE_NEEDS_A_LABEL = 'A box plot with a reference needs referenceLabel, or the dashed line has no name. Pass the words for it: "Fleet target, 12".';
104
+ export function boxPlotNeedsReferenceLabel(reference, referenceLabel) {
105
+ return reference !== undefined && (referenceLabel === undefined || referenceLabel.trim() === '');
106
+ }
107
+ export function boxPlotFlag(flagOutliers) {
108
+ return flagOutliers === undefined || flagOutliers.trim() === '' ? undefined : flagOutliers;
109
+ }
110
+ function lowerFirst(text) {
111
+ return text.charAt(0).toLocaleLowerCase() + text.slice(1);
112
+ }
113
+ export function boxPlotReadout(row, words, format) {
114
+ const { stats, outliers, flag } = row;
115
+ const parts = [`${words.median} ${format(stats.median)}`, `${lowerFirst(words.box)} ${format(stats.q1)} to ${format(stats.q3)}`];
116
+ if (outliers.length > 0) {
117
+ const count = `${String(outliers.length)} ${lowerFirst(outliers.length === 1 ? words.outlier : words.outliers)}`;
118
+ const list = outliers.map((o) => (o.label === undefined ? format(o.value) : `${o.label} ${format(o.value)}`)).join(', ');
119
+ parts.push(outliers.some((o) => o.label !== undefined) ? `${count}: ${list}` : count);
120
+ if (flag !== undefined)
121
+ parts.push(flag);
122
+ }
123
+ return parts.join(', ');
124
+ }
@@ -0,0 +1,8 @@
1
+ import { type ComponentProps } from 'react';
2
+ import { type BoxPlotContract } from '../box-plot';
3
+ export type DSBoxPlotProps = Omit<ComponentProps<'figure'>, 'children' | 'aria-labelledby' | 'aria-busy'> & BoxPlotContract & {
4
+ /** How a reading is written, on the axis, in the readout and in the table: "11.2 L". */
5
+ formatValue?: (value: number) => string;
6
+ };
7
+ /** Each group's spread on one axis: a box for the middle half, a tick for the median and a dot for every outlier. */
8
+ export declare function DSBoxPlot({ label, groups, keyLabels, tableLabels, emptyLabel, flagOutliers, reference, referenceLabel, formatReadout, loading, loadingLabel, labelHidden, formatValue, className, ...props }: DSBoxPlotProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,57 @@
1
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
2
+ import { useId } from 'react';
3
+ import { DSButton } from '../../button/web/ds-button';
4
+ import { DSEmptyState } from '../../empty-state/web/ds-empty-state';
5
+ import { chartContextColor, CHART_NO_DATA } from '../../lib/chart-context';
6
+ import { CHART_TABLE_CLASSES as T } from '../../lib/chart-table';
7
+ import { chartShare } from '../../lib/chart-ticks';
8
+ import { formatChartValue } from '../../lib/chart-value';
9
+ import { cn } from '../../lib/cn';
10
+ import { ChartFigures, useChartFigures } from '../../lib/web/chart-figures';
11
+ import { useChartPoints } from '../../lib/web/use-chart-points';
12
+ import { SpokenRegion } from '../../lib/web/spoken-region';
13
+ import { LOADING_ROWS, loadingSpoken } from '../../skeleton/skeleton';
14
+ import { DSSkeleton } from '../../skeleton/web/ds-skeleton';
15
+ import { DSText } from '../../text/web/ds-text';
16
+ import { BOX_PLOT_REFERENCE_NEEDS_A_LABEL, boxPlotFlag, boxPlotNeedsReferenceLabel, boxPlotReadout, boxPlotSpec, } from '../box-plot';
17
+ const BOX_FILL = { background: chartContextColor(0) };
18
+ const INSET = 'inset-x-5';
19
+ const COLUMNS = 'minmax(6rem, 34%) 1fr';
20
+ const SKELETON_BOXES = ['left-1/4 w-1/3', 'left-1/3 w-2/5', 'left-1/5 w-1/4'];
21
+ function BoxPlotSkeleton() {
22
+ return (_jsxs("div", { "aria-busy": true, className: "flex flex-col gap-3", "data-chart-loading": "", children: [_jsxs("div", { className: "grid", style: { gridTemplateColumns: COLUMNS }, children: [Array.from({ length: LOADING_ROWS }, (_, i) => (_jsxs("div", { className: "contents", children: [_jsx("div", { className: "flex min-h-10 items-center py-1.5 pe-3", children: _jsx(DSSkeleton, { fits: "body-sm", className: "w-3/4" }) }), _jsx("div", { className: "relative min-h-10", children: _jsx("div", { className: cn('absolute inset-y-0', INSET), children: _jsx(DSSkeleton, { className: cn('absolute top-1/2 h-5 -translate-y-1/2', SKELETON_BOXES[i % SKELETON_BOXES.length]) }) }) })] }, i))), _jsx("div", { className: "col-start-2 flex h-6 items-end justify-between px-3", children: Array.from({ length: 4 }, (_, i) => (_jsx(DSSkeleton, { fits: "label-sm", className: "w-6" }, i))) })] }), _jsx("div", { className: "min-h-5" }), _jsx("div", { className: "flex flex-wrap gap-x-4 gap-y-1", children: Array.from({ length: 4 }, (_, i) => (_jsx(DSSkeleton, { fits: "label-sm", className: "w-16" }, i))) })] }));
23
+ }
24
+ export function DSBoxPlot({ label, groups, keyLabels, tableLabels, emptyLabel, flagOutliers, reference, referenceLabel, formatReadout, loading = false, loadingLabel, labelHidden = false, formatValue = formatChartValue, className, ...props }) {
25
+ const spec = boxPlotSpec(groups, { reference });
26
+ const captionId = useId();
27
+ const figures = useChartFigures();
28
+ const flag = boxPlotFlag(flagOutliers);
29
+ const flagged = flag !== undefined && spec.outlierCount > 0;
30
+ const roving = useChartPoints(spec.rows.length);
31
+ const inspected = roving.inspected === undefined ? undefined : spec.rows[roving.inspected];
32
+ const named = referenceLabel !== undefined && referenceLabel.trim() !== '' && spec.referenceAt !== undefined;
33
+ const reading = (row) => {
34
+ if (row.stats === undefined)
35
+ return `${row.label}: ${CHART_NO_DATA}`;
36
+ const told = {
37
+ group: row.label,
38
+ stats: row.stats,
39
+ outliers: row.outliers.map((o) => ({ value: o.value, label: o.label })),
40
+ flag: flagged && row.outliers.length > 0 ? flag : undefined,
41
+ };
42
+ return `${row.label}: ${(formatReadout ?? ((r) => boxPlotReadout(r, keyLabels, formatValue)))(told)}`;
43
+ };
44
+ if (process.env['NODE_ENV'] !== 'production' && boxPlotNeedsReferenceLabel(reference, referenceLabel)) {
45
+ console.error(`DSBoxPlot: ${BOX_PLOT_REFERENCE_NEEDS_A_LABEL}`);
46
+ }
47
+ const header = named ? 1 : 0;
48
+ const first = header + 1;
49
+ const columns = COLUMNS;
50
+ const layer = (rows) => ({ gridColumn: 2, gridRow: `1 / span ${String(rows)}` });
51
+ const dot = (row, i) => (_jsx("span", { "aria-hidden": true, "data-forced-colors": "mark", "data-box-plot-outlier": flagged ? 'flagged' : 'plain', className: cn('ring-card absolute top-1/2 size-2 -translate-x-1/2 -translate-y-1/2 rounded-full ring-2', flagged ? 'bg-chart-needs-you' : 'bg-chart-series-1'), style: { left: `${String(row.at)}%` } }, i));
52
+ return (_jsxs("figure", { "aria-labelledby": captionId, "data-forced-colors": "chart", className: cn('m-0 flex min-w-0 flex-col gap-3', className), ...props, children: [_jsx("figcaption", { id: captionId, className: labelHidden ? 'sr-only' : undefined, children: _jsx(DSText, { as: "span", variant: "body-sm-strong", children: label }) }), _jsx(SpokenRegion, { text: loadingSpoken(loading, loadingLabel) }), loading ? (_jsx(BoxPlotSkeleton, {})) : spec.empty ? (_jsx(DSEmptyState, { description: emptyLabel, className: "flex h-48 flex-col items-center justify-center" })) : (_jsxs(_Fragment, { children: [_jsxs("div", { role: "group", "aria-label": label, className: "grid", style: { gridTemplateColumns: columns }, "data-box-plot-plot": "", ...roving.group, children: [_jsx("div", { "aria-hidden": true, className: "pointer-events-none relative", style: layer(spec.rows.length + header), children: _jsx("div", { className: cn('absolute inset-y-0', INSET), children: spec.scale.ticks.map((tick) => (_jsx("span", { className: "bg-border-subtle absolute inset-y-0 w-px", style: { left: `${String(chartShare(tick, spec.scale))}%` } }, tick))) }) }), spec.rows.map((row, i) => (_jsxs("div", { className: "contents", children: [_jsx(DSText, { as: "span", variant: "body-sm", "aria-hidden": true, className: "flex min-h-10 items-center py-1.5 pe-3", style: { gridColumn: 1, gridRow: first + i }, children: row.label }), _jsx("div", { role: "img", "aria-label": reading(row), ...roving.point(i), className: "focusable relative min-h-10 rounded-xs", style: { gridColumn: 2, gridRow: first + i }, "data-box-plot-row": "", "data-box-plot-missing": row.missing ? '' : undefined, "data-box-plot-inspected": inspected === row ? '' : undefined, children: _jsx("div", { "aria-hidden": true, className: cn('absolute inset-y-0', INSET), children: row.at === undefined ? (_jsx(DSText, { as: "span", variant: "label-sm", className: "text-muted-foreground absolute top-1/2 left-0 -translate-y-1/2", children: CHART_NO_DATA })) : (_jsxs(_Fragment, { children: [_jsx("span", { "data-forced-colors": "mark", "data-box-plot-whisker": "", className: "bg-muted-foreground absolute top-1/2 h-px", style: { left: `${String(row.at.min)}%`, width: `${String(row.at.max - row.at.min)}%` } }), [row.at.min, row.at.max].map((at, end) => (_jsx("span", { "data-forced-colors": "mark", "data-box-plot-cap": "", className: "bg-muted-foreground absolute top-1/2 h-2.5 w-px -translate-x-1/2 -translate-y-1/2", style: { left: `${String(at)}%` } }, end))), _jsx("span", { "data-forced-colors": "mark", "data-box-plot-box": "", className: "absolute top-1/2 h-5 -translate-y-1/2 rounded-xxs", style: {
53
+ ...BOX_FILL,
54
+ left: `${String(row.at.q1)}%`,
55
+ width: `max(${String(row.at.q3 - row.at.q1)}%, 2px)`,
56
+ } }), _jsx("span", { "data-forced-colors": "mark", "data-box-plot-median": "", className: "bg-chart-series-1 absolute top-1/2 h-6 w-0.5 -translate-x-1/2 -translate-y-1/2 rounded-full", style: { left: `${String(row.at.median)}%` } }), row.outliers.map(dot)] })) }) })] }, i))), spec.referenceAt !== undefined && (_jsx("div", { "aria-hidden": true, className: "pointer-events-none relative", style: layer(spec.rows.length + header), children: _jsx("div", { className: cn('absolute inset-y-0', INSET), children: _jsxs("span", { "data-box-plot-reference": "", className: "absolute inset-y-0 w-0.5 -translate-x-1/2", style: { left: `${String(spec.referenceAt)}%` }, children: [_jsx("svg", { "aria-hidden": true, className: "absolute inset-0 size-full overflow-visible", focusable: "false", children: _jsx("line", { x1: "50%", y1: 0, x2: "50%", y2: "100%", className: "stroke-foreground", strokeWidth: 2, strokeDasharray: "4 3", "data-chart-ink": "stroke" }) }), named && (_jsx(DSText, { as: "span", variant: "label-sm", className: cn('text-muted-foreground absolute top-0 whitespace-nowrap', spec.referenceAt > 60 ? 'end-2' : 'start-2'), children: referenceLabel }))] }) }) })), _jsx("div", { "aria-hidden": true, className: "relative h-6 tabular-nums", style: { gridColumn: 2, gridRow: first + spec.rows.length }, "data-box-plot-axis": "", children: _jsx("div", { className: cn('absolute inset-y-0', INSET), children: spec.scale.ticks.map((tick) => (_jsx(DSText, { as: "span", variant: "label-sm", className: "text-muted-foreground absolute top-1 -translate-x-1/2 whitespace-nowrap", style: { left: `${String(chartShare(tick, spec.scale))}%` }, children: formatValue(tick) }, tick))) }) })] }), named && _jsx("span", { className: "sr-only", children: referenceLabel }), _jsx(DSText, { as: "p", variant: "body-sm", "aria-hidden": true, className: "min-h-5 tabular-nums", "data-box-plot-readout": "", children: inspected === undefined ? '' : reading(inspected) }), _jsxs("div", { "aria-hidden": true, className: "flex flex-wrap gap-x-4 gap-y-1", "data-box-plot-key": "", children: [_jsxs(DSText, { as: "span", variant: "label-sm", className: "text-muted-foreground flex items-center gap-1.5", children: [_jsx("span", { "data-forced-colors": "mark", className: "inline-block h-3 w-4 shrink-0 rounded-xxs", style: BOX_FILL }), keyLabels.box] }), _jsxs(DSText, { as: "span", variant: "label-sm", className: "text-muted-foreground flex items-center gap-1.5", children: [_jsx("span", { "data-forced-colors": "mark", className: "bg-chart-series-1 inline-block h-3.5 w-0.5 shrink-0 rounded-full" }), keyLabels.median] }), _jsxs(DSText, { as: "span", variant: "label-sm", className: "text-muted-foreground flex items-center gap-1.5", children: [_jsx("svg", { "aria-hidden": true, viewBox: "0 0 20 10", className: "stroke-muted-foreground h-2.5 w-5 shrink-0 fill-none", "data-forced-colors": "mark", children: _jsx("path", { d: "M0.5 0V10M19.5 0V10M0 5H20", strokeWidth: 1, vectorEffect: "non-scaling-stroke" }) }), keyLabels.whiskers] }), _jsxs(DSText, { as: "span", variant: "label-sm", className: "text-muted-foreground flex items-center gap-1.5", children: [_jsx("span", { "data-forced-colors": "mark", "data-box-plot-key-outlier": flagged ? 'flagged' : 'plain', className: cn('inline-block size-2 shrink-0 rounded-full', flagged ? 'bg-chart-needs-you' : 'bg-chart-series-1') }), flagged ? `${keyLabels.outliers}: ${flag}` : keyLabels.outliers] })] }), _jsx("div", { children: _jsx(DSButton, { variant: "link", quiet: true, labelSize: "sm", ...figures.toggle, children: figures.label }) }), _jsxs(ChartFigures, { figures: figures, caption: label, children: [_jsx("thead", { children: _jsxs("tr", { children: [_jsx("th", { scope: "col", className: T.columnHead, children: tableLabels.group }), ['min', 'q1', 'median', 'q3', 'max'].map((figure) => (_jsx("th", { scope: "col", className: T.figureHead, children: tableLabels[figure] }, figure))), _jsx("th", { scope: "col", className: T.noteHead, children: tableLabels.outliers })] }) }), _jsx("tbody", { children: spec.rows.map((row, i) => (_jsxs("tr", { className: T.row, children: [_jsx("th", { scope: "row", className: T.rowHead, children: row.label }), row.stats === undefined ? (_jsx("td", { colSpan: 6, className: T.note, children: _jsx("span", { className: "text-muted-foreground", children: CHART_NO_DATA }) })) : (_jsxs(_Fragment, { children: [_jsx("td", { className: T.figure, children: formatValue(row.stats.min) }), _jsx("td", { className: T.figure, children: formatValue(row.stats.q1) }), _jsx("td", { className: T.figure, children: formatValue(row.stats.median) }), _jsx("td", { className: T.figure, children: formatValue(row.stats.q3) }), _jsx("td", { className: T.figure, children: formatValue(row.stats.max) }), _jsx("td", { className: T.note, children: row.outliers.map((o, at) => (_jsxs("div", { className: "tabular-nums", children: [o.label === undefined ? formatValue(o.value) : `${o.label}: ${formatValue(o.value)}`, flagged && _jsx("span", { className: "text-muted-foreground", children: `, ${flag}` })] }, at))) })] }))] }, i))) })] })] }))] }));
57
+ }
@@ -118,7 +118,7 @@ export function DSBrandLockup({ overDark = false, size, bare = false, entrance =
118
118
  ...(typeof accent === 'string' ? { accent } : {}),
119
119
  ...(typeof tag === 'string' ? { tag } : {}),
120
120
  });
121
- return (_jsxs(View, { accessible: true, accessibilityRole: "image", ...(label === undefined ? {} : { accessibilityLabel: label }), className: cn('flex-row items-center', ROW_GAP[step], entrance && !reduced && 'animate-slide-in', className), ...props, children: [mark !== undefined && logo === undefined && (_jsx(View, { testID: "brand-lockup-mark", className: cn('shrink-0 items-center justify-center overflow-hidden', MARK_BOX[step], MARK_PAD[step], !bare && 'rounded-chip ios:shadow-md android:elevation-sm', !bare && MARK_SURFACE[spec.markSurface]), style: fontScale === 1 ? undefined : { width: markSize, height: markSize }, children: typeof mark === 'string' || typeof mark === 'number' ? (_jsx(DSText, { className: MARK_INK[spec.markInk], children: mark })) : (fitToMark(mark)) })), _jsxs(View, { className: "shrink", children: [logo === undefined ? (_jsxs(DSText, { testID: "brand-lockup-name", numberOfLines: 1, className: cn(logoWord
121
+ return (_jsxs(View, { accessible: true, accessibilityRole: "image", ...(label === undefined ? {} : { accessibilityLabel: label }), className: cn('flex-row items-center', ROW_GAP[step], entrance && !reduced && 'animate-slide-in', className), ...props, children: [mark !== undefined && logo === undefined && (_jsx(View, { testID: "brand-lockup-mark", className: cn('shrink-0 items-center justify-center overflow-hidden', MARK_BOX[step], MARK_PAD[step], !bare && 'rounded-chip ios:shadow-low android:elevation-sm', !bare && MARK_SURFACE[spec.markSurface]), style: fontScale === 1 ? undefined : { width: markSize, height: markSize }, children: typeof mark === 'string' || typeof mark === 'number' ? (_jsx(DSText, { className: MARK_INK[spec.markInk], children: mark })) : (fitToMark(mark)) })), _jsxs(View, { className: "shrink", children: [logo === undefined ? (_jsxs(DSText, { testID: "brand-lockup-name", numberOfLines: 1, className: cn(logoWord
122
122
  ? 'font-logo text-logo'
123
123
  : ['font-wordmark-primary leading-none tracking-wordmark', NAME_TEXT[step]], tag === undefined ? undefined : 'mb-1', NAME_INK[spec.nameInk]), children: [name, accent !== undefined ? (_jsx(DSText, { testID: "brand-lockup-accent", className: cn('font-wordmark-accent leading-none tracking-wordmark', NAME_TEXT[step], ACCENT_INK[spec.accentInk]), children: accent })) : null] })) : (_jsx(View, { testID: "brand-lockup-logo", className: cn('items-start justify-center', LOGO_BOX[step], tag === undefined ? undefined : 'mb-1'), style: fontScale === 1 ? undefined : { height: logoHeight }, children: typeof logo === 'string' || typeof logo === 'number' ? (_jsx(DSText, { className: NAME_INK[spec.nameInk], children: logo })) : (fitToLogo(logo, logoHeight)) })), tag !== undefined ? (_jsx(DSText, { testID: "brand-lockup-tag", numberOfLines: 2, className: cn('font-semibold uppercase', TAG_TEXT[step], TAG_INK[spec.tagInk]), children: tag })) : null] })] }));
124
124
  }
@@ -0,0 +1,29 @@
1
+ import type { ReactNode } from 'react';
2
+ /** Every brand pack the token package ships. `brand-provider.test.ts` holds this
3
+ * to the generated brand data, so a pack cannot ship without being listed. */
4
+ export declare const BRANDS: readonly ["engen", "kilomita", "lcv", "tfn", "vodafuel"];
5
+ export type Brand = (typeof BRANDS)[number];
6
+ /** Each brand has a light and a dark theme. */
7
+ export declare const BRAND_THEMES: readonly ["light", "dark"];
8
+ export type BrandTheme = (typeof BRAND_THEMES)[number];
9
+ /** What a screen gets with no provider at all: the base pack in light. */
10
+ export declare const BASE_BRAND: Brand;
11
+ export declare function isBrand(value: unknown): value is Brand;
12
+ /** The props both adapters take. */
13
+ export interface BrandProviderContract {
14
+ /** The brand pack every token resolves against. */
15
+ brand: Brand;
16
+ /** Light or dark. */
17
+ theme: BrandTheme;
18
+ children: ReactNode;
19
+ }
20
+ export interface BrandProviderSpec {
21
+ /** The `data-brand` value on the web. */
22
+ attribute: Brand;
23
+ /** Whether the `dark` class is on. */
24
+ dark: boolean;
25
+ /** The colour scheme React Native is pinned to. */
26
+ scheme: BrandTheme;
27
+ }
28
+ /** What a brand and a theme mean on each platform. */
29
+ export declare function brandProviderSpec(brand: Brand, theme: BrandTheme): BrandProviderSpec;
@@ -0,0 +1,9 @@
1
+ export const BRANDS = ['engen', 'kilomita', 'lcv', 'tfn', 'vodafuel'];
2
+ export const BRAND_THEMES = ['light', 'dark'];
3
+ export const BASE_BRAND = 'tfn';
4
+ export function isBrand(value) {
5
+ return typeof value === 'string' && BRANDS.includes(value);
6
+ }
7
+ export function brandProviderSpec(brand, theme) {
8
+ return { attribute: brand, dark: theme === 'dark', scheme: theme };
9
+ }
@@ -0,0 +1,11 @@
1
+ import { type BrandProviderContract } from '../brand-provider';
2
+ export type DSBrandProviderProps = BrandProviderContract;
3
+ /** Sets the brand and theme for the app. Put it once, at the root.
4
+ *
5
+ * React Native has no DOM, so a brand cannot be an attribute the way it is on
6
+ * the web. The brand's values for the theme are handed to everything inside as
7
+ * runtime variables instead. React Native's own colour scheme is pinned to the
8
+ * same theme, because the compiled `.dark:root` block follows it, not the
9
+ * variables: left to the phone's setting, a dark handset would draw light
10
+ * components on dark root values. */
11
+ export declare function DSBrandProvider({ brand, theme, children }: DSBrandProviderProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,18 @@
1
+ import { jsx as _jsx } from "react/jsx-runtime";
2
+ import { useEffect } from 'react';
3
+ import { Appearance } from 'react-native';
4
+ import { VariableContextProvider } from 'nativewind';
5
+ import brandArtifact from '@tfn-design/design-tokens/brands.generated.json';
6
+ import { brandProviderSpec } from '../brand-provider';
7
+ export function DSBrandProvider({ brand, theme, children }) {
8
+ const { scheme } = brandProviderSpec(brand, theme);
9
+ useEffect(() => {
10
+ if (!('setColorScheme' in Appearance))
11
+ return undefined;
12
+ Appearance.setColorScheme(scheme);
13
+ return () => {
14
+ Appearance.setColorScheme(null);
15
+ };
16
+ }, [scheme]);
17
+ return (_jsx(VariableContextProvider, { value: brandArtifact.brands[brand][theme], children: children }));
18
+ }
@@ -0,0 +1,10 @@
1
+ import { type BrandProviderContract } from '../brand-provider';
2
+ export type DSBrandProviderProps = BrandProviderContract;
3
+ /** Sets the brand and theme for the whole page, on `<html>`, so overlays that
4
+ * render outside the app's tree get them too. Put it once, at the root.
5
+ *
6
+ * It applies before the first paint on the client. A page rendered on the
7
+ * server should also write the same `data-brand` and `dark` class into its
8
+ * HTML, so nothing paints in the base brand first. Unmounting puts back
9
+ * whatever was there before. */
10
+ export declare function DSBrandProvider({ brand, theme, children }: DSBrandProviderProps): import("react/jsx-runtime").JSX.Element;
@@ -0,0 +1,20 @@
1
+ import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
2
+ import { useLayoutEffect } from 'react';
3
+ import { brandProviderSpec } from '../brand-provider';
4
+ export function DSBrandProvider({ brand, theme, children }) {
5
+ useLayoutEffect(() => {
6
+ const root = document.documentElement;
7
+ const { attribute, dark } = brandProviderSpec(brand, theme);
8
+ const before = { brand: root.dataset['brand'], dark: root.classList.contains('dark') };
9
+ root.dataset['brand'] = attribute;
10
+ root.classList.toggle('dark', dark);
11
+ return () => {
12
+ if (before.brand === undefined)
13
+ delete root.dataset['brand'];
14
+ else
15
+ root.dataset['brand'] = before.brand;
16
+ root.classList.toggle('dark', before.dark);
17
+ };
18
+ }, [brand, theme]);
19
+ return _jsx(_Fragment, { children: children });
20
+ }
@@ -1,4 +1,5 @@
1
1
  import type { Forwarded } from '../props';
2
+ import type { LoadingContract } from '../skeleton/skeleton';
2
3
  export declare const BULLET_STATES: readonly ["within", "near", "over"];
3
4
  export type BulletState = (typeof BULLET_STATES)[number];
4
5
  /** How far past the larger of the reading and the target the scale runs, so
@@ -14,19 +15,24 @@ export interface BulletRow {
14
15
  value: number;
15
16
  /** The target or limit, drawn as the dark tick. */
16
17
  target: number;
17
- /** The figures in words beside the label: "R 72k of R 80k". Defaults to the
18
+ /** The figures in words beside the label: "R72k of R80k". Defaults to the
18
19
  * reading and the target through the chart's `formatValue`. */
19
20
  caption?: Forwarded<string>;
20
21
  /** Where the bands change, left to right: [60, 80] draws three bands, the
21
22
  * strongest from zero to 60. Absent draws one pale track. */
22
23
  bands?: Forwarded<readonly number[]>;
23
- /** At or past this the bar is drawn as an outline of the "needs you" colour. */
24
+ /** At or past this the bar is drawn as an outline of the "needs you" colour.
25
+ * With `better: 'higher'`, at or under it. */
24
26
  warnAt?: Forwarded<number>;
27
+ /** Which way is better. `lower` (the default): past the target is flagged,
28
+ * as for a cost or a limit. `higher`: short of the target is flagged, as for
29
+ * a share or a rate. */
30
+ better?: Forwarded<'higher' | 'lower'>;
25
31
  /** The scale's end. Defaults to a round figure a little past the reading
26
32
  * and the target. */
27
33
  max?: Forwarded<number>;
28
34
  }
29
- export interface BulletChartContract {
35
+ export interface BulletChartContract extends LoadingContract {
30
36
  /** What the rows show together: "Against target". */
31
37
  label: string;
32
38
  rows: readonly BulletRow[];
@@ -36,8 +42,6 @@ export interface BulletChartContract {
36
42
  nearLabel?: Forwarded<string>;
37
43
  /** What the chart says when there are no rows. Required, this package owns no copy. */
38
44
  emptyLabel: string;
39
- /** The figures are on their way: the chart draws a skeleton at its own height. */
40
- loading?: Forwarded<boolean>;
41
45
  /** Keep the name for a screen reader but do not draw it, when a panel around the chart already shows its title. */
42
46
  labelHidden?: Forwarded<boolean>;
43
47
  }
@@ -68,8 +72,9 @@ export interface BulletResolvedSpec {
68
72
  over: boolean;
69
73
  };
70
74
  }
71
- /** The row's state: past the target is over, at or past `warnAt` is near. */
72
- export declare function bulletState(value: number, target: number, warnAt?: number): BulletState;
75
+ /** The row's state: on the wrong side of the target is over, at or past
76
+ * `warnAt` toward it is near. `better` says which side is wrong. */
77
+ export declare function bulletState(value: number, target: number, warnAt?: number, better?: 'higher' | 'lower'): BulletState;
73
78
  /** The row's scale end: the caller's, else a round figure past the larger of
74
79
  * the reading, the target and the last band. */
75
80
  export declare function bulletScaleMax(row: Pick<BulletRow, 'value' | 'target' | 'bands' | 'max'>): number;
@@ -2,10 +2,11 @@ import { chartShare, chartTicks } from '../lib/chart-ticks';
2
2
  export const BULLET_STATES = ['within', 'near', 'over'];
3
3
  export const BULLET_HEADROOM = 1.08;
4
4
  export const BULLET_MAX_BANDS = 3;
5
- export function bulletState(value, target, warnAt) {
6
- if (value > target)
5
+ export function bulletState(value, target, warnAt, better = 'lower') {
6
+ const higher = better === 'higher';
7
+ if (higher ? value < target : value > target)
7
8
  return 'over';
8
- if (warnAt !== undefined && Number.isFinite(warnAt) && value >= warnAt)
9
+ if (warnAt !== undefined && Number.isFinite(warnAt) && (higher ? value <= warnAt : value >= warnAt))
9
10
  return 'near';
10
11
  return 'within';
11
12
  }
@@ -45,7 +46,7 @@ export function bulletSpec(rows) {
45
46
  valueAt: Math.min(100, Math.max(0, chartShare(r.value, scale))),
46
47
  targetAt: Math.min(100, Math.max(0, chartShare(r.target, scale))),
47
48
  bands: bulletBands(r.bands, scaleMax),
48
- state: bulletState(r.value, r.target, r.warnAt),
49
+ state: bulletState(r.value, r.target, r.warnAt, r.better),
49
50
  missing: false,
50
51
  };
51
52
  });
@@ -5,4 +5,4 @@ export type DSBulletChartProps = Omit<ComponentProps<'figure'>, 'children' | 'ar
5
5
  formatValue?: (value: number) => string;
6
6
  };
7
7
  /** Each reading against its target: a thin bar, a dark tick and pale bands behind. */
8
- export declare function DSBulletChart({ label, rows, overLabel, nearLabel, emptyLabel, loading, labelHidden, formatValue, className, ...props }: DSBulletChartProps): import("react/jsx-runtime").JSX.Element;
8
+ export declare function DSBulletChart({ label, rows, overLabel, nearLabel, emptyLabel, loading, loadingLabel, labelHidden, formatValue, className, ...props }: DSBulletChartProps): import("react/jsx-runtime").JSX.Element;
@@ -4,22 +4,27 @@ import { DSEmptyState } from '../../empty-state/web/ds-empty-state';
4
4
  import { chartContextColor, CHART_NEEDS_YOU, CHART_NO_DATA } from '../../lib/chart-context';
5
5
  import { formatChartValue } from '../../lib/chart-value';
6
6
  import { cn } from '../../lib/cn';
7
+ import { SpokenRegion } from '../../lib/web/spoken-region';
8
+ import { LOADING_ROWS, loadingSpoken } from '../../skeleton/skeleton';
7
9
  import { DSSkeleton } from '../../skeleton/web/ds-skeleton';
8
10
  import { DSText } from '../../text/web/ds-text';
9
11
  import { bulletSpec } from '../bullet-chart';
10
12
  const BAR = {
11
13
  within: { className: 'bg-chart-series-1', mark: true },
12
- near: { className: 'border-warning-mark border-2', style: { background: CHART_NEEDS_YOU.soon.fill }, mark: false },
13
- over: { className: 'bg-warning-mark', mark: true },
14
+ near: { className: 'border-chart-needs-you border-2', style: { background: CHART_NEEDS_YOU.soon.fill }, mark: false },
15
+ over: { className: 'bg-chart-needs-you', mark: true },
14
16
  };
15
17
  function FlagDot({ state }) {
16
18
  return (_jsx("span", { "aria-hidden": true, "data-forced-colors": BAR[state].mark ? 'mark' : undefined, "data-bullet-flag": state, className: cn('inline-block size-2 shrink-0 rounded-full', BAR[state].className), style: BAR[state].style }));
17
19
  }
18
- export function DSBulletChart({ label, rows, overLabel, nearLabel, emptyLabel, loading = false, labelHidden = false, formatValue = formatChartValue, className, ...props }) {
20
+ function BulletSkeleton() {
21
+ return (_jsx("div", { "aria-busy": true, className: "flex flex-col gap-4", "data-chart-loading": "", children: Array.from({ length: LOADING_ROWS }, (_, i) => (_jsxs("div", { className: "flex flex-col gap-2", children: [_jsxs("div", { className: "flex items-center justify-between gap-3", children: [_jsx(DSSkeleton, { fits: "body-sm-strong", className: "w-1/3" }), _jsx(DSSkeleton, { fits: "body-sm", className: "w-1/4" })] }), _jsx(DSSkeleton, { className: "h-4 w-full rounded-full" })] }, i))) }));
22
+ }
23
+ export function DSBulletChart({ label, rows, overLabel, nearLabel, emptyLabel, loading = false, loadingLabel, labelHidden = false, formatValue = formatChartValue, className, ...props }) {
19
24
  const spec = bulletSpec(rows);
20
25
  const captionId = useId();
21
26
  const stateWord = (state) => (state === 'over' ? overLabel : state === 'near' ? (nearLabel ?? '') : '');
22
- return (_jsxs("figure", { "aria-labelledby": captionId, "aria-busy": loading ? true : undefined, className: cn('m-0 flex min-w-0 flex-col gap-4', className), ...props, children: [_jsx("figcaption", { id: captionId, className: labelHidden ? 'sr-only' : undefined, children: _jsx(DSText, { as: "span", variant: "body-sm-strong", children: label }) }), loading ? (_jsxs("div", { className: "flex h-32 flex-col justify-center gap-5", "data-chart-loading": "", children: [_jsx("span", { className: "sr-only", children: `Loading ${label}` }), _jsx(DSSkeleton, { className: "w-full" }), _jsx(DSSkeleton, { className: "w-full" }), _jsx(DSSkeleton, { className: "w-2/3" })] })) : spec.empty ? (_jsx(DSEmptyState, { description: emptyLabel, className: "flex h-32 flex-col items-center justify-center" })) : (_jsxs(_Fragment, { children: [_jsx("ul", { className: "m-0 flex list-none flex-col gap-4 p-0", children: spec.rows.map((row) => {
27
+ return (_jsxs("figure", { "aria-labelledby": captionId, className: cn('m-0 flex min-w-0 flex-col gap-4', className), ...props, children: [_jsx("figcaption", { id: captionId, className: labelHidden ? 'sr-only' : undefined, children: _jsx(DSText, { as: "span", variant: "body-sm-strong", children: label }) }), _jsx(SpokenRegion, { text: loadingSpoken(loading, loadingLabel) }), loading ? (_jsx(BulletSkeleton, {})) : spec.empty ? (_jsx(DSEmptyState, { description: emptyLabel, className: "flex h-32 flex-col items-center justify-center" })) : (_jsxs(_Fragment, { children: [_jsx("ul", { className: "m-0 flex list-none flex-col gap-4 p-0", children: spec.rows.map((row) => {
23
28
  const flagged = !row.missing && row.state !== 'within';
24
29
  const word = row.missing ? '' : stateWord(row.state);
25
30
  return (_jsxs("li", { className: "flex flex-col gap-2", "data-bullet-state": row.state, "data-bullet-missing": row.missing ? '' : undefined, children: [_jsxs("div", { className: "flex items-baseline justify-between gap-3", children: [_jsx(DSText, { as: "span", variant: "body-sm-strong", className: "min-w-0 truncate", children: row.label }), _jsxs(DSText, { as: "span", variant: flagged ? 'body-sm-strong' : 'body-sm', className: cn('flex shrink-0 items-center gap-1.5 tabular-nums', flagged ? 'text-foreground' : 'text-muted-foreground'), children: [flagged && row.state !== 'within' && _jsx(FlagDot, { state: row.state }), row.missing ? CHART_NO_DATA : (row.caption ?? `${formatValue(row.value)} of ${formatValue(row.target)}`), word !== '' && _jsx("span", { className: "sr-only", children: `, ${word}` })] })] }), _jsxs("span", { "aria-hidden": true, className: "relative block h-4", "data-forced-colors": "placeholder", children: [row.bands.map((band, i) => (_jsx("span", { "data-bullet-band": band.step, className: cn('absolute inset-y-0', i === 0 && 'rounded-l-full', i === row.bands.length - 1 && 'rounded-r-full'), style: {
@@ -69,7 +69,7 @@ export interface ButtonModifiers {
69
69
  * Default `false`, because standing alone is the commoner case in an
70
70
  * application. A caller putting a link into a sentence opts in.
71
71
  *
72
- * Superseded for the rule (2026-10-08, Flutter source): every link that is
72
+ * Superseded for the rule (2026-10-08, the source app): every link that is
73
73
  * not `quiet` is underlined at rest. `inText` still sets the prose label.
74
74
  */
75
75
  inText?: Forwarded<boolean>;
@@ -66,8 +66,8 @@ const TEXT = {
66
66
  const DEPTH = {
67
67
  default: 'shadow-medium android:elevation-sm',
68
68
  secondary: '',
69
- destructive: 'ios:shadow-md android:elevation-sm',
70
- overDark: 'ios:shadow-md android:elevation-sm',
69
+ destructive: 'ios:shadow-medium android:elevation-sm',
70
+ overDark: 'ios:shadow-medium android:elevation-sm',
71
71
  outline: '',
72
72
  ghost: '',
73
73
  link: '',
@@ -121,7 +121,7 @@ export function DSButton({ variant = 'default', size = 'md', disabled, pending =
121
121
  wasPending.current = pending;
122
122
  }, [pending, busyLabel]);
123
123
  const onHero = variant === 'overDark' || variant === 'linkOnDark';
124
- const recipe = cn('inline-flex items-center justify-center gap-2 transition-control', spec.shape === 'control' && (spec.surface === 'outline' ? 'state-layer-press' : 'state-layer'), spec.shape === 'control' && spec.border === 'outline-border' && 'state-layer-edge', spec.shape === 'control' && spec.surface === 'outline' && 'state-layer-quiet-hover', spec.shape === 'control' && spec.tone === 'primary' && 'state-layer-edge state-layer-brand', spec.shape === 'control' && STATE_INK[spec.surface], onHero ? 'focusable-on-hero' : 'focusable', shape.chrome, RADIUS[spec.radius], shape.control && SURFACE[spec.surface], shape.control && PRESS[spec.surface], LABEL[spec.label], BORDER[spec.border], shape.control && spec.border === 'none' && 'forced-colors:border', spec.block && 'w-full', spec.underlined && (spec.standing ? 'link-standing-rule' : 'underline'), shape.control &&
124
+ const recipe = cn('inline-flex items-center justify-center gap-2 transition-control', spec.shape === 'control' && (spec.surface === 'outline' ? 'state-layer-press' : 'state-layer'), spec.shape === 'control' && spec.border === 'outline-border' && 'state-layer-edge', spec.shape === 'control' && spec.surface === 'outline' && 'state-layer-quiet-hover', spec.shape === 'control' && spec.tone === 'primary' && 'state-layer-edge state-layer-brand', spec.shape === 'control' && STATE_INK[spec.surface], onHero ? 'focusable-on-hero' : 'focusable', shape.chrome, RADIUS[spec.radius], shape.control && SURFACE[spec.surface], shape.control && PRESS[spec.surface], LABEL[spec.label], BORDER[spec.border], shape.control && spec.border === 'none' && 'forced-colors:border', spec.block && 'w-full', !spec.block && 'w-fit', spec.underlined && (spec.standing ? 'link-standing-rule' : 'underline'), shape.control &&
125
125
  !spec.flush &&
126
126
  (SIZED_PADDING[spec.minHeight]?.[spec.paddingX] ?? PADDING[spec.paddingX]), shape.control &&
127
127
  !spec.flush &&
@@ -5,7 +5,7 @@ export declare const BUTTON_GROUP_PRIMARY_POSITION: {
5
5
  readonly row: "last";
6
6
  readonly stacked: "first";
7
7
  };
8
- /** Where the counter-action, a Back, a Delete, sits, per layout.
8
+ /** Where the counter-action, a Back, sits, per layout.
9
9
  *
10
10
  * Opposite the primary in a row, so the two never sit adjacent. Last when
11
11
  * stacked, for the same reason: furthest from the thumb. */
@@ -4,8 +4,8 @@ export type DSButtonGroupProps = Omit<ComponentProps<'div'>, 'role'> & ButtonGro
4
4
  /** The actions, in ROW order: primary LAST. Stacking flips what is painted,
5
5
  * never what is written. */
6
6
  children: ReactNode;
7
- /** A counter-action, Back, or Delete, pinned to the opposite edge in a
8
- * row and last when stacked. Furthest from the primary either way. */
7
+ /** A counter-action, Back, pinned to the opposite edge in a row and last
8
+ * when stacked. Furthest from the primary either way. */
9
9
  leading?: ReactNode;
10
10
  };
11
11
  /** The action cluster a footer ends with. */
@@ -5,7 +5,10 @@ import type { Forwarded } from '../props';
5
5
  * and a hidden locale lookup would make a visible difference invisible. */
6
6
  export declare const WEEK_STARTS: readonly [0, 1];
7
7
  export type WeekStart = (typeof WEEK_STARTS)[number];
8
- /** Sunday-first, matching the source. */
8
+ /** Monday, as a South African week is read. Every calendar in the package
9
+ * starts here unless its caller asks for another day. It was Sunday, after
10
+ * the source, while every picker passed Monday by hand, so the one picker
11
+ * that forgot (the panel) drew a Sunday week beside Monday ones. */
9
12
  export declare const CALENDAR_WEEK_START: WeekStart;
10
13
  /** Seven and named because the grid's column count is not a magic number: it
11
14
  * is the length of a week and every row here is one. */
@@ -23,6 +26,8 @@ export declare const CALENDAR_SELECTED_TINT_PERCENT = 8;
23
26
  export declare const CALENDAR_HOVER_TINT_PERCENT = 4;
24
27
  /** Today's ring: the quiet ink, 3:1 or more on every ground and on the chosen wash. */
25
28
  export declare const CALENDAR_TODAY_RING = "muted-foreground";
29
+ export declare const CALENDAR_TODAY_MARKS: readonly ["ring", "ring-dot"];
30
+ export type CalendarTodayMark = (typeof CALENDAR_TODAY_MARKS)[number];
26
31
  /** The weekday headings and the arrows' glyphs. */
27
32
  export declare const CALENDAR_MUTED_INK = "muted-foreground";
28
33
  /** One day's look. */
@@ -39,10 +44,12 @@ export interface CalendarDayResolvedSpec {
39
44
  emphasised: boolean;
40
45
  /** Today's ring. */
41
46
  ring?: typeof CALENDAR_TODAY_RING;
47
+ /** Today's dot under the number, in the day's own ink, with `todayMark: 'ring-dot'`. */
48
+ dot?: true;
42
49
  }
43
50
  /** The recipe for one day: its place in the selection, whether it is today,
44
51
  * and whether it can be chosen. */
45
- export declare function calendarDaySpec(day: Pick<CalendarDay, 'selection' | 'today' | 'disabled'>): CalendarDayResolvedSpec;
52
+ export declare function calendarDaySpec(day: Pick<CalendarDay, 'selection' | 'today' | 'disabled'>, todayMark?: CalendarTodayMark): CalendarDayResolvedSpec;
46
53
  /** A day's height and the arrows', the heading's and each month's. */
47
54
  export declare const CALENDAR_TARGET: "touch";
48
55
  /** The narrowest a day's column becomes before the row stops shrinking, in px. */
@@ -161,8 +168,12 @@ export interface CalendarContract {
161
168
  year: number;
162
169
  /** What is chosen. A single day is `from` and `to` the same, or `to` null. */
163
170
  range?: CalendarRange;
171
+ /** The first column. Monday unless the caller asks for Sunday, see
172
+ * `CALENDAR_WEEK_START`. */
164
173
  weekStart?: WeekStart;
165
174
  today?: Forwarded<string>;
175
+ /** How today is marked: a ring, or a ring and a dot under the number. A ring unless set. */
176
+ todayMark?: Forwarded<CalendarTodayMark>;
166
177
  min?: Forwarded<string>;
167
178
  max?: Forwarded<string>;
168
179
  }
@@ -1,6 +1,6 @@
1
1
  import { TAB_CURRENT_INK, TAB_CURRENT_TINT_PERCENT, TAB_HOVER_TINT_PERCENT, TAB_TINT_INK, } from '../tabs/tabs';
2
2
  export const WEEK_STARTS = [0, 1];
3
- export const CALENDAR_WEEK_START = 0;
3
+ export const CALENDAR_WEEK_START = 1;
4
4
  export const DAYS_IN_WEEK = 7;
5
5
  export const CALENDAR_DAY_INK = 'foreground';
6
6
  export const CALENDAR_SELECTED_INK = TAB_CURRENT_INK;
@@ -9,10 +9,11 @@ export const CALENDAR_TINT_INK = TAB_TINT_INK;
9
9
  export const CALENDAR_SELECTED_TINT_PERCENT = TAB_CURRENT_TINT_PERCENT;
10
10
  export const CALENDAR_HOVER_TINT_PERCENT = TAB_HOVER_TINT_PERCENT;
11
11
  export const CALENDAR_TODAY_RING = 'muted-foreground';
12
+ export const CALENDAR_TODAY_MARKS = ['ring', 'ring-dot'];
12
13
  export const CALENDAR_MUTED_INK = 'muted-foreground';
13
- export function calendarDaySpec(day) {
14
+ export function calendarDaySpec(day, todayMark = 'ring') {
14
15
  const ring = day.today
15
- ? { ring: CALENDAR_TODAY_RING }
16
+ ? { ring: CALENDAR_TODAY_RING, ...(todayMark === 'ring-dot' ? { dot: true } : {}) }
16
17
  : {};
17
18
  if (day.disabled) {
18
19
  return { ink: 'disabled-foreground', emphasised: false, ...ring };
@@ -39,4 +39,4 @@ export type DSCalendarProps = Omit<ComponentProps<'div'>, 'onSelect' | 'children
39
39
  pressedRange?: CalendarRange;
40
40
  };
41
41
  /** One month, drawn as a grid of days. */
42
- export declare function DSCalendar({ year, month, range, weekStart, today, min, max, onSelectDate, onMonthChange, monthsOpen, onMonthsOpenChange, previousLabel, nextLabel, arrows, selectionAppearance, pressedRange, className, ...props }: DSCalendarProps): import("react/jsx-runtime").JSX.Element;
42
+ export declare function DSCalendar({ year, month, range, weekStart, today, todayMark, min, max, onSelectDate, onMonthChange, monthsOpen, onMonthsOpenChange, previousLabel, nextLabel, arrows, selectionAppearance, pressedRange, className, ...props }: DSCalendarProps): import("react/jsx-runtime").JSX.Element;