@tfn-design/design-system 0.3.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (751) hide show
  1. package/README.md +2 -2
  2. package/dist/accordion/accordion.d.ts +1 -1
  3. package/dist/accordion/accordion.js +1 -1
  4. package/dist/accordion/web/ds-accordion.js +5 -4
  5. package/dist/account-password-field/account-password-field.js +1 -1
  6. package/dist/account-switcher/account-switcher.d.ts +11 -4
  7. package/dist/account-switcher/account-switcher.js +2 -1
  8. package/dist/account-switcher/web/ds-account-switcher.js +12 -4
  9. package/dist/ai-attachment/ai-attachment.d.ts +1 -1
  10. package/dist/ai-attachment/ai-attachment.js +1 -1
  11. package/dist/ai-attachment/web/ds-ai-attachment.js +1 -1
  12. package/dist/ai-branch-switcher/web/ds-ai-branch-switcher.js +2 -2
  13. package/dist/ai-composer/ai-composer.d.ts +1 -1
  14. package/dist/ai-composer/ai-composer.js +1 -1
  15. package/dist/ai-composer/native/ds-ai-composer.js +4 -2
  16. package/dist/ai-composer/web/ds-ai-composer.js +2 -3
  17. package/dist/ai-confirmation/ai-confirmation.d.ts +19 -3
  18. package/dist/ai-confirmation/ai-confirmation.js +18 -3
  19. package/dist/ai-confirmation/native/ds-ai-confirmation.js +18 -13
  20. package/dist/ai-confirmation/web/ds-ai-confirmation.d.ts +1 -1
  21. package/dist/ai-confirmation/web/ds-ai-confirmation.js +22 -11
  22. package/dist/ai-context-scope/ai-context-scope.d.ts +10 -2
  23. package/dist/ai-context-scope/ai-context-scope.js +11 -2
  24. package/dist/ai-context-scope/native/ds-ai-context-scope.js +4 -3
  25. package/dist/ai-context-scope/web/ds-ai-context-scope.js +19 -5
  26. package/dist/ai-conversation-list/ai-conversation-list.d.ts +16 -0
  27. package/dist/ai-conversation-list/ai-conversation-list.js +8 -0
  28. package/dist/ai-conversation-list/web/ds-ai-conversation-list.d.ts +10 -6
  29. package/dist/ai-conversation-list/web/ds-ai-conversation-list.js +89 -47
  30. package/dist/ai-diff/ai-diff.d.ts +13 -1
  31. package/dist/ai-diff/ai-diff.js +12 -1
  32. package/dist/ai-diff/native/ds-ai-diff.d.ts +1 -1
  33. package/dist/ai-diff/native/ds-ai-diff.js +4 -6
  34. package/dist/ai-diff/web/ds-ai-diff.d.ts +0 -4
  35. package/dist/ai-diff/web/ds-ai-diff.js +16 -9
  36. package/dist/ai-draft-panel/ai-draft-panel.d.ts +2 -0
  37. package/dist/ai-draft-panel/ai-draft-panel.js +5 -0
  38. package/dist/ai-draft-panel/web/ds-ai-draft-panel.d.ts +3 -1
  39. package/dist/ai-draft-panel/web/ds-ai-draft-panel.js +4 -4
  40. package/dist/ai-empty-state/native/ds-ai-empty-state.js +2 -2
  41. package/dist/ai-empty-state/web/ds-ai-empty-state.js +3 -1
  42. package/dist/ai-error-state/ai-error-state.d.ts +2 -2
  43. package/dist/ai-error-state/ai-error-state.js +2 -2
  44. package/dist/ai-error-state/native/ds-ai-error-state.d.ts +5 -1
  45. package/dist/ai-error-state/native/ds-ai-error-state.js +2 -1
  46. package/dist/ai-error-state/web/ds-ai-error-state.d.ts +5 -1
  47. package/dist/ai-error-state/web/ds-ai-error-state.js +3 -2
  48. package/dist/ai-label/native/ds-ai-label.js +2 -1
  49. package/dist/ai-label/web/ds-ai-label.js +1 -1
  50. package/dist/ai-message/ai-message.d.ts +1 -1
  51. package/dist/ai-message/ai-message.js +1 -1
  52. package/dist/ai-message/native/ds-ai-message.js +4 -3
  53. package/dist/ai-message/web/ds-ai-message-markdown.js +3 -3
  54. package/dist/ai-message/web/ds-ai-message.js +4 -3
  55. package/dist/ai-message-actions/ai-message-actions.d.ts +1 -1
  56. package/dist/ai-message-actions/ai-message-actions.js +1 -1
  57. package/dist/ai-message-actions/native/ds-ai-message-actions.js +1 -1
  58. package/dist/ai-message-actions/web/ds-ai-message-actions.js +1 -1
  59. package/dist/ai-plan/ai-plan.d.ts +1 -1
  60. package/dist/ai-plan/ai-plan.js +1 -1
  61. package/dist/ai-plan/web/ds-ai-plan.js +2 -2
  62. package/dist/ai-side-nav/web/ds-ai-side-nav.js +4 -3
  63. package/dist/ai-summary-card/native/ds-ai-summary-card.js +2 -1
  64. package/dist/ai-summary-card/web/ds-ai-summary-card.js +2 -1
  65. package/dist/ai-thread/web/ds-ai-thread.js +1 -1
  66. package/dist/ai-tool-call/ai-tool-call.d.ts +1 -1
  67. package/dist/ai-tool-call/ai-tool-call.js +1 -1
  68. package/dist/ai-tool-call/native/ds-ai-tool-call.js +3 -2
  69. package/dist/ai-tool-call/web/ds-ai-tool-call.js +4 -3
  70. package/dist/alert/native/ds-alert.js +4 -4
  71. package/dist/alert/web/ds-alert.js +5 -5
  72. package/dist/ambient-gradient/ambient-gradient.d.ts +1 -1
  73. package/dist/amount/amount.d.ts +1 -1
  74. package/dist/amount/amount.js +3 -2
  75. package/dist/amount/native/ds-amount.js +1 -1
  76. package/dist/amount/web/ds-amount.js +1 -1
  77. package/dist/amount-cell/amount-cell.d.ts +5 -2
  78. package/dist/amount-cell/web/ds-amount-cell.d.ts +1 -1
  79. package/dist/amount-cell/web/ds-amount-cell.js +7 -1
  80. package/dist/amount-entry/amount-entry.d.ts +28 -2
  81. package/dist/amount-entry/amount-entry.js +19 -12
  82. package/dist/amount-entry/native/ds-amount-entry.d.ts +1 -1
  83. package/dist/amount-entry/native/ds-amount-entry.js +5 -4
  84. package/dist/amount-entry/web/ds-amount-entry.d.ts +1 -1
  85. package/dist/amount-entry/web/ds-amount-entry.js +5 -4
  86. package/dist/app-shell/app-shell.d.ts +2 -0
  87. package/dist/app-shell/web/ds-app-shell.js +26 -3
  88. package/dist/approval-chain/approval-chain.d.ts +6 -2
  89. package/dist/approval-chain/approval-chain.js +4 -4
  90. package/dist/approval-chain/native/ds-approval-chain.js +16 -9
  91. package/dist/approval-chain/web/ds-approval-chain.d.ts +7 -1
  92. package/dist/approval-chain/web/ds-approval-chain.js +12 -11
  93. package/dist/auth-shell/web/ds-auth-shell.d.ts +5 -1
  94. package/dist/auth-shell/web/ds-auth-shell.js +5 -2
  95. package/dist/balance-header/balance-header.d.ts +8 -4
  96. package/dist/balance-header/native/ds-balance-header.d.ts +3 -3
  97. package/dist/balance-header/native/ds-balance-header.js +11 -4
  98. package/dist/balance-header/web/ds-balance-header.d.ts +1 -1
  99. package/dist/balance-header/web/ds-balance-header.js +7 -4
  100. package/dist/bar-chart/bar-chart.d.ts +46 -5
  101. package/dist/bar-chart/bar-chart.js +64 -6
  102. package/dist/bar-chart/web/ds-bar-chart.d.ts +21 -4
  103. package/dist/bar-chart/web/ds-bar-chart.js +121 -50
  104. package/dist/bottom-nav/bottom-nav.d.ts +8 -3
  105. package/dist/bottom-nav/bottom-nav.js +2 -2
  106. package/dist/bottom-nav/web/ds-bottom-nav.js +2 -2
  107. package/dist/box-plot/box-plot.d.ts +150 -0
  108. package/dist/box-plot/box-plot.js +124 -0
  109. package/dist/box-plot/web/ds-box-plot.d.ts +8 -0
  110. package/dist/box-plot/web/ds-box-plot.js +57 -0
  111. package/dist/brand-lockup/native/ds-brand-lockup.js +1 -1
  112. package/dist/brand-provider/brand-provider.d.ts +29 -0
  113. package/dist/brand-provider/brand-provider.js +9 -0
  114. package/dist/brand-provider/native/ds-brand-provider.d.ts +11 -0
  115. package/dist/brand-provider/native/ds-brand-provider.js +18 -0
  116. package/dist/brand-provider/web/ds-brand-provider.d.ts +10 -0
  117. package/dist/brand-provider/web/ds-brand-provider.js +20 -0
  118. package/dist/bullet-chart/bullet-chart.d.ts +12 -7
  119. package/dist/bullet-chart/bullet-chart.js +5 -4
  120. package/dist/bullet-chart/web/ds-bullet-chart.d.ts +1 -1
  121. package/dist/bullet-chart/web/ds-bullet-chart.js +9 -4
  122. package/dist/button/button.d.ts +1 -1
  123. package/dist/button/native/ds-button.js +2 -2
  124. package/dist/button/web/ds-button.js +1 -1
  125. package/dist/button-group/button-group.d.ts +1 -1
  126. package/dist/button-group/web/ds-button-group.d.ts +2 -2
  127. package/dist/calendar/calendar.d.ts +13 -2
  128. package/dist/calendar/calendar.js +4 -3
  129. package/dist/calendar/web/ds-calendar.d.ts +1 -1
  130. package/dist/calendar/web/ds-calendar.js +6 -5
  131. package/dist/card-carousel/native/ds-card-carousel.js +1 -1
  132. package/dist/card-carousel/web/ds-card-carousel.js +2 -2
  133. package/dist/chart/chart.d.ts +180 -64
  134. package/dist/chart/chart.js +367 -118
  135. package/dist/chart/web/ds-chart.d.ts +17 -7
  136. package/dist/chart/web/ds-chart.js +85 -108
  137. package/dist/check-option/check-option.d.ts +1 -1
  138. package/dist/check-option/check-option.js +1 -1
  139. package/dist/check-option/web/ds-check-option.d.ts +6 -1
  140. package/dist/check-option/web/ds-check-option.js +10 -6
  141. package/dist/checkbox/checkbox.d.ts +2 -2
  142. package/dist/checkbox/checkbox.js +2 -2
  143. package/dist/checkbox/native/ds-checkbox.js +1 -1
  144. package/dist/checkbox/web/checkbox-mark.js +1 -1
  145. package/dist/checkbox/web/ds-checkbox.d.ts +2 -2
  146. package/dist/checkbox/web/ds-checkbox.js +17 -6
  147. package/dist/chip/chip.d.ts +11 -11
  148. package/dist/chip/chip.js +5 -3
  149. package/dist/chip/native/ds-chip.js +1 -1
  150. package/dist/chip/web/ds-chip.js +6 -6
  151. package/dist/code-block/web/ds-code-block.js +3 -3
  152. package/dist/column-picker/web/ds-column-picker.js +2 -1
  153. package/dist/combobox/combobox.d.ts +2 -2
  154. package/dist/combobox/web/ds-combobox.js +4 -2
  155. package/dist/command-palette/command-palette.d.ts +4 -0
  156. package/dist/comment-thread/comment-thread.d.ts +2 -2
  157. package/dist/comment-thread/comment-thread.js +2 -2
  158. package/dist/comment-thread/native/ds-comment-thread.js +10 -9
  159. package/dist/comment-thread/web/ds-comment-thread.js +11 -10
  160. package/dist/condition-builder/condition-builder.d.ts +96 -4
  161. package/dist/condition-builder/condition-builder.js +68 -28
  162. package/dist/condition-builder/web/ds-condition-builder.d.ts +4 -2
  163. package/dist/condition-builder/web/ds-condition-builder.js +97 -57
  164. package/dist/context-switcher/context-switcher.d.ts +10 -1
  165. package/dist/context-switcher/context-switcher.js +5 -2
  166. package/dist/context-switcher/web/ds-context-switcher.d.ts +1 -1
  167. package/dist/context-switcher/web/ds-context-switcher.js +4 -3
  168. package/dist/coordinate-field/coordinate-field.d.ts +46 -5
  169. package/dist/coordinate-field/coordinate-field.js +35 -18
  170. package/dist/coordinate-field/native/ds-coordinate-field.d.ts +1 -1
  171. package/dist/coordinate-field/native/ds-coordinate-field.js +9 -8
  172. package/dist/coordinate-field/web/ds-coordinate-field.d.ts +1 -1
  173. package/dist/coordinate-field/web/ds-coordinate-field.js +10 -9
  174. package/dist/copy-field/copy-field.d.ts +23 -9
  175. package/dist/copy-field/copy-field.js +11 -6
  176. package/dist/copy-field/web/ds-copy-field.d.ts +1 -1
  177. package/dist/copy-field/web/ds-copy-field.js +6 -5
  178. package/dist/copy.d.ts +8 -0
  179. package/dist/copy.js +7 -0
  180. package/dist/count-badge/web/ds-count-badge.js +1 -1
  181. package/dist/countdown/native/ds-countdown.js +1 -1
  182. package/dist/countdown/web/ds-countdown.js +1 -1
  183. package/dist/dashboard-shell/dashboard-shell.d.ts +4 -2
  184. package/dist/data-table/web/data-table-theme.css +340 -52
  185. package/dist/data-table/web/ds-data-table.d.ts +43 -1
  186. package/dist/data-table/web/ds-data-table.js +165 -17
  187. package/dist/date-field/web/ds-date-field.d.ts +1 -1
  188. package/dist/date-field/web/ds-date-field.js +6 -5
  189. package/dist/date-input/date-input.d.ts +26 -5
  190. package/dist/date-input/date-input.js +34 -2
  191. package/dist/date-input/web/ds-date-input.js +13 -4
  192. package/dist/date-picker/date-picker.d.ts +38 -67
  193. package/dist/date-picker/date-picker.js +26 -60
  194. package/dist/date-picker/web/ds-date-picker.d.ts +13 -6
  195. package/dist/date-picker/web/ds-date-picker.js +41 -10
  196. package/dist/date-range-picker/web/ds-date-range-picker.d.ts +10 -4
  197. package/dist/date-range-picker/web/ds-date-range-picker.js +8 -5
  198. package/dist/day-picker/day-picker.d.ts +1 -1
  199. package/dist/day-picker/web/ds-day-picker.js +1 -1
  200. package/dist/delta/delta.d.ts +15 -1
  201. package/dist/delta/delta.js +20 -0
  202. package/dist/delta/native/ds-delta.d.ts +5 -2
  203. package/dist/delta/native/ds-delta.js +4 -3
  204. package/dist/delta/web/ds-delta.d.ts +5 -2
  205. package/dist/delta/web/ds-delta.js +4 -3
  206. package/dist/description-list/description-list.d.ts +4 -2
  207. package/dist/description-list/native/ds-description-list.d.ts +2 -2
  208. package/dist/description-list/native/ds-description-list.js +49 -27
  209. package/dist/description-list/web/ds-description-list.d.ts +2 -2
  210. package/dist/description-list/web/ds-description-list.js +40 -17
  211. package/dist/dialog/dialog.d.ts +12 -1
  212. package/dist/dialog/web/ds-dialog.d.ts +1 -1
  213. package/dist/dialog/web/ds-dialog.js +5 -3
  214. package/dist/diverging-bar-chart/diverging-bar-chart.d.ts +2 -1
  215. package/dist/diverging-bar-chart/diverging-bar-chart.js +2 -1
  216. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.d.ts +1 -1
  217. package/dist/diverging-bar-chart/web/ds-diverging-bar-chart.js +28 -5
  218. package/dist/donut-chart/donut-chart.d.ts +7 -1
  219. package/dist/donut-chart/donut-chart.js +4 -0
  220. package/dist/donut-chart/web/ds-donut-chart.d.ts +4 -1
  221. package/dist/donut-chart/web/ds-donut-chart.js +43 -24
  222. package/dist/drawer/drawer.d.ts +42 -5
  223. package/dist/drawer/drawer.js +10 -4
  224. package/dist/drawer/native/ds-drawer.d.ts +1 -1
  225. package/dist/drawer/native/ds-drawer.js +17 -7
  226. package/dist/drawer/web/ds-drawer.d.ts +1 -1
  227. package/dist/drawer/web/ds-drawer.js +32 -17
  228. package/dist/dropdown-menu/dropdown-menu.d.ts +10 -5
  229. package/dist/dropdown-menu/dropdown-menu.js +13 -4
  230. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.d.ts +4 -2
  231. package/dist/dropdown-menu/web/ds-dropdown-menu-surface.js +6 -6
  232. package/dist/dropdown-menu/web/ds-dropdown-menu.d.ts +5 -2
  233. package/dist/dropdown-menu/web/ds-dropdown-menu.js +2 -2
  234. package/dist/dumbbell-chart/dumbbell-chart.d.ts +10 -9
  235. package/dist/dumbbell-chart/dumbbell-chart.js +18 -4
  236. package/dist/dumbbell-chart/web/ds-dumbbell-chart.d.ts +4 -1
  237. package/dist/dumbbell-chart/web/ds-dumbbell-chart.js +13 -3
  238. package/dist/editable-row/editable-row.d.ts +5 -1
  239. package/dist/editable-row/editable-row.js +7 -1
  240. package/dist/editable-row/web/ds-editable-row.js +7 -5
  241. package/dist/empty-state/empty-state.d.ts +39 -0
  242. package/dist/empty-state/empty-state.js +21 -0
  243. package/dist/empty-state/web/ds-empty-state.d.ts +19 -8
  244. package/dist/empty-state/web/ds-empty-state.js +15 -3
  245. package/dist/environment-banner/environment-banner.d.ts +1 -1
  246. package/dist/environment-banner/environment-banner.js +1 -1
  247. package/dist/environment-banner/web/ds-environment-banner.js +3 -3
  248. package/dist/evaluation-trace/evaluation-trace.d.ts +1 -1
  249. package/dist/evaluation-trace/evaluation-trace.js +1 -1
  250. package/dist/evaluation-trace/web/ds-evaluation-trace.js +1 -1
  251. package/dist/event-row/web/ds-event-row.d.ts +1 -1
  252. package/dist/event-row/web/ds-event-row.js +2 -1
  253. package/dist/facet-button/facet-button.d.ts +9 -1
  254. package/dist/facet-button/facet-button.js +2 -2
  255. package/dist/facet-button/web/ds-facet-button.d.ts +1 -1
  256. package/dist/facet-button/web/ds-facet-button.js +9 -5
  257. package/dist/facet-menu/facet-menu.d.ts +1 -1
  258. package/dist/facet-menu/facet-menu.js +2 -1
  259. package/dist/facet-menu/web/ds-facet-menu.js +1 -1
  260. package/dist/fact/native/ds-fact.d.ts +4 -1
  261. package/dist/file-dropzone/file-dropzone.d.ts +54 -5
  262. package/dist/file-dropzone/file-dropzone.js +38 -20
  263. package/dist/file-dropzone/web/ds-file-dropzone.d.ts +1 -1
  264. package/dist/file-dropzone/web/ds-file-dropzone.js +16 -15
  265. package/dist/file-field/file-field.d.ts +26 -5
  266. package/dist/file-field/file-field.js +18 -8
  267. package/dist/file-field/web/ds-file-field.d.ts +5 -2
  268. package/dist/file-field/web/ds-file-field.js +6 -5
  269. package/dist/file-import/file-import.d.ts +50 -4
  270. package/dist/file-import/file-import.js +30 -11
  271. package/dist/file-import/web/ds-file-import.d.ts +7 -3
  272. package/dist/file-import/web/ds-file-import.js +11 -10
  273. package/dist/file-upload/file-upload.d.ts +64 -15
  274. package/dist/file-upload/file-upload.js +44 -30
  275. package/dist/file-upload/web/ds-file-upload.d.ts +11 -2
  276. package/dist/file-upload/web/ds-file-upload.js +17 -12
  277. package/dist/filter-bar/web/ds-filter-bar.js +1 -1
  278. package/dist/filter-button/filter-button.d.ts +5 -4
  279. package/dist/filter-button/filter-button.js +1 -1
  280. package/dist/filter-chip/web/ds-filter-chip.js +2 -2
  281. package/dist/filter-popover/web/ds-filter-popover.js +2 -1
  282. package/dist/form-field-group/form-field-group.d.ts +7 -2
  283. package/dist/form-field-group/form-field-group.js +2 -0
  284. package/dist/form-field-group/web/ds-form-field-group.js +2 -1
  285. package/dist/form-section/form-section.d.ts +4 -2
  286. package/dist/form-section/form-section.js +1 -1
  287. package/dist/funnel/funnel.d.ts +2 -1
  288. package/dist/funnel/web/ds-funnel.d.ts +1 -1
  289. package/dist/funnel/web/ds-funnel.js +22 -12
  290. package/dist/gauge/gauge.d.ts +6 -1
  291. package/dist/gauge/gauge.js +9 -1
  292. package/dist/gauge/web/ds-gauge.d.ts +8 -3
  293. package/dist/gauge/web/ds-gauge.js +26 -15
  294. package/dist/geo/geo.d.ts +15 -0
  295. package/dist/geo/geo.js +112 -0
  296. package/dist/geofence-editor/geofence-editor.d.ts +14 -5
  297. package/dist/geofence-editor/geofence-editor.js +32 -7
  298. package/dist/geofence-editor/web/ds-geofence-editor.d.ts +18 -3
  299. package/dist/geofence-editor/web/ds-geofence-editor.js +28 -13
  300. package/dist/group-header/web/ds-group-header.d.ts +1 -1
  301. package/dist/heatmap/heatmap-calendar.d.ts +95 -0
  302. package/dist/heatmap/heatmap-calendar.js +130 -0
  303. package/dist/heatmap/heatmap.d.ts +35 -8
  304. package/dist/heatmap/heatmap.js +61 -7
  305. package/dist/heatmap/web/ds-heatmap-calendar.d.ts +22 -0
  306. package/dist/heatmap/web/ds-heatmap-calendar.js +33 -0
  307. package/dist/heatmap/web/ds-heatmap.d.ts +21 -1
  308. package/dist/heatmap/web/ds-heatmap.js +59 -31
  309. package/dist/helper-text/native/ds-helper-text.js +2 -2
  310. package/dist/helper-text/web/ds-helper-text.js +2 -2
  311. package/dist/histogram/histogram.d.ts +2 -3
  312. package/dist/histogram/web/ds-histogram.d.ts +1 -1
  313. package/dist/histogram/web/ds-histogram.js +8 -2
  314. package/dist/icon/icon.d.ts +11 -0
  315. package/dist/icon/icon.js +52 -0
  316. package/dist/icon/native/ds-icon-provider.d.ts +6 -1
  317. package/dist/icon/native/ds-icon-provider.js +4 -2
  318. package/dist/icon/native/icon-direction.d.ts +10 -0
  319. package/dist/icon/native/icon-direction.js +6 -0
  320. package/dist/icon/native/use-icon-size.d.ts +6 -0
  321. package/dist/icon/native/use-icon-size.js +12 -0
  322. package/dist/icon/web/ds-icon-provider.d.ts +3 -1
  323. package/dist/icon/web/ds-icon-provider.js +1 -0
  324. package/dist/icon/web/icon-direction.css +45 -0
  325. package/dist/icon-button/icon-button.d.ts +6 -0
  326. package/dist/icon-button/native/ds-icon-button.d.ts +1 -1
  327. package/dist/icon-button/native/ds-icon-button.js +2 -1
  328. package/dist/icon-button/web/ds-icon-button.d.ts +1 -1
  329. package/dist/icon-button/web/ds-icon-button.js +8 -5
  330. package/dist/icon-frame/icon-frame.d.ts +2 -2
  331. package/dist/icon-frame/native/ds-icon-frame.js +3 -3
  332. package/dist/icon-frame/web/ds-icon-frame.js +3 -3
  333. package/dist/ident/ident.d.ts +2 -0
  334. package/dist/ident/ident.js +5 -0
  335. package/dist/ident/native/ds-ident.d.ts +30 -0
  336. package/dist/ident/native/ds-ident.js +13 -0
  337. package/dist/index.d.ts +88 -65
  338. package/dist/index.js +47 -36
  339. package/dist/inline-edit/inline-edit.d.ts +34 -4
  340. package/dist/inline-edit/inline-edit.js +19 -7
  341. package/dist/inline-edit/web/ds-inline-edit.d.ts +1 -1
  342. package/dist/inline-edit/web/ds-inline-edit.js +13 -8
  343. package/dist/input/input.d.ts +18 -5
  344. package/dist/input/input.js +17 -13
  345. package/dist/input/native/ds-input.js +1 -1
  346. package/dist/input/web/ds-input.d.ts +7 -1
  347. package/dist/input/web/ds-input.js +11 -9
  348. package/dist/interaction.d.ts +7 -5
  349. package/dist/interaction.js +1 -1
  350. package/dist/json-viewer/web/ds-json-viewer.js +1 -1
  351. package/dist/key-value-editor/key-value-editor.d.ts +57 -3
  352. package/dist/key-value-editor/key-value-editor.js +56 -26
  353. package/dist/key-value-editor/web/ds-key-value-editor.d.ts +1 -1
  354. package/dist/key-value-editor/web/ds-key-value-editor.js +15 -16
  355. package/dist/keypad/keypad.d.ts +21 -11
  356. package/dist/keypad/keypad.js +16 -10
  357. package/dist/keypad/native/ds-keypad.d.ts +1 -1
  358. package/dist/keypad/native/ds-keypad.js +10 -8
  359. package/dist/keypad/web/ds-keypad.d.ts +1 -1
  360. package/dist/keypad/web/ds-keypad.js +5 -4
  361. package/dist/label-picker/label-picker.d.ts +34 -4
  362. package/dist/label-picker/label-picker.js +28 -17
  363. package/dist/label-picker/native/ds-label-picker.d.ts +1 -1
  364. package/dist/label-picker/native/ds-label-picker.js +11 -10
  365. package/dist/label-picker/web/ds-label-picker.d.ts +1 -1
  366. package/dist/label-picker/web/ds-label-picker.js +11 -10
  367. package/dist/labeled-field/labeled-field.d.ts +17 -2
  368. package/dist/labeled-field/labeled-field.js +7 -5
  369. package/dist/labeled-field/web/ds-labeled-field.d.ts +1 -1
  370. package/dist/labeled-field/web/ds-labeled-field.js +6 -2
  371. package/dist/leaderboard/leaderboard.d.ts +4 -3
  372. package/dist/leaderboard/leaderboard.js +4 -1
  373. package/dist/leaderboard/web/ds-leaderboard.d.ts +1 -1
  374. package/dist/leaderboard/web/ds-leaderboard.js +8 -3
  375. package/dist/legend/legend.d.ts +4 -0
  376. package/dist/legend/legend.js +1 -0
  377. package/dist/legend/web/ds-legend.js +18 -11
  378. package/dist/lib/chart-context.d.ts +23 -3
  379. package/dist/lib/chart-context.js +9 -3
  380. package/dist/lib/chart-finish.d.ts +13 -6
  381. package/dist/lib/chart-finish.js +8 -2
  382. package/dist/lib/chart-library.d.ts +1 -1
  383. package/dist/lib/chart-series.d.ts +7 -4
  384. package/dist/lib/chart-series.js +2 -4
  385. package/dist/lib/chart-ticks.d.ts +11 -0
  386. package/dist/lib/chart-ticks.js +11 -0
  387. package/dist/lib/chart-value.d.ts +1 -1
  388. package/dist/lib/chart-value.js +3 -1
  389. package/dist/lib/cn.d.ts +1 -0
  390. package/dist/lib/cn.js +7 -2
  391. package/dist/lib/native/animated.d.ts +4 -5
  392. package/dist/lib/native/animated.js +3 -4
  393. package/dist/lib/time-of-day.d.ts +21 -0
  394. package/dist/lib/time-of-day.js +37 -0
  395. package/dist/lib/web/chart-finish.d.ts +1 -1
  396. package/dist/lib/web/chart-finish.js +1 -1
  397. package/dist/lib/web/density.d.ts +1 -0
  398. package/dist/lib/web/density.js +7 -0
  399. package/dist/lib/web/focus-habits.js +20 -8
  400. package/dist/lib/web/focus-trap.d.ts +10 -0
  401. package/dist/lib/web/focus-trap.js +4 -1
  402. package/dist/lib/web/live-announcer.d.ts +2 -0
  403. package/dist/lib/web/live-announcer.js +2 -1
  404. package/dist/lib/web/touch-target.d.ts +4 -4
  405. package/dist/lib/web/touch-target.js +3 -3
  406. package/dist/lib/web/use-anchored-surface.js +3 -2
  407. package/dist/lib/web/use-overlay.js +7 -1
  408. package/dist/list-page/list-page.d.ts +2 -1
  409. package/dist/list-page/web/ds-list-page.js +1 -5
  410. package/dist/list-row/list-row.d.ts +6 -6
  411. package/dist/list-row/list-row.js +4 -5
  412. package/dist/list-row/native/ds-list-row.js +7 -2
  413. package/dist/list-row/web/ds-list-row-group.d.ts +6 -2
  414. package/dist/list-row/web/ds-list-row-group.js +4 -2
  415. package/dist/list-row/web/ds-list-row.js +9 -9
  416. package/dist/loading-screen/native/ds-loading-screen.js +1 -1
  417. package/dist/log-viewer/log-viewer.d.ts +2 -2
  418. package/dist/log-viewer/log-viewer.js +1 -1
  419. package/dist/log-viewer/web/ds-log-viewer.js +6 -5
  420. package/dist/map/map.d.ts +5 -0
  421. package/dist/map/map.js +2 -0
  422. package/dist/map/web/ds-map.js +9 -3
  423. package/dist/map-banner/native/ds-map-banner.js +3 -3
  424. package/dist/map-banner/web/ds-map-banner.js +4 -4
  425. package/dist/map-controls/map-controls.d.ts +3 -5
  426. package/dist/map-controls/map-controls.js +4 -4
  427. package/dist/map-controls/native/ds-map-controls.js +1 -1
  428. package/dist/map-controls/web/ds-map-controls.js +1 -1
  429. package/dist/map-draw-toolbar/web/ds-map-draw-toolbar.js +3 -2
  430. package/dist/map-heatmap-layer/map-heatmap-layer.d.ts +1 -1
  431. package/dist/map-layers/map-layers.d.ts +1 -1
  432. package/dist/map-layers/map-layers.js +1 -1
  433. package/dist/map-layers/native/ds-map-layers.d.ts +4 -2
  434. package/dist/map-layers/native/ds-map-layers.js +5 -4
  435. package/dist/map-layers/web/ds-map-layers.js +4 -4
  436. package/dist/map-list/map-list.d.ts +2 -1
  437. package/dist/map-list/web/ds-map-list.d.ts +1 -1
  438. package/dist/map-list/web/ds-map-list.js +19 -16
  439. package/dist/map-marker/map-marker.d.ts +5 -0
  440. package/dist/map-marker/map-marker.js +6 -0
  441. package/dist/map-marker/web/ds-map-marker.d.ts +12 -3
  442. package/dist/map-marker/web/ds-map-marker.js +18 -8
  443. package/dist/map-search/map-search.d.ts +9 -0
  444. package/dist/map-search/map-search.js +13 -0
  445. package/dist/map-search/native/ds-map-search.d.ts +10 -3
  446. package/dist/map-search/native/ds-map-search.js +32 -19
  447. package/dist/map-search/web/ds-map-search.d.ts +8 -3
  448. package/dist/map-search/web/ds-map-search.js +37 -27
  449. package/dist/map-search-area/native/ds-map-search-area.js +2 -1
  450. package/dist/map-search-area/web/ds-map-search-area.js +2 -1
  451. package/dist/map-sheet/native/ds-map-sheet.js +1 -1
  452. package/dist/map-sheet/web/ds-map-sheet.js +2 -2
  453. package/dist/map-summary/map-summary.d.ts +2 -1
  454. package/dist/map-summary/web/ds-map-summary.d.ts +2 -2
  455. package/dist/map-summary/web/ds-map-summary.js +18 -9
  456. package/dist/mention-input/mention-input.d.ts +23 -2
  457. package/dist/mention-input/mention-input.js +15 -8
  458. package/dist/mention-input/native/ds-mention-input.d.ts +1 -1
  459. package/dist/mention-input/native/ds-mention-input.js +6 -9
  460. package/dist/mention-input/web/ds-mention-input.d.ts +1 -1
  461. package/dist/mention-input/web/ds-mention-input.js +6 -5
  462. package/dist/menu-button/web/ds-menu-button.d.ts +2 -2
  463. package/dist/menu-button/web/ds-menu-button.js +9 -4
  464. package/dist/meter/meter.d.ts +5 -2
  465. package/dist/meter/meter.js +2 -1
  466. package/dist/meter/native/ds-meter.d.ts +2 -2
  467. package/dist/meter/native/ds-meter.js +13 -3
  468. package/dist/meter/web/ds-meter.d.ts +1 -1
  469. package/dist/meter/web/ds-meter.js +16 -9
  470. package/dist/metric/metric.d.ts +13 -9
  471. package/dist/metric/native/ds-metric.d.ts +1 -1
  472. package/dist/metric/native/ds-metric.js +26 -16
  473. package/dist/metric/web/ds-metric.d.ts +1 -1
  474. package/dist/metric/web/ds-metric.js +21 -5
  475. package/dist/metric-card/metric-card.d.ts +4 -3
  476. package/dist/metric-card/web/ds-metric-card.d.ts +1 -1
  477. package/dist/metric-card/web/ds-metric-card.js +4 -2
  478. package/dist/month-picker/web/ds-month-picker.js +2 -1
  479. package/dist/month-strip/web/ds-month-strip.js +1 -1
  480. package/dist/motion.d.ts +18 -3
  481. package/dist/motion.js +3 -1
  482. package/dist/multi-select/multi-select.d.ts +39 -9
  483. package/dist/multi-select/multi-select.js +35 -22
  484. package/dist/multi-select/web/ds-multi-select.d.ts +1 -1
  485. package/dist/multi-select/web/ds-multi-select.js +42 -24
  486. package/dist/native.d.ts +12 -0
  487. package/dist/native.js +8 -0
  488. package/dist/notification-list/native/ds-notification-list.d.ts +1 -1
  489. package/dist/notification-list/native/ds-notification-list.js +14 -7
  490. package/dist/notification-list/notification-list.d.ts +2 -1
  491. package/dist/notification-list/web/ds-notification-list.d.ts +1 -1
  492. package/dist/notification-list/web/ds-notification-list.js +10 -4
  493. package/dist/number-field/native/ds-number-field.js +1 -1
  494. package/dist/number-field/web/ds-number-field.js +1 -1
  495. package/dist/otp/native/ds-otp-field.js +3 -21
  496. package/dist/otp/native/ds-otp.js +3 -3
  497. package/dist/otp/otp.d.ts +3 -3
  498. package/dist/otp/web/ds-otp.js +3 -3
  499. package/dist/overflow-menu/web/ds-overflow-menu.js +7 -2
  500. package/dist/page-head/web/ds-page-head.js +2 -2
  501. package/dist/panel/native/ds-panel.js +1 -1
  502. package/dist/panel/panel.d.ts +1 -1
  503. package/dist/panel/web/ds-panel.d.ts +3 -1
  504. package/dist/panel/web/ds-panel.js +3 -2
  505. package/dist/password-feedback/web/ds-password-feedback.d.ts +1 -1
  506. package/dist/password-feedback/web/ds-password-feedback.js +3 -3
  507. package/dist/password-input/web/ds-password-input.d.ts +7 -2
  508. package/dist/password-input/web/ds-password-input.js +28 -3
  509. package/dist/password-requirements/password-requirements.d.ts +12 -2
  510. package/dist/password-requirements/password-requirements.js +6 -8
  511. package/dist/password-requirements/web/ds-password-requirements.js +5 -5
  512. package/dist/password-strength/web/ds-password-strength.js +2 -2
  513. package/dist/payment-card/native/ds-payment-card.d.ts +1 -1
  514. package/dist/payment-card/native/ds-payment-card.js +1 -1
  515. package/dist/payment-card/web/ds-payment-card.d.ts +1 -1
  516. package/dist/payment-card/web/ds-payment-card.js +1 -1
  517. package/dist/people-cell/people-cell.d.ts +5 -2
  518. package/dist/people-cell/web/ds-people-cell.d.ts +1 -1
  519. package/dist/people-cell/web/ds-people-cell.js +6 -2
  520. package/dist/person-cell/person-cell.d.ts +5 -2
  521. package/dist/person-cell/web/ds-person-cell.d.ts +1 -1
  522. package/dist/person-cell/web/ds-person-cell.js +11 -1
  523. package/dist/phone-field/native/ds-phone-field.js +2 -2
  524. package/dist/phone-field/phone-field.d.ts +35 -0
  525. package/dist/phone-field/phone-field.js +38 -0
  526. package/dist/phone-field/web/ds-phone-field.d.ts +31 -3
  527. package/dist/phone-field/web/ds-phone-field.js +45 -8
  528. package/dist/place-card/native/ds-place-card.d.ts +7 -3
  529. package/dist/place-card/native/ds-place-card.js +32 -21
  530. package/dist/place-card/place-card.d.ts +12 -6
  531. package/dist/place-card/place-card.js +6 -3
  532. package/dist/place-card/web/ds-place-card.d.ts +5 -3
  533. package/dist/place-card/web/ds-place-card.js +39 -27
  534. package/dist/plan-chart/plan-chart.d.ts +2 -3
  535. package/dist/plan-chart/web/ds-plan-chart.d.ts +1 -1
  536. package/dist/plan-chart/web/ds-plan-chart.js +34 -6
  537. package/dist/popover/popover.d.ts +7 -3
  538. package/dist/popover/web/ds-popover.d.ts +5 -1
  539. package/dist/popover/web/ds-popover.js +4 -2
  540. package/dist/priority-indicator/native/ds-priority-indicator.js +4 -4
  541. package/dist/priority-indicator/priority-indicator.d.ts +3 -3
  542. package/dist/priority-indicator/priority-indicator.js +3 -3
  543. package/dist/priority-indicator/web/ds-priority-indicator.js +4 -4
  544. package/dist/profile-card/profile-card.d.ts +2 -1
  545. package/dist/profile-card/web/ds-profile-card.d.ts +2 -2
  546. package/dist/profile-card/web/ds-profile-card.js +16 -3
  547. package/dist/progress-bar/native/ds-progress-bar.js +2 -1
  548. package/dist/progress-bar/web/ds-progress-bar.js +2 -1
  549. package/dist/progress-cell/progress-cell.d.ts +8 -3
  550. package/dist/progress-cell/progress-cell.js +1 -1
  551. package/dist/progress-cell/web/ds-progress-cell.d.ts +5 -2
  552. package/dist/progress-cell/web/ds-progress-cell.js +6 -2
  553. package/dist/progress-ring/native/ds-progress-ring.js +16 -11
  554. package/dist/progress-ring/progress-ring.d.ts +8 -4
  555. package/dist/progress-ring/progress-ring.js +7 -3
  556. package/dist/progress-ring/web/ds-progress-ring.js +16 -10
  557. package/dist/proportion-bar/native/ds-proportion-bar.d.ts +2 -2
  558. package/dist/proportion-bar/native/ds-proportion-bar.js +18 -7
  559. package/dist/proportion-bar/proportion-bar.d.ts +10 -3
  560. package/dist/proportion-bar/proportion-bar.js +6 -1
  561. package/dist/proportion-bar/web/ds-proportion-bar.d.ts +1 -1
  562. package/dist/proportion-bar/web/ds-proportion-bar.js +21 -14
  563. package/dist/quick-actions/native/ds-quick-actions.js +17 -2
  564. package/dist/quick-actions/quick-actions.d.ts +32 -2
  565. package/dist/quick-actions/quick-actions.js +9 -1
  566. package/dist/quick-actions/web/ds-quick-actions.js +20 -6
  567. package/dist/radar-chart/radar-chart.d.ts +11 -3
  568. package/dist/radar-chart/radar-chart.js +21 -3
  569. package/dist/radar-chart/web/ds-radar-chart.d.ts +1 -1
  570. package/dist/radar-chart/web/ds-radar-chart.js +34 -22
  571. package/dist/radial-progress/native/ds-radial-progress.d.ts +6 -2
  572. package/dist/radial-progress/native/ds-radial-progress.js +34 -11
  573. package/dist/radial-progress/radial-progress.d.ts +11 -2
  574. package/dist/radial-progress/radial-progress.js +9 -0
  575. package/dist/radial-progress/web/ds-radial-progress.d.ts +6 -2
  576. package/dist/radial-progress/web/ds-radial-progress.js +24 -10
  577. package/dist/radio/radio.d.ts +4 -4
  578. package/dist/radio/radio.js +4 -4
  579. package/dist/radio/web/ds-radio.d.ts +6 -2
  580. package/dist/radio/web/ds-radio.js +22 -10
  581. package/dist/radio-group/radio-group.d.ts +41 -5
  582. package/dist/radio-group/radio-group.js +5 -0
  583. package/dist/radio-group/web/ds-radio-group.d.ts +1 -1
  584. package/dist/radio-group/web/ds-radio-group.js +7 -2
  585. package/dist/rating-badge/rating-badge.d.ts +8 -2
  586. package/dist/rating-badge/rating-badge.js +5 -0
  587. package/dist/rating-badge/web/ds-rating-badge.d.ts +2 -2
  588. package/dist/rating-badge/web/ds-rating-badge.js +6 -4
  589. package/dist/recipient-select/recipient-select.d.ts +7 -0
  590. package/dist/recipient-select/recipient-select.js +3 -0
  591. package/dist/recipient-select/web/ds-recipient-select.js +4 -4
  592. package/dist/record-panel/record-panel.d.ts +17 -2
  593. package/dist/record-panel/web/ds-record-panel.d.ts +48 -13
  594. package/dist/record-panel/web/ds-record-panel.js +27 -18
  595. package/dist/reorder-list/reorder-list.d.ts +3 -0
  596. package/dist/reorder-list/web/ds-reorder-list.d.ts +6 -1
  597. package/dist/reorder-list/web/ds-reorder-list.js +6 -4
  598. package/dist/resend-control/native/ds-resend-control.d.ts +24 -0
  599. package/dist/resend-control/native/ds-resend-control.js +73 -0
  600. package/dist/resend-control/resend-control.d.ts +2 -0
  601. package/dist/resend-control/resend-control.js +2 -0
  602. package/dist/resend-control/web/ds-resend-control.js +3 -3
  603. package/dist/route-fields/route-fields.d.ts +79 -0
  604. package/dist/route-fields/route-fields.js +71 -0
  605. package/dist/route-fields/web/ds-route-fields.d.ts +5 -0
  606. package/dist/route-fields/web/ds-route-fields.js +83 -0
  607. package/dist/route-line/web/ds-route-line.js +2 -2
  608. package/dist/save-bar/save-bar.d.ts +1 -1
  609. package/dist/save-bar/save-bar.js +1 -1
  610. package/dist/save-bar/web/ds-save-bar.js +2 -2
  611. package/dist/scanner/scanner.d.ts +1 -1
  612. package/dist/scanner/scanner.js +2 -1
  613. package/dist/scatter-chart/scatter-chart.d.ts +2 -3
  614. package/dist/scatter-chart/web/ds-scatter-chart.d.ts +1 -1
  615. package/dist/scatter-chart/web/ds-scatter-chart.js +13 -4
  616. package/dist/schedule-chart/schedule-chart.d.ts +187 -0
  617. package/dist/schedule-chart/schedule-chart.js +285 -0
  618. package/dist/schedule-chart/web/ds-schedule-chart.d.ts +24 -0
  619. package/dist/schedule-chart/web/ds-schedule-chart.js +143 -0
  620. package/dist/segmented-control/native/ds-segmented-control.d.ts +1 -1
  621. package/dist/segmented-control/native/ds-segmented-control.js +1 -1
  622. package/dist/segmented-control/segmented-control.d.ts +7 -0
  623. package/dist/segmented-control/web/ds-segmented-control.d.ts +1 -1
  624. package/dist/segmented-control/web/ds-segmented-control.js +4 -3
  625. package/dist/select/native/ds-select.js +6 -3
  626. package/dist/select/select.d.ts +5 -0
  627. package/dist/select/web/ds-select.d.ts +14 -1
  628. package/dist/select/web/ds-select.js +22 -12
  629. package/dist/settings-directory/native/ds-settings-directory.js +1 -1
  630. package/dist/settings-directory/web/ds-settings-directory.js +1 -1
  631. package/dist/settings-row/web/ds-settings-row.d.ts +3 -1
  632. package/dist/settings-row/web/ds-settings-row.js +2 -2
  633. package/dist/sheet/web/ds-sheet.js +3 -3
  634. package/dist/side-nav/side-nav.d.ts +2 -1
  635. package/dist/side-nav/web/ds-side-nav-collapse.d.ts +4 -1
  636. package/dist/side-nav/web/ds-side-nav-collapse.js +6 -3
  637. package/dist/side-nav/web/ds-side-nav-header.js +1 -1
  638. package/dist/side-nav/web/ds-side-nav-primary.js +1 -1
  639. package/dist/side-nav/web/ds-side-nav-profile.js +1 -1
  640. package/dist/side-nav/web/ds-side-nav.d.ts +1 -1
  641. package/dist/side-nav/web/ds-side-nav.js +3 -3
  642. package/dist/skeleton/skeleton.d.ts +20 -0
  643. package/dist/skeleton/skeleton.js +4 -0
  644. package/dist/slider/native/ds-slider.js +1 -1
  645. package/dist/small-multiples/small-multiples.d.ts +3 -4
  646. package/dist/small-multiples/small-multiples.js +2 -1
  647. package/dist/small-multiples/web/ds-small-multiples.d.ts +1 -1
  648. package/dist/small-multiples/web/ds-small-multiples.js +8 -2
  649. package/dist/sparkline/sparkline.d.ts +19 -7
  650. package/dist/sparkline/sparkline.js +42 -17
  651. package/dist/sparkline/web/ds-sparkline.d.ts +1 -1
  652. package/dist/sparkline/web/ds-sparkline.js +4 -3
  653. package/dist/split-pane/web/ds-split-pane.js +2 -2
  654. package/dist/stat-tile/native/ds-stat-tile.d.ts +3 -3
  655. package/dist/stat-tile/native/ds-stat-tile.js +14 -7
  656. package/dist/stat-tile/stat-tile.d.ts +14 -8
  657. package/dist/stat-tile/web/ds-stat-tile.d.ts +4 -2
  658. package/dist/stat-tile/web/ds-stat-tile.js +8 -5
  659. package/dist/state-message/web/ds-state-message.d.ts +6 -2
  660. package/dist/state-message/web/ds-state-message.js +5 -2
  661. package/dist/status-badge/native/ds-status-badge.js +3 -3
  662. package/dist/status-badge/status-badge.d.ts +3 -3
  663. package/dist/status-badge/status-badge.js +1 -1
  664. package/dist/status-badge/web/ds-status-badge.js +4 -4
  665. package/dist/status-cell/status-cell.d.ts +5 -2
  666. package/dist/status-cell/web/ds-status-cell.d.ts +6 -2
  667. package/dist/status-cell/web/ds-status-cell.js +7 -2
  668. package/dist/status-control/web/ds-status-control.js +3 -3
  669. package/dist/status-dot/native/ds-status-dot.js +1 -1
  670. package/dist/status-dot/status-dot.d.ts +2 -2
  671. package/dist/status-dot/status-dot.js +2 -2
  672. package/dist/status-dot/web/ds-status-dot.js +2 -2
  673. package/dist/stepper-form/stepper-form.d.ts +27 -4
  674. package/dist/stepper-form/stepper-form.js +17 -9
  675. package/dist/stepper-form/web/ds-stepper-form.d.ts +1 -1
  676. package/dist/stepper-form/web/ds-stepper-form.js +7 -5
  677. package/dist/stick-chart/stick-chart.d.ts +2 -1
  678. package/dist/stick-chart/stick-chart.js +2 -1
  679. package/dist/stick-chart/web/ds-stick-chart.d.ts +1 -1
  680. package/dist/stick-chart/web/ds-stick-chart.js +17 -3
  681. package/dist/switch/native/ds-switch.js +1 -1
  682. package/dist/system-state/native/ds-system-state.d.ts +29 -0
  683. package/dist/system-state/native/ds-system-state.js +68 -0
  684. package/dist/system-state/system-state.js +4 -3
  685. package/dist/system-state/web/ds-system-state.js +2 -2
  686. package/dist/table-toolbar/web/ds-table-toolbar.js +1 -1
  687. package/dist/tabs/tabs.d.ts +5 -0
  688. package/dist/tabs/tabs.js +2 -0
  689. package/dist/tabs/web/ds-tabs.js +2 -2
  690. package/dist/task-shell/task-shell.d.ts +15 -6
  691. package/dist/task-shell/task-shell.js +5 -2
  692. package/dist/task-shell/web/ds-task-shell.d.ts +21 -6
  693. package/dist/task-shell/web/ds-task-shell.js +52 -18
  694. package/dist/text/native/ds-text.js +1 -1
  695. package/dist/text/text.d.ts +1 -1
  696. package/dist/text/text.js +1 -1
  697. package/dist/text/web/ds-text.js +1 -1
  698. package/dist/textarea/native/ds-textarea.d.ts +1 -1
  699. package/dist/textarea/native/ds-textarea.js +9 -8
  700. package/dist/textarea/web/ds-textarea.d.ts +1 -1
  701. package/dist/textarea/web/ds-textarea.js +8 -7
  702. package/dist/time-field/time-field.d.ts +37 -0
  703. package/dist/time-field/time-field.js +23 -0
  704. package/dist/time-field/web/ds-time-field.d.ts +8 -0
  705. package/dist/time-field/web/ds-time-field.js +28 -0
  706. package/dist/time-range/time-range.d.ts +35 -26
  707. package/dist/time-range/time-range.js +28 -46
  708. package/dist/time-range/web/ds-time-range.d.ts +1 -1
  709. package/dist/time-range/web/ds-time-range.js +9 -6
  710. package/dist/timeline/native/ds-timeline.d.ts +2 -2
  711. package/dist/timeline/native/ds-timeline.js +21 -7
  712. package/dist/timeline/timeline.d.ts +2 -1
  713. package/dist/timeline/web/ds-timeline.d.ts +2 -2
  714. package/dist/timeline/web/ds-timeline.js +18 -9
  715. package/dist/toast/native/ds-toast.js +1 -1
  716. package/dist/toggle-group/native/ds-toggle-group.js +1 -1
  717. package/dist/token-roles.d.ts +1 -1
  718. package/dist/token-roles.js +18 -0
  719. package/dist/tone.d.ts +4 -4
  720. package/dist/tone.js +1 -5
  721. package/dist/toolbar/toolbar.d.ts +19 -7
  722. package/dist/toolbar/toolbar.js +4 -3
  723. package/dist/toolbar/web/ds-toolbar.d.ts +5 -2
  724. package/dist/toolbar/web/ds-toolbar.js +3 -3
  725. package/dist/track-bars/track-bars.d.ts +3 -4
  726. package/dist/track-bars/web/ds-track-bars.d.ts +1 -1
  727. package/dist/track-bars/web/ds-track-bars.js +9 -3
  728. package/dist/tree/tree.d.ts +1 -1
  729. package/dist/tree/tree.js +1 -1
  730. package/dist/tree/web/ds-tree.js +2 -2
  731. package/dist/treemap/treemap.d.ts +2 -3
  732. package/dist/treemap/web/ds-treemap.d.ts +1 -1
  733. package/dist/treemap/web/ds-treemap.js +14 -3
  734. package/dist/two-line-cell/two-line-cell.d.ts +5 -2
  735. package/dist/two-line-cell/web/ds-two-line-cell.d.ts +1 -1
  736. package/dist/two-line-cell/web/ds-two-line-cell.js +5 -1
  737. package/dist/vehicle-marker/vehicle-marker.d.ts +5 -4
  738. package/dist/vehicle-marker/vehicle-marker.js +3 -3
  739. package/dist/vehicle-marker/web/ds-vehicle-marker.js +9 -6
  740. package/dist/waterfall-chart/waterfall-chart.d.ts +10 -5
  741. package/dist/waterfall-chart/waterfall-chart.js +17 -12
  742. package/dist/waterfall-chart/web/ds-waterfall-chart.d.ts +7 -2
  743. package/dist/waterfall-chart/web/ds-waterfall-chart.js +49 -11
  744. package/dist/web.d.ts +20 -5
  745. package/dist/web.js +10 -2
  746. package/dist/week-schedule/web/ds-week-schedule.d.ts +1 -1
  747. package/dist/week-schedule/web/ds-week-schedule.js +4 -4
  748. package/dist/week-schedule/week-schedule.d.ts +23 -4
  749. package/dist/week-schedule/week-schedule.js +19 -13
  750. package/forced-colors.css +8 -5
  751. package/package.json +10 -15
