@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
@@ -28,6 +28,10 @@ export interface UiStrings {
28
28
  elapsedMinutes: string;
29
29
  /** Visible text of an `ElapsedTime` with `format="minutes"`; `{count}` is replaced. */
30
30
  minutesShort: string;
31
+ hoursShort: string;
32
+ hoursMinutesShort: string;
33
+ elapsedHoursOne: string;
34
+ elapsedHours: string;
31
35
  /** Accessible text of a countdown `ElapsedTime`; `{time}` is the remaining time. */
32
36
  countdownLeft: string;
33
37
  /** Accessible text of a countdown `ElapsedTime` past its target; `{time}` is the overrun. */
@@ -45,6 +49,7 @@ export interface UiStrings {
45
49
  /** Keyboard help of an editable `FloorPlan`. */
46
50
  floorPlanEditHint: string;
47
51
  orderTicketNumber: string;
52
+ orderTicketTableAndNumber: string;
48
53
  orderTicketGuests: string;
49
54
  orderTicketGuestsOne: string;
50
55
  orderTicketPart: string;
@@ -55,6 +60,7 @@ export interface UiStrings {
55
60
  orderTicketLateBy: string;
56
61
  orderTicketProgress: string;
57
62
  orderTicketProgressValue: string;
63
+ orderTicketProgressDuration: string;
58
64
  orderTicketItems: string;
59
65
  orderTicketPending: string;
60
66
  orderTicketInProgress: string;
@@ -207,6 +213,10 @@ export const uiStrings = {
207
213
  elapsedMinutesOne: "{count} minute",
208
214
  elapsedMinutes: "{count} minutes",
209
215
  minutesShort: "{count} min",
216
+ hoursShort: "{hours} h",
217
+ hoursMinutesShort: "{hours} h {minutes} min",
218
+ elapsedHoursOne: "{count} hour",
219
+ elapsedHours: "{count} hours",
210
220
  countdownLeft: "{time} left",
211
221
  countdownOver: "{time} over",
212
222
  seats: "{count} seats",
@@ -216,6 +226,7 @@ export const uiStrings = {
216
226
  rotate: "Rotate 90°",
217
227
  floorPlanEditHint: "Alt with arrows moves, Alt and Shift with arrows resizes, R rotates.",
218
228
  orderTicketNumber: "No. {number}",
229
+ orderTicketTableAndNumber: "{table} · No. {number}",
219
230
  orderTicketGuests: "{count} guests",
220
231
  orderTicketGuestsOne: "{count} guest",
221
232
  orderTicketPart: "({index} of {count})",
@@ -226,6 +237,7 @@ export const uiStrings = {
226
237
  orderTicketLateBy: "Late +{time}",
227
238
  orderTicketProgress: "Time against the {target} min target",
228
239
  orderTicketProgressValue: "{elapsed} of {target} min",
240
+ orderTicketProgressDuration: "{elapsed} of {target}",
229
241
  orderTicketItems: "Items",
230
242
  orderTicketPending: "Queued",
231
243
  orderTicketInProgress: "Preparing",
@@ -328,6 +340,10 @@ export const uiStrings = {
328
340
  elapsedMinutesOne: "{count} minuto",
329
341
  elapsedMinutes: "{count} minutos",
330
342
  minutesShort: "{count} min",
343
+ hoursShort: "{hours} h",
344
+ hoursMinutesShort: "{hours} h {minutes} min",
345
+ elapsedHoursOne: "{count} hora",
346
+ elapsedHours: "{count} horas",
331
347
  countdownLeft: "faltan {time}",
332
348
  countdownOver: "{time} de retraso",
333
349
  seats: "{count} asientos",
@@ -337,6 +353,7 @@ export const uiStrings = {
337
353
  rotate: "Girar 90°",
338
354
  floorPlanEditHint: "Alt con flechas mueve, Alt y Mayús con flechas cambia el tamaño, R gira.",
339
355
  orderTicketNumber: "N.º {number}",
356
+ orderTicketTableAndNumber: "{table} · N.º {number}",
340
357
  orderTicketGuests: "{count} personas",
341
358
  orderTicketGuestsOne: "{count} persona",
342
359
  orderTicketPart: "({index} de {count})",
@@ -347,6 +364,7 @@ export const uiStrings = {
347
364
  orderTicketLateBy: "Demorada +{time}",
348
365
  orderTicketProgress: "Tiempo contra los {target} min objetivo",
349
366
  orderTicketProgressValue: "{elapsed} de {target} min",
367
+ orderTicketProgressDuration: "{elapsed} de {target}",
350
368
  orderTicketItems: "Platos",
351
369
  orderTicketPending: "En cola",
352
370
  orderTicketInProgress: "Preparando",
@@ -0,0 +1,96 @@
1
+ import type {
2
+ IntentDataAttributes,
3
+ IntentExpectationInput,
4
+ IntentProps,
5
+ IntentSemanticExpectation,
6
+ IntentTargetRef,
7
+ RoleSource,
8
+ } from "./types.js";
9
+
10
+ export const INTENT_ATTRIBUTE = "data-intent";
11
+ export const INTENT_KEY_ATTRIBUTE = "data-intent-key";
12
+ export const INTENT_HIGHLIGHT_ATTRIBUTE = "data-intent-highlight";
13
+ export const INTENT_CHANGED_ATTRIBUTE = "data-intent-changed";
14
+ export const ROW_ID_ATTRIBUTE = "data-row-id";
15
+ export const COLUMN_ID_ATTRIBUTE = "data-col-id";
16
+
17
+ const INPUT_ROLES: Readonly<Record<string, string>> = {
18
+ checkbox: "checkbox",
19
+ radio: "radio",
20
+ range: "slider",
21
+ number: "spinbutton",
22
+ search: "searchbox",
23
+ button: "button",
24
+ submit: "button",
25
+ reset: "button",
26
+ };
27
+
28
+ const TAG_ROLES: Readonly<Record<string, string>> = {
29
+ button: "button",
30
+ textarea: "textbox",
31
+ tr: "row",
32
+ td: "cell",
33
+ th: "columnheader",
34
+ table: "table",
35
+ article: "article",
36
+ fieldset: "group",
37
+ form: "form",
38
+ dialog: "dialog",
39
+ li: "listitem",
40
+ nav: "navigation",
41
+ section: "region",
42
+ };
43
+
44
+ const GENERIC_ROLE = "generic";
45
+
46
+ const isNonEmpty = (value: string | undefined): value is string =>
47
+ value !== undefined && value !== "";
48
+
49
+ export function intentAttributes(props: IntentProps): IntentDataAttributes {
50
+ if (!isNonEmpty(props.intent)) return {};
51
+ if (!isNonEmpty(props.intentKey)) return { [INTENT_ATTRIBUTE]: props.intent };
52
+ return { [INTENT_ATTRIBUTE]: props.intent, [INTENT_KEY_ATTRIBUTE]: props.intentKey };
53
+ }
54
+
55
+ export function intentTargetRef(props: IntentProps): IntentTargetRef | undefined {
56
+ if (!isNonEmpty(props.intent)) return undefined;
57
+ if (!isNonEmpty(props.intentKey)) return { intent: props.intent };
58
+ return { intent: props.intent, key: props.intentKey };
59
+ }
60
+
61
+ const selectRole = (source: RoleSource): string => {
62
+ const size = Number(source.getAttribute("size"));
63
+ return source.getAttribute("multiple") !== null || size > 1 ? "listbox" : "combobox";
64
+ };
65
+
66
+ const inputRole = (source: RoleSource): string =>
67
+ INPUT_ROLES[(source.getAttribute("type") ?? "").toLowerCase()] ?? "textbox";
68
+
69
+ export function implicitRoleOf(source: RoleSource): string {
70
+ const tag = source.tagName.toLowerCase();
71
+ if (tag === "a" || tag === "area") {
72
+ return source.getAttribute("href") === null ? GENERIC_ROLE : "link";
73
+ }
74
+ if (tag === "input") return inputRole(source);
75
+ if (tag === "select") return selectRole(source);
76
+ return TAG_ROLES[tag] ?? GENERIC_ROLE;
77
+ }
78
+
79
+ const nonEmptyOrUndefined = (value: string | null | undefined): string | undefined =>
80
+ value === null || value === undefined || value.trim() === "" ? undefined : value.trim();
81
+
82
+ const firstRoleToken = (value: string | null): string | undefined =>
83
+ nonEmptyOrUndefined(value?.split(/\s+/)[0]);
84
+
85
+ export function resolveExpectation(
86
+ input: IntentExpectationInput | undefined,
87
+ source: RoleSource,
88
+ ): IntentSemanticExpectation {
89
+ return {
90
+ role:
91
+ nonEmptyOrUndefined(input?.role) ??
92
+ firstRoleToken(source.getAttribute("role")) ??
93
+ implicitRoleOf(source),
94
+ requireName: input?.requireName ?? true,
95
+ };
96
+ }
@@ -0,0 +1,25 @@
1
+ "use client";
2
+
3
+ import { createContext, type ReactElement, type ReactNode, useContext } from "react";
4
+ import type { IntentBridge } from "./types.js";
5
+
6
+ export const noopIntentBridge: IntentBridge = {
7
+ registerTarget: () => () => {},
8
+ };
9
+
10
+ const IntentBridgeContext = createContext<IntentBridge>(noopIntentBridge);
11
+
12
+ export function IntentBridgeProvider(props: {
13
+ bridge: IntentBridge;
14
+ children: ReactNode;
15
+ }): ReactElement {
16
+ return (
17
+ <IntentBridgeContext.Provider value={props.bridge}>
18
+ {props.children}
19
+ </IntentBridgeContext.Provider>
20
+ );
21
+ }
22
+
23
+ export function useIntentBridge(): IntentBridge {
24
+ return useContext(IntentBridgeContext);
25
+ }
@@ -0,0 +1,24 @@
1
+ export {
2
+ COLUMN_ID_ATTRIBUTE,
3
+ INTENT_ATTRIBUTE,
4
+ INTENT_CHANGED_ATTRIBUTE,
5
+ INTENT_HIGHLIGHT_ATTRIBUTE,
6
+ INTENT_KEY_ATTRIBUTE,
7
+ implicitRoleOf,
8
+ intentAttributes,
9
+ intentTargetRef,
10
+ ROW_ID_ATTRIBUTE,
11
+ resolveExpectation,
12
+ } from "./attributes.js";
13
+ export { IntentBridgeProvider, noopIntentBridge, useIntentBridge } from "./bridge.js";
14
+ export type {
15
+ IntentBridge,
16
+ IntentDataAttributes,
17
+ IntentExpectationInput,
18
+ IntentProps,
19
+ IntentSemanticExpectation,
20
+ IntentTargetBinder,
21
+ IntentTargetRef,
22
+ RoleSource,
23
+ } from "./types.js";
24
+ export { useIntentTarget, useIntentTargets } from "./use-intent-target.js";
@@ -0,0 +1,127 @@
1
+ import { isProduction } from "../utils/is-production.js";
2
+ import type { IntentBridge, IntentSemanticExpectation, IntentTargetRef } from "./types.js";
3
+
4
+ const IDENTITY_SEPARATOR = "\u0000";
5
+
6
+ interface Registration {
7
+ readonly identity: string;
8
+ readonly element: Element;
9
+ readonly expectation: IntentSemanticExpectation;
10
+ readonly unregister: () => void;
11
+ released: boolean;
12
+ }
13
+
14
+ export interface BridgeRegistrations {
15
+ readonly byIdentity: Map<string, Registration[]>;
16
+ readonly awaitingSweep: Set<Registration>;
17
+ readonly warnedDuplicates: Set<string>;
18
+ }
19
+
20
+ const registrationsByBridge = new WeakMap<IntentBridge, BridgeRegistrations>();
21
+
22
+ export function registrationsOf(bridge: IntentBridge): BridgeRegistrations {
23
+ const existing = registrationsByBridge.get(bridge);
24
+ if (existing) return existing;
25
+ const created: BridgeRegistrations = {
26
+ byIdentity: new Map(),
27
+ awaitingSweep: new Set(),
28
+ warnedDuplicates: new Set(),
29
+ };
30
+ registrationsByBridge.set(bridge, created);
31
+ return created;
32
+ }
33
+
34
+ const identityOf = (ref: IntentTargetRef): string =>
35
+ `${ref.intent}${IDENTITY_SEPARATOR}${ref.key ?? ""}`;
36
+
37
+ const sameExpectation = (a: IntentSemanticExpectation, b: IntentSemanticExpectation): boolean =>
38
+ a.role === b.role && a.requireName === b.requireName;
39
+
40
+ function reportBridgeError(error: unknown): void {
41
+ if (typeof globalThis.reportError === "function") globalThis.reportError(error);
42
+ else console.error(error);
43
+ }
44
+
45
+ function drop(state: BridgeRegistrations, entry: Registration): void {
46
+ state.awaitingSweep.delete(entry);
47
+ const list = state.byIdentity.get(entry.identity);
48
+ const index = list ? list.indexOf(entry) : -1;
49
+ if (!list || index < 0) return;
50
+ list.splice(index, 1);
51
+ if (list.length === 0) state.byIdentity.delete(entry.identity);
52
+ try {
53
+ entry.unregister();
54
+ } catch (error) {
55
+ reportBridgeError(error);
56
+ }
57
+ }
58
+
59
+ function duplicateTargetWarning(ref: IntentTargetRef): string {
60
+ const key = ref.key === undefined ? "" : ` with key "${ref.key}"`;
61
+ return `Intent target "${ref.intent}"${key} is already registered on another element. An intent and key must name one element at a time.`;
62
+ }
63
+
64
+ function warnOnLiveDuplicate(
65
+ state: BridgeRegistrations,
66
+ ref: IntentTargetRef,
67
+ identity: string,
68
+ element: Element,
69
+ ): void {
70
+ if (isProduction() || state.warnedDuplicates.has(identity)) return;
71
+ const live = state.byIdentity.get(identity) ?? [];
72
+ if (!live.some((entry) => !entry.released && entry.element !== element)) return;
73
+ state.warnedDuplicates.add(identity);
74
+ console.warn(duplicateTargetWarning(ref));
75
+ }
76
+
77
+ function sweepDisconnected(state: BridgeRegistrations): void {
78
+ for (const entry of state.awaitingSweep) {
79
+ if (!entry.element.isConnected) drop(state, entry);
80
+ }
81
+ state.awaitingSweep.clear();
82
+ }
83
+
84
+ function revive(state: BridgeRegistrations, entry: Registration): Registration {
85
+ entry.released = false;
86
+ state.awaitingSweep.delete(entry);
87
+ return entry;
88
+ }
89
+
90
+ function releaseLater(state: BridgeRegistrations, entry: Registration): () => void {
91
+ return () => {
92
+ entry.released = true;
93
+ state.awaitingSweep.add(entry);
94
+ queueMicrotask(() => {
95
+ if (entry.released) drop(state, entry);
96
+ });
97
+ };
98
+ }
99
+
100
+ export function attachTarget(
101
+ bridge: IntentBridge,
102
+ ref: IntentTargetRef,
103
+ element: Element,
104
+ expectation: IntentSemanticExpectation,
105
+ ): () => void {
106
+ const state = registrationsOf(bridge);
107
+ const identity = identityOf(ref);
108
+ const released = (state.byIdentity.get(identity) ?? []).filter((entry) => entry.released);
109
+ const revivable = released.find(
110
+ (entry) => entry.element === element && sameExpectation(entry.expectation, expectation),
111
+ );
112
+ for (const entry of released) if (entry !== revivable) drop(state, entry);
113
+ if (element.isConnected) sweepDisconnected(state);
114
+ warnOnLiveDuplicate(state, ref, identity, element);
115
+ if (revivable) return releaseLater(state, revive(state, revivable));
116
+ const entry: Registration = {
117
+ identity,
118
+ element,
119
+ expectation,
120
+ unregister: bridge.registerTarget(ref, element, expectation),
121
+ released: false,
122
+ };
123
+ const list = state.byIdentity.get(identity);
124
+ if (list) list.push(entry);
125
+ else state.byIdentity.set(identity, [entry]);
126
+ return releaseLater(state, entry);
127
+ }
@@ -0,0 +1,44 @@
1
+ import type { RefCallback } from "react";
2
+
3
+ export interface IntentTargetRef {
4
+ readonly intent: string;
5
+ readonly key?: string;
6
+ }
7
+
8
+ export interface IntentSemanticExpectation {
9
+ readonly role: string;
10
+ readonly requireName: boolean;
11
+ }
12
+
13
+ export interface IntentBridge {
14
+ registerTarget(
15
+ ref: IntentTargetRef,
16
+ element: Element,
17
+ expectation: IntentSemanticExpectation,
18
+ ): () => void;
19
+ }
20
+
21
+ export interface IntentProps {
22
+ intent?: string | undefined;
23
+ intentKey?: string | undefined;
24
+ }
25
+
26
+ export interface IntentDataAttributes {
27
+ "data-intent"?: string;
28
+ "data-intent-key"?: string;
29
+ }
30
+
31
+ export interface IntentExpectationInput {
32
+ role?: string | undefined;
33
+ requireName?: boolean | undefined;
34
+ }
35
+
36
+ export interface RoleSource {
37
+ readonly tagName: string;
38
+ getAttribute(name: string): string | null;
39
+ }
40
+
41
+ export type IntentTargetBinder = <E extends Element = Element>(
42
+ props: IntentProps,
43
+ expectation?: IntentExpectationInput,
44
+ ) => RefCallback<E> | undefined;
@@ -0,0 +1,96 @@
1
+ "use client";
2
+
3
+ import { type RefCallback, useCallback, useMemo } from "react";
4
+ import { intentTargetRef, resolveExpectation } from "./attributes.js";
5
+ import { noopIntentBridge, useIntentBridge } from "./bridge.js";
6
+ import { attachTarget } from "./target-registrations.js";
7
+ import type {
8
+ IntentBridge,
9
+ IntentExpectationInput,
10
+ IntentProps,
11
+ IntentTargetBinder,
12
+ } from "./types.js";
13
+
14
+ const CACHE_SEPARATOR = "\u0000";
15
+
16
+ const ignoreElement: RefCallback<Element> = () => undefined;
17
+
18
+ function createTargetRef<E extends Element>(
19
+ bridge: IntentBridge,
20
+ props: IntentProps,
21
+ expectation: IntentExpectationInput | undefined,
22
+ ): RefCallback<E> | undefined {
23
+ const ref = intentTargetRef(props);
24
+ if (ref === undefined || bridge === noopIntentBridge) return undefined;
25
+ let current: (() => void) | undefined;
26
+ const release = () => {
27
+ const run = current;
28
+ current = undefined;
29
+ run?.();
30
+ };
31
+ return (element) => {
32
+ release();
33
+ if (element === null) return undefined;
34
+ current = attachTarget(bridge, ref, element, resolveExpectation(expectation, element));
35
+ return release;
36
+ };
37
+ }
38
+
39
+ export function useIntentTarget<E extends Element = Element>(
40
+ props: IntentProps,
41
+ expectation?: IntentExpectationInput,
42
+ ): RefCallback<E> {
43
+ const bridge = useIntentBridge();
44
+ const { intent, intentKey } = props;
45
+ const role = expectation?.role;
46
+ const requireName = expectation?.requireName;
47
+ return useMemo(
48
+ () =>
49
+ createTargetRef<E>(bridge, { intent, intentKey }, { role, requireName }) ??
50
+ (ignoreElement as RefCallback<E>),
51
+ [bridge, intent, intentKey, role, requireName],
52
+ );
53
+ }
54
+
55
+ export function useIntentTargets(): IntentTargetBinder {
56
+ const bridge = useIntentBridge();
57
+ const bind = useCallback(
58
+ (cache: Map<string, RefCallback<Element>>): IntentTargetBinder =>
59
+ <E extends Element = Element>(
60
+ props: IntentProps,
61
+ expectation?: IntentExpectationInput,
62
+ ): RefCallback<E> | undefined => {
63
+ const ref = intentTargetRef(props);
64
+ if (ref === undefined) return undefined;
65
+ const cacheKey = [
66
+ ref.intent,
67
+ ref.key ?? "",
68
+ expectation?.role ?? "",
69
+ String(expectation?.requireName ?? true),
70
+ ].join(CACHE_SEPARATOR);
71
+ const cached = cache.get(cacheKey);
72
+ if (cached !== undefined) return cached as RefCallback<E>;
73
+ const inner = createTargetRef<Element>(bridge, props, expectation);
74
+ if (inner === undefined) return undefined;
75
+ const forget = () => {
76
+ if (cache.get(cacheKey) === bound) cache.delete(cacheKey);
77
+ };
78
+ const bound: RefCallback<Element> = (element) => {
79
+ const release = inner(element);
80
+ if (element === null) {
81
+ forget();
82
+ return undefined;
83
+ }
84
+ cache.set(cacheKey, bound);
85
+ return () => {
86
+ forget();
87
+ if (typeof release === "function") release();
88
+ };
89
+ };
90
+ cache.set(cacheKey, bound);
91
+ return bound as RefCallback<E>;
92
+ },
93
+ [bridge],
94
+ );
95
+ return useMemo(() => bind(new Map()), [bind]);
96
+ }
@@ -1,21 +1,28 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
3
+ import type { ComponentPropsWithRef, ReactNode, RefCallback } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { ChevronRight } from "../../icons/index.js";
6
+ import {
7
+ type IntentDataAttributes,
8
+ type IntentProps,
9
+ intentAttributes,
10
+ useIntentTargets,
11
+ } from "../../intent/index.js";
6
12
  import type { ClassNames } from "../../utils/class-names.js";
7
13
  import { cn } from "../../utils/cn.js";
8
14
 
9
- export interface BreadcrumbItem {
15
+ export interface BreadcrumbItem extends IntentProps {
10
16
  label: ReactNode;
11
17
  /** Destination. Omit it on the last item, or on a crumb that is not navigable. */
12
18
  href?: string;
13
19
  }
14
20
 
15
- export interface BreadcrumbLinkProps {
21
+ export interface BreadcrumbLinkProps extends IntentDataAttributes {
16
22
  href: string;
17
23
  className: string;
18
24
  children: ReactNode;
25
+ ref?: RefCallback<HTMLElement> | undefined;
19
26
  }
20
27
 
21
28
  /** Renders a breadcrumb link; inject your router's link component here. */
@@ -23,7 +30,7 @@ export type BreadcrumbRenderLink = (props: BreadcrumbLinkProps) => ReactNode;
23
30
 
24
31
  export type BreadcrumbsPart = "root" | "list" | "item" | "link" | "current" | "separator";
25
32
 
26
- export interface BreadcrumbsProps extends Omit<ComponentPropsWithoutRef<"nav">, "children"> {
33
+ export interface BreadcrumbsProps extends Omit<ComponentPropsWithRef<"nav">, "children"> {
27
34
  /** Trail in order; the last entry is the current page. */
28
35
  items: readonly BreadcrumbItem[];
29
36
  /** Link renderer; defaults to a plain anchor. */
@@ -50,6 +57,7 @@ export function Breadcrumbs({
50
57
  ...props
51
58
  }: BreadcrumbsProps) {
52
59
  const strings = useUiStrings();
60
+ const bind = useIntentTargets();
53
61
  const lastIndex = items.length - 1;
54
62
  return (
55
63
  <nav
@@ -65,11 +73,14 @@ export function Breadcrumbs({
65
73
  >
66
74
  {items.map((item, index) => {
67
75
  const current = index === lastIndex;
76
+ const target = { intent: item.intent, intentKey: item.intentKey };
68
77
  return (
69
78
  // biome-ignore lint/suspicious/noArrayIndexKey: crumbs are positional and may share a label
70
79
  <li key={index} className={cn("inline-flex items-center gap-1.5", classNames?.item)}>
71
80
  {current || item.href === undefined ? (
72
81
  <span
82
+ {...intentAttributes(target)}
83
+ ref={bind<HTMLSpanElement>(target, { requireName: false })}
73
84
  aria-current={current ? "page" : undefined}
74
85
  className={cn(current && "font-semibold text-ink", classNames?.current)}
75
86
  >
@@ -77,9 +88,11 @@ export function Breadcrumbs({
77
88
  </span>
78
89
  ) : (
79
90
  renderLink({
91
+ ...intentAttributes(target),
92
+ ref: bind<HTMLElement>(target),
80
93
  href: item.href,
81
94
  className: cn(
82
- "rounded-xs underline-offset-2 hover:text-ink hover:underline focus-visible:focus-ring",
95
+ "relative rounded-xs underline-offset-2 before:absolute before:-inset-y-1.5 before:inset-x-0 hover:text-ink hover:underline focus-visible:focus-ring",
83
96
  classNames?.link,
84
97
  ),
85
98
  children: item.label,
@@ -1,6 +1,7 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithoutRef, type RefObject, useEffect, useRef, useState } from "react";
3
+ import { type ComponentPropsWithRef, type RefObject, useEffect, useRef, useState } from "react";
4
+ import { intentAttributes, useIntentTargets } from "../../intent/index.js";
4
5
  import type { ClassNames } from "../../utils/class-names.js";
5
6
  import { cn } from "../../utils/cn.js";
6
7
  import { usePrefersReducedMotion } from "../../utils/reduced-motion.js";
@@ -8,7 +9,7 @@ import { pickActive, type TocItem } from "./model.js";
8
9
 
9
10
  export type FloatingTocPart = "root" | "title" | "list" | "item" | "link" | "label";
10
11
 
11
- export interface FloatingTocProps extends Omit<ComponentPropsWithoutRef<"nav">, "children"> {
12
+ export interface FloatingTocProps extends Omit<ComponentPropsWithRef<"nav">, "children"> {
12
13
  items: TocItem[];
13
14
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
14
15
  classNames?: ClassNames<FloatingTocPart>;
@@ -42,6 +43,7 @@ export function FloatingToc({
42
43
  ...props
43
44
  }: FloatingTocProps) {
44
45
  const reduced = usePrefersReducedMotion();
46
+ const bind = useIntentTargets();
45
47
  const [active, setActive] = useState<string | null>(items[0]?.id ?? null);
46
48
  const visible = useRef(new Set<string>());
47
49
  const activeRef = useRef(active);
@@ -104,9 +106,12 @@ export function FloatingToc({
104
106
  >
105
107
  {items.map((item) => {
106
108
  const current = item.id === active;
109
+ const target = { intent: item.intent, intentKey: item.intentKey ?? item.id };
107
110
  return (
108
111
  <li key={item.id} className={cn("min-w-0", classNames?.item)}>
109
112
  <a
113
+ {...intentAttributes(target)}
114
+ ref={bind<HTMLAnchorElement>(target)}
110
115
  href={`#${item.id}`}
111
116
  aria-current={current ? "location" : undefined}
112
117
  onClick={(event) => {
@@ -1,4 +1,6 @@
1
- export interface TocItem {
1
+ import type { IntentProps } from "../../intent/types.js";
2
+
3
+ export interface TocItem extends IntentProps {
2
4
  /** DOM id of the heading element. */
3
5
  id: string;
4
6
  label: string;
@@ -1,6 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import { type ComponentPropsWithRef, createContext, type ReactNode, useContext } from "react";
4
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
4
5
  import { cn } from "../../utils/cn.js";
5
6
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
6
7
  import {
@@ -117,7 +118,9 @@ export function Segmented({
117
118
  );
118
119
  }
119
120
 
120
- export interface SegmentedItemProps extends Omit<ComponentPropsWithRef<"button">, "value"> {
121
+ export interface SegmentedItemProps
122
+ extends Omit<ComponentPropsWithRef<"button">, "value">,
123
+ IntentProps {
121
124
  value: string;
122
125
  }
123
126
 
@@ -126,9 +129,16 @@ export function SegmentedItem({
126
129
  value,
127
130
  disabled: disabledProp,
128
131
  onClick,
132
+ intent,
133
+ intentKey,
134
+ ref,
129
135
  ...props
130
136
  }: SegmentedItemProps) {
131
137
  const context = useContext(SegmentedContext);
138
+ const composedRef = useComposedRefs<HTMLButtonElement>(
139
+ ref,
140
+ useIntentTarget<HTMLButtonElement>({ intent, intentKey }, { role: "radio" }),
141
+ );
132
142
  if (!context) throw new Error("`SegmentedItem` must be used within `Segmented`");
133
143
  const pressed = context.value === value;
134
144
  const disabled = context.disabled || disabledProp;
@@ -147,14 +157,16 @@ export function SegmentedItem({
147
157
  data-state={pressed ? "on" : "off"}
148
158
  data-disabled={disabled ? "" : undefined}
149
159
  disabled={disabled}
160
+ {...intentAttributes({ intent, intentKey })}
150
161
  {...props}
151
162
  {...item}
163
+ ref={composedRef}
152
164
  onClick={composeHandlers(onClick, () => {
153
165
  if (!disabled)
154
166
  context.setValue(nextSegmentedValue(context.value, value, context.allowDeselect));
155
167
  })}
156
168
  className={cn(
157
- "inline-flex h-control-sm shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap rounded-button px-3.5 @max-[420px]:px-2.5 text-control text-ink-2 hover:text-ink data-[state=on]:bg-seg-on data-[state=on]:text-ink data-[state=on]:shadow-sel",
169
+ "inline-flex h-control-sm shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap rounded-button px-3.5 @max-[420px]:px-2.5 text-control text-ink-2 hover:text-ink disabled:cursor-not-allowed disabled:opacity-50 data-[state=on]:bg-seg-on data-[state=on]:text-ink data-[state=on]:shadow-sel",
158
170
  context.block && "h-control flex-1 shrink justify-center",
159
171
  className,
160
172
  )}