@jcsoftdev/ui 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (476) hide show
  1. package/CHANGELOG.md +151 -0
  2. package/README.md +22 -2
  3. package/dist/ai/attachment/attachment.d.ts +4 -3
  4. package/dist/ai/attachment/attachment.js +5 -1
  5. package/dist/ai/chat-message/chat-message.d.ts +4 -3
  6. package/dist/ai/chat-message/chat-message.js +5 -0
  7. package/dist/ai/code-block/code-block.js +2 -2
  8. package/dist/ai/conversation/conversation.d.ts +2 -2
  9. package/dist/ai/internal/disclosure.js +1 -1
  10. package/dist/ai/internal/icon-action.d.ts +4 -3
  11. package/dist/ai/internal/icon-action.js +11 -2
  12. package/dist/ai/message-actions/message-actions.d.ts +6 -3
  13. package/dist/ai/message-actions/message-actions.js +26 -1
  14. package/dist/ai/prompt-input/prompt-input.d.ts +3 -2
  15. package/dist/ai/prompt-input/prompt-input.js +14 -4
  16. package/dist/ai/prompt-suggestion/prompt-suggestion.d.ts +5 -4
  17. package/dist/ai/prompt-suggestion/prompt-suggestion.js +4 -0
  18. package/dist/ai/source/source.d.ts +4 -3
  19. package/dist/ai/source/source.js +16 -1
  20. package/dist/ai/tool-call/tool-call.d.ts +3 -2
  21. package/dist/ai/tool-call/tool-call.js +5 -1
  22. package/dist/atoms/big-date/big-date.d.ts +2 -2
  23. package/dist/atoms/button/button.d.ts +3 -2
  24. package/dist/atoms/button/button.js +9 -0
  25. package/dist/atoms/checkbox/checkbox.d.ts +5 -3
  26. package/dist/atoms/checkbox/checkbox.js +29 -19
  27. package/dist/atoms/chip/chip.d.ts +3 -2
  28. package/dist/atoms/chip/chip.js +10 -1
  29. package/dist/atoms/divider/divider.d.ts +2 -2
  30. package/dist/atoms/elapsed-time/elapsed-time.d.ts +2 -2
  31. package/dist/atoms/elapsed-time/elapsed-time.js +10 -7
  32. package/dist/atoms/elapsed-time/model.d.ts +8 -0
  33. package/dist/atoms/elapsed-time/model.js +44 -0
  34. package/dist/atoms/icon-button/icon-button.d.ts +2 -1
  35. package/dist/atoms/internal/labelled-control.d.ts +16 -0
  36. package/dist/atoms/internal/labelled-control.js +56 -0
  37. package/dist/atoms/number-value/number-value.d.ts +2 -2
  38. package/dist/atoms/pressable-feedback/pressable-feedback.d.ts +4 -3
  39. package/dist/atoms/pressable-feedback/pressable-feedback.js +13 -1
  40. package/dist/atoms/progress/progress.d.ts +2 -2
  41. package/dist/atoms/radio-group/radio-group-primitive.d.ts +3 -2
  42. package/dist/atoms/radio-group/radio-group-primitive.js +10 -1
  43. package/dist/atoms/radio-group/radio-group.d.ts +2 -0
  44. package/dist/atoms/radio-group/radio-group.js +3 -1
  45. package/dist/atoms/seal/seal.d.ts +2 -2
  46. package/dist/atoms/status-pill/status-pill.js +1 -1
  47. package/dist/atoms/switch/switch.d.ts +7 -4
  48. package/dist/atoms/switch/switch.js +35 -5
  49. package/dist/atoms/table-glyph/table-glyph.d.ts +2 -2
  50. package/dist/atoms/trend-chip/trend-chip.d.ts +2 -2
  51. package/dist/auth/login-form/parts.js +2 -2
  52. package/dist/calendar/date-calendar/date-calendar.js +1 -1
  53. package/dist/calendar/day-chip/day-chip.d.ts +3 -2
  54. package/dist/calendar/day-chip/day-chip.js +12 -1
  55. package/dist/calendar/event-block/event-block.d.ts +3 -2
  56. package/dist/calendar/event-block/event-block.js +7 -0
  57. package/dist/calendar/internal/grid-navigation.d.ts +11 -0
  58. package/dist/calendar/internal/grid-navigation.js +34 -0
  59. package/dist/calendar/internal/intent.d.ts +3 -0
  60. package/dist/calendar/internal/intent.js +7 -0
  61. package/dist/calendar/internal/month-model.d.ts +11 -0
  62. package/dist/calendar/internal/month-model.js +11 -0
  63. package/dist/calendar/internal/types.d.ts +4 -0
  64. package/dist/calendar/month-view/month-grid.d.ts +27 -0
  65. package/dist/calendar/month-view/month-grid.js +210 -0
  66. package/dist/calendar/month-view/month-view.d.ts +3 -1
  67. package/dist/calendar/month-view/month-view.js +29 -131
  68. package/dist/calendar/week-view/week-view.d.ts +3 -1
  69. package/dist/calendar/week-view/week-view.js +218 -128
  70. package/dist/charts/bar-chart/bar-race-chart.js +1 -1
  71. package/dist/charts/core/breadcrumb.js +1 -1
  72. package/dist/charts/core/chart-states.js +1 -1
  73. package/dist/charts/core/distribution/xy-points.js +4 -2
  74. package/dist/charts/crossfilter/crossfilter.js +1 -1
  75. package/dist/charts/gantt-chart/gantt-chart.js +1 -1
  76. package/dist/charts/maps/geo/map-data-table.js +1 -1
  77. package/dist/charts/sankey-chart/sankey-chart.js +1 -3
  78. package/dist/charts/tree-chart/tree-chart.js +1 -1
  79. package/dist/containers/action-bar/action-bar.d.ts +2 -2
  80. package/dist/containers/action-bar/action-bar.js +1 -1
  81. package/dist/containers/aside/aside.d.ts +3 -3
  82. package/dist/containers/banner/banner.d.ts +2 -2
  83. package/dist/containers/card/card.d.ts +5 -5
  84. package/dist/containers/card/card.js +3 -1
  85. package/dist/containers/carousel/carousel.d.ts +2 -2
  86. package/dist/containers/carousel/carousel.js +2 -2
  87. package/dist/containers/cols/cols.d.ts +3 -3
  88. package/dist/containers/comment/comment.d.ts +2 -2
  89. package/dist/containers/confirm-action/confirm-action.d.ts +3 -2
  90. package/dist/containers/confirm-action/confirm-action.js +10 -2
  91. package/dist/containers/dashboard/dashboard.d.ts +4 -4
  92. package/dist/containers/data-grid/column-menu.js +1 -1
  93. package/dist/containers/data-grid/data-grid.d.ts +7 -3
  94. package/dist/containers/data-grid/data-grid.js +45 -7
  95. package/dist/containers/data-grid/formula-bar.js +1 -1
  96. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  97. package/dist/containers/data-grid/tool-panel.js +1 -1
  98. package/dist/containers/description-list/description-list.d.ts +2 -2
  99. package/dist/containers/detail-header/detail-header.d.ts +2 -2
  100. package/dist/containers/facts/facts.d.ts +2 -2
  101. package/dist/containers/feed/feed.d.ts +5 -4
  102. package/dist/containers/feed/feed.js +12 -0
  103. package/dist/containers/file-tree/file-tree.js +11 -0
  104. package/dist/containers/file-tree/model.d.ts +2 -0
  105. package/dist/containers/filter-bar/filter-bar.d.ts +2 -2
  106. package/dist/containers/floor-plan/floor-plan.d.ts +2 -0
  107. package/dist/containers/floor-plan/floor-plan.js +17 -9
  108. package/dist/containers/floor-plan/index.d.ts +1 -1
  109. package/dist/containers/floor-plan/index.js +6 -1
  110. package/dist/containers/floor-plan/model.d.ts +3 -0
  111. package/dist/containers/floor-plan/model.js +8 -0
  112. package/dist/containers/generic-row/generic-row.d.ts +8 -6
  113. package/dist/containers/generic-row/generic-row.js +3 -1
  114. package/dist/containers/grid/grid.d.ts +2 -2
  115. package/dist/containers/hbars/hbars.js +2 -2
  116. package/dist/containers/highlight-line/highlight-line.d.ts +2 -2
  117. package/dist/containers/index.d.ts +1 -0
  118. package/dist/containers/index.js +1 -0
  119. package/dist/containers/item-card-group/item-card-group.d.ts +4 -2
  120. package/dist/containers/item-card-group/item-card-group.js +4 -0
  121. package/dist/containers/kanban/kanban.js +13 -0
  122. package/dist/containers/kanban/model.d.ts +2 -0
  123. package/dist/containers/kpi/kpi-model.d.ts +7 -0
  124. package/dist/containers/kpi/kpi-model.js +22 -0
  125. package/dist/containers/kpi/kpi-parts.d.ts +28 -0
  126. package/dist/containers/kpi/kpi-parts.js +121 -0
  127. package/dist/containers/kpi/kpi.d.ts +7 -30
  128. package/dist/containers/kpi/kpi.js +4 -119
  129. package/dist/containers/kpi-group/kpi-group.d.ts +2 -2
  130. package/dist/containers/list-detail/list-detail.d.ts +12 -11
  131. package/dist/containers/list-detail/list-detail.js +9 -1
  132. package/dist/containers/note/note.d.ts +2 -2
  133. package/dist/containers/order-ticket/index.d.ts +2 -0
  134. package/dist/containers/order-ticket/index.js +18 -0
  135. package/dist/containers/order-ticket/model.d.ts +24 -0
  136. package/dist/containers/order-ticket/model.js +45 -0
  137. package/dist/containers/order-ticket/order-ticket.d.ts +35 -0
  138. package/dist/containers/order-ticket/order-ticket.js +406 -0
  139. package/dist/containers/page/page.d.ts +2 -2
  140. package/dist/containers/page-header/back.d.ts +2 -2
  141. package/dist/containers/page-header/page-header.d.ts +6 -6
  142. package/dist/containers/pagination/cursor-pagination.d.ts +2 -2
  143. package/dist/containers/pagination/pagination.d.ts +2 -2
  144. package/dist/containers/pagination/pagination.js +2 -2
  145. package/dist/containers/resizable/resizable.d.ts +4 -4
  146. package/dist/containers/resizable/resizable.js +1 -1
  147. package/dist/containers/row-actions/row-actions.d.ts +4 -3
  148. package/dist/containers/row-actions/row-actions.js +14 -1
  149. package/dist/containers/scrolly/scrolly.js +1 -1
  150. package/dist/containers/section/section.d.ts +10 -9
  151. package/dist/containers/section/section.js +12 -0
  152. package/dist/containers/selectable-card/selectable-card.d.ts +3 -2
  153. package/dist/containers/selectable-card/selectable-card.js +10 -1
  154. package/dist/containers/settings-layout/settings-layout.d.ts +7 -6
  155. package/dist/containers/settings-layout/settings-layout.js +10 -1
  156. package/dist/containers/settings-row/settings-row.d.ts +4 -3
  157. package/dist/containers/settings-row/settings-row.js +4 -0
  158. package/dist/containers/shortcuts/shortcuts.d.ts +3 -3
  159. package/dist/containers/stack/stack.d.ts +2 -2
  160. package/dist/containers/table/table.d.ts +14 -13
  161. package/dist/containers/table/table.js +22 -4
  162. package/dist/containers/timeline/timeline.d.ts +5 -4
  163. package/dist/containers/timeline/timeline.js +12 -0
  164. package/dist/containers/toolbar/toolbar.d.ts +3 -3
  165. package/dist/forms/accent-picker/accent-picker.d.ts +5 -2
  166. package/dist/forms/accent-picker/accent-picker.js +22 -1
  167. package/dist/forms/checkbox-button-group/checkbox-button-group.d.ts +3 -2
  168. package/dist/forms/checkbox-button-group/checkbox-button-group.js +16 -0
  169. package/dist/forms/chip-group/chip-group.d.ts +4 -1
  170. package/dist/forms/chip-group/chip-group.js +20 -2
  171. package/dist/forms/combobox/combobox.d.ts +3 -2
  172. package/dist/forms/combobox/combobox.js +10 -1
  173. package/dist/forms/copy-field/copy-field.d.ts +4 -3
  174. package/dist/forms/copy-field/copy-field.js +7 -0
  175. package/dist/forms/date-picker/date-picker.d.ts +3 -2
  176. package/dist/forms/date-picker/date-picker.js +10 -1
  177. package/dist/forms/date-picker/date-time-picker.d.ts +3 -2
  178. package/dist/forms/date-picker/date-time-picker.js +4 -0
  179. package/dist/forms/dropzone/dropzone.d.ts +3 -2
  180. package/dist/forms/dropzone/dropzone.js +21 -3
  181. package/dist/forms/emoji-picker/emoji-picker.d.ts +3 -2
  182. package/dist/forms/emoji-picker/emoji-picker.js +9 -2
  183. package/dist/forms/emoji-reaction-button/emoji-reaction-button.d.ts +3 -2
  184. package/dist/forms/emoji-reaction-button/emoji-reaction-button.js +8 -1
  185. package/dist/forms/field/field.d.ts +2 -2
  186. package/dist/forms/fieldset/fieldset.d.ts +2 -2
  187. package/dist/forms/form/form.d.ts +6 -4
  188. package/dist/forms/form/form.js +10 -2
  189. package/dist/forms/form-footer/form-footer.d.ts +2 -2
  190. package/dist/forms/form-grid/form-grid.d.ts +3 -3
  191. package/dist/forms/form-section/form-section.d.ts +2 -2
  192. package/dist/forms/inline-select/inline-select.d.ts +4 -3
  193. package/dist/forms/inline-select/inline-select.js +9 -1
  194. package/dist/forms/input/input.d.ts +3 -2
  195. package/dist/forms/input/input.js +6 -1
  196. package/dist/forms/internal/button-option.d.ts +2 -0
  197. package/dist/forms/label/label.d.ts +2 -2
  198. package/dist/forms/native-select/native-select.d.ts +4 -3
  199. package/dist/forms/native-select/native-select.js +4 -0
  200. package/dist/forms/number-stepper/number-stepper.d.ts +2 -1
  201. package/dist/forms/number-stepper/number-stepper.js +13 -3
  202. package/dist/forms/password-input/password-input.d.ts +1 -1
  203. package/dist/forms/password-input/password-input.js +12 -0
  204. package/dist/forms/pin-input/pin-input.d.ts +3 -2
  205. package/dist/forms/pin-input/pin-input.js +8 -1
  206. package/dist/forms/radio-button-group/radio-button-group.d.ts +3 -2
  207. package/dist/forms/radio-button-group/radio-button-group.js +16 -0
  208. package/dist/forms/rating/rating.d.ts +3 -2
  209. package/dist/forms/rating/rating.js +12 -0
  210. package/dist/forms/select/select.d.ts +4 -3
  211. package/dist/forms/select/select.js +11 -2
  212. package/dist/forms/select-menu/select-menu.d.ts +3 -2
  213. package/dist/forms/select-menu/select-menu.js +10 -1
  214. package/dist/forms/slider/model.d.ts +1 -0
  215. package/dist/forms/slider/model.js +5 -0
  216. package/dist/forms/slider/slider.d.ts +2 -1
  217. package/dist/forms/slider/slider.js +12 -3
  218. package/dist/forms/textarea/textarea.d.ts +4 -3
  219. package/dist/forms/textarea/textarea.js +4 -2
  220. package/dist/forms/time-input/time-input.d.ts +4 -3
  221. package/dist/forms/time-input/time-input.js +13 -1
  222. package/dist/glass/crystal-map.d.ts +3 -1
  223. package/dist/glass/crystal-map.js +13 -2
  224. package/dist/i18n/strings.d.ts +78 -0
  225. package/dist/i18n/strings.js +52 -0
  226. package/dist/icons/alarm-clock.d.ts +2 -0
  227. package/dist/icons/alarm-clock.js +15 -0
  228. package/dist/icons/hourglass.d.ts +2 -0
  229. package/dist/icons/hourglass.js +13 -0
  230. package/dist/icons/index.d.ts +2 -0
  231. package/dist/icons/index.js +4 -0
  232. package/dist/intent/attributes.d.ts +11 -0
  233. package/dist/intent/attributes.js +77 -0
  234. package/dist/intent/bridge.d.ts +8 -0
  235. package/dist/intent/bridge.js +19 -0
  236. package/dist/intent/index.d.ts +4 -0
  237. package/dist/intent/index.js +31 -0
  238. package/dist/intent/target-registrations.d.ts +16 -0
  239. package/dist/intent/target-registrations.js +91 -0
  240. package/dist/intent/types.d.ts +29 -0
  241. package/dist/intent/types.js +0 -0
  242. package/dist/intent/use-intent-target.d.ts +4 -0
  243. package/dist/intent/use-intent-target.js +75 -0
  244. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +6 -4
  245. package/dist/navigation/breadcrumbs/breadcrumbs.js +11 -1
  246. package/dist/navigation/floating-toc/floating-toc.d.ts +2 -2
  247. package/dist/navigation/floating-toc/floating-toc.js +5 -0
  248. package/dist/navigation/floating-toc/model.d.ts +2 -1
  249. package/dist/navigation/segmented/segmented.d.ts +3 -2
  250. package/dist/navigation/segmented/segmented.js +11 -1
  251. package/dist/navigation/stepper/stepper.d.ts +4 -2
  252. package/dist/navigation/stepper/stepper.js +3 -0
  253. package/dist/navigation/tabs/tabs-nav.d.ts +5 -4
  254. package/dist/navigation/tabs/tabs-nav.js +11 -0
  255. package/dist/navigation/tabs/tabs.d.ts +5 -4
  256. package/dist/navigation/tabs/tabs.js +20 -1
  257. package/dist/navigation/wizard/wizard.d.ts +4 -3
  258. package/dist/navigation/wizard/wizard.js +9 -1
  259. package/dist/overlays/alert-dialog/alert-dialog.d.ts +5 -4
  260. package/dist/overlays/alert-dialog/alert-dialog.js +20 -3
  261. package/dist/overlays/context-menu/context-menu.d.ts +14 -12
  262. package/dist/overlays/context-menu/context-menu.js +57 -8
  263. package/dist/overlays/dialog/dialog.d.ts +9 -8
  264. package/dist/overlays/dialog/dialog.js +11 -0
  265. package/dist/overlays/drawer/drawer.d.ts +6 -5
  266. package/dist/overlays/drawer/drawer.js +11 -0
  267. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +14 -13
  268. package/dist/overlays/dropdown-menu/dropdown-menu.js +58 -5
  269. package/dist/overlays/hover-card/hover-card.d.ts +4 -3
  270. package/dist/overlays/hover-card/hover-card.js +12 -1
  271. package/dist/overlays/popover/popover.d.ts +3 -2
  272. package/dist/overlays/popover/popover.js +12 -1
  273. package/dist/overlays/tooltip/model.d.ts +1 -0
  274. package/dist/overlays/tooltip/model.js +8 -0
  275. package/dist/overlays/tooltip/tooltip.d.ts +2 -1
  276. package/dist/overlays/tooltip/tooltip.js +8 -2
  277. package/dist/palette/command-palette/command-palette.d.ts +8 -4
  278. package/dist/palette/command-palette/command-palette.js +49 -1
  279. package/dist/palette/command-palette/index.d.ts +1 -0
  280. package/dist/palette/command-palette/index.js +3 -1
  281. package/dist/palette/command-palette/model.d.ts +7 -0
  282. package/dist/palette/command-palette/model.js +11 -0
  283. package/dist/primitives/command/command.js +4 -1
  284. package/dist/primitives/dialog/dialog.js +1 -3
  285. package/dist/primitives/popper/popper.js +15 -4
  286. package/dist/shell/bottom-nav/bottom-nav.js +54 -42
  287. package/dist/shell/sidebar/sidebar.d.ts +5 -3
  288. package/dist/shell/sidebar/sidebar.js +14 -2
  289. package/dist/showcase/bento.js +1 -0
  290. package/dist/utils/is-production.d.ts +1 -0
  291. package/dist/utils/is-production.js +6 -0
  292. package/dist/utils/slot.js +17 -3
  293. package/icons/svg/alarm-clock.svg +8 -0
  294. package/icons/svg/hourglass.svg +6 -0
  295. package/package.json +2 -2
  296. package/src/ai/attachment/attachment.tsx +10 -3
  297. package/src/ai/chat-message/chat-message.tsx +10 -2
  298. package/src/ai/code-block/code-block.tsx +2 -2
  299. package/src/ai/conversation/conversation.tsx +2 -2
  300. package/src/ai/internal/disclosure.tsx +1 -1
  301. package/src/ai/internal/icon-action.tsx +14 -4
  302. package/src/ai/message-actions/message-actions.tsx +28 -3
  303. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  304. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  305. package/src/ai/source/source.tsx +17 -3
  306. package/src/ai/tool-call/tool-call.tsx +6 -1
  307. package/src/atoms/big-date/big-date.tsx +2 -2
  308. package/src/atoms/button/button.tsx +11 -1
  309. package/src/atoms/checkbox/checkbox.tsx +40 -21
  310. package/src/atoms/chip/chip.tsx +12 -2
  311. package/src/atoms/divider/divider.tsx +2 -2
  312. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  313. package/src/atoms/elapsed-time/model.ts +57 -0
  314. package/src/atoms/icon-button/icon-button.tsx +3 -1
  315. package/src/atoms/internal/labelled-control.tsx +83 -0
  316. package/src/atoms/number-value/number-value.tsx +2 -2
  317. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  318. package/src/atoms/progress/progress.tsx +2 -2
  319. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  320. package/src/atoms/radio-group/radio-group.tsx +5 -1
  321. package/src/atoms/seal/seal.tsx +2 -2
  322. package/src/atoms/status-pill/status-pill.tsx +1 -1
  323. package/src/atoms/switch/switch.tsx +43 -9
  324. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  325. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  326. package/src/auth/login-form/parts.tsx +2 -2
  327. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  328. package/src/calendar/day-chip/day-chip.tsx +14 -2
  329. package/src/calendar/event-block/event-block.tsx +9 -1
  330. package/src/calendar/internal/grid-navigation.ts +47 -0
  331. package/src/calendar/internal/intent.ts +10 -0
  332. package/src/calendar/internal/month-model.ts +23 -0
  333. package/src/calendar/internal/types.ts +4 -0
  334. package/src/calendar/month-view/month-grid.tsx +248 -0
  335. package/src/calendar/month-view/month-view.tsx +32 -148
  336. package/src/calendar/week-view/week-view.tsx +87 -10
  337. package/src/charts/README.md +10 -0
  338. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  339. package/src/charts/core/breadcrumb.tsx +1 -1
  340. package/src/charts/core/chart-states.tsx +1 -1
  341. package/src/charts/core/distribution/xy-points.tsx +4 -2
  342. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  343. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  344. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  345. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  346. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  347. package/src/containers/action-bar/action-bar.tsx +3 -3
  348. package/src/containers/aside/aside.tsx +3 -3
  349. package/src/containers/banner/banner.tsx +2 -2
  350. package/src/containers/card/card.tsx +7 -5
  351. package/src/containers/carousel/carousel.tsx +4 -4
  352. package/src/containers/cols/cols.tsx +3 -3
  353. package/src/containers/comment/comment.tsx +2 -2
  354. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  355. package/src/containers/dashboard/dashboard.tsx +4 -4
  356. package/src/containers/data-grid/column-menu.tsx +1 -1
  357. package/src/containers/data-grid/data-grid.tsx +53 -4
  358. package/src/containers/data-grid/formula-bar.tsx +1 -1
  359. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  360. package/src/containers/data-grid/tool-panel.tsx +1 -1
  361. package/src/containers/description-list/description-list.tsx +2 -2
  362. package/src/containers/detail-header/detail-header.tsx +2 -2
  363. package/src/containers/facts/facts.tsx +2 -2
  364. package/src/containers/feed/feed.tsx +16 -3
  365. package/src/containers/file-tree/file-tree.tsx +11 -0
  366. package/src/containers/file-tree/model.ts +2 -0
  367. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  368. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  369. package/src/containers/floor-plan/index.ts +7 -1
  370. package/src/containers/floor-plan/model.ts +16 -0
  371. package/src/containers/generic-row/generic-row.tsx +9 -6
  372. package/src/containers/grid/grid.tsx +2 -2
  373. package/src/containers/hbars/hbars.tsx +23 -21
  374. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  375. package/src/containers/index.ts +1 -0
  376. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  377. package/src/containers/kanban/kanban.tsx +13 -0
  378. package/src/containers/kanban/model.ts +2 -0
  379. package/src/containers/kpi/kpi-model.ts +37 -0
  380. package/src/containers/kpi/kpi-parts.tsx +153 -0
  381. package/src/containers/kpi/kpi.tsx +10 -176
  382. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  383. package/src/containers/list-detail/list-detail.tsx +22 -12
  384. package/src/containers/note/note.tsx +2 -2
  385. package/src/containers/order-ticket/index.ts +17 -0
  386. package/src/containers/order-ticket/model.ts +76 -0
  387. package/src/containers/order-ticket/order-ticket.tsx +480 -0
  388. package/src/containers/page/page.tsx +2 -2
  389. package/src/containers/page-header/back.tsx +2 -2
  390. package/src/containers/page-header/page-header.tsx +6 -6
  391. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  392. package/src/containers/pagination/pagination.tsx +4 -4
  393. package/src/containers/resizable/resizable.tsx +7 -5
  394. package/src/containers/row-actions/row-actions.tsx +18 -3
  395. package/src/containers/scrolly/scrolly.tsx +1 -1
  396. package/src/containers/section/section.tsx +21 -8
  397. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  398. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  399. package/src/containers/settings-row/settings-row.tsx +7 -2
  400. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  401. package/src/containers/stack/stack.tsx +2 -2
  402. package/src/containers/table/table.tsx +35 -14
  403. package/src/containers/timeline/timeline.tsx +17 -3
  404. package/src/containers/toolbar/toolbar.tsx +3 -3
  405. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  406. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  407. package/src/forms/chip-group/chip-group.tsx +23 -2
  408. package/src/forms/combobox/combobox.tsx +15 -4
  409. package/src/forms/copy-field/copy-field.tsx +11 -2
  410. package/src/forms/date-picker/date-picker.tsx +23 -12
  411. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  412. package/src/forms/dropzone/dropzone.tsx +18 -3
  413. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  414. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  415. package/src/forms/field/field.tsx +2 -2
  416. package/src/forms/fieldset/fieldset.tsx +2 -2
  417. package/src/forms/form/form.tsx +13 -5
  418. package/src/forms/form-footer/form-footer.tsx +2 -2
  419. package/src/forms/form-grid/form-grid.tsx +3 -3
  420. package/src/forms/form-section/form-section.tsx +2 -2
  421. package/src/forms/inline-select/inline-select.tsx +14 -3
  422. package/src/forms/input/input.tsx +8 -2
  423. package/src/forms/internal/button-option.tsx +2 -0
  424. package/src/forms/label/label.tsx +2 -2
  425. package/src/forms/native-select/native-select.tsx +9 -2
  426. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  427. package/src/forms/password-input/password-input.tsx +12 -0
  428. package/src/forms/pin-input/pin-input.tsx +9 -1
  429. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  430. package/src/forms/rating/rating.tsx +14 -1
  431. package/src/forms/select/select.tsx +14 -4
  432. package/src/forms/select-menu/select-menu.tsx +15 -4
  433. package/src/forms/slider/model.ts +5 -0
  434. package/src/forms/slider/slider.tsx +13 -3
  435. package/src/forms/textarea/textarea.tsx +7 -4
  436. package/src/forms/time-input/time-input.tsx +19 -5
  437. package/src/glass/crystal-map.ts +21 -3
  438. package/src/i18n/strings.ts +78 -0
  439. package/src/icons/alarm-clock.tsx +16 -0
  440. package/src/icons/hourglass.tsx +14 -0
  441. package/src/icons/index.ts +2 -0
  442. package/src/intent/attributes.ts +96 -0
  443. package/src/intent/bridge.tsx +25 -0
  444. package/src/intent/index.ts +24 -0
  445. package/src/intent/target-registrations.ts +127 -0
  446. package/src/intent/types.ts +44 -0
  447. package/src/intent/use-intent-target.ts +96 -0
  448. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  449. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  450. package/src/navigation/floating-toc/model.ts +3 -1
  451. package/src/navigation/segmented/segmented.tsx +14 -2
  452. package/src/navigation/stepper/stepper.tsx +7 -2
  453. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  454. package/src/navigation/tabs/tabs.tsx +24 -3
  455. package/src/navigation/wizard/wizard.tsx +12 -4
  456. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  457. package/src/overlays/context-menu/context-menu.tsx +58 -11
  458. package/src/overlays/dialog/dialog.tsx +18 -7
  459. package/src/overlays/drawer/drawer.tsx +15 -4
  460. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  461. package/src/overlays/hover-card/hover-card.tsx +13 -2
  462. package/src/overlays/popover/popover.tsx +12 -1
  463. package/src/overlays/tooltip/model.ts +8 -0
  464. package/src/overlays/tooltip/tooltip.tsx +15 -2
  465. package/src/palette/command-palette/command-palette.tsx +66 -3
  466. package/src/palette/command-palette/index.ts +1 -0
  467. package/src/palette/command-palette/model.ts +15 -0
  468. package/src/primitives/command/command.tsx +4 -1
  469. package/src/primitives/dialog/dialog.tsx +1 -4
  470. package/src/primitives/popper/popper.tsx +16 -5
  471. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  472. package/src/shell/sidebar/sidebar.tsx +22 -4
  473. package/src/showcase/bento.tsx +2 -0
  474. package/src/utils/is-production.ts +3 -0
  475. package/src/utils/slot.tsx +21 -3
  476. package/styles/base.css +34 -0
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  Fragment,
6
6
  type KeyboardEvent,
