@jcsoftdev/ui 0.8.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (476) hide show
  1. package/CHANGELOG.md +151 -0
  2. package/README.md +22 -2
  3. package/dist/ai/attachment/attachment.d.ts +4 -3
  4. package/dist/ai/attachment/attachment.js +5 -1
  5. package/dist/ai/chat-message/chat-message.d.ts +4 -3
  6. package/dist/ai/chat-message/chat-message.js +5 -0
  7. package/dist/ai/code-block/code-block.js +2 -2
  8. package/dist/ai/conversation/conversation.d.ts +2 -2
  9. package/dist/ai/internal/disclosure.js +1 -1
  10. package/dist/ai/internal/icon-action.d.ts +4 -3
  11. package/dist/ai/internal/icon-action.js +11 -2
  12. package/dist/ai/message-actions/message-actions.d.ts +6 -3
  13. package/dist/ai/message-actions/message-actions.js +26 -1
  14. package/dist/ai/prompt-input/prompt-input.d.ts +3 -2
  15. package/dist/ai/prompt-input/prompt-input.js +14 -4
  16. package/dist/ai/prompt-suggestion/prompt-suggestion.d.ts +5 -4
  17. package/dist/ai/prompt-suggestion/prompt-suggestion.js +4 -0
  18. package/dist/ai/source/source.d.ts +4 -3
  19. package/dist/ai/source/source.js +16 -1
  20. package/dist/ai/tool-call/tool-call.d.ts +3 -2
  21. package/dist/ai/tool-call/tool-call.js +5 -1
  22. package/dist/atoms/big-date/big-date.d.ts +2 -2
  23. package/dist/atoms/button/button.d.ts +3 -2
  24. package/dist/atoms/button/button.js +9 -0
  25. package/dist/atoms/checkbox/checkbox.d.ts +5 -3
  26. package/dist/atoms/checkbox/checkbox.js +29 -19
  27. package/dist/atoms/chip/chip.d.ts +3 -2
  28. package/dist/atoms/chip/chip.js +10 -1
  29. package/dist/atoms/divider/divider.d.ts +2 -2
  30. package/dist/atoms/elapsed-time/elapsed-time.d.ts +2 -2
  31. package/dist/atoms/elapsed-time/elapsed-time.js +10 -7
  32. package/dist/atoms/elapsed-time/model.d.ts +8 -0
  33. package/dist/atoms/elapsed-time/model.js +44 -0
  34. package/dist/atoms/icon-button/icon-button.d.ts +2 -1
  35. package/dist/atoms/internal/labelled-control.d.ts +16 -0
  36. package/dist/atoms/internal/labelled-control.js +56 -0
  37. package/dist/atoms/number-value/number-value.d.ts +2 -2
  38. package/dist/atoms/pressable-feedback/pressable-feedback.d.ts +4 -3
  39. package/dist/atoms/pressable-feedback/pressable-feedback.js +13 -1
  40. package/dist/atoms/progress/progress.d.ts +2 -2
  41. package/dist/atoms/radio-group/radio-group-primitive.d.ts +3 -2
  42. package/dist/atoms/radio-group/radio-group-primitive.js +10 -1
  43. package/dist/atoms/radio-group/radio-group.d.ts +2 -0
  44. package/dist/atoms/radio-group/radio-group.js +3 -1
  45. package/dist/atoms/seal/seal.d.ts +2 -2
  46. package/dist/atoms/status-pill/status-pill.js +1 -1
  47. package/dist/atoms/switch/switch.d.ts +7 -4
  48. package/dist/atoms/switch/switch.js +35 -5
  49. package/dist/atoms/table-glyph/table-glyph.d.ts +2 -2
  50. package/dist/atoms/trend-chip/trend-chip.d.ts +2 -2
  51. package/dist/auth/login-form/parts.js +2 -2
  52. package/dist/calendar/date-calendar/date-calendar.js +1 -1
  53. package/dist/calendar/day-chip/day-chip.d.ts +3 -2
  54. package/dist/calendar/day-chip/day-chip.js +12 -1
  55. package/dist/calendar/event-block/event-block.d.ts +3 -2
  56. package/dist/calendar/event-block/event-block.js +7 -0
  57. package/dist/calendar/internal/grid-navigation.d.ts +11 -0
  58. package/dist/calendar/internal/grid-navigation.js +34 -0
  59. package/dist/calendar/internal/intent.d.ts +3 -0
  60. package/dist/calendar/internal/intent.js +7 -0
  61. package/dist/calendar/internal/month-model.d.ts +11 -0
  62. package/dist/calendar/internal/month-model.js +11 -0
  63. package/dist/calendar/internal/types.d.ts +4 -0
  64. package/dist/calendar/month-view/month-grid.d.ts +27 -0
  65. package/dist/calendar/month-view/month-grid.js +210 -0
  66. package/dist/calendar/month-view/month-view.d.ts +3 -1
  67. package/dist/calendar/month-view/month-view.js +29 -131
  68. package/dist/calendar/week-view/week-view.d.ts +3 -1
  69. package/dist/calendar/week-view/week-view.js +218 -128
  70. package/dist/charts/bar-chart/bar-race-chart.js +1 -1
  71. package/dist/charts/core/breadcrumb.js +1 -1
  72. package/dist/charts/core/chart-states.js +1 -1
  73. package/dist/charts/core/distribution/xy-points.js +4 -2
  74. package/dist/charts/crossfilter/crossfilter.js +1 -1
  75. package/dist/charts/gantt-chart/gantt-chart.js +1 -1
  76. package/dist/charts/maps/geo/map-data-table.js +1 -1
  77. package/dist/charts/sankey-chart/sankey-chart.js +1 -3
  78. package/dist/charts/tree-chart/tree-chart.js +1 -1
  79. package/dist/containers/action-bar/action-bar.d.ts +2 -2
  80. package/dist/containers/action-bar/action-bar.js +1 -1
  81. package/dist/containers/aside/aside.d.ts +3 -3
  82. package/dist/containers/banner/banner.d.ts +2 -2
  83. package/dist/containers/card/card.d.ts +5 -5
  84. package/dist/containers/card/card.js +3 -1
  85. package/dist/containers/carousel/carousel.d.ts +2 -2
  86. package/dist/containers/carousel/carousel.js +2 -2
  87. package/dist/containers/cols/cols.d.ts +3 -3
  88. package/dist/containers/comment/comment.d.ts +2 -2
  89. package/dist/containers/confirm-action/confirm-action.d.ts +3 -2
  90. package/dist/containers/confirm-action/confirm-action.js +10 -2
  91. package/dist/containers/dashboard/dashboard.d.ts +4 -4
  92. package/dist/containers/data-grid/column-menu.js +1 -1
  93. package/dist/containers/data-grid/data-grid.d.ts +7 -3
  94. package/dist/containers/data-grid/data-grid.js +45 -7
  95. package/dist/containers/data-grid/formula-bar.js +1 -1
  96. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  97. package/dist/containers/data-grid/tool-panel.js +1 -1
  98. package/dist/containers/description-list/description-list.d.ts +2 -2
  99. package/dist/containers/detail-header/detail-header.d.ts +2 -2
  100. package/dist/containers/facts/facts.d.ts +2 -2
  101. package/dist/containers/feed/feed.d.ts +5 -4
  102. package/dist/containers/feed/feed.js +12 -0
  103. package/dist/containers/file-tree/file-tree.js +11 -0
  104. package/dist/containers/file-tree/model.d.ts +2 -0
  105. package/dist/containers/filter-bar/filter-bar.d.ts +2 -2
  106. package/dist/containers/floor-plan/floor-plan.d.ts +2 -0
  107. package/dist/containers/floor-plan/floor-plan.js +17 -9
  108. package/dist/containers/floor-plan/index.d.ts +1 -1
  109. package/dist/containers/floor-plan/index.js +6 -1
  110. package/dist/containers/floor-plan/model.d.ts +3 -0
  111. package/dist/containers/floor-plan/model.js +8 -0
  112. package/dist/containers/generic-row/generic-row.d.ts +8 -6
  113. package/dist/containers/generic-row/generic-row.js +3 -1
  114. package/dist/containers/grid/grid.d.ts +2 -2
  115. package/dist/containers/hbars/hbars.js +2 -2
  116. package/dist/containers/highlight-line/highlight-line.d.ts +2 -2
  117. package/dist/containers/index.d.ts +1 -0
  118. package/dist/containers/index.js +1 -0
  119. package/dist/containers/item-card-group/item-card-group.d.ts +4 -2
  120. package/dist/containers/item-card-group/item-card-group.js +4 -0
  121. package/dist/containers/kanban/kanban.js +13 -0
  122. package/dist/containers/kanban/model.d.ts +2 -0
  123. package/dist/containers/kpi/kpi-model.d.ts +7 -0
  124. package/dist/containers/kpi/kpi-model.js +22 -0
  125. package/dist/containers/kpi/kpi-parts.d.ts +28 -0
  126. package/dist/containers/kpi/kpi-parts.js +121 -0
  127. package/dist/containers/kpi/kpi.d.ts +7 -30
  128. package/dist/containers/kpi/kpi.js +4 -119
  129. package/dist/containers/kpi-group/kpi-group.d.ts +2 -2
  130. package/dist/containers/list-detail/list-detail.d.ts +12 -11
  131. package/dist/containers/list-detail/list-detail.js +9 -1
  132. package/dist/containers/note/note.d.ts +2 -2
  133. package/dist/containers/order-ticket/index.d.ts +2 -0
  134. package/dist/containers/order-ticket/index.js +18 -0
  135. package/dist/containers/order-ticket/model.d.ts +24 -0
  136. package/dist/containers/order-ticket/model.js +45 -0
  137. package/dist/containers/order-ticket/order-ticket.d.ts +35 -0
  138. package/dist/containers/order-ticket/order-ticket.js +406 -0
  139. package/dist/containers/page/page.d.ts +2 -2
  140. package/dist/containers/page-header/back.d.ts +2 -2
  141. package/dist/containers/page-header/page-header.d.ts +6 -6
  142. package/dist/containers/pagination/cursor-pagination.d.ts +2 -2
  143. package/dist/containers/pagination/pagination.d.ts +2 -2
  144. package/dist/containers/pagination/pagination.js +2 -2
  145. package/dist/containers/resizable/resizable.d.ts +4 -4
  146. package/dist/containers/resizable/resizable.js +1 -1
  147. package/dist/containers/row-actions/row-actions.d.ts +4 -3
  148. package/dist/containers/row-actions/row-actions.js +14 -1
  149. package/dist/containers/scrolly/scrolly.js +1 -1
  150. package/dist/containers/section/section.d.ts +10 -9
  151. package/dist/containers/section/section.js +12 -0
  152. package/dist/containers/selectable-card/selectable-card.d.ts +3 -2
  153. package/dist/containers/selectable-card/selectable-card.js +10 -1
  154. package/dist/containers/settings-layout/settings-layout.d.ts +7 -6
  155. package/dist/containers/settings-layout/settings-layout.js +10 -1
  156. package/dist/containers/settings-row/settings-row.d.ts +4 -3
  157. package/dist/containers/settings-row/settings-row.js +4 -0
  158. package/dist/containers/shortcuts/shortcuts.d.ts +3 -3
  159. package/dist/containers/stack/stack.d.ts +2 -2
  160. package/dist/containers/table/table.d.ts +14 -13
  161. package/dist/containers/table/table.js +22 -4
  162. package/dist/containers/timeline/timeline.d.ts +5 -4
  163. package/dist/containers/timeline/timeline.js +12 -0
  164. package/dist/containers/toolbar/toolbar.d.ts +3 -3
  165. package/dist/forms/accent-picker/accent-picker.d.ts +5 -2
  166. package/dist/forms/accent-picker/accent-picker.js +22 -1
  167. package/dist/forms/checkbox-button-group/checkbox-button-group.d.ts +3 -2
  168. package/dist/forms/checkbox-button-group/checkbox-button-group.js +16 -0
  169. package/dist/forms/chip-group/chip-group.d.ts +4 -1
  170. package/dist/forms/chip-group/chip-group.js +20 -2
  171. package/dist/forms/combobox/combobox.d.ts +3 -2
  172. package/dist/forms/combobox/combobox.js +10 -1
  173. package/dist/forms/copy-field/copy-field.d.ts +4 -3
  174. package/dist/forms/copy-field/copy-field.js +7 -0
  175. package/dist/forms/date-picker/date-picker.d.ts +3 -2
  176. package/dist/forms/date-picker/date-picker.js +10 -1
  177. package/dist/forms/date-picker/date-time-picker.d.ts +3 -2
  178. package/dist/forms/date-picker/date-time-picker.js +4 -0
  179. package/dist/forms/dropzone/dropzone.d.ts +3 -2
  180. package/dist/forms/dropzone/dropzone.js +21 -3
  181. package/dist/forms/emoji-picker/emoji-picker.d.ts +3 -2
  182. package/dist/forms/emoji-picker/emoji-picker.js +9 -2
  183. package/dist/forms/emoji-reaction-button/emoji-reaction-button.d.ts +3 -2
  184. package/dist/forms/emoji-reaction-button/emoji-reaction-button.js +8 -1
  185. package/dist/forms/field/field.d.ts +2 -2
  186. package/dist/forms/fieldset/fieldset.d.ts +2 -2
  187. package/dist/forms/form/form.d.ts +6 -4
  188. package/dist/forms/form/form.js +10 -2
  189. package/dist/forms/form-footer/form-footer.d.ts +2 -2
  190. package/dist/forms/form-grid/form-grid.d.ts +3 -3
  191. package/dist/forms/form-section/form-section.d.ts +2 -2
  192. package/dist/forms/inline-select/inline-select.d.ts +4 -3
  193. package/dist/forms/inline-select/inline-select.js +9 -1
  194. package/dist/forms/input/input.d.ts +3 -2
  195. package/dist/forms/input/input.js +6 -1
  196. package/dist/forms/internal/button-option.d.ts +2 -0
  197. package/dist/forms/label/label.d.ts +2 -2
  198. package/dist/forms/native-select/native-select.d.ts +4 -3
  199. package/dist/forms/native-select/native-select.js +4 -0
  200. package/dist/forms/number-stepper/number-stepper.d.ts +2 -1
  201. package/dist/forms/number-stepper/number-stepper.js +13 -3
  202. package/dist/forms/password-input/password-input.d.ts +1 -1
  203. package/dist/forms/password-input/password-input.js +12 -0
  204. package/dist/forms/pin-input/pin-input.d.ts +3 -2
  205. package/dist/forms/pin-input/pin-input.js +8 -1
  206. package/dist/forms/radio-button-group/radio-button-group.d.ts +3 -2
  207. package/dist/forms/radio-button-group/radio-button-group.js +16 -0
  208. package/dist/forms/rating/rating.d.ts +3 -2
  209. package/dist/forms/rating/rating.js +12 -0
  210. package/dist/forms/select/select.d.ts +4 -3
  211. package/dist/forms/select/select.js +11 -2
  212. package/dist/forms/select-menu/select-menu.d.ts +3 -2
  213. package/dist/forms/select-menu/select-menu.js +10 -1
  214. package/dist/forms/slider/model.d.ts +1 -0
  215. package/dist/forms/slider/model.js +5 -0
  216. package/dist/forms/slider/slider.d.ts +2 -1
  217. package/dist/forms/slider/slider.js +12 -3
  218. package/dist/forms/textarea/textarea.d.ts +4 -3
  219. package/dist/forms/textarea/textarea.js +4 -2
  220. package/dist/forms/time-input/time-input.d.ts +4 -3
  221. package/dist/forms/time-input/time-input.js +13 -1
  222. package/dist/glass/crystal-map.d.ts +3 -1
  223. package/dist/glass/crystal-map.js +13 -2
  224. package/dist/i18n/strings.d.ts +78 -0
  225. package/dist/i18n/strings.js +52 -0
  226. package/dist/icons/alarm-clock.d.ts +2 -0
  227. package/dist/icons/alarm-clock.js +15 -0
  228. package/dist/icons/hourglass.d.ts +2 -0
  229. package/dist/icons/hourglass.js +13 -0
  230. package/dist/icons/index.d.ts +2 -0
  231. package/dist/icons/index.js +4 -0
  232. package/dist/intent/attributes.d.ts +11 -0
  233. package/dist/intent/attributes.js +77 -0
  234. package/dist/intent/bridge.d.ts +8 -0
  235. package/dist/intent/bridge.js +19 -0
  236. package/dist/intent/index.d.ts +4 -0
  237. package/dist/intent/index.js +31 -0
  238. package/dist/intent/target-registrations.d.ts +16 -0
  239. package/dist/intent/target-registrations.js +91 -0
  240. package/dist/intent/types.d.ts +29 -0
  241. package/dist/intent/types.js +0 -0
  242. package/dist/intent/use-intent-target.d.ts +4 -0
  243. package/dist/intent/use-intent-target.js +75 -0
  244. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +6 -4
  245. package/dist/navigation/breadcrumbs/breadcrumbs.js +11 -1
  246. package/dist/navigation/floating-toc/floating-toc.d.ts +2 -2
  247. package/dist/navigation/floating-toc/floating-toc.js +5 -0
  248. package/dist/navigation/floating-toc/model.d.ts +2 -1
  249. package/dist/navigation/segmented/segmented.d.ts +3 -2
  250. package/dist/navigation/segmented/segmented.js +11 -1
  251. package/dist/navigation/stepper/stepper.d.ts +4 -2
  252. package/dist/navigation/stepper/stepper.js +3 -0
  253. package/dist/navigation/tabs/tabs-nav.d.ts +5 -4
  254. package/dist/navigation/tabs/tabs-nav.js +11 -0
  255. package/dist/navigation/tabs/tabs.d.ts +5 -4
  256. package/dist/navigation/tabs/tabs.js +20 -1
  257. package/dist/navigation/wizard/wizard.d.ts +4 -3
  258. package/dist/navigation/wizard/wizard.js +9 -1
  259. package/dist/overlays/alert-dialog/alert-dialog.d.ts +5 -4
  260. package/dist/overlays/alert-dialog/alert-dialog.js +20 -3
  261. package/dist/overlays/context-menu/context-menu.d.ts +14 -12
  262. package/dist/overlays/context-menu/context-menu.js +57 -8
  263. package/dist/overlays/dialog/dialog.d.ts +9 -8
  264. package/dist/overlays/dialog/dialog.js +11 -0
  265. package/dist/overlays/drawer/drawer.d.ts +6 -5
  266. package/dist/overlays/drawer/drawer.js +11 -0
  267. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +14 -13
  268. package/dist/overlays/dropdown-menu/dropdown-menu.js +58 -5
  269. package/dist/overlays/hover-card/hover-card.d.ts +4 -3
  270. package/dist/overlays/hover-card/hover-card.js +12 -1
  271. package/dist/overlays/popover/popover.d.ts +3 -2
  272. package/dist/overlays/popover/popover.js +12 -1
  273. package/dist/overlays/tooltip/model.d.ts +1 -0
  274. package/dist/overlays/tooltip/model.js +8 -0
  275. package/dist/overlays/tooltip/tooltip.d.ts +2 -1
  276. package/dist/overlays/tooltip/tooltip.js +8 -2
  277. package/dist/palette/command-palette/command-palette.d.ts +8 -4
  278. package/dist/palette/command-palette/command-palette.js +49 -1
  279. package/dist/palette/command-palette/index.d.ts +1 -0
  280. package/dist/palette/command-palette/index.js +3 -1
  281. package/dist/palette/command-palette/model.d.ts +7 -0
  282. package/dist/palette/command-palette/model.js +11 -0
  283. package/dist/primitives/command/command.js +4 -1
  284. package/dist/primitives/dialog/dialog.js +1 -3
  285. package/dist/primitives/popper/popper.js +15 -4
  286. package/dist/shell/bottom-nav/bottom-nav.js +54 -42
  287. package/dist/shell/sidebar/sidebar.d.ts +5 -3
  288. package/dist/shell/sidebar/sidebar.js +14 -2
  289. package/dist/showcase/bento.js +1 -0
  290. package/dist/utils/is-production.d.ts +1 -0
  291. package/dist/utils/is-production.js +6 -0
  292. package/dist/utils/slot.js +17 -3
  293. package/icons/svg/alarm-clock.svg +8 -0
  294. package/icons/svg/hourglass.svg +6 -0
  295. package/package.json +2 -2
  296. package/src/ai/attachment/attachment.tsx +10 -3
  297. package/src/ai/chat-message/chat-message.tsx +10 -2
  298. package/src/ai/code-block/code-block.tsx +2 -2
  299. package/src/ai/conversation/conversation.tsx +2 -2
  300. package/src/ai/internal/disclosure.tsx +1 -1
  301. package/src/ai/internal/icon-action.tsx +14 -4
  302. package/src/ai/message-actions/message-actions.tsx +28 -3
  303. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  304. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  305. package/src/ai/source/source.tsx +17 -3
  306. package/src/ai/tool-call/tool-call.tsx +6 -1
  307. package/src/atoms/big-date/big-date.tsx +2 -2
  308. package/src/atoms/button/button.tsx +11 -1
  309. package/src/atoms/checkbox/checkbox.tsx +40 -21
  310. package/src/atoms/chip/chip.tsx +12 -2
  311. package/src/atoms/divider/divider.tsx +2 -2
  312. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  313. package/src/atoms/elapsed-time/model.ts +57 -0
  314. package/src/atoms/icon-button/icon-button.tsx +3 -1
  315. package/src/atoms/internal/labelled-control.tsx +83 -0
  316. package/src/atoms/number-value/number-value.tsx +2 -2
  317. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  318. package/src/atoms/progress/progress.tsx +2 -2
  319. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  320. package/src/atoms/radio-group/radio-group.tsx +5 -1
  321. package/src/atoms/seal/seal.tsx +2 -2
  322. package/src/atoms/status-pill/status-pill.tsx +1 -1
  323. package/src/atoms/switch/switch.tsx +43 -9
  324. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  325. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  326. package/src/auth/login-form/parts.tsx +2 -2
  327. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  328. package/src/calendar/day-chip/day-chip.tsx +14 -2
  329. package/src/calendar/event-block/event-block.tsx +9 -1
  330. package/src/calendar/internal/grid-navigation.ts +47 -0
  331. package/src/calendar/internal/intent.ts +10 -0
  332. package/src/calendar/internal/month-model.ts +23 -0
  333. package/src/calendar/internal/types.ts +4 -0
  334. package/src/calendar/month-view/month-grid.tsx +248 -0
  335. package/src/calendar/month-view/month-view.tsx +32 -148
  336. package/src/calendar/week-view/week-view.tsx +87 -10
  337. package/src/charts/README.md +10 -0
  338. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  339. package/src/charts/core/breadcrumb.tsx +1 -1
  340. package/src/charts/core/chart-states.tsx +1 -1
  341. package/src/charts/core/distribution/xy-points.tsx +4 -2
  342. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  343. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  344. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  345. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  346. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  347. package/src/containers/action-bar/action-bar.tsx +3 -3
  348. package/src/containers/aside/aside.tsx +3 -3
  349. package/src/containers/banner/banner.tsx +2 -2
  350. package/src/containers/card/card.tsx +7 -5
  351. package/src/containers/carousel/carousel.tsx +4 -4
  352. package/src/containers/cols/cols.tsx +3 -3
  353. package/src/containers/comment/comment.tsx +2 -2
  354. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  355. package/src/containers/dashboard/dashboard.tsx +4 -4
  356. package/src/containers/data-grid/column-menu.tsx +1 -1
  357. package/src/containers/data-grid/data-grid.tsx +53 -4
  358. package/src/containers/data-grid/formula-bar.tsx +1 -1
  359. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  360. package/src/containers/data-grid/tool-panel.tsx +1 -1
  361. package/src/containers/description-list/description-list.tsx +2 -2
  362. package/src/containers/detail-header/detail-header.tsx +2 -2
  363. package/src/containers/facts/facts.tsx +2 -2
  364. package/src/containers/feed/feed.tsx +16 -3
  365. package/src/containers/file-tree/file-tree.tsx +11 -0
  366. package/src/containers/file-tree/model.ts +2 -0
  367. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  368. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  369. package/src/containers/floor-plan/index.ts +7 -1
  370. package/src/containers/floor-plan/model.ts +16 -0
  371. package/src/containers/generic-row/generic-row.tsx +9 -6
  372. package/src/containers/grid/grid.tsx +2 -2
  373. package/src/containers/hbars/hbars.tsx +23 -21
  374. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  375. package/src/containers/index.ts +1 -0
  376. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  377. package/src/containers/kanban/kanban.tsx +13 -0
  378. package/src/containers/kanban/model.ts +2 -0
  379. package/src/containers/kpi/kpi-model.ts +37 -0
  380. package/src/containers/kpi/kpi-parts.tsx +153 -0
  381. package/src/containers/kpi/kpi.tsx +10 -176
  382. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  383. package/src/containers/list-detail/list-detail.tsx +22 -12
  384. package/src/containers/note/note.tsx +2 -2
  385. package/src/containers/order-ticket/index.ts +17 -0
  386. package/src/containers/order-ticket/model.ts +76 -0
  387. package/src/containers/order-ticket/order-ticket.tsx +480 -0
  388. package/src/containers/page/page.tsx +2 -2
  389. package/src/containers/page-header/back.tsx +2 -2
  390. package/src/containers/page-header/page-header.tsx +6 -6
  391. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  392. package/src/containers/pagination/pagination.tsx +4 -4
  393. package/src/containers/resizable/resizable.tsx +7 -5
  394. package/src/containers/row-actions/row-actions.tsx +18 -3
  395. package/src/containers/scrolly/scrolly.tsx +1 -1
  396. package/src/containers/section/section.tsx +21 -8
  397. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  398. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  399. package/src/containers/settings-row/settings-row.tsx +7 -2
  400. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  401. package/src/containers/stack/stack.tsx +2 -2
  402. package/src/containers/table/table.tsx +35 -14
  403. package/src/containers/timeline/timeline.tsx +17 -3
  404. package/src/containers/toolbar/toolbar.tsx +3 -3
  405. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  406. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  407. package/src/forms/chip-group/chip-group.tsx +23 -2
  408. package/src/forms/combobox/combobox.tsx +15 -4
  409. package/src/forms/copy-field/copy-field.tsx +11 -2
  410. package/src/forms/date-picker/date-picker.tsx +23 -12
  411. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  412. package/src/forms/dropzone/dropzone.tsx +18 -3
  413. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  414. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  415. package/src/forms/field/field.tsx +2 -2
  416. package/src/forms/fieldset/fieldset.tsx +2 -2
  417. package/src/forms/form/form.tsx +13 -5
  418. package/src/forms/form-footer/form-footer.tsx +2 -2
  419. package/src/forms/form-grid/form-grid.tsx +3 -3
  420. package/src/forms/form-section/form-section.tsx +2 -2
  421. package/src/forms/inline-select/inline-select.tsx +14 -3
  422. package/src/forms/input/input.tsx +8 -2
  423. package/src/forms/internal/button-option.tsx +2 -0
  424. package/src/forms/label/label.tsx +2 -2
  425. package/src/forms/native-select/native-select.tsx +9 -2
  426. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  427. package/src/forms/password-input/password-input.tsx +12 -0
  428. package/src/forms/pin-input/pin-input.tsx +9 -1
  429. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  430. package/src/forms/rating/rating.tsx +14 -1
  431. package/src/forms/select/select.tsx +14 -4
  432. package/src/forms/select-menu/select-menu.tsx +15 -4
  433. package/src/forms/slider/model.ts +5 -0
  434. package/src/forms/slider/slider.tsx +13 -3
  435. package/src/forms/textarea/textarea.tsx +7 -4
  436. package/src/forms/time-input/time-input.tsx +19 -5
  437. package/src/glass/crystal-map.ts +21 -3
  438. package/src/i18n/strings.ts +78 -0
  439. package/src/icons/alarm-clock.tsx +16 -0
  440. package/src/icons/hourglass.tsx +14 -0
  441. package/src/icons/index.ts +2 -0
  442. package/src/intent/attributes.ts +96 -0
  443. package/src/intent/bridge.tsx +25 -0
  444. package/src/intent/index.ts +24 -0
  445. package/src/intent/target-registrations.ts +127 -0
  446. package/src/intent/types.ts +44 -0
  447. package/src/intent/use-intent-target.ts +96 -0
  448. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  449. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  450. package/src/navigation/floating-toc/model.ts +3 -1
  451. package/src/navigation/segmented/segmented.tsx +14 -2
  452. package/src/navigation/stepper/stepper.tsx +7 -2
  453. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  454. package/src/navigation/tabs/tabs.tsx +24 -3
  455. package/src/navigation/wizard/wizard.tsx +12 -4
  456. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  457. package/src/overlays/context-menu/context-menu.tsx +58 -11
  458. package/src/overlays/dialog/dialog.tsx +18 -7
  459. package/src/overlays/drawer/drawer.tsx +15 -4
  460. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  461. package/src/overlays/hover-card/hover-card.tsx +13 -2
  462. package/src/overlays/popover/popover.tsx +12 -1
  463. package/src/overlays/tooltip/model.ts +8 -0
  464. package/src/overlays/tooltip/tooltip.tsx +15 -2
  465. package/src/palette/command-palette/command-palette.tsx +66 -3
  466. package/src/palette/command-palette/index.ts +1 -0
  467. package/src/palette/command-palette/model.ts +15 -0
  468. package/src/primitives/command/command.tsx +4 -1
  469. package/src/primitives/dialog/dialog.tsx +1 -4
  470. package/src/primitives/popper/popper.tsx +16 -5
  471. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  472. package/src/shell/sidebar/sidebar.tsx +22 -4
  473. package/src/showcase/bento.tsx +2 -0
  474. package/src/utils/is-production.ts +3 -0
  475. package/src/utils/slot.tsx +21 -3
  476. package/styles/base.css +34 -0
