@tfn-design/design-system 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (967) hide show
  1. package/README.md +3 -3
  2. package/dist/accordion/accordion.d.ts +2 -2
  3. package/dist/accordion/web/ds-accordion.d.ts +10 -3
  4. package/dist/accordion/web/ds-accordion.js +33 -4
  5. package/dist/account-password-field/account-password-field.d.ts +4 -4
  6. package/dist/account-password-field/web/ds-account-password-field.d.ts +2 -2
  7. package/dist/account-password-field/web/ds-account-password-field.js +1 -1
  8. package/dist/account-switcher/account-switcher.d.ts +7 -7
  9. package/dist/account-switcher/web/ds-account-switcher.d.ts +5 -5
  10. package/dist/account-switcher/web/ds-account-switcher.js +3 -3
  11. package/dist/action-toast/action-toast.d.ts +12 -12
  12. package/dist/action-toast/web/ds-action-toast.d.ts +5 -5
  13. package/dist/action-toast/web/ds-action-toast.js +9 -4
  14. package/dist/ai-assist-field/ai-assist-field.d.ts +8 -6
  15. package/dist/ai-assist-field/ai-assist-field.js +12 -2
  16. package/dist/ai-assist-field/web/ds-ai-assist-field.d.ts +1 -1
  17. package/dist/ai-assist-field/web/ds-ai-assist-field.js +9 -8
  18. package/dist/ai-attachment/web/ds-ai-attachment.js +2 -1
  19. package/dist/ai-branch-switcher/ai-branch-switcher.d.ts +3 -0
  20. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.d.ts +1 -1
  21. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.js +8 -5
  22. package/dist/ai-citation/ai-citation.d.ts +8 -8
  23. package/dist/ai-citation/native/ds-ai-citation.js +5 -5
  24. package/dist/ai-citation/web/ds-ai-citation.js +6 -5
  25. package/dist/ai-composer/ai-composer.d.ts +2 -2
  26. package/dist/ai-composer/native/ds-ai-composer.js +5 -4
  27. package/dist/ai-composer/web/ds-ai-composer.d.ts +1 -1
  28. package/dist/ai-composer/web/ds-ai-composer.js +2 -2
  29. package/dist/ai-confirmation/ai-confirmation.d.ts +9 -9
  30. package/dist/ai-confirmation/native/ds-ai-confirmation.js +2 -2
  31. package/dist/ai-confirmation/web/ds-ai-confirmation.d.ts +1 -1
  32. package/dist/ai-confirmation/web/ds-ai-confirmation.js +3 -2
  33. package/dist/ai-context-scope/ai-context-scope.d.ts +5 -5
  34. package/dist/ai-context-scope/ai-context-scope.js +1 -1
  35. package/dist/ai-context-scope/native/ds-ai-context-scope.d.ts +1 -1
  36. package/dist/ai-context-scope/native/ds-ai-context-scope.js +6 -3
  37. package/dist/ai-context-scope/web/ds-ai-context-scope.d.ts +2 -2
  38. package/dist/ai-context-scope/web/ds-ai-context-scope.js +12 -2
  39. package/dist/ai-conversation-list/ai-conversation-list.d.ts +5 -5
  40. package/dist/ai-conversation-list/web/ds-ai-conversation-list.d.ts +1 -1
  41. package/dist/ai-conversation-list/web/ds-ai-conversation-list.js +7 -6
  42. package/dist/ai-diff/ai-diff.d.ts +2 -2
  43. package/dist/ai-diff/native/ds-ai-diff.js +3 -2
  44. package/dist/ai-diff/web/ds-ai-diff.js +3 -2
  45. package/dist/ai-draft-panel/ai-draft-panel.d.ts +3 -3
  46. package/dist/ai-draft-panel/ai-draft-panel.js +3 -3
  47. package/dist/ai-draft-panel/web/ds-ai-draft-panel.d.ts +2 -2
  48. package/dist/ai-draft-panel/web/ds-ai-draft-panel.js +3 -2
  49. package/dist/ai-empty-state/native/ds-ai-empty-state.d.ts +1 -1
  50. package/dist/ai-empty-state/native/ds-ai-empty-state.js +4 -3
  51. package/dist/ai-empty-state/web/ds-ai-empty-state.d.ts +1 -1
  52. package/dist/ai-empty-state/web/ds-ai-empty-state.js +2 -1
  53. package/dist/ai-error-state/native/ds-ai-error-state.js +3 -2
  54. package/dist/ai-error-state/web/ds-ai-error-state.js +2 -1
  55. package/dist/ai-feedback/ai-feedback.d.ts +1 -1
  56. package/dist/ai-feedback/ai-feedback.js +1 -1
  57. package/dist/ai-feedback/web/ds-ai-feedback.js +3 -2
  58. package/dist/ai-label/ai-label.d.ts +5 -5
  59. package/dist/ai-label/native/ds-ai-label.js +5 -4
  60. package/dist/ai-label/web/ds-ai-label.js +4 -4
  61. package/dist/ai-message/ai-message.d.ts +3 -3
  62. package/dist/ai-message/native/ds-ai-message.d.ts +1 -1
  63. package/dist/ai-message/native/ds-ai-message.js +12 -10
  64. package/dist/ai-message/web/ds-ai-message-markdown.js +5 -5
  65. package/dist/ai-message/web/ds-ai-message.d.ts +2 -2
  66. package/dist/ai-message/web/ds-ai-message.js +3 -2
  67. package/dist/ai-message-actions/ai-message-actions.d.ts +1 -1
  68. package/dist/ai-message-actions/native/ds-ai-message-actions.js +2 -1
  69. package/dist/ai-message-actions/web/use-ai-clipboard.d.ts +1 -1
  70. package/dist/ai-plan/ai-plan.d.ts +4 -4
  71. package/dist/ai-plan/web/ds-ai-plan.js +3 -2
  72. package/dist/ai-reasoning/ai-reasoning.d.ts +1 -1
  73. package/dist/ai-side-nav/ai-side-nav.d.ts +19 -19
  74. package/dist/ai-side-nav/web/ds-ai-side-nav.d.ts +9 -9
  75. package/dist/ai-side-nav/web/ds-ai-side-nav.js +2 -1
  76. package/dist/ai-suggestions/native/ds-ai-suggestions.js +1 -1
  77. package/dist/ai-suggestions/web/ds-ai-suggestions.js +1 -1
  78. package/dist/ai-summary-card/ai-summary-card.d.ts +8 -8
  79. package/dist/ai-summary-card/native/ds-ai-summary-card.d.ts +1 -1
  80. package/dist/ai-summary-card/native/ds-ai-summary-card.js +3 -3
  81. package/dist/ai-summary-card/web/ds-ai-summary-card.d.ts +1 -1
  82. package/dist/ai-summary-card/web/ds-ai-summary-card.js +2 -1
  83. package/dist/ai-thinking/native/ds-ai-thinking.js +3 -2
  84. package/dist/ai-thinking/web/ds-ai-thinking.js +1 -1
  85. package/dist/ai-thread/ai-thread.d.ts +3 -3
  86. package/dist/ai-thread/native/ds-ai-thread-panel.js +2 -1
  87. package/dist/ai-thread/native/ds-ai-thread.d.ts +2 -2
  88. package/dist/ai-thread/native/ds-ai-thread.js +4 -2
  89. package/dist/ai-thread/web/ds-ai-thread.d.ts +2 -2
  90. package/dist/ai-thread/web/ds-ai-thread.js +1 -1
  91. package/dist/ai-tool-call/ai-tool-call.d.ts +6 -6
  92. package/dist/ai-tool-call/native/ds-ai-tool-call.d.ts +1 -1
  93. package/dist/ai-tool-call/native/ds-ai-tool-call.js +5 -5
  94. package/dist/ai-tool-call/web/ds-ai-tool-call.d.ts +1 -1
  95. package/dist/ai-tool-call/web/ds-ai-tool-call.js +4 -3
  96. package/dist/alert/alert.d.ts +9 -9
  97. package/dist/alert/alert.js +1 -1
  98. package/dist/alert/native/ds-alert.js +9 -11
  99. package/dist/alert/web/ds-alert.js +24 -14
  100. package/dist/ambient-gradient/ambient-gradient.d.ts +11 -11
  101. package/dist/ambient-gradient/native/ambient-gradient-provider.d.ts +1 -1
  102. package/dist/ambient-gradient/native/ds-ambient-gradient.d.ts +1 -1
  103. package/dist/ambient-gradient/web/ds-ambient-gradient.d.ts +1 -1
  104. package/dist/amount/amount.d.ts +25 -25
  105. package/dist/amount/amount.js +4 -3
  106. package/dist/amount/native/ds-amount.js +2 -1
  107. package/dist/amount/web/ds-amount.js +1 -1
  108. package/dist/amount-cell/web/ds-amount-cell.js +1 -1
  109. package/dist/amount-entry/amount-entry.d.ts +8 -8
  110. package/dist/amount-entry/native/ds-amount-entry.js +3 -2
  111. package/dist/amount-entry/web/ds-amount-entry.js +2 -1
  112. package/dist/app-shell/app-shell.d.ts +9 -9
  113. package/dist/app-shell/app-shell.js +1 -1
  114. package/dist/app-shell/web/ds-app-shell.d.ts +24 -6
  115. package/dist/app-shell/web/ds-app-shell.js +4 -3
  116. package/dist/approval-chain/approval-chain.d.ts +12 -12
  117. package/dist/approval-chain/native/ds-approval-chain.d.ts +1 -1
  118. package/dist/approval-chain/native/ds-approval-chain.js +8 -6
  119. package/dist/approval-chain/web/ds-approval-chain.d.ts +1 -1
  120. package/dist/approval-chain/web/ds-approval-chain.js +7 -6
  121. package/dist/auth-shell/auth-shell.d.ts +4 -4
  122. package/dist/auth-shell/web/ds-auth-shell.d.ts +24 -6
  123. package/dist/auth-shell/web/ds-auth-shell.js +27 -2
  124. package/dist/avatar/avatar.d.ts +2 -2
  125. package/dist/avatar/native/ds-avatar.js +3 -2
  126. package/dist/avatar-group/avatar-group.d.ts +3 -3
  127. package/dist/avatar-group/native/ds-avatar-group.js +3 -2
  128. package/dist/avatar-group/web/ds-avatar-group.js +2 -2
  129. package/dist/balance-header/balance-header.d.ts +7 -7
  130. package/dist/balance-header/native/ds-balance-header.d.ts +1 -1
  131. package/dist/balance-header/native/ds-balance-header.js +3 -2
  132. package/dist/balance-header/web/ds-balance-header.d.ts +1 -1
  133. package/dist/balance-header/web/ds-balance-header.js +2 -1
  134. package/dist/bank-logo/bank-logo.d.ts +187 -0
  135. package/dist/bank-logo/bank-logo.js +151 -0
  136. package/dist/bank-logo/native/ds-bank-logo.d.ts +7 -0
  137. package/dist/bank-logo/native/ds-bank-logo.js +43 -0
  138. package/dist/bank-logo/web/ds-bank-logo.d.ts +10 -0
  139. package/dist/bank-logo/web/ds-bank-logo.js +27 -0
  140. package/dist/bar-chart/bar-chart.d.ts +63 -15
  141. package/dist/bar-chart/bar-chart.js +79 -2
  142. package/dist/bar-chart/web/ds-bar-chart.d.ts +5 -4
  143. package/dist/bar-chart/web/ds-bar-chart.js +86 -27
  144. package/dist/bottom-nav/bottom-nav.d.ts +27 -20
  145. package/dist/bottom-nav/bottom-nav.js +1 -0
  146. package/dist/bottom-nav/native/bottom-nav-icon-weight.d.ts +6 -0
  147. package/dist/bottom-nav/native/bottom-nav-icon-weight.js +6 -0
  148. package/dist/bottom-nav/native/ds-bottom-nav.d.ts +8 -8
  149. package/dist/bottom-nav/native/ds-bottom-nav.js +26 -17
  150. package/dist/bottom-nav/web/ds-bottom-nav.d.ts +16 -0
  151. package/dist/bottom-nav/web/ds-bottom-nav.js +31 -0
  152. package/dist/brand-lockup/brand-lockup.d.ts +41 -35
  153. package/dist/brand-lockup/brand-lockup.js +1 -1
  154. package/dist/brand-lockup/native/ds-brand-lockup.d.ts +7 -7
  155. package/dist/brand-lockup/native/ds-brand-lockup.js +6 -4
  156. package/dist/brand-lockup/web/ds-brand-lockup.d.ts +8 -8
  157. package/dist/brand-lockup/web/ds-brand-lockup.js +6 -4
  158. package/dist/breadcrumbs/breadcrumbs.d.ts +4 -4
  159. package/dist/breadcrumbs/web/ds-breadcrumbs.d.ts +1 -1
  160. package/dist/bulk-action-bar/bulk-action-bar.d.ts +6 -6
  161. package/dist/bulk-action-bar/web/ds-bulk-action-bar.d.ts +4 -4
  162. package/dist/bulk-action-bar/web/ds-bulk-action-bar.js +2 -1
  163. package/dist/bullet-chart/bullet-chart.d.ts +82 -0
  164. package/dist/bullet-chart/bullet-chart.js +60 -0
  165. package/dist/bullet-chart/web/ds-bullet-chart.d.ts +8 -0
  166. package/dist/bullet-chart/web/ds-bullet-chart.js +31 -0
  167. package/dist/button/button.d.ts +36 -36
  168. package/dist/button/button.js +14 -14
  169. package/dist/button/native/ds-button.js +10 -11
  170. package/dist/button/web/ds-button.d.ts +3 -3
  171. package/dist/button/web/ds-button.js +41 -24
  172. package/dist/button-group/button-group.d.ts +2 -2
  173. package/dist/button-group/web/ds-button-group.d.ts +3 -3
  174. package/dist/button-group/web/ds-button-group.js +1 -1
  175. package/dist/calendar/calendar.d.ts +14 -14
  176. package/dist/calendar/web/ds-calendar.d.ts +9 -5
  177. package/dist/calendar/web/ds-calendar.js +11 -9
  178. package/dist/card-carousel/card-carousel.d.ts +5 -5
  179. package/dist/card-carousel/native/ds-card-carousel.js +1 -1
  180. package/dist/card-carousel/web/ds-card-carousel.js +4 -2
  181. package/dist/chart/chart.d.ts +140 -60
  182. package/dist/chart/chart.js +146 -46
  183. package/dist/chart/web/ds-chart.d.ts +15 -13
  184. package/dist/chart/web/ds-chart.js +122 -49
  185. package/dist/check-option/check-option.d.ts +8 -10
  186. package/dist/check-option/check-option.js +0 -2
  187. package/dist/check-option/web/ds-check-option.d.ts +4 -4
  188. package/dist/check-option/web/ds-check-option.js +5 -4
  189. package/dist/checkbox/checkbox.d.ts +1 -1
  190. package/dist/checkbox/web/ds-checkbox.js +3 -7
  191. package/dist/chip/chip-wash.d.ts +5 -5
  192. package/dist/chip/chip.d.ts +5 -5
  193. package/dist/chip/native/ds-chip.d.ts +1 -1
  194. package/dist/chip/native/ds-chip.js +5 -4
  195. package/dist/chip/web/ds-chip.d.ts +2 -2
  196. package/dist/chip/web/ds-chip.js +37 -4
  197. package/dist/code-block/code-block.d.ts +10 -10
  198. package/dist/code-block/web/ds-code-block.js +2 -1
  199. package/dist/code-block/web/use-code-block-clipboard.d.ts +1 -1
  200. package/dist/column-picker/web/ds-column-picker.d.ts +3 -1
  201. package/dist/column-picker/web/ds-column-picker.js +2 -2
  202. package/dist/combobox/combobox.d.ts +24 -10
  203. package/dist/combobox/combobox.js +2 -5
  204. package/dist/combobox/web/ds-combobox.d.ts +2 -2
  205. package/dist/combobox/web/ds-combobox.js +45 -13
  206. package/dist/command-palette/command-palette.d.ts +30 -30
  207. package/dist/command-palette/web/ds-command-palette.d.ts +3 -3
  208. package/dist/command-palette/web/ds-command-palette.js +9 -7
  209. package/dist/comment-thread/comment-thread.d.ts +11 -11
  210. package/dist/comment-thread/native/ds-comment-thread.d.ts +1 -1
  211. package/dist/comment-thread/native/ds-comment-thread.js +14 -12
  212. package/dist/comment-thread/web/ds-comment-thread.d.ts +1 -1
  213. package/dist/comment-thread/web/ds-comment-thread.js +8 -7
  214. package/dist/condition-builder/condition-builder.d.ts +18 -18
  215. package/dist/condition-builder/condition-builder.js +1 -1
  216. package/dist/condition-builder/web/ds-condition-builder.js +9 -9
  217. package/dist/context-menu/context-menu.d.ts +4 -4
  218. package/dist/context-menu/web/ds-context-menu.d.ts +1 -1
  219. package/dist/context-menu/web/ds-context-menu.js +2 -2
  220. package/dist/coordinate-field/coordinate-field.d.ts +10 -10
  221. package/dist/coordinate-field/native/ds-coordinate-field.d.ts +1 -1
  222. package/dist/coordinate-field/native/ds-coordinate-field.js +2 -2
  223. package/dist/coordinate-field/web/ds-coordinate-field.d.ts +1 -1
  224. package/dist/coordinate-field/web/ds-coordinate-field.js +2 -2
  225. package/dist/copy-field/copy-field.d.ts +8 -8
  226. package/dist/copy-field/web/ds-copy-field.d.ts +1 -1
  227. package/dist/copy-field/web/ds-copy-field.js +4 -4
  228. package/dist/count-badge/count-badge.d.ts +9 -9
  229. package/dist/count-badge/native/ds-count-badge.js +3 -2
  230. package/dist/count-badge/web/ds-count-badge.js +4 -4
  231. package/dist/countdown/native/ds-countdown.js +3 -2
  232. package/dist/countdown/web/ds-countdown.js +2 -1
  233. package/dist/dashboard-shell/dashboard-shell.d.ts +3 -3
  234. package/dist/dashboard-shell/web/ds-dashboard-shell.d.ts +4 -4
  235. package/dist/data-table/data-table-license.d.ts +3 -3
  236. package/dist/data-table/data-table-store.d.ts +5 -5
  237. package/dist/data-table/url-state.d.ts +6 -6
  238. package/dist/data-table/web/data-table-parts.d.ts +2 -2
  239. package/dist/data-table/web/data-table-theme.css +83 -21
  240. package/dist/data-table/web/ds-data-table-skeleton-chip.d.ts +2 -2
  241. package/dist/data-table/web/ds-data-table.d.ts +4 -2
  242. package/dist/data-table/web/ds-data-table.js +7 -2
  243. package/dist/date-field/web/ds-date-field.d.ts +1 -1
  244. package/dist/date-input/date-input.d.ts +47 -12
  245. package/dist/date-input/date-input.js +30 -3
  246. package/dist/date-input/web/ds-date-input.d.ts +2 -2
  247. package/dist/date-input/web/ds-date-input.js +33 -7
  248. package/dist/date-picker/date-picker.d.ts +23 -23
  249. package/dist/date-picker/date-picker.js +1 -1
  250. package/dist/date-picker/web/ds-date-picker.d.ts +13 -7
  251. package/dist/date-picker/web/ds-date-picker.js +8 -7
  252. package/dist/date-range-picker/web/ds-date-range-picker.js +33 -3
  253. package/dist/day-picker/day-picker.d.ts +8 -2
  254. package/dist/day-picker/day-picker.js +1 -1
  255. package/dist/day-picker/web/ds-day-picker.d.ts +3 -3
  256. package/dist/day-picker/web/ds-day-picker.js +16 -4
  257. package/dist/delta/delta.d.ts +19 -3
  258. package/dist/delta/delta.js +30 -1
  259. package/dist/delta/native/ds-delta.js +10 -5
  260. package/dist/delta/web/ds-delta.js +7 -4
  261. package/dist/description-list/description-list.d.ts +3 -3
  262. package/dist/description-list/native/ds-description-list.d.ts +2 -2
  263. package/dist/description-list/native/ds-description-list.js +6 -3
  264. package/dist/description-list/web/ds-description-list.d.ts +2 -2
  265. package/dist/description-list/web/ds-description-list.js +3 -1
  266. package/dist/dialog/dialog.d.ts +9 -9
  267. package/dist/dialog/native/ds-dialog.d.ts +1 -1
  268. package/dist/dialog/native/ds-dialog.js +2 -1
  269. package/dist/dialog/web/ds-dialog.d.ts +13 -5
  270. package/dist/dialog/web/ds-dialog.js +9 -11
  271. package/dist/diverging-bar-chart/diverging-bar-chart.d.ts +23 -8
  272. package/dist/diverging-bar-chart/diverging-bar-chart.js +24 -2
  273. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.d.ts +2 -2
  274. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.js +30 -15
  275. package/dist/divider/divider.d.ts +2 -2
  276. package/dist/divider/web/ds-divider.d.ts +1 -1
  277. package/dist/divider/web/ds-divider.js +2 -2
  278. package/dist/donut-chart/donut-chart.d.ts +19 -3
  279. package/dist/donut-chart/donut-chart.js +19 -2
  280. package/dist/donut-chart/web/ds-donut-chart.d.ts +3 -1
  281. package/dist/donut-chart/web/ds-donut-chart.js +20 -12
  282. package/dist/drawer/drawer.d.ts +10 -10
  283. package/dist/drawer/native/ds-drawer.d.ts +3 -3
  284. package/dist/drawer/native/ds-drawer.js +4 -3
  285. package/dist/drawer/web/ds-drawer.d.ts +3 -3
  286. package/dist/drawer/web/ds-drawer.js +5 -3
  287. package/dist/dropdown-menu/dropdown-menu.d.ts +17 -17
  288. package/dist/dropdown-menu/dropdown-menu.js +1 -1
  289. package/dist/dropdown-menu/native/ds-dropdown-menu.d.ts +2 -2
  290. package/dist/dropdown-menu/native/ds-dropdown-menu.js +4 -3
  291. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.d.ts +5 -5
  292. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.js +5 -4
  293. package/dist/dropdown-menu/web/ds-dropdown-menu.d.ts +4 -4
  294. package/dist/dumbbell-chart/dumbbell-chart.d.ts +39 -0
  295. package/dist/dumbbell-chart/dumbbell-chart.js +19 -0
  296. package/dist/dumbbell-chart/web/ds-dumbbell-chart.d.ts +13 -0
  297. package/dist/dumbbell-chart/web/ds-dumbbell-chart.js +20 -0
  298. package/dist/editable-row/editable-row.d.ts +7 -2
  299. package/dist/editable-row/web/ds-editable-row.d.ts +2 -2
  300. package/dist/editable-row/web/ds-editable-row.js +3 -3
  301. package/dist/empty-state/empty-state.d.ts +5 -5
  302. package/dist/empty-state/empty-state.js +1 -1
  303. package/dist/empty-state/native/ds-empty-state.d.ts +3 -3
  304. package/dist/empty-state/native/ds-empty-state.js +1 -1
  305. package/dist/empty-state/web/ds-empty-state.d.ts +8 -8
  306. package/dist/empty-state/web/ds-empty-state.js +2 -8
  307. package/dist/environment-banner/environment-banner.d.ts +9 -9
  308. package/dist/environment-banner/web/ds-environment-banner.d.ts +2 -2
  309. package/dist/environment-banner/web/ds-environment-banner.js +4 -2
  310. package/dist/evaluation-trace/evaluation-trace.d.ts +3 -3
  311. package/dist/evaluation-trace/web/ds-evaluation-trace.d.ts +1 -1
  312. package/dist/evaluation-trace/web/ds-evaluation-trace.js +7 -6
  313. package/dist/event-row/web/ds-event-row.d.ts +1 -1
  314. package/dist/event-row/web/ds-event-row.js +2 -1
  315. package/dist/facet-button/facet-button.d.ts +3 -3
  316. package/dist/facet-button/web/ds-facet-button.d.ts +1 -1
  317. package/dist/facet-button/web/ds-facet-button.js +4 -10
  318. package/dist/facet-menu/web/ds-facet-menu-row.d.ts +1 -1
  319. package/dist/facet-menu/web/ds-facet-menu.js +5 -4
  320. package/dist/fact/fact.d.ts +2 -2
  321. package/dist/fact/fact.js +1 -1
  322. package/dist/fact/native/ds-fact.js +3 -2
  323. package/dist/field-rules/field-rules.d.ts +9 -9
  324. package/dist/figure/figure.d.ts +1 -1
  325. package/dist/figure/figure.js +1 -1
  326. package/dist/figure/native/ds-figure.js +4 -3
  327. package/dist/file-dropzone/file-dropzone.d.ts +10 -10
  328. package/dist/file-dropzone/web/ds-file-dropzone.d.ts +2 -2
  329. package/dist/file-dropzone/web/ds-file-dropzone.js +3 -2
  330. package/dist/file-field/file-field.d.ts +4 -4
  331. package/dist/file-field/web/ds-file-field.d.ts +4 -4
  332. package/dist/file-field/web/ds-file-field.js +2 -1
  333. package/dist/file-import/file-import.d.ts +8 -8
  334. package/dist/file-import/file-import.js +1 -1
  335. package/dist/file-import/web/ds-file-import.d.ts +2 -2
  336. package/dist/file-import/web/ds-file-import.js +1 -1
  337. package/dist/file-upload/file-upload.d.ts +13 -13
  338. package/dist/file-upload/file-upload.js +1 -1
  339. package/dist/file-upload/web/ds-file-upload.d.ts +3 -1
  340. package/dist/file-upload/web/ds-file-upload.js +4 -4
  341. package/dist/filter-bar/filter-bar.d.ts +4 -4
  342. package/dist/filter-bar/web/ds-filter-bar.d.ts +2 -2
  343. package/dist/filter-bar/web/ds-filter-bar.js +2 -1
  344. package/dist/filter-button/filter-button.d.ts +7 -7
  345. package/dist/filter-button/web/ds-filter-button.d.ts +1 -1
  346. package/dist/filter-chip/filter-chip.d.ts +12 -12
  347. package/dist/filter-chip/web/ds-filter-chip.d.ts +1 -1
  348. package/dist/filter-chip/web/ds-filter-chip.js +4 -4
  349. package/dist/filter-popover/filter-popover.d.ts +3 -0
  350. package/dist/filter-popover/web/ds-filter-popover.d.ts +2 -2
  351. package/dist/filter-popover/web/ds-filter-popover.js +9 -4
  352. package/dist/form-field-group/form-field-group.d.ts +7 -7
  353. package/dist/form-field-group/web/ds-form-field-group.js +1 -1
  354. package/dist/form-section/form-section.d.ts +1 -1
  355. package/dist/form-section/form-section.js +1 -1
  356. package/dist/form-section/web/ds-form-section.d.ts +2 -2
  357. package/dist/form-section/web/ds-form-section.js +3 -1
  358. package/dist/freshness-indicator/freshness-indicator.d.ts +4 -1
  359. package/dist/freshness-indicator/freshness-indicator.js +8 -2
  360. package/dist/freshness-indicator/web/ds-freshness-indicator.d.ts +1 -1
  361. package/dist/freshness-indicator/web/ds-freshness-indicator.js +4 -2
  362. package/dist/funnel/funnel.d.ts +4 -4
  363. package/dist/funnel/web/ds-funnel.d.ts +3 -3
  364. package/dist/funnel/web/ds-funnel.js +21 -28
  365. package/dist/gauge/gauge.d.ts +9 -3
  366. package/dist/gauge/gauge.js +11 -1
  367. package/dist/gauge/web/ds-gauge.d.ts +8 -3
  368. package/dist/gauge/web/ds-gauge.js +15 -8
  369. package/dist/geo/geo.d.ts +15 -15
  370. package/dist/geofence-editor/geofence-editor.d.ts +8 -8
  371. package/dist/geofence-editor/web/ds-geofence-editor.d.ts +6 -6
  372. package/dist/geofence-editor/web/ds-geofence-editor.js +18 -18
  373. package/dist/glass.d.ts +15 -15
  374. package/dist/glass.js +1 -1
  375. package/dist/gradient-card/gradient-card.d.ts +3 -3
  376. package/dist/gradient-card/web/ds-gradient-card.d.ts +2 -2
  377. package/dist/gradient-card/web/ds-gradient-card.js +1 -1
  378. package/dist/group-header/group-header.d.ts +1 -1
  379. package/dist/group-header/web/ds-group-header.d.ts +1 -1
  380. package/dist/group-header/web/ds-group-header.js +1 -1
  381. package/dist/heading/heading.d.ts +18 -0
  382. package/dist/heading/heading.js +14 -0
  383. package/dist/heading/native/ds-heading.d.ts +5 -0
  384. package/dist/heading/native/ds-heading.js +9 -0
  385. package/dist/heading/web/ds-heading.d.ts +5 -0
  386. package/dist/heading/web/ds-heading.js +10 -0
  387. package/dist/heatmap/heatmap.d.ts +15 -4
  388. package/dist/heatmap/heatmap.js +6 -0
  389. package/dist/heatmap/web/ds-heatmap.d.ts +4 -4
  390. package/dist/heatmap/web/ds-heatmap.js +24 -11
  391. package/dist/helper-text/helper-text.d.ts +13 -13
  392. package/dist/helper-text/helper-text.js +4 -4
  393. package/dist/helper-text/native/ds-helper-text.d.ts +1 -1
  394. package/dist/helper-text/web/ds-helper-text.d.ts +1 -1
  395. package/dist/histogram/histogram.d.ts +68 -0
  396. package/dist/histogram/histogram.js +79 -0
  397. package/dist/histogram/web/ds-histogram.d.ts +10 -0
  398. package/dist/histogram/web/ds-histogram.js +33 -0
  399. package/dist/hover-card/hover-card.d.ts +1 -1
  400. package/dist/hover-card/web/ds-hover-card.d.ts +1 -1
  401. package/dist/hover-card/web/ds-hover-card.js +3 -2
  402. package/dist/icon/web/ds-icon-provider.js +2 -1
  403. package/dist/icon-button/icon-button.d.ts +8 -8
  404. package/dist/icon-button/icon-button.js +1 -1
  405. package/dist/icon-button/native/ds-icon-button.js +2 -2
  406. package/dist/icon-button/web/ds-icon-button.d.ts +1 -1
  407. package/dist/icon-button/web/ds-icon-button.js +3 -3
  408. package/dist/icon-frame/icon-frame.d.ts +23 -9
  409. package/dist/icon-frame/icon-frame.js +6 -2
  410. package/dist/icon-frame/native/ds-icon-frame.d.ts +1 -1
  411. package/dist/icon-frame/native/ds-icon-frame.js +24 -7
  412. package/dist/icon-frame/web/ds-icon-frame.d.ts +2 -2
  413. package/dist/icon-frame/web/ds-icon-frame.js +25 -6
  414. package/dist/icon-toggle-group/web/ds-icon-toggle-group.d.ts +5 -1
  415. package/dist/icon-toggle-group/web/ds-icon-toggle-group.js +2 -2
  416. package/dist/ident/ident.d.ts +4 -4
  417. package/dist/ident/web/ds-ident.js +1 -1
  418. package/dist/impersonation-banner/impersonation-banner.d.ts +2 -2
  419. package/dist/impersonation-banner/impersonation-banner.js +2 -2
  420. package/dist/impersonation-banner/web/ds-impersonation-banner.d.ts +5 -5
  421. package/dist/impersonation-banner/web/ds-impersonation-banner.js +2 -1
  422. package/dist/index.d.ts +39 -11
  423. package/dist/index.js +24 -10
  424. package/dist/inline-edit/inline-edit.d.ts +5 -5
  425. package/dist/inline-edit/web/ds-inline-edit.d.ts +2 -2
  426. package/dist/inline-edit/web/ds-inline-edit.js +8 -6
  427. package/dist/input/input.d.ts +8 -8
  428. package/dist/input/input.js +1 -1
  429. package/dist/input/native/ds-input.js +2 -3
  430. package/dist/input/web/ds-input.d.ts +2 -2
  431. package/dist/input/web/ds-input.js +13 -10
  432. package/dist/interaction.d.ts +7 -7
  433. package/dist/interaction.js +2 -2
  434. package/dist/json-viewer/json-viewer.d.ts +17 -17
  435. package/dist/json-viewer/web/ds-json-viewer.d.ts +1 -1
  436. package/dist/json-viewer/web/ds-json-viewer.js +3 -2
  437. package/dist/kanban-board/kanban-board.d.ts +13 -13
  438. package/dist/kanban-board/web/ds-kanban-board.d.ts +1 -1
  439. package/dist/kanban-board/web/ds-kanban-board.js +6 -5
  440. package/dist/kbd/kbd.d.ts +6 -6
  441. package/dist/kbd/web/ds-kbd.js +2 -2
  442. package/dist/key-value-editor/key-value-editor.d.ts +15 -10
  443. package/dist/key-value-editor/web/ds-key-value-editor.d.ts +2 -2
  444. package/dist/key-value-editor/web/ds-key-value-editor.js +11 -8
  445. package/dist/keypad/keypad.d.ts +4 -4
  446. package/dist/keypad/native/ds-keypad.js +3 -2
  447. package/dist/keypad/web/ds-keypad.js +1 -1
  448. package/dist/label/label.d.ts +28 -28
  449. package/dist/label/label.js +6 -6
  450. package/dist/label/native/ds-label-group.js +5 -3
  451. package/dist/label/native/ds-label.d.ts +2 -2
  452. package/dist/label/native/ds-label.js +18 -13
  453. package/dist/label/web/ds-label-group.js +4 -3
  454. package/dist/label/web/ds-label.d.ts +2 -2
  455. package/dist/label/web/ds-label.js +17 -13
  456. package/dist/label-picker/label-picker.d.ts +9 -9
  457. package/dist/label-picker/native/ds-label-picker.js +8 -5
  458. package/dist/label-picker/web/ds-label-picker.js +7 -6
  459. package/dist/labeled-divider/web/ds-labeled-divider.js +2 -1
  460. package/dist/labeled-field/labeled-field.d.ts +6 -6
  461. package/dist/labeled-field/web/ds-labeled-field.d.ts +4 -4
  462. package/dist/labeled-field/web/ds-labeled-field.js +1 -1
  463. package/dist/leaderboard/leaderboard.d.ts +53 -0
  464. package/dist/leaderboard/leaderboard.js +35 -0
  465. package/dist/leaderboard/web/ds-leaderboard.d.ts +14 -0
  466. package/dist/leaderboard/web/ds-leaderboard.js +16 -0
  467. package/dist/legend/legend.d.ts +28 -3
  468. package/dist/legend/legend.js +4 -0
  469. package/dist/legend/web/ds-legend.d.ts +5 -2
  470. package/dist/legend/web/ds-legend.js +32 -23
  471. package/dist/lib/chart-context.d.ts +32 -0
  472. package/dist/lib/chart-context.js +18 -0
  473. package/dist/lib/chart-curve.js +7 -1
  474. package/dist/lib/chart-finish.d.ts +28 -18
  475. package/dist/lib/chart-finish.js +25 -22
  476. package/dist/lib/chart-hue.d.ts +4 -3
  477. package/dist/lib/chart-hue.js +1 -1
  478. package/dist/lib/chart-library.d.ts +1 -1
  479. package/dist/lib/chart-library.js +1 -1
  480. package/dist/lib/chart-palette.d.ts +7 -7
  481. package/dist/lib/chart-series.d.ts +52 -7
  482. package/dist/lib/chart-series.js +43 -1
  483. package/dist/lib/chart-table.d.ts +14 -0
  484. package/dist/lib/chart-table.js +14 -0
  485. package/dist/lib/chart-ticks.d.ts +24 -0
  486. package/dist/lib/chart-ticks.js +33 -0
  487. package/dist/lib/chart-value.d.ts +2 -0
  488. package/dist/lib/chart-value.js +6 -0
  489. package/dist/lib/cn.d.ts +2 -0
  490. package/dist/lib/cn.js +22 -24
  491. package/dist/lib/focus-order.d.ts +2 -2
  492. package/dist/lib/ink-child.d.ts +1 -1
  493. package/dist/lib/native/glass.d.ts +3 -3
  494. package/dist/lib/native/glass.js +1 -1
  495. package/dist/lib/native/text.d.ts +5 -0
  496. package/dist/lib/native/text.js +6 -0
  497. package/dist/lib/native/use-large-text.d.ts +3 -0
  498. package/dist/lib/native/use-large-text.js +9 -0
  499. package/dist/lib/overlay-stack.d.ts +11 -11
  500. package/dist/lib/sets-type.d.ts +1 -0
  501. package/dist/lib/sets-type.js +5 -0
  502. package/dist/lib/use-theme-epoch.d.ts +4 -4
  503. package/dist/lib/use-theme-epoch.native.d.ts +7 -7
  504. package/dist/lib/web/assign-ref.d.ts +4 -0
  505. package/dist/lib/web/assign-ref.js +6 -0
  506. package/dist/lib/web/chart-figures.d.ts +25 -0
  507. package/dist/lib/web/chart-figures.js +25 -0
  508. package/dist/lib/web/chart-finish.d.ts +20 -6
  509. package/dist/lib/web/chart-finish.js +16 -2
  510. package/dist/lib/web/density.js +5 -5
  511. package/dist/lib/web/focus-trap.d.ts +3 -3
  512. package/dist/lib/web/map-glass.js +2 -2
  513. package/dist/lib/web/scroll-lock.d.ts +1 -1
  514. package/dist/lib/web/use-anchored-surface.d.ts +6 -6
  515. package/dist/lib/web/use-chart-points.d.ts +23 -0
  516. package/dist/lib/web/use-chart-points.js +58 -0
  517. package/dist/lib/web/use-overlay.d.ts +3 -3
  518. package/dist/list-row/list-row.d.ts +6 -6
  519. package/dist/list-row/native/ds-list-row.js +5 -2
  520. package/dist/list-row/web/ds-list-row-group.d.ts +13 -0
  521. package/dist/list-row/web/ds-list-row-group.js +5 -0
  522. package/dist/list-row/web/ds-list-row.d.ts +15 -3
  523. package/dist/list-row/web/ds-list-row.js +12 -5
  524. package/dist/loading-screen/loading-screen.d.ts +10 -10
  525. package/dist/loading-screen/native/ds-loading-screen.d.ts +1 -1
  526. package/dist/loading-screen/native/ds-loading-screen.js +3 -2
  527. package/dist/loading-screen/web/ds-loading-screen.d.ts +1 -1
  528. package/dist/loading-screen/web/ds-loading-screen.js +3 -3
  529. package/dist/loading-state/loading-state.d.ts +9 -9
  530. package/dist/loading-state/web/ds-loading-state.js +1 -1
  531. package/dist/log-viewer/log-viewer.d.ts +20 -20
  532. package/dist/log-viewer/log-viewer.js +14 -2
  533. package/dist/log-viewer/web/ds-log-viewer.js +12 -3
  534. package/dist/map/map.d.ts +18 -18
  535. package/dist/map/map.js +2 -2
  536. package/dist/map/web/ds-map-fence.d.ts +2 -2
  537. package/dist/map/web/ds-map-fence.js +14 -13
  538. package/dist/map/web/ds-map-popup.d.ts +2 -2
  539. package/dist/map/web/ds-map-popup.js +1 -1
  540. package/dist/map/web/ds-map.d.ts +3 -3
  541. package/dist/map/web/ds-map.js +5 -4
  542. package/dist/map/web/map-provider.d.ts +7 -7
  543. package/dist/map-banner/map-banner.d.ts +4 -4
  544. package/dist/map-banner/map-banner.js +1 -1
  545. package/dist/map-banner/native/ds-map-banner.js +2 -2
  546. package/dist/map-banner/web/ds-map-banner.js +3 -2
  547. package/dist/map-controls/map-controls.d.ts +6 -6
  548. package/dist/map-controls/map-controls.js +1 -1
  549. package/dist/map-controls/native/ds-map-controls.d.ts +1 -1
  550. package/dist/map-controls/native/ds-map-controls.js +5 -4
  551. package/dist/map-controls/web/ds-map-controls.d.ts +1 -1
  552. package/dist/map-controls/web/ds-map-controls.js +4 -4
  553. package/dist/map-draw-toolbar/map-draw-toolbar.d.ts +3 -3
  554. package/dist/map-draw-toolbar/map-draw-toolbar.js +1 -1
  555. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.d.ts +1 -1
  556. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.js +3 -2
  557. package/dist/map-heatmap-layer/map-heatmap-layer.d.ts +25 -8
  558. package/dist/map-heatmap-layer/map-heatmap-layer.js +4 -0
  559. package/dist/map-heatmap-layer/web/ds-map-heatmap-layer.d.ts +19 -7
  560. package/dist/map-heatmap-layer/web/ds-map-heatmap-layer.js +15 -11
  561. package/dist/map-layers/map-layers.d.ts +1 -1
  562. package/dist/map-layers/map-layers.js +1 -1
  563. package/dist/map-layers/native/ds-map-layers.d.ts +1 -1
  564. package/dist/map-layers/native/ds-map-layers.js +4 -4
  565. package/dist/map-layers/web/ds-map-layers.d.ts +2 -2
  566. package/dist/map-layers/web/ds-map-layers.js +6 -5
  567. package/dist/map-list/map-list.d.ts +1 -1
  568. package/dist/map-list/web/ds-map-list.js +2 -2
  569. package/dist/map-marker/map-marker.d.ts +2 -2
  570. package/dist/map-marker/web/ds-map-marker.d.ts +1 -1
  571. package/dist/map-marker/web/ds-map-marker.js +4 -3
  572. package/dist/map-search/map-search.d.ts +2 -2
  573. package/dist/map-search/map-search.js +1 -1
  574. package/dist/map-search/native/ds-map-search.d.ts +1 -1
  575. package/dist/map-search/native/ds-map-search.js +4 -4
  576. package/dist/map-search/web/ds-map-search.d.ts +1 -1
  577. package/dist/map-search/web/ds-map-search.js +21 -14
  578. package/dist/map-search-area/map-search-area.d.ts +1 -1
  579. package/dist/map-search-area/map-search-area.js +1 -1
  580. package/dist/map-search-area/native/ds-map-search-area.d.ts +1 -1
  581. package/dist/map-search-area/native/ds-map-search-area.js +2 -2
  582. package/dist/map-search-area/web/ds-map-search-area.d.ts +1 -1
  583. package/dist/map-search-area/web/ds-map-search-area.js +3 -2
  584. package/dist/map-sheet/map-sheet.d.ts +7 -7
  585. package/dist/map-sheet/map-sheet.js +1 -1
  586. package/dist/map-sheet/native/ds-map-sheet.js +2 -2
  587. package/dist/map-sheet/web/ds-map-sheet.d.ts +1 -1
  588. package/dist/map-sheet/web/ds-map-sheet.js +14 -6
  589. package/dist/map-summary/web/ds-map-summary.d.ts +1 -1
  590. package/dist/map-summary/web/ds-map-summary.js +6 -3
  591. package/dist/measure.d.ts +3 -3
  592. package/dist/mention-input/mention-input.d.ts +13 -13
  593. package/dist/mention-input/native/ds-mention-input.d.ts +1 -1
  594. package/dist/mention-input/native/ds-mention-input.js +6 -3
  595. package/dist/mention-input/web/ds-mention-input.d.ts +3 -3
  596. package/dist/mention-input/web/ds-mention-input.js +9 -7
  597. package/dist/menu-button/web/ds-menu-button.d.ts +2 -2
  598. package/dist/menu-button/web/ds-menu-button.js +9 -3
  599. package/dist/merchant-avatar/merchant-avatar.d.ts +6 -3
  600. package/dist/merchant-avatar/merchant-avatar.js +8 -0
  601. package/dist/merchant-avatar/native/ds-merchant-avatar.js +10 -9
  602. package/dist/merchant-avatar/web/ds-merchant-avatar.js +8 -8
  603. package/dist/meter/meter.d.ts +8 -4
  604. package/dist/meter/meter.js +5 -0
  605. package/dist/meter/native/ds-meter.d.ts +1 -1
  606. package/dist/meter/native/ds-meter.js +6 -4
  607. package/dist/meter/web/ds-meter.d.ts +8 -2
  608. package/dist/meter/web/ds-meter.js +12 -5
  609. package/dist/metric/metric.d.ts +5 -5
  610. package/dist/metric/native/ds-metric.js +5 -3
  611. package/dist/metric/web/ds-metric.js +2 -1
  612. package/dist/metric-card/metric-card.d.ts +60 -0
  613. package/dist/metric-card/metric-card.js +18 -0
  614. package/dist/metric-card/web/ds-metric-card.d.ts +24 -0
  615. package/dist/metric-card/web/ds-metric-card.js +17 -0
  616. package/dist/month-picker/month-picker.d.ts +2 -0
  617. package/dist/month-picker/web/ds-month-picker.d.ts +1 -1
  618. package/dist/month-picker/web/ds-month-picker.js +5 -4
  619. package/dist/month-strip/month-strip.d.ts +2 -0
  620. package/dist/month-strip/web/ds-month-strip.d.ts +3 -3
  621. package/dist/month-strip/web/ds-month-strip.js +12 -7
  622. package/dist/morph/morph.d.ts +10 -10
  623. package/dist/morph/native/ds-morph.d.ts +1 -1
  624. package/dist/morph/native/morph-provider.d.ts +2 -2
  625. package/dist/morph/web/ds-morph.d.ts +4 -4
  626. package/dist/motion.d.ts +33 -33
  627. package/dist/motion.js +12 -12
  628. package/dist/multi-select/multi-select.d.ts +10 -10
  629. package/dist/multi-select/web/ds-multi-select.js +9 -8
  630. package/dist/native.d.ts +6 -0
  631. package/dist/native.js +3 -0
  632. package/dist/notification-list/native/ds-notification-list.d.ts +1 -1
  633. package/dist/notification-list/native/ds-notification-list.js +7 -4
  634. package/dist/notification-list/notification-list.d.ts +4 -4
  635. package/dist/notification-list/web/ds-notification-list.d.ts +1 -1
  636. package/dist/notification-list/web/ds-notification-list.js +6 -5
  637. package/dist/number-field/native/ds-number-field.js +15 -7
  638. package/dist/number-field/number-field.d.ts +7 -7
  639. package/dist/number-field/web/ds-number-field.js +8 -7
  640. package/dist/otp/native/ds-otp-field.d.ts +1 -1
  641. package/dist/otp/native/ds-otp-field.js +9 -3
  642. package/dist/otp/native/ds-otp.js +1 -1
  643. package/dist/otp/otp.d.ts +14 -10
  644. package/dist/otp/web/ds-otp-field.d.ts +2 -2
  645. package/dist/otp/web/ds-otp-field.js +6 -1
  646. package/dist/otp/web/ds-otp.d.ts +1 -1
  647. package/dist/otp/web/ds-otp.js +3 -3
  648. package/dist/overflow-menu/web/ds-overflow-menu.js +9 -3
  649. package/dist/page-head/page-head.d.ts +4 -4
  650. package/dist/page-head/web/ds-page-head.d.ts +5 -3
  651. package/dist/page-head/web/ds-page-head.js +6 -2
  652. package/dist/pagination/web/ds-pagination.js +2 -1
  653. package/dist/panel/native/ds-panel.js +7 -4
  654. package/dist/panel/panel.d.ts +14 -14
  655. package/dist/panel/panel.js +7 -7
  656. package/dist/panel/web/ds-panel.d.ts +7 -5
  657. package/dist/panel/web/ds-panel.js +4 -3
  658. package/dist/password-feedback/password-feedback.d.ts +3 -3
  659. package/dist/password-feedback/web/ds-password-feedback.js +2 -2
  660. package/dist/password-requirements/password-requirements.d.ts +5 -5
  661. package/dist/password-requirements/web/ds-password-requirements.js +1 -1
  662. package/dist/password-strength/password-strength.d.ts +5 -5
  663. package/dist/password-strength/web/ds-password-strength.d.ts +2 -2
  664. package/dist/password-strength/web/ds-password-strength.js +4 -2
  665. package/dist/payment-card/native/ds-payment-card.js +5 -2
  666. package/dist/payment-card/payment-card.d.ts +2 -2
  667. package/dist/payment-card/web/ds-payment-card.js +2 -1
  668. package/dist/people-cell/web/ds-people-cell.js +1 -1
  669. package/dist/person-cell/person-cell.d.ts +1 -1
  670. package/dist/phone-field/native/ds-phone-field.d.ts +1 -1
  671. package/dist/phone-field/native/ds-phone-field.js +6 -4
  672. package/dist/phone-field/phone-field.d.ts +13 -12
  673. package/dist/phone-field/phone-field.js +1 -1
  674. package/dist/phone-field/web/ds-phone-field.d.ts +3 -3
  675. package/dist/phone-field/web/ds-phone-field.js +15 -8
  676. package/dist/place-card/native/ds-place-card.js +15 -7
  677. package/dist/place-card/place-card.d.ts +18 -18
  678. package/dist/place-card/web/ds-place-card.js +18 -8
  679. package/dist/plan-chart/plan-chart.d.ts +68 -0
  680. package/dist/plan-chart/plan-chart.js +42 -0
  681. package/dist/plan-chart/web/ds-plan-chart.d.ts +10 -0
  682. package/dist/plan-chart/web/ds-plan-chart.js +35 -0
  683. package/dist/popover/native/ds-popover.d.ts +1 -1
  684. package/dist/popover/popover.d.ts +3 -3
  685. package/dist/popover/web/ds-popover.d.ts +1 -1
  686. package/dist/popover/web/ds-popover.js +2 -2
  687. package/dist/presence-indicator/native/ds-presence-indicator.js +4 -3
  688. package/dist/presence-indicator/presence-indicator.d.ts +3 -3
  689. package/dist/presence-indicator/web/ds-presence-indicator.js +2 -2
  690. package/dist/price-pin/native/ds-price-pin.js +3 -2
  691. package/dist/price-pin/price-pin.d.ts +7 -7
  692. package/dist/price-pin/web/ds-price-pin.js +2 -2
  693. package/dist/priority-indicator/native/ds-priority-indicator.d.ts +1 -1
  694. package/dist/priority-indicator/native/ds-priority-indicator.js +3 -2
  695. package/dist/priority-indicator/priority-indicator.d.ts +5 -5
  696. package/dist/priority-indicator/web/ds-priority-indicator.d.ts +1 -1
  697. package/dist/priority-indicator/web/ds-priority-indicator.js +1 -1
  698. package/dist/profile-card/profile-card.d.ts +1 -1
  699. package/dist/profile-card/web/ds-profile-card.d.ts +1 -1
  700. package/dist/profile-card/web/ds-profile-card.js +5 -3
  701. package/dist/progress-bar/native/ds-progress-bar.d.ts +1 -1
  702. package/dist/progress-bar/native/ds-progress-bar.js +1 -1
  703. package/dist/progress-bar/progress-bar.d.ts +8 -8
  704. package/dist/progress-bar/web/ds-progress-bar.d.ts +1 -1
  705. package/dist/progress-bar/web/ds-progress-bar.js +4 -4
  706. package/dist/progress-cell/progress-cell.js +1 -1
  707. package/dist/progress-cell/web/ds-progress-cell.js +4 -1
  708. package/dist/progress-ring/native/ds-progress-ring.js +5 -3
  709. package/dist/progress-ring/progress-ring.d.ts +5 -5
  710. package/dist/progress-ring/web/ds-progress-ring.d.ts +8 -2
  711. package/dist/progress-ring/web/ds-progress-ring.js +9 -3
  712. package/dist/promo-banner/web/ds-promo-banner.js +2 -1
  713. package/dist/proportion-bar/native/ds-proportion-bar.js +4 -3
  714. package/dist/proportion-bar/proportion-bar.d.ts +3 -3
  715. package/dist/proportion-bar/web/ds-proportion-bar.js +5 -5
  716. package/dist/props.d.ts +2 -2
  717. package/dist/provider-button/provider-button.d.ts +6 -6
  718. package/dist/provider-button/web/ds-provider-button.d.ts +8 -8
  719. package/dist/qr-code/qr-code.d.ts +12 -12
  720. package/dist/qr-code/qr-matrix.d.ts +4 -4
  721. package/dist/qr-code/qr-matrix.js +1 -1
  722. package/dist/quick-actions/native/ds-quick-actions.js +4 -3
  723. package/dist/quick-actions/quick-actions.d.ts +2 -2
  724. package/dist/quick-actions/web/ds-quick-actions.js +7 -4
  725. package/dist/radar-chart/radar-chart.d.ts +26 -9
  726. package/dist/radar-chart/radar-chart.js +20 -7
  727. package/dist/radar-chart/web/ds-radar-chart.js +11 -24
  728. package/dist/radial-progress/native/ds-radial-progress.js +18 -20
  729. package/dist/radial-progress/radial-progress.d.ts +10 -10
  730. package/dist/radial-progress/radial-progress.js +1 -1
  731. package/dist/radial-progress/web/ds-radial-progress.js +24 -22
  732. package/dist/radio/radio.d.ts +11 -11
  733. package/dist/radio/web/ds-radio.d.ts +1 -1
  734. package/dist/radio/web/ds-radio.js +9 -5
  735. package/dist/radio-group/radio-group.d.ts +5 -5
  736. package/dist/radio-group/web/ds-radio-group.d.ts +2 -2
  737. package/dist/rating-badge/rating-badge.js +4 -1
  738. package/dist/rating-badge/web/ds-rating-badge.js +1 -1
  739. package/dist/recipient-select/recipient-select.d.ts +8 -4
  740. package/dist/recipient-select/web/ds-recipient-select.d.ts +2 -2
  741. package/dist/recipient-select/web/ds-recipient-select.js +5 -4
  742. package/dist/record-panel/record-panel.d.ts +1 -1
  743. package/dist/record-panel/web/ds-record-panel.js +20 -12
  744. package/dist/recovery-actions/web/ds-recovery-actions.d.ts +1 -1
  745. package/dist/recovery-shell/web/ds-recovery-shell.js +1 -1
  746. package/dist/relative-time/native/ds-relative-time.js +2 -1
  747. package/dist/relative-time/relative-time.d.ts +4 -4
  748. package/dist/reorder-list/reorder-list.d.ts +2 -2
  749. package/dist/reorder-list/web/ds-reorder-list.js +3 -2
  750. package/dist/resend-control/resend-control.d.ts +3 -3
  751. package/dist/resend-control/web/ds-resend-control.js +1 -1
  752. package/dist/route-line/route-line.d.ts +4 -4
  753. package/dist/route-line/web/ds-route-line.js +1 -1
  754. package/dist/route-stops/route-stops.d.ts +1 -1
  755. package/dist/route-stops/web/ds-route-stops.js +6 -3
  756. package/dist/row-actions-cell/web/ds-row-actions-cell.d.ts +4 -2
  757. package/dist/row-actions-cell/web/ds-row-actions-cell.js +2 -2
  758. package/dist/rule-summary/rule-summary.d.ts +8 -8
  759. package/dist/rule-summary/web/ds-rule-summary.d.ts +5 -5
  760. package/dist/rule-summary/web/ds-rule-summary.js +3 -2
  761. package/dist/save-bar/save-bar.d.ts +3 -3
  762. package/dist/save-bar/save-bar.js +1 -1
  763. package/dist/save-bar/web/ds-save-bar.js +2 -1
  764. package/dist/scale.d.ts +19 -19
  765. package/dist/scanner/native/ds-scanner.d.ts +5 -5
  766. package/dist/scanner/native/ds-scanner.js +4 -4
  767. package/dist/scanner/scanner.d.ts +20 -13
  768. package/dist/scanner/scanner.js +12 -8
  769. package/dist/scatter-chart/scatter-chart.d.ts +48 -0
  770. package/dist/scatter-chart/scatter-chart.js +15 -0
  771. package/dist/scatter-chart/web/ds-scatter-chart.d.ts +9 -0
  772. package/dist/scatter-chart/web/ds-scatter-chart.js +34 -0
  773. package/dist/scrim.d.ts +2 -2
  774. package/dist/scrim.js +1 -1
  775. package/dist/search-field/search-field.d.ts +3 -3
  776. package/dist/search-field/web/ds-search-field.d.ts +1 -1
  777. package/dist/search-field/web/ds-search-field.js +25 -6
  778. package/dist/section/native/ds-section.d.ts +5 -0
  779. package/dist/section/native/ds-section.js +9 -0
  780. package/dist/section/section-context.d.ts +1 -0
  781. package/dist/section/section-context.js +2 -0
  782. package/dist/section/section.d.ts +9 -0
  783. package/dist/section/section.js +8 -0
  784. package/dist/section/web/ds-section.d.ts +5 -0
  785. package/dist/section/web/ds-section.js +8 -0
  786. package/dist/section-nav/section-nav.d.ts +7 -7
  787. package/dist/section-nav/web/ds-section-nav.d.ts +2 -2
  788. package/dist/section-nav/web/ds-section-nav.js +2 -2
  789. package/dist/segmented-control/native/ds-segmented-control.js +21 -9
  790. package/dist/segmented-control/segmented-control.d.ts +5 -5
  791. package/dist/segmented-control/web/ds-segmented-control.js +2 -2
  792. package/dist/select/native/ds-select.d.ts +3 -3
  793. package/dist/select/native/ds-select.js +7 -6
  794. package/dist/select/select.d.ts +14 -14
  795. package/dist/select/web/ds-select-option-labels.d.ts +1 -1
  796. package/dist/select/web/ds-select-option-labels.js +2 -1
  797. package/dist/select/web/ds-select.d.ts +9 -9
  798. package/dist/select/web/ds-select.js +37 -12
  799. package/dist/settings-directory/native/ds-settings-directory.js +4 -2
  800. package/dist/settings-directory/web/ds-settings-directory.js +2 -1
  801. package/dist/settings-row/native/ds-settings-row.d.ts +2 -2
  802. package/dist/settings-row/native/ds-settings-row.js +4 -3
  803. package/dist/settings-row/settings-row.d.ts +3 -3
  804. package/dist/settings-row/web/ds-settings-row-group.d.ts +17 -0
  805. package/dist/settings-row/web/ds-settings-row-group.js +7 -0
  806. package/dist/settings-row/web/ds-settings-row.d.ts +5 -3
  807. package/dist/settings-row/web/ds-settings-row.js +3 -2
  808. package/dist/setup-guide/setup-guide.d.ts +19 -15
  809. package/dist/setup-guide/setup-guide.js +1 -0
  810. package/dist/setup-guide/web/ds-setup-guide.d.ts +5 -2
  811. package/dist/setup-guide/web/ds-setup-guide.js +12 -17
  812. package/dist/sheet/native/ds-sheet.d.ts +2 -2
  813. package/dist/sheet/native/ds-sheet.js +2 -2
  814. package/dist/sheet/sheet.d.ts +15 -15
  815. package/dist/sheet/sheet.js +2 -2
  816. package/dist/sheet/web/ds-sheet.d.ts +3 -3
  817. package/dist/sheet/web/ds-sheet.js +4 -2
  818. package/dist/side-nav/side-nav.d.ts +38 -38
  819. package/dist/side-nav/web/ds-side-nav-header.d.ts +1 -1
  820. package/dist/side-nav/web/ds-side-nav-menu.d.ts +4 -4
  821. package/dist/side-nav/web/ds-side-nav-notifications.d.ts +3 -3
  822. package/dist/side-nav/web/ds-side-nav-notifications.js +2 -1
  823. package/dist/side-nav/web/ds-side-nav-primary.d.ts +2 -2
  824. package/dist/side-nav/web/ds-side-nav-primary.js +1 -1
  825. package/dist/side-nav/web/ds-side-nav-profile.d.ts +2 -2
  826. package/dist/side-nav/web/ds-side-nav-profile.js +2 -1
  827. package/dist/side-nav/web/ds-side-nav-search.d.ts +1 -1
  828. package/dist/side-nav/web/ds-side-nav-search.js +1 -1
  829. package/dist/side-nav/web/ds-side-nav.d.ts +11 -11
  830. package/dist/side-nav/web/ds-side-nav.js +8 -7
  831. package/dist/skeleton/native/ds-skeleton.js +10 -8
  832. package/dist/skeleton/skeleton.d.ts +25 -25
  833. package/dist/skeleton/skeleton.js +15 -15
  834. package/dist/skeleton/web/ds-skeleton.js +44 -20
  835. package/dist/slider/native/ds-slider.js +3 -2
  836. package/dist/slider/slider.d.ts +6 -6
  837. package/dist/slider/web/ds-slider.js +2 -2
  838. package/dist/small-multiples/small-multiples.d.ts +49 -0
  839. package/dist/small-multiples/small-multiples.js +40 -0
  840. package/dist/small-multiples/web/ds-small-multiples.d.ts +10 -0
  841. package/dist/small-multiples/web/ds-small-multiples.js +21 -0
  842. package/dist/sparkline/sparkline.d.ts +8 -4
  843. package/dist/sparkline/sparkline.js +2 -2
  844. package/dist/sparkline/web/ds-sparkline.js +0 -2
  845. package/dist/spinner/spinner.d.ts +3 -3
  846. package/dist/split-pane/split-pane.d.ts +13 -13
  847. package/dist/split-pane/web/ds-split-pane.d.ts +2 -2
  848. package/dist/split-pane/web/ds-split-pane.js +3 -3
  849. package/dist/stat-tile/native/ds-stat-tile.d.ts +1 -1
  850. package/dist/stat-tile/native/ds-stat-tile.js +5 -7
  851. package/dist/stat-tile/stat-tile.d.ts +14 -12
  852. package/dist/stat-tile/stat-tile.js +5 -4
  853. package/dist/stat-tile/web/ds-stat-tile.d.ts +5 -2
  854. package/dist/stat-tile/web/ds-stat-tile.js +6 -5
  855. package/dist/state-message/state-message.d.ts +1 -1
  856. package/dist/state-message/state-message.js +7 -1
  857. package/dist/state-message/web/ds-state-message.js +1 -1
  858. package/dist/status-badge/native/ds-status-badge.js +2 -2
  859. package/dist/status-badge/status-badge.d.ts +3 -3
  860. package/dist/status-badge/web/ds-status-badge.d.ts +6 -6
  861. package/dist/status-badge/web/ds-status-badge.js +2 -2
  862. package/dist/status-cell/web/ds-status-cell.d.ts +1 -1
  863. package/dist/status-cell/web/ds-status-cell.js +3 -2
  864. package/dist/status-control/status-control.d.ts +11 -9
  865. package/dist/status-control/status-control.js +1 -1
  866. package/dist/status-control/web/ds-status-control.d.ts +1 -1
  867. package/dist/status-control/web/ds-status-control.js +3 -3
  868. package/dist/status-dot/native/ds-status-dot.d.ts +1 -1
  869. package/dist/status-dot/native/ds-status-dot.js +4 -2
  870. package/dist/status-dot/status-dot.d.ts +11 -11
  871. package/dist/status-dot/web/ds-status-dot.d.ts +1 -1
  872. package/dist/status-dot/web/ds-status-dot.js +4 -2
  873. package/dist/status-vocabularies.d.ts +2 -2
  874. package/dist/stepper-form/stepper-form.d.ts +7 -7
  875. package/dist/stepper-form/web/ds-stepper-form.d.ts +3 -3
  876. package/dist/stepper-form/web/ds-stepper-form.js +3 -2
  877. package/dist/steps/steps.d.ts +20 -7
  878. package/dist/steps/steps.js +2 -1
  879. package/dist/steps/web/ds-steps.d.ts +1 -1
  880. package/dist/steps/web/ds-steps.js +58 -15
  881. package/dist/stick-chart/stick-chart.d.ts +2 -2
  882. package/dist/stick-chart/web/ds-stick-chart.d.ts +2 -2
  883. package/dist/stick-chart/web/ds-stick-chart.js +13 -10
  884. package/dist/switch/switch.d.ts +2 -2
  885. package/dist/switch/web/ds-switch.js +1 -1
  886. package/dist/system-state/system-state.d.ts +1 -1
  887. package/dist/system-state/web/ds-system-state.d.ts +1 -1
  888. package/dist/system-state/web/ds-system-state.js +2 -1
  889. package/dist/table-toolbar/web/ds-table-toolbar.d.ts +3 -4
  890. package/dist/table-toolbar/web/ds-table-toolbar.js +20 -4
  891. package/dist/tabs/tabs.d.ts +10 -6
  892. package/dist/tabs/tabs.js +13 -4
  893. package/dist/tabs/web/ds-tabs.d.ts +1 -1
  894. package/dist/tabs/web/ds-tabs.js +9 -6
  895. package/dist/task/web/ds-task-editor.d.ts +3 -3
  896. package/dist/task/web/ds-task-editor.js +2 -2
  897. package/dist/task-shell/task-shell.d.ts +17 -13
  898. package/dist/task-shell/task-shell.js +2 -1
  899. package/dist/task-shell/web/ds-task-shell.d.ts +9 -9
  900. package/dist/task-shell/web/ds-task-shell.js +12 -5
  901. package/dist/text/native/ds-text.d.ts +5 -1
  902. package/dist/text/native/ds-text.js +12 -10
  903. package/dist/text/text.d.ts +88 -46
  904. package/dist/text/text.js +76 -41
  905. package/dist/text/web/ds-text.d.ts +1 -1
  906. package/dist/text/web/ds-text.js +16 -10
  907. package/dist/textarea/native/ds-textarea.js +7 -6
  908. package/dist/textarea/web/ds-textarea.js +10 -8
  909. package/dist/time-range/time-range.d.ts +8 -4
  910. package/dist/time-range/web/ds-time-range.d.ts +1 -1
  911. package/dist/time-range/web/ds-time-range.js +23 -9
  912. package/dist/timeline/native/ds-timeline.d.ts +1 -1
  913. package/dist/timeline/native/ds-timeline.js +6 -4
  914. package/dist/timeline/timeline.d.ts +9 -9
  915. package/dist/timeline/web/ds-timeline.d.ts +3 -3
  916. package/dist/timeline/web/ds-timeline.js +4 -3
  917. package/dist/toast/native/ds-toast.js +1 -1
  918. package/dist/toast/toast.d.ts +4 -4
  919. package/dist/toggle-group/toggle-group.d.ts +6 -6
  920. package/dist/token-roles.d.ts +2 -2
  921. package/dist/token-roles.js +21 -4
  922. package/dist/tone.d.ts +9 -9
  923. package/dist/tone.js +1 -1
  924. package/dist/toolbar/toolbar.d.ts +2 -2
  925. package/dist/toolbar/web/ds-toolbar.d.ts +1 -1
  926. package/dist/toolbar/web/ds-toolbar.js +1 -1
  927. package/dist/tooltip/tooltip.d.ts +11 -11
  928. package/dist/tooltip/tooltip.js +4 -4
  929. package/dist/tooltip/web/ds-tooltip.d.ts +4 -4
  930. package/dist/tooltip/web/ds-tooltip.js +1 -1
  931. package/dist/track-bars/track-bars.d.ts +49 -0
  932. package/dist/track-bars/track-bars.js +22 -0
  933. package/dist/track-bars/web/ds-track-bars.d.ts +8 -0
  934. package/dist/track-bars/web/ds-track-bars.js +24 -0
  935. package/dist/trail-line/trail-line.d.ts +12 -12
  936. package/dist/trail-line/trail-line.js +1 -1
  937. package/dist/trail-line/web/ds-trail-line.d.ts +2 -2
  938. package/dist/trail-line/web/ds-trail-line.js +13 -12
  939. package/dist/tree/tree.d.ts +11 -11
  940. package/dist/tree/web/ds-tree.d.ts +1 -1
  941. package/dist/tree/web/ds-tree.js +5 -4
  942. package/dist/treemap/treemap.d.ts +40 -0
  943. package/dist/treemap/treemap.js +74 -0
  944. package/dist/treemap/web/ds-treemap.d.ts +14 -0
  945. package/dist/treemap/web/ds-treemap.js +29 -0
  946. package/dist/trip-replay/trip-replay.d.ts +12 -12
  947. package/dist/trip-replay/web/ds-trip-replay.d.ts +1 -1
  948. package/dist/trip-replay/web/ds-trip-replay.js +2 -1
  949. package/dist/two-line-cell/web/ds-two-line-cell.js +1 -1
  950. package/dist/value-row/native/ds-value-row.js +7 -2
  951. package/dist/value-row/value-row.d.ts +3 -3
  952. package/dist/vehicle-marker/vehicle-marker.d.ts +10 -10
  953. package/dist/vehicle-marker/web/ds-vehicle-marker.d.ts +1 -1
  954. package/dist/vehicle-marker/web/ds-vehicle-marker.js +4 -2
  955. package/dist/waterfall-chart/waterfall-chart.d.ts +55 -0
  956. package/dist/waterfall-chart/waterfall-chart.js +44 -0
  957. package/dist/waterfall-chart/web/ds-waterfall-chart.d.ts +14 -0
  958. package/dist/waterfall-chart/web/ds-waterfall-chart.js +31 -0
  959. package/dist/web.d.ts +36 -2
  960. package/dist/web.js +18 -1
  961. package/dist/week-schedule/web/ds-week-schedule.d.ts +1 -1
  962. package/dist/week-schedule/web/ds-week-schedule.js +5 -4
  963. package/dist/week-schedule/week-schedule.d.ts +4 -4
  964. package/dist/week-schedule/week-schedule.js +5 -2
  965. package/forced-colors.css +35 -35
  966. package/package.json +4 -4
  967. package/styles.css +2 -2
