@jcsoftdev/ui 0.9.0 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (461) hide show
  1. package/CHANGELOG.md +132 -0
  2. package/README.md +22 -3
  3. package/dist/ai/attachment/attachment.d.ts +4 -3
  4. package/dist/ai/attachment/attachment.js +5 -1
  5. package/dist/ai/chat-message/chat-message.d.ts +4 -3
  6. package/dist/ai/chat-message/chat-message.js +5 -0
  7. package/dist/ai/code-block/code-block.js +2 -2
  8. package/dist/ai/conversation/conversation.d.ts +2 -2
  9. package/dist/ai/internal/disclosure.js +1 -1
  10. package/dist/ai/internal/icon-action.d.ts +4 -3
  11. package/dist/ai/internal/icon-action.js +11 -2
  12. package/dist/ai/message-actions/message-actions.d.ts +6 -3
  13. package/dist/ai/message-actions/message-actions.js +26 -1
  14. package/dist/ai/prompt-input/prompt-input.d.ts +3 -2
  15. package/dist/ai/prompt-input/prompt-input.js +14 -4
  16. package/dist/ai/prompt-suggestion/prompt-suggestion.d.ts +5 -4
  17. package/dist/ai/prompt-suggestion/prompt-suggestion.js +4 -0
  18. package/dist/ai/source/source.d.ts +4 -3
  19. package/dist/ai/source/source.js +16 -1
  20. package/dist/ai/tool-call/tool-call.d.ts +3 -2
  21. package/dist/ai/tool-call/tool-call.js +5 -1
  22. package/dist/atoms/big-date/big-date.d.ts +2 -2
  23. package/dist/atoms/button/button.d.ts +3 -2
  24. package/dist/atoms/button/button.js +9 -0
  25. package/dist/atoms/checkbox/checkbox.d.ts +5 -3
  26. package/dist/atoms/checkbox/checkbox.js +29 -19
  27. package/dist/atoms/chip/chip.d.ts +3 -2
  28. package/dist/atoms/chip/chip.js +10 -1
  29. package/dist/atoms/divider/divider.d.ts +2 -2
  30. package/dist/atoms/elapsed-time/elapsed-time.d.ts +2 -2
  31. package/dist/atoms/elapsed-time/elapsed-time.js +10 -7
  32. package/dist/atoms/elapsed-time/model.d.ts +8 -0
  33. package/dist/atoms/elapsed-time/model.js +44 -0
  34. package/dist/atoms/icon-button/icon-button.d.ts +2 -1
  35. package/dist/atoms/internal/labelled-control.d.ts +16 -0
  36. package/dist/atoms/internal/labelled-control.js +56 -0
  37. package/dist/atoms/number-value/number-value.d.ts +2 -2
  38. package/dist/atoms/pressable-feedback/pressable-feedback.d.ts +4 -3
  39. package/dist/atoms/pressable-feedback/pressable-feedback.js +13 -1
  40. package/dist/atoms/progress/progress.d.ts +2 -2
  41. package/dist/atoms/radio-group/radio-group-primitive.d.ts +3 -2
  42. package/dist/atoms/radio-group/radio-group-primitive.js +10 -1
  43. package/dist/atoms/radio-group/radio-group.d.ts +2 -0
  44. package/dist/atoms/radio-group/radio-group.js +3 -1
  45. package/dist/atoms/seal/seal.d.ts +2 -2
  46. package/dist/atoms/status-pill/status-pill.js +1 -1
  47. package/dist/atoms/switch/switch.d.ts +7 -4
  48. package/dist/atoms/switch/switch.js +35 -5
  49. package/dist/atoms/table-glyph/table-glyph.d.ts +2 -2
  50. package/dist/atoms/trend-chip/trend-chip.d.ts +2 -2
  51. package/dist/auth/login-form/parts.js +2 -2
  52. package/dist/calendar/date-calendar/date-calendar.js +1 -1
  53. package/dist/calendar/day-chip/day-chip.d.ts +3 -2
  54. package/dist/calendar/day-chip/day-chip.js +12 -1
  55. package/dist/calendar/event-block/event-block.d.ts +3 -2
  56. package/dist/calendar/event-block/event-block.js +7 -0
  57. package/dist/calendar/internal/grid-navigation.d.ts +11 -0
  58. package/dist/calendar/internal/grid-navigation.js +34 -0
  59. package/dist/calendar/internal/intent.d.ts +3 -0
  60. package/dist/calendar/internal/intent.js +7 -0
  61. package/dist/calendar/internal/month-model.d.ts +11 -0
  62. package/dist/calendar/internal/month-model.js +11 -0
  63. package/dist/calendar/internal/types.d.ts +4 -0
  64. package/dist/calendar/month-view/month-grid.d.ts +27 -0
  65. package/dist/calendar/month-view/month-grid.js +210 -0
  66. package/dist/calendar/month-view/month-view.d.ts +3 -1
  67. package/dist/calendar/month-view/month-view.js +29 -131
  68. package/dist/calendar/week-view/week-view.d.ts +3 -1
  69. package/dist/calendar/week-view/week-view.js +218 -128
  70. package/dist/charts/bar-chart/bar-race-chart.js +1 -1
  71. package/dist/charts/core/breadcrumb.js +1 -1
  72. package/dist/charts/core/chart-states.js +1 -1
  73. package/dist/charts/core/distribution/xy-points.js +4 -2
  74. package/dist/charts/crossfilter/crossfilter.js +1 -1
  75. package/dist/charts/gantt-chart/gantt-chart.js +1 -1
  76. package/dist/charts/maps/geo/map-data-table.js +1 -1
  77. package/dist/charts/sankey-chart/sankey-chart.js +1 -3
  78. package/dist/charts/tree-chart/tree-chart.js +1 -1
  79. package/dist/containers/action-bar/action-bar.d.ts +2 -2
  80. package/dist/containers/action-bar/action-bar.js +1 -1
  81. package/dist/containers/aside/aside.d.ts +3 -3
  82. package/dist/containers/banner/banner.d.ts +2 -2
  83. package/dist/containers/card/card.d.ts +5 -5
  84. package/dist/containers/card/card.js +3 -1
  85. package/dist/containers/carousel/carousel.d.ts +2 -2
  86. package/dist/containers/carousel/carousel.js +2 -2
  87. package/dist/containers/cols/cols.d.ts +3 -3
  88. package/dist/containers/comment/comment.d.ts +2 -2
  89. package/dist/containers/confirm-action/confirm-action.d.ts +3 -2
  90. package/dist/containers/confirm-action/confirm-action.js +10 -2
  91. package/dist/containers/dashboard/dashboard.d.ts +4 -4
  92. package/dist/containers/data-grid/column-menu.js +1 -1
  93. package/dist/containers/data-grid/data-grid.d.ts +7 -3
  94. package/dist/containers/data-grid/data-grid.js +45 -7
  95. package/dist/containers/data-grid/formula-bar.js +1 -1
  96. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  97. package/dist/containers/data-grid/tool-panel.js +1 -1
  98. package/dist/containers/description-list/description-list.d.ts +2 -2
  99. package/dist/containers/detail-header/detail-header.d.ts +2 -2
  100. package/dist/containers/facts/facts.d.ts +2 -2
  101. package/dist/containers/feed/feed.d.ts +5 -4
  102. package/dist/containers/feed/feed.js +12 -0
  103. package/dist/containers/file-tree/file-tree.js +11 -0
  104. package/dist/containers/file-tree/model.d.ts +2 -0
  105. package/dist/containers/filter-bar/filter-bar.d.ts +2 -2
  106. package/dist/containers/floor-plan/floor-plan.d.ts +2 -0
  107. package/dist/containers/floor-plan/floor-plan.js +17 -9
  108. package/dist/containers/floor-plan/index.d.ts +1 -1
  109. package/dist/containers/floor-plan/index.js +6 -1
  110. package/dist/containers/floor-plan/model.d.ts +3 -0
  111. package/dist/containers/floor-plan/model.js +8 -0
  112. package/dist/containers/generic-row/generic-row.d.ts +8 -6
  113. package/dist/containers/generic-row/generic-row.js +3 -1
  114. package/dist/containers/grid/grid.d.ts +2 -2
  115. package/dist/containers/hbars/hbars.js +2 -2
  116. package/dist/containers/highlight-line/highlight-line.d.ts +2 -2
  117. package/dist/containers/item-card-group/item-card-group.d.ts +4 -2
  118. package/dist/containers/item-card-group/item-card-group.js +4 -0
  119. package/dist/containers/kanban/kanban.js +13 -0
  120. package/dist/containers/kanban/model.d.ts +2 -0
  121. package/dist/containers/kpi/kpi-model.d.ts +7 -0
  122. package/dist/containers/kpi/kpi-model.js +22 -0
  123. package/dist/containers/kpi/kpi-parts.d.ts +28 -0
  124. package/dist/containers/kpi/kpi-parts.js +121 -0
  125. package/dist/containers/kpi/kpi.d.ts +7 -30
  126. package/dist/containers/kpi/kpi.js +4 -119
  127. package/dist/containers/kpi-group/kpi-group.d.ts +2 -2
  128. package/dist/containers/list-detail/list-detail.d.ts +12 -11
  129. package/dist/containers/list-detail/list-detail.js +9 -1
  130. package/dist/containers/note/note.d.ts +2 -2
  131. package/dist/containers/order-ticket/index.d.ts +1 -1
  132. package/dist/containers/order-ticket/index.js +2 -0
  133. package/dist/containers/order-ticket/model.d.ts +6 -0
  134. package/dist/containers/order-ticket/model.js +9 -0
  135. package/dist/containers/order-ticket/order-ticket.d.ts +4 -3
  136. package/dist/containers/order-ticket/order-ticket.js +26 -10
  137. package/dist/containers/page/page.d.ts +2 -2
  138. package/dist/containers/page-header/back.d.ts +2 -2
  139. package/dist/containers/page-header/page-header.d.ts +6 -6
  140. package/dist/containers/pagination/cursor-pagination.d.ts +2 -2
  141. package/dist/containers/pagination/pagination.d.ts +2 -2
  142. package/dist/containers/pagination/pagination.js +2 -2
  143. package/dist/containers/resizable/resizable.d.ts +4 -4
  144. package/dist/containers/resizable/resizable.js +1 -1
  145. package/dist/containers/row-actions/row-actions.d.ts +4 -3
  146. package/dist/containers/row-actions/row-actions.js +14 -1
  147. package/dist/containers/scrolly/scrolly.js +1 -1
  148. package/dist/containers/section/section.d.ts +10 -9
  149. package/dist/containers/section/section.js +12 -0
  150. package/dist/containers/selectable-card/selectable-card.d.ts +3 -2
  151. package/dist/containers/selectable-card/selectable-card.js +10 -1
  152. package/dist/containers/settings-layout/settings-layout.d.ts +7 -6
  153. package/dist/containers/settings-layout/settings-layout.js +10 -1
  154. package/dist/containers/settings-row/settings-row.d.ts +4 -3
  155. package/dist/containers/settings-row/settings-row.js +4 -0
  156. package/dist/containers/shortcuts/shortcuts.d.ts +3 -3
  157. package/dist/containers/stack/stack.d.ts +2 -2
  158. package/dist/containers/table/table.d.ts +14 -13
  159. package/dist/containers/table/table.js +22 -4
  160. package/dist/containers/timeline/timeline.d.ts +5 -4
  161. package/dist/containers/timeline/timeline.js +12 -0
  162. package/dist/containers/toolbar/toolbar.d.ts +3 -3
  163. package/dist/forms/accent-picker/accent-picker.d.ts +5 -2
  164. package/dist/forms/accent-picker/accent-picker.js +22 -1
  165. package/dist/forms/checkbox-button-group/checkbox-button-group.d.ts +3 -2
  166. package/dist/forms/checkbox-button-group/checkbox-button-group.js +16 -0
  167. package/dist/forms/chip-group/chip-group.d.ts +4 -1
  168. package/dist/forms/chip-group/chip-group.js +20 -2
  169. package/dist/forms/combobox/combobox.d.ts +3 -2
  170. package/dist/forms/combobox/combobox.js +10 -1
  171. package/dist/forms/copy-field/copy-field.d.ts +4 -3
  172. package/dist/forms/copy-field/copy-field.js +7 -0
  173. package/dist/forms/date-picker/date-picker.d.ts +3 -2
  174. package/dist/forms/date-picker/date-picker.js +10 -1
  175. package/dist/forms/date-picker/date-time-picker.d.ts +3 -2
  176. package/dist/forms/date-picker/date-time-picker.js +4 -0
  177. package/dist/forms/dropzone/dropzone.d.ts +3 -2
  178. package/dist/forms/dropzone/dropzone.js +21 -3
  179. package/dist/forms/emoji-picker/emoji-picker.d.ts +3 -2
  180. package/dist/forms/emoji-picker/emoji-picker.js +9 -2
  181. package/dist/forms/emoji-reaction-button/emoji-reaction-button.d.ts +3 -2
  182. package/dist/forms/emoji-reaction-button/emoji-reaction-button.js +8 -1
  183. package/dist/forms/field/field.d.ts +2 -2
  184. package/dist/forms/fieldset/fieldset.d.ts +2 -2
  185. package/dist/forms/form/form.d.ts +6 -4
  186. package/dist/forms/form/form.js +10 -2
  187. package/dist/forms/form-footer/form-footer.d.ts +2 -2
  188. package/dist/forms/form-grid/form-grid.d.ts +3 -3
  189. package/dist/forms/form-section/form-section.d.ts +2 -2
  190. package/dist/forms/inline-select/inline-select.d.ts +4 -3
  191. package/dist/forms/inline-select/inline-select.js +9 -1
  192. package/dist/forms/input/input.d.ts +3 -2
  193. package/dist/forms/input/input.js +11 -3
  194. package/dist/forms/internal/button-option.d.ts +2 -0
  195. package/dist/forms/label/label.d.ts +2 -2
  196. package/dist/forms/native-select/native-select.d.ts +4 -3
  197. package/dist/forms/native-select/native-select.js +4 -0
  198. package/dist/forms/number-stepper/number-stepper.d.ts +2 -1
  199. package/dist/forms/number-stepper/number-stepper.js +13 -3
  200. package/dist/forms/password-input/password-input.d.ts +1 -1
  201. package/dist/forms/password-input/password-input.js +12 -0
  202. package/dist/forms/pin-input/pin-input.d.ts +3 -2
  203. package/dist/forms/pin-input/pin-input.js +8 -1
  204. package/dist/forms/radio-button-group/radio-button-group.d.ts +3 -2
  205. package/dist/forms/radio-button-group/radio-button-group.js +16 -0
  206. package/dist/forms/rating/rating.d.ts +3 -2
  207. package/dist/forms/rating/rating.js +12 -0
  208. package/dist/forms/select/select.d.ts +4 -3
  209. package/dist/forms/select/select.js +11 -2
  210. package/dist/forms/select-menu/select-menu.d.ts +3 -2
  211. package/dist/forms/select-menu/select-menu.js +10 -1
  212. package/dist/forms/slider/model.d.ts +1 -0
  213. package/dist/forms/slider/model.js +5 -0
  214. package/dist/forms/slider/slider.d.ts +2 -1
  215. package/dist/forms/slider/slider.js +12 -3
  216. package/dist/forms/textarea/textarea.d.ts +4 -3
  217. package/dist/forms/textarea/textarea.js +4 -2
  218. package/dist/forms/time-input/time-input.d.ts +4 -3
  219. package/dist/forms/time-input/time-input.js +13 -1
  220. package/dist/i18n/strings.d.ts +18 -0
  221. package/dist/i18n/strings.js +12 -0
  222. package/dist/intent/attributes.d.ts +11 -0
  223. package/dist/intent/attributes.js +77 -0
  224. package/dist/intent/bridge.d.ts +8 -0
  225. package/dist/intent/bridge.js +19 -0
  226. package/dist/intent/index.d.ts +4 -0
  227. package/dist/intent/index.js +31 -0
  228. package/dist/intent/target-registrations.d.ts +16 -0
  229. package/dist/intent/target-registrations.js +91 -0
  230. package/dist/intent/types.d.ts +29 -0
  231. package/dist/intent/types.js +0 -0
  232. package/dist/intent/use-intent-target.d.ts +4 -0
  233. package/dist/intent/use-intent-target.js +75 -0
  234. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +6 -4
  235. package/dist/navigation/breadcrumbs/breadcrumbs.js +11 -1
  236. package/dist/navigation/floating-toc/floating-toc.d.ts +2 -2
  237. package/dist/navigation/floating-toc/floating-toc.js +5 -0
  238. package/dist/navigation/floating-toc/model.d.ts +2 -1
  239. package/dist/navigation/segmented/segmented.d.ts +3 -2
  240. package/dist/navigation/segmented/segmented.js +11 -1
  241. package/dist/navigation/stepper/stepper.d.ts +4 -2
  242. package/dist/navigation/stepper/stepper.js +3 -0
  243. package/dist/navigation/tabs/tabs-nav.d.ts +5 -4
  244. package/dist/navigation/tabs/tabs-nav.js +11 -0
  245. package/dist/navigation/tabs/tabs.d.ts +6 -5
  246. package/dist/navigation/tabs/tabs.js +44 -2
  247. package/dist/navigation/wizard/wizard.d.ts +4 -3
  248. package/dist/navigation/wizard/wizard.js +9 -1
  249. package/dist/overlays/alert-dialog/alert-dialog.d.ts +5 -4
  250. package/dist/overlays/alert-dialog/alert-dialog.js +20 -3
  251. package/dist/overlays/context-menu/context-menu.d.ts +14 -12
  252. package/dist/overlays/context-menu/context-menu.js +57 -8
  253. package/dist/overlays/dialog/dialog.d.ts +14 -8
  254. package/dist/overlays/dialog/dialog.js +29 -6
  255. package/dist/overlays/drawer/drawer.d.ts +6 -5
  256. package/dist/overlays/drawer/drawer.js +11 -0
  257. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +14 -13
  258. package/dist/overlays/dropdown-menu/dropdown-menu.js +58 -5
  259. package/dist/overlays/hover-card/hover-card.d.ts +4 -3
  260. package/dist/overlays/hover-card/hover-card.js +12 -1
  261. package/dist/overlays/popover/popover.d.ts +3 -2
  262. package/dist/overlays/popover/popover.js +12 -1
  263. package/dist/overlays/tooltip/model.d.ts +1 -0
  264. package/dist/overlays/tooltip/model.js +8 -0
  265. package/dist/overlays/tooltip/tooltip.d.ts +2 -1
  266. package/dist/overlays/tooltip/tooltip.js +8 -2
  267. package/dist/palette/command-palette/command-palette.d.ts +8 -4
  268. package/dist/palette/command-palette/command-palette.js +49 -1
  269. package/dist/palette/command-palette/index.d.ts +1 -0
  270. package/dist/palette/command-palette/index.js +3 -1
  271. package/dist/palette/command-palette/model.d.ts +7 -0
  272. package/dist/palette/command-palette/model.js +11 -0
  273. package/dist/primitives/command/command.js +4 -1
  274. package/dist/primitives/dialog/dialog.js +1 -3
  275. package/dist/primitives/popper/popper.js +15 -4
  276. package/dist/shell/bottom-nav/bottom-nav.js +54 -42
  277. package/dist/shell/sidebar/sidebar.d.ts +5 -3
  278. package/dist/shell/sidebar/sidebar.js +14 -2
  279. package/dist/shell/topbar/topbar.js +2 -2
  280. package/dist/showcase/bento.js +1 -0
  281. package/dist/utils/is-production.d.ts +1 -0
  282. package/dist/utils/is-production.js +6 -0
  283. package/dist/utils/slot.js +17 -3
  284. package/package.json +2 -2
  285. package/src/ai/attachment/attachment.tsx +10 -3
  286. package/src/ai/chat-message/chat-message.tsx +10 -2
  287. package/src/ai/code-block/code-block.tsx +2 -2
  288. package/src/ai/conversation/conversation.tsx +2 -2
  289. package/src/ai/internal/disclosure.tsx +1 -1
  290. package/src/ai/internal/icon-action.tsx +14 -4
  291. package/src/ai/message-actions/message-actions.tsx +28 -3
  292. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  293. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  294. package/src/ai/source/source.tsx +17 -3
  295. package/src/ai/tool-call/tool-call.tsx +6 -1
  296. package/src/atoms/big-date/big-date.tsx +2 -2
  297. package/src/atoms/button/button.tsx +11 -1
  298. package/src/atoms/checkbox/checkbox.tsx +40 -21
  299. package/src/atoms/chip/chip.tsx +12 -2
  300. package/src/atoms/divider/divider.tsx +2 -2
  301. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  302. package/src/atoms/elapsed-time/model.ts +57 -0
  303. package/src/atoms/icon-button/icon-button.tsx +3 -1
  304. package/src/atoms/internal/labelled-control.tsx +83 -0
  305. package/src/atoms/number-value/number-value.tsx +2 -2
  306. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  307. package/src/atoms/progress/progress.tsx +2 -2
  308. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  309. package/src/atoms/radio-group/radio-group.tsx +5 -1
  310. package/src/atoms/seal/seal.tsx +2 -2
  311. package/src/atoms/status-pill/status-pill.tsx +1 -1
  312. package/src/atoms/switch/switch.tsx +43 -9
  313. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  314. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  315. package/src/auth/login-form/parts.tsx +2 -2
  316. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  317. package/src/calendar/day-chip/day-chip.tsx +14 -2
  318. package/src/calendar/event-block/event-block.tsx +9 -1
  319. package/src/calendar/internal/grid-navigation.ts +47 -0
  320. package/src/calendar/internal/intent.ts +10 -0
  321. package/src/calendar/internal/month-model.ts +23 -0
  322. package/src/calendar/internal/types.ts +4 -0
  323. package/src/calendar/month-view/month-grid.tsx +248 -0
  324. package/src/calendar/month-view/month-view.tsx +32 -148
  325. package/src/calendar/week-view/week-view.tsx +87 -10
  326. package/src/charts/README.md +10 -0
  327. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  328. package/src/charts/core/breadcrumb.tsx +1 -1
  329. package/src/charts/core/chart-states.tsx +1 -1
  330. package/src/charts/core/distribution/xy-points.tsx +4 -2
  331. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  332. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  333. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  334. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  335. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  336. package/src/containers/action-bar/action-bar.tsx +3 -3
  337. package/src/containers/aside/aside.tsx +3 -3
  338. package/src/containers/banner/banner.tsx +2 -2
  339. package/src/containers/card/card.tsx +7 -5
  340. package/src/containers/carousel/carousel.tsx +4 -4
  341. package/src/containers/cols/cols.tsx +3 -3
  342. package/src/containers/comment/comment.tsx +2 -2
  343. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  344. package/src/containers/dashboard/dashboard.tsx +4 -4
  345. package/src/containers/data-grid/column-menu.tsx +1 -1
  346. package/src/containers/data-grid/data-grid.tsx +53 -4
  347. package/src/containers/data-grid/formula-bar.tsx +1 -1
  348. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  349. package/src/containers/data-grid/tool-panel.tsx +1 -1
  350. package/src/containers/description-list/description-list.tsx +2 -2
  351. package/src/containers/detail-header/detail-header.tsx +2 -2
  352. package/src/containers/facts/facts.tsx +2 -2
  353. package/src/containers/feed/feed.tsx +16 -3
  354. package/src/containers/file-tree/file-tree.tsx +11 -0
  355. package/src/containers/file-tree/model.ts +2 -0
  356. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  357. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  358. package/src/containers/floor-plan/index.ts +7 -1
  359. package/src/containers/floor-plan/model.ts +16 -0
  360. package/src/containers/generic-row/generic-row.tsx +9 -6
  361. package/src/containers/grid/grid.tsx +2 -2
  362. package/src/containers/hbars/hbars.tsx +23 -21
  363. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  364. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  365. package/src/containers/kanban/kanban.tsx +13 -0
  366. package/src/containers/kanban/model.ts +2 -0
  367. package/src/containers/kpi/kpi-model.ts +37 -0
  368. package/src/containers/kpi/kpi-parts.tsx +153 -0
  369. package/src/containers/kpi/kpi.tsx +10 -176
  370. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  371. package/src/containers/list-detail/list-detail.tsx +22 -12
  372. package/src/containers/note/note.tsx +2 -2
  373. package/src/containers/order-ticket/index.ts +2 -0
  374. package/src/containers/order-ticket/model.ts +21 -0
  375. package/src/containers/order-ticket/order-ticket.tsx +30 -13
  376. package/src/containers/page/page.tsx +2 -2
  377. package/src/containers/page-header/back.tsx +2 -2
  378. package/src/containers/page-header/page-header.tsx +6 -6
  379. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  380. package/src/containers/pagination/pagination.tsx +4 -4
  381. package/src/containers/resizable/resizable.tsx +7 -5
  382. package/src/containers/row-actions/row-actions.tsx +18 -3
  383. package/src/containers/scrolly/scrolly.tsx +1 -1
  384. package/src/containers/section/section.tsx +21 -8
  385. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  386. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  387. package/src/containers/settings-row/settings-row.tsx +7 -2
  388. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  389. package/src/containers/stack/stack.tsx +2 -2
  390. package/src/containers/table/table.tsx +35 -14
  391. package/src/containers/timeline/timeline.tsx +17 -3
  392. package/src/containers/toolbar/toolbar.tsx +3 -3
  393. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  394. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  395. package/src/forms/chip-group/chip-group.tsx +23 -2
  396. package/src/forms/combobox/combobox.tsx +15 -4
  397. package/src/forms/copy-field/copy-field.tsx +11 -2
  398. package/src/forms/date-picker/date-picker.tsx +23 -12
  399. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  400. package/src/forms/dropzone/dropzone.tsx +18 -3
  401. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  402. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  403. package/src/forms/field/field.tsx +2 -2
  404. package/src/forms/fieldset/fieldset.tsx +2 -2
  405. package/src/forms/form/form.tsx +13 -5
  406. package/src/forms/form-footer/form-footer.tsx +2 -2
  407. package/src/forms/form-grid/form-grid.tsx +3 -3
  408. package/src/forms/form-section/form-section.tsx +2 -2
  409. package/src/forms/inline-select/inline-select.tsx +14 -3
  410. package/src/forms/input/input.tsx +14 -3
  411. package/src/forms/internal/button-option.tsx +2 -0
  412. package/src/forms/label/label.tsx +2 -2
  413. package/src/forms/native-select/native-select.tsx +9 -2
  414. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  415. package/src/forms/password-input/password-input.tsx +12 -0
  416. package/src/forms/pin-input/pin-input.tsx +9 -1
  417. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  418. package/src/forms/rating/rating.tsx +14 -1
  419. package/src/forms/select/select.tsx +14 -4
  420. package/src/forms/select-menu/select-menu.tsx +15 -4
  421. package/src/forms/slider/model.ts +5 -0
  422. package/src/forms/slider/slider.tsx +13 -3
  423. package/src/forms/textarea/textarea.tsx +7 -4
  424. package/src/forms/time-input/time-input.tsx +19 -5
  425. package/src/i18n/strings.ts +18 -0
  426. package/src/intent/attributes.ts +96 -0
  427. package/src/intent/bridge.tsx +25 -0
  428. package/src/intent/index.ts +24 -0
  429. package/src/intent/target-registrations.ts +127 -0
  430. package/src/intent/types.ts +44 -0
  431. package/src/intent/use-intent-target.ts +96 -0
  432. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  433. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  434. package/src/navigation/floating-toc/model.ts +3 -1
  435. package/src/navigation/segmented/segmented.tsx +14 -2
  436. package/src/navigation/stepper/stepper.tsx +7 -2
  437. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  438. package/src/navigation/tabs/tabs.tsx +57 -4
  439. package/src/navigation/wizard/wizard.tsx +12 -4
  440. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  441. package/src/overlays/context-menu/context-menu.tsx +58 -11
  442. package/src/overlays/dialog/dialog.tsx +49 -20
  443. package/src/overlays/drawer/drawer.tsx +15 -4
  444. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  445. package/src/overlays/hover-card/hover-card.tsx +13 -2
  446. package/src/overlays/popover/popover.tsx +12 -1
  447. package/src/overlays/tooltip/model.ts +8 -0
  448. package/src/overlays/tooltip/tooltip.tsx +15 -2
  449. package/src/palette/command-palette/command-palette.tsx +66 -3
  450. package/src/palette/command-palette/index.ts +1 -0
  451. package/src/palette/command-palette/model.ts +15 -0
  452. package/src/primitives/command/command.tsx +4 -1
  453. package/src/primitives/dialog/dialog.tsx +1 -4
  454. package/src/primitives/popper/popper.tsx +16 -5
  455. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  456. package/src/shell/sidebar/sidebar.tsx +22 -4
  457. package/src/shell/topbar/topbar.tsx +2 -2
  458. package/src/showcase/bento.tsx +2 -0
  459. package/src/utils/is-production.ts +3 -0
  460. package/src/utils/slot.tsx +21 -3
  461. package/styles/base.css +39 -0
