@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
@@ -0,0 +1,44 @@
1
+ import type { RefCallback } from "react";
2
+
3
+ export interface IntentTargetRef {
4
+ readonly intent: string;
5
+ readonly key?: string;
6
+ }
7
+
8
+ export interface IntentSemanticExpectation {
9
+ readonly role: string;
10
+ readonly requireName: boolean;
11
+ }
12
+
13
+ export interface IntentBridge {
14
+ registerTarget(
15
+ ref: IntentTargetRef,
16
+ element: Element,
17
+ expectation: IntentSemanticExpectation,
18
+ ): () => void;
19
+ }
20
+
21
+ export interface IntentProps {
22
+ intent?: string | undefined;
23
+ intentKey?: string | undefined;
24
+ }
25
+
26
+ export interface IntentDataAttributes {
27
+ "data-intent"?: string;
28
+ "data-intent-key"?: string;
29
+ }
30
+
31
+ export interface IntentExpectationInput {
32
+ role?: string | undefined;
33
+ requireName?: boolean | undefined;
34
+ }
35
+
36
+ export interface RoleSource {
37
+ readonly tagName: string;
38
+ getAttribute(name: string): string | null;
39
+ }
40
+
41
+ export type IntentTargetBinder = <E extends Element = Element>(
42
+ props: IntentProps,
43
+ expectation?: IntentExpectationInput,
44
+ ) => RefCallback<E> | undefined;
@@ -0,0 +1,96 @@
1
+ "use client";
2
+
3
+ import { type RefCallback, useCallback, useMemo } from "react";
4
+ import { intentTargetRef, resolveExpectation } from "./attributes.js";
5
+ import { noopIntentBridge, useIntentBridge } from "./bridge.js";
6
+ import { attachTarget } from "./target-registrations.js";
7
+ import type {
8
+ IntentBridge,
9
+ IntentExpectationInput,
10
+ IntentProps,
11
+ IntentTargetBinder,
12
+ } from "./types.js";
13
+
14
+ const CACHE_SEPARATOR = "\u0000";
15
+
16
+ const ignoreElement: RefCallback<Element> = () => undefined;
17
+
18
+ function createTargetRef<E extends Element>(
19
+ bridge: IntentBridge,
20
+ props: IntentProps,
21
+ expectation: IntentExpectationInput | undefined,
22
+ ): RefCallback<E> | undefined {
23
+ const ref = intentTargetRef(props);
24
+ if (ref === undefined || bridge === noopIntentBridge) return undefined;
25
+ let current: (() => void) | undefined;
26
+ const release = () => {
27
+ const run = current;
28
+ current = undefined;
29
+ run?.();
30
+ };
31
+ return (element) => {
32
+ release();
33
+ if (element === null) return undefined;
34
+ current = attachTarget(bridge, ref, element, resolveExpectation(expectation, element));
35
+ return release;
36
+ };
37
+ }
38
+
39
+ export function useIntentTarget<E extends Element = Element>(
40
+ props: IntentProps,
41
+ expectation?: IntentExpectationInput,
42
+ ): RefCallback<E> {
43
+ const bridge = useIntentBridge();
44
+ const { intent, intentKey } = props;
45
+ const role = expectation?.role;
46
+ const requireName = expectation?.requireName;
47
+ return useMemo(
48
+ () =>
49
+ createTargetRef<E>(bridge, { intent, intentKey }, { role, requireName }) ??
50
+ (ignoreElement as RefCallback<E>),
51
+ [bridge, intent, intentKey, role, requireName],
52
+ );
53
+ }
54
+
55
+ export function useIntentTargets(): IntentTargetBinder {
56
+ const bridge = useIntentBridge();
57
+ const bind = useCallback(
58
+ (cache: Map<string, RefCallback<Element>>): IntentTargetBinder =>
59
+ <E extends Element = Element>(
60
+ props: IntentProps,
61
+ expectation?: IntentExpectationInput,
62
+ ): RefCallback<E> | undefined => {
63
+ const ref = intentTargetRef(props);
64
+ if (ref === undefined) return undefined;
65
+ const cacheKey = [
66
+ ref.intent,
67
+ ref.key ?? "",
68
+ expectation?.role ?? "",
69
+ String(expectation?.requireName ?? true),
70
+ ].join(CACHE_SEPARATOR);
71
+ const cached = cache.get(cacheKey);
72
+ if (cached !== undefined) return cached as RefCallback<E>;
73
+ const inner = createTargetRef<Element>(bridge, props, expectation);
74
+ if (inner === undefined) return undefined;
75
+ const forget = () => {
76
+ if (cache.get(cacheKey) === bound) cache.delete(cacheKey);
77
+ };
78
+ const bound: RefCallback<Element> = (element) => {
79
+ const release = inner(element);
80
+ if (element === null) {
81
+ forget();
82
+ return undefined;
83
+ }
84
+ cache.set(cacheKey, bound);
85
+ return () => {
86
+ forget();
87
+ if (typeof release === "function") release();
88
+ };
89
+ };
90
+ cache.set(cacheKey, bound);
91
+ return bound as RefCallback<E>;
92
+ },
93
+ [bridge],
94
+ );
95
+ return useMemo(() => bind(new Map()), [bind]);
96
+ }
@@ -1,21 +1,28 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
3
+ import type { ComponentPropsWithRef, ReactNode, RefCallback } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { ChevronRight } from "../../icons/index.js";
6
+ import {
7
+ type IntentDataAttributes,
8
+ type IntentProps,
9
+ intentAttributes,
10
+ useIntentTargets,
11
+ } from "../../intent/index.js";
6
12
  import type { ClassNames } from "../../utils/class-names.js";