@@ -1,25 +1,44 @@
1
- import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
1
+ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
2
2
  import { useId, useState } from 'react';
3
- import { DONUT_BOX, DONUT_RADIUS, DONUT_STROKE, donutArcs, donutParts, donutPercents, donutTotal, donutVisible, } from '../donut-chart';
3
+ import { DONUT_BOX, DONUT_RADIUS, DONUT_STROKE, donutArcs, donutParts, donutPercents, donutTotal, donutCentreLabel, DONUT_SHOWN_NEEDS_A_LABEL, donutVisible, } from '../donut-chart';
4
4
  import { CHART_QUIET, CHART_SERIES_BG, CHART_SERIES_STROKE, chartSeriesSlot, } from '../../lib/chart-series';
5
5
  import { cn } from '../../lib/cn';
6
- import { CHART_FINISH_ORNAMENT, FillSheenGradient } from '../../lib/web/chart-finish';
6
+ import { formatChartValue } from '../../lib/chart-value';
7
7
  import { DSText } from '../../text/web/ds-text';
8
- export function DSDonutChart({ segments, label, hiddenKeys = [], onHiddenKeysChange, formatValue = (value) => value.toLocaleString(), totalLabel, emptyLabel, otherLabel, reveal = true, className, ...props }) {
8
+ import { DSSkeleton } from '../../skeleton/web/ds-skeleton';
9
+ import { LOADING_ROWS, loadingSpoken } from '../../skeleton/skeleton';
10
+ import { SpokenRegion } from '../../lib/web/spoken-region';
11
+ const DONUT_BOX_PX = 160;
12
+ const DONUT_PX = DONUT_BOX_PX / DONUT_BOX;
13
+ const SKELETON_RING = {
14
+ inset: (DONUT_BOX / 2 - DONUT_RADIUS - DONUT_STROKE / 2) * DONUT_PX,
15
+ borderWidth: DONUT_STROKE * DONUT_PX,
16
+ };
17
+ export function DSDonutChart({ segments, label, hiddenKeys = [], onHiddenKeysChange, formatValue = formatChartValue, totalLabel, shownLabel, emptyLabel, otherLabel, reveal = true, loading = false, loadingLabel, className, ...props }) {
9
18
  const uid = useId().replace(/[^a-zA-Z0-9_-]/g, '');
10
19
  const maskId = `${uid}-draw`;
11
- const sheenId = `${uid}-sheen`;
12
20
  const [active, setActive] = useState(undefined);
13
21
  const listed = donutParts(segments, otherLabel);
14
22
  const visible = donutVisible(listed, hiddenKeys, otherLabel);
15
23
  const total = donutTotal(visible);
16
24
  const percents = donutPercents(visible);
25
+ const hiddenCount = listed.filter((s) => hiddenKeys.includes(s.key)).length;
26
+ const centreLabel = donutCentreLabel(totalLabel, shownLabel, hiddenCount);
27
+ if (process.env['NODE_ENV'] !== 'production' &&
28
+ onHiddenKeysChange !== undefined &&
29
+ (shownLabel === undefined || shownLabel.trim() === '')) {
30
+ console.warn(`DSDonutChart: ${DONUT_SHOWN_NEEDS_A_LABEL}`);
31
+ }
17
32
  const arcs = donutArcs(visible);
18
33
  const isQuiet = (key) => listed.find((s) => s.key === key)?.other === true;
19
- const slotOf = (key) => chartSeriesSlot(listed.findIndex((s) => s.key === key) + 1);
34
+ const slotOf = (key) => chartSeriesSlot(listed.findIndex((s) => s.key === key) + 1) ?? 1;
20
35
  const inspected = listed.find((s) => s.key === active && !hiddenKeys.includes(s.key));
21
36
  const inspectedPercent = inspected === undefined ? 0 : (percents[visible.indexOf(inspected)] ?? 0);
22
37
  const interactive = onHiddenKeysChange !== undefined;
38
+ const status = _jsx(SpokenRegion, { text: loadingSpoken(loading, loadingLabel) });
39
+ if (loading) {
40
+ return (_jsxs(_Fragment, { children: [_jsxs("div", { className: cn('flex w-full flex-col items-center gap-6 sm:flex-row', className), ...props, role: "group", "aria-label": label, "aria-busy": true, children: [_jsxs("div", { className: "relative size-40 shrink-0", children: [_jsx(DSSkeleton, { className: "border-track absolute h-auto rounded-full bg-transparent", style: SKELETON_RING }), _jsxs("div", { className: "absolute inset-0 flex flex-col items-center justify-center gap-1 px-8", children: [_jsx(DSSkeleton, { fits: "heading-md", className: "w-20" }), _jsx(DSSkeleton, { fits: "body-xs", className: "w-14" })] })] }), _jsx("div", { className: "flex w-full min-w-0 flex-1 flex-col gap-1", children: Array.from({ length: LOADING_ROWS }, (_, i) => (_jsxs("div", { className: "flex min-h-8 items-center gap-2 px-2", children: [_jsx(DSSkeleton, { className: "size-2.5 shrink-0 rounded-full" }), _jsx(DSSkeleton, { fits: "body-sm", className: "w-24 min-w-0" }), _jsx(DSSkeleton, { fits: "body-sm", className: "ms-auto w-16" }), _jsx(DSSkeleton, { fits: "body-sm", className: "w-10" })] }, i))) })] }), status] }));
41
+ }
23
42
  const rowContent = (s) => {
24
43
  const hidden = hiddenKeys.includes(s.key);
25
44
  const at = visible.findIndex((v) => v.key === s.key);
@@ -27,23 +46,23 @@ export function DSDonutChart({ segments, label, hiddenKeys = [], onHiddenKeysCha
27
46
  ? 'border border-muted-foreground bg-transparent'
28
47
  : s.other === true
29
48
  ? CHART_QUIET.bg
30
- : CHART_SERIES_BG[slotOf(s.key)]) }), _jsx("span", { className: cn('min-w-0 flex-1 truncate text-start', hidden && 'text-muted-foreground line-through'), children: s.label }), _jsx("span", { className: cn('tabular-nums', hidden ? 'text-muted-foreground line-through' : 'font-semibold text-foreground'), children: formatValue(s.value) }), _jsx("span", { className: "w-10 text-end tabular-nums text-muted-foreground", children: hidden ? '' : `${String(percents[at] ?? 0)}%` })] }));
49
+ : CHART_SERIES_BG[slotOf(s.key)]) }), _jsx("span", { className: cn('min-w-20 flex-1 truncate text-start', hidden && 'text-muted-foreground line-through'), children: s.label }), _jsx("span", { className: cn('tabular-nums', hidden ? 'text-muted-foreground line-through' : 'font-semibold text-foreground'), children: formatValue(s.value) }), _jsx("span", { "data-donut-percent": "", className: "w-10 text-end tabular-nums text-muted-foreground", children: hidden ? '' : `${String(percents[at] ?? 0)}%` })] }));
31
50
  };