@@ -1,11 +1,11 @@
1
1
  /** How much colour the pools carry. `subtle` behind words; `medium` where the
2
- * gradient is the moment — a splash, a success. */
2
+ * gradient is the moment, a splash, a success. */
3
3
  export declare const AMBIENT_GRADIENT_INTENSITIES: readonly ["subtle", "medium"];
4
4
  export type AmbientGradientIntensity = (typeof AMBIENT_GRADIENT_INTENSITIES)[number];
5
5
  /** The surface the pools sit on, which decides the ink placed over them. */
6
6
  export declare const AMBIENT_GRADIENT_GROUNDS: readonly ["background", "hero", "app"];
7
7
  export type AmbientGradientGround = (typeof AMBIENT_GRADIENT_GROUNDS)[number];
8
- /** The roles the pools are painted in — the brand pack's gradient stops. */
8
+ /** The roles the pools are painted in, the brand pack's gradient stops. */
9
9
  export declare const AMBIENT_GRADIENT_POOL_ROLES: readonly ["ambient-pool-1", "ambient-pool-2", "ambient-pool-3"];
10
10
  /** The driver app's own three pools, the same drifts in the app's hues. */
11
11
  export declare const AMBIENT_GRADIENT_APP_POOL_ROLES: readonly ["ambient-pool-app-1", "ambient-pool-app-2", "ambient-pool-app-3"];
