@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,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. */
@@ -0,0 +1,17 @@
1
+ export {
2
+ type OrderTicketLine,
3
+ type OrderTicketLineStatus,
4
+ type OrderTicketState,
5
+ type OrderTicketTitleInput,
6
+ orderTicketState,
7
+ orderTicketTitle,
8
+ splitTicketLines,
9
+ ticketLineCost,
10
+ warnLeadSeconds,
11
+ } from "./model.js";
12
+ export {
13
+ OrderTicket,
14
+ type OrderTicketChannel,
15
+ type OrderTicketPart,
16
+ type OrderTicketProps,
17
+ } from "./order-ticket.js";
@@ -0,0 +1,76 @@
1
+ import type { UiStrings } from "../../i18n/index.js";
2
+
3
+ export type OrderTicketState = "ok" | "warn" | "late";
4
+
5
+ export type OrderTicketLineStatus = "pending" | "in-progress" | "done";
6
+
7
+ export interface OrderTicketLine {
8
+ id: string;
9
+ qty: number;
10
+ name: string;
11
+ modifiers?: readonly string[] | undefined;
12
+ note?: string | undefined;
13
+ allergy?: string | undefined;
14
+ status?: OrderTicketLineStatus | undefined;
15
+ onToggle?: (() => void) | undefined;
16
+ }
17
+
18
+ const MIN_WARN_LEAD_SECONDS = 120;
19
+ const WARN_LEAD_SHARE = 0.25;
20
+
21
+ export function warnLeadSeconds(targetMinutes: number): number {
22
+ return Math.max(MIN_WARN_LEAD_SECONDS, targetMinutes * 60 * WARN_LEAD_SHARE);
23
+ }
24
+
25
+ export function orderTicketState(elapsedSeconds: number, targetMinutes: number): OrderTicketState {
26
+ const target = targetMinutes * 60;
27
+ if (elapsedSeconds > target) return "late";
28
+ if (elapsedSeconds >= target - warnLeadSeconds(targetMinutes)) return "warn";
29
+ return "ok";
30
+ }
31
+
32
+ type LineShape = Pick<OrderTicketLine, "modifiers" | "note" | "allergy">;
33
+
34
+ export function ticketLineCost(line: LineShape): number {
35
+ return 1 + (line.modifiers?.length ? 0.6 : 0) + (line.note ? 0.9 : 0) + (line.allergy ? 0.9 : 0);
36
+ }
37
+
38
+ export function splitTicketLines<Line extends LineShape>(
39
+ lines: readonly Line[],
40
+ budget: number,
41
+ cost: (line: Line) => number = ticketLineCost,
42
+ ): Line[][] {
43
+ const parts: Line[][] = [];
44
+ let used = 0;
45
+ for (const line of lines) {
46
+ const weight = cost(line);
47
+ const current = parts.at(-1);
48
+ if (current && used + weight <= budget) {
49
+ current.push(line);
50
+ used += weight;
51
+ } else {
52
+ parts.push([line]);
53
+ used = weight;
54
+ }
55
+ }
56
+ return parts;
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
+ }