32
- return (_jsxs("div", { className: cn('flex w-full flex-col items-center gap-6 sm:flex-row', className), ...props, role: "group", "aria-label": label, children: [_jsxs("div", { className: "relative size-40 shrink-0", children: [_jsxs("svg", { "aria-hidden": true, viewBox: `0 0 ${String(DONUT_BOX)} ${String(DONUT_BOX)}`, className: "size-full overflow-visible", fill: "none", children: [_jsxs("defs", { children: [_jsx(FillSheenGradient, { id: sheenId, round: true, turned: true }), reveal && (_jsx("mask", { id: maskId, maskUnits: "userSpaceOnUse", children: _jsx("circle", { cx: DONUT_BOX / 2, cy: DONUT_BOX / 2, r: DONUT_RADIUS, strokeWidth: DONUT_STROKE * 3, pathLength: 100, strokeDasharray: "100 100", className: "stroke-hero-foreground animate-draw-arc", transform: `rotate(-90 ${String(DONUT_BOX / 2)} ${String(DONUT_BOX / 2)})` }) }))] }), _jsx("circle", { "data-donut-track": "", cx: DONUT_BOX / 2, cy: DONUT_BOX / 2, r: DONUT_RADIUS, strokeWidth: DONUT_STROKE, className: "stroke-track forced-colors:hidden" }), _jsxs("g", { ...(reveal ? { mask: `url(#${maskId})` } : {}), children: [arcs.map((arc) => (_jsx("circle", { "data-donut-arc": arc.key, cx: DONUT_BOX / 2, cy: DONUT_BOX / 2, r: DONUT_RADIUS, strokeWidth: DONUT_STROKE, strokeLinecap: "round", strokeDasharray: `${String(arc.length)} ${String(2 * Math.PI * DONUT_RADIUS)}`, strokeDashoffset: -arc.offset, transform: `rotate(-90 ${String(DONUT_BOX / 2)} ${String(DONUT_BOX / 2)})`, "data-chart-ink": "stroke", className: cn(isQuiet(arc.key) ? CHART_QUIET.stroke : CHART_SERIES_STROKE[slotOf(arc.key)], 'transition-control', active !== undefined && active !== arc.key && 'opacity-40'), onPointerEnter: () => {
33
- setActive(arc.key);
34
- }, onPointerLeave: () => {
35
- setActive(undefined);
36
- } }, arc.key))), arcs.map((arc) => (_jsx("circle", { cx: DONUT_BOX / 2, cy: DONUT_BOX / 2, r: DONUT_RADIUS, strokeWidth: DONUT_STROKE, strokeLinecap: "round", strokeDasharray: `${String(arc.length)} ${String(2 * Math.PI * DONUT_RADIUS)}`, strokeDashoffset: -arc.offset, transform: `rotate(-90 ${String(DONUT_BOX / 2)} ${String(DONUT_BOX / 2)})`, stroke: `url(#${sheenId})`, className: cn(CHART_FINISH_ORNAMENT, 'transition-control', active !== undefined && active !== arc.key && 'opacity-40') }, `${arc.key}-sheen`)))] })] }), _jsx("div", { "aria-hidden": true, "data-donut-centre": "", className: "pointer-events-none absolute inset-0 flex flex-col items-center justify-center gap-1 px-8 text-center", children: total <= 0 ? (_jsx(DSText, { as: "span", variant: "body-sm", className: "text-muted-foreground", children: emptyLabel })) : inspected === undefined ? (_jsxs(_Fragment, { children: [_jsx(DSText, { as: "span", variant: "heading-md", className: "tabular-nums leading-none text-foreground", children: formatValue(total) }), _jsx(DSText, { as: "span", variant: "body-xs", className: "text-muted-foreground", children: totalLabel })] })) : (_jsxs(_Fragment, { children: [_jsx(DSText, { as: "span", variant: "heading-md", className: "tabular-nums leading-none text-foreground", children: formatValue(inspected.value) }), _jsxs(DSText, { as: "span", variant: "body-xs", className: "max-w-full truncate text-muted-foreground", children: [inspected.label, ", ", String(inspectedPercent), "%"] })] })) })] }), _jsx("ul", { className: "flex w-full min-w-0 flex-1 flex-col gap-1 text-body-sm", "aria-label": `${label}, parts`, children: listed.map((s) => (_jsx("li", { children: interactive ? (_jsx("button", { type: "button", "aria-pressed": !hiddenKeys.includes(s.key), onClick: () => {
37
- onHiddenKeysChange(hiddenKeys.includes(s.key)
38
- ? hiddenKeys.filter((k) => k !== s.key)
39
- : [...hiddenKeys, s.key]);
40
- }, onPointerEnter: () => {
41
- setActive(s.key);
42
- }, onPointerLeave: () => {
43
- setActive(undefined);
44
- }, onFocus: () => {
45
- setActive(s.key);
46
- }, onBlur: () => {
47
- setActive(undefined);
48
- }, className: "focusable state-layer flex min-h-8 w-full items-center gap-2 rounded-xs px-2 pointer-coarse:min-h-touch", children: rowContent(s) })) : (_jsx("div", { className: "flex min-h-8 items-center gap-2 px-2", children: rowContent(s) })) }, s.key))) })] }));
51
+ return (_jsxs(_Fragment, { children: [_jsx("div", { className: cn('@container w-full', className), ...props, role: "group", "aria-label": label, children: _jsxs("div", { className: "flex w-full flex-col items-center gap-6 @sm:flex-row", children: [_jsxs("div", { className: "relative size-40 shrink-0", children: [_jsxs("svg", { "aria-hidden": true, viewBox: `0 0 ${String(DONUT_BOX)} ${String(DONUT_BOX)}`, className: "size-full overflow-visible", fill: "none", children: [_jsx("defs", { children: reveal && (_jsx("mask", { id: maskId, maskUnits: "userSpaceOnUse", children: _jsx("circle", { cx: DONUT_BOX / 2, cy: DONUT_BOX / 2, r: DONUT_RADIUS, strokeWidth: DONUT_STROKE * 3, pathLength: 100, strokeDasharray: "100 100", className: "stroke-hero-foreground animate-draw-arc", transform: `rotate(-90 ${String(DONUT_BOX / 2)} ${String(DONUT_BOX / 2)})` }) })) }), _jsx("circle", { "data-donut-track": "", cx: DONUT_BOX / 2, cy: DONUT_BOX / 2, r: DONUT_RADIUS, strokeWidth: DONUT_STROKE, className: "stroke-track forced-colors:hidden" }), _jsx("g", { ...(reveal ? { mask: `url(#${maskId})` } : {}), children: arcs.map((arc) => (_jsx("circle", { "data-donut-arc": arc.key, cx: DONUT_BOX / 2, cy: DONUT_BOX / 2, r: DONUT_RADIUS, strokeWidth: DONUT_STROKE, strokeLinecap: "round", strokeDasharray: `${String(arc.length)} ${String(2 * Math.PI * DONUT_RADIUS)}`, strokeDashoffset: -arc.offset, transform: `rotate(-90 ${String(DONUT_BOX / 2)} ${String(DONUT_BOX / 2)})`, "data-chart-ink": "stroke", className: cn(isQuiet(arc.key) ? CHART_QUIET.stroke : CHART_SERIES_STROKE[slotOf(arc.key)], 'transition-control', active !== undefined && active !== arc.key && 'opacity-40'), onPointerEnter: () => {
52
+ setActive(arc.key);
53
+ }, onPointerLeave: () => {
54
+ setActive(undefined);
55
+ } }, arc.key))) })] }), _jsx("div", { "aria-hidden": true, "data-donut-centre": "", className: "pointer-events-none absolute inset-0 flex flex-col items-center justify-center gap-1 px-8 text-center", children: total <= 0 ? (_jsx(DSText, { as: "span", variant: "body-sm", className: "text-muted-foreground", children: emptyLabel })) : inspected === undefined ? (_jsxs(_Fragment, { children: [_jsx(DSText, { as: "span", variant: "heading-md", "data-donut-total": "", className: "whitespace-nowrap tabular-nums leading-none text-foreground", children: formatValue(total) }), _jsx(DSText, { as: "span", variant: "body-xs", className: "text-muted-foreground", children: centreLabel })] })) : (_jsxs(_Fragment, { children: [_jsx(DSText, { as: "span", variant: "heading-md", className: "whitespace-nowrap tabular-nums leading-none text-foreground", children: formatValue(inspected.value) }), _jsxs(DSText, { as: "span", variant: "body-xs", className: "max-w-full truncate text-muted-foreground", children: [inspected.label, ", ", String(inspectedPercent), "%"] })] })) })] }), _jsx("ul", { className: "flex w-full min-w-0 flex-1 flex-col gap-1 text-body-sm", "aria-label": `${label}, parts`, children: listed.map((s) => (_jsx("li", { children: interactive ? (_jsx("button", { type: "button", "aria-pressed": !hiddenKeys.includes(s.key), onClick: () => {
56
+ onHiddenKeysChange(hiddenKeys.includes(s.key)
57
+ ? hiddenKeys.filter((k) => k !== s.key)
58
+ : [...hiddenKeys, s.key]);
59
+ }, onPointerEnter: () => {
60
+ setActive(s.key);
61
+ }, onPointerLeave: () => {
62
+ setActive(undefined);
63
+ }, onFocus: () => {
64
+ setActive(s.key);
65
+ }, onBlur: () => {
66
+ setActive(undefined);
67
+ }, className: "focusable state-layer flex min-h-8 w-full items-center gap-2 rounded-xs px-2 pointer-coarse:min-h-touch", children: rowContent(s) })) : (_jsx("div", { className: "flex min-h-8 items-center gap-2 px-2", children: rowContent(s) })) }, s.key))) })] }) }), status] }));
49
68
  }
