@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,14 +1,14 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export type ToolbarProps = ComponentPropsWithoutRef<"div">;
4
+ export type ToolbarProps = ComponentPropsWithRef<"div">;
5
5
 
6
6
  /** Row of filters/controls above a table or grid. */
7
7
  export function Toolbar({ className, ...props }: ToolbarProps) {
8
8
  return <div className={cn("flex min-w-0 flex-wrap items-center gap-2", className)} {...props} />;
9
9
  }
10
10
 
11
- export type ToolbarRightProps = ComponentPropsWithoutRef<"div">;
11
+ export type ToolbarRightProps = ComponentPropsWithRef<"div">;
12
12
 
13
13
  /** Group pushed to the right edge of the toolbar. */
14
14
  export function ToolbarRight({ className, ...props }: ToolbarRightProps) {
@@ -6,20 +6,27 @@ import {
6
6
  RadioGroupRoot,
7
7
  type RadioGroupRootProps,
8
8
  } from "../../atoms/radio-group/radio-group-primitive.js";
9
+ import { intentAttributes } from "../../intent/attributes.js";
10
+ import type { IntentProps } from "../../intent/types.js";
11
+ import { useIntentTarget, useIntentTargets } from "../../intent/use-intent-target.js";
9
12
  import type { ClassNames } from "../../utils/class-names.js";
10
13
  import { cn } from "../../utils/cn.js";
14
+ import { useComposedRefs } from "../../utils/compose.js";
11
15
 
12
16
  export interface AccentOption {
13
17
  value: string;
14
18
  label: string;
15
19
  /** Any CSS color value, typically a variable such as `var(--accent)`. */
16
20
  swatch: string;
21
+ intent?: string | undefined;
22
+ intentKey?: string | undefined;
17
23
  }
18
24
 
19
25
  export type AccentPickerPart = "root" | "option" | "swatch";
20
26
 
21
27
  export interface AccentPickerProps
22
- extends Omit<RadioGroupRootProps, "value" | "defaultValue" | "onValueChange"> {
28
+ extends Omit<RadioGroupRootProps, "value" | "defaultValue" | "onValueChange">,
29
+ IntentProps {
23
30
  options: AccentOption[];
24
31
  value?: string;
25
32
  defaultValue?: string;
@@ -40,13 +47,23 @@ export function AccentPicker({
40
47
  onValueChange,
41
48
  className,
42
49
  classNames,
50
+ intent,
51
+ intentKey,
52
+ ref,
43
53
  ...props
44
54
  }: AccentPickerProps) {
55
+ const rootRef = useComposedRefs<HTMLDivElement>(
56
+ ref,
57
+ useIntentTarget({ intent, intentKey }, { role: "radiogroup" }),
58
+ );
59
+ const bindOption = useIntentTargets();
45
60
  const [internal, setInternal] = useState(() => defaultValue ?? options[0]?.value);
46
61
  const current = value ?? internal;
47
62
 
48
63
  return (
49
64
  <RadioGroupRoot
65
+ {...intentAttributes({ intent, intentKey })}
66
+ ref={rootRef}
50
67
  data-accent={current}
51
68
  value={current}
52
69
  onValueChange={(next) => {
@@ -60,8 +77,16 @@ export function AccentPicker({
60
77
  <RadioGroupItem
61
78
  key={option.value}
62
79
  value={option.value}
80
+ {...intentAttributes({
81
+ intent: option.intent,
82
+ intentKey: option.intentKey ?? option.value,
83
+ })}
84
+ ref={bindOption(
85
+ { intent: option.intent, intentKey: option.intentKey ?? option.value },
86
+ { role: "radio" },
87
+ )}
63
88
  className={cn(
64
- "flex items-center gap-2 rounded-control border-divider px-2.5 py-1.75 font-semibold text-chip-text text-ink data-[state=checked]:border-accent-ink data-[state=checked]:shadow-selected",
89
+ "flex items-center gap-2 rounded-control border-divider px-2.5 py-1.75 font-semibold text-chip-text text-ink disabled:cursor-not-allowed disabled:opacity-50 data-[state=checked]:border-accent-ink data-[state=checked]:shadow-selected",
65
90
  classNames?.option,
66
91
  )}
67
92
  >
@@ -1,6 +1,9 @@
1
1
  "use client";
2
2
 
3
3
  import { useState } from "react";
4
+ import { intentAttributes } from "../../intent/attributes.js";
5
+ import type { IntentProps } from "../../intent/types.js";
6
+ import { useIntentTarget, useIntentTargets } from "../../intent/use-intent-target.js";
4
7
  import type { ClassNames } from "../../utils/class-names.js";
5
8
  import { cn } from "../../utils/cn.js";
6
9
  import {
@@ -14,7 +17,7 @@ export type CheckboxButtonOption = ButtonOption;
14
17
 
15
18
  export type CheckboxButtonGroupPart = "root" | ButtonOptionPart;
16
19
 
17
- export interface CheckboxButtonGroupProps {
20
+ export interface CheckboxButtonGroupProps extends IntentProps {
18
21
  options: CheckboxButtonOption[];
19
22
  value?: string[];
20
23
  defaultValue?: string[];
@@ -39,8 +42,12 @@ export function CheckboxButtonGroup({
39
42
  disabled,
40
43
  className,
41
44
  classNames,
45
+ intent,
46
+ intentKey,
42
47
  ...aria
43
48
  }: CheckboxButtonGroupProps) {
49
+ const rootRef = useIntentTarget<HTMLFieldSetElement>({ intent, intentKey });
50
+ const bindOption = useIntentTargets();
44
51
  const [inner, setInner] = useState(defaultValue);
45
52
  const value = valueProp ?? inner;
46
53
 
@@ -58,7 +65,9 @@ export function CheckboxButtonGroup({
58
65
  classNames?.root,
59
66
  className,
60
67
  )}
68
+ {...intentAttributes({ intent, intentKey })}
61
69
  {...aria}
70
+ ref={rootRef}
62
71
  >
63
72
  {options.map((option) => (
64
73
  <OptionShell
@@ -67,6 +76,14 @@ export function CheckboxButtonGroup({
67
76
  classNames={classNames}
68
77
  input={
69
78
  <input
79
+ {...intentAttributes({
80
+ intent: option.intent,
81
+ intentKey: option.intentKey ?? option.value,
82
+ })}
83
+ ref={bindOption({
84
+ intent: option.intent,
85
+ intentKey: option.intentKey ?? option.value,
86
+ })}
70
87
  type="checkbox"
71
88
  name={name}
72
89
  value={option.value}
@@ -2,6 +2,9 @@
2
2
 
3
3
  import { type ReactNode, useEffect, useId, useRef, useState } from "react";
4
4
  import { Check } from "../../icons/index.js";
5
+ import { intentAttributes } from "../../intent/attributes.js";
6
+ import type { IntentProps } from "../../intent/types.js";
7
+ import { useIntentTarget, useIntentTargets } from "../../intent/use-intent-target.js";
5
8
  import type { ClassNames } from "../../utils/class-names.js";
6
9
  import { cn } from "../../utils/cn.js";
7
10
  import { useComposedRefs } from "../../utils/compose.js";
@@ -16,11 +19,13 @@ export interface ChipGroupOption {
16
19
  /** Decorative glyph before the label (replaced by a check while selected in a multiple group). */
17
20
  icon?: ReactNode;
18
21
  disabled?: boolean;
22
+ intent?: string | undefined;
23
+ intentKey?: string | undefined;
19
24
  }
20
25
 
21
26
  export type ChipGroupPart = "root" | "chip" | "label" | "count" | "check";
22
27
 
23
- interface ChipGroupCommon {
28
+ interface ChipGroupCommon extends IntentProps {
24
29
  options: readonly ChipGroupOption[];
25
30
  disabled?: boolean | undefined;
26
31
  /** Form field name: a hidden input per selected value. */
@@ -83,6 +88,8 @@ export function ChipGroup(props: ChipGroupProps) {
83
88
  "aria-labelledby": ariaLabelledBy,
84
89
  "aria-describedby": ariaDescribedBy,
85
90
  "aria-invalid": ariaInvalid,
91
+ intent,
92
+ intentKey,
86
93
  } = props;
87
94
  const single = props.type === "single";
88
95
  const generated = useId();
@@ -117,7 +124,12 @@ export function ChipGroup(props: ChipGroupProps) {
117
124
  });
118
125
  const { ref: rovingRef, onFocus: rovingOnFocus, tabIndex } = roving.rootProps;
119
126
  const localRef = useRef<HTMLFieldSetElement | null>(null);
120
- const composedRef = useComposedRefs<HTMLFieldSetElement>(rovingRef, localRef);
127
+ const composedRef = useComposedRefs<HTMLFieldSetElement>(
128
+ rovingRef,
129
+ localRef,
130
+ useIntentTarget({ intent, intentKey }),
131
+ );
132
+ const bindOption = useIntentTargets();
121
133
 
122
134
  // A group is not a labelable element, so `Field`'s <label for> cannot name it: read its text.
123
135
  const [fieldLabel, setFieldLabel] = useState<string | undefined>();
@@ -133,6 +145,7 @@ export function ChipGroup(props: ChipGroupProps) {
133
145
 
134
146
  return (
135
147
  <fieldset
148
+ {...intentAttributes({ intent, intentKey })}
136
149
  ref={composedRef}
137
150
  id={baseId}
138
151
  tabIndex={tabIndex}
@@ -159,6 +172,14 @@ export function ChipGroup(props: ChipGroupProps) {
159
172
  type="button"
160
173
  aria-pressed={pressed}
161
174
  disabled={off}
175
+ {...intentAttributes({
176
+ intent: option.intent,
177
+ intentKey: option.intentKey ?? option.value,
178
+ })}
179
+ ref={bindOption({
180
+ intent: option.intent,
181
+ intentKey: option.intentKey ?? option.value,
182
+ })}
162
183
  {...item}
163
184
  onClick={() => toggle(option.value)}
164
185
  className={cn(
@@ -11,6 +11,9 @@ import {
11
11
  } from "react";
12
12
  import { useUiStrings } from "../../i18n/index.js";
13
13
  import { X } from "../../icons/index.js";
14
+ import { intentAttributes } from "../../intent/attributes.js";
15
+ import type { IntentProps } from "../../intent/types.js";
16
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
14
17
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
15
18
  import type { ClassNames } from "../../utils/class-names.js";
16
19
  import { cn } from "../../utils/cn.js";
@@ -34,9 +37,10 @@ export type ComboboxPart = "root" | "input" | "clear" | "content" | "option" | "
34
37
 
35
38
  export interface ComboboxProps
36
39
  extends Omit<
37
- ComponentProps<"input">,
38
- "value" | "defaultValue" | "onChange" | "type" | "role" | "size"
39
- > {
40
+ ComponentProps<"input">,
41
+ "value" | "defaultValue" | "onChange" | "type" | "role" | "size"
42
+ >,
43
+ IntentProps {
40
44
  /** Options, optionally nested in labelled groups. For async search, pass the current results. */
41
45
  options: readonly (ComboboxOption | ComboboxGroup)[];
42
46
  /** Selected option value (controlled). `""` means nothing is selected. */
@@ -115,6 +119,8 @@ export function Combobox({
115
119
  classNames,
116
120
  ref,
117
121
  id,
122
+ intent,
123
+ intentKey,
118
124
  onFocus,
119
125
  onClick,
120
126
  onBlur,
@@ -130,7 +136,11 @@ export function Combobox({
130
136
  const listId = `${inputId}-listbox`;
131
137
  const rootRef = useRef<HTMLDivElement | null>(null);
132
138
  const inputRef = useRef<HTMLInputElement | null>(null);
133
- const composedRef = useComposedRefs<HTMLInputElement>(ref, inputRef);
139
+ const composedRef = useComposedRefs<HTMLInputElement>(
140
+ ref,
141
+ inputRef,
142
+ useIntentTarget({ intent, intentKey }, { role: "combobox" }),
143
+ );
134
144
  const allOptions = useMemo(() => flattenItems(options), [options]);
135
145
  const [value, setValue] = useControllableState<string>({
136
146
  prop: valueProp,
@@ -229,6 +239,7 @@ export function Combobox({
229
239
  className={cn("relative flex w-full min-w-0", classNames?.root, className)}
230
240
  >
231
241
  <input
242
+ {...intentAttributes({ intent, intentKey })}
232
243
  {...props}
233
244
  ref={composedRef}
234
245
  id={inputId}
@@ -1,8 +1,11 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, type ReactNode, useId } from "react";
3
+ import { type ComponentPropsWithRef, type ReactNode, useId } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { Check, Copy } from "../../icons/index.js";
6
+ import { intentAttributes } from "../../intent/attributes.js";
7
+ import type { IntentProps } from "../../intent/types.js";
8
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
6
9
  import type { ClassNames } from "../../utils/class-names.js";
7
10
  import { cn } from "../../utils/cn.js";
8
11
  import { useCopy } from "../../utils/use-copy.js";
@@ -10,7 +13,8 @@ import { useCopy } from "../../utils/use-copy.js";
10
13
  export type CopyFieldPart = "root" | "label" | "box" | "value" | "button";
11
14
 
12
15
  export interface CopyFieldProps
13
- extends Omit<ComponentPropsWithoutRef<"div">, "children" | "onCopy"> {
16
+ extends Omit<ComponentPropsWithRef<"div">, "children" | "onCopy">,
17
+ IntentProps {
14
18
  label: ReactNode;
15
19
  /** Text shown in monospace and written to the clipboard. */
16
20
  value: string;
@@ -32,8 +36,11 @@ export function CopyField({
32
36
  copiedLabel,
33
37
  className,
34
38
  classNames,
39
+ intent,
40
+ intentKey,
35
41
  ...props
36
42
  }: CopyFieldProps) {
43
+ const inputRef = useIntentTarget<HTMLInputElement>({ intent, intentKey });
37
44
  const strings = useUiStrings();
38
45
  const id = useId();
39
46
  const { copied, copy } = useCopy(1500);
@@ -51,6 +58,8 @@ export function CopyField({
51
58
  )}
52
59
  >
53
60
  <input
61
+ {...intentAttributes({ intent, intentKey })}
62
+ ref={inputRef}
54
63
  id={id}
55
64
  readOnly
56
65
  value={value}
@@ -5,6 +5,9 @@ import { DateCalendar } from "../../calendar/date-calendar/date-calendar.js";
5
5
  import { isIsoDate, type WeekStart } from "../../calendar/internal/date-utils.js";
6
6
  import { useUiStrings } from "../../i18n/index.js";
7
7
  import { Calendar as CalendarIcon, X } from "../../icons/index.js";
8
+ import { intentAttributes } from "../../intent/attributes.js";
9
+ import type { IntentProps } from "../../intent/types.js";
10
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
8
11
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
9
12
  import type { ClassNames } from "../../utils/class-names.js";
10
13
  import { cn } from "../../utils/cn.js";
@@ -23,17 +26,18 @@ export type DatePickerPart = "root" | "input" | "clear" | "trigger" | "content"
23
26
 
24
27
  export interface DatePickerProps
25
28
  extends Omit<
26
- ComponentProps<"input">,
27
- | "value"
28
- | "defaultValue"
29
- | "onChange"
30
- | "type"
31
- | "min"
32
- | "max"
33
- | "size"
34
- | "inputMode"
35
- | "maxLength"
36
- > {
29
+ ComponentProps<"input">,
30
+ | "value"
31
+ | "defaultValue"
32
+ | "onChange"
33
+ | "type"
34
+ | "min"
35
+ | "max"
36
+ | "size"
37
+ | "inputMode"
38
+ | "maxLength"
39
+ >,
40
+ IntentProps {
37
41
  /** Selected date as "YYYY-MM-DD" (controlled); `""` means none. Never converted through a time zone. */
38
42
  value?: string;
39
43
  defaultValue?: string;
@@ -95,6 +99,8 @@ export function DatePicker({
95
99
  className,
96
100
  classNames,
97
101
  ref,
102
+ intent,
103
+ intentKey,
98
104
  onBlur,
99
105
  onKeyDown,
100
106
  "aria-invalid": ariaInvalid,
@@ -104,7 +110,11 @@ export function DatePicker({
104
110
  const locale = localeProp || strings.locale;
105
111
  const format = useMemo(() => dateFormatFor(locale), [locale]);
106
112
  const inputRef = useRef<HTMLInputElement | null>(null);
107
- const composedRef = useComposedRefs<HTMLInputElement>(ref, inputRef);
113
+ const composedRef = useComposedRefs<HTMLInputElement>(
114
+ ref,
115
+ inputRef,
116
+ useIntentTarget({ intent, intentKey }),
117
+ );
108
118
  const [current, setCurrent] = useControllableState<string>({
109
119
  prop: valueProp,
110
120
  defaultProp: defaultValue,
@@ -147,6 +157,7 @@ export function DatePicker({
147
157
  <PopoverPrimitive.Anchor asChild>
148
158
  <div className={cn("relative flex w-full min-w-0", classNames?.root)}>
149
159
  <input
160
+ {...intentAttributes({ intent, intentKey })}
150
161
  {...props}
151
162
  ref={composedRef}
152
163
  type="text"
@@ -3,6 +3,7 @@
3
3
  import { type ComponentProps, useEffect, useId, useMemo, useState } from "react";
4
4
  import { isIsoDate, type WeekStart } from "../../calendar/internal/date-utils.js";
5
5
  import { useUiStrings } from "../../i18n/index.js";
6
+ import type { IntentProps } from "../../intent/types.js";
6
7
  import type { ClassNames } from "../../utils/class-names.js";
7
8
  import { cn } from "../../utils/cn.js";
8
9
  import type { Material } from "../../utils/material.js";
@@ -28,9 +29,10 @@ export type DateTimePickerPart =
28
29
 
29
30
  export interface DateTimePickerProps
30
31
  extends Omit<
31
- ComponentProps<"div">,
32
- "defaultValue" | "onChange" | "children" | "role" | "id" | "aria-label" | "aria-labelledby"
33
- > {
32
+ ComponentProps<"div">,
33
+ "defaultValue" | "onChange" | "children" | "role" | "id" | "aria-label" | "aria-labelledby"
34
+ >,
35
+ IntentProps {
34
36
  /**
35
37
  * "YYYY-MM-DDTHH:mm" (controlled), a wall-clock date and time with no zone: the component never
36
38
  * converts it, so "2026-09-07T09:30" stays that string whatever the browser's time zone is.
@@ -96,6 +98,8 @@ export function DateTimePicker({
96
98
  "aria-labelledby": ariaLabelledBy,
97
99
  "aria-describedby": ariaDescribedBy,
98
100
  "aria-invalid": ariaInvalid,
101
+ intent,
102
+ intentKey,
99
103
  ...props
100
104
  }: DateTimePickerProps) {
101
105
  const strings = useUiStrings();
@@ -161,6 +165,8 @@ export function DateTimePicker({
161
165
  >
162
166
  <DatePicker
163
167
  {...shared}
168
+ intent={intent}
169
+ intentKey={intentKey}
164
170
  id={dateId}
165
171
  value={parts.date}
166
172
  onValueChange={(date) => update({ ...parts, date })}
@@ -12,8 +12,12 @@ import {
12
12
  } from "react";
13
13
  import { useUiStrings } from "../../i18n/index.js";
14
14
  import { Upload, X } from "../../icons/index.js";
15
+ import { intentAttributes } from "../../intent/attributes.js";
16
+ import type { IntentProps } from "../../intent/types.js";
17
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
15
18
  import type { ClassNames } from "../../utils/class-names.js";
16
19
  import { cn } from "../../utils/cn.js";
20
+ import { useComposedRefs } from "../../utils/compose.js";
17
21
 
18
22
  export type DropzoneRejectionReason = "type" | "size";
19
23
 
@@ -24,7 +28,7 @@ export interface DropzoneRejection {
24
28
 
25
29
  export type DropzonePart = "root" | "icon" | "title" | "hint" | "browse" | "list" | "file";
26
30
 
27
- export interface DropzoneProps {
31
+ export interface DropzoneProps extends IntentProps {
28
32
  onFiles: (files: File[]) => void;
29
33
  /** Called with the rejected files; the caller composes the user-facing message. */
30
34
  onReject?: (rejections: DropzoneRejection[]) => void;
@@ -133,9 +137,13 @@ export function Dropzone({
133
137
  "aria-invalid": ariaInvalid,
134
138
  className,
135
139
  classNames,
140
+ intent,
141
+ intentKey,
136
142
  }: DropzoneProps) {
137
143
  const strings = useUiStrings();
138
144
  const inputRef = useRef<HTMLInputElement>(null);
145
+ const targetRef = useIntentTarget({ intent, intentKey });
146
+ const fieldInputRef = useComposedRefs<HTMLInputElement>(inputRef, targetRef);
139
147
  const [dragging, setDragging] = useState(false);
140
148
  const [selected, setSelected] = useState<File[]>([]);
141
149
  const autoId = useId();
@@ -259,7 +267,13 @@ export function Dropzone({
259
267
  {browseLabel}
260
268
  </span>
261
269
  ) : (
262
- <button type="button" className={browse} onClick={() => inputRef.current?.click()}>
270
+ <button
271
+ type="button"
272
+ {...intentAttributes({ intent, intentKey })}
273
+ ref={targetRef}
274
+ className={browse}
275
+ onClick={() => inputRef.current?.click()}
276
+ >
263
277
  {browseLabel}
264
278
  </button>
265
279
  )}
@@ -296,7 +310,8 @@ export function Dropzone({
296
310
  ) : null}
297
311
  {field ? (
298
312
  <input
299
- ref={inputRef}
313
+ {...intentAttributes({ intent, intentKey })}
314
+ ref={fieldInputRef}
300
315
  id={inputId}
301
316
  name={name}
302
317
  type="file"
@@ -2,8 +2,12 @@
2
2
 
3
3
  import { type KeyboardEvent, useId, useMemo, useRef, useState } from "react";
4
4
  import { Search } from "../../icons/index.js";
5
+ import { intentAttributes } from "../../intent/attributes.js";
6
+ import type { IntentProps } from "../../intent/types.js";
7
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
5
8
  import type { ClassNames } from "../../utils/class-names.js";
6
9
  import { cn } from "../../utils/cn.js";
10
+ import { useComposedRefs } from "../../utils/compose.js";
7
11
  import { EMOJI_CATEGORIES, type EmojiCategory, type EmojiEntry } from "./emoji-data.js";
8
12
  import { gridMove, searchEmojis } from "./model.js";
9
13
 
@@ -19,7 +23,7 @@ export type EmojiPickerPart =
19
23
  | "emoji"
20
24
  | "empty";
21
25
 
22
- export interface EmojiPickerProps {
26
+ export interface EmojiPickerProps extends IntentProps {
23
27
  onSelect?: (emoji: string) => void;
24
28
  /** Replaces the built-in dataset (`EMOJI_CATEGORIES`). */
25
29
  categories?: EmojiCategory[];
@@ -43,9 +47,12 @@ export function EmojiPicker({
43
47
  searchPlaceholder = "Buscar emoji",
44
48
  className,
45
49
  classNames,
50
+ intent,
51
+ intentKey,
46
52
  }: EmojiPickerProps) {
47
53
  const baseId = useId();
48
54
  const grid = useRef<HTMLDivElement>(null);
55
+ const gridRef = useComposedRefs<HTMLDivElement>(grid, useIntentTarget({ intent, intentKey }));
49
56
  const [query, setQuery] = useState("");
50
57
  const [categoryId, setCategoryId] = useState(defaultCategory ?? categories[0]?.id);
51
58
  const [active, setActive] = useState(0);
@@ -142,7 +149,8 @@ export function EmojiPicker({
142
149
 
143
150
  {/* biome-ignore lint/a11y/useSemanticElements: arrow-key grid of buttons with a roving tabindex */}
144
151
  <div
145
- ref={grid}
152
+ {...intentAttributes({ intent, intentKey })}
153
+ ref={gridRef}
146
154
  role="group"
147
155
  aria-labelledby={`${baseId}-title`}
148
156
  onKeyDown={onKeyDown}
@@ -2,6 +2,9 @@
2
2
 
3
3
  import { useState } from "react";
4
4
  import { SmilePlus } from "../../icons/index.js";
5
+ import { intentAttributes } from "../../intent/attributes.js";
6
+ import type { IntentProps } from "../../intent/types.js";
7
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
5
8
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
6
9
  import type { ClassNames } from "../../utils/class-names.js";
7
10
  import { cn } from "../../utils/cn.js";
@@ -9,7 +12,7 @@ import { EmojiPicker } from "../emoji-picker/emoji-picker.js";
9
12
 
10
13
  export type EmojiReactionButtonPart = "root" | "emoji" | "count";
11
14
 
12
- export interface EmojiReactionButtonProps {
15
+ export interface EmojiReactionButtonProps extends IntentProps {
13
16
  emoji: string;
14
17
  count: number;
15
18
  /** Whether the current user has used this reaction. */
@@ -30,9 +33,14 @@ export function EmojiReactionButton({
30
33
  disabled,
31
34
  className,
32
35
  classNames,
36
+ intent,
37
+ intentKey,
33
38
  }: EmojiReactionButtonProps) {
39
+ const buttonRef = useIntentTarget<HTMLButtonElement>({ intent, intentKey });
34
40
  return (
35
41
  <button
42
+ {...intentAttributes({ intent, intentKey })}
43
+ ref={buttonRef}
36
44
  type="button"
37
45
  aria-pressed={reacted}
38
46
  aria-label={`${emoji} ${count}`}
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  cloneElement,
6
6
  Fragment,
7
7
  isValidElement,
@@ -33,7 +33,7 @@ const FALLBACK_CONTROL = 'button:not([tabindex="-1"]), [tabindex]:not([tabindex=
33
33
 
34
34
  export type FieldPart = "root" | "label" | "optional" | "required" | "hint" | "error";
35
35
 
36
- export interface FieldProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "id"> {
36
+ export interface FieldProps extends Omit<ComponentPropsWithRef<"div">, "children" | "id"> {
37
37
  /** The label content: text or any node (an icon, a tooltip trigger). */
38
38
  label: ReactNode;
39
39
  hint?: string;
@@ -1,7 +1,7 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, ReactNode } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export interface FieldsetProps extends Omit<ComponentPropsWithoutRef<"fieldset">, "title"> {
4
+ export interface FieldsetProps extends Omit<ComponentPropsWithRef<"fieldset">, "title"> {
5
5
  /** The group name; announced with each control inside. */
6
6
  legend: ReactNode;
7
7
  description?: ReactNode;
@@ -1,14 +1,22 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, ReactNode } from "react";
2
+ import { intentAttributes } from "../../intent/attributes.js";
3
+ import type { IntentProps } from "../../intent/types.js";
2
4
  import { cn } from "../../utils/cn.js";
3
5
 
4
- export type FormProps = ComponentPropsWithoutRef<"form">;
6
+ export interface FormProps extends ComponentPropsWithRef<"form">, IntentProps {}
5
7
 
6
8
  /** Vertical form layout; every `<form>` attribute and handler passes through. */
7
- export function Form({ className, ...props }: FormProps) {
8
- return <form className={cn("flex min-w-0 flex-col gap-4", className)} {...props} />;
9
+ export function Form({ className, intent, intentKey, ...props }: FormProps) {
10
+ return (
11
+ <form
12
+ className={cn("flex min-w-0 flex-col gap-4", className)}
13
+ {...intentAttributes({ intent, intentKey })}
14
+ {...props}
15
+ />
16
+ );
9
17
  }
10
18
 
11
- interface FormMessageProps extends Omit<ComponentPropsWithoutRef<"p">, "role" | "children"> {
19
+ interface FormMessageProps extends Omit<ComponentPropsWithRef<"p">, "role" | "children"> {
12
20
  /** Message text; `null`, `undefined` and an empty string render nothing. */
13
21
  message: ReactNode | null | undefined;
14
22
  }
@@ -1,11 +1,11 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
3
+ import type { ComponentPropsWithRef, ReactNode } from "react";
4
4
  import { Button } from "../../atoms/button/index.js";
5
5
  import { useUiStrings } from "../../i18n/index.js";
6
6
  import { cn } from "../../utils/cn.js";
7
7
 
8
- export interface FormFooterProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
8
+ export interface FormFooterProps extends Omit<ComponentPropsWithRef<"div">, "children"> {
9
9
  /** Called by the cancel button; without it no cancel button renders. */
10
10
  onCancel?: () => void;
11
11
  cancelLabel?: string;
@@ -1,10 +1,10 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
4
  export type FormGridColumns = 1 | 2 | 3;
5
5
  export type FormGridSpan = 1 | 2 | 3 | "full";
6
6
 
7
- export interface FormGridProps extends ComponentPropsWithoutRef<"div"> {
7
+ export interface FormGridProps extends ComponentPropsWithRef<"div"> {
8
8
  /**
9
9
  * Largest column count, reached by container width: 2 columns from 620px, 3 from 900px
10
10
  * (the wrapper is the size container). `1` never splits. Default `2`.
@@ -38,7 +38,7 @@ export function FormGrid({ columns = 2, className, ...props }: FormGridProps) {
38
38
  );
39
39
  }
40
40
 
41
- export interface FormGridItemProps extends ComponentPropsWithoutRef<"div"> {
41
+ export interface FormGridItemProps extends ComponentPropsWithRef<"div"> {
42
42
  /**
43
43
  * Columns the item spans once the grid has them; it never adds a column the grid does not
44
44
  * have. `"full"` spans every column at any width. Default `1`.
@@ -1,7 +1,7 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, ReactNode } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export interface FormSectionProps extends Omit<ComponentPropsWithoutRef<"section">, "title"> {
4
+ export interface FormSectionProps extends Omit<ComponentPropsWithRef<"section">, "title"> {
5
5
  title: ReactNode;
6
6
  description?: ReactNode;
7
7
  /** The fields; usually a `FormGrid`. */