7
13
  import { cn } from "../../utils/cn.js";
8
14
 
9
- export interface BreadcrumbItem {
15
+ export interface BreadcrumbItem extends IntentProps {
10
16
  label: ReactNode;
11
17
  /** Destination. Omit it on the last item, or on a crumb that is not navigable. */
12
18
  href?: string;
13
19
  }
14
20
 
15
- export interface BreadcrumbLinkProps {
21
+ export interface BreadcrumbLinkProps extends IntentDataAttributes {
16
22
  href: string;
17
23
  className: string;
18
24
  children: ReactNode;
25
+ ref?: RefCallback<HTMLElement> | undefined;
19
26
  }
20
27
 
21
28
  /** Renders a breadcrumb link; inject your router's link component here. */
@@ -23,7 +30,7 @@ export type BreadcrumbRenderLink = (props: BreadcrumbLinkProps) => ReactNode;
23
30
 
24
31
  export type BreadcrumbsPart = "root" | "list" | "item" | "link" | "current" | "separator";
25
32
 
26
- export interface BreadcrumbsProps extends Omit<ComponentPropsWithoutRef<"nav">, "children"> {
33
+ export interface BreadcrumbsProps extends Omit<ComponentPropsWithRef<"nav">, "children"> {
27
34
  /** Trail in order; the last entry is the current page. */
28
35
  items: readonly BreadcrumbItem[];
29
36
  /** Link renderer; defaults to a plain anchor. */
@@ -50,6 +57,7 @@ export function Breadcrumbs({
50
57
  ...props
51
58
  }: BreadcrumbsProps) {
52
59
  const strings = useUiStrings();
60
+ const bind = useIntentTargets();
53
61
  const lastIndex = items.length - 1;
54
62
  return (
55
63
  <nav
@@ -65,11 +73,14 @@ export function Breadcrumbs({
65
73
  >
66
74
  {items.map((item, index) => {
67
75
  const current = index === lastIndex;
76
+ const target = { intent: item.intent, intentKey: item.intentKey };
68
77
  return (
69
78
  // biome-ignore lint/suspicious/noArrayIndexKey: crumbs are positional and may share a label
70
79
  <li key={index} className={cn("inline-flex items-center gap-1.5", classNames?.item)}>
71
80
  {current || item.href === undefined ? (
72
81
  <span
82
+ {...intentAttributes(target)}
83
+ ref={bind<HTMLSpanElement>(target, { requireName: false })}
73
84
  aria-current={current ? "page" : undefined}
74
85
  className={cn(current && "font-semibold text-ink", classNames?.current)}
75
86
  >
@@ -77,9 +88,11 @@ export function Breadcrumbs({
77
88
  </span>
78
89
  ) : (
79
90
  renderLink({
91
+ ...intentAttributes(target),
92
+ ref: bind<HTMLElement>(target),
80
93
  href: item.href,
81
94
  className: cn(
82
- "rounded-xs underline-offset-2 hover:text-ink hover:underline focus-visible:focus-ring",
95
+ "relative rounded-xs underline-offset-2 before:absolute before:-inset-y-1.5 before:inset-x-0 hover:text-ink hover:underline focus-visible:focus-ring",
83
96
  classNames?.link,
84
97
  ),
85
98
  children: item.label,
@@ -1,6 +1,7 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, type RefObject, useEffect, useRef, useState } from "react";
3
+ import { type ComponentPropsWithRef, type RefObject, useEffect, useRef, useState } from "react";
4
+ import { intentAttributes, useIntentTargets } from "../../intent/index.js";
4
5
  import type { ClassNames } from "../../utils/class-names.js";
5
6
  import { cn } from "../../utils/cn.js";
6
7
  import { usePrefersReducedMotion } from "../../utils/reduced-motion.js";
@@ -8,7 +9,7 @@ import { pickActive, type TocItem } from "./model.js";
8
9
 
9
10
  export type FloatingTocPart = "root" | "title" | "list" | "item" | "link" | "label";
10
11
 
11
- export interface FloatingTocProps extends Omit<ComponentPropsWithoutRef<"nav">, "children"> {
12
+ export interface FloatingTocProps extends Omit<ComponentPropsWithRef<"nav">, "children"> {
12
13
  items: TocItem[];
13
14
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
14
15
  classNames?: ClassNames<FloatingTocPart>;
@@ -42,6 +43,7 @@ export function FloatingToc({
42
43
  ...props
43
44
  }: FloatingTocProps) {
44
45
  const reduced = usePrefersReducedMotion();
46
+ const bind = useIntentTargets();
45
47
  const [active, setActive] = useState<string | null>(items[0]?.id ?? null);
46
48
  const visible = useRef(new Set<string>());
47
49
  const activeRef = useRef(active);
@@ -104,9 +106,12 @@ export function FloatingToc({
104
106
  >
105
107
  {items.map((item) => {
106
108
  const current = item.id === active;
109
+ const target = { intent: item.intent, intentKey: item.intentKey ?? item.id };
107
110
  return (
108
111
  <li key={item.id} className={cn("min-w-0", classNames?.item)}>
109
112
  <a
113
+ {...intentAttributes(target)}
114
+ ref={bind<HTMLAnchorElement>(target)}
110
115
  href={`#${item.id}`}
111
116
  aria-current={current ? "location" : undefined}
112
117
  onClick={(event) => {
@@ -1,4 +1,6 @@
1
- export interface TocItem {
1
+ import type { IntentProps } from "../../intent/types.js";
2
+
3
+ export interface TocItem extends IntentProps {
2
4
  /** DOM id of the heading element. */
3
5
  id: string;
4
6
  label: string;
@@ -1,6 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import { type ComponentPropsWithRef, createContext, type ReactNode, useContext } from "react";
4
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
4
5
  import { cn } from "../../utils/cn.js";
5
6
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
6
7
  import {
@@ -117,7 +118,9 @@ export function Segmented({
117
118
  );
118
119
  }
119
120
 
120
- export interface SegmentedItemProps extends Omit<ComponentPropsWithRef<"button">, "value"> {
121
+ export interface SegmentedItemProps
122
+ extends Omit<ComponentPropsWithRef<"button">, "value">,
123
+ IntentProps {
121
124
  value: string;
122
125
  }
123
126
 
@@ -126,9 +129,16 @@ export function SegmentedItem({
126
129
  value,
127
130
  disabled: disabledProp,
128
131
  onClick,
132
+ intent,
133
+ intentKey,
134
+ ref,
129
135
  ...props
130
136
  }: SegmentedItemProps) {
131
137
  const context = useContext(SegmentedContext);
138
+ const composedRef = useComposedRefs<HTMLButtonElement>(
139
+ ref,
140
+ useIntentTarget<HTMLButtonElement>({ intent, intentKey }, { role: "radio" }),
141
+ );
132
142
  if (!context) throw new Error("`SegmentedItem` must be used within `Segmented`");
133
143
  const pressed = context.value === value;
134
144
  const disabled = context.disabled || disabledProp;
@@ -147,14 +157,16 @@ export function SegmentedItem({
147
157
  data-state={pressed ? "on" : "off"}
148
158
  data-disabled={disabled ? "" : undefined}
149
159
  disabled={disabled}
160
+ {...intentAttributes({ intent, intentKey })}
150
161
  {...props}
151
162
  {...item}
163
+ ref={composedRef}
152
164
  onClick={composeHandlers(onClick, () => {
153
165
  if (!disabled)
154
166
  context.setValue(nextSegmentedValue(context.value, value, context.allowDeselect));
155
167
  })}
156
168
  className={cn(
157
- "inline-flex h-control-sm shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap rounded-button px-3.5 @max-[420px]:px-2.5 text-control text-ink-2 hover:text-ink data-[state=on]:bg-seg-on data-[state=on]:text-ink data-[state=on]:shadow-sel",
169
+ "inline-flex h-control-sm shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap rounded-button px-3.5 @max-[420px]:px-2.5 text-control text-ink-2 hover:text-ink disabled:cursor-not-allowed disabled:opacity-50 data-[state=on]:bg-seg-on data-[state=on]:text-ink data-[state=on]:shadow-sel",
158
170
  context.block && "h-control flex-1 shrink justify-center",
159
171
  className,
160
172
  )}
@@ -1,12 +1,14 @@
1
- import type { ComponentPropsWithRef } from "react";
1
+ import type { ComponentPropsWithRef, Ref } from "react";
2
2
  import { useUiStrings } from "../../i18n/index.js";
3
3
  import { Check, X } from "../../icons/index.js";
4
+ import { intentAttributes } from "../../intent/attributes.js";
5
+ import type { IntentProps } from "../../intent/types.js";
4
6
  import type { ClassNames } from "../../utils/class-names.js";
5
7
  import { cn } from "../../utils/cn.js";
6
8
 
7
9
  export type StepStatus = "done" | "current" | "error" | "pending";
8
10
 
9
- export interface Step {
11
+ export interface Step extends IntentProps {
10
12
  id: string;
11
13
  label: string;
12
14
  /**
@@ -16,6 +18,7 @@ export interface Step {
16
18
  * `aria-current="step"` whatever its status.
17
19
  */
18
20
  status?: StepStatus;
21
+ ref?: Ref<HTMLLIElement> | undefined;
19
22
  }
20
23
 
21
24
  const markerStatusClasses: Record<StepStatus, string> = {
@@ -53,6 +56,8 @@ export function Stepper({ steps, currentStepId, className, classNames, ...props
53
56
  return (
54
57
  <li
55
58
  key={step.id}
59
+ {...intentAttributes({ intent: step.intent, intentKey: step.intentKey ?? step.id })}
60
+ ref={step.ref}
56
61
  data-status={status}
57
62
  className={cn("flex min-w-0 items-center gap-1.5", classNames?.step)}
58
63
  >
@@ -2,7 +2,7 @@
2
2
 
3
3
  import {
4
4
  type AnchorHTMLAttributes,
5
- type ComponentPropsWithoutRef,
5
+ type ComponentPropsWithRef,
6
6
  cloneElement,
7
7
  createContext,
8
8
  isValidElement,
@@ -11,7 +11,9 @@ import {
11
11
  type Ref,
12
12
  useContext,
13
13
  } from "react";
14
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
14
15
  import { cn } from "../../utils/cn.js";
16
+ import { useComposedRefs } from "../../utils/compose.js";
15
17
  import { Slot } from "../../utils/slot.js";
16
18
 
17
19
  /** Props handed to `renderLink`: spread them on your router's link component. */
@@ -31,7 +33,7 @@ const TabsNavContext = createContext<TabsNavContextValue>({
31
33
  renderLink: undefined,
32
34
  });
33
35
 
34
- export interface TabsNavProps extends ComponentPropsWithoutRef<"nav"> {
36
+ export interface TabsNavProps extends ComponentPropsWithRef<"nav"> {
35
37
  /** Name of the strip (required: a page can have several navigations). */
36
38
  "aria-label": string;
37
39
  /** Value of the item that is the current page. */
@@ -61,7 +63,9 @@ export function TabsNav({ value, renderLink, className, children, ...props }: Ta
61
63
  );
62
64
  }
63
65
 
64
- export interface TabsNavLinkProps extends Omit<ComponentPropsWithoutRef<"a">, "children"> {
66
+ export interface TabsNavLinkProps
67
+ extends Omit<ComponentPropsWithRef<"a">, "children">,
68
+ IntentProps {
65
69
  /** Matches the strip's `value` to mark this item as the current page. */
66
70
  value: string;
67
71
  /** Overrides the match for routers that report the active state themselves. */
@@ -83,12 +87,21 @@ export function TabsNavLink({
83
87
  asChild = false,
84
88
  className,
85
89
  children,
90
+ intent,
91
+ intentKey,
92
+ ref,
86
93
  ...props
87
94
  }: TabsNavLinkProps) {
88
95
  const context = useContext(TabsNavContext);
96
+ const composedRef = useComposedRefs<HTMLAnchorElement>(
97
+ ref,
98
+ useIntentTarget<HTMLAnchorElement>({ intent, intentKey }),
99
+ );
89
100
  const isActive = active ?? (context.value !== undefined && context.value === value);
90
101
  const shared = {
102
+ ...intentAttributes({ intent, intentKey }),
91
103
  ...props,
104
+ ref: composedRef,
92
105
  "aria-current": isActive ? ("page" as const) : undefined,
93
106
  "data-active": isActive ? ("" as const) : undefined,
94
107
  className: cn(itemClasses, className),
@@ -3,11 +3,13 @@
3
3
  import {
4
4
  type ComponentPropsWithRef,
5
5
  createContext,
6
+ type FocusEvent,
6
7
  type KeyboardEvent,
7
8
  type MouseEvent,
8
9
  useContext,
9
10
  useId,
10
11
  } from "react";
12
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
11
13
  import { cn } from "../../utils/cn.js";
12
14
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
13
15
  import {
@@ -17,6 +19,19 @@ import {
17
19
  } from "../../utils/roving-focus.js";
18
20
  import { useControllableState } from "../../utils/use-controllable-state.js";
19
21
 
22
+ /**
23
+ * A click focuses a tab by script, and a script focus inherits `:focus-visible` when
24
+ * the previous focus came from the keyboard, which would frame something that was only clicked.
25
+ * `data-pointer-focus` (silenced in `base.css`) marks that focus; the next key press or blur
26
+ * clears it so the ring stays for keyboard users.
27
+ */
28
+ const markPointerFocus = (element: HTMLElement | null) => {
29
+ if (element) element.dataset.pointerFocus = "";
30
+ };
31
+ const clearPointerFocus = (element: HTMLElement) => {
32
+ delete element.dataset.pointerFocus;
33
+ };
34
+
20
35
  type TabsActivationMode = "automatic" | "manual";
21
36
  type GetItemProps = ReturnType<typeof useRovingFocus>["getItemProps"];
22
37
 
@@ -92,7 +107,14 @@ export interface TabsListProps extends ComponentPropsWithRef<"div"> {
92
107
  loop?: boolean | undefined;
93
108
  }
94
109
 
95
- export function TabsList({ className, loop = true, ref, onFocus, ...props }: TabsListProps) {
110
+ export function TabsList({
111
+ className,
112
+ loop = true,
113
+ ref,
114
+ onFocus,
115
+ onMouseDown,
116
+ ...props
117
+ }: TabsListProps) {
96
118
  const context = useTabsContext("TabsList");
97
119
  const roving = useRovingFocus({
98
120
  orientation: context.orientation,
@@ -112,6 +134,11 @@ export function TabsList({ className, loop = true, ref, onFocus, ...props }: Tab
112
134
  {...props}
113
135
  ref={composedRef}
114
136
  onFocus={composeHandlers(onFocus, rovingOnFocus)}
137
+ onMouseDown={composeHandlers(onMouseDown, (event: MouseEvent<HTMLDivElement>) => {
138
+ // A click on the strip's own padding would focus the strip, and the roving focus would
139
+ // then move to (and select) the first tab. Focus stays where it was instead.
140
+ if (event.target === event.currentTarget) event.preventDefault();
141
+ })}
115
142
  className={cn(
116
143
  "@container/tabs flex max-w-full gap-0.5 overflow-x-auto overscroll-x-contain border-b-divider px-2",
117
144
  className,
@@ -121,7 +148,9 @@ export function TabsList({ className, loop = true, ref, onFocus, ...props }: Tab
121
148
  );
122
149
  }
123
150
 
124
- export interface TabsTriggerProps extends Omit<ComponentPropsWithRef<"button">, "value"> {
151
+ export interface TabsTriggerProps
152
+ extends Omit<ComponentPropsWithRef<"button">, "value">,
153
+ IntentProps {
125
154
  value: string;
126
155
  /** Optional record count shown after the label. */
127
156
  count?: number;
@@ -136,9 +165,17 @@ export function TabsTrigger({
136
165
  onMouseDown,
137
166
  onKeyDown,
138
167
  onFocus,
168
+ onBlur,
169
+ intent,
170
+ intentKey,
171
+ ref,
139
172
  ...props
140
173
  }: TabsTriggerProps) {
141
174
  const context = useTabsContext("TabsTrigger");
175
+ const composedRef = useComposedRefs<HTMLButtonElement>(
176
+ ref,
177
+ useIntentTarget<HTMLButtonElement>({ intent, intentKey }, { role: "tab" }),
178
+ );
142
179
  const getItemProps = useContext(TabsListContext);
143
180
  if (!getItemProps) throw new Error("`TabsTrigger` must be used within `TabsList`");
144
181
  const selected = value === context.value;
@@ -146,6 +183,7 @@ export function TabsTrigger({
146
183
  const item = getItemProps<HTMLButtonElement>(value, {
147
184
  disabled,
148
185
  onKeyDown: composeHandlers(onKeyDown, (event: KeyboardEvent<HTMLButtonElement>) => {
186
+ clearPointerFocus(event.currentTarget);
149
187
  if (disabled || event.target !== event.currentTarget) return;
150
188
  if (event.key === " " || event.key === "Enter") context.setValue(value);
151
189
  }),
@@ -165,10 +203,16 @@ export function TabsTrigger({
165
203
  data-disabled={disabled ? "" : undefined}
166
204
  disabled={disabled}
167
205
  id={triggerId(context.baseId, value)}
206
+ {...intentAttributes({ intent, intentKey })}
168
207
  {...props}
169
208
  {...item}
209
+ ref={composedRef}
210
+ onBlur={composeHandlers(onBlur, (event: FocusEvent<HTMLButtonElement>) =>
211
+ clearPointerFocus(event.currentTarget),
212
+ )}
170
213
  onMouseDown={composeHandlers(onMouseDown, (event: MouseEvent<HTMLButtonElement>) => {
171
214
  if (!disabled && event.button === 0 && !event.ctrlKey) {
215
+ markPointerFocus(event.currentTarget);
172
216
  event.currentTarget.focus();
173
217
  context.setValue(value);
174
218
  } else {
@@ -176,7 +220,7 @@ export function TabsTrigger({
176
220
  }
177
221
  })}
178
222
  className={cn(
179
- "inline-flex min-h-(--touch-target) shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap border-b-2 border-transparent px-2.5 @max-[420px]/tabs:px-2 pt-2.75 pb-2.5 text-control text-ink-3 hover:text-ink focus-visible:-outline-offset-2 data-[state=active]:border-accent-word data-[state=active]:text-ink",
223
+ "inline-flex min-h-(--touch-target) shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap border-b-2 border-transparent px-2.5 @max-[420px]/tabs:px-2 pt-2.75 pb-2.5 text-control text-ink-3 hover:text-ink focus-visible:-outline-offset-2 disabled:cursor-not-allowed disabled:opacity-50 data-[state=active]:border-accent-word data-[state=active]:text-ink",
180
224
  className,
181
225
  )}
182
226
  >
@@ -186,7 +230,7 @@ export function TabsTrigger({
186
230
  );
187
231
  }
188
232
 
189
- export interface TabsContentProps extends Omit<ComponentPropsWithRef<"div">, "value"> {
233
+ export interface TabsContentProps extends Omit<ComponentPropsWithRef<"div">, "value">, IntentProps {
190
234
  value: string;
191
235
  /** Keeps the panel mounted (hidden) while inactive. */
192
236
  forceMount?: boolean | undefined;
@@ -197,9 +241,16 @@ export function TabsContent({
197
241
  value,
198
242
  forceMount,
199
243
  children,
244
+ intent,
245
+ intentKey,
246
+ ref,
200
247
  ...props
201
248
  }: TabsContentProps) {
202
249
  const context = useTabsContext("TabsContent");
250
+ const composedRef = useComposedRefs<HTMLDivElement>(
251
+ ref,
252
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "tabpanel" }),
253
+ );
203
254
  const selected = value === context.value;
204
255
  const present = forceMount || selected;
205
256
  if (!present) return null;
@@ -213,7 +264,9 @@ export function TabsContent({
213
264
  id={contentId(context.baseId, value)}
214
265
  // biome-ignore lint/a11y/noNoninteractiveTabindex: WAI-ARIA tabpanels are focusable so keyboard users can reach the content
215
266
  tabIndex={0}
267
+ {...intentAttributes({ intent, intentKey })}
216
268
  {...props}
269
+ ref={composedRef}
217
270
  className={cn(className)}
218
271
  >
219
272
  {children}
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  type KeyboardEvent,
6
6
  type ReactNode,
7
7
  useEffect,
@@ -10,6 +10,7 @@ import {
10
10
  } from "react";
11
11
  import { Button, type ButtonSize } from "../../atoms/button/button.js";
12
12
  import { useUiStrings } from "../../i18n/index.js";
13
+ import { type IntentProps, useIntentTargets } from "../../intent/index.js";
13
14
  import type { ClassNames } from "../../utils/class-names.js";
14
15
  import { cn } from "../../utils/cn.js";
15
16
  import { useControllableState } from "../../utils/use-controllable-state.js";
@@ -18,7 +19,7 @@ import { clampIndex, evaluateGates, formatStepOf, isAdvanceKey, type WizardGate
18
19
 
19
20
  export type { WizardGate } from "./model.js";
20
21
 
21
- export interface WizardStep {
22
+ export interface WizardStep extends IntentProps {
22
23
  id: string;
23
24
  label: string;
24
25
  content: ReactNode;
@@ -40,7 +41,7 @@ export type WizardPart =
40
41
  | "next";
41
42
 
42
43
  export interface WizardProps
43
- extends Omit<ComponentPropsWithoutRef<"div">, "children" | "defaultValue" | "onChange"> {
44
+ extends Omit<ComponentPropsWithRef<"div">, "children" | "defaultValue" | "onChange"> {
44
45
  steps: readonly WizardStep[];
45
46
  /** Controlled current step id. */
46
47
  value?: string | undefined;
@@ -88,6 +89,7 @@ export function Wizard({
88
89
  ...props
89
90
  }: WizardProps) {
90
91
  const strings = useUiStrings();
92
+ const bind = useIntentTargets();
91
93
  const [stepId, setStepId] = useControllableState<string>({
92
94
  prop: valueProp,
93
95
  defaultProp: defaultValue ?? steps[0]?.id ?? "",
@@ -164,7 +166,13 @@ export function Wizard({
164
166
  >
165
167
  <Stepper
166
168
  aria-label={strings.steps}
167
- steps={steps.map(({ id, label: stepLabel }) => ({ id, label: stepLabel }))}
169
+ steps={steps.map(({ id, label: stepLabel, intent, intentKey }) => ({
170
+ id,
171
+ label: stepLabel,
172
+ intent,
173
+ intentKey: intentKey ?? id,
174
+ ref: bind<HTMLLIElement>({ intent, intentKey: intentKey ?? id }, { requireName: false }),
175
+ }))}
168
176
  currentStepId={current.id}
169
177
  className={classNames?.stepper}
170
178
  />