@jcsoftdev/ui 0.9.0 → 0.10.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 (461) hide show
  1. package/CHANGELOG.md +132 -0
  2. package/README.md +22 -3
  3. package/dist/ai/attachment/attachment.d.ts +4 -3
  4. package/dist/ai/attachment/attachment.js +5 -1
  5. package/dist/ai/chat-message/chat-message.d.ts +4 -3
  6. package/dist/ai/chat-message/chat-message.js +5 -0
  7. package/dist/ai/code-block/code-block.js +2 -2
  8. package/dist/ai/conversation/conversation.d.ts +2 -2
  9. package/dist/ai/internal/disclosure.js +1 -1
  10. package/dist/ai/internal/icon-action.d.ts +4 -3
  11. package/dist/ai/internal/icon-action.js +11 -2
  12. package/dist/ai/message-actions/message-actions.d.ts +6 -3
  13. package/dist/ai/message-actions/message-actions.js +26 -1
  14. package/dist/ai/prompt-input/prompt-input.d.ts +3 -2
  15. package/dist/ai/prompt-input/prompt-input.js +14 -4
  16. package/dist/ai/prompt-suggestion/prompt-suggestion.d.ts +5 -4
  17. package/dist/ai/prompt-suggestion/prompt-suggestion.js +4 -0
  18. package/dist/ai/source/source.d.ts +4 -3
  19. package/dist/ai/source/source.js +16 -1
  20. package/dist/ai/tool-call/tool-call.d.ts +3 -2
  21. package/dist/ai/tool-call/tool-call.js +5 -1
  22. package/dist/atoms/big-date/big-date.d.ts +2 -2
  23. package/dist/atoms/button/button.d.ts +3 -2
  24. package/dist/atoms/button/button.js +9 -0
  25. package/dist/atoms/checkbox/checkbox.d.ts +5 -3
  26. package/dist/atoms/checkbox/checkbox.js +29 -19
  27. package/dist/atoms/chip/chip.d.ts +3 -2
  28. package/dist/atoms/chip/chip.js +10 -1
  29. package/dist/atoms/divider/divider.d.ts +2 -2
  30. package/dist/atoms/elapsed-time/elapsed-time.d.ts +2 -2
  31. package/dist/atoms/elapsed-time/elapsed-time.js +10 -7
  32. package/dist/atoms/elapsed-time/model.d.ts +8 -0
  33. package/dist/atoms/elapsed-time/model.js +44 -0
  34. package/dist/atoms/icon-button/icon-button.d.ts +2 -1
  35. package/dist/atoms/internal/labelled-control.d.ts +16 -0
  36. package/dist/atoms/internal/labelled-control.js +56 -0
  37. package/dist/atoms/number-value/number-value.d.ts +2 -2
  38. package/dist/atoms/pressable-feedback/pressable-feedback.d.ts +4 -3
  39. package/dist/atoms/pressable-feedback/pressable-feedback.js +13 -1
  40. package/dist/atoms/progress/progress.d.ts +2 -2
  41. package/dist/atoms/radio-group/radio-group-primitive.d.ts +3 -2
  42. package/dist/atoms/radio-group/radio-group-primitive.js +10 -1
  43. package/dist/atoms/radio-group/radio-group.d.ts +2 -0
  44. package/dist/atoms/radio-group/radio-group.js +3 -1
  45. package/dist/atoms/seal/seal.d.ts +2 -2
  46. package/dist/atoms/status-pill/status-pill.js +1 -1
  47. package/dist/atoms/switch/switch.d.ts +7 -4
  48. package/dist/atoms/switch/switch.js +35 -5
  49. package/dist/atoms/table-glyph/table-glyph.d.ts +2 -2
  50. package/dist/atoms/trend-chip/trend-chip.d.ts +2 -2
  51. package/dist/auth/login-form/parts.js +2 -2
  52. package/dist/calendar/date-calendar/date-calendar.js +1 -1
  53. package/dist/calendar/day-chip/day-chip.d.ts +3 -2
  54. package/dist/calendar/day-chip/day-chip.js +12 -1
  55. package/dist/calendar/event-block/event-block.d.ts +3 -2
  56. package/dist/calendar/event-block/event-block.js +7 -0
  57. package/dist/calendar/internal/grid-navigation.d.ts +11 -0
  58. package/dist/calendar/internal/grid-navigation.js +34 -0
  59. package/dist/calendar/internal/intent.d.ts +3 -0
  60. package/dist/calendar/internal/intent.js +7 -0
  61. package/dist/calendar/internal/month-model.d.ts +11 -0
  62. package/dist/calendar/internal/month-model.js +11 -0
  63. package/dist/calendar/internal/types.d.ts +4 -0
  64. package/dist/calendar/month-view/month-grid.d.ts +27 -0
  65. package/dist/calendar/month-view/month-grid.js +210 -0
  66. package/dist/calendar/month-view/month-view.d.ts +3 -1
  67. package/dist/calendar/month-view/month-view.js +29 -131
  68. package/dist/calendar/week-view/week-view.d.ts +3 -1
  69. package/dist/calendar/week-view/week-view.js +218 -128
  70. package/dist/charts/bar-chart/bar-race-chart.js +1 -1
  71. package/dist/charts/core/breadcrumb.js +1 -1
  72. package/dist/charts/core/chart-states.js +1 -1
  73. package/dist/charts/core/distribution/xy-points.js +4 -2
  74. package/dist/charts/crossfilter/crossfilter.js +1 -1
  75. package/dist/charts/gantt-chart/gantt-chart.js +1 -1
  76. package/dist/charts/maps/geo/map-data-table.js +1 -1
  77. package/dist/charts/sankey-chart/sankey-chart.js +1 -3
  78. package/dist/charts/tree-chart/tree-chart.js +1 -1
  79. package/dist/containers/action-bar/action-bar.d.ts +2 -2
  80. package/dist/containers/action-bar/action-bar.js +1 -1
  81. package/dist/containers/aside/aside.d.ts +3 -3
  82. package/dist/containers/banner/banner.d.ts +2 -2
  83. package/dist/containers/card/card.d.ts +5 -5
  84. package/dist/containers/card/card.js +3 -1
  85. package/dist/containers/carousel/carousel.d.ts +2 -2
  86. package/dist/containers/carousel/carousel.js +2 -2
  87. package/dist/containers/cols/cols.d.ts +3 -3
  88. package/dist/containers/comment/comment.d.ts +2 -2
  89. package/dist/containers/confirm-action/confirm-action.d.ts +3 -2
  90. package/dist/containers/confirm-action/confirm-action.js +10 -2
  91. package/dist/containers/dashboard/dashboard.d.ts +4 -4
  92. package/dist/containers/data-grid/column-menu.js +1 -1
  93. package/dist/containers/data-grid/data-grid.d.ts +7 -3
  94. package/dist/containers/data-grid/data-grid.js +45 -7
  95. package/dist/containers/data-grid/formula-bar.js +1 -1
  96. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  97. package/dist/containers/data-grid/tool-panel.js +1 -1
  98. package/dist/containers/description-list/description-list.d.ts +2 -2
  99. package/dist/containers/detail-header/detail-header.d.ts +2 -2
  100. package/dist/containers/facts/facts.d.ts +2 -2
  101. package/dist/containers/feed/feed.d.ts +5 -4
  102. package/dist/containers/feed/feed.js +12 -0
  103. package/dist/containers/file-tree/file-tree.js +11 -0
  104. package/dist/containers/file-tree/model.d.ts +2 -0
  105. package/dist/containers/filter-bar/filter-bar.d.ts +2 -2
  106. package/dist/containers/floor-plan/floor-plan.d.ts +2 -0
  107. package/dist/containers/floor-plan/floor-plan.js +17 -9
  108. package/dist/containers/floor-plan/index.d.ts +1 -1
  109. package/dist/containers/floor-plan/index.js +6 -1
  110. package/dist/containers/floor-plan/model.d.ts +3 -0
  111. package/dist/containers/floor-plan/model.js +8 -0
  112. package/dist/containers/generic-row/generic-row.d.ts +8 -6
  113. package/dist/containers/generic-row/generic-row.js +3 -1
  114. package/dist/containers/grid/grid.d.ts +2 -2
  115. package/dist/containers/hbars/hbars.js +2 -2
  116. package/dist/containers/highlight-line/highlight-line.d.ts +2 -2
  117. package/dist/containers/item-card-group/item-card-group.d.ts +4 -2
  118. package/dist/containers/item-card-group/item-card-group.js +4 -0
  119. package/dist/containers/kanban/kanban.js +13 -0
  120. package/dist/containers/kanban/model.d.ts +2 -0
  121. package/dist/containers/kpi/kpi-model.d.ts +7 -0
  122. package/dist/containers/kpi/kpi-model.js +22 -0
  123. package/dist/containers/kpi/kpi-parts.d.ts +28 -0
  124. package/dist/containers/kpi/kpi-parts.js +121 -0
  125. package/dist/containers/kpi/kpi.d.ts +7 -30
  126. package/dist/containers/kpi/kpi.js +4 -119
  127. package/dist/containers/kpi-group/kpi-group.d.ts +2 -2
  128. package/dist/containers/list-detail/list-detail.d.ts +12 -11
  129. package/dist/containers/list-detail/list-detail.js +9 -1
  130. package/dist/containers/note/note.d.ts +2 -2
  131. package/dist/containers/order-ticket/index.d.ts +1 -1
  132. package/dist/containers/order-ticket/index.js +2 -0
  133. package/dist/containers/order-ticket/model.d.ts +6 -0
  134. package/dist/containers/order-ticket/model.js +9 -0
  135. package/dist/containers/order-ticket/order-ticket.d.ts +4 -3
  136. package/dist/containers/order-ticket/order-ticket.js +26 -10
  137. package/dist/containers/page/page.d.ts +2 -2
  138. package/dist/containers/page-header/back.d.ts +2 -2
  139. package/dist/containers/page-header/page-header.d.ts +6 -6
  140. package/dist/containers/pagination/cursor-pagination.d.ts +2 -2
  141. package/dist/containers/pagination/pagination.d.ts +2 -2
  142. package/dist/containers/pagination/pagination.js +2 -2
  143. package/dist/containers/resizable/resizable.d.ts +4 -4
  144. package/dist/containers/resizable/resizable.js +1 -1
  145. package/dist/containers/row-actions/row-actions.d.ts +4 -3
  146. package/dist/containers/row-actions/row-actions.js +14 -1
  147. package/dist/containers/scrolly/scrolly.js +1 -1
  148. package/dist/containers/section/section.d.ts +10 -9
  149. package/dist/containers/section/section.js +12 -0
  150. package/dist/containers/selectable-card/selectable-card.d.ts +3 -2
  151. package/dist/containers/selectable-card/selectable-card.js +10 -1
  152. package/dist/containers/settings-layout/settings-layout.d.ts +7 -6
  153. package/dist/containers/settings-layout/settings-layout.js +10 -1
  154. package/dist/containers/settings-row/settings-row.d.ts +4 -3
  155. package/dist/containers/settings-row/settings-row.js +4 -0
  156. package/dist/containers/shortcuts/shortcuts.d.ts +3 -3
  157. package/dist/containers/stack/stack.d.ts +2 -2
  158. package/dist/containers/table/table.d.ts +14 -13
  159. package/dist/containers/table/table.js +22 -4
  160. package/dist/containers/timeline/timeline.d.ts +5 -4
  161. package/dist/containers/timeline/timeline.js +12 -0
  162. package/dist/containers/toolbar/toolbar.d.ts +3 -3
  163. package/dist/forms/accent-picker/accent-picker.d.ts +5 -2
  164. package/dist/forms/accent-picker/accent-picker.js +22 -1
  165. package/dist/forms/checkbox-button-group/checkbox-button-group.d.ts +3 -2
  166. package/dist/forms/checkbox-button-group/checkbox-button-group.js +16 -0
  167. package/dist/forms/chip-group/chip-group.d.ts +4 -1
  168. package/dist/forms/chip-group/chip-group.js +20 -2
  169. package/dist/forms/combobox/combobox.d.ts +3 -2
  170. package/dist/forms/combobox/combobox.js +10 -1
  171. package/dist/forms/copy-field/copy-field.d.ts +4 -3
  172. package/dist/forms/copy-field/copy-field.js +7 -0
  173. package/dist/forms/date-picker/date-picker.d.ts +3 -2
  174. package/dist/forms/date-picker/date-picker.js +10 -1
  175. package/dist/forms/date-picker/date-time-picker.d.ts +3 -2
  176. package/dist/forms/date-picker/date-time-picker.js +4 -0
  177. package/dist/forms/dropzone/dropzone.d.ts +3 -2
  178. package/dist/forms/dropzone/dropzone.js +21 -3
  179. package/dist/forms/emoji-picker/emoji-picker.d.ts +3 -2
  180. package/dist/forms/emoji-picker/emoji-picker.js +9 -2
  181. package/dist/forms/emoji-reaction-button/emoji-reaction-button.d.ts +3 -2
  182. package/dist/forms/emoji-reaction-button/emoji-reaction-button.js +8 -1
  183. package/dist/forms/field/field.d.ts +2 -2
  184. package/dist/forms/fieldset/fieldset.d.ts +2 -2
  185. package/dist/forms/form/form.d.ts +6 -4
  186. package/dist/forms/form/form.js +10 -2
  187. package/dist/forms/form-footer/form-footer.d.ts +2 -2
  188. package/dist/forms/form-grid/form-grid.d.ts +3 -3
  189. package/dist/forms/form-section/form-section.d.ts +2 -2
  190. package/dist/forms/inline-select/inline-select.d.ts +4 -3
  191. package/dist/forms/inline-select/inline-select.js +9 -1
  192. package/dist/forms/input/input.d.ts +3 -2
  193. package/dist/forms/input/input.js +11 -3
  194. package/dist/forms/internal/button-option.d.ts +2 -0
  195. package/dist/forms/label/label.d.ts +2 -2
  196. package/dist/forms/native-select/native-select.d.ts +4 -3
  197. package/dist/forms/native-select/native-select.js +4 -0
  198. package/dist/forms/number-stepper/number-stepper.d.ts +2 -1
  199. package/dist/forms/number-stepper/number-stepper.js +13 -3
  200. package/dist/forms/password-input/password-input.d.ts +1 -1
  201. package/dist/forms/password-input/password-input.js +12 -0
  202. package/dist/forms/pin-input/pin-input.d.ts +3 -2
  203. package/dist/forms/pin-input/pin-input.js +8 -1
  204. package/dist/forms/radio-button-group/radio-button-group.d.ts +3 -2
  205. package/dist/forms/radio-button-group/radio-button-group.js +16 -0
  206. package/dist/forms/rating/rating.d.ts +3 -2
  207. package/dist/forms/rating/rating.js +12 -0
  208. package/dist/forms/select/select.d.ts +4 -3
  209. package/dist/forms/select/select.js +11 -2
  210. package/dist/forms/select-menu/select-menu.d.ts +3 -2
  211. package/dist/forms/select-menu/select-menu.js +10 -1
  212. package/dist/forms/slider/model.d.ts +1 -0
  213. package/dist/forms/slider/model.js +5 -0
  214. package/dist/forms/slider/slider.d.ts +2 -1
  215. package/dist/forms/slider/slider.js +12 -3
  216. package/dist/forms/textarea/textarea.d.ts +4 -3
  217. package/dist/forms/textarea/textarea.js +4 -2
  218. package/dist/forms/time-input/time-input.d.ts +4 -3
  219. package/dist/forms/time-input/time-input.js +13 -1
  220. package/dist/i18n/strings.d.ts +18 -0
  221. package/dist/i18n/strings.js +12 -0
  222. package/dist/intent/attributes.d.ts +11 -0
  223. package/dist/intent/attributes.js +77 -0
  224. package/dist/intent/bridge.d.ts +8 -0
  225. package/dist/intent/bridge.js +19 -0
  226. package/dist/intent/index.d.ts +4 -0
  227. package/dist/intent/index.js +31 -0
  228. package/dist/intent/target-registrations.d.ts +16 -0
  229. package/dist/intent/target-registrations.js +91 -0
  230. package/dist/intent/types.d.ts +29 -0
  231. package/dist/intent/types.js +0 -0
  232. package/dist/intent/use-intent-target.d.ts +4 -0
  233. package/dist/intent/use-intent-target.js +75 -0
  234. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +6 -4
  235. package/dist/navigation/breadcrumbs/breadcrumbs.js +11 -1
  236. package/dist/navigation/floating-toc/floating-toc.d.ts +2 -2
  237. package/dist/navigation/floating-toc/floating-toc.js +5 -0
  238. package/dist/navigation/floating-toc/model.d.ts +2 -1
  239. package/dist/navigation/segmented/segmented.d.ts +3 -2
  240. package/dist/navigation/segmented/segmented.js +11 -1
  241. package/dist/navigation/stepper/stepper.d.ts +4 -2
  242. package/dist/navigation/stepper/stepper.js +3 -0
  243. package/dist/navigation/tabs/tabs-nav.d.ts +5 -4
  244. package/dist/navigation/tabs/tabs-nav.js +11 -0
  245. package/dist/navigation/tabs/tabs.d.ts +6 -5
  246. package/dist/navigation/tabs/tabs.js +44 -2
  247. package/dist/navigation/wizard/wizard.d.ts +4 -3
  248. package/dist/navigation/wizard/wizard.js +9 -1
  249. package/dist/overlays/alert-dialog/alert-dialog.d.ts +5 -4
  250. package/dist/overlays/alert-dialog/alert-dialog.js +20 -3
  251. package/dist/overlays/context-menu/context-menu.d.ts +14 -12
  252. package/dist/overlays/context-menu/context-menu.js +57 -8
  253. package/dist/overlays/dialog/dialog.d.ts +14 -8
  254. package/dist/overlays/dialog/dialog.js +29 -6
  255. package/dist/overlays/drawer/drawer.d.ts +6 -5
  256. package/dist/overlays/drawer/drawer.js +11 -0
  257. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +14 -13
  258. package/dist/overlays/dropdown-menu/dropdown-menu.js +58 -5
  259. package/dist/overlays/hover-card/hover-card.d.ts +4 -3
  260. package/dist/overlays/hover-card/hover-card.js +12 -1
  261. package/dist/overlays/popover/popover.d.ts +3 -2
  262. package/dist/overlays/popover/popover.js +12 -1
  263. package/dist/overlays/tooltip/model.d.ts +1 -0
  264. package/dist/overlays/tooltip/model.js +8 -0
  265. package/dist/overlays/tooltip/tooltip.d.ts +2 -1
  266. package/dist/overlays/tooltip/tooltip.js +8 -2
  267. package/dist/palette/command-palette/command-palette.d.ts +8 -4
  268. package/dist/palette/command-palette/command-palette.js +49 -1
  269. package/dist/palette/command-palette/index.d.ts +1 -0
  270. package/dist/palette/command-palette/index.js +3 -1
  271. package/dist/palette/command-palette/model.d.ts +7 -0
  272. package/dist/palette/command-palette/model.js +11 -0
  273. package/dist/primitives/command/command.js +4 -1
  274. package/dist/primitives/dialog/dialog.js +1 -3
  275. package/dist/primitives/popper/popper.js +15 -4
  276. package/dist/shell/bottom-nav/bottom-nav.js +54 -42
  277. package/dist/shell/sidebar/sidebar.d.ts +5 -3
  278. package/dist/shell/sidebar/sidebar.js +14 -2
  279. package/dist/shell/topbar/topbar.js +2 -2
  280. package/dist/showcase/bento.js +1 -0
  281. package/dist/utils/is-production.d.ts +1 -0
  282. package/dist/utils/is-production.js +6 -0
  283. package/dist/utils/slot.js +17 -3
  284. package/package.json +2 -2
  285. package/src/ai/attachment/attachment.tsx +10 -3
  286. package/src/ai/chat-message/chat-message.tsx +10 -2
  287. package/src/ai/code-block/code-block.tsx +2 -2
  288. package/src/ai/conversation/conversation.tsx +2 -2
  289. package/src/ai/internal/disclosure.tsx +1 -1
  290. package/src/ai/internal/icon-action.tsx +14 -4
  291. package/src/ai/message-actions/message-actions.tsx +28 -3
  292. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  293. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  294. package/src/ai/source/source.tsx +17 -3
  295. package/src/ai/tool-call/tool-call.tsx +6 -1
  296. package/src/atoms/big-date/big-date.tsx +2 -2
  297. package/src/atoms/button/button.tsx +11 -1
  298. package/src/atoms/checkbox/checkbox.tsx +40 -21
  299. package/src/atoms/chip/chip.tsx +12 -2
  300. package/src/atoms/divider/divider.tsx +2 -2
  301. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  302. package/src/atoms/elapsed-time/model.ts +57 -0
  303. package/src/atoms/icon-button/icon-button.tsx +3 -1
  304. package/src/atoms/internal/labelled-control.tsx +83 -0
  305. package/src/atoms/number-value/number-value.tsx +2 -2
  306. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  307. package/src/atoms/progress/progress.tsx +2 -2
  308. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  309. package/src/atoms/radio-group/radio-group.tsx +5 -1
  310. package/src/atoms/seal/seal.tsx +2 -2
  311. package/src/atoms/status-pill/status-pill.tsx +1 -1
  312. package/src/atoms/switch/switch.tsx +43 -9
  313. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  314. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  315. package/src/auth/login-form/parts.tsx +2 -2
  316. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  317. package/src/calendar/day-chip/day-chip.tsx +14 -2
  318. package/src/calendar/event-block/event-block.tsx +9 -1
  319. package/src/calendar/internal/grid-navigation.ts +47 -0
  320. package/src/calendar/internal/intent.ts +10 -0
  321. package/src/calendar/internal/month-model.ts +23 -0
  322. package/src/calendar/internal/types.ts +4 -0
  323. package/src/calendar/month-view/month-grid.tsx +248 -0
  324. package/src/calendar/month-view/month-view.tsx +32 -148
  325. package/src/calendar/week-view/week-view.tsx +87 -10
  326. package/src/charts/README.md +10 -0
  327. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  328. package/src/charts/core/breadcrumb.tsx +1 -1
  329. package/src/charts/core/chart-states.tsx +1 -1
  330. package/src/charts/core/distribution/xy-points.tsx +4 -2
  331. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  332. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  333. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  334. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  335. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  336. package/src/containers/action-bar/action-bar.tsx +3 -3
  337. package/src/containers/aside/aside.tsx +3 -3
  338. package/src/containers/banner/banner.tsx +2 -2
  339. package/src/containers/card/card.tsx +7 -5
  340. package/src/containers/carousel/carousel.tsx +4 -4
  341. package/src/containers/cols/cols.tsx +3 -3
  342. package/src/containers/comment/comment.tsx +2 -2
  343. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  344. package/src/containers/dashboard/dashboard.tsx +4 -4
  345. package/src/containers/data-grid/column-menu.tsx +1 -1
  346. package/src/containers/data-grid/data-grid.tsx +53 -4
  347. package/src/containers/data-grid/formula-bar.tsx +1 -1
  348. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  349. package/src/containers/data-grid/tool-panel.tsx +1 -1
  350. package/src/containers/description-list/description-list.tsx +2 -2
  351. package/src/containers/detail-header/detail-header.tsx +2 -2
  352. package/src/containers/facts/facts.tsx +2 -2
  353. package/src/containers/feed/feed.tsx +16 -3
  354. package/src/containers/file-tree/file-tree.tsx +11 -0
  355. package/src/containers/file-tree/model.ts +2 -0
  356. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  357. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  358. package/src/containers/floor-plan/index.ts +7 -1
  359. package/src/containers/floor-plan/model.ts +16 -0
  360. package/src/containers/generic-row/generic-row.tsx +9 -6
  361. package/src/containers/grid/grid.tsx +2 -2
  362. package/src/containers/hbars/hbars.tsx +23 -21
  363. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  364. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  365. package/src/containers/kanban/kanban.tsx +13 -0
  366. package/src/containers/kanban/model.ts +2 -0
  367. package/src/containers/kpi/kpi-model.ts +37 -0
  368. package/src/containers/kpi/kpi-parts.tsx +153 -0
  369. package/src/containers/kpi/kpi.tsx +10 -176
  370. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  371. package/src/containers/list-detail/list-detail.tsx +22 -12
  372. package/src/containers/note/note.tsx +2 -2
  373. package/src/containers/order-ticket/index.ts +2 -0
  374. package/src/containers/order-ticket/model.ts +21 -0
  375. package/src/containers/order-ticket/order-ticket.tsx +30 -13
  376. package/src/containers/page/page.tsx +2 -2
  377. package/src/containers/page-header/back.tsx +2 -2
  378. package/src/containers/page-header/page-header.tsx +6 -6
  379. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  380. package/src/containers/pagination/pagination.tsx +4 -4
  381. package/src/containers/resizable/resizable.tsx +7 -5
  382. package/src/containers/row-actions/row-actions.tsx +18 -3
  383. package/src/containers/scrolly/scrolly.tsx +1 -1
  384. package/src/containers/section/section.tsx +21 -8
  385. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  386. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  387. package/src/containers/settings-row/settings-row.tsx +7 -2
  388. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  389. package/src/containers/stack/stack.tsx +2 -2
  390. package/src/containers/table/table.tsx +35 -14
  391. package/src/containers/timeline/timeline.tsx +17 -3
  392. package/src/containers/toolbar/toolbar.tsx +3 -3
  393. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  394. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  395. package/src/forms/chip-group/chip-group.tsx +23 -2
  396. package/src/forms/combobox/combobox.tsx +15 -4
  397. package/src/forms/copy-field/copy-field.tsx +11 -2
  398. package/src/forms/date-picker/date-picker.tsx +23 -12
  399. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  400. package/src/forms/dropzone/dropzone.tsx +18 -3
  401. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  402. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  403. package/src/forms/field/field.tsx +2 -2
  404. package/src/forms/fieldset/fieldset.tsx +2 -2
  405. package/src/forms/form/form.tsx +13 -5
  406. package/src/forms/form-footer/form-footer.tsx +2 -2
  407. package/src/forms/form-grid/form-grid.tsx +3 -3
  408. package/src/forms/form-section/form-section.tsx +2 -2
  409. package/src/forms/inline-select/inline-select.tsx +14 -3
  410. package/src/forms/input/input.tsx +14 -3
  411. package/src/forms/internal/button-option.tsx +2 -0
  412. package/src/forms/label/label.tsx +2 -2
  413. package/src/forms/native-select/native-select.tsx +9 -2
  414. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  415. package/src/forms/password-input/password-input.tsx +12 -0
  416. package/src/forms/pin-input/pin-input.tsx +9 -1
  417. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  418. package/src/forms/rating/rating.tsx +14 -1
  419. package/src/forms/select/select.tsx +14 -4
  420. package/src/forms/select-menu/select-menu.tsx +15 -4
  421. package/src/forms/slider/model.ts +5 -0
  422. package/src/forms/slider/slider.tsx +13 -3
  423. package/src/forms/textarea/textarea.tsx +7 -4
  424. package/src/forms/time-input/time-input.tsx +19 -5
  425. package/src/i18n/strings.ts +18 -0
  426. package/src/intent/attributes.ts +96 -0
  427. package/src/intent/bridge.tsx +25 -0
  428. package/src/intent/index.ts +24 -0
  429. package/src/intent/target-registrations.ts +127 -0
  430. package/src/intent/types.ts +44 -0
  431. package/src/intent/use-intent-target.ts +96 -0
  432. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  433. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  434. package/src/navigation/floating-toc/model.ts +3 -1
  435. package/src/navigation/segmented/segmented.tsx +14 -2
  436. package/src/navigation/stepper/stepper.tsx +7 -2
  437. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  438. package/src/navigation/tabs/tabs.tsx +57 -4
  439. package/src/navigation/wizard/wizard.tsx +12 -4
  440. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  441. package/src/overlays/context-menu/context-menu.tsx +58 -11
  442. package/src/overlays/dialog/dialog.tsx +49 -20
  443. package/src/overlays/drawer/drawer.tsx +15 -4
  444. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  445. package/src/overlays/hover-card/hover-card.tsx +13 -2
  446. package/src/overlays/popover/popover.tsx +12 -1
  447. package/src/overlays/tooltip/model.ts +8 -0
  448. package/src/overlays/tooltip/tooltip.tsx +15 -2
  449. package/src/palette/command-palette/command-palette.tsx +66 -3
  450. package/src/palette/command-palette/index.ts +1 -0
  451. package/src/palette/command-palette/model.ts +15 -0
  452. package/src/primitives/command/command.tsx +4 -1
  453. package/src/primitives/dialog/dialog.tsx +1 -4
  454. package/src/primitives/popper/popper.tsx +16 -5
  455. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  456. package/src/shell/sidebar/sidebar.tsx +22 -4
  457. package/src/shell/topbar/topbar.tsx +2 -2
  458. package/src/showcase/bento.tsx +2 -0
  459. package/src/utils/is-production.ts +3 -0
  460. package/src/utils/slot.tsx +21 -3
  461. package/styles/base.css +39 -0