7
7
  type MouseEvent,
@@ -9,6 +9,9 @@ import {
9
9
  } from "react";
10
10
  import { IconButton } from "../../atoms/icon-button/icon-button.js";
11
11
  import { EllipsisVertical } from "../../icons/index.js";
12
+ import { intentAttributes } from "../../intent/attributes.js";
13
+ import type { IntentProps } from "../../intent/types.js";
14
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
12
15
  import {
13
16
  DropdownMenu,
14
17
  DropdownMenuContent,
@@ -31,7 +34,8 @@ export interface RowActionItem {
31
34
  }
32
35
 
33
36
  export interface RowActionsProps
34
- extends Omit<ComponentPropsWithoutRef<"span">, "children" | "onClick" | "onKeyDown"> {
37
+ extends Omit<ComponentPropsWithRef<"span">, "children" | "onClick" | "onKeyDown">,
38
+ IntentProps {
35
39
  /** Accessible name of the overflow trigger. Name the row: "Actions for Ana Quispe". */
36
40
  label: string;
37
41
  /** At most one inline action, typically a `Button size="sm"`: the one thing the row is mostly for. */
@@ -53,7 +57,16 @@ function contain(event: MouseEvent | KeyboardEvent): void {
53
57
  * 30px "more" button. It never wraps, so the row keeps its height; destructive items sort last,
54
58
  * behind a separator. The menu is a WAI-ARIA menu: arrows, Home/End, typeahead, Escape.
55
59
  */
56
- export function RowActions({ label, primary, items, className, ...props }: RowActionsProps) {
60
+ export function RowActions({
61
+ label,
62
+ primary,
63
+ items,
64
+ className,
65
+ intent,
66
+ intentKey,
67
+ ...props
68
+ }: RowActionsProps) {
69
+ const triggerRef = useIntentTarget<HTMLButtonElement>({ intent, intentKey });
57
70
  const regular = items.filter((item) => item.tone !== "danger");
58
71
  const destructive = items.filter((item) => item.tone === "danger");
59
72
  return (
@@ -73,6 +86,8 @@ export function RowActions({ label, primary, items, className, ...props }: RowAc
73
86
  <DropdownMenu>
74
87
  <DropdownMenuTrigger asChild>
75
88
  <IconButton
89
+ {...intentAttributes({ intent, intentKey })}
90
+ ref={triggerRef}
76
91
  size="sm"
77
92
  variant="secondary"
78
93
  label={label}
@@ -195,7 +195,7 @@ export function ScrollyStep({ children, minHeight = "70svh", className }: Scroll
195
195
  aria-current={active ? "step" : undefined}
196
196
  className={cn(
197
197
  "flex min-w-0 flex-col justify-center py-6 text-ink",
198
- "opacity-60 motion-safe:transition-opacity motion-safe:duration-300 data-[active]:opacity-100",
198
+ "opacity-80 motion-safe:transition-opacity motion-safe:duration-300 data-[active]:opacity-100",
199
199
  className,
200
200
  )}
201
201
  style={{ minHeight }}
@@ -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 ReactNode,
@@ -11,8 +11,12 @@ import {
11
11
  useId,
12
12
  useState,
13
13
  } from "react";
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
  /** Heading depth: how many titled sections enclose this point. A titleless wrapper adds nothing. */
18
22
  const SectionDepth = createContext(0);
@@ -46,7 +50,7 @@ export type SectionPart =
46
50
  | "actions"
47
51
  | "body";
48
52
 
49
- export interface SectionProps extends Omit<ComponentPropsWithoutRef<"section">, "title"> {
53
+ export interface SectionProps extends Omit<ComponentPropsWithRef<"section">, "title">, IntentProps {
50
54
  as?: "section" | "div" | "article";
51
55
  title?: ReactNode;
52
56
  /** Outlined count next to the title (a record total, say). */
@@ -111,8 +115,15 @@ export function Section({
111
115
  className,
112
116
  classNames,
113
117
  children,
118
+ intent,
119
+ intentKey,
120
+ ref,
114
121
  ...props
115
122
  }: SectionProps) {
123
+ const targetRef = useComposedRefs(
124
+ ref,
125
+ useIntentTarget<HTMLElement>({ intent, intentKey }, { requireName: false }),
126
+ );
116
127
  const outerDepth = useContext(SectionDepth);
117
128
  const titleId = useId();
118
129
  const [registered, setRegistered] = useState(false);
@@ -138,7 +149,9 @@ export function Section({
138
149
  }}
139
150
  >
140
151
  <Tag
152
+ {...intentAttributes({ intent, intentKey })}
141
153
  {...props}
154
+ ref={targetRef}
142
155
  data-depth={outerDepth}
143
156
  aria-labelledby={named && props["aria-label"] === undefined ? titleId : undefined}
144
157
  className={cn(
@@ -165,7 +178,7 @@ export function Section({
165
178
  );
166
179
  }
167
180
 
168
- export interface SectionHeaderProps extends ComponentPropsWithoutRef<"div"> {}
181
+ export interface SectionHeaderProps extends ComponentPropsWithRef<"div"> {}
169
182
 
170
183
  /** Header row of a composed `Section`: title, count and description wrap, actions go to the end. */
171
184
  export function SectionHeader({ className, ...props }: SectionHeaderProps) {
@@ -183,7 +196,7 @@ export function SectionHeader({ className, ...props }: SectionHeaderProps) {
183
196
  );
184
197
  }
185
198
 
186
- export interface SectionTitleProps extends ComponentPropsWithoutRef<"h2"> {
199
+ export interface SectionTitleProps extends ComponentPropsWithRef<"h2"> {
187
200
  /** Heading element. Defaults to `h2`, one level deeper per enclosing titled section. */
188
201
  as?: SectionHeadingTag | undefined;
189
202
  }
@@ -211,7 +224,7 @@ export function SectionTitle({ as, className, ...props }: SectionTitleProps) {
211
224
  );
212
225
  }
213
226
 
214
- export interface SectionCountProps extends ComponentPropsWithoutRef<"span"> {}
227
+ export interface SectionCountProps extends ComponentPropsWithRef<"span"> {}
215
228
 
216
229
  /** Outlined count next to the title. */
217
230
  export function SectionCount({ className, ...props }: SectionCountProps) {
@@ -228,7 +241,7 @@ export function SectionCount({ className, ...props }: SectionCountProps) {
228
241
  );
229
242
  }
230
243
 
231
- export interface SectionDescriptionProps extends ComponentPropsWithoutRef<"p"> {}
244
+ export interface SectionDescriptionProps extends ComponentPropsWithRef<"p"> {}
232
245
 
233
246
  export function SectionDescription({ className, ...props }: SectionDescriptionProps) {
234
247
  const { classNames } = useSectionParts("Description");
@@ -240,7 +253,7 @@ export function SectionDescription({ className, ...props }: SectionDescriptionPr
240
253
  );
241
254
  }
242
255
 
243
- export interface SectionActionsProps extends ComponentPropsWithoutRef<"div"> {}
256
+ export interface SectionActionsProps extends ComponentPropsWithRef<"div"> {}
244
257
 
245
258
  /** Slot at the end of the header; takes the full row under 560px of the section's own width. */
246
259
  export function SectionActions({ className, ...props }: SectionActionsProps) {
@@ -257,7 +270,7 @@ export function SectionActions({ className, ...props }: SectionActionsProps) {
257
270
  );
258
271
  }
259
272
 
260
- export interface SectionBodyProps extends ComponentPropsWithoutRef<"div"> {
273
+ export interface SectionBodyProps extends ComponentPropsWithRef<"div"> {
261
274
  /** Vertical padding. Defaults to the section's `padded`. */
262
275
  padded?: boolean | undefined;
263
276
  }
@@ -1,13 +1,18 @@
1
1
  "use client";
2
2
 
3
3
  import { type ComponentPropsWithRef, type MouseEvent, type ReactNode, useId } from "react";
4
+ import { intentAttributes } from "../../intent/attributes.js";
5
+ import type { IntentProps } from "../../intent/types.js";
6
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
4
7
  import type { ClassNames } from "../../utils/class-names.js";
5
8
  import { cn } from "../../utils/cn.js";
9
+ import { useComposedRefs } from "../../utils/compose.js";
6
10
 
7
11
  export type SelectableCardPart = "root" | "content" | "reason";
8
12
 
9
13
  export interface SelectableCardProps
10
- extends Omit<ComponentPropsWithRef<"button">, "children" | "role" | "aria-checked"> {
14
+ extends Omit<ComponentPropsWithRef<"button">, "children" | "role" | "aria-checked">,
15
+ IntentProps {
11
16
  /** Card content. It sits inside a button, so use phrasing content only (spans, text, icons). */
12
17
  children: ReactNode;
13
18
  /**
@@ -40,8 +45,12 @@ export function SelectableCard({
40
45
  className,
41
46
  classNames,
42
47
  "aria-describedby": describedBy,
48
+ intent,
49
+ intentKey,
50
+ ref,
43
51
  ...props
44
52
  }: SelectableCardProps) {
53
+ const targetRef = useComposedRefs(ref, useIntentTarget<HTMLButtonElement>({ intent, intentKey }));
45
54
  const reasonId = useId();
46
55
  const showReason = disabled && Boolean(disabledReason);
47
56
  const radio = semantics === "radio" && selected !== undefined;
@@ -56,7 +65,9 @@ export function SelectableCard({
56
65
  // biome-ignore lint/a11y/useAriaPropsSupportedByRole: aria-checked is only set together with role="radio"
57
66
  <button
58
67
  type="button"
68
+ {...intentAttributes({ intent, intentKey })}
59
69
  {...props}
70
+ ref={targetRef}
60
71
  role={radio ? "radio" : undefined}
61
72
  aria-checked={radio ? selected : undefined}
62
73
  aria-pressed={!radio && selected !== undefined ? selected : undefined}
@@ -68,7 +79,7 @@ export function SelectableCard({
68
79
  className={cn(
69
80
  "pressable flex w-full min-w-0 flex-col gap-1 rounded-card border-card p-card text-left shadow-card surface-card focus-visible:focus-ring",
70
81
  selected && "border-accent-line bg-accent-soft shadow-selected",
71
- disabled ? "cursor-not-allowed opacity-60" : "cursor-pointer",
82
+ disabled ? "cursor-not-allowed opacity-50" : "cursor-pointer",
72
83
  classNames?.root,
73
84
  className,
74
85
  )}
@@ -1,7 +1,11 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, createContext, use } from "react";
3
+ import { type ComponentPropsWithRef, createContext, use } from "react";
4
+ import { intentAttributes } from "../../intent/attributes.js";
5
+ import type { IntentProps } from "../../intent/types.js";
6
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
4
7
  import { cn } from "../../utils/cn.js";
8
+ import { useComposedRefs } from "../../utils/compose.js";
5
9
 
6
10
  /** Container widths (px) under which the layout stacks. The set is closed so every query is a literal class. */
7
11
  export type SettingsLayoutBreakpoint = 720 | 940 | 1080 | 1280;
@@ -66,7 +70,7 @@ function stackFor(config: SettingsLayoutConfig, part: "grid" | "nav") {
66
70
  : stackClasses[config.container][config.breakpoint][part];
67
71
  }
68
72
 
69
- export interface SettingsLayoutProps extends ComponentPropsWithoutRef<"div"> {
73
+ export interface SettingsLayoutProps extends ComponentPropsWithRef<"div"> {
70
74
  /**
71
75
  * Container width (px) under which the nav and the content stack. `"never"` keeps two columns.
72
76
  * Defaults to 940. `SettingsLayoutNav` follows it without being told.
@@ -107,7 +111,7 @@ export function SettingsLayout({
107
111
  );
108
112
  }
109
113
 
110
- export interface SettingsLayoutNavProps extends ComponentPropsWithoutRef<"nav"> {
114
+ export interface SettingsLayoutNavProps extends ComponentPropsWithRef<"nav"> {
111
115
  /** Overrides the breakpoint the surrounding `SettingsLayout` set. */
112
116
  breakpoint?: SettingsLayoutBreakpoint | "never";
113
117
  }
@@ -130,7 +134,7 @@ export function SettingsLayoutNav({
130
134
  );
131
135
  }
132
136
 
133
- export interface SettingsLayoutNavItemProps extends ComponentPropsWithoutRef<"button"> {
137
+ export interface SettingsLayoutNavItemProps extends ComponentPropsWithRef<"button">, IntentProps {
134
138
  /** Currently visible section. */
135
139
  active?: boolean;
136
140
  }
@@ -139,10 +143,15 @@ export function SettingsLayoutNavItem({
139
143
  active,
140
144
  className,
141
145
  type = "button",
146
+ intent,
147
+ intentKey,
148
+ ref,
142
149
  ...props
143
150
  }: SettingsLayoutNavItemProps) {
151
+ const targetRef = useComposedRefs(ref, useIntentTarget<HTMLButtonElement>({ intent, intentKey }));
144
152
  return (
145
153
  <button
154
+ {...intentAttributes({ intent, intentKey })}
146
155
  type={type}
147
156
  aria-current={active ? "true" : undefined}
148
157
  className={cn(
@@ -151,11 +160,12 @@ export function SettingsLayoutNavItem({
151
160
  className,
152
161
  )}
153
162
  {...props}
163
+ ref={targetRef}
154
164
  />
155
165
  );
156
166
  }
157
167
 
158
- export type SettingsLayoutMainProps = ComponentPropsWithoutRef<"div">;
168
+ export type SettingsLayoutMainProps = ComponentPropsWithRef<"div">;
159
169
 
160
170
  /**
161
171
  * Content column: a single stack that becomes a 2-column masonry at 1180px of
@@ -1,10 +1,12 @@
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 type { ClassNames } from "../../utils/class-names.js";
3
5
  import { cn } from "../../utils/cn.js";
4
6
 
5
7
  export type SettingsRowPart = "root" | "body" | "title" | "description" | "control";
6
8
 
7
- export interface SettingsRowProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
9
+ export interface SettingsRowProps extends Omit<ComponentPropsWithRef<"div">, "title">, IntentProps {
8
10
  title: ReactNode;
9
11
  description?: ReactNode;
10
12
  /** Control on the right: a switch, a button, etc. */
@@ -22,10 +24,13 @@ export function SettingsRow({
22
24
  titleId,
23
25
  className,
24
26
  classNames,
27
+ intent,
28
+ intentKey,
25
29
  ...props
26
30
  }: SettingsRowProps) {
27
31
  return (
28
32
  <div
33
+ {...intentAttributes({ intent, intentKey })}
29
34
  className={cn(
30
35
  "flex flex-wrap items-center justify-between gap-x-4 gap-y-2.5 border-t-divider px-4 py-3.25 first:border-t-0",
31
36
  classNames?.root,
@@ -1,5 +1,5 @@
1
1
  import {
2
- type ComponentPropsWithoutRef,
2
+ type ComponentPropsWithRef,
3
3
  cloneElement,
4
4
  isValidElement,
5
5
  type ReactElement,
@@ -9,14 +9,14 @@ import { Kbd } from "../../atoms/kbd/kbd.js";
9
9
  import { cn } from "../../utils/cn.js";
10
10
  import { Slot } from "../../utils/slot.js";
11
11
 
12
- export type ShortcutsProps = ComponentPropsWithoutRef<"ul">;
12
+ export type ShortcutsProps = ComponentPropsWithRef<"ul">;
13
13
 
14
14
  /** A short list of quick links or actions, flush to its container. Items go in `ShortcutsItem`. */
15
15
  export function Shortcuts({ className, ...props }: ShortcutsProps) {
16
16
  return <ul className={cn("m-0 flex list-none flex-col gap-0.5 p-0", className)} {...props} />;
17
17
  }
18
18
 
19
- export interface ShortcutsItemProps extends ComponentPropsWithoutRef<"a"> {
19
+ export interface ShortcutsItemProps extends ComponentPropsWithRef<"a"> {
20
20
  /** Decorative glyph before the label. */
21
21
  icon?: ReactNode;
22
22
  /** Keyboard hint at the end (`G P`, `⌘K`). */
@@ -75,7 +75,7 @@ export function ShortcutsItem({
75
75
  <button
76
76
  type="button"
77
77
  className={classes}
78
- {...(props as unknown as ComponentPropsWithoutRef<"button">)}
78
+ {...(props as unknown as ComponentPropsWithRef<"button">)}
79
79
  >
80
80
  {content(children)}
81
81
  </button>
@@ -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) {