@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,13 +1,22 @@
1
1
  "use client";
2
2
 
3
- import type { CSSProperties, ReactNode } from "react";
3
+ import {
4
+ type CSSProperties,
5
+ type KeyboardEvent,
6
+ type ReactNode,
7
+ type RefObject,
8
+ useEffect,
9
+ useRef,
10
+ } from "react";
4
11
  import { Search } from "../../icons/index.js";
12
+ import { type IntentProps, intentAttributes, useIntentTargets } from "../../intent/index.js";
5
13
  import * as Command from "../../primitives/command/command.js";
6
14
  import type { ClassNames } from "../../utils/class-names.js";
7
15
  import { cn } from "../../utils/cn.js";
8
16
  import { type Material, materialClass } from "../../utils/material.js";
17
+ import { shouldSubmitQuery } from "./model.js";
9
18
 
10
- export interface CommandPaletteItem {
19
+ export interface CommandPaletteItem extends IntentProps {
11
20
  id: string;
12
21
  label: string;
13
22
  group: string;
@@ -25,6 +34,7 @@ export type CommandPalettePart =
25
34
  | "header"
26
35
  | "searchIcon"
27
36
  | "input"
37
+ | "inputEnd"
28
38
  | "closeKey"
29
39
  | "list"
30
40
  | "empty"
@@ -49,6 +59,9 @@ export interface CommandPaletteProps {
49
59
  /** Controlled query, so the parent can react to typing (e.g. debounced remote search). */
50
60
  query?: string;
51
61
  onQueryChange?: (query: string) => void;
62
+ onSubmitQuery?: (query: string) => void;
63
+ inputEnd?: ReactNode;
64
+ keepOpenOnSelect?: boolean;
52
65
  /**
53
66
  * Surface material. Omitted keeps the default for this layer; `"glass"` and `"glass-clear"`
54
67
  * are frosted glass, `"liquid"` and `"liquid-clear"` Liquid Glass (with its fallbacks), `"solid"`
@@ -73,6 +86,23 @@ function groupItems(items: CommandPaletteItem[]): [string, CommandPaletteItem[]]
73
86
  return [...groups.entries()];
74
87
  }
75
88
 
89
+ interface PaletteState {
90
+ search: string;
91
+ highlighted: string;
92
+ }
93
+
94
+ function StateMirror({ target }: { target: RefObject<PaletteState> }) {
95
+ const search = Command.useCommandState((state) => state.search);
96
+ const highlighted = Command.useCommandState((state) => state.value);
97
+ useEffect(() => {
98
+ target.current = { search, highlighted };
99
+ }, [target, search, highlighted]);
100
+ return null;
101
+ }
102
+
103
+ const isComposing = (event: KeyboardEvent): boolean =>
104
+ event.nativeEvent.isComposing || event.keyCode === 229;
105
+
76
106
  function ResultCount({ format }: { format: (count: number) => string }) {
77
107
  const count = Command.useCommandState((state) => state.filtered.count);
78
108
  return (
@@ -94,13 +124,31 @@ export function CommandPalette({
94
124
  closeKeyLabel = "Esc",
95
125
  query,
96
126
  onQueryChange,
127
+ onSubmitQuery,
128
+ inputEnd,
129
+ keepOpenOnSelect = false,
97
130
  material,
98
131
  className,
99
132
  style,
100
133
  classNames,
101
134
  }: CommandPaletteProps) {
135
+ const bindIntent = useIntentTargets();
136
+ const state = useRef<PaletteState>({ search: "", highlighted: "" });
137
+ const submitOnEnter = (event: KeyboardEvent<HTMLDivElement>) => {
138
+ if (!onSubmitQuery) return;
139
+ if (event.target instanceof Element && event.target.closest("[data-part='inputEnd']")) return;
140
+ const submit = shouldSubmitQuery({
141
+ key: event.key,
142
+ isComposing: isComposing(event),
143
+ ...state.current,
144
+ });
145
+ if (!submit) return;
146
+ event.preventDefault();
147
+ onSubmitQuery(state.current.search);
148
+ };
102
149
  return (
103
150
  <Command.Dialog
151
+ onKeyDown={submitOnEnter}
104
152
  open={open}
105
153
  onOpenChange={(next) => {
106
154
  if (!next) onClose();
@@ -134,6 +182,15 @@ export function CommandPalette({
134
182
  )}
135
183
  {...(onQueryChange ? { value: query ?? "", onValueChange: onQueryChange } : {})}
136
184
  />
185
+ {inputEnd === undefined ? null : (
186
+ <span
187
+ data-part="inputEnd"
188
+ data-ui-command-skip-keys=""
189
+ className={cn("shrink-0", classNames?.inputEnd)}
190
+ >
191
+ {inputEnd}
192
+ </span>
193
+ )}
137
194
  <span
138
195
  className={cn(
139
196
  "shrink-0 rounded-xs border-divider bg-surface-2 px-1.25 py-1 font-mono @max-[360px]/palette:hidden text-count text-ink-2",
@@ -143,6 +200,7 @@ export function CommandPalette({
143
200
  {closeKeyLabel}
144
201
  </span>
145
202
  </div>
203
+ <StateMirror target={state} />
146
204
  <ResultCount format={formatResultCount} />
147
205
  <Command.List
148
206
  className={cn("overflow-y-auto p-1.5 @min-[420px]/palette:p-2", classNames?.list)}
@@ -166,8 +224,13 @@ export function CommandPalette({
166
224
  keywords={[item.label, item.hint ?? "", ...(item.keywords ?? [])]}
167
225
  onSelect={() => {
168
226
  item.onSelect();
169
- onClose();
227
+ if (!keepOpenOnSelect) onClose();
170
228
  }}
229
+ {...intentAttributes({ intent: item.intent, intentKey: item.intentKey ?? item.id })}
230
+ ref={bindIntent(
231
+ { intent: item.intent, intentKey: item.intentKey ?? item.id },
232
+ { role: "option" },
233
+ )}
171
234
  className={cn(
172
235
  "flex w-full cursor-pointer items-center gap-2.5 rounded-control px-2.5 py-2 text-ink text-meta data-[selected=true]:bg-surface-2 [&_svg]:size-4 [&_svg]:text-ink-3",
173
236
  classNames?.item,
@@ -4,3 +4,4 @@ export {
4
4
  type CommandPalettePart,
5
5
  type CommandPaletteProps,
6
6
  } from "./command-palette.js";
7
+ export { type SubmitQueryInput, shouldSubmitQuery } from "./model.js";
@@ -0,0 +1,15 @@
1
+ export interface SubmitQueryInput {
2
+ key: string;
3
+ isComposing: boolean;
4
+ highlighted: string;
5
+ search: string;
6
+ }
7
+
8
+ export function shouldSubmitQuery({
9
+ key,
10
+ isComposing,
11
+ highlighted,
12
+ search,
13
+ }: SubmitQueryInput): boolean {
14
+ return key === "Enter" && !isComposing && highlighted === "" && search.trim() !== "";
15
+ }
@@ -144,6 +144,8 @@ export function Root({
144
144
  const keyDown = (event: ReactKeyboardEvent<HTMLDivElement>) => {
145
145
  onKeyDown?.(event);
146
146
  if (event.defaultPrevented) return;
147
+ if (event.target instanceof Element && event.target.closest("[data-ui-command-skip-keys]"))
148
+ return;
147
149
  if (event.nativeEvent.isComposing || event.keyCode === 229) return;
148
150
  const navigator = createNavigator(context);
149
151
  const key = event.key;
@@ -415,7 +417,8 @@ export function Item({
415
417
  onSelectRef.current = onSelect;
416
418
  });
417
419
  useLayoutEffect(() => {
418
- if (valueProp === undefined) setDerived(elementRef.current?.textContent?.trim() ?? "");
420
+ const text = elementRef.current?.textContent?.trim();
421
+ if (valueProp === undefined && text !== undefined) setDerived(text);
419
422
  });
420
423
  useLayoutEffect(() => () => store.removeItem(id), [store, id]);
421
424
  // biome-ignore lint/correctness/useExhaustiveDependencies: keywordsKey stands for keywords
@@ -12,6 +12,7 @@ import {
12
12
  useRef,
13
13
  } from "react";
14
14
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
15
+ import { isProduction } from "../../utils/is-production.js";
15
16
  import { Slot } from "../../utils/slot.js";
16
17
  import { useControllableState } from "../../utils/use-controllable-state.js";
17
18
  import { hideOthers } from "../hide-others.js";
@@ -52,10 +53,6 @@ function useDialogContext(part: string): DialogContextValue {
52
53
  return context;
53
54
  }
54
55
 
55
- function isProduction(): boolean {
56
- return typeof process !== "undefined" && process.env?.NODE_ENV === "production";
57
- }
58
-
59
56
  const stateOf = (open: boolean) => (open ? "open" : "closed");
60
57
 
61
58
  export interface DialogRootProps {
@@ -4,6 +4,7 @@ import {
4
4
  type ComponentProps,
5
5
  createContext,
6
6
  type ReactNode,
7
+ useCallback,
7
8
  useContext,
8
9
  useLayoutEffect,
9
10
  useMemo,
@@ -35,7 +36,7 @@ import {
35
36
 
36
37
  interface PopperContextValue {
37
38
  anchor: HTMLElement | null;
38
- setAnchor: (node: HTMLElement | null) => void;
39
+ registerAnchor: (node: HTMLElement) => () => void;
39
40
  arrow: ArrowGeometry | null;
40
41
  setArrow: (arrow: ArrowGeometry | null) => void;
41
42
  }
@@ -49,9 +50,17 @@ function usePopperContext(part: string): PopperContextValue {
49
50
  }
50
51
 
51
52
  export function Root({ children }: { children?: ReactNode }) {
52
- const [anchor, setAnchor] = useState<HTMLElement | null>(null);
53
+ const [anchors, setAnchors] = useState<HTMLElement[]>([]);
53
54
  const [arrow, setArrow] = useState<ArrowGeometry | null>(null);
54
- const value = useMemo(() => ({ anchor, setAnchor, arrow, setArrow }), [anchor, arrow]);
55
+ const registerAnchor = useCallback((node: HTMLElement) => {
56
+ setAnchors((current) => [...current.filter((candidate) => candidate !== node), node]);
57
+ return () => setAnchors((current) => current.filter((candidate) => candidate !== node));
58
+ }, []);
59
+ const anchor = anchors.at(-1) ?? null;
60
+ const value = useMemo(
61
+ () => ({ anchor, registerAnchor, arrow, setArrow }),
62
+ [anchor, registerAnchor, arrow],
63
+ );
55
64
  return <PopperContext.Provider value={value}>{children}</PopperContext.Provider>;
56
65
  }
57
66
 
@@ -61,8 +70,10 @@ export interface PopperAnchorProps extends ComponentProps<"div"> {
61
70
 
62
71
  /** The element the content is positioned against. */
63
72
  export function Anchor({ asChild, ref, ...props }: PopperAnchorProps) {
64
- const { setAnchor } = usePopperContext("PopperAnchor");
65
- const composedRef = useComposedRefs<HTMLDivElement>(ref, setAnchor);
73
+ const { registerAnchor } = usePopperContext("PopperAnchor");
74
+ const [node, setNode] = useState<HTMLDivElement | null>(null);
75
+ const composedRef = useComposedRefs<HTMLDivElement>(ref, setNode);
76
+ useLayoutEffect(() => (node ? registerAnchor(node) : undefined), [node, registerAnchor]);
66
77
  const Comp = asChild ? Slot : "div";
67
78
  return <Comp {...props} ref={composedRef as never} />;
68
79
  }
@@ -3,6 +3,7 @@
3
3
  import { type ReactNode, useState } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { Menu } from "../../icons/index.js";
6
+ import { intentAttributes, useIntentTargets } from "../../intent/index.js";
6
7
  import { Drawer, DrawerContent, DrawerTitle } from "../../overlays/drawer/index.js";
7
8
  import type { ClassNames } from "../../utils/class-names.js";
8
9
  import { cn } from "../../utils/cn.js";
@@ -114,6 +115,7 @@ export function BottomNav({
114
115
  classNames,
115
116
  }: BottomNavProps) {
116
117
  const strings = useUiStrings();
118
+ const bind = useIntentTargets();
117
119
  const [moreOpen, setMoreOpen] = useState(false);
118
120
  const { visible, overflow } = splitBottomNavItems(items, maxSlots);
119
121
  const more = moreLabel ?? strings.more;
@@ -149,34 +151,39 @@ export function BottomNav({
149
151
  classNames?.list,
150
152
  )}
151
153
  >
152
- {visible.map((item) => (
153
- <li key={item.id} className={classNames?.item}>
154
- {renderLink({
155
- href: item.href,
156
- "aria-current": item.active ? "page" : undefined,
157
- className: slotClasses,
158
- children: (
159
- <>
160
- <span className="relative">
161
- {item.icon}
162
- {item.badge !== undefined ? (
163
- <>
164
- <BadgeMark
165
- count={numericBadge(item.badge)}
166
- danger={item.badgeTone === "danger"}
167
- asDot={badgeStyle === "dot"}
168
- className={classNames?.badge}
169
- />
170
- <span className="sr-only">{item.badgeLabel ?? item.badge}</span>
171
- </>
172
- ) : null}
173
- </span>
174
- <span className="max-w-full truncate">{item.label}</span>
175
- </>
176
- ),
177
- })}
178
- </li>
179
- ))}
154
+ {visible.map((item) => {
155
+ const target = { intent: item.intent, intentKey: item.intentKey ?? item.id };
156
+ return (
157
+ <li key={item.id} className={classNames?.item}>
158
+ {renderLink({
159
+ ...intentAttributes(target),
160
+ ref: bind<HTMLElement>(target),
161
+ href: item.href,
162
+ "aria-current": item.active ? "page" : undefined,
163
+ className: slotClasses,
164
+ children: (
165
+ <>
166
+ <span className="relative">
167
+ {item.icon}
168
+ {item.badge !== undefined ? (
169
+ <>
170
+ <BadgeMark
171
+ count={numericBadge(item.badge)}
172
+ danger={item.badgeTone === "danger"}
173
+ asDot={badgeStyle === "dot"}
174
+ className={classNames?.badge}
175
+ />
176
+ <span className="sr-only">{item.badgeLabel ?? item.badge}</span>
177
+ </>
178
+ ) : null}
179
+ </span>
180
+ <span className="max-w-full truncate">{item.label}</span>
181
+ </>
182
+ ),
183
+ })}
184
+ </li>
185
+ );
186
+ })}
180
187
  {overflow.length > 0 ? (
181
188
  <li className={classNames?.item}>
182
189
  <button
@@ -216,33 +223,38 @@ export function BottomNav({
216
223
  >
217
224
  <DrawerTitle className="font-semibold text-lede">{more}</DrawerTitle>
218
225
  <nav aria-label={more} className="flex flex-col gap-px">
219
- {overflow.map((item) => (
220
- <div key={item.id}>
221
- {renderLink({
222
- href: item.href,
223
- "aria-current": item.active ? "page" : undefined,
224
- onClick: () => setMoreOpen(false),
225
- className: cn(
226
- "flex min-h-11 items-center gap-2.5 rounded-control px-2.5 py-2 text-control text-ink-2 hover:bg-surface-2 hover:text-ink focus-visible:focus-ring aria-[current=page]:bg-accent-soft aria-[current=page]:font-bold aria-[current=page]:text-accent-ink [&_svg]:size-4.25 [&_svg]:shrink-0",
227
- classNames?.moreLink,
228
- ),
229
- children: (
230
- <>
231
- {item.icon}
232
- <span className="min-w-0 truncate">{item.label}</span>
233
- {item.badge !== undefined ? (
234
- <span className="ml-auto shrink-0 rounded-chip bg-surface-2 px-1.5 py-0.75 text-count text-ink-2">
235
- {item.badge}
236
- {item.badgeLabel ? (
237
- <span className="sr-only"> {item.badgeLabel}</span>
238
- ) : null}
239
- </span>
240
- ) : null}
241
- </>
242
- ),
243
- })}
244
- </div>
245
- ))}
226
+ {overflow.map((item) => {
227
+ const target = { intent: item.intent, intentKey: item.intentKey ?? item.id };
228
+ return (
229
+ <div key={item.id}>
230
+ {renderLink({
231
+ ...intentAttributes(target),
232
+ ref: bind<HTMLElement>(target),
233
+ href: item.href,
234
+ "aria-current": item.active ? "page" : undefined,
235
+ onClick: () => setMoreOpen(false),
236
+ className: cn(
237
+ "flex min-h-11 items-center gap-2.5 rounded-control px-2.5 py-2 text-control text-ink-2 hover:bg-surface-2 hover:text-ink focus-visible:focus-ring aria-[current=page]:bg-accent-soft aria-[current=page]:font-bold aria-[current=page]:text-accent-ink [&_svg]:size-4.25 [&_svg]:shrink-0",
238
+ classNames?.moreLink,
239
+ ),
240
+ children: (
241
+ <>
242
+ {item.icon}
243
+ <span className="min-w-0 truncate">{item.label}</span>
244
+ {item.badge !== undefined ? (
245
+ <span className="ml-auto shrink-0 rounded-chip bg-surface-2 px-1.5 py-0.75 text-count text-ink-2">
246
+ {item.badge}
247
+ {item.badgeLabel ? (
248
+ <span className="sr-only"> {item.badgeLabel}</span>
249
+ ) : null}
250
+ </span>
251
+ ) : null}
252
+ </>
253
+ ),
254
+ })}
255
+ </div>
256
+ );
257
+ })}
246
258
  </nav>
247
259
  {moreFooter ? (
248
260
  <div className={cn("mt-auto border-t-divider pt-3", classNames?.moreFooter)}>
@@ -1,26 +1,40 @@
1
1
  "use client";
2
2
 
3
- import { type CSSProperties, type ReactNode, useEffect, useId, useRef } from "react";
3
+ import {
4
+ type CSSProperties,
5
+ type ReactNode,
6
+ type RefCallback,
7
+ useEffect,
8
+ useId,
9
+ useRef,
10
+ } from "react";
4
11
  import { ChevronDown } from "../../icons/index.js";
12
+ import {
13
+ type IntentDataAttributes,
14
+ type IntentProps,
15
+ intentAttributes,
16
+ useIntentTargets,
17
+ } from "../../intent/index.js";
5
18
  import type { ClassNames } from "../../utils/class-names.js";
6
19
  import { cn } from "../../utils/cn.js";
7
20
  import { type Material, materialClass } from "../../utils/material.js";
8
21
  import { useControllableState } from "../../utils/use-controllable-state.js";
9
22
  import { useAppShell, useCompactContainer } from "../app-shell/app-shell.js";
10
23
 
11
- export interface SidebarLinkProps {
24
+ export interface SidebarLinkProps extends IntentDataAttributes {
12
25
  href: string;
13
26
  className: string;
14
27
  children: ReactNode;
15
28
  "aria-current"?: "page";
16
29
  /** Set in rail mode, where the label is visually hidden. */
17
30
  title?: string;
31
+ ref?: RefCallback<HTMLElement> | undefined;
18
32
  }
19
33
 
20
34
  /** Renders a navigation link; inject your router's link component here. */
21
35
  export type SidebarRenderLink = (props: SidebarLinkProps) => ReactNode;
22
36
 
23
- export interface SidebarItem {
37
+ export interface SidebarItem extends IntentProps {
24
38
  id: string;
25
39
  label: string;
26
40
  href: string;
@@ -117,6 +131,7 @@ export function opensOnActivation(
117
131
 
118
132
  function SidebarGroupSection({ group, rail, renderLink, classNames }: SidebarGroupSectionProps) {
119
133
  const itemsId = useId();
134
+ const bind = useIntentTargets();
120
135
  const collapsible = group.collapsible === true && !rail;
121
136
  const holdsActive = group.items.some((item) => item.active);
122
137
  const [collapsedState, setCollapsed] = useControllableState<boolean>({
@@ -140,7 +155,7 @@ function SidebarGroupSection({ group, rail, renderLink, classNames }: SidebarGro
140
155
  aria-controls={itemsId}
141
156
  onClick={() => setCollapsed(!collapsed)}
142
157
  className={cn(
143
- "flex w-full items-center gap-1 rounded-control px-2.5 pb-1.5 text-left text-overline text-ink-3 hover:text-ink focus-visible:focus-ring",
158
+ "flex min-h-6 w-full items-center gap-1 rounded-control px-2.5 pb-1.5 text-left text-overline text-ink-3 hover:text-ink focus-visible:focus-ring",
144
159
  classNames?.groupLabel,
145
160
  classNames?.groupToggle,
146
161
  )}
@@ -170,9 +185,12 @@ function SidebarGroupSection({ group, rail, renderLink, classNames }: SidebarGro
170
185
  {group.items.map((item) => {
171
186
  const badgeTone =
172
187
  item.badgeTone === "danger" ? "bg-danger-soft text-danger" : "bg-surface-2 text-ink-2";
188
+ const target = { intent: item.intent, intentKey: item.intentKey ?? item.id };
173
189
  return (
174
190
  <div key={item.id} className={classNames?.item}>
175
191
  {renderLink({
192
+ ...intentAttributes(target),
193
+ ref: bind<HTMLElement>(target),
176
194
  href: item.href,
177
195
  "aria-current": item.active ? "page" : undefined,
178
196
  title: rail ? item.label : undefined,
@@ -1,3 +1,5 @@
1
+ "use client";
2
+
1
3
  import { type CSSProperties, createContext, type ReactNode, useContext } from "react";
2
4
  import { cn } from "../utils/cn.js";
3
5
 
@@ -0,0 +1,3 @@
1
+ export function isProduction(): boolean {
2
+ return typeof process !== "undefined" && process.env?.NODE_ENV === "production";
3
+ }
@@ -27,8 +27,10 @@ export function composeRefs<T>(...refs: Array<Ref<T> | undefined>): RefCallback<
27
27
  const cleanups: Array<() => void> = [];
28
28
  for (const ref of refs) {
29
29
  const result = typeof ref === "function" ? (ref as RefCallback<T>)(node) : undefined;
30
- if (typeof ref !== "function") setRef(ref, node);
31
- else if (typeof result === "function") cleanups.push(result as () => void);
30
+ if (typeof ref !== "function") {
31
+ setRef(ref, node);
32
+ cleanups.push(() => setRef(ref, null));
33
+ } else if (typeof result === "function") cleanups.push(result as () => void);
32
34
  else cleanups.push(() => setRef(ref, null));
33
35
  }
34
36
  return () => {
@@ -37,6 +39,22 @@ export function composeRefs<T>(...refs: Array<Ref<T> | undefined>): RefCallback<
37
39
  };
38
40
  }
39
41
 
42
+ type ComposedCache = WeakMap<object, RefCallback<never>>;
43
+
44
+ const pairCache = new WeakMap<object, ComposedCache>();
45
+
46
+ function composePair<T>(first: NonNullable<Ref<T>>, second: Ref<T> | undefined): Ref<T> {
47
+ if (second === undefined || second === null) return first;
48
+ const existing = pairCache.get(first);
49
+ const inner = existing ?? new WeakMap();
50
+ if (!existing) pairCache.set(first, inner);
51
+ const cached = inner.get(second);
52
+ if (cached) return cached as RefCallback<T>;
53
+ const composed = composeRefs(first, second);
54
+ inner.set(second, composed as RefCallback<never>);
55
+ return composed;
56
+ }
57
+
40
58
  function mergeProps(slotProps: AnyProps, childProps: AnyProps): AnyProps {
41
59
  const merged: AnyProps = { ...childProps };
42
60
  for (const name of Object.keys(childProps)) {
@@ -85,7 +103,7 @@ export function Slot({ children, ref, ...slotProps }: SlotProps) {
85
103
  const child = children as ReactElement<AnyProps & { ref?: Ref<HTMLElement> }>;
86
104
  const merged = mergeProps(slotProps, child.props);
87
105
  if (child.type !== Fragment) {
88
- merged.ref = ref ? composeRefs(ref, child.props.ref) : child.props.ref;
106
+ merged.ref = ref ? composePair(ref, child.props.ref) : child.props.ref;
89
107
  }
90
108
  return cloneElement(child, merged);
91
109
  }
package/styles/base.css CHANGED
@@ -33,6 +33,40 @@ body {
33
33
  outline-offset: var(--focus-ring-offset, 2px);
34
34
  }
35
35
 
36
+ @keyframes intent-highlight {
37
+ from {
38
+ background-color: var(--intent-highlight-tint, var(--accent-soft));
39
+ }
40
+ to {
41
+ background-color: transparent;
42
+ }
43
+ }
44
+
45
+ [data-intent-highlight] {
46
+ outline: var(--intent-highlight-width, 3px) solid
47
+ var(--intent-highlight-color, var(--focus-ring-color, var(--accent-ink)));
48
+ outline-offset: var(--intent-highlight-offset, 3px);
49
+ animation: intent-highlight var(--intent-highlight-duration, 350ms) ease-out;
50
+ }
51
+
52
+ [data-intent-changed] {
53
+ outline: 2px dashed var(--intent-highlight-color, var(--focus-ring-color, var(--accent-ink)));
54
+ outline-offset: var(--intent-highlight-offset, 3px);
55
+ }
56
+
57
+ @media (prefers-reduced-motion: reduce) {
58
+ [data-intent-highlight] {
59
+ animation: none;
60
+ }
61
+ }
62
+
63
+ @media (forced-colors: active) {
64
+ [data-intent-highlight],
65
+ [data-intent-changed] {
66
+ outline-color: Highlight;
67
+ }
68
+ }
69
+
36
70
  /* The menu surface itself takes programmatic focus and its items carry the visible ring, so the
37
71
  surface drops the ring normally. Under more contrast and forced colors it keeps it. */
38
72
  @media (not (prefers-contrast: more)) and (not (forced-colors: active)) {