@jcsoftdev/ui 0.9.0 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (461) hide show
  1. package/CHANGELOG.md +132 -0
  2. package/README.md +22 -3
  3. package/dist/ai/attachment/attachment.d.ts +4 -3
  4. package/dist/ai/attachment/attachment.js +5 -1
  5. package/dist/ai/chat-message/chat-message.d.ts +4 -3
  6. package/dist/ai/chat-message/chat-message.js +5 -0
  7. package/dist/ai/code-block/code-block.js +2 -2
  8. package/dist/ai/conversation/conversation.d.ts +2 -2
  9. package/dist/ai/internal/disclosure.js +1 -1
  10. package/dist/ai/internal/icon-action.d.ts +4 -3
  11. package/dist/ai/internal/icon-action.js +11 -2
  12. package/dist/ai/message-actions/message-actions.d.ts +6 -3
  13. package/dist/ai/message-actions/message-actions.js +26 -1
  14. package/dist/ai/prompt-input/prompt-input.d.ts +3 -2
  15. package/dist/ai/prompt-input/prompt-input.js +14 -4
  16. package/dist/ai/prompt-suggestion/prompt-suggestion.d.ts +5 -4
  17. package/dist/ai/prompt-suggestion/prompt-suggestion.js +4 -0
  18. package/dist/ai/source/source.d.ts +4 -3
  19. package/dist/ai/source/source.js +16 -1
  20. package/dist/ai/tool-call/tool-call.d.ts +3 -2
  21. package/dist/ai/tool-call/tool-call.js +5 -1
  22. package/dist/atoms/big-date/big-date.d.ts +2 -2
  23. package/dist/atoms/button/button.d.ts +3 -2
  24. package/dist/atoms/button/button.js +9 -0
  25. package/dist/atoms/checkbox/checkbox.d.ts +5 -3
  26. package/dist/atoms/checkbox/checkbox.js +29 -19
  27. package/dist/atoms/chip/chip.d.ts +3 -2
  28. package/dist/atoms/chip/chip.js +10 -1
  29. package/dist/atoms/divider/divider.d.ts +2 -2
  30. package/dist/atoms/elapsed-time/elapsed-time.d.ts +2 -2
  31. package/dist/atoms/elapsed-time/elapsed-time.js +10 -7
  32. package/dist/atoms/elapsed-time/model.d.ts +8 -0
  33. package/dist/atoms/elapsed-time/model.js +44 -0
  34. package/dist/atoms/icon-button/icon-button.d.ts +2 -1
  35. package/dist/atoms/internal/labelled-control.d.ts +16 -0
  36. package/dist/atoms/internal/labelled-control.js +56 -0
  37. package/dist/atoms/number-value/number-value.d.ts +2 -2
  38. package/dist/atoms/pressable-feedback/pressable-feedback.d.ts +4 -3
  39. package/dist/atoms/pressable-feedback/pressable-feedback.js +13 -1
  40. package/dist/atoms/progress/progress.d.ts +2 -2
  41. package/dist/atoms/radio-group/radio-group-primitive.d.ts +3 -2
  42. package/dist/atoms/radio-group/radio-group-primitive.js +10 -1
  43. package/dist/atoms/radio-group/radio-group.d.ts +2 -0
  44. package/dist/atoms/radio-group/radio-group.js +3 -1
  45. package/dist/atoms/seal/seal.d.ts +2 -2
  46. package/dist/atoms/status-pill/status-pill.js +1 -1
  47. package/dist/atoms/switch/switch.d.ts +7 -4
  48. package/dist/atoms/switch/switch.js +35 -5
  49. package/dist/atoms/table-glyph/table-glyph.d.ts +2 -2
  50. package/dist/atoms/trend-chip/trend-chip.d.ts +2 -2
  51. package/dist/auth/login-form/parts.js +2 -2
  52. package/dist/calendar/date-calendar/date-calendar.js +1 -1
  53. package/dist/calendar/day-chip/day-chip.d.ts +3 -2
  54. package/dist/calendar/day-chip/day-chip.js +12 -1
  55. package/dist/calendar/event-block/event-block.d.ts +3 -2
  56. package/dist/calendar/event-block/event-block.js +7 -0
  57. package/dist/calendar/internal/grid-navigation.d.ts +11 -0
  58. package/dist/calendar/internal/grid-navigation.js +34 -0
  59. package/dist/calendar/internal/intent.d.ts +3 -0
  60. package/dist/calendar/internal/intent.js +7 -0
  61. package/dist/calendar/internal/month-model.d.ts +11 -0
  62. package/dist/calendar/internal/month-model.js +11 -0
  63. package/dist/calendar/internal/types.d.ts +4 -0
  64. package/dist/calendar/month-view/month-grid.d.ts +27 -0
  65. package/dist/calendar/month-view/month-grid.js +210 -0
  66. package/dist/calendar/month-view/month-view.d.ts +3 -1
  67. package/dist/calendar/month-view/month-view.js +29 -131
  68. package/dist/calendar/week-view/week-view.d.ts +3 -1
  69. package/dist/calendar/week-view/week-view.js +218 -128
  70. package/dist/charts/bar-chart/bar-race-chart.js +1 -1
  71. package/dist/charts/core/breadcrumb.js +1 -1
  72. package/dist/charts/core/chart-states.js +1 -1
  73. package/dist/charts/core/distribution/xy-points.js +4 -2
  74. package/dist/charts/crossfilter/crossfilter.js +1 -1
  75. package/dist/charts/gantt-chart/gantt-chart.js +1 -1
  76. package/dist/charts/maps/geo/map-data-table.js +1 -1
  77. package/dist/charts/sankey-chart/sankey-chart.js +1 -3
  78. package/dist/charts/tree-chart/tree-chart.js +1 -1
  79. package/dist/containers/action-bar/action-bar.d.ts +2 -2
  80. package/dist/containers/action-bar/action-bar.js +1 -1
  81. package/dist/containers/aside/aside.d.ts +3 -3
  82. package/dist/containers/banner/banner.d.ts +2 -2
  83. package/dist/containers/card/card.d.ts +5 -5
  84. package/dist/containers/card/card.js +3 -1
  85. package/dist/containers/carousel/carousel.d.ts +2 -2
  86. package/dist/containers/carousel/carousel.js +2 -2
  87. package/dist/containers/cols/cols.d.ts +3 -3
  88. package/dist/containers/comment/comment.d.ts +2 -2
  89. package/dist/containers/confirm-action/confirm-action.d.ts +3 -2
  90. package/dist/containers/confirm-action/confirm-action.js +10 -2
  91. package/dist/containers/dashboard/dashboard.d.ts +4 -4
  92. package/dist/containers/data-grid/column-menu.js +1 -1
  93. package/dist/containers/data-grid/data-grid.d.ts +7 -3
  94. package/dist/containers/data-grid/data-grid.js +45 -7
  95. package/dist/containers/data-grid/formula-bar.js +1 -1
  96. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  97. package/dist/containers/data-grid/tool-panel.js +1 -1
  98. package/dist/containers/description-list/description-list.d.ts +2 -2
  99. package/dist/containers/detail-header/detail-header.d.ts +2 -2
  100. package/dist/containers/facts/facts.d.ts +2 -2
  101. package/dist/containers/feed/feed.d.ts +5 -4
  102. package/dist/containers/feed/feed.js +12 -0
  103. package/dist/containers/file-tree/file-tree.js +11 -0
  104. package/dist/containers/file-tree/model.d.ts +2 -0
  105. package/dist/containers/filter-bar/filter-bar.d.ts +2 -2
  106. package/dist/containers/floor-plan/floor-plan.d.ts +2 -0
  107. package/dist/containers/floor-plan/floor-plan.js +17 -9
  108. package/dist/containers/floor-plan/index.d.ts +1 -1
  109. package/dist/containers/floor-plan/index.js +6 -1
  110. package/dist/containers/floor-plan/model.d.ts +3 -0
  111. package/dist/containers/floor-plan/model.js +8 -0
  112. package/dist/containers/generic-row/generic-row.d.ts +8 -6
  113. package/dist/containers/generic-row/generic-row.js +3 -1
  114. package/dist/containers/grid/grid.d.ts +2 -2
  115. package/dist/containers/hbars/hbars.js +2 -2
  116. package/dist/containers/highlight-line/highlight-line.d.ts +2 -2
  117. package/dist/containers/item-card-group/item-card-group.d.ts +4 -2
  118. package/dist/containers/item-card-group/item-card-group.js +4 -0
  119. package/dist/containers/kanban/kanban.js +13 -0
  120. package/dist/containers/kanban/model.d.ts +2 -0
  121. package/dist/containers/kpi/kpi-model.d.ts +7 -0
  122. package/dist/containers/kpi/kpi-model.js +22 -0
  123. package/dist/containers/kpi/kpi-parts.d.ts +28 -0
  124. package/dist/containers/kpi/kpi-parts.js +121 -0
  125. package/dist/containers/kpi/kpi.d.ts +7 -30
  126. package/dist/containers/kpi/kpi.js +4 -119
  127. package/dist/containers/kpi-group/kpi-group.d.ts +2 -2
  128. package/dist/containers/list-detail/list-detail.d.ts +12 -11
  129. package/dist/containers/list-detail/list-detail.js +9 -1
  130. package/dist/containers/note/note.d.ts +2 -2
  131. package/dist/containers/order-ticket/index.d.ts +1 -1
  132. package/dist/containers/order-ticket/index.js +2 -0
  133. package/dist/containers/order-ticket/model.d.ts +6 -0
  134. package/dist/containers/order-ticket/model.js +9 -0
  135. package/dist/containers/order-ticket/order-ticket.d.ts +4 -3
  136. package/dist/containers/order-ticket/order-ticket.js +26 -10
  137. package/dist/containers/page/page.d.ts +2 -2
  138. package/dist/containers/page-header/back.d.ts +2 -2
  139. package/dist/containers/page-header/page-header.d.ts +6 -6
  140. package/dist/containers/pagination/cursor-pagination.d.ts +2 -2
  141. package/dist/containers/pagination/pagination.d.ts +2 -2
  142. package/dist/containers/pagination/pagination.js +2 -2
  143. package/dist/containers/resizable/resizable.d.ts +4 -4
  144. package/dist/containers/resizable/resizable.js +1 -1
  145. package/dist/containers/row-actions/row-actions.d.ts +4 -3
  146. package/dist/containers/row-actions/row-actions.js +14 -1
  147. package/dist/containers/scrolly/scrolly.js +1 -1
  148. package/dist/containers/section/section.d.ts +10 -9
  149. package/dist/containers/section/section.js +12 -0
  150. package/dist/containers/selectable-card/selectable-card.d.ts +3 -2
  151. package/dist/containers/selectable-card/selectable-card.js +10 -1
  152. package/dist/containers/settings-layout/settings-layout.d.ts +7 -6
  153. package/dist/containers/settings-layout/settings-layout.js +10 -1
  154. package/dist/containers/settings-row/settings-row.d.ts +4 -3
  155. package/dist/containers/settings-row/settings-row.js +4 -0
  156. package/dist/containers/shortcuts/shortcuts.d.ts +3 -3
  157. package/dist/containers/stack/stack.d.ts +2 -2
  158. package/dist/containers/table/table.d.ts +14 -13
  159. package/dist/containers/table/table.js +22 -4
  160. package/dist/containers/timeline/timeline.d.ts +5 -4
  161. package/dist/containers/timeline/timeline.js +12 -0
  162. package/dist/containers/toolbar/toolbar.d.ts +3 -3
  163. package/dist/forms/accent-picker/accent-picker.d.ts +5 -2
  164. package/dist/forms/accent-picker/accent-picker.js +22 -1
  165. package/dist/forms/checkbox-button-group/checkbox-button-group.d.ts +3 -2
  166. package/dist/forms/checkbox-button-group/checkbox-button-group.js +16 -0
  167. package/dist/forms/chip-group/chip-group.d.ts +4 -1
  168. package/dist/forms/chip-group/chip-group.js +20 -2
  169. package/dist/forms/combobox/combobox.d.ts +3 -2
  170. package/dist/forms/combobox/combobox.js +10 -1
  171. package/dist/forms/copy-field/copy-field.d.ts +4 -3
  172. package/dist/forms/copy-field/copy-field.js +7 -0
  173. package/dist/forms/date-picker/date-picker.d.ts +3 -2
  174. package/dist/forms/date-picker/date-picker.js +10 -1
  175. package/dist/forms/date-picker/date-time-picker.d.ts +3 -2
  176. package/dist/forms/date-picker/date-time-picker.js +4 -0
  177. package/dist/forms/dropzone/dropzone.d.ts +3 -2
  178. package/dist/forms/dropzone/dropzone.js +21 -3
  179. package/dist/forms/emoji-picker/emoji-picker.d.ts +3 -2
  180. package/dist/forms/emoji-picker/emoji-picker.js +9 -2
  181. package/dist/forms/emoji-reaction-button/emoji-reaction-button.d.ts +3 -2
  182. package/dist/forms/emoji-reaction-button/emoji-reaction-button.js +8 -1
  183. package/dist/forms/field/field.d.ts +2 -2
  184. package/dist/forms/fieldset/fieldset.d.ts +2 -2
  185. package/dist/forms/form/form.d.ts +6 -4
  186. package/dist/forms/form/form.js +10 -2
  187. package/dist/forms/form-footer/form-footer.d.ts +2 -2
  188. package/dist/forms/form-grid/form-grid.d.ts +3 -3
  189. package/dist/forms/form-section/form-section.d.ts +2 -2
  190. package/dist/forms/inline-select/inline-select.d.ts +4 -3
  191. package/dist/forms/inline-select/inline-select.js +9 -1
  192. package/dist/forms/input/input.d.ts +3 -2
  193. package/dist/forms/input/input.js +11 -3
  194. package/dist/forms/internal/button-option.d.ts +2 -0
  195. package/dist/forms/label/label.d.ts +2 -2
  196. package/dist/forms/native-select/native-select.d.ts +4 -3
  197. package/dist/forms/native-select/native-select.js +4 -0
  198. package/dist/forms/number-stepper/number-stepper.d.ts +2 -1
  199. package/dist/forms/number-stepper/number-stepper.js +13 -3
  200. package/dist/forms/password-input/password-input.d.ts +1 -1
  201. package/dist/forms/password-input/password-input.js +12 -0
  202. package/dist/forms/pin-input/pin-input.d.ts +3 -2
  203. package/dist/forms/pin-input/pin-input.js +8 -1
  204. package/dist/forms/radio-button-group/radio-button-group.d.ts +3 -2
  205. package/dist/forms/radio-button-group/radio-button-group.js +16 -0
  206. package/dist/forms/rating/rating.d.ts +3 -2
  207. package/dist/forms/rating/rating.js +12 -0
  208. package/dist/forms/select/select.d.ts +4 -3
  209. package/dist/forms/select/select.js +11 -2
  210. package/dist/forms/select-menu/select-menu.d.ts +3 -2
  211. package/dist/forms/select-menu/select-menu.js +10 -1
  212. package/dist/forms/slider/model.d.ts +1 -0
  213. package/dist/forms/slider/model.js +5 -0
  214. package/dist/forms/slider/slider.d.ts +2 -1
  215. package/dist/forms/slider/slider.js +12 -3
  216. package/dist/forms/textarea/textarea.d.ts +4 -3
  217. package/dist/forms/textarea/textarea.js +4 -2
  218. package/dist/forms/time-input/time-input.d.ts +4 -3
  219. package/dist/forms/time-input/time-input.js +13 -1
  220. package/dist/i18n/strings.d.ts +18 -0
  221. package/dist/i18n/strings.js +12 -0
  222. package/dist/intent/attributes.d.ts +11 -0
  223. package/dist/intent/attributes.js +77 -0
  224. package/dist/intent/bridge.d.ts +8 -0
  225. package/dist/intent/bridge.js +19 -0
  226. package/dist/intent/index.d.ts +4 -0
  227. package/dist/intent/index.js +31 -0
  228. package/dist/intent/target-registrations.d.ts +16 -0
  229. package/dist/intent/target-registrations.js +91 -0
  230. package/dist/intent/types.d.ts +29 -0
  231. package/dist/intent/types.js +0 -0
  232. package/dist/intent/use-intent-target.d.ts +4 -0
  233. package/dist/intent/use-intent-target.js +75 -0
  234. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +6 -4
  235. package/dist/navigation/breadcrumbs/breadcrumbs.js +11 -1
  236. package/dist/navigation/floating-toc/floating-toc.d.ts +2 -2
  237. package/dist/navigation/floating-toc/floating-toc.js +5 -0
  238. package/dist/navigation/floating-toc/model.d.ts +2 -1
  239. package/dist/navigation/segmented/segmented.d.ts +3 -2
  240. package/dist/navigation/segmented/segmented.js +11 -1
  241. package/dist/navigation/stepper/stepper.d.ts +4 -2
  242. package/dist/navigation/stepper/stepper.js +3 -0
  243. package/dist/navigation/tabs/tabs-nav.d.ts +5 -4
  244. package/dist/navigation/tabs/tabs-nav.js +11 -0
  245. package/dist/navigation/tabs/tabs.d.ts +6 -5
  246. package/dist/navigation/tabs/tabs.js +44 -2
  247. package/dist/navigation/wizard/wizard.d.ts +4 -3
  248. package/dist/navigation/wizard/wizard.js +9 -1
  249. package/dist/overlays/alert-dialog/alert-dialog.d.ts +5 -4
  250. package/dist/overlays/alert-dialog/alert-dialog.js +20 -3
  251. package/dist/overlays/context-menu/context-menu.d.ts +14 -12
  252. package/dist/overlays/context-menu/context-menu.js +57 -8
  253. package/dist/overlays/dialog/dialog.d.ts +14 -8
  254. package/dist/overlays/dialog/dialog.js +29 -6
  255. package/dist/overlays/drawer/drawer.d.ts +6 -5
  256. package/dist/overlays/drawer/drawer.js +11 -0
  257. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +14 -13
  258. package/dist/overlays/dropdown-menu/dropdown-menu.js +58 -5
  259. package/dist/overlays/hover-card/hover-card.d.ts +4 -3
  260. package/dist/overlays/hover-card/hover-card.js +12 -1
  261. package/dist/overlays/popover/popover.d.ts +3 -2
  262. package/dist/overlays/popover/popover.js +12 -1
  263. package/dist/overlays/tooltip/model.d.ts +1 -0
  264. package/dist/overlays/tooltip/model.js +8 -0
  265. package/dist/overlays/tooltip/tooltip.d.ts +2 -1
  266. package/dist/overlays/tooltip/tooltip.js +8 -2
  267. package/dist/palette/command-palette/command-palette.d.ts +8 -4
  268. package/dist/palette/command-palette/command-palette.js +49 -1
  269. package/dist/palette/command-palette/index.d.ts +1 -0
  270. package/dist/palette/command-palette/index.js +3 -1
  271. package/dist/palette/command-palette/model.d.ts +7 -0
  272. package/dist/palette/command-palette/model.js +11 -0
  273. package/dist/primitives/command/command.js +4 -1
  274. package/dist/primitives/dialog/dialog.js +1 -3
  275. package/dist/primitives/popper/popper.js +15 -4
  276. package/dist/shell/bottom-nav/bottom-nav.js +54 -42
  277. package/dist/shell/sidebar/sidebar.d.ts +5 -3
  278. package/dist/shell/sidebar/sidebar.js +14 -2
  279. package/dist/shell/topbar/topbar.js +2 -2
  280. package/dist/showcase/bento.js +1 -0
  281. package/dist/utils/is-production.d.ts +1 -0
  282. package/dist/utils/is-production.js +6 -0
  283. package/dist/utils/slot.js +17 -3
  284. package/package.json +2 -2
  285. package/src/ai/attachment/attachment.tsx +10 -3
  286. package/src/ai/chat-message/chat-message.tsx +10 -2
  287. package/src/ai/code-block/code-block.tsx +2 -2
  288. package/src/ai/conversation/conversation.tsx +2 -2
  289. package/src/ai/internal/disclosure.tsx +1 -1
  290. package/src/ai/internal/icon-action.tsx +14 -4
  291. package/src/ai/message-actions/message-actions.tsx +28 -3
  292. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  293. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  294. package/src/ai/source/source.tsx +17 -3
  295. package/src/ai/tool-call/tool-call.tsx +6 -1
  296. package/src/atoms/big-date/big-date.tsx +2 -2
  297. package/src/atoms/button/button.tsx +11 -1
  298. package/src/atoms/checkbox/checkbox.tsx +40 -21
  299. package/src/atoms/chip/chip.tsx +12 -2
  300. package/src/atoms/divider/divider.tsx +2 -2
  301. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  302. package/src/atoms/elapsed-time/model.ts +57 -0
  303. package/src/atoms/icon-button/icon-button.tsx +3 -1
  304. package/src/atoms/internal/labelled-control.tsx +83 -0
  305. package/src/atoms/number-value/number-value.tsx +2 -2
  306. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  307. package/src/atoms/progress/progress.tsx +2 -2
  308. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  309. package/src/atoms/radio-group/radio-group.tsx +5 -1
  310. package/src/atoms/seal/seal.tsx +2 -2
  311. package/src/atoms/status-pill/status-pill.tsx +1 -1
  312. package/src/atoms/switch/switch.tsx +43 -9
  313. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  314. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  315. package/src/auth/login-form/parts.tsx +2 -2
  316. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  317. package/src/calendar/day-chip/day-chip.tsx +14 -2
  318. package/src/calendar/event-block/event-block.tsx +9 -1
  319. package/src/calendar/internal/grid-navigation.ts +47 -0
  320. package/src/calendar/internal/intent.ts +10 -0
  321. package/src/calendar/internal/month-model.ts +23 -0
  322. package/src/calendar/internal/types.ts +4 -0
  323. package/src/calendar/month-view/month-grid.tsx +248 -0
  324. package/src/calendar/month-view/month-view.tsx +32 -148
  325. package/src/calendar/week-view/week-view.tsx +87 -10
  326. package/src/charts/README.md +10 -0
  327. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  328. package/src/charts/core/breadcrumb.tsx +1 -1
  329. package/src/charts/core/chart-states.tsx +1 -1
  330. package/src/charts/core/distribution/xy-points.tsx +4 -2
  331. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  332. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  333. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  334. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  335. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  336. package/src/containers/action-bar/action-bar.tsx +3 -3
  337. package/src/containers/aside/aside.tsx +3 -3
  338. package/src/containers/banner/banner.tsx +2 -2
  339. package/src/containers/card/card.tsx +7 -5
  340. package/src/containers/carousel/carousel.tsx +4 -4
  341. package/src/containers/cols/cols.tsx +3 -3
  342. package/src/containers/comment/comment.tsx +2 -2
  343. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  344. package/src/containers/dashboard/dashboard.tsx +4 -4
  345. package/src/containers/data-grid/column-menu.tsx +1 -1
  346. package/src/containers/data-grid/data-grid.tsx +53 -4
  347. package/src/containers/data-grid/formula-bar.tsx +1 -1
  348. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  349. package/src/containers/data-grid/tool-panel.tsx +1 -1
  350. package/src/containers/description-list/description-list.tsx +2 -2
  351. package/src/containers/detail-header/detail-header.tsx +2 -2
  352. package/src/containers/facts/facts.tsx +2 -2
  353. package/src/containers/feed/feed.tsx +16 -3
  354. package/src/containers/file-tree/file-tree.tsx +11 -0
  355. package/src/containers/file-tree/model.ts +2 -0
  356. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  357. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  358. package/src/containers/floor-plan/index.ts +7 -1
  359. package/src/containers/floor-plan/model.ts +16 -0
  360. package/src/containers/generic-row/generic-row.tsx +9 -6
  361. package/src/containers/grid/grid.tsx +2 -2
  362. package/src/containers/hbars/hbars.tsx +23 -21
  363. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  364. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  365. package/src/containers/kanban/kanban.tsx +13 -0
  366. package/src/containers/kanban/model.ts +2 -0
  367. package/src/containers/kpi/kpi-model.ts +37 -0
  368. package/src/containers/kpi/kpi-parts.tsx +153 -0
  369. package/src/containers/kpi/kpi.tsx +10 -176
  370. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  371. package/src/containers/list-detail/list-detail.tsx +22 -12
  372. package/src/containers/note/note.tsx +2 -2
  373. package/src/containers/order-ticket/index.ts +2 -0
  374. package/src/containers/order-ticket/model.ts +21 -0
  375. package/src/containers/order-ticket/order-ticket.tsx +30 -13
  376. package/src/containers/page/page.tsx +2 -2
  377. package/src/containers/page-header/back.tsx +2 -2
  378. package/src/containers/page-header/page-header.tsx +6 -6
  379. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  380. package/src/containers/pagination/pagination.tsx +4 -4
  381. package/src/containers/resizable/resizable.tsx +7 -5
  382. package/src/containers/row-actions/row-actions.tsx +18 -3
  383. package/src/containers/scrolly/scrolly.tsx +1 -1
  384. package/src/containers/section/section.tsx +21 -8
  385. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  386. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  387. package/src/containers/settings-row/settings-row.tsx +7 -2
  388. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  389. package/src/containers/stack/stack.tsx +2 -2
  390. package/src/containers/table/table.tsx +35 -14
  391. package/src/containers/timeline/timeline.tsx +17 -3
  392. package/src/containers/toolbar/toolbar.tsx +3 -3
  393. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  394. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  395. package/src/forms/chip-group/chip-group.tsx +23 -2
  396. package/src/forms/combobox/combobox.tsx +15 -4
  397. package/src/forms/copy-field/copy-field.tsx +11 -2
  398. package/src/forms/date-picker/date-picker.tsx +23 -12
  399. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  400. package/src/forms/dropzone/dropzone.tsx +18 -3
  401. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  402. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  403. package/src/forms/field/field.tsx +2 -2
  404. package/src/forms/fieldset/fieldset.tsx +2 -2
  405. package/src/forms/form/form.tsx +13 -5
  406. package/src/forms/form-footer/form-footer.tsx +2 -2
  407. package/src/forms/form-grid/form-grid.tsx +3 -3
  408. package/src/forms/form-section/form-section.tsx +2 -2
  409. package/src/forms/inline-select/inline-select.tsx +14 -3
  410. package/src/forms/input/input.tsx +14 -3
  411. package/src/forms/internal/button-option.tsx +2 -0
  412. package/src/forms/label/label.tsx +2 -2
  413. package/src/forms/native-select/native-select.tsx +9 -2
  414. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  415. package/src/forms/password-input/password-input.tsx +12 -0
  416. package/src/forms/pin-input/pin-input.tsx +9 -1
  417. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  418. package/src/forms/rating/rating.tsx +14 -1
  419. package/src/forms/select/select.tsx +14 -4
  420. package/src/forms/select-menu/select-menu.tsx +15 -4
  421. package/src/forms/slider/model.ts +5 -0
  422. package/src/forms/slider/slider.tsx +13 -3
  423. package/src/forms/textarea/textarea.tsx +7 -4
  424. package/src/forms/time-input/time-input.tsx +19 -5
  425. package/src/i18n/strings.ts +18 -0
  426. package/src/intent/attributes.ts +96 -0
  427. package/src/intent/bridge.tsx +25 -0
  428. package/src/intent/index.ts +24 -0
  429. package/src/intent/target-registrations.ts +127 -0
  430. package/src/intent/types.ts +44 -0
  431. package/src/intent/use-intent-target.ts +96 -0
  432. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  433. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  434. package/src/navigation/floating-toc/model.ts +3 -1
  435. package/src/navigation/segmented/segmented.tsx +14 -2
  436. package/src/navigation/stepper/stepper.tsx +7 -2
  437. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  438. package/src/navigation/tabs/tabs.tsx +57 -4
  439. package/src/navigation/wizard/wizard.tsx +12 -4
  440. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  441. package/src/overlays/context-menu/context-menu.tsx +58 -11
  442. package/src/overlays/dialog/dialog.tsx +49 -20
  443. package/src/overlays/drawer/drawer.tsx +15 -4
  444. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  445. package/src/overlays/hover-card/hover-card.tsx +13 -2
  446. package/src/overlays/popover/popover.tsx +12 -1
  447. package/src/overlays/tooltip/model.ts +8 -0
  448. package/src/overlays/tooltip/tooltip.tsx +15 -2
  449. package/src/palette/command-palette/command-palette.tsx +66 -3
  450. package/src/palette/command-palette/index.ts +1 -0
  451. package/src/palette/command-palette/model.ts +15 -0
  452. package/src/primitives/command/command.tsx +4 -1
  453. package/src/primitives/dialog/dialog.tsx +1 -4
  454. package/src/primitives/popper/popper.tsx +16 -5
  455. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  456. package/src/shell/sidebar/sidebar.tsx +22 -4
  457. package/src/shell/topbar/topbar.tsx +2 -2
  458. package/src/showcase/bento.tsx +2 -0
  459. package/src/utils/is-production.ts +3 -0
  460. package/src/utils/slot.tsx +21 -3
  461. package/styles/base.css +39 -0