@@ -1,3 +1,4 @@
1
+ import type { ReactNode } from 'react';
1
2
  import type { Forwarded } from '../props';
2
3
  /** Which edge the panel comes from. `right` is the design's; the other three are this package's. */
3
4
  export declare const DRAWER_DIRECTIONS: readonly ["right", "left", "top", "bottom"];
@@ -8,6 +9,10 @@ export declare const DRAWER_AXES: Record<DrawerDirection, 'inline' | 'block'>;
8
9
  export declare const DRAWER_EXTENT_PX: 520;
9
10
  /** The design's own token name for `DRAWER_EXTENT_PX`. */
10
11
  export declare const DRAWER_WIDTH_PX: 520;
12
+ export declare const DRAWER_SIZES: readonly ["md", "lg"];
13
+ export type DrawerSize = (typeof DRAWER_SIZES)[number];
14
+ /** Each size's extent along the entry axis, before the viewport cap. */
15
+ export declare const DRAWER_SIZE_EXTENT_PX: Record<DrawerSize, number>;
11
16
  /** The body scrolls; the panel never does. */
12
17
  export declare const DRAWER_SCROLLS_ITS_BODY: true;
13
18
  /** `--z-drawer`, with its scrim on `--z-scrim` below and room for a dialog above. */
@@ -16,6 +21,15 @@ export declare const DRAWER_SCRIM_Z_INDEX: 30;
16
21
  /** The panel scrim's strength, the value `--scrim-panel-opacity` carries. The
17
22
  * measurement, not a taste, see theme.css.
18
23
  *
24
+ * THE ONE SCRIM FOR A SIDE PANEL, AT EITHER SIZE (2026-10-31). The web sheet
25
+ * dimmed with the dark dialog scrim at 45%. This one stays, for three reasons.
26
+ * The theme names `--scrim-panel` as the scrim for a drawer or a sheet: the
27
+ * page behind a panel is set aside, not put out. The Engen and TFN brands
28
+ * already lay their dialogs over this same blue-grey, so a dialog raised from
29
+ * a panel there does not change colour behind it. And in dark it sits below the
30
+ * page, so it dims in both modes, the reason the sheet left the body ink.
31
+ * A sheet caller moving here gets this scrim.
32
+ *
19
33
  * IN THE COLOUR, NOT THE ELEMENT (2026-10-05). It was the element's `opacity`,
20
34
  * under a fade whose keyframe runs opacity from 0 to 1 and a running
21
35
  * animation outranks a resting value: the scrim rose to a solid blue grey over
@@ -71,11 +85,13 @@ export interface DrawerResolvedSpec {
71
85
  direction: DrawerDirection;
72
86
  /** Which dimension `extentPx` sets, see `DRAWER_AXES`. */
