@jcsoftdev/ui 0.9.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 (459) hide show
  1. package/CHANGELOG.md +123 -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 +6 -1
  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 +5 -4
  246. package/dist/navigation/tabs/tabs.js +20 -1
  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 +9 -8
  254. package/dist/overlays/dialog/dialog.js +11 -0
  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/showcase/bento.js +1 -0
  280. package/dist/utils/is-production.d.ts +1 -0
  281. package/dist/utils/is-production.js +6 -0
  282. package/dist/utils/slot.js +17 -3
  283. package/package.json +2 -2
  284. package/src/ai/attachment/attachment.tsx +10 -3
  285. package/src/ai/chat-message/chat-message.tsx +10 -2
  286. package/src/ai/code-block/code-block.tsx +2 -2
  287. package/src/ai/conversation/conversation.tsx +2 -2
  288. package/src/ai/internal/disclosure.tsx +1 -1
  289. package/src/ai/internal/icon-action.tsx +14 -4
  290. package/src/ai/message-actions/message-actions.tsx +28 -3
  291. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  292. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  293. package/src/ai/source/source.tsx +17 -3
  294. package/src/ai/tool-call/tool-call.tsx +6 -1
  295. package/src/atoms/big-date/big-date.tsx +2 -2
  296. package/src/atoms/button/button.tsx +11 -1
  297. package/src/atoms/checkbox/checkbox.tsx +40 -21
  298. package/src/atoms/chip/chip.tsx +12 -2
  299. package/src/atoms/divider/divider.tsx +2 -2
  300. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  301. package/src/atoms/elapsed-time/model.ts +57 -0
  302. package/src/atoms/icon-button/icon-button.tsx +3 -1
  303. package/src/atoms/internal/labelled-control.tsx +83 -0
  304. package/src/atoms/number-value/number-value.tsx +2 -2
  305. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  306. package/src/atoms/progress/progress.tsx +2 -2
  307. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  308. package/src/atoms/radio-group/radio-group.tsx +5 -1
  309. package/src/atoms/seal/seal.tsx +2 -2
  310. package/src/atoms/status-pill/status-pill.tsx +1 -1
  311. package/src/atoms/switch/switch.tsx +43 -9
  312. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  313. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  314. package/src/auth/login-form/parts.tsx +2 -2
  315. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  316. package/src/calendar/day-chip/day-chip.tsx +14 -2
  317. package/src/calendar/event-block/event-block.tsx +9 -1
  318. package/src/calendar/internal/grid-navigation.ts +47 -0
  319. package/src/calendar/internal/intent.ts +10 -0
  320. package/src/calendar/internal/month-model.ts +23 -0
  321. package/src/calendar/internal/types.ts +4 -0
  322. package/src/calendar/month-view/month-grid.tsx +248 -0
  323. package/src/calendar/month-view/month-view.tsx +32 -148
  324. package/src/calendar/week-view/week-view.tsx +87 -10
  325. package/src/charts/README.md +10 -0
  326. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  327. package/src/charts/core/breadcrumb.tsx +1 -1
  328. package/src/charts/core/chart-states.tsx +1 -1
  329. package/src/charts/core/distribution/xy-points.tsx +4 -2
  330. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  331. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  332. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  333. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  334. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  335. package/src/containers/action-bar/action-bar.tsx +3 -3
  336. package/src/containers/aside/aside.tsx +3 -3
  337. package/src/containers/banner/banner.tsx +2 -2
  338. package/src/containers/card/card.tsx +7 -5
  339. package/src/containers/carousel/carousel.tsx +4 -4
  340. package/src/containers/cols/cols.tsx +3 -3
  341. package/src/containers/comment/comment.tsx +2 -2
  342. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  343. package/src/containers/dashboard/dashboard.tsx +4 -4
  344. package/src/containers/data-grid/column-menu.tsx +1 -1
  345. package/src/containers/data-grid/data-grid.tsx +53 -4
  346. package/src/containers/data-grid/formula-bar.tsx +1 -1
  347. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  348. package/src/containers/data-grid/tool-panel.tsx +1 -1
  349. package/src/containers/description-list/description-list.tsx +2 -2
  350. package/src/containers/detail-header/detail-header.tsx +2 -2
  351. package/src/containers/facts/facts.tsx +2 -2
  352. package/src/containers/feed/feed.tsx +16 -3
  353. package/src/containers/file-tree/file-tree.tsx +11 -0
  354. package/src/containers/file-tree/model.ts +2 -0
  355. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  356. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  357. package/src/containers/floor-plan/index.ts +7 -1
  358. package/src/containers/floor-plan/model.ts +16 -0
  359. package/src/containers/generic-row/generic-row.tsx +9 -6
  360. package/src/containers/grid/grid.tsx +2 -2
  361. package/src/containers/hbars/hbars.tsx +23 -21
  362. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  363. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  364. package/src/containers/kanban/kanban.tsx +13 -0
  365. package/src/containers/kanban/model.ts +2 -0
  366. package/src/containers/kpi/kpi-model.ts +37 -0
  367. package/src/containers/kpi/kpi-parts.tsx +153 -0
  368. package/src/containers/kpi/kpi.tsx +10 -176
  369. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  370. package/src/containers/list-detail/list-detail.tsx +22 -12
  371. package/src/containers/note/note.tsx +2 -2
  372. package/src/containers/order-ticket/index.ts +2 -0
  373. package/src/containers/order-ticket/model.ts +21 -0
  374. package/src/containers/order-ticket/order-ticket.tsx +30 -13
  375. package/src/containers/page/page.tsx +2 -2
  376. package/src/containers/page-header/back.tsx +2 -2
  377. package/src/containers/page-header/page-header.tsx +6 -6
  378. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  379. package/src/containers/pagination/pagination.tsx +4 -4
  380. package/src/containers/resizable/resizable.tsx +7 -5
  381. package/src/containers/row-actions/row-actions.tsx +18 -3
  382. package/src/containers/scrolly/scrolly.tsx +1 -1
  383. package/src/containers/section/section.tsx +21 -8
  384. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  385. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  386. package/src/containers/settings-row/settings-row.tsx +7 -2
  387. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  388. package/src/containers/stack/stack.tsx +2 -2
  389. package/src/containers/table/table.tsx +35 -14
  390. package/src/containers/timeline/timeline.tsx +17 -3
  391. package/src/containers/toolbar/toolbar.tsx +3 -3
  392. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  393. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  394. package/src/forms/chip-group/chip-group.tsx +23 -2
  395. package/src/forms/combobox/combobox.tsx +15 -4
  396. package/src/forms/copy-field/copy-field.tsx +11 -2
  397. package/src/forms/date-picker/date-picker.tsx +23 -12
  398. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  399. package/src/forms/dropzone/dropzone.tsx +18 -3
  400. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  401. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  402. package/src/forms/field/field.tsx +2 -2
  403. package/src/forms/fieldset/fieldset.tsx +2 -2
  404. package/src/forms/form/form.tsx +13 -5
  405. package/src/forms/form-footer/form-footer.tsx +2 -2
  406. package/src/forms/form-grid/form-grid.tsx +3 -3
  407. package/src/forms/form-section/form-section.tsx +2 -2
  408. package/src/forms/inline-select/inline-select.tsx +14 -3
  409. package/src/forms/input/input.tsx +8 -2
  410. package/src/forms/internal/button-option.tsx +2 -0
  411. package/src/forms/label/label.tsx +2 -2
  412. package/src/forms/native-select/native-select.tsx +9 -2
  413. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  414. package/src/forms/password-input/password-input.tsx +12 -0
  415. package/src/forms/pin-input/pin-input.tsx +9 -1
  416. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  417. package/src/forms/rating/rating.tsx +14 -1
  418. package/src/forms/select/select.tsx +14 -4
  419. package/src/forms/select-menu/select-menu.tsx +15 -4
  420. package/src/forms/slider/model.ts +5 -0
  421. package/src/forms/slider/slider.tsx +13 -3
  422. package/src/forms/textarea/textarea.tsx +7 -4
  423. package/src/forms/time-input/time-input.tsx +19 -5
  424. package/src/i18n/strings.ts +18 -0
  425. package/src/intent/attributes.ts +96 -0
  426. package/src/intent/bridge.tsx +25 -0
  427. package/src/intent/index.ts +24 -0
  428. package/src/intent/target-registrations.ts +127 -0
  429. package/src/intent/types.ts +44 -0
  430. package/src/intent/use-intent-target.ts +96 -0
  431. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  432. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  433. package/src/navigation/floating-toc/model.ts +3 -1
  434. package/src/navigation/segmented/segmented.tsx +14 -2
  435. package/src/navigation/stepper/stepper.tsx +7 -2
  436. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  437. package/src/navigation/tabs/tabs.tsx +24 -3
  438. package/src/navigation/wizard/wizard.tsx +12 -4
  439. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  440. package/src/overlays/context-menu/context-menu.tsx +58 -11
  441. package/src/overlays/dialog/dialog.tsx +18 -7
  442. package/src/overlays/drawer/drawer.tsx +15 -4
  443. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  444. package/src/overlays/hover-card/hover-card.tsx +13 -2
  445. package/src/overlays/popover/popover.tsx +12 -1
  446. package/src/overlays/tooltip/model.ts +8 -0
  447. package/src/overlays/tooltip/tooltip.tsx +15 -2
  448. package/src/palette/command-palette/command-palette.tsx +66 -3
  449. package/src/palette/command-palette/index.ts +1 -0
  450. package/src/palette/command-palette/model.ts +15 -0
  451. package/src/primitives/command/command.tsx +4 -1
  452. package/src/primitives/dialog/dialog.tsx +1 -4
  453. package/src/primitives/popper/popper.tsx +16 -5
  454. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  455. package/src/shell/sidebar/sidebar.tsx +22 -4
  456. package/src/showcase/bento.tsx +2 -0
  457. package/src/utils/is-production.ts +3 -0
  458. package/src/utils/slot.tsx +21 -3
  459. package/styles/base.css +34 -0