@@ -29,10 +29,10 @@ export interface AmbientGradientWaypoint {
29
29
  y: number;
30
30
  scale: number;
31
31
  }
32
- /** One pool of colour: where it lives, how big it is, and where it wanders. */
32
+ /** One pool of colour: where it lives, how big it is and where it wanders. */
33
33
  export interface AmbientGradientPool {
34
34
  role: AmbientGradientPoolRole;
35
- /** The pool's centre at rest, as fractions of the box — 0,0 is top-left. */
35
+ /** The pool's centre at rest, as fractions of the box, 0,0 is top-left. */
36
36
  home: {
37
37
  x: number;
38
38
  y: number;
@@ -58,7 +58,7 @@ export interface AmbientGradientResolvedSpec {
58
58
  pools: readonly (AmbientGradientPool & {
59
59
  opacity: number;
60
60
  })[];
61
- /** Present only when `scrim` is on — absent rather than zero, so an adapter
61
+ /** Present only when `scrim` is on, absent rather than zero, so an adapter
62
62
  * cannot paint an empty wash by forgetting to check. */
63
63
  scrim?: {
64
64
  role: AmbientGradientGroundRole;
@@ -68,14 +68,14 @@ export interface AmbientGradientResolvedSpec {
68
68
  /** The one function an adapter calls. */
69
69
  export declare function ambientGradientSpec(intensity?: AmbientGradientIntensity, ground?: AmbientGradientGround, scrim?: boolean): AmbientGradientResolvedSpec;
70
70
  /** The most colour any single point can carry once every pool overlaps there
71
- * and the scrim is laid over them — the number the contrast promise rests on. */
71
+ * and the scrim is laid over them, the number the contrast promise rests on. */
72
72
  export declare function ambientGradientPeakTint(spec: AmbientGradientResolvedSpec): number;
73
73
  export interface AmbientGradientDriftInput {
74
74
  /** The person has asked their system for less motion. */
75
75
  reducedMotion: boolean;
76
76
  /** Any part of the box is on screen. */
77
77
  visible: boolean;
78
- /** The tab or the app is in front — not hidden, not backgrounded. */
78
+ /** The tab or the app is in front, not hidden, not backgrounded. */
79
79
  foreground: boolean;
80
80
  /** The caller has asked for the pools to hold still. */
81
81
  still: boolean;
@@ -84,7 +84,7 @@ export interface AmbientGradientDriftInput {
84
84
  * no, because each reason to stop is sufficient on its own. */
85
85
  export declare function ambientGradientShouldDrift({ reducedMotion, visible, foreground, still, }: AmbientGradientDriftInput): boolean;
86
86
  /** A waypoint as a CSS transform. Percentages of the layer's own box, which is
87
- * what `translate()` percentages mean — so the path scales with the pool. */
87
+ * what `translate()` percentages mean, so the path scales with the pool. */
88
88
  export declare function ambientGradientTransform(point: AmbientGradientWaypoint): string;
89
89
  /** A pool's path as Web Animations keyframes: out along the path, played
90
90
  * alternate so it comes back the same way. */
@@ -102,13 +102,13 @@ export declare function ambientGradientTiming(pool: AmbientGradientPool): {
102
102
  /** The keyframe name a stylesheet would give a pool, for the CSS below. */
103
103
  export declare function ambientGradientKeyframesName(index: number): string;
104
104
  /**
105
- * The same drift as stylesheet keyframes — what a theme would carry if the
105
+ * The same drift as stylesheet keyframes, what a theme would carry if the
106
106
  * drift moved out of script. The adapters do not need it: they drive the
107
107
  * identical path through the Web Animations API, which needs no stylesheet and
108
108
  * can be paused and cancelled from the component that owns it.
109
109
  */
110
110
  export declare function ambientGradientKeyframesCss(): string;
111
- /** Where a pool sits at `progress` (0 at home, 1 at the end of the path) —
111
+ /** Where a pool sits at `progress` (0 at home, 1 at the end of the path),
112
112
  * what the native fallback interpolates between. Linear between waypoints;
113
113
  * the easing lives in the timing, not in the path. */
114
114
  export declare function ambientGradientPointAt(pool: AmbientGradientPool, progress: number): AmbientGradientWaypoint;
@@ -118,7 +118,7 @@ export declare const AMBIENT_GRADIENT_FALLOFF: readonly {
118
118
  }[];
119
119
  export declare const AMBIENT_GRADIENT_RING_COUNT = 6;
120
120
  /** The opacity each of `rings` stacked discs needs so that where all of them
121
- * overlap the colour reaches `opacity` — the overlap, not the sum. */
121
+ * overlap the colour reaches `opacity`, the overlap, not the sum. */
122
122
  export declare function ambientGradientRingOpacity(opacity: number, rings?: number): number;
123
123
  /** Each ring's diameter as a fraction of the pool's, outermost first. The
124
124
  * outermost stops short of the pool's box for the same reason the web fade
@@ -1,6 +1,6 @@
1
1
  import { type ComponentType, type ReactNode } from 'react';
2
2
  import { type StyleProp, type ViewStyle } from 'react-native';
3
- /** What the mesh component is given: the brand's stop colours, and whether it may move. */
3
+ /** What the mesh component is given: the brand's stop colours and whether it may move. */
4
4
  export interface AmbientGradientMeshProps {
5
5
  /** The brand's gradient stops, resolved to colour literals, in order. */
6
6
  colors: readonly string[];
@@ -5,5 +5,5 @@ export type DSAmbientGradientProps = ViewProps & AmbientGradientContract & {
5
5
  /** The content standing on the gradient. */
6
6
  children?: ReactNode;
7
7
  };
8
- /** A soft, slowly drifting wash of the brand's gradient hues, for brand moments only — never behind data. */
8
+ /** A soft, slowly drifting wash of the brand's gradient hues, for brand moments only, never behind data. */
9
9
  export declare function DSAmbientGradient({ intensity, ground, scrim, still, className, children, onLayout, ...props }: DSAmbientGradientProps): import("react/jsx-runtime").JSX.Element;
@@ -1,5 +1,5 @@
1
1
  import { type ComponentProps } from 'react';
2
2
  import { type AmbientGradientContract } from '../ambient-gradient';
3
3
  export type DSAmbientGradientProps = ComponentProps<'div'> & AmbientGradientContract;
4
- /** A soft, slowly drifting wash of the brand's gradient hues, for brand moments only — never behind data. */
4
+ /** A soft, slowly drifting wash of the brand's gradient hues, for brand moments only, never behind data. */
5
5
  export declare function DSAmbientGradient({ intensity, ground, scrim, still, className, children, ...props }: DSAmbientGradientProps): import("react/jsx-runtime").JSX.Element;
@@ -8,7 +8,7 @@ export type AmountSize = (typeof AMOUNT_SIZES)[number];
8
8
  export declare const AMOUNT_MINUS = "\u2212";
9
9
  /** The thousands separator, a no-break space (U+00A0). */
10
10
  export declare const AMOUNT_GROUP_SEPARATOR = "\u00A0";
11
- /** What an amount that is not a number renders as — an em dash. */
11
+ /** What an amount that is not a number renders as, an em dash. */
12
12
  export declare const AMOUNT_EMPTY = "\u2014";
13
13
  /** What an amount that is not a number is called to a screen reader. */
14
14
  export declare const AMOUNT_EMPTY_LABEL = "No amount";
@@ -40,35 +40,35 @@ export interface AmountFormatOptions {
40
40
  export interface AmountParts {
41
41
  sign: AmountSign;
42
42
  currency: string;
43
- /** The whole part, grouped — `1 284`, or `1.2` when compact. */
43
+ /** The whole part, grouped, `1 284`, or `1.2` when compact. */
44
44
  whole: string;
45
- /** The decimal point and the cents — `.50` — or empty. */
45
+ /** The decimal point and the cents, `.50`, or empty. */
46
46
  fraction: string;
47
- /** The compact unit — `k`, `m`, `bn` — or empty. */
47
+ /** The compact unit, `k`, `m`, `bn`, or empty. */
48
48
  suffix: string;
49
49
  /** Everything above, joined: what a sighted reader sees. */
50
50
  text: string;
51
51
  /** The exact figure, ungrouped, sign spelled as a word: what a listener hears. */
52
52
  label: string;
53
- /** Whether the figure is zero once rounded — and so carries no sign. */
53
+ /** Whether the figure is zero once rounded and so carries no sign. */
54
54
  zero: boolean;
55
55
  /** Whether the value was not a finite number and rendered as a dash. */
56
56
  empty: boolean;
57
57
  }
58
58
  /**
59
59
  * A non-negative finite number rounded half away from zero to `digits` places,
60
- * as a plain decimal string with exactly that many places — `1.005` → `"1.01"`.
60
+ * as a plain decimal string with exactly that many places, `1.005` → `"1.01"`.
61
61
  * Works on the decimal spelling, so no float error and no exponent notation.
62
62
  */
63
63
  export declare function roundHalfAwayFromZero(abs: number, digits: number): string;
64
- /** Groups a string of whole digits in threes from the right — `1284` → `1 284`. */
64
+ /** Groups a string of whole digits in threes from the right, `1284` → `1 284`. */
65
65
  export declare function groupThousands(whole: string, separator?: string): string;
66
66
  /**
67
67
  * The amount split into sign, currency, digits and suffix, plus the text a
68
68
  * reader sees and the label a listener hears. The one function adapters call.
69
69
  */
70
70
  export declare function amountParts(value: number, options?: AmountFormatOptions): AmountParts;
71
- /** The amount as one display string — `formatAmount(-1284.5)` → `−R1 284.50`. */
71
+ /** The amount as one display string, `formatAmount(-1284.5)` → `−R1 284.50`. */
72
72
  export declare function formatAmount(value: number, options?: AmountFormatOptions): string;
73
73
  export declare const AMOUNT_INK = "foreground";
74
74
  export declare const AMOUNT_CREDIT_INK = "success";
@@ -85,29 +85,29 @@ export interface AmountSizeSpec {
85
85
  maxScale: number;
86
86
  }
87
87
  export declare const AMOUNT_SIZE_SPECS: {
88
- readonly sm: {
89
- readonly scale: "body-sm";
90
- readonly quietScale: "body-sm";
91
- readonly weight: "semibold";
92
- readonly maxScale: 1.6;
88
+ sm: {
89
+ scale: "body-sm";
90
+ quietScale: "body-sm";
91
+ weight: "semibold";
92
+ maxScale: number;
93
93
  };
94
- readonly md: {
95
- readonly scale: "body-md";
96
- readonly quietScale: "body-md";
97
- readonly weight: "semibold";
98
- readonly maxScale: 2;
94
+ md: {
95
+ scale: "body-md";
96
+ quietScale: "body-md";
97
+ weight: "semibold";
98
+ maxScale: number;
99
99
  };
100
- readonly lg: {
101
- readonly scale: "heading-xl";
102
- readonly quietScale: "heading-md";
103
- readonly weight: "bold";
104
- readonly maxScale: 1.45;
100
+ lg: {
101
+ scale: "heading-xl";
102
+ quietScale: "heading-md";
103
+ weight: "bold";
104
+ maxScale: number;
105
105
  };
106
106
  };
107
107
  export interface AmountResolvedSpec {
108
108
  ink: AmountInkRole;
109
109
  scale: AmountScaleStep;
110
- /** The cents' step — smaller than `scale` only at `lg` with `quietCents`. */
110
+ /** The cents' step, smaller than `scale` only at `lg` with `quietCents`. */
111
111
  fractionScale: AmountScaleStep;
112
112
  weight: AmountSizeSpec['weight'];
113
113
  maxScale: number;
@@ -119,7 +119,7 @@ export declare function amountSpec(direction: AmountDirection | undefined, size?
119
119
  }): AmountResolvedSpec;
120
120
  /** The props every Amount implementation accepts. */
121
121
  export interface AmountContract extends AmountFormatOptions {
122
- /** The amount in currency units — rand, not cents. */
122
+ /** The amount in currency units, rand, not cents. */
123
123
  value: number;
124
124
  /** The type step: `sm` and `md` for rows, `lg` for a hero balance. */
125
125
  size?: Forwarded<AmountSize>;
@@ -1,3 +1,4 @@
1
+ import { textMaxScale } from '../text/text';
1
2
  export const AMOUNT_DIRECTIONS = ['credit', 'debit', 'failed'];
2
3
  export const AMOUNT_SIZES = ['sm', 'md', 'lg'];
3
4
  export const AMOUNT_MINUS = '−';
@@ -114,9 +115,9 @@ export const AMOUNT_INK = 'foreground';
114
115
  export const AMOUNT_CREDIT_INK = 'success';
115
116
  export const AMOUNT_FAILED_INK = 'destructive';
116
117
  export const AMOUNT_SIZE_SPECS = {
117
- sm: { scale: 'body-sm', quietScale: 'body-sm', weight: 'semibold', maxScale: 1.6 },
118
- md: { scale: 'body-md', quietScale: 'body-md', weight: 'semibold', maxScale: 2 },
119
- lg: { scale: 'heading-xl', quietScale: 'heading-md', weight: 'bold', maxScale: 1.45 },
118
+ sm: { scale: 'body-sm', quietScale: 'body-sm', weight: 'semibold', maxScale: textMaxScale(14) },
119
+ md: { scale: 'body-md', quietScale: 'body-md', weight: 'semibold', maxScale: textMaxScale(16) },
120
+ lg: { scale: 'heading-xl', quietScale: 'heading-md', weight: 'bold', maxScale: textMaxScale(32) },
120
121
  };
121
122
  export function amountSpec(direction, size = 'md', options = {}) {
122
123
  const sizing = AMOUNT_SIZE_SPECS[size];
@@ -1,5 +1,6 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
- import { Text } from 'react-native';
2
+ import {} from 'react-native';
3
+ import { Text } from '../../lib/native/text';
3
4
  import { amountParts, amountSpec, } from '../amount';
4
5
  import { cn } from '../../lib/cn';
5
6
  const INK = {
@@ -16,7 +16,7 @@ const WEIGHT = { semibold: 'font-semibold', bold: 'font-bold' };
16
16
  export function DSAmount({ value, currency, fractionDigits, direction, compact, size = 'md', quietCents, className, ...props }) {
17
17
  const parts = amountParts(value, { currency, fractionDigits, direction, compact });
18
18
  const spec = amountSpec(direction, size, { zero: parts.zero, quietCents });
19
- return (_jsxs("span", { className: cn('inline-block whitespace-nowrap tabular-nums', WEIGHT[spec.weight], INK[spec.ink], SCALE[spec.scale], className), "data-direction": direction, ...props, children: [_jsx("span", { className: "sr-only", children: parts.label }), _jsxs("span", { "aria-hidden": true, children: [parts.sign, parts.currency, parts.whole, parts.fraction !== '' && (_jsx("span", { className: spec.fractionScale === spec.scale
19
+ return (_jsxs("span", { className: cn('amount-type inline-block whitespace-nowrap tabular-nums', WEIGHT[spec.weight], INK[spec.ink], SCALE[spec.scale], className), "data-direction": direction, "data-amount-weight": spec.weight, "data-amount-ink": spec.ink, ...props, children: [_jsx("span", { className: "sr-only", children: parts.label }), _jsxs("span", { "aria-hidden": true, children: [parts.sign, parts.currency, parts.whole, parts.fraction !== '' && (_jsx("span", { "data-amount-cents": "", className: spec.fractionScale === spec.scale
20
20
  ? undefined
21
21
  : cn(SCALE[spec.fractionScale], WEIGHT[spec.weight]), children: parts.fraction })), parts.suffix] })] }));
22
22
  }
@@ -4,5 +4,5 @@ import { amountCellRand } from '../amount-cell';
4
4
  import { DSAmount } from '../../amount/web/ds-amount';
5
5
  import { DSText } from '../../text/web/ds-text';
6
6
  export function DSAmountCell({ minor, detail, size = 'md', currency, fractionDigits, direction, compact, className, ...props }) {
7
- return (_jsxs("span", { className: cn('inline-flex flex-col items-end text-end', className), ...props, children: [_jsx(DSAmount, { value: amountCellRand(minor), size: size, ...(currency === undefined ? {} : { currency }), ...(fractionDigits === undefined ? {} : { fractionDigits }), ...(direction === undefined ? {} : { direction }), ...(compact === undefined ? {} : { compact }) }), detail !== undefined && detail !== '' && (_jsx(DSText, { variant: "caption", tone: "muted", children: detail }))] }));
7
+ return (_jsxs("span", { className: cn('inline-flex flex-col items-end text-end', className), ...props, children: [_jsx(DSAmount, { value: amountCellRand(minor), size: size, ...(currency === undefined ? {} : { currency }), ...(fractionDigits === undefined ? {} : { fractionDigits }), ...(direction === undefined ? {} : { direction }), ...(compact === undefined ? {} : { compact }) }), detail !== undefined && detail !== '' && (_jsx(DSText, { variant: "body-sm", tone: "muted", children: detail }))] }));
8
8
  }
@@ -16,12 +16,12 @@ export interface AmountEntryRules {
16
16
  maxDecimals?: number | undefined;
17
17
  }
18
18
  export interface AmountEntryStep {
19
- /** The entry after the key — unchanged when refused. */
19
+ /** The entry after the key, unchanged when refused. */
20
20
  value: string;
21
21
  /** Why the key was refused, or `undefined` when it was taken. */
22
22
  refused: AmountEntryRefusal | undefined;
23
23
  }
24
- /** The figure an entry stands for — 0 for the empty entry. */
24
+ /** The figure an entry stands for, 0 for the empty entry. */
25
25
  export declare function amountEntryNumber(value: string): number;
26
26
  /**
27
27
  * Applies one keypad press to the entry. Returns the new entry, or the same
@@ -30,22 +30,22 @@ export declare function amountEntryNumber(value: string): number;
30
30
  export declare function amountEntryReduce(value: string, key: KeypadKey, rules?: AmountEntryRules): AmountEntryStep;
31
31
  export interface AmountEntryDisplay {
32
32
  currency: string;
33
- /** The whole part, grouped — `1 284` — or `0` for the empty entry. */
33
+ /** The whole part, grouped, `1 284`, or `0` for the empty entry. */
34
34
  whole: string;
35
- /** The point and whatever has been typed after it — `.`, `.5`, `.50` — or empty. */
35
+ /** The point and whatever has been typed after it, `.`, `.5`, `.50`, or empty. */
36
36
  fraction: string;
37
37
  /** Everything above, joined: what a sighted reader sees. */
38
38
  text: string;
39
- /** Whether nothing has been typed, and the display is the placeholder `R0`. */
39
+ /** Whether nothing has been typed and the display is the placeholder `R0`. */
40
40
  empty: boolean;
41
41
  }
42
42
  /** The currency an entry draws: none by default once it measures something in a unit. */
43
43
  export declare function amountEntryCurrency(currency: string | undefined, unit: string | undefined): string;
44
- /** The entry as it is drawn: the currency, the grouped whole, the fraction exactly as typed, and the unit. */
44
+ /** The entry as it is drawn: the currency, the grouped whole, the fraction exactly as typed and the unit. */
45
45
  export declare function amountEntryDisplay(value: string, currency?: string, unit?: string): AmountEntryDisplay;
46
46
  /**
47
47
  * What a screen reader hears for the entry: the figure ungrouped, so it is read
48
- * as one number — "R1284.5" — and "R0" for the empty entry.
48
+ * as one number, "R1284.5" and "R0" for the empty entry.
49
49
  */
50
50
  export declare function amountEntrySpoken(value: string, currency?: string, unit?: string): string;
51
51
  /** What the screen says when a key was refused, or `undefined` when there is nothing to say. */
@@ -78,7 +78,7 @@ export interface AmountEntryContract {
78
78
  /** The currency symbol drawn before the figure. */
79
79
  currency?: Forwarded<string>;
80
80
  /** What a measure is counted in, "km" or "L", drawn and said after the figure.
81
- * An entry with a unit has no currency unless one is passed, and its
81
+ * An entry with a unit has no currency unless one is passed and its
82
82
  * refusals speak of a number, not an amount. */
83
83
  unit?: Forwarded<string>;
84
84
  /** Turns off the decimal point, for whole rand amounts. */
@@ -1,11 +1,12 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { useEffect, useRef, useState } from 'react';
3
- import { Platform, Text, View } from 'react-native';
3
+ import { Platform, View } from 'react-native';
4
4
  import { amountEntryCurrency, amountEntryDisplay, amountEntryFigureSize, amountEntryInk, amountEntryMessage, amountEntryReduce, amountEntrySpoken, } from '../amount-entry';
5
5
  import { DSKeypad } from '../../keypad/native/ds-keypad';
6
6
  import { DSMetric } from '../../metric/native/ds-metric';
7
7
  import { cn } from '../../lib/cn';
8
8
  import { announce as say } from '../../lib/native/announce';
9
+ import { DSText } from '../../text/native/ds-text';
9
10
  const INK = {
10
11
  foreground: 'text-foreground',
11
12
  'muted-foreground': 'text-muted-foreground',
@@ -43,5 +44,5 @@ export function DSAmountEntry({ value, onValueChange, max, label, currency, unit
43
44
  if (step.refused === undefined && step.value !== value)
44
45
  onValueChange(step.value);
45
46
  };
46
- return (_jsxs(View, { className: cn('gap-4', className), ...props, children: [_jsxs(View, { className: "items-center gap-1", children: [_jsxs(View, { accessible: true, accessibilityLabel: `${label}, ${spoken}`, ...(disabled ? { 'aria-disabled': true } : {}), accessibilityLiveRegion: "polite", className: "items-center gap-1", children: [_jsx(Text, { className: "font-sans text-body-sm text-muted-foreground", children: label }), _jsx(View, { importantForAccessibility: "no-hide-descendants", accessibilityElementsHidden: true, className: "min-h-16 justify-center", children: _jsx(DSMetric, { size: amountEntryFigureSize(display), roll: roll && !display.empty && !disabled, className: INK[amountEntryInk(display, disabled)], children: display.text }) })] }), _jsx(Text, { accessibilityLiveRegion: "polite", className: cn('font-sans min-h-5 text-body-sm', MESSAGE_INK['muted-foreground']), children: message ?? '' })] }), _jsx(DSKeypad, { label: `${label} keypad`, decimal: !wholeOnly, disabled: disabled, onKey: onKey })] }));
47
+ return (_jsxs(View, { className: cn('gap-4', className), ...props, children: [_jsxs(View, { className: "items-center gap-1", children: [_jsxs(View, { accessible: true, accessibilityLabel: `${label}, ${spoken}`, ...(disabled ? { 'aria-disabled': true } : {}), accessibilityLiveRegion: "polite", className: "items-center gap-1", children: [_jsx(DSText, { variant: "body-sm", className: "text-muted-foreground", children: label }), _jsx(View, { importantForAccessibility: "no-hide-descendants", accessibilityElementsHidden: true, className: "min-h-16 justify-center", children: _jsx(DSMetric, { size: amountEntryFigureSize(display), roll: roll && !display.empty && !disabled, className: INK[amountEntryInk(display, disabled)], children: display.text }) })] }), _jsx(DSText, { variant: "body-sm", accessibilityLiveRegion: "polite", className: cn('min-h-5', MESSAGE_INK['muted-foreground']), children: message ?? '' })] }), _jsx(DSKeypad, { label: `${label} keypad`, decimal: !wholeOnly, disabled: disabled, onKey: onKey })] }));
47
48
  }
@@ -4,6 +4,7 @@ import { amountEntryCurrency, amountEntryDisplay, amountEntryFigureSize, amountE
4
4
  import { DSKeypad } from '../../keypad/web/ds-keypad';
5
5
  import { DSMetric } from '../../metric/web/ds-metric';
6
6
  import { cn } from '../../lib/cn';
7
+ import { DSText } from '../../text/web/ds-text';
7
8
  const INK = {
8
9
  foreground: 'text-foreground',
9
10
  'muted-foreground': 'text-muted-foreground',
@@ -25,5 +26,5 @@ export function DSAmountEntry({ value, onValueChange, max, label, currency, unit
25
26
  if (step.refused === undefined && step.value !== value)
26
27
  onValueChange(step.value);
27
28
  };
28
- return (_jsxs("div", { ...props, role: "group", "aria-labelledby": labelId, ...(disabled ? { 'aria-disabled': true } : {}), className: cn('flex flex-col items-stretch gap-4', className), children: [_jsxs("div", { className: "flex flex-col items-center gap-1 text-center", children: [_jsx("span", { id: labelId, className: "text-body-sm text-muted-foreground", children: label }), _jsx("span", { "aria-live": "polite", "aria-atomic": "true", className: "sr-only", children: amountEntrySpoken(value, shownCurrency, unit) }), _jsx("span", { "aria-hidden": true, className: "flex min-h-16 items-center", children: _jsx(DSMetric, { size: amountEntryFigureSize(display), roll: roll, "data-empty": display.empty, className: INK[amountEntryInk(display, disabled)], children: display.text }) }), _jsx("span", { "aria-live": "polite", className: cn('min-h-5 text-body-sm', MESSAGE_INK['muted-foreground']), children: message ?? '' })] }), _jsx(DSKeypad, { label: `${label} keypad`, decimal: !wholeOnly, disabled: disabled, onKey: onKey })] }));
29
+ return (_jsxs("div", { ...props, role: "group", "aria-labelledby": labelId, ...(disabled ? { 'aria-disabled': true } : {}), className: cn('flex flex-col items-stretch gap-4', className), children: [_jsxs("div", { className: "flex flex-col items-center gap-1 text-center", children: [_jsx(DSText, { as: "span", variant: "body-sm", id: labelId, className: "text-muted-foreground", children: label }), _jsx("span", { "aria-live": "polite", "aria-atomic": "true", className: "sr-only", children: amountEntrySpoken(value, shownCurrency, unit) }), _jsx("span", { "aria-hidden": true, className: "flex min-h-16 items-center", children: _jsx(DSMetric, { size: amountEntryFigureSize(display), roll: roll, "data-empty": display.empty, className: INK[amountEntryInk(display, disabled)], children: display.text }) }), _jsx(DSText, { as: "span", variant: "body-sm", "aria-live": "polite", className: cn('min-h-5', MESSAGE_INK['muted-foreground']), children: message ?? '' })] }), _jsx(DSKeypad, { label: `${label} keypad`, decimal: !wholeOnly, disabled: disabled, onKey: onKey })] }));
29
30
  }
@@ -1,15 +1,15 @@
1
1
  import type { Forwarded } from '../props';
2
2
  import type { TokenRole } from '../token-roles';
3
- /** A region that is absent renders no box at all, rather than an empty one —
3
+ /** A region that is absent renders no box at all, rather than an empty one,
4
4
  * an empty pinned strip is a band of background nobody asked for. */
5
5
  export declare const APP_SHELL_REGIONS: readonly ["banner", "nav", "header", "footer"];
6
6
  export type AppShellRegion = (typeof APP_SHELL_REGIONS)[number];
7
7
  export declare const APP_SHELL_CONTENT_MAX_WIDTH_PX: 1280;
8
- export declare const APP_SHELL_GUTTER_PX: 24;
8
+ export declare const APP_SHELL_GUTTER_PX: 28;
9
9
  export declare const APP_SHELL_RAIL_MIN_WIDTH_PX: 768;
10
10
  export type AppShellSurfaceRole = Extract<TokenRole, 'background'>;
11
11
  /** The rule between a pinned region and the content under it. `border-subtle`
12
- * is the role for a line BETWEEN two regions — the same one the side nav
12
+ * is the role for a line BETWEEN two regions, the same one the side nav
13
13
  * draws down its own trailing edge, so the two meet as one continuous rule
14
14
  * rather than two weights a pixel apart. */
15
15
  export type AppShellEdgeRole = Extract<TokenRole, 'border-subtle'>;
@@ -19,28 +19,28 @@ export interface AppShellResolvedSpec {
19
19
  surface: AppShellSurfaceRole;
20
20
  edge: AppShellEdgeRole;
21
21
  }
22
- /** The one function an adapter calls. No size or tone axis exists for a frame —
22
+ /** The one function an adapter calls. No size or tone axis exists for a frame,
23
23
  * the same "one recipe" shape `bottomNavSpec()` takes no arguments for. */
24
24
  export declare function appShellSpec(): AppShellResolvedSpec;
25
25
  export declare const APP_SHELL_SURFACE_ROLES: readonly ["background"];
26
26
  export declare const APP_SHELL_EDGE_ROLES: readonly ["border-subtle"];
27
27
  /** The props every App Shell implementation accepts. Web only: a phone has no
28
- * rail and no pinned header of this shape, and the driver app's frame is its
29
- * own bottom nav plus a screen — see `bottom-nav.ts`. */
28
+ * rail and no pinned header of this shape and the driver app's frame is its
29
+ * own bottom nav plus a screen, see `bottom-nav.ts`. */
30
30
  export interface AppShellContract {
31
31
  /** Remove the content cap for a page that genuinely wants the full width. */
32
32
  wide?: Forwarded<boolean>;
33
33
  /** Names the scrolling region for a screen reader, so a page with a rail and
34
34
  * a header has a landmark that says which one is the work. REQUIRED, NO
35
- * DEFAULT — this package owns no copy, and "Main content" shipped as a
35
+ * DEFAULT, this package owns no copy and "Main content" shipped as a
36
36
  * fallback English string nobody ever overrode. Generic is not an
37
- * exemption: the rule is about translation, and a generic English word is
37
+ * exemption: the rule is about translation and a generic English word is
38
38
  * still untranslated. */
39
39
  contentLabel: string;
40
40
  /** The words of a skip link, the first stop in the shell, that takes focus to
41
41
  * the content past the banner and the rail. Optional and with no default, for
42
42
  * the same reason `contentLabel` has none: the package owns no copy. A page
43
- * that gives it one gets the link; a page that does not has none, and one
43
+ * that gives it one gets the link; a page that does not has none and one
44
44
  * that already has its own is not given a second. */
45
45
  skipLabel?: Forwarded<string>;
46
46
  }
@@ -1,6 +1,6 @@
1
1
  export const APP_SHELL_REGIONS = ['banner', 'nav', 'header', 'footer'];
2
2
  export const APP_SHELL_CONTENT_MAX_WIDTH_PX = 1280;
3
- export const APP_SHELL_GUTTER_PX = 24;
3
+ export const APP_SHELL_GUTTER_PX = 28;
4
4
  export const APP_SHELL_RAIL_MIN_WIDTH_PX = 768;
5
5
  export const APP_SHELL_SURFACE = 'background';
6
6
  export const APP_SHELL_EDGE = 'border-subtle';
@@ -1,16 +1,32 @@
1
1
  import { type ComponentProps, type ReactNode } from 'react';
2
2
  import { type AppShellContract } from '../app-shell';
3
3
  import type { Density } from '../../scale';
4
+ /** THE SPOTLIGHT: the one thing a first-run page asks for, said over the page.
5
+ * The content beside the nav washes back towards the page colour under the
6
+ * brand's bloom, and the message stands at the foot, clear of a docked setup
7
+ * guide; on a narrow screen it is a card near the top, where it can be read. */
8
+ export interface AppShellSpotlight {
9
+ title: string;
10
+ body: string;
11
+ /** The one action, the main button. */
12
+ action: ReactNode;
13
+ }
4
14
  export type DSAppShellProps = Omit<ComponentProps<'div'>, 'children'> & AppShellContract & {
5
15
  /** Full width, above everything. An announcement about the session. */
6
16
  banner?: ReactNode;
7
- /** The rail. Dropped below the threshold — see the contract. */
17
+ /** The rail. Dropped below the threshold, see the contract. */
8
18
  nav?: ReactNode;
9
19
  /**
10
- * What stands in for the rail once the rail is gone — a menu button, and
20
+ * The phone's tab bar, a `DSBottomNav`: shown at the foot exactly where the
21
+ * rail is dropped, the same threshold spelled the same way. With it, no
22
+ * `navTrigger` is drawn; a phone has its places in view, not behind a button.
23
+ */
24
+ bottomNav?: ReactNode;
25
+ /**
26
+ * What stands in for the rail once the rail is gone, a menu button and
11
27
  * usually the account name beside it.
12
28
  *
13
- * IT APPEARS EXACTLY WHEN THE RAIL DISAPPEARS, and that is the whole reason
29
+ * IT APPEARS EXACTLY WHEN THE RAIL DISAPPEARS and that is the whole reason
14
30
  * it is a slot here rather than something a caller renders themselves. The
15
31
  * threshold is a CONTAINER query against this shell, so only this component
16
32
  * knows when the rail is hidden; a caller reproducing it had to re-derive an
@@ -18,8 +34,8 @@ export type DSAppShellProps = Omit<ComponentProps<'div'>, 'children'> & AppShell
18
34
  * one breakpoint is how a page ends up with neither a rail nor a way to open
19
35
  * one, at exactly one width, on one screen.
20
36
  *
21
- * The DRAWER is still the caller's. What opens it, what it holds, and
22
- * whether it closes on navigation are screen decisions, and a shell that
37
+ * The DRAWER is still the caller's. What opens it, what it holds and
38
+ * whether it closes on navigation are screen decisions and a shell that
23
39
  * owned them would have to take the nav's whole state as well.
24
40
  */
25
41
  navTrigger?: ReactNode;
@@ -35,7 +51,9 @@ export type DSAppShellProps = Omit<ComponentProps<'div'>, 'children'> & AppShell
35
51
  * comfortable sizes whatever this says.
36
52
  */
37
53
  density?: Density;
54
+ /** The first-run spotlight over the content beside the nav. See `AppShellSpotlight`. */
55
+ spotlight?: AppShellSpotlight | undefined;
38
56
  };
39
57
  /** The frame every signed-in page shares: a banner, a rail, a pinned header, a
40
58
  * scrolling middle and a footer strip. */
41
- export declare function DSAppShell({ banner, nav, navTrigger, header, footer, children, wide, contentLabel, skipLabel, density, className, ...props }: DSAppShellProps): import("react/jsx-runtime").JSX.Element;
59
+ export declare function DSAppShell({ banner, nav, navTrigger, header, footer, children, wide, bottomNav, spotlight, contentLabel, skipLabel, density, className, ...props }: DSAppShellProps): import("react/jsx-runtime").JSX.Element;
@@ -1,10 +1,11 @@
1
1
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { useId, useRef } from 'react';
3
- import { APP_SHELL_CONTENT_MAX_WIDTH_PX, APP_SHELL_GUTTER_PX, appShellSpec, } from '../app-shell';
3
+ import { APP_SHELL_CONTENT_MAX_WIDTH_PX, appShellSpec, } from '../app-shell';
4
4
  import { cn } from '../../lib/cn';
5
+ import { DSText } from '../../text/web/ds-text';
5
6
  const SURFACE = { background: 'bg-background' };
6
7
  const EDGE = { 'border-subtle': 'border-border-subtle' };
7
- export function DSAppShell({ banner, nav, navTrigger, header, footer, children, wide = false, contentLabel, skipLabel, density = 'comfortable', className, ...props }) {
8
+ export function DSAppShell({ banner, nav, navTrigger, header, footer, children, wide = false, bottomNav, spotlight, contentLabel, skipLabel, density = 'comfortable', className, ...props }) {
8
9
  const spec = appShellSpec();
9
10
  const mainRef = useRef(null);
10
11
  const mainId = useId();
@@ -20,5 +21,5 @@ export function DSAppShell({ banner, nav, navTrigger, header, footer, children,
20
21
  event.preventDefault();
21
22
  mainRef.current?.focus();
22
23
  }
23
- return (_jsxs("div", { "data-density": density === 'compact' ? 'compact' : undefined, className: cn('@container/shell relative flex h-dvh flex-col overflow-hidden', SURFACE[spec.surface], className), ...props, children: [skipLabel !== undefined && (_jsx("a", { href: `#${mainId}`, onClick: skip, className: "focusable sr-only focus:not-sr-only focus:absolute focus:start-2 focus:top-2 focus:z-(--layer-takeover) focus:rounded-chip focus:bg-card focus:px-4 focus:py-2 focus:text-body-sm focus:text-card-foreground", children: skipLabel })), banner !== undefined && _jsx("div", { className: "shrink-0", children: banner }), _jsxs("div", { className: "flex min-h-0 flex-1", children: [nav !== undefined && (_jsx("div", { className: "hidden @3xl/shell:flex", children: nav })), _jsxs("div", { className: "flex min-w-0 flex-1 flex-col", children: [navTrigger !== undefined && (_jsx("div", { className: cn('shrink-0 border-b @3xl/shell:hidden', EDGE[spec.edge]), children: navTrigger })), header !== undefined && (_jsx("div", { className: cn('shrink-0 border-b', EDGE[spec.edge]), children: header })), _jsx("main", { ref: mainRef, id: mainId, "aria-label": contentLabel, tabIndex: 0, className: "focusable relative min-h-0 flex-1 overflow-y-auto focus-visible:-outline-offset-2", style: { padding: APP_SHELL_GUTTER_PX }, children: _jsx("div", { className: "mx-auto w-full", style: wide ? undefined : { maxWidth: APP_SHELL_CONTENT_MAX_WIDTH_PX }, children: children }) })] })] }), footer !== undefined && (_jsx("div", { className: cn('shrink-0 border-t', EDGE[spec.edge]), children: footer }))] }));
24
+ return (_jsxs("div", { "data-density": density === 'compact' ? 'compact' : undefined, className: cn('@container/shell relative flex h-dvh flex-col overflow-hidden', SURFACE[spec.surface], 'shell-wash shell-type', className), ...props, children: [skipLabel !== undefined && (_jsx("a", { href: `#${mainId}`, onClick: skip, className: "focusable sr-only focus:not-sr-only focus:absolute focus:start-2 focus:top-2 focus:z-(--layer-takeover) focus:rounded-chip focus:bg-card focus:px-4 focus:py-2 focus:text-body-sm focus:text-card-foreground", children: skipLabel })), banner !== undefined && _jsx("div", { className: "shrink-0", children: banner }), _jsxs("div", { className: "flex min-h-0 flex-1", children: [nav !== undefined && (_jsx("div", { className: "hidden @3xl/shell:flex", children: nav })), _jsxs("div", { className: "relative flex min-w-0 flex-1 flex-col", children: [spotlight !== undefined && (_jsxs("div", { className: "absolute inset-0 z-(--layer-raised)", children: [_jsx("div", { "aria-hidden": true, className: "spotlight-wash absolute inset-0" }), _jsx("div", { "aria-hidden": true, className: "spotlight-bloom pointer-events-none absolute inset-0" }), _jsxs("div", { className: "absolute start-6 end-6 top-40 flex max-w-96 flex-col items-start rounded-card border border-transparent bg-card p-5 shadow-medium md:start-auto md:end-90 md:top-auto md:bottom-38 md:rounded-none md:border-0 md:bg-transparent md:p-0 md:shadow-none", children: [_jsx(DSText, { as: "h2", variant: "heading-lg", className: "spotlight-title", children: spotlight.title }), _jsx(DSText, { as: "p", tone: "muted", className: "spotlight-body mt-4", children: spotlight.body }), _jsx("div", { className: "mt-5", children: spotlight.action })] })] })), navTrigger !== undefined && bottomNav === undefined && (_jsx("div", { className: cn('shrink-0 border-b @3xl/shell:hidden', EDGE[spec.edge], 'shell-band-subtle'), children: navTrigger })), header !== undefined && (_jsx("div", { className: cn('shrink-0 border-b', EDGE[spec.edge], 'shell-band-subtle'), children: header })), _jsx("main", { ref: mainRef, id: mainId, "aria-label": contentLabel, tabIndex: 0, className: "shell-gutter shell-sections focusable relative min-h-0 flex-1 overflow-y-auto focus-visible:-outline-offset-2", children: _jsx("div", { className: "w-full", style: wide ? undefined : { maxWidth: APP_SHELL_CONTENT_MAX_WIDTH_PX }, children: children }) })] })] }), bottomNav !== undefined && _jsx("div", { className: "shrink-0 @3xl/shell:hidden", children: bottomNav }), footer !== undefined && (_jsx("div", { className: cn('shrink-0 border-t', EDGE[spec.edge]), children: footer }))] }));
24
25
  }
@@ -8,7 +8,7 @@ export declare const APPROVAL_CHAIN_VERDICTS: readonly ["approved", "rejected"];
8
8
  export type ApprovalChainVerdict = (typeof APPROVAL_CHAIN_VERDICTS)[number];
9
9
  /** One person who may decide a step. */
10
10
  export interface ApprovalChainApprover {
11
- /** Stable identity — compared with the viewer to decide whether they may act. */
11
+ /** Stable identity, compared with the viewer to decide whether they may act. */
12
12
  id: string;
13
13
  /** The name shown beside the avatar. */
14
14
  name: string;
@@ -26,7 +26,7 @@ export interface ApprovalChainDecision {
26
26
  approverId: string;
27
27
  /** Which way they decided. */
28
28
  verdict: ApprovalChainVerdict;
29
- /** When, as the caller formats it — "Today 14:32". */
29
+ /** When, as the caller formats it, "Today 14:32". */
30
30
  at: string;
31
31
  /** The same moment as an ISO string, for a machine-readable `<time>`. */
32
32
  dateTime?: string;
@@ -37,7 +37,7 @@ export interface ApprovalChainDecision {
37
37
  export interface ApprovalChainStep {
38
38
  /** Stable identity for the step. */
39
39
  key: string;
40
- /** What the step IS — "Depot lead", "Finance". */
40
+ /** What the step IS, "Depot lead", "Finance". */
41
41
  role: string;
42
42
  /** Who may decide it. One person is an ordinary step; several make it parallel. */
43
43
  approvers: readonly ApprovalChainApprover[];
@@ -55,20 +55,20 @@ export interface ApprovalChainStep {
55
55
  /** How many approvals a step needs, held to what its approvers can give.
56
56
  *
57
57
  * Clamped rather than trusted: a `required` of 3 on a step with two people can
58
- * never be met, and a request stuck forever on a typo is worse than a step
59
- * that asks everybody present. Below 1 is read as 1 — a step nobody needs to
60
- * approve is a skipped step, and that is said with `skippedReason`. */
58
+ * never be met and a request stuck forever on a typo is worse than a step
59
+ * that asks everybody present. Below 1 is read as 1, a step nobody needs to
60
+ * approve is a skipped step and that is said with `skippedReason`. */
61
61
  export declare function approvalChainRequired(step: ApprovalChainStep): number;
62
62
  /** The decisions that count: one per approver on the step, the latest winning.
63
63
  *
64
- * A decision from somebody not on the step is ignored rather than counted — a
64
+ * A decision from somebody not on the step is ignored rather than counted, a
65
65
  * stale record from before the approvers changed must not tip a quorum. */
66
66
  export declare function approvalChainTally(step: ApprovalChainStep): {
67
67
  approved: number;
68
68
  rejected: number;
69
69
  undecided: number;
70
70
  };
71
- /** What a step resolved to, and — for a step the chain never reached — why. */
71
+ /** What a step resolved to and, for a step the chain never reached, why. */
72
72
  export interface ApprovalChainResolvedStep {
73
73
  state: ApprovalChainState;
74
74
  /** A reason the adapter shows under the step: the waiver, or "not reached". */
@@ -77,7 +77,7 @@ export interface ApprovalChainResolvedStep {
77
77
  /** The note on a step nobody will reach because an earlier one was rejected. */
78
78
  export declare const APPROVAL_CHAIN_NOT_REACHED = "Not reached. The request was rejected earlier.";
79
79
  /** Every step's state, in order. Exactly one step is `current` or `escalated`
80
- * while the request is pending, and none once it has closed. */
80
+ * while the request is pending and none once it has closed. */
81
81
  export declare function approvalChainStates(steps: readonly ApprovalChainStep[]): ApprovalChainResolvedStep[];
82
82
  /** Where the whole request stands. See the header on why an empty chain is
83
83
  * pending rather than approved. */
@@ -88,7 +88,7 @@ export declare function approvalChainTurn(steps: readonly ApprovalChainStep[]):
88
88
  index: number;
89
89
  approvers: ApprovalChainApprover[];
90
90
  } | undefined;
91
- /** Whether this viewer may approve or reject right now, and on which step. */
91
+ /** Whether this viewer may approve or reject right now and on which step. */
92
92
  export declare function approvalChainViewerStep(steps: readonly ApprovalChainStep[], viewerId: string | undefined): number | undefined;
93
93
  /** "Any 1 of 3", "All 3", or `undefined` for a step with one approver. */
94
94
  export declare function approvalChainQuorumLabel(step: ApprovalChainStep): string | undefined;
@@ -157,7 +157,7 @@ export declare function approvalChainMarkerSpec(state: ApprovalChainState): Appr
157
157
  export interface ApprovalChainDecisionEvent {
158
158
  stepKey: string;
159
159
  verdict: ApprovalChainVerdict;
160
- /** Present, and not blank, on every rejection. Optional on an approval. */
160
+ /** Present and not blank, on every rejection. Optional on an approval. */
161
161
  comment?: string;
162
162
  }
163
163
  /** The props every Approval Chain implementation accepts. */
@@ -167,7 +167,7 @@ export interface ApprovalChainContract {
167
167
  /** Who is looking. When it is somebody whose turn it is, their step offers
168
168
  * Approve and Reject. */
169
169
  viewerId?: string;
170
- /** Names the chain for a screen reader — "Approval path for request FR-2291". */
170
+ /** Names the chain for a screen reader, "Approval path for request FR-2291". */
171
171
  label: string;
172
172
  /** Holds the decision controls while the caller's request is in flight. */
173
173
  pending?: boolean;
@@ -5,5 +5,5 @@ export type DSApprovalChainProps = Omit<ViewProps, 'children'> & ApprovalChainCo
5
5
  * carries a reason that is not blank. */
6
6
  onDecide?: (decision: ApprovalChainDecisionEvent) => void;
7
7
  };
8
- /** The approval path of a request: each approver's step, its state as a glyph and a word, and the viewer's own decision when it is their turn. */
8
+ /** The approval path of a request: each approver's step, its state as a glyph and a word and the viewer's own decision when it is their turn. */
9
9
  export declare function DSApprovalChain({ steps, viewerId, label, pending, onDecide, className, ...props }: DSApprovalChainProps): import("react/jsx-runtime").JSX.Element;