@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,7 +1,8 @@
1
+ import type { IntentProps } from "../../intent/types.js";
1
2
  import type { ClassNames } from "../../utils/class-names.js";
2
3
  export type ToolCallStatus = "pending" | "running" | "done" | "error";
3
4
  export type ToolCallPart = "root" | "header" | "body" | "name" | "status" | "panel" | "section" | "sectionTitle" | "code" | "error";
4
- export interface ToolCallProps {
5
+ export interface ToolCallProps extends IntentProps {
5
6
  /** Tool identifier, e.g. `buscar_turnos`. */
6
7
  name: string;
7
8
  status?: ToolCallStatus;
@@ -19,4 +20,4 @@ export interface ToolCallProps {
19
20
  classNames?: ClassNames<ToolCallPart>;
20
21
  }
21
22
  /** Collapsible tool invocation with status, JSON arguments and JSON result. */
22
- export declare function ToolCall({ name, status, args, result, error, duration, defaultOpen, className, classNames, }: ToolCallProps): import("react").JSX.Element;
23
+ export declare function ToolCall({ name, status, args, result, error, duration, defaultOpen, className, classNames, intent, intentKey, }: ToolCallProps): import("react").JSX.Element;
@@ -1,6 +1,7 @@
1
1
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
2
2
  import { useMemo } from "react";
3
3
  import { Check, CircleAlert, Clock, LoaderCircle, Wrench } from "../../icons/index.js";
4
+ import { intentAttributes } from "../../intent/attributes.js";
4
5
  import { cn } from "../../utils/cn.js";
5
6
  import { CodeBlock } from "../code-block/code-block.js";
6
7
  import { Disclosure } from "../internal/disclosure.js";
@@ -27,7 +28,9 @@ function ToolCall({
27
28
  duration,
28
29
  defaultOpen = false,
29
30
  className,
30
- classNames
31
+ classNames,
32
+ intent,
33
+ intentKey
31
34
  }) {
32
35
  const info = STATUS[status];
33
36
  const argsText = useMemo(() => args === void 0 ? null : pretty(args), [args]);
@@ -35,6 +38,7 @@ function ToolCall({
35
38
  return /* @__PURE__ */ jsx(
36
39
  "div",
37
40
  {
41
+ ...intentAttributes({ intent, intentKey }),
38
42
  className: cn(
39
43
  "@container/tool min-w-0 rounded-card bg-surface-card p-2 text-ink border-card shadow-card",
40
44
  classNames?.root,
@@ -1,6 +1,6 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
2
  export type BigDateSize = "normal" | "compact";
3
- export interface BigDateProps extends ComponentPropsWithoutRef<"div"> {
3
+ export interface BigDateProps extends ComponentPropsWithRef<"div"> {
4
4
  size?: BigDateSize;
5
5
  }
6
6
  /** Prominent date or number, typically at the top of a card. */
@@ -1,4 +1,5 @@
1
1
  import { type ComponentPropsWithRef } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  export type ButtonVariant = "primary" | "secondary" | "ghost" | "danger";
3
4
  export type ButtonSize = "sm" | "md" | "lg";
4
5
  /**
@@ -23,7 +24,7 @@ export interface ButtonClassOptions {
23
24
  * element (a router link, a menu item) the kit's button look without wrapping it in `<Button>`.
24
25
  */
25
26
  export declare function buttonClasses({ variant, size, block, className, }?: ButtonClassOptions): string;
26
- export interface ButtonProps extends ComponentPropsWithRef<"button"> {
27
+ export interface ButtonProps extends ComponentPropsWithRef<"button">, IntentProps {
27
28
  variant?: ButtonVariant;
28
29
  /** `sm` is 30px and `md` (default) 38px, the heights every form control shares; `lg` is 52px. */
29
30
  size?: ButtonSize;
@@ -45,4 +46,4 @@ export interface ButtonProps extends ComponentPropsWithRef<"button"> {
45
46
  /** Render the child element (via Slot) instead of a `<button>`, e.g. a link. */
46
47
  asChild?: boolean;
47
48
  }
48
- export declare function Button({ variant, size, loading, loadingLabel, block, disabled, asChild, className, children, onClick, ...props }: ButtonProps): import("react").JSX.Element;
49
+ export declare function Button({ variant, size, loading, loadingLabel, block, disabled, asChild, className, children, onClick, intent, intentKey, ref, ...props }: ButtonProps): import("react").JSX.Element;
@@ -6,7 +6,10 @@ import {
6
6
  isValidElement
7
7
  } from "react";
8
8
  import { useUiStrings } from "../../i18n/index.js";
9
+ import { intentAttributes } from "../../intent/attributes.js";
10
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
9
11
  import { cn } from "../../utils/cn.js";
12
+ import { useComposedRefs } from "../../utils/compose.js";
10
13
  import { Slot } from "../../utils/slot.js";
11
14
  const buttonVariantClasses = {
12
15
  primary: "bg-accent text-on-accent font-bold hover:bg-accent-ink hover:text-surface",
@@ -45,9 +48,13 @@ function Button({
45
48
  className,
46
49
  children,
47
50
  onClick,
51
+ intent,
52
+ intentKey,
53
+ ref,
48
54
  ...props
49
55
  }) {
50
56
  const strings = useUiStrings();
57
+ const composedRef = useComposedRefs(ref, useIntentTarget({ intent, intentKey }));
51
58
  const busy = Boolean(loading) && !disabled;
52
59
  const Comp = asChild ? Slot : "button";
53
60
  const showLoadingLabel = loading && loadingLabel !== void 0 && !asChild;
@@ -60,7 +67,9 @@ function Button({
60
67
  "aria-disabled": busy || void 0,
61
68
  disabled,
62
69
  className: buttonClasses({ variant, size, block, className }),
70
+ ...intentAttributes({ intent, intentKey }),
63
71
  ...props,
72
+ ref: composedRef,
64
73
  onClick: busy ? ignoreClick : onClick,
65
74
  children: content
66
75
  }
@@ -1,8 +1,9 @@
1
1
  import { type ComponentProps, type ReactNode } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  import type { ClassNames } from "../../utils/class-names.js";
3
4
  export type CheckedState = boolean | "indeterminate";
4
- export type CheckboxPart = "root" | "box" | "indicator" | "icon" | "wrapper" | "label";
5
- export interface CheckboxProps extends Omit<ComponentProps<"button">, "value" | "defaultValue" | "checked" | "defaultChecked" | "children"> {
5
+ export type CheckboxPart = "root" | "box" | "indicator" | "icon" | "wrapper" | "label" | "description";
6
+ export interface CheckboxProps extends Omit<ComponentProps<"button">, "value" | "defaultValue" | "checked" | "defaultChecked" | "children">, IntentProps {
6
7
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
7
8
  classNames?: ClassNames<CheckboxPart>;
8
9
  checked?: CheckedState;
@@ -18,5 +19,6 @@ export interface CheckboxProps extends Omit<ComponentProps<"button">, "value" |
18
19
  * assistive tech and a click on it toggles. Without it the checkbox is bare and needs `aria-label`.
19
20
  */
20
21
  label?: ReactNode;
22
+ description?: ReactNode;
21
23
  }
22
- export declare function Checkbox({ className, classNames, checked: checkedProp, defaultChecked, onCheckedChange, required, disabled, name, value, form, label, id, onClick, onKeyDown, ref, ...props }: CheckboxProps): import("react").JSX.Element;
24
+ export declare function Checkbox({ className, classNames, checked: checkedProp, defaultChecked, onCheckedChange, required, disabled, name, value, form, label, description, id, onClick, onKeyDown, intent, intentKey, ref, ...props }: CheckboxProps): import("react").JSX.Element;
@@ -2,11 +2,14 @@
2
2
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
3
3
  import { useId, useRef } from "react";
4
4
  import { Check, Minus } from "../../icons/index.js";
5
+ import { intentAttributes } from "../../intent/attributes.js";
6
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
5
7
  import { cn } from "../../utils/cn.js";
6
8
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
7
9
  import { BubbleInput, useFormBubble, useFormReset } from "../../utils/form-bubble.js";
8
10
  import { useControllableState } from "../../utils/use-controllable-state.js";
9
11
  import { touchHitArea } from "../internal/hit-area.js";
12
+ import { describedByProps, LabelledControl } from "../internal/labelled-control.js";
10
13
  function getState(checked) {
11
14
  return checked === "indeterminate" ? "indeterminate" : checked ? "checked" : "unchecked";
12
15
  }
@@ -22,9 +25,12 @@ function Checkbox({
22
25
  value = "on",
23
26
  form,
24
27
  label,
28
+ description,
25
29
  id,
26
30
  onClick,
27
31
  onKeyDown,
32
+ intent,
33
+ intentKey,
28
34
  ref,
29
35
  ...props
30
36
  }) {
@@ -36,11 +42,16 @@ function Checkbox({
36
42
  const bubble = useFormBubble(form);
37
43
  const initialRef = useRef(checked);
38
44
  useFormReset(bubble.control, form, () => setChecked(initialRef.current));
39
- const composedRef = useComposedRefs(ref, bubble.setControl);
45
+ const composedRef = useComposedRefs(
46
+ ref,
47
+ bubble.setControl,
48
+ useIntentTarget({ intent, intentKey }, { role: "checkbox" })
49
+ );
40
50
  const state = getState(checked);
41
51
  const disabledAttr = disabled ? "" : void 0;
42
52
  const generatedId = useId();
43
53
  const controlId = label === void 0 ? id : id ?? generatedId;
54
+ const descriptionId = `${generatedId}-description`;
44
55
  const control = /* @__PURE__ */ jsxs(Fragment, { children: [
45
56
  /* @__PURE__ */ jsx(
46
57
  "button",
@@ -54,11 +65,13 @@ function Checkbox({
54
65
  disabled,
55
66
  value,
56
67
  id: controlId,
68
+ ...intentAttributes({ intent, intentKey }),
57
69
  ...props,
70
+ ...describedByProps(props["aria-describedby"], descriptionId, description),
58
71
  ref: composedRef,
59
72
  className: cn(
60
73
  touchHitArea,
61
- "group inline-flex size-10 shrink-0 items-center justify-center disabled:cursor-not-allowed disabled:opacity-50",
74
+ "group inline-flex size-10 shrink-0 items-center justify-center focus-visible:outline-hidden! disabled:cursor-not-allowed disabled:opacity-50",
62
75
  classNames?.root,
63
76
  className
64
77
  ),
@@ -73,7 +86,7 @@ function Checkbox({
73
86
  "span",
74
87
  {
75
88
  className: cn(
76
- "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",
89
+ "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",
77
90
  classNames?.box
78
91
  ),
79
92
  children: checked === false ? null : /* @__PURE__ */ jsx(
@@ -116,22 +129,19 @@ function Checkbox({
116
129
  }
117
130
  ) : null
118
131
  ] });
119
- if (label === void 0) return control;
120
- return /* @__PURE__ */ jsxs("span", { className: cn("inline-flex items-center", classNames?.wrapper), children: [
121
- control,
122
- /* @__PURE__ */ jsx(
123
- "label",
124
- {
125
- htmlFor: controlId,
126
- "data-disabled": disabledAttr,
127
- className: cn(
128
- "cursor-pointer select-none text-control text-ink data-disabled:cursor-not-allowed data-disabled:opacity-50",
129
- classNames?.label
130
- ),
131
- children: label
132
- }
133
- )
134
- ] });
132
+ if (label === void 0 && description === void 0) return control;
133
+ return /* @__PURE__ */ jsx(
134
+ LabelledControl,
135
+ {
136
+ control,
137
+ controlId,
138
+ label,
139
+ description,
140
+ descriptionId,
141
+ disabled,
142
+ classNames
143
+ }
144
+ );
135
145
  }
136
146
  export {
137
147
  Checkbox
@@ -1,4 +1,5 @@
1
1
  import type { ComponentPropsWithRef, ReactNode } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  export type ChipBuiltinTone = "neutral" | "danger" | "warning" | "success" | "accent" | "info" | "solid" | "outline";
3
4
  /** A built-in tone, or the name of a tone declared in `tonePalettes`. */
4
5
  export type ChipTone = ChipBuiltinTone | (string & {});
@@ -7,7 +8,7 @@ export declare const chipToneClasses: Readonly<Record<ChipBuiltinTone, string>>;
7
8
  export type ChipSize = "sm" | "md";
8
9
  /** Class map behind each `size`; exported like `chipToneClasses`. */
9
10
  export declare const chipSizeClasses: Readonly<Record<ChipSize, string>>;
10
- export interface ChipProps extends ComponentPropsWithRef<"span"> {
11
+ export interface ChipProps extends ComponentPropsWithRef<"span">, IntentProps {
11
12
  tone?: ChipTone;
12
13
  /**
13
14
  * `sm` is the compact tag: it grows with its content, tightens the padding and uses tabular
@@ -30,4 +31,4 @@ export interface ChipProps extends ComponentPropsWithRef<"span"> {
30
31
  /** Accessible name of the remove button. Defaults to the localized "Remove". */
31
32
  removeLabel?: string;
32
33
  }
33
- export declare function Chip({ tone, size, square, icon, statusIcon: withStatusIcon, onRemove, removeLabel, className, style, children, ...props }: ChipProps): import("react").JSX.Element;
34
+ export declare function Chip({ tone, size, square, icon, statusIcon: withStatusIcon, onRemove, removeLabel, className, style, children, intent, intentKey, ref, ...props }: ChipProps): import("react").JSX.Element;
@@ -2,7 +2,10 @@
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
3
  import { useUiStrings } from "../../i18n/index.js";
4
4
  import { X } from "../../icons/index.js";
5
+ import { intentAttributes } from "../../intent/attributes.js";
6
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
5
7
  import { cn } from "../../utils/cn.js";
8
+ import { useComposedRefs } from "../../utils/compose.js";
6
9
  import { customToneStyle, isCustomTone } from "../../utils/tone.js";
7
10
  import { statusIcon } from "../internal/status-icons.js";
8
11
  const chipToneClasses = {
@@ -32,9 +35,13 @@ function Chip({
32
35
  className,
33
36
  style,
34
37
  children,
38
+ intent,
39
+ intentKey,
40
+ ref,
35
41
  ...props
36
42
  }) {
37
43
  const strings = useUiStrings();
44
+ const composedRef = useComposedRefs(ref, useIntentTarget({ intent, intentKey }));
38
45
  const custom = isCustomTone(tone, builtinTones);
39
46
  const leading = icon ?? (withStatusIcon && statusTones.has(tone) ? statusIcon(tone, "size-3") : null);
40
47
  const interactive = props.onClick !== void 0 || props.role === "button";
@@ -51,7 +58,9 @@ function Chip({
51
58
  className
52
59
  ),
53
60
  style: customToneStyle(tone, builtinTones, style),
61
+ ...intentAttributes({ intent, intentKey }),
54
62
  ...props,
63
+ ref: composedRef,
55
64
  children: [
56
65
  leading,
57
66
  children,
@@ -61,7 +70,7 @@ function Chip({
61
70
  type: "button",
62
71
  "aria-label": removeLabel ?? strings.remove,
63
72
  onClick: onRemove,
64
- 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",
73
+ 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",
65
74
  children: /* @__PURE__ */ jsx(X, { "aria-hidden": "true" })
66
75
  }
67
76
  ) : null
@@ -1,7 +1,7 @@
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
  export type DividerPart = "root" | "line" | "label";
4
- export interface DividerProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
4
+ export interface DividerProps extends Omit<ComponentPropsWithRef<"div">, "children"> {
5
5
  /** Text centered on the rule. Without it the divider is a plain hairline. */
6
6
  children?: ReactNode;
7
7
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
@@ -1,7 +1,7 @@
1
- import { type ComponentPropsWithoutRef } from "react";
1
+ import { type ComponentPropsWithRef } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  export type ElapsedTimePart = "root" | "text";
4
- export interface ElapsedTimeProps extends Omit<ComponentPropsWithoutRef<"time">, "children"> {
4
+ export interface ElapsedTimeProps extends Omit<ComponentPropsWithRef<"time">, "children"> {
5
5
  /** Moment the timer counts from. */
6
6
  since: Date | string;
7
7
  /** Server clock minus the client clock in ms, so a skewed device still shows the server's elapsed time. */
@@ -4,7 +4,14 @@ import { useSyncExternalStore } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { cn } from "../../utils/cn.js";
6
6
  import { usePrefersReducedMotion } from "../../utils/reduced-motion.js";
7
- import { formatClock, isoDuration, readElapsed, toneFor } from "./model.js";
7
+ import {
8
+ formatClockText,
9
+ formatMinutesText,
10
+ isoDuration,
11
+ readElapsed,
12
+ spokenDuration,
13
+ toneFor
14
+ } from "./model.js";
8
15
  import { getTickerSnapshot, subscribeTicker } from "./ticker.js";
9
16
  const toneClasses = {
10
17
  neutral: "text-ink-2",
@@ -33,12 +40,8 @@ function ElapsedTime({
33
40
  const tone = toneFor(reading, countdown, warnAt, dangerAt);
34
41
  const minutes = Math.floor(reading.seconds / 60);
35
42
  const asClock = format === "mm:ss" && !reducedMotion;
36
- const visible = asClock ? formatClock(reading.seconds) : fill(strings.minutesShort, "count", String(minutes));
37
- const spoken = fill(
38
- minutes === 1 ? strings.elapsedMinutesOne : strings.elapsedMinutes,
39
- "count",
40
- String(minutes)
41
- );
43
+ const visible = asClock ? formatClockText(reading.seconds, strings) : formatMinutesText(minutes, strings);
44
+ const spoken = spokenDuration(minutes, strings);
42
45
  const announced = countdown ? fill(reading.over ? strings.countdownOver : strings.countdownLeft, "time", spoken) : spoken;
43
46
  return /* @__PURE__ */ jsxs(
44
47
  "time",
@@ -1,3 +1,4 @@
1
+ import type { UiStrings } from "../../i18n/index.js";
1
2
  export type ElapsedTone = "neutral" | "warning" | "danger";
2
3
  export interface ElapsedReading {
3
4
  /** Whole seconds away from the reference: elapsed since it, or remaining until the target. */
@@ -15,3 +16,10 @@ export declare function readElapsed(options: {
15
16
  export declare function toneFor(reading: ElapsedReading, countdown: boolean, warnAt?: number, dangerAt?: number): ElapsedTone;
16
17
  export declare function formatClock(seconds: number): string;
17
18
  export declare function isoDuration(seconds: number): string;
19
+ type DurationStrings = Pick<UiStrings, "minutesShort" | "hoursShort" | "hoursMinutesShort">;
20
+ type SpokenDurationStrings = Pick<UiStrings, "elapsedMinutesOne" | "elapsedMinutes" | "elapsedHoursOne" | "elapsedHours">;
21
+ export declare function formatMinutesText(totalMinutes: number, strings: DurationStrings): string;
22
+ export declare function formatClockText(seconds: number, strings: DurationStrings): string;
23
+ export declare function formatOverrunText(seconds: number, strings: DurationStrings): string;
24
+ export declare function spokenDuration(totalMinutes: number, strings: SpokenDurationStrings): string;
25
+ export {};
@@ -28,10 +28,54 @@ function formatClock(seconds) {
28
28
  function isoDuration(seconds) {
29
29
  return `PT${Math.floor(seconds / 60)}M${seconds % 60}S`;
30
30
  }
31
+ const SECONDS_PER_MINUTE = 60;
32
+ const MINUTES_PER_HOUR = 60;
33
+ const SECONDS_PER_HOUR = SECONDS_PER_MINUTE * MINUTES_PER_HOUR;
34
+ function fillTemplate(template, values) {
35
+ return Object.entries(values).reduce(
36
+ (text, [key, value]) => text.replace(`{${key}}`, String(value)),
37
+ template
38
+ );
39
+ }
40
+ function formatMinutesText(totalMinutes, strings) {
41
+ if (totalMinutes < MINUTES_PER_HOUR) {
42
+ return fillTemplate(strings.minutesShort, { count: totalMinutes });
43
+ }
44
+ const hours = Math.floor(totalMinutes / MINUTES_PER_HOUR);
45
+ const minutes = totalMinutes % MINUTES_PER_HOUR;
46
+ return minutes === 0 ? fillTemplate(strings.hoursShort, { hours }) : fillTemplate(strings.hoursMinutesShort, { hours, minutes });
47
+ }
48
+ function formatClockText(seconds, strings) {
49
+ if (seconds < SECONDS_PER_HOUR) return formatClock(seconds);
50
+ return formatMinutesText(Math.floor(seconds / SECONDS_PER_MINUTE), strings);
51
+ }
52
+ function formatOverrunText(seconds, strings) {
53
+ if (seconds < SECONDS_PER_HOUR) {
54
+ return `${Math.floor(seconds / SECONDS_PER_MINUTE)}:${pad(seconds % SECONDS_PER_MINUTE)}`;
55
+ }
56
+ return formatMinutesText(Math.floor(seconds / SECONDS_PER_MINUTE), strings);
57
+ }
58
+ function spokenMinutes(minutes, strings) {
59
+ const template = minutes === 1 ? strings.elapsedMinutesOne : strings.elapsedMinutes;
60
+ return fillTemplate(template, { count: minutes });
61
+ }
62
+ function spokenDuration(totalMinutes, strings) {
63
+ if (totalMinutes < MINUTES_PER_HOUR) return spokenMinutes(totalMinutes, strings);
64
+ const hours = Math.floor(totalMinutes / MINUTES_PER_HOUR);
65
+ const minutes = totalMinutes % MINUTES_PER_HOUR;
66
+ const spokenHours = fillTemplate(hours === 1 ? strings.elapsedHoursOne : strings.elapsedHours, {
67
+ count: hours
68
+ });
69
+ return minutes === 0 ? spokenHours : `${spokenHours} ${spokenMinutes(minutes, strings)}`;
70
+ }
31
71
  export {
32
72
  formatClock,
73
+ formatClockText,
74
+ formatMinutesText,
75
+ formatOverrunText,
33
76
  isoDuration,
34
77
  readElapsed,
78
+ spokenDuration,
35
79
  toMs,
36
80
  toneFor
37
81
  };
@@ -1,9 +1,10 @@
1
1
  import type { ComponentPropsWithRef } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  import { type ButtonSize, type ButtonVariant } from "../button/button.js";
3
4
  export type IconButtonSize = ButtonSize;
4
5
  /** Width behind each `size`; the height comes from the matching `Button` size, so the button is square. */
5
6
  export declare const iconButtonSizeClasses: Readonly<Record<IconButtonSize, string>>;
6
- export interface IconButtonProps extends Omit<ComponentPropsWithRef<"button">, "aria-label" | "aria-labelledby" | "children"> {
7
+ export interface IconButtonProps extends Omit<ComponentPropsWithRef<"button">, "aria-label" | "aria-labelledby" | "children">, IntentProps {
7
8
  /** Accessible name, announced in place of the icon. Required: an icon alone names nothing. */
8
9
  label: string;
9
10
  variant?: ButtonVariant;
@@ -0,0 +1,16 @@
1
+ import type { ReactElement, ReactNode } from "react";
2
+ import type { ClassNames } from "../../utils/class-names.js";
3
+ export type LabelledControlPart = "wrapper" | "label" | "description";
4
+ export interface LabelledControlProps {
5
+ control: ReactNode;
6
+ controlId: string | undefined;
7
+ label: ReactNode;
8
+ description: ReactNode;
9
+ descriptionId: string;
10
+ disabled: boolean | undefined;
11
+ classNames: ClassNames<LabelledControlPart> | undefined;
12
+ }
13
+ export declare function describedByProps(consumerIds: string | undefined, descriptionId: string, description: ReactNode): {
14
+ "aria-describedby"?: string;
15
+ };
16
+ export declare function LabelledControl({ control, controlId, label, description, descriptionId, disabled, classNames, }: LabelledControlProps): ReactElement;
@@ -0,0 +1,56 @@
1
+ import { jsx, jsxs } from "react/jsx-runtime";
2
+ import { cn } from "../../utils/cn.js";
3
+ const labelClasses = "cursor-pointer select-none text-control text-ink data-disabled:cursor-not-allowed data-disabled:opacity-50";
4
+ function describedBy(consumerIds, descriptionId, description) {
5
+ if (description === void 0) return consumerIds;
6
+ return consumerIds ? `${consumerIds} ${descriptionId}` : descriptionId;
7
+ }
8
+ function describedByProps(consumerIds, descriptionId, description) {
9
+ if (description === void 0) return {};
10
+ return { "aria-describedby": describedBy(consumerIds, descriptionId, description) };
11
+ }
12
+ function LabelledControl({
13
+ control,
14
+ controlId,
15
+ label,
16
+ description,
17
+ descriptionId,
18
+ disabled,
19
+ classNames
20
+ }) {
21
+ const disabledAttr = disabled ? "" : void 0;
22
+ const labelElement = label === void 0 ? null : /* @__PURE__ */ jsx(
23
+ "label",
24
+ {
25
+ htmlFor: controlId,
26
+ "data-disabled": disabledAttr,
27
+ className: cn(labelClasses, classNames?.label),
28
+ children: label
29
+ }
30
+ );
31
+ if (description === void 0) {
32
+ return /* @__PURE__ */ jsxs("span", { className: cn("inline-flex items-center", classNames?.wrapper), children: [
33
+ control,
34
+ labelElement
35
+ ] });
36
+ }
37
+ return /* @__PURE__ */ jsxs("span", { className: cn("inline-flex items-center", classNames?.wrapper), children: [
38
+ control,
39
+ /* @__PURE__ */ jsxs("span", { className: "flex min-w-0 flex-col", children: [
40
+ labelElement,
41
+ /* @__PURE__ */ jsx(
42
+ "span",
43
+ {
44
+ id: descriptionId,
45
+ "data-disabled": disabledAttr,
46
+ className: cn("text-ink-3 text-fs-120 data-disabled:opacity-50", classNames?.description),
47
+ children: description
48
+ }
49
+ )
50
+ ] })
51
+ ] });
52
+ }
53
+ export {
54
+ LabelledControl,
55
+ describedByProps
56
+ };
@@ -1,6 +1,6 @@
1
- import { type ComponentPropsWithoutRef } from "react";
1
+ import { type ComponentPropsWithRef } from "react";
2
2
  import { type NumberFormatConfig } from "./format.js";
3
- export interface NumberValueProps extends Omit<ComponentPropsWithoutRef<"span">, "children"> {
3
+ export interface NumberValueProps extends Omit<ComponentPropsWithRef<"span">, "children"> {
4
4
  value: number;
5
5
  /** Intl options plus `locale`, e.g. `{ style: "currency", currency: "PEN" }`. */
6
6
  format?: NumberFormatConfig;
@@ -1,5 +1,6 @@
1
- import { type ComponentPropsWithoutRef } from "react";
2
- export interface PressableFeedbackProps extends ComponentPropsWithoutRef<"span"> {
1
+ import { type ComponentPropsWithRef } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
3
+ export interface PressableFeedbackProps extends ComponentPropsWithRef<"span">, IntentProps {
3
4
  /** Draws an expanding ripple from the pointer position. */
4
5
  ripple?: boolean;
5
6
  /** Scales the content down while pressed (uses the preset's `--press-scale`). */
@@ -11,4 +12,4 @@ export interface PressableFeedbackProps extends ComponentPropsWithoutRef<"span">
11
12
  * are skipped under `prefers-reduced-motion`. It adds no semantics, so put it around (or let it
12
13
  * contain) the real button or link.
13
14
  */
14
- export declare function PressableFeedback({ ripple, scale, disabled, className, children, onPointerDown, ...props }: PressableFeedbackProps): import("react").JSX.Element;
15
+ export declare function PressableFeedback({ ripple, scale, disabled, className, children, onPointerDown, intent, intentKey, ref, ...props }: PressableFeedbackProps): import("react").JSX.Element;
@@ -1,7 +1,10 @@
1
1
  "use client";
2
2
  import { jsx } from "react/jsx-runtime";
3
3
  import { useRef } from "react";
4
+ import { intentAttributes } from "../../intent/attributes.js";
5
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
4
6
  import { cn } from "../../utils/cn.js";
7
+ import { useComposedRefs } from "../../utils/compose.js";
5
8
  import { usePrefersReducedMotion } from "../../utils/reduced-motion.js";
6
9
  function PressableFeedback({
7
10
  ripple = true,
@@ -10,9 +13,17 @@ function PressableFeedback({
10
13
  className,
11
14
  children,
12
15
  onPointerDown,
16
+ intent,
17
+ intentKey,
18
+ ref,
13
19
  ...props
14
20
  }) {
15
21
  const host = useRef(null);
22
+ const composedRef = useComposedRefs(
23
+ ref,
24
+ host,
25
+ useIntentTarget({ intent, intentKey })
26
+ );
16
27
  const reduced = usePrefersReducedMotion();
17
28
  const spawn = (event) => {
18
29
  onPointerDown?.(event);
@@ -47,7 +58,7 @@ function PressableFeedback({
47
58
  return /* @__PURE__ */ jsx(
48
59
  "span",
49
60
  {
50
- ref: host,
61
+ ref: composedRef,
51
62
  "data-disabled": disabled || void 0,
52
63
  onPointerDown: spawn,
53
64
  className: cn(
@@ -56,6 +67,7 @@ function PressableFeedback({
56
67
  disabled && "pointer-events-none opacity-60",
57
68
  className
58
69
  ),
70
+ ...intentAttributes({ intent, intentKey }),
59
71
  ...props,
60
72
  children
61
73
  }
@@ -1,10 +1,10 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  export type ProgressBuiltinTone = "accent" | "neutral" | "success" | "warning" | "danger" | "info";
4
4
  /** A built-in tone, or the name of a tone declared in `tonePalettes`. */
5
5
  export type ProgressTone = ProgressBuiltinTone | (string & {});
6
6
  export type ProgressPart = "root" | "indicator";
7
- export interface ProgressProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
7
+ export interface ProgressProps extends Omit<ComponentPropsWithRef<"div">, "children"> {
8
8
  value: number;
9
9
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
10
10
  classNames?: ClassNames<ProgressPart>;
@@ -1,4 +1,5 @@
1
1
  import { type ComponentProps, type ReactNode } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  import { type RovingDirection, type RovingOrientation } from "../../utils/roving-focus.js";
3
4
  export interface RadioGroupRootProps extends Omit<ComponentProps<"div">, "defaultValue" | "dir" | "onChange"> {
4
5
  value?: string;
@@ -13,10 +14,10 @@ export interface RadioGroupRootProps extends Omit<ComponentProps<"div">, "defaul
13
14
  loop?: boolean;
14
15
  }
15
16
  export declare function RadioGroupRoot({ value: valueProp, defaultValue, onValueChange, name, form, required, disabled, orientation, dir, loop, ref, ...props }: RadioGroupRootProps): import("react").JSX.Element;
16
- export interface RadioGroupItemProps extends Omit<ComponentProps<"button">, "value" | "defaultValue" | "checked" | "defaultChecked"> {
17
+ export interface RadioGroupItemProps extends Omit<ComponentProps<"button">, "value" | "defaultValue" | "checked" | "defaultChecked">, IntentProps {
17
18
  value: string;
18
19
  }
19
- export declare function RadioGroupItem({ value, disabled, children, onClick, onKeyDown, onFocus, ref, ...props }: RadioGroupItemProps): import("react").JSX.Element;
20
+ export declare function RadioGroupItem({ value, disabled, children, onClick, onKeyDown, onFocus, intent, intentKey, ref, ...props }: RadioGroupItemProps): import("react").JSX.Element;
20
21
  export interface RadioGroupIndicatorProps extends ComponentProps<"span"> {
21
22
  forceMount?: boolean;
22
23
  children?: ReactNode;