@@ -1,60 +1,15 @@
1
- import { type ComponentPropsWithoutRef, createContext, type ReactNode, useContext } 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
- import { customToneStyle, isCustomTone } from "../../utils/tone.js";
4
+ import { customToneStyle } from "../../utils/tone.js";
5
+ import { builtinTones, type KpiPart, type KpiTone, type KpiVariant } from "./kpi-model.js";
6
+ import { KpiDescription, KpiLabel, KpiProvider, KpiValue } from "./kpi-parts.js";
5
7
 
6
- export type KpiVariant = "default" | "danger";
8
+ export type { KpiBuiltinTone, KpiPart, KpiTone, KpiVariant } from "./kpi-model.js";
9
+ export type { KpiDescriptionProps, KpiLabelProps, KpiValueProps } from "./kpi-parts.js";
10
+ export { KpiDescription, KpiLabel, KpiValue };
7
11
 
8
- export type KpiBuiltinTone = "neutral" | "accent" | "success" | "warning" | "danger" | "info";
9
-
10
- /** A built-in tone, or the name of a tone declared in `tonePalettes`. */
11
- export type KpiTone = KpiBuiltinTone | (string & {});
12
-
13
- const valueToneClasses: Record<KpiBuiltinTone, string> = {
14
- neutral: "text-ink",
15
- accent: "text-accent-ink",
16
- success: "text-success",
17
- warning: "text-warning",
18
- danger: "text-danger",
19
- info: "text-info",
20
- };
21
-
22
- const dotToneClasses: Record<KpiBuiltinTone, string> = {
23
- neutral: "bg-ink-3",
24
- accent: "bg-accent",
25
- success: "bg-success",
26
- warning: "bg-warning",
27
- danger: "bg-danger",
28
- info: "bg-info",
29
- };
30
-
31
- const builtinTones = new Set<string>(Object.keys(valueToneClasses));
32
-
33
- export type KpiPart =
34
- | "root"
35
- | "header"
36
- | "label"
37
- | "dot"
38
- | "icon"
39
- | "trailing"
40
- | "value"
41
- | "suffix"
42
- | "trend"
43
- | "description";
44
-
45
- interface KpiContextValue {
46
- tone: KpiTone;
47
- dot: boolean;
48
- classNames: ClassNames<KpiPart> | undefined;
49
- }
50
-
51
- const KpiContext = createContext<KpiContextValue>({
52
- tone: "neutral",
53
- dot: false,
54
- classNames: undefined,
55
- });
56
-
57
- export interface KpiProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
12
+ export interface KpiProps extends Omit<ComponentPropsWithRef<"div">, "children"> {
58
13
  /** Short label describing the metric. Optional when you compose `Kpi.Label` as children. */
59
14
  label?: ReactNode;
60
15
  /** Highlighted number, already formatted by the consumer. Optional when you compose `Kpi.Value`. */
@@ -85,127 +40,6 @@ export interface KpiProps extends Omit<ComponentPropsWithoutRef<"div">, "childre
85
40
  classNames?: ClassNames<KpiPart>;
86
41
  }
