@jcsoftdev/ui 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (459) hide show
  1. package/CHANGELOG.md +123 -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 +6 -1
  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 +5 -4
  246. package/dist/navigation/tabs/tabs.js +20 -1
  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 +9 -8
  254. package/dist/overlays/dialog/dialog.js +11 -0
  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/showcase/bento.js +1 -0
  280. package/dist/utils/is-production.d.ts +1 -0
  281. package/dist/utils/is-production.js +6 -0
  282. package/dist/utils/slot.js +17 -3
  283. package/package.json +2 -2
  284. package/src/ai/attachment/attachment.tsx +10 -3
  285. package/src/ai/chat-message/chat-message.tsx +10 -2
  286. package/src/ai/code-block/code-block.tsx +2 -2
  287. package/src/ai/conversation/conversation.tsx +2 -2
  288. package/src/ai/internal/disclosure.tsx +1 -1
  289. package/src/ai/internal/icon-action.tsx +14 -4
  290. package/src/ai/message-actions/message-actions.tsx +28 -3
  291. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  292. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  293. package/src/ai/source/source.tsx +17 -3
  294. package/src/ai/tool-call/tool-call.tsx +6 -1
  295. package/src/atoms/big-date/big-date.tsx +2 -2
  296. package/src/atoms/button/button.tsx +11 -1
  297. package/src/atoms/checkbox/checkbox.tsx +40 -21
  298. package/src/atoms/chip/chip.tsx +12 -2
  299. package/src/atoms/divider/divider.tsx +2 -2
  300. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  301. package/src/atoms/elapsed-time/model.ts +57 -0
  302. package/src/atoms/icon-button/icon-button.tsx +3 -1
  303. package/src/atoms/internal/labelled-control.tsx +83 -0
  304. package/src/atoms/number-value/number-value.tsx +2 -2
  305. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  306. package/src/atoms/progress/progress.tsx +2 -2
  307. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  308. package/src/atoms/radio-group/radio-group.tsx +5 -1
  309. package/src/atoms/seal/seal.tsx +2 -2
  310. package/src/atoms/status-pill/status-pill.tsx +1 -1
  311. package/src/atoms/switch/switch.tsx +43 -9
  312. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  313. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  314. package/src/auth/login-form/parts.tsx +2 -2
  315. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  316. package/src/calendar/day-chip/day-chip.tsx +14 -2
  317. package/src/calendar/event-block/event-block.tsx +9 -1
  318. package/src/calendar/internal/grid-navigation.ts +47 -0
  319. package/src/calendar/internal/intent.ts +10 -0
  320. package/src/calendar/internal/month-model.ts +23 -0
  321. package/src/calendar/internal/types.ts +4 -0
  322. package/src/calendar/month-view/month-grid.tsx +248 -0
  323. package/src/calendar/month-view/month-view.tsx +32 -148
  324. package/src/calendar/week-view/week-view.tsx +87 -10
  325. package/src/charts/README.md +10 -0
  326. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  327. package/src/charts/core/breadcrumb.tsx +1 -1
  328. package/src/charts/core/chart-states.tsx +1 -1
  329. package/src/charts/core/distribution/xy-points.tsx +4 -2
  330. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  331. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  332. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  333. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  334. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  335. package/src/containers/action-bar/action-bar.tsx +3 -3
  336. package/src/containers/aside/aside.tsx +3 -3
  337. package/src/containers/banner/banner.tsx +2 -2
  338. package/src/containers/card/card.tsx +7 -5
  339. package/src/containers/carousel/carousel.tsx +4 -4
  340. package/src/containers/cols/cols.tsx +3 -3
  341. package/src/containers/comment/comment.tsx +2 -2
  342. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  343. package/src/containers/dashboard/dashboard.tsx +4 -4
  344. package/src/containers/data-grid/column-menu.tsx +1 -1
  345. package/src/containers/data-grid/data-grid.tsx +53 -4
  346. package/src/containers/data-grid/formula-bar.tsx +1 -1
  347. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  348. package/src/containers/data-grid/tool-panel.tsx +1 -1
  349. package/src/containers/description-list/description-list.tsx +2 -2
  350. package/src/containers/detail-header/detail-header.tsx +2 -2
  351. package/src/containers/facts/facts.tsx +2 -2
  352. package/src/containers/feed/feed.tsx +16 -3
  353. package/src/containers/file-tree/file-tree.tsx +11 -0
  354. package/src/containers/file-tree/model.ts +2 -0
  355. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  356. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  357. package/src/containers/floor-plan/index.ts +7 -1
  358. package/src/containers/floor-plan/model.ts +16 -0
  359. package/src/containers/generic-row/generic-row.tsx +9 -6
  360. package/src/containers/grid/grid.tsx +2 -2
  361. package/src/containers/hbars/hbars.tsx +23 -21
  362. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  363. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  364. package/src/containers/kanban/kanban.tsx +13 -0
  365. package/src/containers/kanban/model.ts +2 -0
  366. package/src/containers/kpi/kpi-model.ts +37 -0
  367. package/src/containers/kpi/kpi-parts.tsx +153 -0
  368. package/src/containers/kpi/kpi.tsx +10 -176
  369. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  370. package/src/containers/list-detail/list-detail.tsx +22 -12
  371. package/src/containers/note/note.tsx +2 -2
  372. package/src/containers/order-ticket/index.ts +2 -0
  373. package/src/containers/order-ticket/model.ts +21 -0
  374. package/src/containers/order-ticket/order-ticket.tsx +30 -13
  375. package/src/containers/page/page.tsx +2 -2
  376. package/src/containers/page-header/back.tsx +2 -2
  377. package/src/containers/page-header/page-header.tsx +6 -6
  378. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  379. package/src/containers/pagination/pagination.tsx +4 -4
  380. package/src/containers/resizable/resizable.tsx +7 -5
  381. package/src/containers/row-actions/row-actions.tsx +18 -3
  382. package/src/containers/scrolly/scrolly.tsx +1 -1
  383. package/src/containers/section/section.tsx +21 -8
  384. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  385. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  386. package/src/containers/settings-row/settings-row.tsx +7 -2
  387. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  388. package/src/containers/stack/stack.tsx +2 -2
  389. package/src/containers/table/table.tsx +35 -14
  390. package/src/containers/timeline/timeline.tsx +17 -3
  391. package/src/containers/toolbar/toolbar.tsx +3 -3
  392. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  393. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  394. package/src/forms/chip-group/chip-group.tsx +23 -2
  395. package/src/forms/combobox/combobox.tsx +15 -4
  396. package/src/forms/copy-field/copy-field.tsx +11 -2
  397. package/src/forms/date-picker/date-picker.tsx +23 -12
  398. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  399. package/src/forms/dropzone/dropzone.tsx +18 -3
  400. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  401. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  402. package/src/forms/field/field.tsx +2 -2
  403. package/src/forms/fieldset/fieldset.tsx +2 -2
  404. package/src/forms/form/form.tsx +13 -5
  405. package/src/forms/form-footer/form-footer.tsx +2 -2
  406. package/src/forms/form-grid/form-grid.tsx +3 -3
  407. package/src/forms/form-section/form-section.tsx +2 -2
  408. package/src/forms/inline-select/inline-select.tsx +14 -3
  409. package/src/forms/input/input.tsx +8 -2
  410. package/src/forms/internal/button-option.tsx +2 -0
  411. package/src/forms/label/label.tsx +2 -2
  412. package/src/forms/native-select/native-select.tsx +9 -2
  413. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  414. package/src/forms/password-input/password-input.tsx +12 -0
  415. package/src/forms/pin-input/pin-input.tsx +9 -1
  416. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  417. package/src/forms/rating/rating.tsx +14 -1
  418. package/src/forms/select/select.tsx +14 -4
  419. package/src/forms/select-menu/select-menu.tsx +15 -4
  420. package/src/forms/slider/model.ts +5 -0
  421. package/src/forms/slider/slider.tsx +13 -3
  422. package/src/forms/textarea/textarea.tsx +7 -4
  423. package/src/forms/time-input/time-input.tsx +19 -5
  424. package/src/i18n/strings.ts +18 -0
  425. package/src/intent/attributes.ts +96 -0
  426. package/src/intent/bridge.tsx +25 -0
  427. package/src/intent/index.ts +24 -0
  428. package/src/intent/target-registrations.ts +127 -0
  429. package/src/intent/types.ts +44 -0
  430. package/src/intent/use-intent-target.ts +96 -0
  431. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  432. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  433. package/src/navigation/floating-toc/model.ts +3 -1
  434. package/src/navigation/segmented/segmented.tsx +14 -2
  435. package/src/navigation/stepper/stepper.tsx +7 -2
  436. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  437. package/src/navigation/tabs/tabs.tsx +24 -3
  438. package/src/navigation/wizard/wizard.tsx +12 -4
  439. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  440. package/src/overlays/context-menu/context-menu.tsx +58 -11
  441. package/src/overlays/dialog/dialog.tsx +18 -7
  442. package/src/overlays/drawer/drawer.tsx +15 -4
  443. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  444. package/src/overlays/hover-card/hover-card.tsx +13 -2
  445. package/src/overlays/popover/popover.tsx +12 -1
  446. package/src/overlays/tooltip/model.ts +8 -0
  447. package/src/overlays/tooltip/tooltip.tsx +15 -2
  448. package/src/palette/command-palette/command-palette.tsx +66 -3
  449. package/src/palette/command-palette/index.ts +1 -0
  450. package/src/palette/command-palette/model.ts +15 -0
  451. package/src/primitives/command/command.tsx +4 -1
  452. package/src/primitives/dialog/dialog.tsx +1 -4
  453. package/src/primitives/popper/popper.tsx +16 -5
  454. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  455. package/src/shell/sidebar/sidebar.tsx +22 -4
  456. package/src/showcase/bento.tsx +2 -0
  457. package/src/utils/is-production.ts +3 -0
  458. package/src/utils/slot.tsx +21 -3
  459. package/styles/base.css +34 -0
