@jcsoftdev/ui 0.8.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 (476) hide show
  1. package/CHANGELOG.md +151 -0
  2. package/README.md +22 -2
  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/index.d.ts +1 -0
  118. package/dist/containers/index.js +1 -0
  119. package/dist/containers/item-card-group/item-card-group.d.ts +4 -2
  120. package/dist/containers/item-card-group/item-card-group.js +4 -0
  121. package/dist/containers/kanban/kanban.js +13 -0
  122. package/dist/containers/kanban/model.d.ts +2 -0
  123. package/dist/containers/kpi/kpi-model.d.ts +7 -0
  124. package/dist/containers/kpi/kpi-model.js +22 -0
  125. package/dist/containers/kpi/kpi-parts.d.ts +28 -0
  126. package/dist/containers/kpi/kpi-parts.js +121 -0
  127. package/dist/containers/kpi/kpi.d.ts +7 -30
  128. package/dist/containers/kpi/kpi.js +4 -119
  129. package/dist/containers/kpi-group/kpi-group.d.ts +2 -2
  130. package/dist/containers/list-detail/list-detail.d.ts +12 -11
  131. package/dist/containers/list-detail/list-detail.js +9 -1
  132. package/dist/containers/note/note.d.ts +2 -2
  133. package/dist/containers/order-ticket/index.d.ts +2 -0
  134. package/dist/containers/order-ticket/index.js +18 -0
  135. package/dist/containers/order-ticket/model.d.ts +24 -0
  136. package/dist/containers/order-ticket/model.js +45 -0
  137. package/dist/containers/order-ticket/order-ticket.d.ts +35 -0
  138. package/dist/containers/order-ticket/order-ticket.js +406 -0
  139. package/dist/containers/page/page.d.ts +2 -2
  140. package/dist/containers/page-header/back.d.ts +2 -2
  141. package/dist/containers/page-header/page-header.d.ts +6 -6
  142. package/dist/containers/pagination/cursor-pagination.d.ts +2 -2
  143. package/dist/containers/pagination/pagination.d.ts +2 -2
  144. package/dist/containers/pagination/pagination.js +2 -2
  145. package/dist/containers/resizable/resizable.d.ts +4 -4
  146. package/dist/containers/resizable/resizable.js +1 -1
  147. package/dist/containers/row-actions/row-actions.d.ts +4 -3
  148. package/dist/containers/row-actions/row-actions.js +14 -1
  149. package/dist/containers/scrolly/scrolly.js +1 -1
  150. package/dist/containers/section/section.d.ts +10 -9
  151. package/dist/containers/section/section.js +12 -0
  152. package/dist/containers/selectable-card/selectable-card.d.ts +3 -2
  153. package/dist/containers/selectable-card/selectable-card.js +10 -1
  154. package/dist/containers/settings-layout/settings-layout.d.ts +7 -6
  155. package/dist/containers/settings-layout/settings-layout.js +10 -1
  156. package/dist/containers/settings-row/settings-row.d.ts +4 -3
  157. package/dist/containers/settings-row/settings-row.js +4 -0
  158. package/dist/containers/shortcuts/shortcuts.d.ts +3 -3
  159. package/dist/containers/stack/stack.d.ts +2 -2
  160. package/dist/containers/table/table.d.ts +14 -13
  161. package/dist/containers/table/table.js +22 -4
  162. package/dist/containers/timeline/timeline.d.ts +5 -4
  163. package/dist/containers/timeline/timeline.js +12 -0
  164. package/dist/containers/toolbar/toolbar.d.ts +3 -3
  165. package/dist/forms/accent-picker/accent-picker.d.ts +5 -2
  166. package/dist/forms/accent-picker/accent-picker.js +22 -1
  167. package/dist/forms/checkbox-button-group/checkbox-button-group.d.ts +3 -2
  168. package/dist/forms/checkbox-button-group/checkbox-button-group.js +16 -0
  169. package/dist/forms/chip-group/chip-group.d.ts +4 -1
  170. package/dist/forms/chip-group/chip-group.js +20 -2
  171. package/dist/forms/combobox/combobox.d.ts +3 -2
  172. package/dist/forms/combobox/combobox.js +10 -1
  173. package/dist/forms/copy-field/copy-field.d.ts +4 -3
  174. package/dist/forms/copy-field/copy-field.js +7 -0
  175. package/dist/forms/date-picker/date-picker.d.ts +3 -2
  176. package/dist/forms/date-picker/date-picker.js +10 -1
  177. package/dist/forms/date-picker/date-time-picker.d.ts +3 -2
  178. package/dist/forms/date-picker/date-time-picker.js +4 -0
  179. package/dist/forms/dropzone/dropzone.d.ts +3 -2
  180. package/dist/forms/dropzone/dropzone.js +21 -3
  181. package/dist/forms/emoji-picker/emoji-picker.d.ts +3 -2
  182. package/dist/forms/emoji-picker/emoji-picker.js +9 -2
  183. package/dist/forms/emoji-reaction-button/emoji-reaction-button.d.ts +3 -2
  184. package/dist/forms/emoji-reaction-button/emoji-reaction-button.js +8 -1
  185. package/dist/forms/field/field.d.ts +2 -2
  186. package/dist/forms/fieldset/fieldset.d.ts +2 -2
  187. package/dist/forms/form/form.d.ts +6 -4
  188. package/dist/forms/form/form.js +10 -2
  189. package/dist/forms/form-footer/form-footer.d.ts +2 -2
  190. package/dist/forms/form-grid/form-grid.d.ts +3 -3
  191. package/dist/forms/form-section/form-section.d.ts +2 -2
  192. package/dist/forms/inline-select/inline-select.d.ts +4 -3
  193. package/dist/forms/inline-select/inline-select.js +9 -1
  194. package/dist/forms/input/input.d.ts +3 -2
  195. package/dist/forms/input/input.js +6 -1
  196. package/dist/forms/internal/button-option.d.ts +2 -0
  197. package/dist/forms/label/label.d.ts +2 -2
  198. package/dist/forms/native-select/native-select.d.ts +4 -3
  199. package/dist/forms/native-select/native-select.js +4 -0
  200. package/dist/forms/number-stepper/number-stepper.d.ts +2 -1
  201. package/dist/forms/number-stepper/number-stepper.js +13 -3
  202. package/dist/forms/password-input/password-input.d.ts +1 -1
  203. package/dist/forms/password-input/password-input.js +12 -0
  204. package/dist/forms/pin-input/pin-input.d.ts +3 -2
  205. package/dist/forms/pin-input/pin-input.js +8 -1
  206. package/dist/forms/radio-button-group/radio-button-group.d.ts +3 -2
  207. package/dist/forms/radio-button-group/radio-button-group.js +16 -0
  208. package/dist/forms/rating/rating.d.ts +3 -2
  209. package/dist/forms/rating/rating.js +12 -0
  210. package/dist/forms/select/select.d.ts +4 -3
  211. package/dist/forms/select/select.js +11 -2
  212. package/dist/forms/select-menu/select-menu.d.ts +3 -2
  213. package/dist/forms/select-menu/select-menu.js +10 -1
  214. package/dist/forms/slider/model.d.ts +1 -0
  215. package/dist/forms/slider/model.js +5 -0
  216. package/dist/forms/slider/slider.d.ts +2 -1
  217. package/dist/forms/slider/slider.js +12 -3
  218. package/dist/forms/textarea/textarea.d.ts +4 -3
  219. package/dist/forms/textarea/textarea.js +4 -2
  220. package/dist/forms/time-input/time-input.d.ts +4 -3
  221. package/dist/forms/time-input/time-input.js +13 -1
  222. package/dist/glass/crystal-map.d.ts +3 -1
  223. package/dist/glass/crystal-map.js +13 -2
  224. package/dist/i18n/strings.d.ts +78 -0
  225. package/dist/i18n/strings.js +52 -0
  226. package/dist/icons/alarm-clock.d.ts +2 -0
  227. package/dist/icons/alarm-clock.js +15 -0
  228. package/dist/icons/hourglass.d.ts +2 -0
  229. package/dist/icons/hourglass.js +13 -0
  230. package/dist/icons/index.d.ts +2 -0
  231. package/dist/icons/index.js +4 -0
  232. package/dist/intent/attributes.d.ts +11 -0
  233. package/dist/intent/attributes.js +77 -0
  234. package/dist/intent/bridge.d.ts +8 -0
  235. package/dist/intent/bridge.js +19 -0
  236. package/dist/intent/index.d.ts +4 -0
  237. package/dist/intent/index.js +31 -0
  238. package/dist/intent/target-registrations.d.ts +16 -0
  239. package/dist/intent/target-registrations.js +91 -0
  240. package/dist/intent/types.d.ts +29 -0
  241. package/dist/intent/types.js +0 -0
  242. package/dist/intent/use-intent-target.d.ts +4 -0
  243. package/dist/intent/use-intent-target.js +75 -0
  244. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +6 -4
  245. package/dist/navigation/breadcrumbs/breadcrumbs.js +11 -1
  246. package/dist/navigation/floating-toc/floating-toc.d.ts +2 -2
  247. package/dist/navigation/floating-toc/floating-toc.js +5 -0
  248. package/dist/navigation/floating-toc/model.d.ts +2 -1
  249. package/dist/navigation/segmented/segmented.d.ts +3 -2
  250. package/dist/navigation/segmented/segmented.js +11 -1
  251. package/dist/navigation/stepper/stepper.d.ts +4 -2
  252. package/dist/navigation/stepper/stepper.js +3 -0
  253. package/dist/navigation/tabs/tabs-nav.d.ts +5 -4
  254. package/dist/navigation/tabs/tabs-nav.js +11 -0
  255. package/dist/navigation/tabs/tabs.d.ts +5 -4
  256. package/dist/navigation/tabs/tabs.js +20 -1
  257. package/dist/navigation/wizard/wizard.d.ts +4 -3
  258. package/dist/navigation/wizard/wizard.js +9 -1
  259. package/dist/overlays/alert-dialog/alert-dialog.d.ts +5 -4
  260. package/dist/overlays/alert-dialog/alert-dialog.js +20 -3
  261. package/dist/overlays/context-menu/context-menu.d.ts +14 -12
  262. package/dist/overlays/context-menu/context-menu.js +57 -8
  263. package/dist/overlays/dialog/dialog.d.ts +9 -8
  264. package/dist/overlays/dialog/dialog.js +11 -0
  265. package/dist/overlays/drawer/drawer.d.ts +6 -5
  266. package/dist/overlays/drawer/drawer.js +11 -0
  267. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +14 -13
  268. package/dist/overlays/dropdown-menu/dropdown-menu.js +58 -5
  269. package/dist/overlays/hover-card/hover-card.d.ts +4 -3
  270. package/dist/overlays/hover-card/hover-card.js +12 -1
  271. package/dist/overlays/popover/popover.d.ts +3 -2
  272. package/dist/overlays/popover/popover.js +12 -1
  273. package/dist/overlays/tooltip/model.d.ts +1 -0
  274. package/dist/overlays/tooltip/model.js +8 -0
  275. package/dist/overlays/tooltip/tooltip.d.ts +2 -1
  276. package/dist/overlays/tooltip/tooltip.js +8 -2
  277. package/dist/palette/command-palette/command-palette.d.ts +8 -4
  278. package/dist/palette/command-palette/command-palette.js +49 -1
  279. package/dist/palette/command-palette/index.d.ts +1 -0
  280. package/dist/palette/command-palette/index.js +3 -1
  281. package/dist/palette/command-palette/model.d.ts +7 -0
  282. package/dist/palette/command-palette/model.js +11 -0
  283. package/dist/primitives/command/command.js +4 -1
  284. package/dist/primitives/dialog/dialog.js +1 -3
  285. package/dist/primitives/popper/popper.js +15 -4
  286. package/dist/shell/bottom-nav/bottom-nav.js +54 -42
  287. package/dist/shell/sidebar/sidebar.d.ts +5 -3
  288. package/dist/shell/sidebar/sidebar.js +14 -2
  289. package/dist/showcase/bento.js +1 -0
  290. package/dist/utils/is-production.d.ts +1 -0
  291. package/dist/utils/is-production.js +6 -0
  292. package/dist/utils/slot.js +17 -3
  293. package/icons/svg/alarm-clock.svg +8 -0
  294. package/icons/svg/hourglass.svg +6 -0
  295. package/package.json +2 -2
  296. package/src/ai/attachment/attachment.tsx +10 -3
  297. package/src/ai/chat-message/chat-message.tsx +10 -2
  298. package/src/ai/code-block/code-block.tsx +2 -2
  299. package/src/ai/conversation/conversation.tsx +2 -2
  300. package/src/ai/internal/disclosure.tsx +1 -1
  301. package/src/ai/internal/icon-action.tsx +14 -4
  302. package/src/ai/message-actions/message-actions.tsx +28 -3
  303. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  304. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  305. package/src/ai/source/source.tsx +17 -3
  306. package/src/ai/tool-call/tool-call.tsx +6 -1
  307. package/src/atoms/big-date/big-date.tsx +2 -2
  308. package/src/atoms/button/button.tsx +11 -1
  309. package/src/atoms/checkbox/checkbox.tsx +40 -21
  310. package/src/atoms/chip/chip.tsx +12 -2
  311. package/src/atoms/divider/divider.tsx +2 -2
  312. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  313. package/src/atoms/elapsed-time/model.ts +57 -0
  314. package/src/atoms/icon-button/icon-button.tsx +3 -1
  315. package/src/atoms/internal/labelled-control.tsx +83 -0
  316. package/src/atoms/number-value/number-value.tsx +2 -2
  317. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  318. package/src/atoms/progress/progress.tsx +2 -2
  319. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  320. package/src/atoms/radio-group/radio-group.tsx +5 -1
  321. package/src/atoms/seal/seal.tsx +2 -2
  322. package/src/atoms/status-pill/status-pill.tsx +1 -1
  323. package/src/atoms/switch/switch.tsx +43 -9
  324. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  325. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  326. package/src/auth/login-form/parts.tsx +2 -2
  327. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  328. package/src/calendar/day-chip/day-chip.tsx +14 -2
  329. package/src/calendar/event-block/event-block.tsx +9 -1
  330. package/src/calendar/internal/grid-navigation.ts +47 -0
  331. package/src/calendar/internal/intent.ts +10 -0
  332. package/src/calendar/internal/month-model.ts +23 -0
  333. package/src/calendar/internal/types.ts +4 -0
  334. package/src/calendar/month-view/month-grid.tsx +248 -0
  335. package/src/calendar/month-view/month-view.tsx +32 -148
  336. package/src/calendar/week-view/week-view.tsx +87 -10
  337. package/src/charts/README.md +10 -0
  338. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  339. package/src/charts/core/breadcrumb.tsx +1 -1
  340. package/src/charts/core/chart-states.tsx +1 -1
  341. package/src/charts/core/distribution/xy-points.tsx +4 -2
  342. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  343. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  344. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  345. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  346. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  347. package/src/containers/action-bar/action-bar.tsx +3 -3
  348. package/src/containers/aside/aside.tsx +3 -3
  349. package/src/containers/banner/banner.tsx +2 -2
  350. package/src/containers/card/card.tsx +7 -5
  351. package/src/containers/carousel/carousel.tsx +4 -4
  352. package/src/containers/cols/cols.tsx +3 -3
  353. package/src/containers/comment/comment.tsx +2 -2
  354. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  355. package/src/containers/dashboard/dashboard.tsx +4 -4
  356. package/src/containers/data-grid/column-menu.tsx +1 -1
  357. package/src/containers/data-grid/data-grid.tsx +53 -4
  358. package/src/containers/data-grid/formula-bar.tsx +1 -1
  359. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  360. package/src/containers/data-grid/tool-panel.tsx +1 -1
  361. package/src/containers/description-list/description-list.tsx +2 -2
  362. package/src/containers/detail-header/detail-header.tsx +2 -2
  363. package/src/containers/facts/facts.tsx +2 -2
  364. package/src/containers/feed/feed.tsx +16 -3
  365. package/src/containers/file-tree/file-tree.tsx +11 -0
  366. package/src/containers/file-tree/model.ts +2 -0
  367. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  368. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  369. package/src/containers/floor-plan/index.ts +7 -1
  370. package/src/containers/floor-plan/model.ts +16 -0
  371. package/src/containers/generic-row/generic-row.tsx +9 -6
  372. package/src/containers/grid/grid.tsx +2 -2
  373. package/src/containers/hbars/hbars.tsx +23 -21
  374. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  375. package/src/containers/index.ts +1 -0
  376. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  377. package/src/containers/kanban/kanban.tsx +13 -0
  378. package/src/containers/kanban/model.ts +2 -0
  379. package/src/containers/kpi/kpi-model.ts +37 -0
  380. package/src/containers/kpi/kpi-parts.tsx +153 -0
  381. package/src/containers/kpi/kpi.tsx +10 -176
  382. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  383. package/src/containers/list-detail/list-detail.tsx +22 -12
  384. package/src/containers/note/note.tsx +2 -2
  385. package/src/containers/order-ticket/index.ts +17 -0
  386. package/src/containers/order-ticket/model.ts +76 -0
  387. package/src/containers/order-ticket/order-ticket.tsx +480 -0
  388. package/src/containers/page/page.tsx +2 -2
  389. package/src/containers/page-header/back.tsx +2 -2
  390. package/src/containers/page-header/page-header.tsx +6 -6
  391. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  392. package/src/containers/pagination/pagination.tsx +4 -4
  393. package/src/containers/resizable/resizable.tsx +7 -5
  394. package/src/containers/row-actions/row-actions.tsx +18 -3
  395. package/src/containers/scrolly/scrolly.tsx +1 -1
  396. package/src/containers/section/section.tsx +21 -8
  397. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  398. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  399. package/src/containers/settings-row/settings-row.tsx +7 -2
  400. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  401. package/src/containers/stack/stack.tsx +2 -2
  402. package/src/containers/table/table.tsx +35 -14
  403. package/src/containers/timeline/timeline.tsx +17 -3
  404. package/src/containers/toolbar/toolbar.tsx +3 -3
  405. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  406. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  407. package/src/forms/chip-group/chip-group.tsx +23 -2
  408. package/src/forms/combobox/combobox.tsx +15 -4
  409. package/src/forms/copy-field/copy-field.tsx +11 -2
  410. package/src/forms/date-picker/date-picker.tsx +23 -12
  411. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  412. package/src/forms/dropzone/dropzone.tsx +18 -3
  413. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  414. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  415. package/src/forms/field/field.tsx +2 -2
  416. package/src/forms/fieldset/fieldset.tsx +2 -2
  417. package/src/forms/form/form.tsx +13 -5
  418. package/src/forms/form-footer/form-footer.tsx +2 -2
  419. package/src/forms/form-grid/form-grid.tsx +3 -3
  420. package/src/forms/form-section/form-section.tsx +2 -2
  421. package/src/forms/inline-select/inline-select.tsx +14 -3
  422. package/src/forms/input/input.tsx +8 -2
  423. package/src/forms/internal/button-option.tsx +2 -0
  424. package/src/forms/label/label.tsx +2 -2
  425. package/src/forms/native-select/native-select.tsx +9 -2
  426. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  427. package/src/forms/password-input/password-input.tsx +12 -0
  428. package/src/forms/pin-input/pin-input.tsx +9 -1
  429. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  430. package/src/forms/rating/rating.tsx +14 -1
  431. package/src/forms/select/select.tsx +14 -4
  432. package/src/forms/select-menu/select-menu.tsx +15 -4
  433. package/src/forms/slider/model.ts +5 -0
  434. package/src/forms/slider/slider.tsx +13 -3
  435. package/src/forms/textarea/textarea.tsx +7 -4
  436. package/src/forms/time-input/time-input.tsx +19 -5
  437. package/src/glass/crystal-map.ts +21 -3
  438. package/src/i18n/strings.ts +78 -0
  439. package/src/icons/alarm-clock.tsx +16 -0
  440. package/src/icons/hourglass.tsx +14 -0
  441. package/src/icons/index.ts +2 -0
  442. package/src/intent/attributes.ts +96 -0
  443. package/src/intent/bridge.tsx +25 -0
  444. package/src/intent/index.ts +24 -0
  445. package/src/intent/target-registrations.ts +127 -0
  446. package/src/intent/types.ts +44 -0
  447. package/src/intent/use-intent-target.ts +96 -0
  448. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  449. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  450. package/src/navigation/floating-toc/model.ts +3 -1
  451. package/src/navigation/segmented/segmented.tsx +14 -2
  452. package/src/navigation/stepper/stepper.tsx +7 -2
  453. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  454. package/src/navigation/tabs/tabs.tsx +24 -3
  455. package/src/navigation/wizard/wizard.tsx +12 -4
  456. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  457. package/src/overlays/context-menu/context-menu.tsx +58 -11
  458. package/src/overlays/dialog/dialog.tsx +18 -7
  459. package/src/overlays/drawer/drawer.tsx +15 -4
  460. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  461. package/src/overlays/hover-card/hover-card.tsx +13 -2
  462. package/src/overlays/popover/popover.tsx +12 -1
  463. package/src/overlays/tooltip/model.ts +8 -0
  464. package/src/overlays/tooltip/tooltip.tsx +15 -2
  465. package/src/palette/command-palette/command-palette.tsx +66 -3
  466. package/src/palette/command-palette/index.ts +1 -0
  467. package/src/palette/command-palette/model.ts +15 -0
  468. package/src/primitives/command/command.tsx +4 -1
  469. package/src/primitives/dialog/dialog.tsx +1 -4
  470. package/src/primitives/popper/popper.tsx +16 -5
  471. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  472. package/src/shell/sidebar/sidebar.tsx +22 -4
  473. package/src/showcase/bento.tsx +2 -0
  474. package/src/utils/is-production.ts +3 -0
  475. package/src/utils/slot.tsx +21 -3
  476. package/styles/base.css +34 -0