@@ -16,9 +16,11 @@ import { Button, type ButtonProps } from "../../atoms/button/button.js";
16
16
  import type { ConfirmResult } from "../../containers/confirm-action/model.js";
17
17
  import { runConfirm } from "../../containers/confirm-action/model.js";
18
18
  import { useUiStrings } from "../../i18n/index.js";
19
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
19
20
  import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
20
21
  import type { ClassNames } from "../../utils/class-names.js";
21
22
  import { cn } from "../../utils/cn.js";
23
+ import { useComposedRefs } from "../../utils/compose.js";
22
24
  import { type Material, materialClass } from "../../utils/material.js";
23
25
  import { DIALOG_MOTION, OVERLAY_MOTION } from "../../utils/overlay-motion.js";
24
26
  import { useControllableState } from "../../utils/use-controllable-state.js";
@@ -43,7 +45,7 @@ export type AlertDialogPart =
43
45
  | "cancel"
44
46
  | "confirm";
45
47
 
46
- export interface AlertDialogProps {
48
+ export interface AlertDialogProps extends IntentProps {
47
49
  open?: boolean;
48
50
  defaultOpen?: boolean;
49
51
  onOpenChange?: (open: boolean) => void;
@@ -111,6 +113,8 @@ export function AlertDialog({
111
113
  container,
112
114
  className,
113
115
  classNames,
116
+ intent,
117
+ intentKey,
114
118
  }: AlertDialogProps) {
115
119
  const strings = useUiStrings();
116
120
  const [open, setOpen] = useControllableState({
@@ -184,6 +188,8 @@ export function AlertDialog({
184
188
  container={container}
185
189
  className={className}
186
190
  classNames={classNames}
191
+ intent={intent}
192
+ intentKey={intentKey}
187
193
  onEscape={(event) => {
188
194
  if (pendingRef.current) event.preventDefault();
189
195
  else onCancel?.();
@@ -255,7 +261,7 @@ export function AlertDialog({
255
261
  );
256
262
  }
257
263
 
258
- interface AlertDialogPanelProps {
264
+ interface AlertDialogPanelProps extends IntentProps {
259
265
  children: ReactNode;
260
266
  panelRef: RefObject<HTMLDivElement | null>;
261
267
  material: Material | undefined;
@@ -273,18 +279,25 @@ function AlertDialogPanel({
273
279
  container,
274
280
  className,
275
281
  classNames,
282
+ intent,
283
+ intentKey,
276
284
  onEscape,
277
285
  onOpenAutoFocus,
278
286
  }: AlertDialogPanelProps) {
279
287
  const previousFocusRef = usePreviousFocus();
288
+ const composedRef = useComposedRefs<HTMLDivElement>(
289
+ panelRef,
290
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "alertdialog" }),
291
+ );
280
292
  return (
281
293
  <DialogPrimitive.Portal container={container}>
282
294
  <DialogPrimitive.Overlay
283
295
  className={cn("fixed inset-0 z-70 bg-scrim", OVERLAY_MOTION, classNames?.overlay)}
284
296
  />
285
297
  <DialogPrimitive.Content
286
- ref={panelRef}
298
+ ref={composedRef}
287
299
  role="alertdialog"
300
+ {...intentAttributes({ intent, intentKey })}
288
301
  onEscapeKeyDown={onEscape}
289
302
  // Answered with the buttons: pressing outside never answers for the user.
290
303
  onPointerDownOutside={(event) => event.preventDefault()}
@@ -348,7 +361,7 @@ function AlertDialogTrigger(props: ComponentProps<typeof DialogPrimitive.Trigger
348
361
  return <DialogPrimitive.Trigger {...props} />;
349
362
  }
350
363
 
351
- export interface AlertDialogContentProps {
364
+ export interface AlertDialogContentProps extends IntentProps {
352
365
  children?: ReactNode;
353
366
  material?: Material;
354
367
  container?: HTMLElement | null;
@@ -364,6 +377,8 @@ function AlertDialogContent({
364
377
  container,
365
378
  className,
366
379
  classNames,
380
+ intent,
381
+ intentKey,
367
382
  }: AlertDialogContentProps) {
368
383
  const cancelRef = useContext(CancelRefContext);
369
384
  const panelRef = useRef<HTMLDivElement>(null);
@@ -374,6 +389,8 @@ function AlertDialogContent({
374
389
  container={container}
375
390
  className={className}
376
391
  classNames={classNames}
392
+ intent={intent}
393
+ intentKey={intentKey}
377
394
  onEscape={() => {}}
378
395
  onOpenAutoFocus={(event) => {
379
396
  if (!cancelRef?.current) return;
@@ -1,9 +1,8 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  createContext,
6
- type HTMLAttributes,
7
6
  type KeyboardEvent,
8
7
  type PointerEvent,
9
8
  type ReactNode,
@@ -15,8 +14,10 @@ import {
15
14
  useState,
16
15
  } from "react";
17
16
  import { Check } from "../../icons/index.js";
17
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
18
18
  import * as MenuPrimitive from "../../primitives/menu/menu.js";
19
19
  import { cn } from "../../utils/cn.js";
20
+ import { useComposedRefs } from "../../utils/compose.js";
20
21
  import { type Material, materialClass } from "../../utils/material.js";
21
22
  import { ITEM_MOTION, POPPER_MOTION } from "../../utils/overlay-motion.js";
22
23
 
@@ -95,7 +96,7 @@ export function ContextMenu({
95
96
  );
96
97
  }
97
98
 
98
- export interface ContextMenuTriggerProps extends HTMLAttributes<HTMLDivElement> {
99
+ export interface ContextMenuTriggerProps extends ComponentPropsWithRef<"div">, IntentProps {
99
100
  disabled?: boolean;
100
101
  }
101
102
 
@@ -108,12 +109,19 @@ export function ContextMenuTrigger({
108
109
  onPointerMove,
109
110
  onPointerUp,
110
111
  onPointerCancel,
112
+ intent,
113
+ intentKey,
114
+ ref,
111
115
  ...props
112
116
  }: ContextMenuTriggerProps) {
113
117
  const menu = useContext(ContextMenuContext);
114
118
  if (!menu) throw new Error("ContextMenuTrigger must be inside ContextMenu");
115
119
  const press = useRef<number | undefined>(undefined);
116
120
  const clearPress = () => window.clearTimeout(press.current);
121
+ const composedRef = useComposedRefs<HTMLDivElement>(
122
+ ref,
123
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }),
124
+ );
117
125
  useEffect(() => () => window.clearTimeout(press.current), []);
118
126
 
119
127
  return (
@@ -153,13 +161,16 @@ export function ContextMenuTrigger({
153
161
  onPointerCancel?.(event);
154
162
  clearPress();
155
163
  }}
164
+ {...intentAttributes({ intent, intentKey })}
156
165
  {...props}
166
+ ref={composedRef}
157
167
  />
158
168
  );
159
169
  }
160
170
 
161
171
  export interface ContextMenuContentProps
162
- extends Omit<MenuPrimitive.MenuContentProps, "side" | "align"> {
172
+ extends Omit<MenuPrimitive.MenuContentProps, "side" | "align">,
173
+ IntentProps {
163
174
  /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
164
175
  container?: HTMLElement | null;
165
176
  /**
@@ -177,8 +188,15 @@ export function ContextMenuContent({
177
188
  material,
178
189
  collisionPadding = 8,
179
190
  onCloseAutoFocus,
191
+ intent,
192
+ intentKey,
193
+ ref,
180
194
  ...props
181
195
  }: ContextMenuContentProps) {
196
+ const composedRef = useComposedRefs<HTMLDivElement>(
197
+ ref,
198
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menu" }),
199
+ );
182
200
  return (
183
201
  <MenuPrimitive.Portal container={container}>
184
202
  <MenuPrimitive.Content
@@ -197,7 +215,9 @@ export function ContextMenuContent({
197
215
  materialClass(material, "surface-solid"),
198
216
  className,
199
217
  )}
218
+ {...intentAttributes({ intent, intentKey })}
200
219
  {...props}
220
+ ref={composedRef}
201
221
  />
202
222
  </MenuPrimitive.Portal>
203
223
  );
@@ -205,29 +225,56 @@ export function ContextMenuContent({
205
225
 
206
226
  const itemBase = `relative flex min-h-control-sm w-full cursor-pointer select-none items-center gap-density-sm rounded-button px-control-x text-body outline-none data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-surface-2 [&_svg]:size-4 [&_svg]:shrink-0 ${ITEM_MOTION}`;
207
227
 
208
- export interface ContextMenuItemProps extends MenuPrimitive.MenuItemProps {
228
+ export interface ContextMenuItemProps extends MenuPrimitive.MenuItemProps, IntentProps {
209
229
  /** Destructive action styling. */
210
230
  tone?: "default" | "danger";
211
231
  }
212
232
 
213
- export function ContextMenuItem({ className, tone = "default", ...props }: ContextMenuItemProps) {
233
+ export function ContextMenuItem({
234
+ className,
235
+ tone = "default",
236
+ intent,
237
+ intentKey,
238
+ ref,
239
+ ...props
240
+ }: ContextMenuItemProps) {
241
+ const composedRef = useComposedRefs<HTMLDivElement>(
242
+ ref,
243
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitem" }),
244
+ );
214
245
  return (
215
246
  <MenuPrimitive.Item
216
247
  className={cn(itemBase, tone === "danger" ? "text-danger" : "text-ink", className)}
248
+ {...intentAttributes({ intent, intentKey })}
217
249
  {...props}
250
+ ref={composedRef}
218
251
  />
219
252
  );
220
253
  }
221
254
 
222
- export type ContextMenuCheckboxItemProps = MenuPrimitive.MenuCheckboxItemProps;
255
+ export interface ContextMenuCheckboxItemProps
256
+ extends MenuPrimitive.MenuCheckboxItemProps,
257
+ IntentProps {}
223
258
 
224
259
  export function ContextMenuCheckboxItem({
225
260
  className,
226
261
  children,
262
+ intent,
263
+ intentKey,
264
+ ref,
227
265
  ...props
228
266
  }: ContextMenuCheckboxItemProps) {
267
+ const composedRef = useComposedRefs<HTMLDivElement>(
268
+ ref,
269
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitemcheckbox" }),
270
+ );
229
271
  return (
230
- <MenuPrimitive.CheckboxItem className={cn(itemBase, "ps-8 text-ink", className)} {...props}>
272
+ <MenuPrimitive.CheckboxItem
273
+ className={cn(itemBase, "ps-8 text-ink", className)}
274
+ {...intentAttributes({ intent, intentKey })}
275
+ {...props}
276
+ ref={composedRef}
277
+ >
231
278
  <span className="absolute inset-s-2 flex size-4 items-center justify-center">
232
279
  <MenuPrimitive.ItemIndicator>
233
280
  <Check aria-hidden="true" />
@@ -238,7 +285,7 @@ export function ContextMenuCheckboxItem({
238
285
  );
239
286
  }
240
287
 
241
- export function ContextMenuLabel({ className, ...props }: HTMLAttributes<HTMLDivElement>) {
288
+ export function ContextMenuLabel({ className, ...props }: ComponentPropsWithRef<"div">) {
242
289
  return (
243
290
  <div
244
291
  className={cn("px-control-x pt-1.5 pb-1 text-ink-3 text-overline uppercase", className)}
@@ -247,12 +294,12 @@ export function ContextMenuLabel({ className, ...props }: HTMLAttributes<HTMLDiv
247
294
  );
248
295
  }
249
296
 
250
- export function ContextMenuSeparator({ className, ...props }: ComponentPropsWithoutRef<"div">) {
297
+ export function ContextMenuSeparator({ className, ...props }: ComponentPropsWithRef<"div">) {
251
298
  return <MenuPrimitive.Separator className={cn("my-1 h-px bg-divider", className)} {...props} />;
252
299
  }
253
300
 
254
301
  /** Right-aligned hint such as "Ctrl+D"; purely visual. */
255
- export function ContextMenuShortcut({ className, ...props }: HTMLAttributes<HTMLSpanElement>) {
302
+ export function ContextMenuShortcut({ className, ...props }: ComponentPropsWithRef<"span">) {
256
303
  return (
257
304
  <span
258
305
  className={cn("ms-auto ps-density text-ink-3 text-meta tracking-wide", className)}
@@ -1,11 +1,13 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef, HTMLAttributes } from "react";
3
+ import type { ComponentPropsWithRef } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { X } from "../../icons/index.js";
6
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
6
7
  import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
7
8
  import type { ClassNames } from "../../utils/class-names.js";
8
9
  import { cn } from "../../utils/cn.js";
10
+ import { useComposedRefs } from "../../utils/compose.js";
9
11
  import { type Material, materialClass } from "../../utils/material.js";
10
12
  import { DIALOG_MOTION, OVERLAY_MOTION } from "../../utils/overlay-motion.js";
11
13
  import {
@@ -40,7 +42,7 @@ const widthClasses: Record<DialogWidth, string> = {
40
42
 
41
43
  export type DialogContentPart = "root" | "overlay" | "close";
42
44
 
43
- export interface DialogContentProps extends DialogPrimitive.DialogContentProps {
45
+ export interface DialogContentProps extends DialogPrimitive.DialogContentProps, IntentProps {
44
46
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the content and is merged last. */
45
47
  classNames?: ClassNames<DialogContentPart>;
46
48
  width?: DialogWidth;
@@ -62,6 +64,11 @@ export interface DialogContentProps extends DialogPrimitive.DialogContentProps {
62
64
  container?: HTMLElement | null;
63
65
  }
64
66
 
67
+ /**
68
+ * Keep it a flex column (the default): the sticky close anchor and the pinned `DialogHeader` and
69
+ * `DialogFooter` rely on it. A wrapper between them and this element, such as a `<form>`, needs
70
+ * `flex min-h-0 flex-col` too.
71
+ */
65
72
  export function DialogContent({
66
73
  className,
67
74
  classNames,
@@ -75,9 +82,16 @@ export function DialogContent({
75
82
  onPointerDownOutside,
76
83
  onInteractOutside,
77
84
  onCloseAutoFocus,
85
+ intent,
86
+ intentKey,
87
+ ref,
78
88
  ...props
79
89
  }: DialogContentProps) {
80
90
  const previousFocusRef = usePreviousFocus();
91
+ const composedRef = useComposedRefs<HTMLDivElement>(
92
+ ref,
93
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "dialog" }),
94
+ );
81
95
  const strings = useUiStrings();
82
96
  return (
83
97
  <DialogPrimitive.Portal container={container}>
@@ -109,20 +123,27 @@ export function DialogContent({
109
123
  onCloseAutoFocus?.(event);
110
124
  restoreFocusOnClose(event, previousFocusRef);
111
125
  }}
126
+ {...intentAttributes({ intent, intentKey })}
112
127
  {...props}
128
+ ref={composedRef}
113
129
  >
114
130
  {children}
115
131
  {!blocking && (
116
- <DialogPrimitive.Close
117
- aria-label={closeLabel ?? strings.close}
118
- className={cn(
119
- // A 30px square (44px under touch) centred where the 24px button was, so the glyph stays put.
120
- "absolute top-[calc(0.5625rem-0.4375rem*var(--touch))] right-[calc(0.5625rem-0.4375rem*var(--touch))] flex size-control-sm items-center justify-center rounded-event text-ink-3 hover:text-ink",
121
- classNames?.close,
122
- )}
123
- >
124
- <X aria-hidden="true" className="size-4" />
125
- </DialogPrimitive.Close>
132
+ // Zero-height sticky anchor: content that scrolls inside the dialog (anything not wrapped
133
+ // in `DialogBody`) cannot carry the close button away. `order-first` is visual only; the
134
+ // button stays last in the DOM and in the tab order.
135
+ <div className="pointer-events-none sticky top-0 z-10 order-first h-0 shrink-0">
136
+ <DialogPrimitive.Close
137
+ aria-label={closeLabel ?? strings.close}
138
+ className={cn(
139
+ // A 30px square (44px under touch) centred where the 24px button was, so the glyph stays put.
140
+ "pointer-events-auto absolute top-[calc(0.5625rem-0.4375rem*var(--touch))] right-[calc(0.5625rem-0.4375rem*var(--touch))] flex size-control-sm items-center justify-center rounded-event text-ink-3 hover:text-ink",
141
+ classNames?.close,
142
+ )}
143
+ >
144
+ <X aria-hidden="true" className="size-4" />
145
+ </DialogPrimitive.Close>
146
+ </div>
126
147
  )}
127
148
  </DialogPrimitive.Content>
128
149
  </DialogPrimitive.Portal>
@@ -130,10 +151,10 @@ export function DialogContent({
130
151
  }
131
152
 
132
153
  /** Title above description at every width; pass `flex-row items-center` in `className` for a side-by-side layout. */
133
- export function DialogHeader({ className, ...props }: HTMLAttributes<HTMLDivElement>) {
154
+ export function DialogHeader({ className, ...props }: ComponentPropsWithRef<"div">) {
134
155
  return (
135
156
  <div
136
- className={cn("flex flex-col gap-1 border-b-divider py-3.5 pr-10 pl-4.5", className)}
157
+ className={cn("flex shrink-0 flex-col gap-1 border-b-divider py-3.5 pr-10 pl-4.5", className)}
137
158
  {...props}
138
159
  />
139
160
  );
@@ -142,7 +163,7 @@ export function DialogHeader({ className, ...props }: HTMLAttributes<HTMLDivElem
142
163
  export function DialogTitle({
143
164
  className,
144
165
  ...props
145
- }: ComponentPropsWithoutRef<typeof DialogPrimitive.Title>) {
166
+ }: ComponentPropsWithRef<typeof DialogPrimitive.Title>) {
146
167
  return (
147
168
  <DialogPrimitive.Title
148
169
  className={cn("m-0 min-w-0 break-words text-dialog-title text-ink", className)}
@@ -154,19 +175,27 @@ export function DialogTitle({
154
175
  export function DialogDescription({
155
176
  className,
156
177
  ...props
157
- }: ComponentPropsWithoutRef<typeof DialogPrimitive.Description>) {
178
+ }: ComponentPropsWithRef<typeof DialogPrimitive.Description>) {
158
179
  return <DialogPrimitive.Description className={cn("m-0 text-ink-2", className)} {...props} />;
159
180
  }
160
181
 
161
- export function DialogBody({ className, ...props }: HTMLAttributes<HTMLDivElement>) {
162
- return <div className={cn("flex flex-col gap-4 p-4.5", className)} {...props} />;
182
+ export function DialogBody({ className, ...props }: ComponentPropsWithRef<"div">) {
183
+ return (
184
+ <div
185
+ className={cn(
186
+ "flex min-h-0 flex-1 flex-col gap-4 overflow-y-auto overscroll-contain p-4.5",
187
+ className,
188
+ )}
189
+ {...props}
190
+ />
191
+ );
163
192
  }
164
193
 
165
- export function DialogFooter({ className, ...props }: HTMLAttributes<HTMLDivElement>) {
194
+ export function DialogFooter({ className, ...props }: ComponentPropsWithRef<"div">) {
166
195
  return (
167
196
  <div
168
197
  className={cn(
169
- "flex flex-wrap items-center gap-2 border-t-divider px-4.5 py-3",
198
+ "flex shrink-0 flex-wrap items-center gap-2 border-t-divider px-4.5 py-3 pb-[max(0.75rem,env(safe-area-inset-bottom))]",
170
199
  "@max-sm/dialog:flex-col-reverse @max-sm/dialog:items-stretch @max-sm/dialog:[&>*]:w-full",
171
200
  className,
172
201
  )}
@@ -1,11 +1,13 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, type PointerEvent, useRef } from "react";
3
+ import { type ComponentPropsWithRef, type PointerEvent, useRef } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { X } from "../../icons/index.js";
6
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
6
7
  import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
7
8
  import type { ClassNames } from "../../utils/class-names.js";
8
9
  import { cn } from "../../utils/cn.js";
10
+ import { useComposedRefs } from "../../utils/compose.js";
9
11
  import { type Material, materialClass } from "../../utils/material.js";
10
12
  import { DRAWER_MOTION, OVERLAY_MOTION, SHEET_MOTION } from "../../utils/overlay-motion.js";
11
13
  import {
@@ -33,13 +35,13 @@ export const DrawerClose = DialogPrimitive.Close;
33
35
  export function DrawerTitle({
34
36
  className,
35
37
  ...props
36
- }: ComponentPropsWithoutRef<typeof DialogPrimitive.Title>) {
38
+ }: ComponentPropsWithRef<typeof DialogPrimitive.Title>) {
37
39
  return <DialogPrimitive.Title className={cn("m-0", className)} {...props} />;
38
40
  }
39
41
  export function DrawerDescription({
40
42
  className,
41
43
  ...props
42
- }: ComponentPropsWithoutRef<typeof DialogPrimitive.Description>) {
44
+ }: ComponentPropsWithRef<typeof DialogPrimitive.Description>) {
43
45
  return <DialogPrimitive.Description className={cn("m-0 text-ink-2", className)} {...props} />;
44
46
  }
45
47
 
@@ -60,7 +62,7 @@ export function drawerSideClass(side: DrawerSide): string {
60
62
  return sideClasses[side];
61
63
  }
62
64
 
63
- export interface DrawerContentProps extends DialogPrimitive.DialogContentProps {
65
+ export interface DrawerContentProps extends DialogPrimitive.DialogContentProps, IntentProps {
64
66
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the content and is merged last. */
65
67
  classNames?: ClassNames<DrawerContentPart>;
66
68
  /**
@@ -101,9 +103,16 @@ export function DrawerContent({
101
103
  onPointerDownOutside,
102
104
  onInteractOutside,
103
105
  onCloseAutoFocus,
106
+ intent,
107
+ intentKey,
108
+ ref,
104
109
  ...props
105
110
  }: DrawerContentProps) {
106
111
  const previousFocusRef = usePreviousFocus();
112
+ const composedRef = useComposedRefs<HTMLDivElement>(
113
+ ref,
114
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "dialog" }),
115
+ );
107
116
  const strings = useUiStrings();
108
117
  const closeRef = useRef<HTMLButtonElement>(null);
109
118
  const swipe = useRef<number | null>(null);
@@ -150,7 +159,9 @@ export function DrawerContent({
150
159
  onCloseAutoFocus?.(event);
151
160
  restoreFocusOnClose(event, previousFocusRef);
152
161
  }}
162
+ {...intentAttributes({ intent, intentKey })}
153
163
  {...props}
164
+ ref={composedRef}
154
165
  >
155
166
  {showHandle ? (
156
167
  <div
@@ -1,9 +1,11 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef, HTMLAttributes } from "react";
3
+ import type { ComponentPropsWithRef } from "react";
4
4
  import { Check, ChevronRight } from "../../icons/index.js";
5
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
5
6
  import * as MenuPrimitive from "../../primitives/menu/menu.js";
6
7
  import { cn } from "../../utils/cn.js";
8
+ import { useComposedRefs } from "../../utils/compose.js";
7
9
  import { type Material, materialClass } from "../../utils/material.js";
8
10
  import { ITEM_MOTION, POPPER_MOTION } from "../../utils/overlay-motion.js";
9
11
 
@@ -33,7 +35,7 @@ export const dropdownMenuItemClasses =
33
35
  const surface = `${placement} ${POPPER_MOTION} ${dropdownMenuSurfaceClasses}`;
34
36
  const itemBase = `${dropdownMenuItemClasses} ${ITEM_MOTION}`;
35
37
 
36
- export interface DropdownMenuContentProps extends MenuPrimitive.MenuContentProps {
38
+ export interface DropdownMenuContentProps extends MenuPrimitive.MenuContentProps, IntentProps {
37
39
  /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
38
40
  container?: HTMLElement | null;
39
41
  /**
@@ -59,8 +61,15 @@ export function DropdownMenuContent({
59
61
  container,
60
62
  material,
61
63
  bare = false,
64
+ intent,
65
+ intentKey,
66
+ ref,
62
67
  ...props
63
68
  }: DropdownMenuContentProps) {
69
+ const composedRef = useComposedRefs<HTMLDivElement>(
70
+ ref,
71
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menu" }),
72
+ );
64
73
  return (
65
74
  <MenuPrimitive.Portal container={container}>
66
75
  <MenuPrimitive.Content
@@ -71,15 +80,27 @@ export function DropdownMenuContent({
71
80
  ? cn(placement, POPPER_MOTION, className)
72
81
  : cn(surface, materialClass(material, "surface-solid"), className)
73
82
  }
83
+ {...intentAttributes({ intent, intentKey })}
74
84
  {...props}
85
+ ref={composedRef}
75
86
  />
76
87
  </MenuPrimitive.Portal>
77
88
  );
78
89
  }
79
90
 
80
- export interface DropdownMenuItemProps extends MenuPrimitive.MenuItemProps {}
91
+ export interface DropdownMenuItemProps extends MenuPrimitive.MenuItemProps, IntentProps {}
81
92
 
82
- export function DropdownMenuItem({ className, ...props }: DropdownMenuItemProps) {
93
+ export function DropdownMenuItem({
94
+ className,
95
+ intent,
96
+ intentKey,
97
+ ref,
98
+ ...props
99
+ }: DropdownMenuItemProps) {
100
+ const composedRef = useComposedRefs<HTMLDivElement>(
101
+ ref,
102
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitem" }),
103
+ );
83
104
  return (
84
105
  <MenuPrimitive.Item
85
106
  className={cn(
@@ -87,18 +108,29 @@ export function DropdownMenuItem({ className, ...props }: DropdownMenuItemProps)
87
108
  "data-disabled:pointer-events-none data-disabled:opacity-50",
88
109
  className,
89
110
  )}
111
+ {...intentAttributes({ intent, intentKey })}
90
112
  {...props}
113
+ ref={composedRef}
91
114
  />
92
115
  );
93
116
  }
94
117
 
95
- export interface DropdownMenuCheckboxItemProps extends MenuPrimitive.MenuCheckboxItemProps {}
118
+ export interface DropdownMenuCheckboxItemProps
119
+ extends MenuPrimitive.MenuCheckboxItemProps,
120
+ IntentProps {}
96
121
 
97
122
  export function DropdownMenuCheckboxItem({
98
123
  className,
99
124
  children,
125
+ intent,
126
+ intentKey,
127
+ ref,
100
128
  ...props
101
129
  }: DropdownMenuCheckboxItemProps) {
130
+ const composedRef = useComposedRefs<HTMLDivElement>(
131
+ ref,
132
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitemcheckbox" }),
133
+ );
102
134
  return (
103
135
  <MenuPrimitive.CheckboxItem
104
136
  className={cn(
@@ -106,7 +138,9 @@ export function DropdownMenuCheckboxItem({
106
138
  "relative ps-8 data-disabled:pointer-events-none data-disabled:opacity-50",
107
139
  className,
108
140
  )}
141
+ {...intentAttributes({ intent, intentKey })}
109
142
  {...props}
143
+ ref={composedRef}
110
144
  >
111
145
  <span className="absolute inset-s-2 flex size-4 items-center justify-center">
112
146
  <MenuPrimitive.ItemIndicator>
@@ -118,10 +152,20 @@ export function DropdownMenuCheckboxItem({
118
152
  );
119
153
  }
120
154
 
121
- export interface DropdownMenuRadioItemProps extends MenuPrimitive.MenuRadioItemProps {}
155
+ export interface DropdownMenuRadioItemProps extends MenuPrimitive.MenuRadioItemProps, IntentProps {}
122
156
 
123
157
  /** Exposes `role="menuitemradio"` and `aria-checked`: use it for single-value filters. */
124
- export function DropdownMenuRadioItem({ className, ...props }: DropdownMenuRadioItemProps) {
158
+ export function DropdownMenuRadioItem({
159
+ className,
160
+ intent,
161
+ intentKey,
162
+ ref,
163
+ ...props
164
+ }: DropdownMenuRadioItemProps) {
165
+ const composedRef = useComposedRefs<HTMLDivElement>(
166
+ ref,
167
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitemradio" }),
168
+ );
125
169
  return (
126
170
  <MenuPrimitive.RadioItem
127
171
  className={cn(
@@ -129,12 +173,14 @@ export function DropdownMenuRadioItem({ className, ...props }: DropdownMenuRadio
129
173
  "data-[state=checked]:font-bold data-[state=checked]:text-accent-ink",
130
174
  className,
131
175
  )}
176
+ {...intentAttributes({ intent, intentKey })}
132
177
  {...props}
178
+ ref={composedRef}
133
179
  />
134
180
  );
135
181
  }
136
182
 
137
- export function DropdownMenuLabel({ className, ...props }: HTMLAttributes<HTMLDivElement>) {
183
+ export function DropdownMenuLabel({ className, ...props }: ComponentPropsWithRef<"div">) {
138
184
  return (
139
185
  <MenuPrimitive.Label
140
186
  className={cn("px-2.5 pt-1.5 pb-1 text-overline text-ink-3", className)}
@@ -143,7 +189,7 @@ export function DropdownMenuLabel({ className, ...props }: HTMLAttributes<HTMLDi
143
189
  );
144
190
  }
145
191
 
146
- export interface DropdownMenuSeparatorProps extends ComponentPropsWithoutRef<"div"> {}
192
+ export interface DropdownMenuSeparatorProps extends ComponentPropsWithRef<"div"> {}
147
193
 
148
194
  export function DropdownMenuSeparator({ className, ...props }: DropdownMenuSeparatorProps) {
149
195
  return (
@@ -151,14 +197,23 @@ export function DropdownMenuSeparator({ className, ...props }: DropdownMenuSepar
151
197
  );
152
198
  }
153
199
 
154
- export interface DropdownMenuSubTriggerProps extends MenuPrimitive.MenuSubTriggerProps {}
200
+ export interface DropdownMenuSubTriggerProps
201
+ extends MenuPrimitive.MenuSubTriggerProps,
202
+ IntentProps {}
155
203
 
156
204
  /** Item that opens a nested menu; the chevron is added after the children. */
157
205
  export function DropdownMenuSubTrigger({
158
206
  className,
159
207
  children,
208
+ intent,
209
+ intentKey,
210
+ ref,
160
211
  ...props
161
212
  }: DropdownMenuSubTriggerProps) {
213
+ const composedRef = useComposedRefs<HTMLDivElement>(
214
+ ref,
215
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitem" }),
216
+ );
162
217
  return (
163
218
  <MenuPrimitive.SubTrigger
164
219
  className={cn(
@@ -166,7 +221,9 @@ export function DropdownMenuSubTrigger({
166
221
  "data-disabled:pointer-events-none data-disabled:opacity-50 data-[state=open]:bg-surface-2",
167
222
  className,
168
223
  )}
224
+ {...intentAttributes({ intent, intentKey })}
169
225
  {...props}
226
+ ref={composedRef}
170
227
  >
171
228
  {children}
172
229
  <ChevronRight aria-hidden="true" className="ms-auto size-4 rtl:rotate-180" />