73
87
  axis: 'inline' | 'block';
74
- /** 520px, along the entry axis. */
88
+ /** The size, echoed back with the direction. */
89
+ size: DrawerSize;
90
+ /** 520px or 896px along the entry axis, by `size`. */
75
91
  extentPx: number;
76
92
  }
77
93
  /** The one function an adapter calls. */
78
- export declare function drawerSpec(direction?: DrawerDirection): DrawerResolvedSpec;
94
+ export declare function drawerSpec(direction?: DrawerDirection, size?: DrawerSize): DrawerResolvedSpec;
79
95
  export declare const DRAWER_DEFAULT_MODAL: true;
80
96
  export declare const DRAWER_HEADING_LEVELS: readonly [2, 3, 4];
81
97
  export type DrawerHeadingLevel = (typeof DRAWER_HEADING_LEVELS)[number];
@@ -85,8 +101,15 @@ export declare const DRAWER_MOTION: Record<DrawerDirection, {
85
101
  enter: string;
86
102
  exit: string;
87
103
  }>;
104
+ /** The words the drawer says itself, so a screen can swap them. The defaults
105
+ * are English and live here, not in the adapter. */
106
+ export interface DrawerCopy {
107
+ /** What a peek says when it opens or its record changes, given its title. */
108
+ showing: (title: string) => string;
109
+ }
110
+ export declare const DRAWER_COPY: DrawerCopy;
88
111
  /** What a peek says when it opens or its record changes. */