87
42
 
88
- export interface KpiLabelProps extends ComponentPropsWithoutRef<"span"> {
89
- /** Decorative icon at the end of the row (`aria-hidden`). */
90
- icon?: ReactNode;
91
- /** Interactive or labelled content at the end of the row. */
92
- trailing?: ReactNode;
93
- /** Overrides the tile's `dot`. */
94
- dot?: boolean;
95
- }
96
-
97
- /** Label row of a composed `Kpi`: the label, then an optional icon and trailing slot at the end. */
98
- export function KpiLabel({
99
- icon,
100
- trailing,
101
- dot: dotProp,
102
- className,
103
- children,
104
- ...props
105
- }: KpiLabelProps) {
106
- const { tone, dot: tileDot, classNames } = useContext(KpiContext);
107
- const dot = dotProp ?? tileDot;
108
- const dotTone = isCustomTone(tone, builtinTones)
109
- ? "bg-(--tone-c)"
110
- : (dotToneClasses[tone as KpiBuiltinTone] ?? dotToneClasses.neutral);
111
- const labelNode = (
112
- <span
113
- {...props}
114
- className={cn(
115
- "min-w-0 break-words font-semibold text-fs-120 text-ink-2",
116
- dot && "inline-flex items-center gap-1.5",
117
- classNames?.label,
118
- className,
119
- )}
120
- >
121
- {dot ? (
122
- <span
123
- aria-hidden="true"
124
- className={cn("size-1.5 shrink-0 rounded-pill", dotTone, classNames?.dot)}
125
- />
126
- ) : null}
127
- {children}
128
- </span>
129
- );
130
- if (!icon && !trailing) return labelNode;
131
- return (
132
- <div className={cn("flex items-center justify-between gap-2", classNames?.header)}>
133
- {labelNode}
134
- <span className="flex shrink-0 items-center gap-1.5">
135
- {icon ? (
136
- <span
137
- aria-hidden="true"
138
- className={cn("shrink-0 text-ink-3 [&_svg]:size-4", classNames?.icon)}
139
- >
140
- {icon}
141
- </span>
142
- ) : null}
143
- {trailing ? <span className={cn("shrink-0", classNames?.trailing)}>{trailing}</span> : null}
144
- </span>
145
- </div>
146
- );
147
- }
148
-
149
- export interface KpiValueProps extends ComponentPropsWithoutRef<"span"> {
150
- /** Small suffix next to the number. */
151
- suffix?: ReactNode;
152
- /** Change indicator next to the value. */
153
- trend?: ReactNode;
154
- /** Monospaced digits at a steady weight, for amounts and codes. */
155
- mono?: boolean;
156
- }
157
-
158
- /** The highlighted number of a composed `Kpi`, coloured by the tile's tone. */
159
- export function KpiValue({ suffix, trend, mono, className, children, ...props }: KpiValueProps) {
160
- const { tone, classNames } = useContext(KpiContext);
161
- const valueTone = isCustomTone(tone, builtinTones)
162
- ? "text-(--tone-c-ink)"
163
- : (valueToneClasses[tone as KpiBuiltinTone] ?? valueToneClasses.neutral);
164
- const valueNode = (
165
- <span
166
- {...props}
167
- className={cn(
168
- "break-words text-kpi-number tabular-nums @max-[9rem]/kpi:text-fs-200",
169
- mono && "font-mono tracking-normal",
170
- valueTone,
171
- classNames?.value,
172
- className,
173
- )}
174
- >
175
- {children}
176
- {suffix ? (
177
- <small
178
- className={cn(
179
- "ml-1 font-semibold text-fs-140 text-ink-3 tracking-normal",
180
- classNames?.suffix,
181
- )}
182
- >
183
- {suffix}
184
- </small>
185
- ) : null}
186
- </span>
187
- );
188
- if (!trend) return valueNode;
189
- return (
190
- <div className="flex flex-wrap items-baseline gap-x-2 gap-y-1">
191
- {valueNode}
192
- <span className={cn("shrink-0", classNames?.trend)}>{trend}</span>
193
- </div>
194
- );
195
- }
196
-
197
- export interface KpiDescriptionProps extends ComponentPropsWithoutRef<"span"> {}
198
-
199
- export function KpiDescription({ className, ...props }: KpiDescriptionProps) {
200
- const { classNames } = useContext(KpiContext);
201
- return (
202
- <span
203
- {...props}
204
- className={cn("break-words text-fs-120 text-ink-3", classNames?.description, className)}
205
- />
206
- );
207
- }
208
-
209
43
  /**
210
44
  * One metric: a label, a big number and an optional description. Fill it with props, or compose
211
45
  * `Kpi.Label`, `Kpi.Value` and `Kpi.Description` as children when the parts need their own
@@ -231,7 +65,7 @@ export function Kpi({
231
65
  }: KpiProps) {
232
66
  const tone: KpiTone = toneProp ?? (variant === "danger" ? "danger" : "neutral");
233
67
  return (
234
- <KpiContext.Provider value={{ tone, dot, classNames }}>
68
+ <KpiProvider tone={tone} dot={dot} classNames={classNames}>
235
69
  <div
236
70
  {...props}
237
71
  style={customToneStyle(tone, builtinTones, style)}
@@ -255,7 +89,7 @@ export function Kpi({
255
89
  {description ? <KpiDescription>{description}</KpiDescription> : null}
256
90
  {children}
257
91
  </div>
258
- </KpiContext.Provider>
92
+ </KpiProvider>
259
93
  );
260
94
  }
261
95
 
@@ -1,4 +1,4 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, ReactNode } from "react";
2
2
  import type { NumberFormatConfig } from "../../atoms/number-value/format.js";
3
3
  import { NumberValue } from "../../atoms/number-value/number-value.js";
4
4
  import { TrendChip } from "../../atoms/trend-chip/trend-chip.js";
@@ -23,7 +23,7 @@ export type KpiGroupLayout = "divided" | "auto-fit";
23
23
 
24
24
  export type KpiGroupPart = "root" | "list" | "item" | "label" | "value" | "trend" | "description";
25
25
 
26
- export interface KpiGroupProps extends Omit<ComponentPropsWithoutRef<"dl">, "children"> {
26
+ export interface KpiGroupProps extends Omit<ComponentPropsWithRef<"dl">, "children"> {
27
27
  items: KpiGroupItem[];
28
28
  /**
29
29
  * `divided` (default): one card, 1, 2 or 4 columns by container width. `auto-fit`: separate
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  type CSSProperties,
6
6
  createContext,
7
7
  type ReactNode,
@@ -16,8 +16,11 @@ import {
16
16
  } from "react";
17
17
  import { useUiStrings } from "../../i18n/index.js";
18
18
  import { ChevronLeft } from "../../icons/index.js";
19
+ import { intentAttributes } from "../../intent/attributes.js";
20
+ import type { IntentProps } from "../../intent/types.js";
21
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
19
22
  import { cn } from "../../utils/cn.js";
20
- import { composeHandlers } from "../../utils/compose.js";
23
+ import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
21
24
  import { useFocusRescue } from "../../utils/focus-rescue.js";
22
25
  import { useControllableState } from "../../utils/use-controllable-state.js";
23
26
 
@@ -58,7 +61,7 @@ function cssLength(value: number | string): string {
58
61
  }
59
62
 
60
63
  export interface ListDetailProps
61
- extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue" | "onChange"> {
64
+ extends Omit<ComponentPropsWithRef<"div">, "defaultValue" | "onChange"> {
62
65
  /** Controlled selected item id; `null` means none (the single-pane view then shows the list). */