@@ -1,20 +1,30 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
+ import { intentAttributes } from "../../intent/attributes.js";
3
+ import type { IntentProps } from "../../intent/types.js";
2
4
  import { cn } from "../../utils/cn.js";
3
5
 
4
- export interface IconActionProps extends ComponentPropsWithoutRef<"button"> {
6
+ export interface IconActionProps extends ComponentPropsWithRef<"button">, IntentProps {
5
7
  /** Accessible name; the icon alone carries no text. */
6
8
  label: string;
7
9
  }
8
10
 
9
11
  /** Square ghost icon button used by the AI set (copy, regenerate, remove…). */
10
- export function IconAction({ label, className, children, ...props }: IconActionProps) {
12
+ export function IconAction({
13
+ label,
14
+ className,
15
+ children,
16
+ intent,
17
+ intentKey,
18
+ ...props
19
+ }: IconActionProps) {
11
20
  return (
12
21
  <button
22
+ {...intentAttributes({ intent, intentKey })}
13
23
  type="button"
14
24
  aria-label={label}
15
25
  title={label}
16
26
  className={cn(
17
- "inline-grid size-7 shrink-0 cursor-pointer place-items-center rounded-button text-ink-3 pressable hover:bg-surface-2 hover:text-ink focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-45 aria-pressed:bg-accent-soft aria-pressed:text-accent-ink [&_svg]:size-3.5",
27
+ "inline-grid size-7 shrink-0 cursor-pointer place-items-center rounded-button text-ink-3 pressable hover:bg-surface-2 hover:text-ink focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-50 aria-pressed:bg-accent-soft aria-pressed:text-accent-ink [&_svg]:size-3.5",
18
28
  className,
19
29
  )}
20
30
  {...props}
@@ -1,14 +1,19 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, useState } from "react";
3
+ import { type ComponentPropsWithRef, useState } from "react";
4
4
  import { Check, Copy, RefreshCw, ThumbsDown, ThumbsUp } from "../../icons/index.js";
5
+ import type { IntentProps } from "../../intent/types.js";
6
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
5
7
  import { cn } from "../../utils/cn.js";
6
8
  import { IconAction } from "../internal/icon-action.js";
7
9
  import { useCopy } from "../internal/use-copy.js";
8
10
 
9
11
  export type MessageFeedback = "like" | "dislike" | null;
10
12
 
11
- export interface MessageActionsProps extends Omit<ComponentPropsWithoutRef<"div">, "onCopy"> {
13
+ export type MessageActionName = "copy" | "regenerate" | "like" | "dislike";
14
+
15
+ export interface MessageActionsProps extends Omit<ComponentPropsWithRef<"div">, "onCopy"> {
16
+ actionIntents?: Partial<Record<MessageActionName, IntentProps>>;
12
17
  /** Text copied by the copy button. */
13
18
  text: string;
14
19
  onCopy?: (text: string) => void;
@@ -28,9 +33,18 @@ export function MessageActions({
28
33
  onFeedback,
29
34
  feedback: feedbackProp,
30
35
  defaultFeedback = null,
36
+ actionIntents,
31
37
  className,
32
38
  ...props
33
39
  }: MessageActionsProps) {
40
+ const copyIntent = actionIntents?.copy;
41
+ const regenerateIntent = actionIntents?.regenerate;
42
+ const likeIntent = actionIntents?.like;
43
+ const dislikeIntent = actionIntents?.dislike;
44
+ const copyRef = useIntentTarget<HTMLButtonElement>({ ...copyIntent });
45
+ const regenerateRef = useIntentTarget<HTMLButtonElement>({ ...regenerateIntent });
46
+ const likeRef = useIntentTarget<HTMLButtonElement>({ ...likeIntent });
47
+ const dislikeRef = useIntentTarget<HTMLButtonElement>({ ...dislikeIntent });
34
48
  const { copied, copy } = useCopy();
35
49
  const [state, setState] = useState<MessageFeedback>(defaultFeedback);
36
50
  const feedback = feedbackProp === undefined ? state : feedbackProp;
@@ -49,6 +63,8 @@ export function MessageActions({
49
63
  {...props}
50
64
  >
51
65
  <IconAction
66
+ {...copyIntent}
67
+ ref={copyRef}
52
68
  label={copied ? "Mensaje copiado" : "Copiar mensaje"}
53
69
  onClick={() => {
54
70
  copy(text);
@@ -58,13 +74,20 @@ export function MessageActions({
58
74
  {copied ? <Check aria-hidden /> : <Copy aria-hidden />}
59
75
  </IconAction>
60
76
  {onRegenerate ? (
61
- <IconAction label="Regenerar respuesta" onClick={onRegenerate}>
77
+ <IconAction
78
+ {...regenerateIntent}
79
+ ref={regenerateRef}
80
+ label="Regenerar respuesta"
81
+ onClick={onRegenerate}
82
+ >
62
83
  <RefreshCw aria-hidden />
63
84
  </IconAction>
64
85
  ) : null}
65
86
  {onFeedback ? (
66
87
  <>
67
88
  <IconAction
89
+ {...likeIntent}
90
+ ref={likeRef}
68
91
  label="Me gusta"
69
92
  aria-pressed={feedback === "like"}
70
93
  onClick={() => choose("like")}
@@ -72,6 +95,8 @@ export function MessageActions({
72
95
  <ThumbsUp aria-hidden />
73
96
  </IconAction>
74
97
  <IconAction
98
+ {...dislikeIntent}
99
+ ref={dislikeRef}
75
100
  label="No me gusta"
76
101
  aria-pressed={feedback === "dislike"}
77
102
  onClick={() => choose("dislike")}
@@ -9,8 +9,12 @@ import {
9
9
  useState,
10
10
  } from "react";
11
11
  import { ArrowUp, Square } 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 type { ClassNames } from "../../utils/class-names.js";
13
16
  import { cn } from "../../utils/cn.js";
17
+ import { useComposedRefs } from "../../utils/compose.js";
14
18
  import { shouldSubmit } from "./keys.js";
15
19
 
16
20
  export type PromptInputPart =
@@ -24,7 +28,7 @@ export type PromptInputPart =
24
28
  | "stop"
25
29
  | "hint";
26
30
 
27
- export interface PromptInputProps {
31
+ export interface PromptInputProps extends IntentProps {
28
32
  value?: string;
29
33
  defaultValue?: string;
30
34
  onValueChange?: (value: string) => void;
@@ -70,10 +74,16 @@ export function PromptInput({
70
74
  hint,
71
75
  className,
72
76
  classNames,
77
+ intent,
78
+ intentKey,
73
79
  }: PromptInputProps) {
74
80
  const [state, setState] = useState(defaultValue);
75
81
  const value = valueProp ?? state;
76
82
  const area = useRef<HTMLTextAreaElement>(null);
83
+ const textareaRef = useComposedRefs(
84
+ area,
85
+ useIntentTarget<HTMLTextAreaElement>({ intent, intentKey }),
86
+ );
77
87
 
78
88
  useLayoutEffect(() => {
79
89
  const el = area.current;
@@ -137,7 +147,8 @@ export function PromptInput({
137
147
  </div>
138
148
  ) : null}
139
149
  <textarea
140
- ref={area}
150
+ {...intentAttributes({ intent, intentKey })}
151
+ ref={textareaRef}
141
152
  rows={1}
142
153
  value={value}
143
154
  disabled={disabled}
@@ -146,7 +157,7 @@ export function PromptInput({
146
157
  onChange={(event) => set(event.target.value)}
147
158
  onKeyDown={onKeyDown}
148
159
  className={cn(
149
- "block max-h-none w-full min-w-0 resize-none bg-transparent px-1 py-1 text-body leading-normal text-ink outline-none placeholder:text-ink-3 disabled:cursor-not-allowed",
160
+ "block max-h-none w-full min-w-0 resize-none bg-transparent px-1 py-1 text-body leading-normal text-ink outline-none placeholder:text-ink-3 disabled:cursor-not-allowed disabled:opacity-50",
150
161
  classNames?.textarea,
151
162
  )}
152
163
  />
@@ -173,7 +184,7 @@ export function PromptInput({
173
184
  aria-label="Enviar mensaje"
174
185
  disabled={!canSend}
175
186
  className={cn(
176
- "inline-grid size-8 shrink-0 cursor-pointer place-items-center rounded-button bg-accent text-on-accent pressable focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-45",
187
+ "inline-grid size-8 shrink-0 cursor-pointer place-items-center rounded-button bg-accent text-on-accent pressable focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-50",
177
188
  classNames?.send,
178
189
  )}
179
190
  >
@@ -1,8 +1,11 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
+ import { intentAttributes } from "../../intent/attributes.js";
3
+ import type { IntentProps } from "../../intent/types.js";
2
4
  import { cn } from "../../utils/cn.js";
3
5
 
4
6
  export interface PromptSuggestionProps
5
- extends Omit<ComponentPropsWithoutRef<"button">, "onSelect" | "children"> {
7
+ extends Omit<ComponentPropsWithRef<"button">, "onSelect" | "children">,
8
+ IntentProps {
6
9
  /** Receives the suggestion text when pressed (the visible label is the text). */
7
10
  onSelect?: (text: string) => void;
8
11
  children: string;
@@ -14,11 +17,14 @@ export function PromptSuggestion({
14
17
  children,
15
18
  className,
16
19
  onClick,
20
+ intent,
21
+ intentKey,
17
22
  ...props
18
23
  }: PromptSuggestionProps) {
19
24
  return (
20
25
  <button
21
26
  type="button"
27
+ {...intentAttributes({ intent, intentKey })}
22
28
  onClick={(event) => {
23
29
  onClick?.(event);
24
30
  onSelect?.(children);
@@ -34,7 +40,7 @@ export function PromptSuggestion({
34
40
  );
35
41
  }
36
42
 
37
- export interface PromptSuggestionListProps extends ComponentPropsWithoutRef<"fieldset"> {
43
+ export interface PromptSuggestionListProps extends ComponentPropsWithRef<"fieldset"> {
38
44
  label?: string;
39
45
  }
40
46
 
@@ -1,4 +1,6 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef, Ref } from "react";
2
+ import { intentAttributes } from "../../intent/attributes.js";
3
+ import type { IntentProps } from "../../intent/types.js";
2
4
  import {
3
5
  HoverCard,
4
6
  HoverCardContent,
@@ -17,7 +19,9 @@ export type SourcePart =
17
19
  | "cardTitle"
18
20
  | "cardSnippet";
19
21
 
20
- export interface SourceProps extends Omit<ComponentPropsWithoutRef<"a">, "href" | "title"> {
22
+ export interface SourceProps
23
+ extends Omit<ComponentPropsWithRef<"a">, "href" | "title">,
24
+ IntentProps {
21
25
  /** Citation number shown in the chip. */
22
26
  index?: number;
23
27
  title: string;
@@ -45,6 +49,9 @@ export function Source({
45
49
  snippet,
46
50
  className,
47
51
  classNames,
52
+ intent,
53
+ intentKey,
54
+ ref,
48
55
  ...props
49
56
  }: SourceProps) {
50
57
  const href = safeHref(url);
@@ -75,16 +82,23 @@ export function Source({
75
82
  <HoverCardTrigger asChild>
76
83
  {href ? (
77
84
  <a
85
+ {...intentAttributes({ intent, intentKey })}
78
86
  href={href}
79
87
  target="_blank"
80
88
  rel="noopener noreferrer nofollow"
81
89
  className={chipClass}
82
90
  {...props}
91
+ ref={ref}
83
92
  >
84
93
  {chip}
85
94
  </a>
86
95
  ) : (
87
- <button type="button" className={chipClass}>
96
+ <button
97
+ type="button"
98
+ {...intentAttributes({ intent, intentKey })}
99
+ className={chipClass}
100
+ ref={ref as Ref<HTMLButtonElement>}
101
+ >
88
102
  {chip}
89
103
  </button>
90
104
  )}
@@ -1,5 +1,7 @@
1
1
  import { useMemo } from "react";
2
2
  import { Check, CircleAlert, Clock, LoaderCircle, Wrench } from "../../icons/index.js";
3
+ import { intentAttributes } from "../../intent/attributes.js";
4
+ import type { IntentProps } from "../../intent/types.js";
3
5
  import type { ClassNames } from "../../utils/class-names.js";
4
6
  import { cn } from "../../utils/cn.js";
5
7
  import { CodeBlock } from "../code-block/code-block.js";
@@ -34,7 +36,7 @@ export type ToolCallPart =
34
36
  | "code"
35
37
  | "error";
36
38
 
37
- export interface ToolCallProps {
39
+ export interface ToolCallProps extends IntentProps {
38
40
  /** Tool identifier, e.g. `buscar_turnos`. */
39
41
  name: string;
40
42
  status?: ToolCallStatus;
@@ -66,6 +68,8 @@ export function ToolCall({
66
68
  defaultOpen = false,
67
69
  className,
68
70
  classNames,
71
+ intent,
72
+ intentKey,
69
73
  }: ToolCallProps) {
70
74
  const info = STATUS[status];
71
75
  const argsText = useMemo(() => (args === undefined ? null : pretty(args)), [args]);
@@ -73,6 +77,7 @@ export function ToolCall({
73
77
 
74
78
  return (
75
79
  <div
80
+ {...intentAttributes({ intent, intentKey })}
76
81
  className={cn(
77
82
  "@container/tool min-w-0 rounded-card bg-surface-card p-2 text-ink border-card shadow-card",
78
83
  classNames?.root,
@@ -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 BigDateSize = "normal" | "compact";
@@ -8,7 +8,7 @@ const sizeClasses: Record<BigDateSize, string> = {
8
8
  compact: "text-fs-200",
9
9
  };
10
10
 
11
- export interface BigDateProps extends ComponentPropsWithoutRef<"div"> {
11
+ export interface BigDateProps extends ComponentPropsWithRef<"div"> {
12
12
  size?: BigDateSize;
13
13
  }
14
14
 
@@ -9,7 +9,11 @@ import {
9
9
  type ReactNode,
10
10
  } from "react";
11
11
  import { useUiStrings } from "../../i18n/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 { cn } from "../../utils/cn.js";
16
+ import { useComposedRefs } from "../../utils/compose.js";
13
17
  import { Slot } from "../../utils/slot.js";
14
18
 
15
19
  export type ButtonVariant = "primary" | "secondary" | "ghost" | "danger";
@@ -66,7 +70,7 @@ export function buttonClasses({
66
70
  );
67
71
  }
68
72
 
69
- export interface ButtonProps extends ComponentPropsWithRef<"button"> {
73
+ export interface ButtonProps extends ComponentPropsWithRef<"button">, IntentProps {
70
74
  variant?: ButtonVariant;
71
75
  /** `sm` is 30px and `md` (default) 38px, the heights every form control shares; `lg` is 52px. */
72
76
  size?: ButtonSize;
@@ -100,9 +104,13 @@ export function Button({
100
104
  className,
101
105
  children,
102
106
  onClick,
107
+ intent,
108
+ intentKey,
109
+ ref,
103
110
  ...props
104
111
  }: ButtonProps) {
105
112
  const strings = useUiStrings();
113
+ const composedRef = useComposedRefs<HTMLElement>(ref, useIntentTarget({ intent, intentKey }));
106
114
  // Natively disabled wins; a busy button stays focusable and swallows its activation instead.
107
115
  const busy = Boolean(loading) && !disabled;
108
116
  const Comp = asChild ? Slot : "button";
@@ -121,7 +129,9 @@ export function Button({
121
129
  aria-disabled={busy || undefined}
122
130
  disabled={disabled}
123
131
  className={buttonClasses({ variant, size, block, className })}
132
+ {...intentAttributes({ intent, intentKey })}
124
133
  {...props}
134
+ ref={composedRef}
125
135
  onClick={busy ? ignoreClick : onClick}
126
136
  >
127
137
  {content}
@@ -2,22 +2,34 @@
2
2
 
3
3
  import { type ComponentProps, type ReactNode, useId, useRef } from "react";
4
4
  import { Check, Minus } from "../../icons/index.js";
5
+ import { intentAttributes } from "../../intent/attributes.js";
6
+ import type { IntentProps } from "../../intent/types.js";
7
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
5
8
  import type { ClassNames } from "../../utils/class-names.js";
6
9
  import { cn } from "../../utils/cn.js";
7
10
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
8
11
  import { BubbleInput, useFormBubble, useFormReset } from "../../utils/form-bubble.js";
9
12
  import { useControllableState } from "../../utils/use-controllable-state.js";
10
13
  import { touchHitArea } from "../internal/hit-area.js";
14
+ import { describedByProps, LabelledControl } from "../internal/labelled-control.js";
11
15
 
12
16
  export type CheckedState = boolean | "indeterminate";
13
17
 
14
- export type CheckboxPart = "root" | "box" | "indicator" | "icon" | "wrapper" | "label";
18
+ export type CheckboxPart =
19
+ | "root"
20
+ | "box"
21
+ | "indicator"
22
+ | "icon"
23
+ | "wrapper"
24
+ | "label"
25
+ | "description";
15
26
 
16
27
  export interface CheckboxProps
17
28
  extends Omit<
18
- ComponentProps<"button">,
19
- "value" | "defaultValue" | "checked" | "defaultChecked" | "children"
20
- > {
29
+ ComponentProps<"button">,
30
+ "value" | "defaultValue" | "checked" | "defaultChecked" | "children"
31
+ >,
32
+ IntentProps {
21
33
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
22
34
  classNames?: ClassNames<CheckboxPart>;
23
35
  checked?: CheckedState;
@@ -33,6 +45,7 @@ export interface CheckboxProps
33
45
  * assistive tech and a click on it toggles. Without it the checkbox is bare and needs `aria-label`.
34
46
  */
35
47
  label?: ReactNode;
48
+ description?: ReactNode;
36
49
  }
37
50
 
38
51
  function getState(checked: CheckedState) {
@@ -51,9 +64,12 @@ export function Checkbox({
51
64
  value = "on",
52
65
  form,
53
66
  label,
67
+ description,
54
68
  id,
55
69
  onClick,
56
70
  onKeyDown,
71
+ intent,
72
+ intentKey,
57
73
  ref,
58
74
  ...props
59
75
  }: CheckboxProps) {
@@ -65,11 +81,16 @@ export function Checkbox({
65
81
  const bubble = useFormBubble(form);
66
82
  const initialRef = useRef(checked);
67
83
  useFormReset(bubble.control, form, () => setChecked(initialRef.current));
68
- const composedRef = useComposedRefs(ref, bubble.setControl);
84
+ const composedRef = useComposedRefs(
85
+ ref,
86
+ bubble.setControl,
87
+ useIntentTarget<HTMLButtonElement>({ intent, intentKey }, { role: "checkbox" }),
88
+ );
69
89
  const state = getState(checked);
70
90
  const disabledAttr = disabled ? "" : undefined;
71
91
  const generatedId = useId();
72
92
  const controlId = label === undefined ? id : (id ?? generatedId);
93
+ const descriptionId = `${generatedId}-description`;
73
94
 
74
95
  const control = (
75
96
  <>
@@ -84,11 +105,13 @@ export function Checkbox({
84
105
  disabled={disabled}
85
106
  value={value}
86
107
  id={controlId}
108
+ {...intentAttributes({ intent, intentKey })}
87
109
  {...props}
110
+ {...describedByProps(props["aria-describedby"], descriptionId, description)}
88
111
  ref={composedRef}
89
112
  className={cn(
90
113
  touchHitArea,
91
- "group inline-flex size-10 shrink-0 items-center justify-center disabled:cursor-not-allowed disabled:opacity-50",
114
+ "group inline-flex size-10 shrink-0 items-center justify-center focus-visible:outline-hidden! disabled:cursor-not-allowed disabled:opacity-50",
92
115
  classNames?.root,
93
116
  className,
94
117
  )}
@@ -103,7 +126,7 @@ export function Checkbox({
103
126
  >
104
127
  <span
105
128
  className={cn(
106
- "grid size-4.5 place-items-center rounded-xs border-[1.5px] border-line-strong group-data-[state=checked]:border-accent group-data-[state=checked]:bg-accent group-data-[state=indeterminate]:border-accent group-data-[state=indeterminate]:bg-accent",
129
+ "grid size-4.5 place-items-center rounded-xs border-[1.5px] border-line-strong group-focus-visible:focus-ring group-data-[state=checked]:border-accent group-data-[state=checked]:bg-accent group-data-[state=indeterminate]:border-accent group-data-[state=indeterminate]:bg-accent",
107
130
  classNames?.box,
108
131
  )}
109
132
  >
@@ -144,20 +167,16 @@ export function Checkbox({
144
167
  </>
145
168
  );
146
169
 
147
- if (label === undefined) return control;
170
+ if (label === undefined && description === undefined) return control;
148
171
  return (
149
- <span className={cn("inline-flex items-center", classNames?.wrapper)}>
150
- {control}
151
- <label
152
- htmlFor={controlId}
153
- data-disabled={disabledAttr}
154
- className={cn(
155
- "cursor-pointer select-none text-control text-ink data-disabled:cursor-not-allowed data-disabled:opacity-50",
156
- classNames?.label,
157
- )}
158
- >
159
- {label}
160
- </label>
161
- </span>
172
+ <LabelledControl
173
+ control={control}
174
+ controlId={controlId}
175
+ label={label}
176
+ description={description}
177
+ descriptionId={descriptionId}
178
+ disabled={disabled}
179
+ classNames={classNames}
180
+ />
162
181
  );
163
182
  }
@@ -3,7 +3,11 @@
3
3
  import type { ComponentPropsWithRef, ReactNode } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { X } from "../../icons/index.js";
6
+ import { intentAttributes } from "../../intent/attributes.js";
7
+ import type { IntentProps } from "../../intent/types.js";
8
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
6
9
  import { cn } from "../../utils/cn.js";
10
+ import { useComposedRefs } from "../../utils/compose.js";
7
11
  import { customToneStyle, isCustomTone } from "../../utils/tone.js";
8
12
  import { type StatusTone, statusIcon } from "../internal/status-icons.js";
9
13
 
@@ -40,7 +44,7 @@ export const chipSizeClasses: Readonly<Record<ChipSize, string>> = {
40
44
  sm: "h-auto min-h-5 px-1.5 py-px font-medium text-fs-120 tabular-nums",
41
45
  };
42
46
 
43
- export interface ChipProps extends ComponentPropsWithRef<"span"> {
47
+ export interface ChipProps extends ComponentPropsWithRef<"span">, IntentProps {
44
48
  tone?: ChipTone;
45
49
  /**
46
50
  * `sm` is the compact tag: it grows with its content, tightens the padding and uses tabular
@@ -78,9 +82,13 @@ export function Chip({
78
82
  className,
79
83
  style,
80
84
  children,
85
+ intent,
86
+ intentKey,
87
+ ref,
81
88
  ...props
82
89
  }: ChipProps) {
83
90
  const strings = useUiStrings();
91
+ const composedRef = useComposedRefs<HTMLSpanElement>(ref, useIntentTarget({ intent, intentKey }));
84
92
  const custom = isCustomTone(tone, builtinTones);
85
93
  const leading =
86
94
  icon ??
@@ -100,7 +108,9 @@ export function Chip({
100
108
  className,
101
109
  )}
102
110
  style={customToneStyle(tone, builtinTones, style)}
111
+ {...intentAttributes({ intent, intentKey })}
103
112
  {...props}
113
+ ref={composedRef}
104
114
  >
105
115
  {leading}
106
116
  {children}
@@ -109,7 +119,7 @@ export function Chip({
109
119
  type="button"
110
120
  aria-label={removeLabel ?? strings.remove}
111
121
  onClick={onRemove}
112
- className="-mr-[calc(0.5rem*var(--touch))] grid size-[calc(1rem+1.75rem*var(--touch))] shrink-0 cursor-pointer place-items-center self-center rounded-full text-current opacity-70 hover:opacity-100 focus-visible:focus-ring"
122
+ className="-ml-[calc(0.25rem-0.25rem*var(--touch))] -mr-[calc(0.25rem+0.25rem*var(--touch))] grid size-[calc(1.5rem+1.25rem*var(--touch))] shrink-0 cursor-pointer place-items-center self-center rounded-full text-current opacity-70 hover:opacity-100 focus-visible:focus-ring"
113
123
  >
114
124
  <X aria-hidden="true" />
115
125
  </button>
@@ -1,10 +1,10 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, ReactNode } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  import { cn } from "../../utils/cn.js";
4
4
 
5
5
  export type DividerPart = "root" | "line" | "label";
6
6
 
7
- export interface DividerProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
7
+ export interface DividerProps extends Omit<ComponentPropsWithRef<"div">, "children"> {
8
8
  /** Text centered on the rule. Without it the divider is a plain hairline. */
9
9
  children?: ReactNode;
10
10
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
@@ -1,16 +1,24 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, useSyncExternalStore } from "react";
3
+ import { type ComponentPropsWithRef, useSyncExternalStore } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import type { ClassNames } from "../../utils/class-names.js";
6
6
  import { cn } from "../../utils/cn.js";
7
7
  import { usePrefersReducedMotion } from "../../utils/reduced-motion.js";
8
- import { type ElapsedTone, formatClock, isoDuration, readElapsed, toneFor } from "./model.js";
8
+ import {
9
+ type ElapsedTone,
10
+ formatClockText,
11
+ formatMinutesText,
12
+ isoDuration,
13
+ readElapsed,
14
+ spokenDuration,
15
+ toneFor,
16
+ } from "./model.js";
9
17
  import { getTickerSnapshot, subscribeTicker } from "./ticker.js";
10
18
 
11
19
  export type ElapsedTimePart = "root" | "text";
12
20
 
13
- export interface ElapsedTimeProps extends Omit<ComponentPropsWithoutRef<"time">, "children"> {
21
+ export interface ElapsedTimeProps extends Omit<ComponentPropsWithRef<"time">, "children"> {
14
22
  /** Moment the timer counts from. */
15
23
  since: Date | string;
16
24
  /** Server clock minus the client clock in ms, so a skewed device still shows the server's elapsed time. */
@@ -66,13 +74,9 @@ export function ElapsedTime({
66
74
  const minutes = Math.floor(reading.seconds / 60);
67
75
  const asClock = format === "mm:ss" && !reducedMotion;
68
76
  const visible = asClock
69
- ? formatClock(reading.seconds)
70
- : fill(strings.minutesShort, "count", String(minutes));
71
- const spoken = fill(
72
- minutes === 1 ? strings.elapsedMinutesOne : strings.elapsedMinutes,
73
- "count",
74
- String(minutes),
75
- );
77
+ ? formatClockText(reading.seconds, strings)
78
+ : formatMinutesText(minutes, strings);
79
+ const spoken = spokenDuration(minutes, strings);
76
80
  const announced = countdown
77
81
  ? fill(reading.over ? strings.countdownOver : strings.countdownLeft, "time", spoken)
78
82
  : spoken;