89
- export declare function drawerPeekAnnouncement(title: string): string;
112
+ export declare function drawerPeekAnnouncement(title: string, copy?: Pick<DrawerCopy, 'showing'>): string;
90
113
  /** The props every Drawer implementation accepts, on both platforms. */
91
114
  export interface DrawerContract {
92
115
  /** Whether the drawer is showing. Owned by the caller; there is no
@@ -94,10 +117,16 @@ export interface DrawerContract {
94
117
  open: boolean;
95
118
  /** The record's name, as a heading. Required and visible on both platforms. */
96
119
  title: string;
97
- /** A second line under the title, `.drawer-sub`. One line at body-sm. */
98
- sub?: Forwarded<string>;
120
+ /** A second line under the title, `.drawer-sub`, at body-sm. Usually words; an
121
+ * element passes through, for a line with a link in it. Web sets it inside
122
+ * a paragraph, so keep an element to inline content. Native wraps a string
123
+ * in text and puts an element in a view. */
124
+ sub?: Forwarded<ReactNode>;
99
125
  /** Which edge it comes from. `right` by default; a phone usually wants `bottom`. */
100
126
  direction?: DrawerDirection;
127
+ /** How far it reaches from its edge: `md` (520px) by default, `lg` (896px)
128
+ * for a form or a record with a table in it. See `DRAWER_SIZES`. */
129
+ size?: Forwarded<DrawerSize>;
101
130
  /** The close control's accessible name. Required for the same reason `title` is. */
102
131
  closeLabel: string;
103
132
  /** Asked to close. With `dirty`, `onDirtyCloseAttempt` is asked instead. */
@@ -108,6 +137,11 @@ export interface DrawerContract {
108
137
  /** Called INSTEAD of `onRequestClose` when a close is asked for while
109
138
  * `dirty`: ask your question here. Left out, a dirty close does nothing. */
110
139
  onDirtyCloseAttempt?: Forwarded<() => void>;
140
+ /** `true` while your own unsaved-changes prompt is open. Every way out waits
141
+ * for the answer and the drawer lets go of the page, so a prompt drawn in
142
+ * your own markup can take focus and be answered. A prompt that is a
143
+ * `DSDialog` needs none of this: the overlay stack raises it above. */
144
+ dirtyClosePending?: Forwarded<boolean>;
111
145
  /** `false` makes it a peek beside the page: no scrim, the page stays usable
112
146
  * and focus stays where it was. Web only; native is always modal. */
113
147
  modal?: Forwarded<boolean>;
@@ -117,6 +151,9 @@ export interface DrawerContract {
117
151
  * bottom it spans the gutters and grows to 520px at most. See
118
152
  * `DRAWER_FLOATING_GUTTER`. Web only; native always docks to its edge. */
119
153
  floating?: Forwarded<boolean>;
154
+ /** Replaces any of the words the drawer says itself (see `DrawerCopy`).
155
+ * Native takes it so cross platform JSX need not branch; it says none of them. */
156
+ copy?: Forwarded<Partial<DrawerCopy>>;
120
157
  }
121
158
  /** Why the count is a prop: `margin-right: auto` is the whole rule. */
122
159
  export declare const DRAWER_COUNT_IS_A_SLOT = "The count sits left of the actions via margin-right: auto, which is why it is a prop rather than a child.";
@@ -7,6 +7,8 @@ export const DRAWER_AXES = {
7
7
  };
8
8
  export const DRAWER_EXTENT_PX = 520;
9
9
  export const DRAWER_WIDTH_PX = DRAWER_EXTENT_PX;
10
+ export const DRAWER_SIZES = ['md', 'lg'];
11
+ export const DRAWER_SIZE_EXTENT_PX = { md: DRAWER_EXTENT_PX, lg: 896 };
10
12
  export const DRAWER_SCROLLS_ITS_BODY = true;
11
13
  export const DRAWER_Z_INDEX = 31;
12
14
  export const DRAWER_SCRIM_Z_INDEX = 30;
@@ -30,7 +32,7 @@ export const DRAWER_ROLES = [
30
32
  DRAWER_CLOSE_INK,
31
33
  DRAWER_SCRIM,
32
34
  ];
33
- export function drawerSpec(direction = 'right') {
35
+ export function drawerSpec(direction = 'right', size = 'md') {
34
36
  return {
35
37
  surface: DRAWER_SURFACE,
36
38
  border: DRAWER_BORDER,
@@ -42,7 +44,8 @@ export function drawerSpec(direction = 'right') {
42
44
  scrim: DRAWER_SCRIM,
43
45
  direction,
44
46
  axis: DRAWER_AXES[direction],
45
- extentPx: DRAWER_EXTENT_PX,
47
+ size,
48
+ extentPx: DRAWER_SIZE_EXTENT_PX[size],
46
49
  };
47
50
  }
48
51
  export const DRAWER_DEFAULT_MODAL = true;
@@ -54,7 +57,10 @@ export const DRAWER_MOTION = {
54
57
  top: { enter: 'slide-in-top', exit: 'slide-out-top' },
55
58
  bottom: { enter: 'slide-in-bottom', exit: 'slide-out-bottom' },
56
59
  };
57
- export function drawerPeekAnnouncement(title) {
58
- return `Showing ${title}`;
60
+ export const DRAWER_COPY = {
61
+ showing: (title) => `Showing ${title}`,
62
+ };
63
+ export function drawerPeekAnnouncement(title, copy = DRAWER_COPY) {
64
+ return copy.showing(title);
59
65
  }
60
66
  export const DRAWER_COUNT_IS_A_SLOT = 'The count sits left of the actions via margin-right: auto, which is why it is a prop rather than a child.';
@@ -12,4 +12,4 @@ export type DSDrawerProps = Omit<ViewProps, 'accessibilityViewIsModal' | 'access
12
12
  className?: string;
13
13
  };
14
14
  /** A panel that slides in from an edge to show one record. */
15
- export declare function DSDrawer({ open, title, sub, direction, closeLabel, onRequestClose, dirty, onDirtyCloseAttempt, modal, floating, children, footer, count, className, ...props }: DSDrawerProps): import("react/jsx-runtime").JSX.Element;
15
+ export declare function DSDrawer({ open, title, sub, direction, size, closeLabel, onRequestClose, dirty, onDirtyCloseAttempt, dirtyClosePending, modal, floating, copy, children, footer, count, className, ...props }: DSDrawerProps): import("react/jsx-runtime").JSX.Element;
@@ -24,21 +24,31 @@ const CloseIcon = styled(X, {
24
24
  className: { target: 'style', nativeStyleMapping: { color: 'color' } },
25
25
  });
26
26
  const GEOMETRY = {
27
- right: 'inset-y-0 right-0 w-130 max-w-full border-l',
28
- left: 'inset-y-0 left-0 w-130 max-w-full border-r',
29
- top: 'inset-x-0 top-0 h-130 max-h-full border-b',
30
- bottom: 'inset-x-0 bottom-0 h-130 max-h-full border-t',
27
+ right: 'inset-y-0 right-0 border-l',
28
+ left: 'inset-y-0 left-0 border-r',
29
+ top: 'inset-x-0 top-0 border-b',
30
+ bottom: 'inset-x-0 bottom-0 border-t',
31
31
  };
32
- export function DSDrawer({ open, title, sub, direction = 'right', closeLabel, onRequestClose, dirty, onDirtyCloseAttempt, modal, floating, children, footer, count, className, ...props }) {
33
- const spec = drawerSpec(direction);
32
+ const EXTENT = {
33
+ md: { inline: 'w-130 max-w-full', block: 'h-130 max-h-full' },
34
+ lg: { inline: 'w-224 max-w-full', block: 'h-224 max-h-full' },
35
+ };
36
+ export function DSDrawer({ open, title, sub, direction = 'right', size = 'md', closeLabel, onRequestClose, dirty, onDirtyCloseAttempt, dirtyClosePending, modal, floating, copy, children, footer, count, className, ...props }) {
37
+ const spec = drawerSpec(direction, size);
34
38
  void modal;
35
39
  void floating;
40
+ void copy;
36
41
  const requestClose = () => {
42
+ if (dirtyClosePending === true)
43
+ return;
37
44
  requestCloseUnlessDirty({ dirty, onRequestClose, onDirtyCloseAttempt });
38
45
  };
39
46
  const epoch = useThemeEpoch();
40
47
  const reduced = useReducedMotion();
41
- return (_jsxs(Modal, { visible: open, transparent: true, animationType: reduced || Platform.OS === 'web' ? 'none' : spec.direction === 'bottom' ? 'slide' : 'fade', onRequestClose: requestClose, statusBarTranslucent: true, "aria-label": title, children: [_jsx(Pressable, { testID: "drawer-scrim", "aria-hidden": true, accessibilityElementsHidden: true, importantForAccessibility: "no-hide-descendants", onPress: requestClose, style: { opacity: DRAWER_SCRIM_OPACITY }, className: cn('absolute inset-0', SCRIM[spec.scrim]) }), _jsxs(View, { testID: "drawer", accessibilityViewIsModal: true, accessibilityRole: "none", accessibilityLabel: title, "data-direction": spec.direction, className: cn('absolute flex-col overflow-hidden', GEOMETRY[spec.direction], SURFACE[spec.surface], BORDER[spec.border], className), ...props, children: [_jsxs(View, { testID: "drawer-head", className: cn('flex-row items-start border-b p-6', BORDER[spec.border]), children: [_jsxs(View, { className: "min-w-0 flex-1 flex-col gap-1", children: [_jsx(DSText, { variant: "heading-md", accessibilityRole: "header", className: cn(TITLE_INK[spec.titleInk]), children: title }), sub !== undefined && (_jsx(DSText, { variant: "body-sm", className: cn(SUB_INK[spec.subInk]), children: sub }))] }), _jsx(Pressable, { testID: "drawer-close", accessibilityRole: "button", accessibilityLabel: closeLabel, onPress: requestClose, style: ({ pressed }) => pressed && Platform.OS === 'ios'
48
+ return (_jsxs(Modal, { visible: open, transparent: true, animationType: reduced || Platform.OS === 'web' ? 'none' : spec.direction === 'bottom' ? 'slide' : 'fade', onRequestClose: requestClose, statusBarTranslucent: true, "aria-label": title, children: [_jsx(Pressable, { testID: "drawer-scrim", "aria-hidden": true, accessibilityElementsHidden: true, importantForAccessibility: "no-hide-descendants", onPress: requestClose, style: { opacity: DRAWER_SCRIM_OPACITY }, className: cn('absolute inset-0', SCRIM[spec.scrim]) }), _jsxs(View, { testID: "drawer", accessibilityViewIsModal: true, accessibilityRole: "none", accessibilityLabel: title, "data-direction": spec.direction, className: cn('absolute flex-col overflow-hidden', GEOMETRY[spec.direction], EXTENT[spec.size][spec.axis], SURFACE[spec.surface], BORDER[spec.border], className), ...props, children: [_jsxs(View, { testID: "drawer-head", className: cn('flex-row items-start border-b p-6', BORDER[spec.border]), children: [_jsxs(View, { className: "min-w-0 flex-1 flex-col gap-1", children: [_jsx(DSText, { variant: "heading-md", accessibilityRole: "header", className: cn(TITLE_INK[spec.titleInk]), children: title }), sub !== undefined &&
49
+ sub !== null &&
50
+ typeof sub !== 'boolean' &&
51
+ (typeof sub === 'string' || typeof sub === 'number' ? (_jsx(DSText, { variant: "body-sm", className: cn(SUB_INK[spec.subInk]), children: sub })) : (_jsx(View, { children: sub })))] }), _jsx(Pressable, { testID: "drawer-close", accessibilityRole: "button", accessibilityLabel: closeLabel, onPress: requestClose, style: ({ pressed }) => pressed && Platform.OS === 'ios'
42
52
  ? { transform: [{ scale: PRESS_SCALES.firm }] }
43
53
  : null, className: cn('ml-3 size-11 shrink-0 items-center justify-center rounded-full android:ripple-border', CLOSE_HOVER[spec.closeHoverSurface]), children: _jsx(CloseIcon, { "aria-hidden": true, size: 18, className: CLOSE_INK[spec.closeInk] }) }, epoch)] }), _jsx(ScrollView, { testID: "drawer-scroll", focusable: true, className: "flex-1", contentContainerClassName: "gap-3 p-6", children: children }), footer !== undefined && (_jsxs(View, { testID: "drawer-foot", className: cn('flex-row items-center gap-3 border-t p-4', BORDER[spec.border]), children: [count !== undefined && (_jsx(DSText, { variant: "body-sm", className: cn('mr-auto', SUB_INK[spec.subInk]), children: count })), footer] }))] })] }));
44
54
  }
@@ -14,4 +14,4 @@ export type DSDrawerProps = Omit<ComponentProps<'div'>, 'title' | 'role' | 'aria
14
14
  className?: string;
15
15
  };
16
16
  /** A panel that slides in from an edge to show one record. */
17
- export declare function DSDrawer({ open, title, sub, direction, closeLabel, onRequestClose, dirty, onDirtyCloseAttempt, modal, floating, headingLevel, children, footer, count, className, ...props }: DSDrawerProps): import("react").ReactPortal | null;
17
+ export declare function DSDrawer({ open, title, sub, direction, size, closeLabel, onRequestClose, dirty, onDirtyCloseAttempt, dirtyClosePending, modal, floating, headingLevel, copy, children, footer, count, className, style, ...props }: DSDrawerProps): import("react").ReactPortal | null;
@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
2
2
  import { useEffect, useId, useRef, useState, } from 'react';
3
3
  import { createPortal } from 'react-dom';
4
4
  import { X } from 'lucide-react';
5
- import { drawerPeekAnnouncement, drawerSpec, } from '../drawer';
5
+ import { DRAWER_COPY, drawerPeekAnnouncement, drawerSpec, } from '../drawer';
6
6
  import { cn } from '../../lib/cn';
7
7
  import { requestCloseUnlessDirty } from '../../lib/dirty-close';
8
8
  import { SCRIM_BLUR_CLASS } from '../../scrim';
@@ -25,22 +25,26 @@ const SCRIM = {
25
25
  };
26
26
  const HEADING = { 2: 'h2', 3: 'h3', 4: 'h4' };
27
27
  const GEOMETRY = {
28
- right: 'fixed inset-y-0 right-0 w-130 max-w-full border-l',
29
- left: 'fixed inset-y-0 left-0 w-130 max-w-full border-r',
30
- top: 'fixed inset-x-0 top-0 h-130 max-h-full border-b',
31
- bottom: 'fixed inset-x-0 bottom-0 h-130 max-h-full border-t',
28
+ right: 'fixed top-(--drawer-top) bottom-0 right-0 border-l',
29
+ left: 'fixed top-(--drawer-top) bottom-0 left-0 border-r',
30
+ top: 'fixed inset-x-0 top-0 border-b',
31
+ bottom: 'fixed inset-x-0 bottom-0 border-t',
32
32
  };
33
+ const EXTENT = {
34
+ md: { inline: 'w-130 max-w-full', block: 'h-130 max-h-full' },
35
+ lg: { inline: 'w-224 max-w-full', block: 'h-224 max-h-full' },
36
+ };
37
+ const DRAWER_TOP = { '--drawer-top': '0px' };
33
38
  const FLOATING_FRAME = {
34
39
  right: 'fixed inset-4 flex items-start justify-end pointer-events-none',
35
40
  left: 'fixed inset-4 flex items-start justify-start pointer-events-none',
36
41
  top: 'fixed inset-4 flex flex-col justify-start pointer-events-none',
37
42
  bottom: 'fixed inset-4 flex flex-col justify-end pointer-events-none',
38
43
  };
39
- const FLOATING_GEOMETRY = {
40
- right: 'pointer-events-auto w-130 max-w-full max-h-full overflow-hidden rounded-card border',
41
- left: 'pointer-events-auto w-130 max-w-full max-h-full overflow-hidden rounded-card border',
42
- top: 'pointer-events-auto w-full max-h-130 overflow-hidden rounded-card border',
43
- bottom: 'pointer-events-auto w-full max-h-130 overflow-hidden rounded-card border',
44
+ const FLOATING_GEOMETRY = 'pointer-events-auto overflow-hidden rounded-card border';
45
+ const FLOATING_EXTENT = {
46
+ md: { inline: 'w-130 max-w-full max-h-full', block: 'w-full max-h-130' },
47
+ lg: { inline: 'w-224 max-w-full max-h-full', block: 'w-full max-h-224' },
44
48
  };
45
49
  const PANEL = 'flex flex-col shadow-high';
46
50
  const ENTER = {
@@ -56,8 +60,9 @@ const EXIT = {
56
60
  bottom: 'animate-slide-out-bottom',
57
61
  };
58
62
  const EXIT_FALLBACK_MS = 400;
59
- export function DSDrawer({ open, title, sub, direction = 'right', closeLabel, onRequestClose, dirty = false, onDirtyCloseAttempt, modal = true, floating = false, headingLevel = 2, children, footer, count, className, ...props }) {
60
- const spec = drawerSpec(direction);
63
+ export function DSDrawer({ open, title, sub, direction = 'right', size = 'md', closeLabel, onRequestClose, dirty = false, onDirtyCloseAttempt, dirtyClosePending = false, modal = true, floating = false, headingLevel = 2, copy, children, footer, count, className, style, ...props }) {
64
+ const spec = drawerSpec(direction, size);
65
+ const hasSub = sub !== undefined && sub !== null && typeof sub !== 'boolean';
61
66
  const id = useId();
62
67
  const titleId = `${id}-title`;
63
68
  const subId = `${id}-sub`;
@@ -67,6 +72,7 @@ export function DSDrawer({ open, title, sub, direction = 'right', closeLabel, on
67
72
  const openerRef = useRef(null);
68
73
  const [portalNode] = useState(() => document.createElement('div'));
69
74
  const [overflows, setOverflows] = useState(false);
75
+ const [scrolled, setScrolled] = useState(false);
70
76
  const [exiting, setExiting] = useState(false);
71
77
  const wasOpen = useRef(false);
72
78
  if (wasOpen.current !== open) {
@@ -124,11 +130,12 @@ export function DSDrawer({ open, title, sub, direction = 'right', closeLabel, on
124
130
  return;
125
131
  return lockBodyScroll('drawer-open');
126
132
  }, [open, modal]);
133
+ const peekWords = drawerPeekAnnouncement(title, { ...DRAWER_COPY, ...copy });
127
134
  useEffect(() => {
128
135
  if (!open || modal)
129
136
  return;
130
- announceLive(drawerPeekAnnouncement(title));
131
- }, [open, modal, title]);
137
+ announceLive(peekWords);
138
+ }, [open, modal, peekWords]);
132
139
  useEffect(() => {
133
140
  const body = bodyRef.current;
134
141
  if (!open || body === null)
@@ -148,16 +155,19 @@ export function DSDrawer({ open, title, sub, direction = 'right', closeLabel, on
148
155
  };
149
156
  }, [open, children]);
150
157
  const requestClose = () => {
158
+ if (dirtyClosePending)
159
+ return;
151
160
  requestCloseUnlessDirty({ dirty, onRequestClose, onDirtyCloseAttempt });
152
161
  };
153
162
  const { z } = useOverlay({
154
163
  kind: modal ? 'modal' : 'anchored',
155
164
  open,
156
165
  host: present ? portalNode : null,
166
+ yieldsPage: dirtyClosePending,
157
167
  onEscape: requestClose,
158
168
  });
159
169
  function handleKeyDown(event) {
160
- if (modal)
170
+ if (modal && !dirtyClosePending)
161
171
  trapTab(panelRef.current, event);
162
172
  }
163
173
  if (!present)
@@ -165,7 +175,12 @@ export function DSDrawer({ open, title, sub, direction = 'right', closeLabel, on
165
175
  const Heading = HEADING[headingLevel];
166
176
  const panel = (_jsxs("div", { ref: panelRef, ...(modal
167
177
  ? { role: 'dialog', 'aria-modal': true, tabIndex: -1 }
168
- : { role: 'complementary' }), "aria-labelledby": titleId, ...(sub === undefined ? {} : { 'aria-describedby': subId }), onKeyDown: handleKeyDown, "data-direction": spec.direction, "data-modal": modal ? 'true' : 'false', "data-floating": floating ? 'true' : 'false', ...(exiting ? { inert: true } : {}), style: z === null || floating ? undefined : { zIndex: z }, onAnimationEnd: finishExit, className: cn(PANEL, exiting ? EXIT[spec.direction] : ENTER[spec.direction], floating ? FLOATING_GEOMETRY[spec.direction] : GEOMETRY[spec.direction], SURFACE[spec.surface], PANEL_EDGE, INK[spec.ink], 'outline-none', className), ...props, children: [_jsxs("div", { className: cn('flex shrink-0 items-start gap-3 border-b p-6', BORDER[spec.border]), children: [_jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [_jsx(Heading, { ref: headingRef, id: titleId, tabIndex: -1, className: cn('m-0 text-heading-md break-words outline-none', TITLE_INK[spec.titleInk]), children: title }), sub !== undefined && (_jsx(DSText, { as: "p", variant: "body-sm", id: subId, className: cn('m-0 break-words', SUB_INK[spec.subInk]), children: sub }))] }), _jsx(DSIconButton, { label: closeLabel, variant: "ghost", icon: _jsx(X, {}), onClick: requestClose, className: "-my-2 shrink-0" })] }), _jsx("div", { ref: bodyRef, ...(overflows ? { tabIndex: 0 } : {}), className: cn('min-h-0 flex-1 overflow-y-auto overscroll-contain p-6', overflows &&
169
- 'focusable focus-visible:-outline-offset-(--size-focus-ring-offset) focus-visible:shadow-none'), children: children }), footer !== undefined && (_jsxs("div", { className: cn('flex flex-none flex-wrap items-center justify-end gap-3 border-t p-4', BORDER[spec.border]), children: [count !== undefined && (_jsx(DSText, { as: "span", variant: "body-sm", className: cn('mr-auto', SUB_INK[spec.subInk]), children: count })), footer] }))] }));
178
+ : { role: 'complementary' }), "aria-labelledby": titleId, ...(hasSub ? { 'aria-describedby': subId } : {}), onKeyDown: handleKeyDown, "data-direction": spec.direction, "data-size": spec.size, "data-modal": modal ? 'true' : 'false', "data-floating": floating ? 'true' : 'false', ...(exiting ? { inert: true } : {}), style: z === null || floating
179
+ ? { ...DRAWER_TOP, ...style }
180
+ : { ...DRAWER_TOP, ...style, zIndex: z }, onAnimationEnd: finishExit, className: cn(PANEL, exiting ? EXIT[spec.direction] : ENTER[spec.direction], floating
181
+ ? [FLOATING_GEOMETRY, FLOATING_EXTENT[spec.size][spec.axis]]
182
+ : [GEOMETRY[spec.direction], EXTENT[spec.size][spec.axis]], SURFACE[spec.surface], PANEL_EDGE, INK[spec.ink], 'outline-none', className), ...props, children: [_jsxs("div", { className: cn('flex shrink-0 items-start gap-3 border-b drawer-head drawer-px', scrolled ? BORDER[spec.border] : 'drawer-head-rule'), children: [_jsxs("div", { className: "flex min-w-0 flex-1 flex-col gap-1", children: [_jsx(Heading, { ref: headingRef, id: titleId, tabIndex: -1, className: cn('m-0 text-heading-md break-words outline-none drawer-title-room', TITLE_INK[spec.titleInk]), children: title }), hasSub && (_jsx(DSText, { as: "p", variant: "body-sm", id: subId, className: cn('m-0 break-words', SUB_INK[spec.subInk]), children: sub }))] }), _jsx("div", { className: "drawer-close-line shrink-0", children: _jsx(DSIconButton, { label: closeLabel, variant: "ghost", icon: _jsx(X, {}), onClick: requestClose }) })] }), _jsx("div", { ref: bodyRef, ...(overflows ? { tabIndex: 0 } : {}), onScroll: (event) => {
183
+ setScrolled(event.currentTarget.scrollTop > 0);
184
+ }, className: cn('min-h-0 flex-1 overflow-y-auto overscroll-contain py-6 drawer-px scroll-py-1', overflows && 'focusable-inset'), children: children }), footer !== undefined && (_jsxs("div", { className: cn('flex flex-none flex-wrap items-center justify-end gap-3 border-t p-4', BORDER[spec.border]), children: [count !== undefined && (_jsx(DSText, { as: "span", variant: "body-sm", className: cn('mr-auto', SUB_INK[spec.subInk]), children: count })), footer] }))] }));
170
185
  return createPortal(_jsxs(_Fragment, { children: [modal && (_jsx("div", { "data-role": "drawer-scrim", "aria-hidden": "true", onClick: exiting ? undefined : requestClose, style: z === null ? undefined : { zIndex: z - 1 }, className: cn('fixed inset-0', SCRIM_BLUR_CLASS, exiting ? 'animate-fade-out' : 'animate-fade-in', SCRIM[spec.scrim]) })), floating ? (_jsx("div", { "data-role": "drawer-frame", style: z === null ? undefined : { zIndex: z }, className: FLOATING_FRAME[spec.direction], children: panel })) : (panel)] }), portalNode);
171
186
  }
@@ -60,10 +60,11 @@ export interface DropdownMenuItemSpec {
60
60
  ink: DropdownMenuItemInkRole;
61
61
  hoverSurface: DropdownMenuItemHoverSurfaceRole;
62
62
  }
63
- /** `.pop-item` vs `.pop-item-danger`, the danger half CALLS `toneSpec('error')`
64
- * rather than re-deriving `destructive`/`destructive-surface` by hand, the
65
- * same discipline `delta.ts`'s `DELTA_SENTIMENT_SPECS` already holds itself
66
- * to for the identical two CSS variables. See the header. */
63
+ /** `.pop-item` vs `.pop-item-danger`. The danger half is an ACTION (delete,
64
+ * remove, archive), so it takes the destructive roles by name. It used to call
65
+ * `toneSpec('error')`, which pointed at the same roles until 2026-11-01, when
66
+ * the error tone moved to the error roles and `destructive` was left to the
67
+ * action. */
67
68
  export declare const DROPDOWN_MENU_ITEM_SPECS: {
68
69
  readonly safe: {
69
70
  readonly ink: "foreground";
@@ -177,11 +178,15 @@ export declare function dropdownMenuRowIsDestructive(row: {
177
178
  item: DropdownMenuLeaf;
178
179
  danger: boolean;
179
180
  }): boolean;
181
+ export declare const DROPDOWN_MENU_OPEN_ENDS: readonly ["first", "last"];
182
+ export type DropdownMenuOpenEnd = (typeof DROPDOWN_MENU_OPEN_ENDS)[number];
180
183
  /** The index, among the walked rows, that focus starts on; `-1` for none. */
181
184
  export declare function dropdownMenuInitialIndex(rows: readonly {
182
185
  item: DropdownMenuLeaf;
183
186
  danger: boolean;
184
- }[]): number;
187
+ }[], from?: DropdownMenuOpenEnd): number;
188
+ /** Which end a menu trigger's arrow key opens the menu at; `undefined` when the key does not open it. */
189
+ export declare function dropdownMenuTriggerOpenEnd(key: string): DropdownMenuOpenEnd | undefined;
185
190
  export declare const DROPDOWN_MENU_KEY_INTENTS: readonly ["next", "previous", "first", "last", "choose", "open-submenu", "close-submenu", "close"];
186
191
  export type DropdownMenuKeyIntent = (typeof DROPDOWN_MENU_KEY_INTENTS)[number];
187
192
  /** What a key does inside the menu. `undefined` means the key is not the menu's. */
@@ -1,8 +1,7 @@
1
- import { toneSpec } from '../tone';
2
1
  import { parseShortcut } from '../kbd/kbd';
3
2
  export const DROPDOWN_MENU_ITEM_SPECS = {
4
3
  safe: { ink: 'foreground', hoverSurface: 'secondary' },
5
- danger: { ink: toneSpec('error').role, hoverSurface: toneSpec('error').surfaceRole },
4
+ danger: { ink: 'destructive', hoverSurface: 'destructive-surface' },
6
5
  };
7
6
  export function dropdownMenuItemSpec(danger) {
8
7
  return danger ? { ...DROPDOWN_MENU_ITEM_SPECS.danger } : { ...DROPDOWN_MENU_ITEM_SPECS.safe };
@@ -85,10 +84,20 @@ export function dropdownMenuWalk(sections) {
85
84
  export function dropdownMenuRowIsDestructive(row) {
86
85
  return row.danger || row.item.destructive === true;
87
86
  }
88
- export function dropdownMenuInitialIndex(rows) {
87
+ export const DROPDOWN_MENU_OPEN_ENDS = ['first', 'last'];
88
+ export function dropdownMenuInitialIndex(rows, from = 'first') {
89
89
  const safe = (row) => row.item.disabled !== true && !dropdownMenuRowIsDestructive(row);
90
90
  const chosen = rows.findIndex((row) => safe(row) && row.item.radio === true && row.item.checked === true);
91
- return chosen >= 0 ? chosen : rows.findIndex(safe);
91
+ if (chosen >= 0)
92
+ return chosen;
93
+ return from === 'last' ? rows.findLastIndex(safe) : rows.findIndex(safe);
94
+ }
95
+ export function dropdownMenuTriggerOpenEnd(key) {
96
+ if (key === 'ArrowDown')
97
+ return 'first';
98
+ if (key === 'ArrowUp')
99
+ return 'last';
100
+ return undefined;
92
101
  }
93
102
  export const DROPDOWN_MENU_KEY_INTENTS = [
94
103
  'next',
@@ -1,5 +1,5 @@
1
1
  import { type ComponentProps, type MouseEvent, type ReactNode } from 'react';
2
- import { type DropdownMenuLeaf, type DropdownMenuSeparator } from '../dropdown-menu';
2
+ import { type DropdownMenuLeaf, type DropdownMenuOpenEnd, type DropdownMenuSeparator } from '../dropdown-menu';
3
3
  import { type KbdPlatform } from '../../kbd/kbd';
4
4
  /** One action in a submenu, with an optional glyph. */
5
5
  export interface DSDropdownMenuLeaf extends DropdownMenuLeaf {
@@ -57,6 +57,8 @@ export type DSDropdownMenuSurfaceProps = SurfaceRest & {
57
57
  backOnArrowLeft?: boolean | undefined;
58
58
  /** Plays the transform-only entrance and the fading exit. */
59
59
  animated?: boolean | undefined;
60
+ /** Which end focus starts at: `last` for a menu its trigger opened with ArrowUp. The first safe item unless told. */
61
+ openAt?: DropdownMenuOpenEnd | undefined;
60
62
  /** An item was chosen, report it, close, return focus; `staysOpen` is true for a tickable choice, which keeps the menu open. The press is passed so a link item can be routed by the caller. */
61
63
  onChoose: (act: string, event: MouseEvent<HTMLElement>, staysOpen: boolean) => void;
62
64
  /** Close everything; `returnFocus` is false for an outside press, which has already put attention elsewhere. */
@@ -67,5 +69,5 @@ export type DSDropdownMenuSurfaceProps = SurfaceRest & {
67
69
  onOpenSubmenuChange?: ((act: string | null) => void) | undefined;
68
70
  };
69
71
  /** A whole anchored menu: sections, rules, group names, roving focus, type-ahead and one level of submenu. */
70
- export declare function DSDropdownMenuSurface({ open, anchor, entries, danger, label, side, gap, size, backOnArrowLeft, animated, onChoose, onDismiss, openSubmenu, onOpenSubmenuChange, ...rest }: DSDropdownMenuSurfaceProps): import("react/jsx-runtime").JSX.Element;
72
+ export declare function DSDropdownMenuSurface({ open, anchor, entries, danger, label, side, gap, size, backOnArrowLeft, animated, openAt, onChoose, onDismiss, openSubmenu, onOpenSubmenuChange, ...rest }: DSDropdownMenuSurfaceProps): import("react/jsx-runtime").JSX.Element;
71
73
  export {};
@@ -70,7 +70,7 @@ export function DSDropdownMenuRow({ item, destructive, hasSubmenu = false, expan
70
70
  const spec = dropdownMenuItemStateSpec({ destructive, disabled });
71
71
  const role = hasSubmenu ? 'menuitem' : dropdownMenuItemRole(item);
72
72
  const checked = item.checked === true;
73
- const className = cn('focusable flex w-full items-center gap-2 rounded-xxs text-left no-underline', ROW_SIZE[size], INK[spec.ink], spec.hoverSurface === null
73
+ const className = cn('focusable flex w-full items-center gap-2 rounded-field text-left no-underline', ROW_SIZE[size], INK[spec.ink], spec.hoverSurface === null
74
74
  ? 'cursor-not-allowed'
75
75
  : cn('cursor-pointer transition-control', HOVER[followsPointer ? 'pointer' : 'keyboard'][spec.hoverSurface]));
76
76
  const content = (_jsxs(_Fragment, { children: [role !== 'menuitem' && (_jsx("span", { "aria-hidden": true, className: cn('grid size-4 shrink-0 place-items-center', disabled ? INK['disabled-foreground'] : CHECK_INK.primary), children: checked &&
@@ -95,7 +95,7 @@ export function DSDropdownMenuRow({ item, destructive, hasSubmenu = false, expan
95
95
  }
96
96
  return (_jsx("button", { ref: rowRef, type: "button", ...shared, children: content }));
97
97
  }
98
- function Level({ menuId, open, anchor, entries, danger, label, side, gap, size, inSubmenu, backOnArrowLeft, animated, autoFocus, platform, onChoose, onDismiss, onBack, openSubmenu: openSubmenuProp, onOpenSubmenuChange, rest, }) {
98
+ function Level({ menuId, open, anchor, entries, danger, label, side, gap, size, inSubmenu, backOnArrowLeft, animated, autoFocus, openAt, platform, onChoose, onDismiss, onBack, openSubmenu: openSubmenuProp, onOpenSubmenuChange, rest, }) {
99
99
  const baseId = useId();
100
100
  const spec = dropdownMenuSpec();
101
101
  const sections = dropdownMenuSections(entries, danger);
@@ -143,7 +143,7 @@ function Level({ menuId, open, anchor, entries, danger, label, side, gap, size,
143
143
  setSub(null);
144
144
  return;
145
145
  }
146
- setActive(dropdownMenuInitialIndex(rows));
146
+ setActive(dropdownMenuInitialIndex(rows, openAt));
147
147
  }, [open]);
148
148
  const subHoldsFocus = sub?.focus === true;
149
149
  useEffect(() => {
@@ -286,16 +286,16 @@ function Level({ menuId, open, anchor, entries, danger, label, side, gap, size,
286
286
  }
287
287
  const headingId = `${baseId}-group-${String(sectionIndex)}`;
288
288
  return (_jsxs(Fragment, { children: [rule, _jsxs("div", { role: "group", "aria-labelledby": headingId, children: [_jsx("div", { id: headingId, "aria-hidden": true, className: "truncate px-2 pb-1 pt-2 text-label-sm font-semibold text-muted-foreground", children: section.label }), section.rows.map(renderRow)] })] }, section.key));
289
- }) }), host), subRow !== undefined && sub !== null && (_jsx(Level, { menuId: menuId, open: true, anchor: sub.element, entries: subRow.item.items ?? [], danger: [], label: subRow.item.label, side: "right", gap: SUBMENU_GAP[size], size: size, inSubmenu: true, backOnArrowLeft: false, animated: false, autoFocus: sub.focus, platform: platform, onChoose: onChoose, onDismiss: onDismiss, onBack: () => {
289
+ }) }), host), subRow !== undefined && sub !== null && (_jsx(Level, { menuId: menuId, open: true, anchor: sub.element, entries: subRow.item.items ?? [], danger: [], label: subRow.item.label, side: "right", gap: SUBMENU_GAP[size], size: size, inSubmenu: true, backOnArrowLeft: false, animated: false, autoFocus: sub.focus, openAt: "first", platform: platform, onChoose: onChoose, onDismiss: onDismiss, onBack: () => {
290
290
  const element = sub.element;
291
291
  setSub(null);
292
292
  element.focus();
293
293
  }, openSubmenu: undefined, onOpenSubmenuChange: undefined, rest: undefined }))] }));
294
294
  }
295
- export function DSDropdownMenuSurface({ open, anchor, entries, danger, label, side = 'bottom', gap, size = 'md', backOnArrowLeft = false, animated = false, onChoose, onDismiss, openSubmenu, onOpenSubmenuChange, ...rest }) {
295
+ export function DSDropdownMenuSurface({ open, anchor, entries, danger, label, side = 'bottom', gap, size = 'md', backOnArrowLeft = false, animated = false, openAt = 'first', onChoose, onDismiss, openSubmenu, onOpenSubmenuChange, ...rest }) {
296
296
  const menuId = useId();
297
297
  const platform = useDropdownMenuPlatform();
298
- return (_jsx(Level, { menuId: menuId, open: open, anchor: anchor, entries: entries, danger: danger ?? [], label: label, side: side, gap: gap, size: size, inSubmenu: false, backOnArrowLeft: backOnArrowLeft, animated: animated, autoFocus: true, platform: platform, onChoose: onChoose, onDismiss: onDismiss, onBack: () => {
298
+ return (_jsx(Level, { menuId: menuId, open: open, anchor: anchor, entries: entries, danger: danger ?? [], label: label, side: side, gap: gap, size: size, inSubmenu: false, backOnArrowLeft: backOnArrowLeft, animated: animated, autoFocus: true, openAt: openAt, platform: platform, onChoose: onChoose, onDismiss: onDismiss, onBack: () => {
299
299
  onDismiss(true);
300
300
  }, openSubmenu: openSubmenu, onOpenSubmenuChange: onOpenSubmenuChange, rest: rest }));
301
301
  }
@@ -1,5 +1,5 @@
1
1
  import { type ComponentProps } from 'react';
2
- import type { DropdownMenuContract } from '../dropdown-menu';
2
+ import type { DropdownMenuContract, DropdownMenuOpenEnd } from '../dropdown-menu';
3
3
  import { type DSDropdownMenuEntry, type DSDropdownMenuItem, type DSDropdownMenuSize } from './ds-dropdown-menu-surface';
4
4
  export type { DSDropdownMenuEntry, DSDropdownMenuItem, DSDropdownMenuLeaf, } from './ds-dropdown-menu-surface';
5
5
  export type DSDropdownMenuProps = Omit<ComponentProps<'div'>, 'onSelect' | 'role' | 'onKeyDown' | 'tabIndex' | 'ref'> & Omit<DropdownMenuContract, 'items' | 'danger'> & {
@@ -9,6 +9,9 @@ export type DSDropdownMenuProps = Omit<ComponentProps<'div'>, 'onSelect' | 'role
9
9
  danger?: readonly DSDropdownMenuItem[] | undefined;
10
10
  /** The roomy menu (`md`, 320px wide) or the dense one (`sm`). */
11
11
  size?: DSDropdownMenuSize | undefined;
12
+ /** Which end focus starts at: `last` when the trigger opened the menu with
13
+ * ArrowUp (`dropdownMenuTriggerOpenEnd`). The first safe item unless told. */
14
+ openAt?: DropdownMenuOpenEnd | undefined;
12
15
  /** Fires with the chosen item's `act`, never its label. Adapter-level
13
16
  * plumbing, not contract vocabulary, the same terms `DSRadioGroup`'s
14
17
  * `onValueChange` is on `DSRadioGroupProps` rather than
@@ -20,4 +23,4 @@ export type DSDropdownMenuProps = Omit<ComponentProps<'div'>, 'onSelect' | 'role
20
23
  onOpenChange: (open: boolean) => void;
21
24
  };
22
25
  /** A menu of actions for one item, anchored to the control that opened it, with glyphs, shortcut hints, disabled items, groups and one level of submenu. */
23
- export declare function DSDropdownMenu({ items, danger, open, size, onAction, onOpenChange, ...props }: DSDropdownMenuProps): import("react/jsx-runtime").JSX.Element;
26
+ export declare function DSDropdownMenu({ items, danger, open, size, openAt, onAction, onOpenChange, ...props }: DSDropdownMenuProps): import("react/jsx-runtime").JSX.Element;