63
66
  value?: string | null | undefined;
64
67
  defaultValue?: string | null | undefined;
@@ -188,7 +191,7 @@ export function ListDetail({
188
191
  );
189
192
  }
190
193
 
191
- export interface ListDetailListProps extends Omit<ComponentPropsWithoutRef<"ul">, "aria-label"> {
194
+ export interface ListDetailListProps extends Omit<ComponentPropsWithRef<"ul">, "aria-label"> {
192
195
  /** Sits above the items and stays put while they scroll: a `ListDetailHeader` with search, filters and a count. */
193
196
  header?: ReactNode;
194
197
  }
@@ -225,7 +228,7 @@ export function ListDetailList({ header, className, ...props }: ListDetailListPr
225
228
  );
226
229
  }
227
230
 
228
- export interface ListDetailHeaderProps extends ComponentPropsWithoutRef<"div"> {
231
+ export interface ListDetailHeaderProps extends ComponentPropsWithRef<"div"> {
229
232
  /** End slot showing how many items match, e.g. `12`. Announced politely when it changes. */
230
233
  count?: ReactNode;
231
234
  }
@@ -250,7 +253,9 @@ export function ListDetailHeader({ count, className, children, ...props }: ListD
250
253
  );
251
254
  }
252
255
 
253
- export interface ListDetailItemProps extends Omit<ComponentPropsWithoutRef<"button">, "value"> {
256
+ export interface ListDetailItemProps
257
+ extends Omit<ComponentPropsWithRef<"button">, "value">,
258
+ IntentProps {
254
259
  value: string;
255
260
  /** End slot: a count, a status chip, a time. */
256
261
  trailing?: ReactNode;
@@ -262,14 +267,19 @@ export function ListDetailItem({
262
267
  className,
263
268
  children,
264
269
  onClick,
270
+ intent,
271
+ intentKey,
272
+ ref,
265
273
  ...props
266
274
  }: ListDetailItemProps) {
275
+ const targetRef = useComposedRefs(ref, useIntentTarget<HTMLButtonElement>({ intent, intentKey }));
267
276
  const { value: selected, select } = useListDetailContext("ListDetailItem");
268
277
  const isSelected = selected === value;
269
278
  return (
270
279
  <li>
271
280
  <button
272
281
  type="button"
282
+ {...intentAttributes({ intent, intentKey })}
273
283
  data-list-detail-item={value}
274
284
  aria-current={isSelected ? "true" : undefined}
275
285
  onClick={composeHandlers(onClick, () => select(value))}
@@ -279,6 +289,7 @@ export function ListDetailItem({
279
289
  className,
280
290
  )}
281
291
  {...props}
292
+ ref={targetRef}
282
293
  >
283
294
  <span className="min-w-0">{children}</span>
284
295
  {trailing !== undefined ? (
@@ -289,11 +300,11 @@ export function ListDetailItem({
289
300
  );
290
301
  }
291
302
 
292
- export function ListDetailTitle({ className, ...props }: ComponentPropsWithoutRef<"span">) {
303
+ export function ListDetailTitle({ className, ...props }: ComponentPropsWithRef<"span">) {
293
304
  return <span className={cn("block font-medium text-ink", className)} {...props} />;
294
305
  }
295
306
 
296
- export function ListDetailMeta({ className, ...props }: ComponentPropsWithoutRef<"span">) {
307
+ export function ListDetailMeta({ className, ...props }: ComponentPropsWithRef<"span">) {
297
308
  return <span className={cn("block text-meta text-ink-3", className)} {...props} />;
298
309
  }
299
310
 
@@ -304,7 +315,7 @@ interface DetailTitleValue {
304
315
 
305
316
  const DetailTitleContext = createContext<DetailTitleValue | null>(null);
306
317
 
307
- export interface ListDetailDetailProps extends ComponentPropsWithoutRef<"section"> {
318
+ export interface ListDetailDetailProps extends ComponentPropsWithRef<"section"> {
308
319
  /** Label of the back action shown in the single-pane view. Defaults to the localized "Back to list". */
309
320
  backLabel?: string;
310
321
  /** Hides the back action (the consumer then provides its own way back). */
@@ -362,8 +373,7 @@ export function ListDetailDetail({
362
373
  );
363
374
  }
364
375
 
365
- export interface ListDetailDetailHeaderProps
366
- extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
376
+ export interface ListDetailDetailHeaderProps extends Omit<ComponentPropsWithRef<"div">, "title"> {
367
377
  title: ReactNode;
368
378
  description?: ReactNode;
369
379
  actions?: ReactNode;
@@ -397,7 +407,7 @@ export function ListDetailDetailHeader({
397
407
  );
398
408
  }
399
409
 
400
- export interface ListDetailEmptyProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
410
+ export interface ListDetailEmptyProps extends Omit<ComponentPropsWithRef<"div">, "title"> {
401
411
  /** Decorative icon; hidden from screen readers. */
402
412
  icon?: ReactNode;
403
413
  title: ReactNode;
@@ -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 NoteTone = "neutral" | "info" | "success" | "warning" | "danger";
@@ -11,7 +11,7 @@ const toneClasses: Record<NoteTone, string> = {
11
11
  danger: "text-danger",
12
12
  };
13
13
 
14
- export interface NoteProps extends ComponentPropsWithoutRef<"p"> {
14
+ export interface NoteProps extends ComponentPropsWithRef<"p"> {
15
15
  /** Colors the text. Defaults to `neutral`. */
16
16
  tone?: NoteTone;
17
17
  /** Hairline above the note, to hang it under a block it explains. */
@@ -2,7 +2,9 @@ export {
2
2
  type OrderTicketLine,
3
3
  type OrderTicketLineStatus,
4
4
  type OrderTicketState,
5
+ type OrderTicketTitleInput,
5
6
  orderTicketState,
7
+ orderTicketTitle,
6
8
  splitTicketLines,
7
9
  ticketLineCost,
8
10
  warnLeadSeconds,
@@ -1,3 +1,5 @@
1
+ import type { UiStrings } from "../../i18n/index.js";
2
+
1
3
  export type OrderTicketState = "ok" | "warn" | "late";
2
4
 
3
5
  export type OrderTicketLineStatus = "pending" | "in-progress" | "done";
@@ -53,3 +55,22 @@ export function splitTicketLines<Line extends LineShape>(
53
55
  }
54
56
  return parts;
55
57
  }
58
+
59
+ export interface OrderTicketTitleInput {
60
+ table?: string | undefined;
61
+ number?: string | number | undefined;
62
+ }
63
+
64
+ export function orderTicketTitle(
65
+ input: OrderTicketTitleInput,
66
+ strings: Pick<UiStrings, "orderTicketNumber" | "orderTicketTableAndNumber">,
67
+ ): string {
68
+ const number = input.number === undefined ? undefined : String(input.number);
69
+ if (input.table !== undefined && number !== undefined) {
70
+ return strings.orderTicketTableAndNumber
71
+ .replace("{table}", input.table)
72
+ .replace("{number}", number);
73
+ }
74
+ if (input.table !== undefined) return input.table;
75
+ return strings.orderTicketNumber.replace("{number}", number ?? "");
76
+ }
@@ -1,10 +1,14 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, type ReactNode, useId, useSyncExternalStore } from "react";
3
+ import { type ComponentPropsWithRef, type ReactNode, useId, useSyncExternalStore } from "react";
4
4
  import { Button } from "../../atoms/button/button.js";
5
5
  import { Chip } from "../../atoms/chip/chip.js";
6
6
  import { ElapsedTime } from "../../atoms/elapsed-time/elapsed-time.js";
7
- import { readElapsed } from "../../atoms/elapsed-time/model.js";
7
+ import {
8
+ formatMinutesText,
9
+ formatOverrunText,
10
+ readElapsed,
11
+ } from "../../atoms/elapsed-time/model.js";
8
12
  import { getTickerSnapshot, subscribeTicker } from "../../atoms/elapsed-time/ticker.js";
9
13
  import { Progress, type ProgressBuiltinTone } from "../../atoms/progress/progress.js";
10
14
  import { type UiStrings, useUiStrings } from "../../i18n/index.js";
@@ -18,14 +22,17 @@ import {
18
22
  Square,
19
23
  TriangleAlert,
20
24
  } from "../../icons/index.js";
25
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
21
26
  import type { ClassNames } from "../../utils/class-names.js";
22
27
  import { cn } from "../../utils/cn.js";
28
+ import { useComposedRefs } from "../../utils/compose.js";
23
29
  import { usePrefersReducedMotion } from "../../utils/reduced-motion.js";
24
30
  import {
25
31
  type OrderTicketLine,
26
32
  type OrderTicketLineStatus,
27
33
  type OrderTicketState,
28
34
  orderTicketState,
35
+ orderTicketTitle,
29
36
  } from "./model.js";
30
37
 
31
38
  export type OrderTicketPart =
@@ -46,7 +53,8 @@ export interface OrderTicketChannel {
46
53
  }
47
54
 
48
55
  export interface OrderTicketProps
49
- extends Omit<ComponentPropsWithoutRef<"article">, "title" | "children"> {
56
+ extends Omit<ComponentPropsWithRef<"article">, "title" | "children">,
57
+ IntentProps {
50
58
  table?: string | undefined;
51
59
  number?: string | number | undefined;
52
60
  channel?: OrderTicketChannel | undefined;
@@ -132,9 +140,6 @@ const fill = (template: string, values: Record<string, string | number>) =>
132
140
  template,
133
141
  );
134
142
 
135
- const clock = (seconds: number) =>
136
- `${Math.floor(seconds / 60)}:${String(seconds % 60).padStart(2, "0")}`;
137
-
138
143
  const noteClasses =
139
144
  "inline-flex max-w-full items-start gap-1 self-start rounded-chip px-1.5 py-0.5 text-meta font-medium [&_svg]:mt-0.5 [&_svg]:shrink-0";
140
145
 
@@ -273,11 +278,18 @@ export function OrderTicket({
273
278
  classNames,
274
279
  className,
275
280
  style,
281
+ intent,
282
+ intentKey,
283
+ ref,
284
+ "aria-describedby": describedBy,
276
285
  ...props
277
286
  }: OrderTicketProps) {
278
287
  const strings = useUiStrings();
279
288
  const reducedMotion = usePrefersReducedMotion();
280
289
  const headingId = useId();
290
+ const stateId = useId();
291
+ const intentRef = useIntentTarget<HTMLElement>({ intent, intentKey }, { role: "article" });
292
+ const articleRef = useComposedRefs<HTMLElement>(ref, intentRef);
281
293
  const now = useSyncExternalStore(subscribeTicker, getTickerSnapshot, getTickerSnapshot);
282
294
  const { seconds } = readElapsed({ since, now, serverOffsetMs });
283
295
  const targetSeconds = Math.max(1, targetMinutes * 60);
@@ -285,7 +297,7 @@ export function OrderTicket({
285
297
  const late = state === "late";
286
298
  const overrun = Math.max(0, seconds - targetSeconds);
287
299
  const Heading = `h${headingLevel}` as const;
288
- const title = table ?? fill(strings.orderTicketNumber, { number: number ?? "" });
300
+ const title = orderTicketTitle({ table, number }, strings);
289
301
  const titleIcon = table ? null : channel?.icon;
290
302
  const guestsText =
291
303
  guests === undefined
@@ -302,13 +314,16 @@ export function OrderTicket({
302
314
  ? strings.orderTicketContinued
303
315
  : fill(strings.orderTicketPart, { index: 1, count: partCount ?? 1 });
304
316
  const overrunText = reducedMotion
305
- ? fill(strings.minutesShort, { count: Math.ceil(overrun / 60) })
306
- : clock(overrun);
317
+ ? formatMinutesText(Math.ceil(overrun / 60), strings)
318
+ : formatOverrunText(overrun, strings);
307
319
  const showActions = !readOnly && Boolean(actions || onStartAll || onReadyAll);
308
320
 
309
321
  return (
310
322
  <article
323
+ ref={articleRef}
311
324
  aria-labelledby={headingId}
325
+ aria-describedby={[stateId, describedBy].filter(Boolean).join(" ")}
326
+ {...intentAttributes({ intent, intentKey })}
312
327
  data-state={state}
313
328
  data-read-only={readOnly ? "" : undefined}
314
329
  data-part-index={split ? (partIndex ?? 1) : undefined}
@@ -352,8 +367,10 @@ export function OrderTicket({
352
367
  {titleIcon}
353
368
  <span>{title}</span>
354
369
  {split && <span className="text-control">{partLabel}</span>}
355
- <span className="sr-only">{`, ${strings[stateWord[state]]}`}</span>
356
370
  </Heading>
371
+ <span id={stateId} className="sr-only">
372
+ {strings[stateWord[state]]}
373
+ </span>
357
374
  {meta && (
358
375
  <span
359
376
  className={cn(
@@ -394,9 +411,9 @@ export function OrderTicket({
394
411
  tone={progressTone[state]}
395
412
  aria-label={fill(strings.orderTicketProgress, { target: targetMinutes })}
396
413
  getValueLabel={() =>
397
- fill(strings.orderTicketProgressValue, {
398
- elapsed: Math.floor(seconds / 60),
399
- target: targetMinutes,
414
+ fill(strings.orderTicketProgressDuration, {
415
+ elapsed: formatMinutesText(Math.floor(seconds / 60), strings),
416
+ target: formatMinutesText(targetMinutes, strings),
400
417
  })
401
418
  }
402
419
  className={classNames?.progress}
@@ -1,7 +1,7 @@
1
- import type { ComponentPropsWithoutRef, CSSProperties, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, CSSProperties, ReactNode } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export interface PageProps extends ComponentPropsWithoutRef<"div"> {
4
+ export interface PageProps extends ComponentPropsWithRef<"div"> {
5
5
  /**
6
6
  * A fixed column beside the page content, usually an `Aside`. The column draws a divider and the
7
7
  * page background, never narrows the width the `page` container measures (so `Cols` inside the
@@ -1,12 +1,12 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef } from "react";
3
+ import type { ComponentPropsWithRef } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { ChevronLeft } from "../../icons/index.js";
6
6
  import { cn } from "../../utils/cn.js";
7
7
  import { Slot } from "../../utils/slot.js";
8
8
 
9
- export interface PageHeaderBackProps extends ComponentPropsWithoutRef<"a"> {
9
+ export interface PageHeaderBackProps extends ComponentPropsWithRef<"a"> {
10
10
  /** Renders the single child element (a router `Link`) with the link's look. The child supplies the label. */
11
11
  asChild?: boolean | undefined;
12
12
  }
@@ -1,7 +1,7 @@
1
- import type { ComponentPropsWithoutRef, CSSProperties, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, CSSProperties, ReactNode } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export interface PageHeaderProps extends ComponentPropsWithoutRef<"header"> {
4
+ export interface PageHeaderProps extends ComponentPropsWithRef<"header"> {
5
5
  /** Trail shown on its own row above the title, usually a `Breadcrumbs`. */
6
6
  breadcrumbs?: ReactNode;
7
7
  /** Tighter, centred header with a smaller title and a body-size lede. */
@@ -82,7 +82,7 @@ export function PageHeader({
82
82
  );
83
83
  }
84
84
 
85
- export type PageHeaderEyebrowProps = ComponentPropsWithoutRef<"div">;
85
+ export type PageHeaderEyebrowProps = ComponentPropsWithRef<"div">;
86
86
 
87
87
  export function PageHeaderEyebrow({ className, ...props }: PageHeaderEyebrowProps) {
88
88
  return (
@@ -93,7 +93,7 @@ export function PageHeaderEyebrow({ className, ...props }: PageHeaderEyebrowProp
93
93
  );
94
94
  }
95
95
 
96
- export type PageHeaderTitleProps = ComponentPropsWithoutRef<"h1">;
96
+ export type PageHeaderTitleProps = ComponentPropsWithRef<"h1">;
97
97
 
98
98
  /** Page title. Wrap a word in `<span className="text-accent-word">` to accent it. */
99
99
  export function PageHeaderTitle({ className, ...props }: PageHeaderTitleProps) {
@@ -108,7 +108,7 @@ export function PageHeaderTitle({ className, ...props }: PageHeaderTitleProps) {
108
108
  );
109
109
  }
110
110
 
111
- export type PageHeaderLedeProps = ComponentPropsWithoutRef<"p">;
111
+ export type PageHeaderLedeProps = ComponentPropsWithRef<"p">;
112
112
 
113
113
  export function PageHeaderLede({ className, ...props }: PageHeaderLedeProps) {
114
114
  return (
@@ -122,7 +122,7 @@ export function PageHeaderLede({ className, ...props }: PageHeaderLedeProps) {
122
122
  );
123
123
  }
124
124
 
125
- export type PageHeaderActionsProps = ComponentPropsWithoutRef<"div">;
125
+ export type PageHeaderActionsProps = ComponentPropsWithRef<"div">;
126
126
 
127
127
  export function PageHeaderActions({ className, ...props }: PageHeaderActionsProps) {
128
128
  return <div className={cn("flex flex-wrap items-center gap-2", className)} {...props} />;
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, useMemo } from "react";
3
+ import { type ComponentPropsWithRef, useMemo } from "react";
4
4
  import { Button } from "../../atoms/button/button.js";
5
5
  import { useUiStrings } from "../../i18n/index.js";
6
6
  import { cn } from "../../utils/cn.js";
@@ -15,7 +15,7 @@ export interface CursorPaginationLabels {
15
15
  }
16
16
 
17
17
  export interface CursorPaginationProps
18
- extends Omit<ComponentPropsWithoutRef<"nav">, "children" | "onChange"> {
18
+ extends Omit<ComponentPropsWithRef<"nav">, "children" | "onChange"> {
19
19
  /** 1-based page the cursor trail is on. */
20
20
  page: number;
21
21
  /** Rows on this page. */
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, useId, useMemo } from "react";
3
+ import { type ComponentPropsWithRef, useId, useMemo } from "react";
4
4
  import { Button } from "../../atoms/button/button.js";
5
5
  import { useUiStrings } from "../../i18n/index.js";
6
6
  import { ChevronLeft, ChevronRight, ChevronsLeft, ChevronsRight } from "../../icons/index.js";
@@ -44,7 +44,7 @@ export interface PaginationLabels {
44
44
  pageNumber: string;
45
45
  }
46
46
 
47
- export interface PaginationProps extends Omit<ComponentPropsWithoutRef<"nav">, "onChange"> {
47
+ export interface PaginationProps extends Omit<ComponentPropsWithRef<"nav">, "onChange"> {
48
48
  /** Total rows across every page. */
49
49
  total: number;
50
50
  /** Controlled 1-based page. Pair it with `onPageChange`. */
@@ -74,7 +74,7 @@ export interface PaginationProps extends Omit<ComponentPropsWithoutRef<"nav">, "
74
74
  const DEFAULT_OPTIONS = [10, 25, 50, 100] as const;
75
75
 
76
76
  const stepButton =
77
- "grid size-8 place-items-center rounded-control text-ink-2 hover:bg-surface-2 hover:text-ink focus-visible:focus-ring disabled:pointer-events-none disabled:opacity-35 [&_svg]:size-4";
77
+ "grid size-8 place-items-center rounded-control text-ink-2 hover:bg-surface-2 hover:text-ink focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-50 disabled:hover:bg-transparent disabled:hover:text-ink-2 [&_svg]:size-4";
78
78
 
79
79
  /**
80
80
  * Footer of a list or table: rows per page, the range shown ("11–20 of 134") and first, previous,
@@ -170,7 +170,7 @@ export function Pagination({
170
170
  </span>
171
171
  <span className="flex flex-wrap items-center gap-x-4 gap-y-2">
172
172
  {picker}
173
- <span className="flex items-center gap-1">
173
+ <span className="flex flex-wrap items-center gap-1">
174
174
  <Button size="sm" disabled={atStart} onClick={() => setPage(at - 1)}>
175
175
  {text.previousLabel}
176
176
  </Button>