@@ -1,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;
@@ -1,3 +1,5 @@
1
+ import type { UiStrings } from "../../i18n/index.js";
2
+
1
3
  export type ElapsedTone = "neutral" | "warning" | "danger";
2
4
 
3
5
  export interface ElapsedReading {
@@ -52,3 +54,58 @@ export function formatClock(seconds: number): string {
52
54
  export function isoDuration(seconds: number): string {
53
55
  return `PT${Math.floor(seconds / 60)}M${seconds % 60}S`;
54
56
  }
57
+
58
+ const SECONDS_PER_MINUTE = 60;
59
+ const MINUTES_PER_HOUR = 60;
60
+ const SECONDS_PER_HOUR = SECONDS_PER_MINUTE * MINUTES_PER_HOUR;
61
+
62
+ type DurationStrings = Pick<UiStrings, "minutesShort" | "hoursShort" | "hoursMinutesShort">;
63
+ type SpokenDurationStrings = Pick<
64
+ UiStrings,
65
+ "elapsedMinutesOne" | "elapsedMinutes" | "elapsedHoursOne" | "elapsedHours"
66
+ >;
67
+
68
+ function fillTemplate(template: string, values: Record<string, number>): string {
69
+ return Object.entries(values).reduce(
70
+ (text, [key, value]) => text.replace(`{${key}}`, String(value)),
71
+ template,
72
+ );
73
+ }
74
+
75
+ export function formatMinutesText(totalMinutes: number, strings: DurationStrings): string {
76
+ if (totalMinutes < MINUTES_PER_HOUR) {
77
+ return fillTemplate(strings.minutesShort, { count: totalMinutes });
78
+ }
79
+ const hours = Math.floor(totalMinutes / MINUTES_PER_HOUR);
80
+ const minutes = totalMinutes % MINUTES_PER_HOUR;
81
+ return minutes === 0
82
+ ? fillTemplate(strings.hoursShort, { hours })
83
+ : fillTemplate(strings.hoursMinutesShort, { hours, minutes });
84
+ }
85
+
86
+ export function formatClockText(seconds: number, strings: DurationStrings): string {
87
+ if (seconds < SECONDS_PER_HOUR) return formatClock(seconds);
88
+ return formatMinutesText(Math.floor(seconds / SECONDS_PER_MINUTE), strings);
89
+ }
90
+
91
+ export function formatOverrunText(seconds: number, strings: DurationStrings): string {
92
+ if (seconds < SECONDS_PER_HOUR) {
93
+ return `${Math.floor(seconds / SECONDS_PER_MINUTE)}:${pad(seconds % SECONDS_PER_MINUTE)}`;
94
+ }
95
+ return formatMinutesText(Math.floor(seconds / SECONDS_PER_MINUTE), strings);
96
+ }
97
+
98
+ function spokenMinutes(minutes: number, strings: SpokenDurationStrings): string {
99
+ const template = minutes === 1 ? strings.elapsedMinutesOne : strings.elapsedMinutes;
100
+ return fillTemplate(template, { count: minutes });
101
+ }
102
+
103
+ export function spokenDuration(totalMinutes: number, strings: SpokenDurationStrings): string {
104
+ if (totalMinutes < MINUTES_PER_HOUR) return spokenMinutes(totalMinutes, strings);
105
+ const hours = Math.floor(totalMinutes / MINUTES_PER_HOUR);
106
+ const minutes = totalMinutes % MINUTES_PER_HOUR;
107
+ const spokenHours = fillTemplate(hours === 1 ? strings.elapsedHoursOne : strings.elapsedHours, {
108
+ count: hours,
109
+ });
110
+ return minutes === 0 ? spokenHours : `${spokenHours} ${spokenMinutes(minutes, strings)}`;
111
+ }
@@ -1,6 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import type { ComponentPropsWithRef } from "react";
4
+ import type { IntentProps } from "../../intent/types.js";
4
5
  import { cn } from "../../utils/cn.js";
5
6
  import { Button, type ButtonSize, type ButtonVariant } from "../button/button.js";
6
7
  import { Spinner } from "../spinner/spinner.js";
@@ -15,7 +16,8 @@ export const iconButtonSizeClasses: Readonly<Record<IconButtonSize, string>> = {
15
16
  };
16
17
 
17
18
  export interface IconButtonProps
18
- extends Omit<ComponentPropsWithRef<"button">, "aria-label" | "aria-labelledby" | "children"> {
19
+ extends Omit<ComponentPropsWithRef<"button">, "aria-label" | "aria-labelledby" | "children">,
20
+ IntentProps {
19
21
  /** Accessible name, announced in place of the icon. Required: an icon alone names nothing. */
20
22
  label: string;
21
23
  variant?: ButtonVariant;
@@ -0,0 +1,83 @@
1
+ import type { ReactElement, ReactNode } from "react";
2
+ import type { ClassNames } from "../../utils/class-names.js";
3
+ import { cn } from "../../utils/cn.js";
4
+
5
+ export type LabelledControlPart = "wrapper" | "label" | "description";
6
+
7
+ export interface LabelledControlProps {
8
+ control: ReactNode;
9
+ controlId: string | undefined;
10
+ label: ReactNode;
11
+ description: ReactNode;
12
+ descriptionId: string;
13
+ disabled: boolean | undefined;
14
+ classNames: ClassNames<LabelledControlPart> | undefined;
15
+ }
16
+
17
+ const labelClasses =
18
+ "cursor-pointer select-none text-control text-ink data-disabled:cursor-not-allowed data-disabled:opacity-50";
19
+
20
+ function describedBy(
21
+ consumerIds: string | undefined,
22
+ descriptionId: string,
23
+ description: ReactNode,
24
+ ): string | undefined {
25
+ if (description === undefined) return consumerIds;
26
+ return consumerIds ? `${consumerIds} ${descriptionId}` : descriptionId;
27
+ }
28
+
29
+ export function describedByProps(
30
+ consumerIds: string | undefined,
31
+ descriptionId: string,
32
+ description: ReactNode,
33
+ ): { "aria-describedby"?: string } {
34
+ if (description === undefined) return {};
35
+ return { "aria-describedby": describedBy(consumerIds, descriptionId, description) };
36
+ }
37
+
38
+ export function LabelledControl({
39
+ control,
40
+ controlId,
41
+ label,
42
+ description,
43
+ descriptionId,
44
+ disabled,
45
+ classNames,
46
+ }: LabelledControlProps): ReactElement {
47
+ const disabledAttr = disabled ? "" : undefined;
48
+ const labelElement =
49
+ label === undefined ? null : (
50
+ <label
51
+ htmlFor={controlId}
52
+ data-disabled={disabledAttr}
53
+ className={cn(labelClasses, classNames?.label)}
54
+ >
55
+ {label}
56
+ </label>
57
+ );
58
+
59
+ if (description === undefined) {
60
+ return (
61
+ <span className={cn("inline-flex items-center", classNames?.wrapper)}>
62
+ {control}
63
+ {labelElement}
64
+ </span>
65
+ );
66
+ }
67
+
68
+ return (
69
+ <span className={cn("inline-flex items-center", classNames?.wrapper)}>
70
+ {control}
71
+ <span className="flex min-w-0 flex-col">
72
+ {labelElement}
73
+ <span
74
+ id={descriptionId}
75
+ data-disabled={disabledAttr}
76
+ className={cn("text-ink-3 text-fs-120 data-disabled:opacity-50", classNames?.description)}
77
+ >
78
+ {description}
79
+ </span>
80
+ </span>
81
+ </span>
82
+ );
83
+ }
@@ -1,11 +1,11 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, useEffect, useRef, useState } from "react";
3
+ import { type ComponentPropsWithRef, useEffect, useRef, useState } from "react";
4
4
  import { cn } from "../../utils/cn.js";
5
5
  import { usePrefersReducedMotion } from "../../utils/reduced-motion.js";
6
6
  import { formatNumber, type NumberFormatConfig, tweenValue } from "./format.js";
7
7
 
8
- export interface NumberValueProps extends Omit<ComponentPropsWithoutRef<"span">, "children"> {
8
+ export interface NumberValueProps extends Omit<ComponentPropsWithRef<"span">, "children"> {
9
9
  value: number;
10
10
  /** Intl options plus `locale`, e.g. `{ style: "currency", currency: "PEN" }`. */
11
11
  format?: NumberFormatConfig;
@@ -1,10 +1,14 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, type PointerEvent, useRef } from "react";
3
+ import { type ComponentPropsWithRef, type PointerEvent, useRef } from "react";
4
+ import { intentAttributes } from "../../intent/attributes.js";
5
+ import type { IntentProps } from "../../intent/types.js";
6
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
4
7
  import { cn } from "../../utils/cn.js";
8
+ import { useComposedRefs } from "../../utils/compose.js";
5
9
  import { usePrefersReducedMotion } from "../../utils/reduced-motion.js";
6
10
 
7
- export interface PressableFeedbackProps extends ComponentPropsWithoutRef<"span"> {
11
+ export interface PressableFeedbackProps extends ComponentPropsWithRef<"span">, IntentProps {
8
12
  /** Draws an expanding ripple from the pointer position. */
9
13
  ripple?: boolean;
10
14
  /** Scales the content down while pressed (uses the preset's `--press-scale`). */
@@ -24,9 +28,17 @@ export function PressableFeedback({
24
28
  className,
25
29
  children,
26
30
  onPointerDown,
31
+ intent,
32
+ intentKey,
33
+ ref,
27
34
  ...props
28
35
  }: PressableFeedbackProps) {
29
36
  const host = useRef<HTMLSpanElement>(null);
37
+ const composedRef = useComposedRefs<HTMLSpanElement>(
38
+ ref,
39
+ host,
40
+ useIntentTarget({ intent, intentKey }),
41
+ );
30
42
  const reduced = usePrefersReducedMotion();
31
43
 
32
44
  const spawn = (event: PointerEvent<HTMLSpanElement>) => {
@@ -62,7 +74,7 @@ export function PressableFeedback({
62
74
 
63
75
  return (
64
76
  <span
65
- ref={host}
77
+ ref={composedRef}
66
78
  data-disabled={disabled || undefined}
67
79
  onPointerDown={spawn}
68
80
  className={cn(
@@ -71,6 +83,7 @@ export function PressableFeedback({
71
83
  disabled && "pointer-events-none opacity-60",
72
84
  className,
73
85
  )}
86
+ {...intentAttributes({ intent, intentKey })}
74
87
  {...props}
75
88
  >
76
89
  {children}
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef } from "react";
3
+ import type { ComponentPropsWithRef } from "react";
4
4
  import type { ClassNames } from "../../utils/class-names.js";
5
5
  import { cn } from "../../utils/cn.js";
6
6
  import { customToneStyle, isCustomTone } from "../../utils/tone.js";
@@ -25,7 +25,7 @@ const DEFAULT_MAX = 100;
25
25
 
26
26
  export type ProgressPart = "root" | "indicator";
27
27
 
28
- export interface ProgressProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
28
+ export interface ProgressProps extends Omit<ComponentPropsWithRef<"div">, "children"> {
29
29
  value: number;
30
30
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
31
31
  classNames?: ClassNames<ProgressPart>;