@@ -1,12 +1,14 @@
1
- import type { ComponentPropsWithRef } from "react";
1
+ import type { ComponentPropsWithRef, Ref } from "react";
2
2
  import { useUiStrings } from "../../i18n/index.js";
3
3
  import { Check, X } from "../../icons/index.js";
4
+ import { intentAttributes } from "../../intent/attributes.js";
5
+ import type { IntentProps } from "../../intent/types.js";
4
6
  import type { ClassNames } from "../../utils/class-names.js";
5
7
  import { cn } from "../../utils/cn.js";
6
8
 
7
9
  export type StepStatus = "done" | "current" | "error" | "pending";
8
10
 
9
- export interface Step {
11
+ export interface Step extends IntentProps {
10
12
  id: string;
11
13
  label: string;
12
14
  /**
@@ -16,6 +18,7 @@ export interface Step {
16
18
  * `aria-current="step"` whatever its status.
17
19
  */
18
20
  status?: StepStatus;
21
+ ref?: Ref<HTMLLIElement> | undefined;
19
22
  }
20
23
 
21
24
  const markerStatusClasses: Record<StepStatus, string> = {
@@ -53,6 +56,8 @@ export function Stepper({ steps, currentStepId, className, classNames, ...props
53
56
  return (
54
57
  <li
55
58
  key={step.id}
59
+ {...intentAttributes({ intent: step.intent, intentKey: step.intentKey ?? step.id })}
60
+ ref={step.ref}
56
61
  data-status={status}
57
62
  className={cn("flex min-w-0 items-center gap-1.5", classNames?.step)}
58
63
  >
@@ -2,7 +2,7 @@
2
2
 
3
3
  import {
4
4
  type AnchorHTMLAttributes,
5
- type ComponentPropsWithoutRef,
5
+ type ComponentPropsWithRef,
6
6
  cloneElement,
7
7
  createContext,
8
8
  isValidElement,
@@ -11,7 +11,9 @@ import {
11
11
  type Ref,
12
12
  useContext,
13
13
  } from "react";
14
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
14
15
  import { cn } from "../../utils/cn.js";
16
+ import { useComposedRefs } from "../../utils/compose.js";
15
17
  import { Slot } from "../../utils/slot.js";
16
18
 
17
19
  /** Props handed to `renderLink`: spread them on your router's link component. */
@@ -31,7 +33,7 @@ const TabsNavContext = createContext<TabsNavContextValue>({
31
33
  renderLink: undefined,
32
34
  });
33
35
 
34
- export interface TabsNavProps extends ComponentPropsWithoutRef<"nav"> {
36
+ export interface TabsNavProps extends ComponentPropsWithRef<"nav"> {
35
37
  /** Name of the strip (required: a page can have several navigations). */
36
38
  "aria-label": string;
37
39
  /** Value of the item that is the current page. */
@@ -61,7 +63,9 @@ export function TabsNav({ value, renderLink, className, children, ...props }: Ta
61
63
  );
62
64
  }
63
65
 
64
- export interface TabsNavLinkProps extends Omit<ComponentPropsWithoutRef<"a">, "children"> {
66
+ export interface TabsNavLinkProps
67
+ extends Omit<ComponentPropsWithRef<"a">, "children">,
68
+ IntentProps {
65
69
  /** Matches the strip's `value` to mark this item as the current page. */
66
70
  value: string;
67
71
  /** Overrides the match for routers that report the active state themselves. */
@@ -83,12 +87,21 @@ export function TabsNavLink({
83
87
  asChild = false,
84
88
  className,
85
89
  children,
90
+ intent,
91
+ intentKey,
92
+ ref,
86
93
  ...props
87
94
  }: TabsNavLinkProps) {
88
95
  const context = useContext(TabsNavContext);
96
+ const composedRef = useComposedRefs<HTMLAnchorElement>(
97
+ ref,
98
+ useIntentTarget<HTMLAnchorElement>({ intent, intentKey }),
99
+ );
89
100
  const isActive = active ?? (context.value !== undefined && context.value === value);
90
101
  const shared = {
102
+ ...intentAttributes({ intent, intentKey }),
91
103
  ...props,
104
+ ref: composedRef,
92
105
  "aria-current": isActive ? ("page" as const) : undefined,
93
106
  "data-active": isActive ? ("" as const) : undefined,
94
107
  className: cn(itemClasses, className),
@@ -8,6 +8,7 @@ import {
8
8
  useContext,
9
9
  useId,
10
10
  } from "react";
11
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
11
12
  import { cn } from "../../utils/cn.js";
12
13
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
13
14
  import {
@@ -121,7 +122,9 @@ export function TabsList({ className, loop = true, ref, onFocus, ...props }: Tab
121
122
  );
122
123
  }
123
124
 
124
- export interface TabsTriggerProps extends Omit<ComponentPropsWithRef<"button">, "value"> {
125
+ export interface TabsTriggerProps
126
+ extends Omit<ComponentPropsWithRef<"button">, "value">,
127
+ IntentProps {
125
128
  value: string;
126
129
  /** Optional record count shown after the label. */
127
130
  count?: number;
@@ -136,9 +139,16 @@ export function TabsTrigger({
136
139
  onMouseDown,
137
140
  onKeyDown,
138
141
  onFocus,
142
+ intent,
143
+ intentKey,
144
+ ref,
139
145
  ...props
140
146
  }: TabsTriggerProps) {
141
147
  const context = useTabsContext("TabsTrigger");
148
+ const composedRef = useComposedRefs<HTMLButtonElement>(
149
+ ref,
150
+ useIntentTarget<HTMLButtonElement>({ intent, intentKey }, { role: "tab" }),
151
+ );
142
152
  const getItemProps = useContext(TabsListContext);
143
153
  if (!getItemProps) throw new Error("`TabsTrigger` must be used within `TabsList`");
144
154
  const selected = value === context.value;
@@ -165,8 +175,10 @@ export function TabsTrigger({
165
175
  data-disabled={disabled ? "" : undefined}
166
176
  disabled={disabled}
167
177
  id={triggerId(context.baseId, value)}
178
+ {...intentAttributes({ intent, intentKey })}
168
179
  {...props}
169
180
  {...item}
181
+ ref={composedRef}
170
182
  onMouseDown={composeHandlers(onMouseDown, (event: MouseEvent<HTMLButtonElement>) => {
171
183
  if (!disabled && event.button === 0 && !event.ctrlKey) {
172
184
  event.currentTarget.focus();
@@ -176,7 +188,7 @@ export function TabsTrigger({
176
188
  }
177
189
  })}
178
190
  className={cn(
179
- "inline-flex min-h-(--touch-target) shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap border-b-2 border-transparent px-2.5 @max-[420px]/tabs:px-2 pt-2.75 pb-2.5 text-control text-ink-3 hover:text-ink focus-visible:-outline-offset-2 data-[state=active]:border-accent-word data-[state=active]:text-ink",
191
+ "inline-flex min-h-(--touch-target) shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap border-b-2 border-transparent px-2.5 @max-[420px]/tabs:px-2 pt-2.75 pb-2.5 text-control text-ink-3 hover:text-ink focus-visible:-outline-offset-2 disabled:cursor-not-allowed disabled:opacity-50 data-[state=active]:border-accent-word data-[state=active]:text-ink",
180
192
  className,
181
193
  )}
182
194
  >
@@ -186,7 +198,7 @@ export function TabsTrigger({
186
198
  );
187
199
  }
188
200
 
189
- export interface TabsContentProps extends Omit<ComponentPropsWithRef<"div">, "value"> {
201
+ export interface TabsContentProps extends Omit<ComponentPropsWithRef<"div">, "value">, IntentProps {
190
202
  value: string;
191
203
  /** Keeps the panel mounted (hidden) while inactive. */
192
204
  forceMount?: boolean | undefined;
@@ -197,9 +209,16 @@ export function TabsContent({
197
209
  value,
198
210
  forceMount,
199
211
  children,
212
+ intent,
213
+ intentKey,
214
+ ref,
200
215
  ...props
201
216
  }: TabsContentProps) {
202
217
  const context = useTabsContext("TabsContent");
218
+ const composedRef = useComposedRefs<HTMLDivElement>(
219
+ ref,
220
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "tabpanel" }),
221
+ );
203
222
  const selected = value === context.value;
204
223
  const present = forceMount || selected;
205
224
  if (!present) return null;
@@ -213,7 +232,9 @@ export function TabsContent({
213
232
  id={contentId(context.baseId, value)}
214
233
  // biome-ignore lint/a11y/noNoninteractiveTabindex: WAI-ARIA tabpanels are focusable so keyboard users can reach the content
215
234
  tabIndex={0}
235
+ {...intentAttributes({ intent, intentKey })}
216
236
  {...props}
237
+ ref={composedRef}
217
238
  className={cn(className)}
218
239
  >
219
240
  {children}
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  type KeyboardEvent,
6
6
  type ReactNode,
7
7
  useEffect,
@@ -10,6 +10,7 @@ import {
10
10
  } from "react";
11
11
  import { Button, type ButtonSize } from "../../atoms/button/button.js";
12
12
  import { useUiStrings } from "../../i18n/index.js";
13
+ import { type IntentProps, useIntentTargets } from "../../intent/index.js";
13
14
  import type { ClassNames } from "../../utils/class-names.js";
14
15
  import { cn } from "../../utils/cn.js";
15
16
  import { useControllableState } from "../../utils/use-controllable-state.js";
@@ -18,7 +19,7 @@ import { clampIndex, evaluateGates, formatStepOf, isAdvanceKey, type WizardGate
18
19
 
19
20
  export type { WizardGate } from "./model.js";
20
21
 
21
- export interface WizardStep {
22
+ export interface WizardStep extends IntentProps {
22
23
  id: string;
23
24
  label: string;
24
25
  content: ReactNode;
@@ -40,7 +41,7 @@ export type WizardPart =
40
41
  | "next";
41
42
 
42
43
  export interface WizardProps
43
- extends Omit<ComponentPropsWithoutRef<"div">, "children" | "defaultValue" | "onChange"> {
44
+ extends Omit<ComponentPropsWithRef<"div">, "children" | "defaultValue" | "onChange"> {
44
45
  steps: readonly WizardStep[];
45
46
  /** Controlled current step id. */
46
47
  value?: string | undefined;
@@ -88,6 +89,7 @@ export function Wizard({
88
89
  ...props
89
90
  }: WizardProps) {
90
91
  const strings = useUiStrings();
92
+ const bind = useIntentTargets();
91
93
  const [stepId, setStepId] = useControllableState<string>({
92
94
  prop: valueProp,
93
95
  defaultProp: defaultValue ?? steps[0]?.id ?? "",
@@ -164,7 +166,13 @@ export function Wizard({
164
166
  >
165
167
  <Stepper
166
168
  aria-label={strings.steps}
167
- steps={steps.map(({ id, label: stepLabel }) => ({ id, label: stepLabel }))}
169
+ steps={steps.map(({ id, label: stepLabel, intent, intentKey }) => ({
170
+ id,
171
+ label: stepLabel,
172
+ intent,
173
+ intentKey: intentKey ?? id,
174
+ ref: bind<HTMLLIElement>({ intent, intentKey: intentKey ?? id }, { requireName: false }),
175
+ }))}
168
176
  currentStepId={current.id}
169
177
  className={classNames?.stepper}
170
178
  />
@@ -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;
@@ -75,9 +77,16 @@ export function DialogContent({
75
77
  onPointerDownOutside,
76
78
  onInteractOutside,
77
79
  onCloseAutoFocus,
80
+ intent,
81
+ intentKey,
82
+ ref,
78
83
  ...props
79
84
  }: DialogContentProps) {
80
85
  const previousFocusRef = usePreviousFocus();
86
+ const composedRef = useComposedRefs<HTMLDivElement>(
87
+ ref,
88
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "dialog" }),
89
+ );
81
90
  const strings = useUiStrings();
82
91
  return (
83
92
  <DialogPrimitive.Portal container={container}>
@@ -109,7 +118,9 @@ export function DialogContent({
109
118
  onCloseAutoFocus?.(event);
110
119
  restoreFocusOnClose(event, previousFocusRef);
111
120
  }}
121
+ {...intentAttributes({ intent, intentKey })}
112
122
  {...props}
123
+ ref={composedRef}
113
124
  >
114
125
  {children}
115
126
  {!blocking && (
@@ -130,7 +141,7 @@ export function DialogContent({
130
141
  }
131
142
 
132
143
  /** 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>) {
144
+ export function DialogHeader({ className, ...props }: ComponentPropsWithRef<"div">) {
134
145
  return (
135
146
  <div
136
147
  className={cn("flex flex-col gap-1 border-b-divider py-3.5 pr-10 pl-4.5", className)}
@@ -142,7 +153,7 @@ export function DialogHeader({ className, ...props }: HTMLAttributes<HTMLDivElem
142
153
  export function DialogTitle({
143
154
  className,
144
155
  ...props
145
- }: ComponentPropsWithoutRef<typeof DialogPrimitive.Title>) {
156
+ }: ComponentPropsWithRef<typeof DialogPrimitive.Title>) {
146
157
  return (
147
158
  <DialogPrimitive.Title
148
159
  className={cn("m-0 min-w-0 break-words text-dialog-title text-ink", className)}
@@ -154,15 +165,15 @@ export function DialogTitle({
154
165
  export function DialogDescription({
155
166
  className,
156
167
  ...props
157
- }: ComponentPropsWithoutRef<typeof DialogPrimitive.Description>) {
168
+ }: ComponentPropsWithRef<typeof DialogPrimitive.Description>) {
158
169
  return <DialogPrimitive.Description className={cn("m-0 text-ink-2", className)} {...props} />;
159
170
  }
160
171
 
161
- export function DialogBody({ className, ...props }: HTMLAttributes<HTMLDivElement>) {
172
+ export function DialogBody({ className, ...props }: ComponentPropsWithRef<"div">) {
162
173
  return <div className={cn("flex flex-col gap-4 p-4.5", className)} {...props} />;
163
174
  }
164
175
 
165
- export function DialogFooter({ className, ...props }: HTMLAttributes<HTMLDivElement>) {
176
+ export function DialogFooter({ className, ...props }: ComponentPropsWithRef<"div">) {
166
177
  return (
167
178
  <div
168
179
  className={cn(
@@ -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