@@ -1,4 +1,4 @@
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 StackDirection = "column" | "row";
@@ -22,7 +22,7 @@ const alignClasses: Record<StackAlign, string> = {
22
22
  baseline: "items-baseline",
23
23
  };
24
24
 
25
- export interface StackProps extends ComponentPropsWithoutRef<"div"> {
25
+ export interface StackProps extends ComponentPropsWithRef<"div"> {
26
26
  /** `column` stacks children vertically, `row` lays them out inline and wraps. Defaults to `column`. */
27
27
  direction?: StackDirection;
28
28
  /** Space between children. Defaults to `md`. */
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  type CSSProperties,
6
6
  createContext,
7
7
  type ReactNode,
@@ -23,7 +23,11 @@ import {
23
23
  ChevronsUpDown,
24
24
  PinOff,
25
25
  } from "../../icons/index.js";
26
+ import { intentAttributes } from "../../intent/attributes.js";
27
+ import type { IntentProps } from "../../intent/types.js";
28
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
26
29
  import { cn } from "../../utils/cn.js";
30
+ import { useComposedRefs } from "../../utils/compose.js";
27
31
  import { useControllableState } from "../../utils/use-controllable-state.js";
28
32
  import { CELL_PY } from "./cell-padding.js";
29
33
  import {
@@ -130,7 +134,7 @@ const STICKY_EDGE = "[&_:is(th,td):last-child]:[--sticky-edge:var(--shadow-pinne
130
134
  const STICKY_HEADER =
131
135
  "[&_thead_th]:sticky [&_thead_th]:top-0 [&_thead_th]:z-2 [&_thead_th]:bg-surface [&_thead_th]:shadow-[inset_0_-1px_0_var(--border-color-divider)]";
132
136
 
133
- export interface TableProps extends ComponentPropsWithoutRef<"table"> {
137
+ export interface TableProps extends ComponentPropsWithRef<"table"> {
134
138
  /** Controlled pinned columns (ids of `columnId`). Pair it with `onPinnedColumnsChange`. */
135
139
  pinnedColumns?: PinnedColumns;
136
140
  /** Initial pins when uncontrolled. */
@@ -398,11 +402,11 @@ export function Table({
398
402
  );
399
403
  }
400
404
 
401
- export function TableHead(props: ComponentPropsWithoutRef<"thead">) {
405
+ export function TableHead(props: ComponentPropsWithRef<"thead">) {
402
406
  return <thead {...props} />;
403
407
  }
404
408
 
405
- export function TableBody(props: ComponentPropsWithoutRef<"tbody">) {
409
+ export function TableBody(props: ComponentPropsWithRef<"tbody">) {
406
410
  return <tbody {...props} />;
407
411
  }
408
412
 
@@ -440,7 +444,7 @@ function PinButtons({ columnId }: { columnId: string }) {
440
444
  if (!context) return null;
441
445
  const side = context.positions[columnId]?.side;
442
446
  const button =
443
- "grid size-5 shrink-0 place-items-center rounded-xs text-ink-3 hover:bg-surface-2 hover:text-ink focus-visible:text-ink";
447
+ "relative grid size-5 shrink-0 place-items-center rounded-xs text-ink-3 before:absolute before:-inset-0.5 before:content-[''] hover:bg-surface-2 hover:text-ink focus-visible:text-ink";
444
448
  if (side) {
445
449
  return (
446
450
  <button
@@ -498,7 +502,7 @@ function SortButton({
498
502
  type="button"
499
503
  onClick={() => context.toggle(columnId)}
500
504
  className={cn(
501
- "-mx-1 inline-flex items-center gap-1 rounded-xs px-1 font-[inherit] text-[length:inherit] uppercase tracking-[inherit] hover:text-ink focus-visible:focus-ring",
505
+ "relative -mx-1 inline-flex items-center gap-1 rounded-xs px-1 before:absolute before:-inset-y-1 before:inset-x-0 before:content-[''] font-[inherit] text-[length:inherit] uppercase tracking-[inherit] hover:text-ink focus-visible:focus-ring",
502
506
  direction !== "none" ? "text-ink" : "text-inherit",
503
507
  )}
504
508
  >
@@ -520,7 +524,7 @@ export function TableHeaderCell({
520
524
  children,
521
525
  style,
522
526
  ...props
523
- }: ComponentPropsWithoutRef<"th"> &
527
+ }: ComponentPropsWithRef<"th"> &
524
528
  AlignProps & {
525
529
  pinnable?: boolean;
526
530
  /**
@@ -567,7 +571,7 @@ export function TableHeaderCell({
567
571
  );
568
572
  }
569
573
 
570
- export interface TableRowProps extends ComponentPropsWithoutRef<"tr"> {
574
+ export interface TableRowProps extends ComponentPropsWithRef<"tr">, IntentProps {
571
575
  /**
572
576
  * Identifies the row for selection. In a table with selection the row reports `aria-selected`
573
577
  * and highlights when its key is selected.
@@ -575,12 +579,17 @@ export interface TableRowProps extends ComponentPropsWithoutRef<"tr"> {
575
579
  rowKey?: string;
576
580
  }
577
581
 
578
- export function TableRow({ className, rowKey, ...props }: TableRowProps) {
582
+ export function TableRow({ className, rowKey, intent, intentKey, ref, ...props }: TableRowProps) {
583
+ const targetRef = useComposedRefs(
584
+ ref,
585
+ useIntentTarget<HTMLTableRowElement>({ intent, intentKey }, { requireName: false }),
586
+ );
579
587
  const selection = useContext(SelectionContext);
580
588
  const isSelected =
581
589
  selection && rowKey !== undefined ? selection.selected.includes(rowKey) : undefined;
582
590
  return (
583
591
  <tr
592
+ {...intentAttributes({ intent, intentKey })}
584
593
  aria-selected={isSelected}
585
594
  data-selected={isSelected || undefined}
586
595
  className={cn(
@@ -589,11 +598,12 @@ export function TableRow({ className, rowKey, ...props }: TableRowProps) {
589
598
  className,
590
599
  )}
591
600
  {...props}
601
+ ref={targetRef}
592
602
  />
593
603
  );
594
604
  }
595
605
 
596
- export interface TableSelectCellProps extends ComponentPropsWithoutRef<"td"> {
606
+ export interface TableSelectCellProps extends ComponentPropsWithRef<"td"> {
597
607
  /** Key of the row, the same as the row's `rowKey`. */
598
608
  rowKey: string;
599
609
  /** Names the checkbox: "Select {label}". Defaults to the key. */
@@ -619,7 +629,7 @@ export function TableSelectCell({ rowKey, label, className, ...props }: TableSel
619
629
  );
620
630
  }
621
631
 
622
- export interface TableSelectAllCellProps extends ComponentPropsWithoutRef<"th"> {
632
+ export interface TableSelectAllCellProps extends ComponentPropsWithRef<"th"> {
623
633
  /** Keys of the rows on screen. The box is checked when all are selected, mixed when some are. */
624
634
  rowKeys: readonly string[];
625
635
  }
@@ -648,7 +658,7 @@ export function TableSelectAllCell({ rowKeys, className, ...props }: TableSelect
648
658
  );
649
659
  }
650
660
 
651
- export interface TableActionsCellProps extends ComponentPropsWithoutRef<"td"> {
661
+ export interface TableActionsCellProps extends ComponentPropsWithRef<"td"> {
652
662
  /**
653
663
  * An overflow menu (a `DropdownMenu` with a trigger, say). When set, it replaces the inline
654
664
  * actions under a narrow table container (under 48rem of the wrapper's own width), so the
@@ -689,7 +699,7 @@ export function TableCell({
689
699
  columnId,
690
700
  style,
691
701
  ...props
692
- }: ComponentPropsWithoutRef<"td"> & AlignProps) {
702
+ }: ComponentPropsWithRef<"td"> & AlignProps) {
693
703
  const pinned = usePinnedCell(columnId, false);
694
704
  const hiddenIds = useContext(HiddenContext);
695
705
  if (columnId && hiddenIds.has(columnId)) return null;
@@ -709,7 +719,9 @@ export function TableCell({
709
719
  );
710
720
  }
711
721
 
712
- export interface TableLinkRowProps extends Omit<ComponentPropsWithoutRef<"tr">, "children"> {
722
+ export interface TableLinkRowProps
723
+ extends Omit<ComponentPropsWithRef<"tr">, "children">,
724
+ IntentProps {
713
725
  /** Row destination: rendered as a real `<a href>` in the first cell. */
714
726
  href: string;
715
727
  /** Content of the first cell, wrapped by the anchor. */
@@ -734,8 +746,15 @@ export function TableLinkRow({
734
746
  rowKey,
735
747
  children,
736
748
  className,
749
+ intent,
750
+ intentKey,
751
+ ref,
737
752
  ...props
738
753
  }: TableLinkRowProps) {
754
+ const targetRef = useComposedRefs(
755
+ ref,
756
+ useIntentTarget<HTMLTableRowElement>({ intent, intentKey }, { requireName: false }),
757
+ );
739
758
  const pinned = usePinnedCell(primaryColumnId, false);
740
759
  const hiddenIds = useContext(HiddenContext);
741
760
  const selection = useContext(SelectionContext);
@@ -743,6 +762,7 @@ export function TableLinkRow({
743
762
  selection && rowKey !== undefined ? selection.selected.includes(rowKey) : undefined;
744
763
  return (
745
764
  <tr
765
+ {...intentAttributes({ intent, intentKey })}
746
766
  aria-selected={isSelected}
747
767
  data-selected={isSelected || undefined}
748
768
  className={cn(
@@ -751,6 +771,7 @@ export function TableLinkRow({
751
771
  className,
752
772
  )}
753
773
  {...props}
774
+ ref={targetRef}
754
775
  >
755
776
  {primaryColumnId && hiddenIds.has(primaryColumnId) ? null : (
756
777
  <td
@@ -2,7 +2,7 @@
2
2
 
3
3
  import {
4
4
  Children,
5
- type ComponentPropsWithoutRef,
5
+ type ComponentPropsWithRef,
6
6
  createContext,
7
7
  isValidElement,
8
8
  type ReactElement,
@@ -11,8 +11,12 @@ import {
11
11
  } from "react";
12
12
  import { useUiStrings } from "../../i18n/index.js";
13
13
  import { Check, 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 type { ClassNames } from "../../utils/class-names.js";
15
18
  import { cn } from "../../utils/cn.js";
19
+ import { useComposedRefs } from "../../utils/compose.js";
16
20
 
17
21
  export type TimelineFeedTone = "neutral" | "accent" | "success" | "warning" | "danger";
18
22
 
@@ -59,7 +63,7 @@ export type TimelinePart =
59
63
  | "actor"
60
64
  | "description";
61
65
 
62
- export interface TimelineProps extends Omit<ComponentPropsWithoutRef<"ol">, "children"> {
66
+ export interface TimelineProps extends Omit<ComponentPropsWithRef<"ol">, "children"> {
63
67
  /** Data-driven entries. Rendered before `children`. */
64
68
  items?: TimelineFeedItem[];
65
69
  /**
@@ -96,7 +100,8 @@ const TimelinePositionContext = createContext<TimelinePosition>({ last: true, sh
96
100
 
97
101
  export interface TimelineItemProps
98
102
  extends Omit<TimelineFeedItem, "id">,
99
- Omit<ComponentPropsWithoutRef<"li">, "title" | "children"> {
103
+ Omit<ComponentPropsWithRef<"li">, "title" | "children">,
104
+ IntentProps {
100
105
  /** Kept so a `TimelineFeedItem` can be spread as is; React uses it as the key. */
101
106
  id?: string;
102
107
  }
@@ -114,8 +119,15 @@ export function TimelineItem({
114
119
  group,
115
120
  children,
116
121
  className,
122
+ intent,
123
+ intentKey,
124
+ ref,
117
125
  ...props
118
126
  }: TimelineItemProps) {
127
+ const targetRef = useComposedRefs(
128
+ ref,
129
+ useIntentTarget<HTMLLIElement>({ intent, intentKey }, { requireName: false }),
130
+ );
119
131
  const classNames = useContext(TimelineClasses);
120
132
  const { last, showGroup } = useContext(TimelinePositionContext);
121
133
  const strings = useUiStrings();
@@ -133,9 +145,11 @@ export function TimelineItem({
133
145
  status === "done" ? strings.stepDone : status === "error" ? strings.stepError : null;
134
146
  return (
135
147
  <li
148
+ {...intentAttributes({ intent, intentKey })}
136
149
  aria-current={status === "current" ? "step" : undefined}
137
150
  data-status={status}
138
151
  {...props}
152
+ ref={targetRef}
139
153
  className={cn("flex min-w-0 flex-col", classNames?.item, className)}
140
154
  >
141
155
  {group && showGroup ? (
@@ -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"