@@ -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
@@ -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" />
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  createContext,
6
6
  type FocusEvent,
7
7
  type PointerEvent,
@@ -14,8 +14,10 @@ import {
14
14
  useRef,
15
15
  useState,
16
16
  } from "react";
17
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
17
18
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
18
19
  import { cn } from "../../utils/cn.js";
20
+ import { useComposedRefs } from "../../utils/compose.js";
19
21
  import { type Material, materialClass } from "../../utils/material.js";
20
22
  import { POPPER_MOTION } from "../../utils/overlay-motion.js";
21
23
  import { Slot } from "../../utils/slot.js";
@@ -98,7 +100,7 @@ export function HoverCard({
98
100
  );
99
101
  }
100
102
 
101
- export interface HoverCardTriggerProps extends ComponentPropsWithoutRef<"span"> {
103
+ export interface HoverCardTriggerProps extends ComponentPropsWithRef<"span">, IntentProps {
102
104
  /** Use the child element as the trigger instead of wrapping it in a span. */
103
105
  asChild?: boolean;
104
106
  }
@@ -109,9 +111,16 @@ export function HoverCardTrigger({
109
111
  onPointerLeave,
110
112
  onFocus,
111
113
  onBlur,
114
+ intent,
115
+ intentKey,
116
+ ref,
112
117
  ...props
113
118
  }: HoverCardTriggerProps) {
114
119
  const card = useHoverCard();
120
+ const composedRef = useComposedRefs<HTMLSpanElement>(
121
+ ref,
122
+ useIntentTarget<HTMLSpanElement>({ intent, intentKey }),
123
+ );
115
124
  const Comp = asChild ? Slot : "span";
116
125
  return (
117
126
  <PopoverPrimitive.Anchor asChild>
@@ -133,7 +142,9 @@ export function HoverCardTrigger({
133
142
  onBlur?.(event);
134
143
  card.schedule(false, 0);
135
144
  }}
145
+ {...intentAttributes({ intent, intentKey })}
136
146
  {...props}
147
+ ref={composedRef}
137
148
  />
138
149
  </PopoverPrimitive.Anchor>
139
150
  );
@@ -1,7 +1,9 @@
1
1
  "use client";
2
2
 
3
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
3
4
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
4
5
  import { cn } from "../../utils/cn.js";
6
+ import { useComposedRefs } from "../../utils/compose.js";
5
7
  import { type Material, materialClass } from "../../utils/material.js";
6
8
  import { POPPER_MOTION } from "../../utils/overlay-motion.js";
7
9
 
@@ -11,7 +13,7 @@ export const PopoverClose = PopoverPrimitive.Close;
11
13
  export const PopoverAnchor = PopoverPrimitive.Anchor;
12
14
  export const PopoverArrow = PopoverPrimitive.Arrow;
13
15
 
14
- export interface PopoverContentProps extends PopoverPrimitive.PopoverContentProps {
16
+ export interface PopoverContentProps extends PopoverPrimitive.PopoverContentProps, IntentProps {
15
17
  /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
16
18
  container?: HTMLElement | null;
17
19
  /**
@@ -30,8 +32,15 @@ export function PopoverContent({
30
32
  collisionPadding = 8,
31
33
  container,
32
34
  material,
35
+ intent,
36
+ intentKey,
37
+ ref,
33
38
  ...props
34
39
  }: PopoverContentProps) {
40
+ const composedRef = useComposedRefs<HTMLDivElement>(
41
+ ref,
42
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "dialog" }),
43
+ );
35
44
  return (
36
45
  <PopoverPrimitive.Portal container={container}>
37
46
  <PopoverPrimitive.Content
@@ -43,7 +52,9 @@ export function PopoverContent({
43
52
  materialClass(material, "surface-solid"),
44
53
  className,
45
54
  )}
55
+ {...intentAttributes({ intent, intentKey })}
46
56
  {...props}
57
+ ref={composedRef}
47
58
  />
48
59
  </PopoverPrimitive.Portal>
49
60
  );
@@ -16,3 +16,11 @@ export function opensOnFocus({
16
16
  }): boolean {
17
17
  return focusVisible && !pressed;
18
18
  }
19
+
20
+ export function joinIds(...ids: Array<string | undefined>): string | undefined {
21
+ const unique = new Set<string>();
22
+ for (const value of ids) {
23
+ for (const id of (value ?? "").trim().split(/\s+/)) if (id) unique.add(id);
24
+ }
25
+ return unique.size > 0 ? [...unique].join(" ") : undefined;
26
+ }
@@ -19,7 +19,7 @@ import { type Material, materialClass } from "../../utils/material.js";
19
19
  import { POPPER_MOTION } from "../../utils/overlay-motion.js";
20
20
  import { Slot } from "../../utils/slot.js";
21
21
  import { useControllableState } from "../../utils/use-controllable-state.js";
22
- import { opensOnFocus, opensOnHover } from "./model.js";
22
+ import { joinIds, opensOnFocus, opensOnHover } from "./model.js";
23
23
 
24
24
  export type TooltipPart = "content" | "shortcut";
25
25
 
@@ -51,6 +51,7 @@ export interface TooltipProps {
51
51
  classNames?: ClassNames<TooltipPart>;
52
52
  /** The element that gets the tooltip. It receives `aria-describedby` while the tooltip is open. */
53
53
  children: ReactElement;
54
+ describeTrigger?: "whileOpen" | "always";
54
55
  }
55
56
 
56
57
  function focusIsVisible(element: Element): boolean {
@@ -83,6 +84,7 @@ export function Tooltip({
83
84
  material,
84
85
  className,
85
86
  classNames,
87
+ describeTrigger = "whileOpen",
86
88
  children,
87
89
  }: TooltipProps) {
88
90
  const [openState, setOpen] = useControllableState({
@@ -92,6 +94,12 @@ export function Tooltip({
92
94
  });
93
95
  const open = openState && !disabled;
94
96
  const contentId = useId();
97
+ const descriptionId = useId();
98
+ const persistent = describeTrigger === "always";
99
+ const ownDescribedBy = (children.props as { "aria-describedby"?: string })["aria-describedby"];
100
+ const describedBy = persistent
101
+ ? joinIds(ownDescribedBy, descriptionId)
102
+ : joinIds(ownDescribedBy, open ? contentId : undefined);
95
103
  const timer = useRef<number | undefined>(undefined);
96
104
  const pressed = useRef(false);
97
105
 
@@ -108,7 +116,7 @@ export function Tooltip({
108
116
 
109
117
  const trigger = (
110
118
  <Slot
111
- aria-describedby={open ? contentId : undefined}
119
+ aria-describedby={describedBy}
112
120
  onPointerEnter={(event: PointerEvent<HTMLElement>) => {
113
121
  if (opensOnHover(event.pointerType)) schedule(true, openDelay);
114
122
  }}
@@ -137,6 +145,11 @@ export function Tooltip({
137
145
 
138
146
  return (
139
147
  <PopoverPrimitive.Root open={open} onOpenChange={setOpen}>
148
+ {persistent ? (
149
+ <span id={descriptionId} hidden>
150
+ {content}
151
+ </span>
152
+ ) : null}
140
153
  <PopoverPrimitive.Anchor asChild>{trigger}</PopoverPrimitive.Anchor>
141
154
  <PopoverPrimitive.Portal container={container}>
142
155
  <PopoverPrimitive.Content