@jcsoftdev/ui 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (459) hide show
  1. package/CHANGELOG.md +123 -0
  2. package/README.md +22 -3
  3. package/dist/ai/attachment/attachment.d.ts +4 -3
  4. package/dist/ai/attachment/attachment.js +5 -1
  5. package/dist/ai/chat-message/chat-message.d.ts +4 -3
  6. package/dist/ai/chat-message/chat-message.js +5 -0
  7. package/dist/ai/code-block/code-block.js +2 -2
  8. package/dist/ai/conversation/conversation.d.ts +2 -2
  9. package/dist/ai/internal/disclosure.js +1 -1
  10. package/dist/ai/internal/icon-action.d.ts +4 -3
  11. package/dist/ai/internal/icon-action.js +11 -2
  12. package/dist/ai/message-actions/message-actions.d.ts +6 -3
  13. package/dist/ai/message-actions/message-actions.js +26 -1
  14. package/dist/ai/prompt-input/prompt-input.d.ts +3 -2
  15. package/dist/ai/prompt-input/prompt-input.js +14 -4
  16. package/dist/ai/prompt-suggestion/prompt-suggestion.d.ts +5 -4
  17. package/dist/ai/prompt-suggestion/prompt-suggestion.js +4 -0
  18. package/dist/ai/source/source.d.ts +4 -3
  19. package/dist/ai/source/source.js +16 -1
  20. package/dist/ai/tool-call/tool-call.d.ts +3 -2
  21. package/dist/ai/tool-call/tool-call.js +5 -1
  22. package/dist/atoms/big-date/big-date.d.ts +2 -2
  23. package/dist/atoms/button/button.d.ts +3 -2
  24. package/dist/atoms/button/button.js +9 -0
  25. package/dist/atoms/checkbox/checkbox.d.ts +5 -3
  26. package/dist/atoms/checkbox/checkbox.js +29 -19
  27. package/dist/atoms/chip/chip.d.ts +3 -2
  28. package/dist/atoms/chip/chip.js +10 -1
  29. package/dist/atoms/divider/divider.d.ts +2 -2
  30. package/dist/atoms/elapsed-time/elapsed-time.d.ts +2 -2
  31. package/dist/atoms/elapsed-time/elapsed-time.js +10 -7
  32. package/dist/atoms/elapsed-time/model.d.ts +8 -0
  33. package/dist/atoms/elapsed-time/model.js +44 -0
  34. package/dist/atoms/icon-button/icon-button.d.ts +2 -1
  35. package/dist/atoms/internal/labelled-control.d.ts +16 -0
  36. package/dist/atoms/internal/labelled-control.js +56 -0
  37. package/dist/atoms/number-value/number-value.d.ts +2 -2
  38. package/dist/atoms/pressable-feedback/pressable-feedback.d.ts +4 -3
  39. package/dist/atoms/pressable-feedback/pressable-feedback.js +13 -1
  40. package/dist/atoms/progress/progress.d.ts +2 -2
  41. package/dist/atoms/radio-group/radio-group-primitive.d.ts +3 -2
  42. package/dist/atoms/radio-group/radio-group-primitive.js +10 -1
  43. package/dist/atoms/radio-group/radio-group.d.ts +2 -0
  44. package/dist/atoms/radio-group/radio-group.js +3 -1
  45. package/dist/atoms/seal/seal.d.ts +2 -2
  46. package/dist/atoms/status-pill/status-pill.js +1 -1
  47. package/dist/atoms/switch/switch.d.ts +7 -4
  48. package/dist/atoms/switch/switch.js +35 -5
  49. package/dist/atoms/table-glyph/table-glyph.d.ts +2 -2
  50. package/dist/atoms/trend-chip/trend-chip.d.ts +2 -2
  51. package/dist/auth/login-form/parts.js +2 -2
  52. package/dist/calendar/date-calendar/date-calendar.js +1 -1
  53. package/dist/calendar/day-chip/day-chip.d.ts +3 -2
  54. package/dist/calendar/day-chip/day-chip.js +12 -1
  55. package/dist/calendar/event-block/event-block.d.ts +3 -2
  56. package/dist/calendar/event-block/event-block.js +7 -0
  57. package/dist/calendar/internal/grid-navigation.d.ts +11 -0
  58. package/dist/calendar/internal/grid-navigation.js +34 -0
  59. package/dist/calendar/internal/intent.d.ts +3 -0
  60. package/dist/calendar/internal/intent.js +7 -0
  61. package/dist/calendar/internal/month-model.d.ts +11 -0
  62. package/dist/calendar/internal/month-model.js +11 -0
  63. package/dist/calendar/internal/types.d.ts +4 -0
  64. package/dist/calendar/month-view/month-grid.d.ts +27 -0
  65. package/dist/calendar/month-view/month-grid.js +210 -0
  66. package/dist/calendar/month-view/month-view.d.ts +3 -1
  67. package/dist/calendar/month-view/month-view.js +29 -131
  68. package/dist/calendar/week-view/week-view.d.ts +3 -1
  69. package/dist/calendar/week-view/week-view.js +218 -128
  70. package/dist/charts/bar-chart/bar-race-chart.js +1 -1
  71. package/dist/charts/core/breadcrumb.js +1 -1
  72. package/dist/charts/core/chart-states.js +1 -1
  73. package/dist/charts/core/distribution/xy-points.js +4 -2
  74. package/dist/charts/crossfilter/crossfilter.js +1 -1
  75. package/dist/charts/gantt-chart/gantt-chart.js +1 -1
  76. package/dist/charts/maps/geo/map-data-table.js +1 -1
  77. package/dist/charts/sankey-chart/sankey-chart.js +1 -3
  78. package/dist/charts/tree-chart/tree-chart.js +1 -1
  79. package/dist/containers/action-bar/action-bar.d.ts +2 -2
  80. package/dist/containers/action-bar/action-bar.js +1 -1
  81. package/dist/containers/aside/aside.d.ts +3 -3
  82. package/dist/containers/banner/banner.d.ts +2 -2
  83. package/dist/containers/card/card.d.ts +5 -5
  84. package/dist/containers/card/card.js +3 -1
  85. package/dist/containers/carousel/carousel.d.ts +2 -2
  86. package/dist/containers/carousel/carousel.js +2 -2
  87. package/dist/containers/cols/cols.d.ts +3 -3
  88. package/dist/containers/comment/comment.d.ts +2 -2
  89. package/dist/containers/confirm-action/confirm-action.d.ts +3 -2
  90. package/dist/containers/confirm-action/confirm-action.js +10 -2
  91. package/dist/containers/dashboard/dashboard.d.ts +4 -4
  92. package/dist/containers/data-grid/column-menu.js +1 -1
  93. package/dist/containers/data-grid/data-grid.d.ts +7 -3
  94. package/dist/containers/data-grid/data-grid.js +45 -7
  95. package/dist/containers/data-grid/formula-bar.js +1 -1
  96. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  97. package/dist/containers/data-grid/tool-panel.js +1 -1
  98. package/dist/containers/description-list/description-list.d.ts +2 -2
  99. package/dist/containers/detail-header/detail-header.d.ts +2 -2
  100. package/dist/containers/facts/facts.d.ts +2 -2
  101. package/dist/containers/feed/feed.d.ts +5 -4
  102. package/dist/containers/feed/feed.js +12 -0
  103. package/dist/containers/file-tree/file-tree.js +11 -0
  104. package/dist/containers/file-tree/model.d.ts +2 -0
  105. package/dist/containers/filter-bar/filter-bar.d.ts +2 -2
  106. package/dist/containers/floor-plan/floor-plan.d.ts +2 -0
  107. package/dist/containers/floor-plan/floor-plan.js +17 -9
  108. package/dist/containers/floor-plan/index.d.ts +1 -1
  109. package/dist/containers/floor-plan/index.js +6 -1
  110. package/dist/containers/floor-plan/model.d.ts +3 -0
  111. package/dist/containers/floor-plan/model.js +8 -0
  112. package/dist/containers/generic-row/generic-row.d.ts +8 -6
  113. package/dist/containers/generic-row/generic-row.js +3 -1
  114. package/dist/containers/grid/grid.d.ts +2 -2
  115. package/dist/containers/hbars/hbars.js +2 -2
  116. package/dist/containers/highlight-line/highlight-line.d.ts +2 -2
  117. package/dist/containers/item-card-group/item-card-group.d.ts +4 -2
  118. package/dist/containers/item-card-group/item-card-group.js +4 -0
  119. package/dist/containers/kanban/kanban.js +13 -0
  120. package/dist/containers/kanban/model.d.ts +2 -0
  121. package/dist/containers/kpi/kpi-model.d.ts +7 -0
  122. package/dist/containers/kpi/kpi-model.js +22 -0
  123. package/dist/containers/kpi/kpi-parts.d.ts +28 -0
  124. package/dist/containers/kpi/kpi-parts.js +121 -0
  125. package/dist/containers/kpi/kpi.d.ts +7 -30
  126. package/dist/containers/kpi/kpi.js +4 -119
  127. package/dist/containers/kpi-group/kpi-group.d.ts +2 -2
  128. package/dist/containers/list-detail/list-detail.d.ts +12 -11
  129. package/dist/containers/list-detail/list-detail.js +9 -1
  130. package/dist/containers/note/note.d.ts +2 -2
  131. package/dist/containers/order-ticket/index.d.ts +1 -1
  132. package/dist/containers/order-ticket/index.js +2 -0
  133. package/dist/containers/order-ticket/model.d.ts +6 -0
  134. package/dist/containers/order-ticket/model.js +9 -0
  135. package/dist/containers/order-ticket/order-ticket.d.ts +4 -3
  136. package/dist/containers/order-ticket/order-ticket.js +26 -10
  137. package/dist/containers/page/page.d.ts +2 -2
  138. package/dist/containers/page-header/back.d.ts +2 -2
  139. package/dist/containers/page-header/page-header.d.ts +6 -6
  140. package/dist/containers/pagination/cursor-pagination.d.ts +2 -2
  141. package/dist/containers/pagination/pagination.d.ts +2 -2
  142. package/dist/containers/pagination/pagination.js +2 -2
  143. package/dist/containers/resizable/resizable.d.ts +4 -4
  144. package/dist/containers/resizable/resizable.js +1 -1
  145. package/dist/containers/row-actions/row-actions.d.ts +4 -3
  146. package/dist/containers/row-actions/row-actions.js +14 -1
  147. package/dist/containers/scrolly/scrolly.js +1 -1
  148. package/dist/containers/section/section.d.ts +10 -9
  149. package/dist/containers/section/section.js +12 -0
  150. package/dist/containers/selectable-card/selectable-card.d.ts +3 -2
  151. package/dist/containers/selectable-card/selectable-card.js +10 -1
  152. package/dist/containers/settings-layout/settings-layout.d.ts +7 -6
  153. package/dist/containers/settings-layout/settings-layout.js +10 -1
  154. package/dist/containers/settings-row/settings-row.d.ts +4 -3
  155. package/dist/containers/settings-row/settings-row.js +4 -0
  156. package/dist/containers/shortcuts/shortcuts.d.ts +3 -3
  157. package/dist/containers/stack/stack.d.ts +2 -2
  158. package/dist/containers/table/table.d.ts +14 -13
  159. package/dist/containers/table/table.js +22 -4
  160. package/dist/containers/timeline/timeline.d.ts +5 -4
  161. package/dist/containers/timeline/timeline.js +12 -0
  162. package/dist/containers/toolbar/toolbar.d.ts +3 -3
  163. package/dist/forms/accent-picker/accent-picker.d.ts +5 -2
  164. package/dist/forms/accent-picker/accent-picker.js +22 -1
  165. package/dist/forms/checkbox-button-group/checkbox-button-group.d.ts +3 -2
  166. package/dist/forms/checkbox-button-group/checkbox-button-group.js +16 -0
  167. package/dist/forms/chip-group/chip-group.d.ts +4 -1
  168. package/dist/forms/chip-group/chip-group.js +20 -2
  169. package/dist/forms/combobox/combobox.d.ts +3 -2
  170. package/dist/forms/combobox/combobox.js +10 -1
  171. package/dist/forms/copy-field/copy-field.d.ts +4 -3
  172. package/dist/forms/copy-field/copy-field.js +7 -0
  173. package/dist/forms/date-picker/date-picker.d.ts +3 -2
  174. package/dist/forms/date-picker/date-picker.js +10 -1
  175. package/dist/forms/date-picker/date-time-picker.d.ts +3 -2
  176. package/dist/forms/date-picker/date-time-picker.js +4 -0
  177. package/dist/forms/dropzone/dropzone.d.ts +3 -2
  178. package/dist/forms/dropzone/dropzone.js +21 -3
  179. package/dist/forms/emoji-picker/emoji-picker.d.ts +3 -2
  180. package/dist/forms/emoji-picker/emoji-picker.js +9 -2
  181. package/dist/forms/emoji-reaction-button/emoji-reaction-button.d.ts +3 -2
  182. package/dist/forms/emoji-reaction-button/emoji-reaction-button.js +8 -1
  183. package/dist/forms/field/field.d.ts +2 -2
  184. package/dist/forms/fieldset/fieldset.d.ts +2 -2
  185. package/dist/forms/form/form.d.ts +6 -4
  186. package/dist/forms/form/form.js +10 -2
  187. package/dist/forms/form-footer/form-footer.d.ts +2 -2
  188. package/dist/forms/form-grid/form-grid.d.ts +3 -3
  189. package/dist/forms/form-section/form-section.d.ts +2 -2
  190. package/dist/forms/inline-select/inline-select.d.ts +4 -3
  191. package/dist/forms/inline-select/inline-select.js +9 -1
  192. package/dist/forms/input/input.d.ts +3 -2
  193. package/dist/forms/input/input.js +6 -1
  194. package/dist/forms/internal/button-option.d.ts +2 -0
  195. package/dist/forms/label/label.d.ts +2 -2
  196. package/dist/forms/native-select/native-select.d.ts +4 -3
  197. package/dist/forms/native-select/native-select.js +4 -0
  198. package/dist/forms/number-stepper/number-stepper.d.ts +2 -1
  199. package/dist/forms/number-stepper/number-stepper.js +13 -3
  200. package/dist/forms/password-input/password-input.d.ts +1 -1
  201. package/dist/forms/password-input/password-input.js +12 -0
  202. package/dist/forms/pin-input/pin-input.d.ts +3 -2
  203. package/dist/forms/pin-input/pin-input.js +8 -1
  204. package/dist/forms/radio-button-group/radio-button-group.d.ts +3 -2
  205. package/dist/forms/radio-button-group/radio-button-group.js +16 -0
  206. package/dist/forms/rating/rating.d.ts +3 -2
  207. package/dist/forms/rating/rating.js +12 -0
  208. package/dist/forms/select/select.d.ts +4 -3
  209. package/dist/forms/select/select.js +11 -2
  210. package/dist/forms/select-menu/select-menu.d.ts +3 -2
  211. package/dist/forms/select-menu/select-menu.js +10 -1
  212. package/dist/forms/slider/model.d.ts +1 -0
  213. package/dist/forms/slider/model.js +5 -0
  214. package/dist/forms/slider/slider.d.ts +2 -1
  215. package/dist/forms/slider/slider.js +12 -3
  216. package/dist/forms/textarea/textarea.d.ts +4 -3
  217. package/dist/forms/textarea/textarea.js +4 -2
  218. package/dist/forms/time-input/time-input.d.ts +4 -3
  219. package/dist/forms/time-input/time-input.js +13 -1
  220. package/dist/i18n/strings.d.ts +18 -0
  221. package/dist/i18n/strings.js +12 -0
  222. package/dist/intent/attributes.d.ts +11 -0
  223. package/dist/intent/attributes.js +77 -0
  224. package/dist/intent/bridge.d.ts +8 -0
  225. package/dist/intent/bridge.js +19 -0
  226. package/dist/intent/index.d.ts +4 -0
  227. package/dist/intent/index.js +31 -0
  228. package/dist/intent/target-registrations.d.ts +16 -0
  229. package/dist/intent/target-registrations.js +91 -0
  230. package/dist/intent/types.d.ts +29 -0
  231. package/dist/intent/types.js +0 -0
  232. package/dist/intent/use-intent-target.d.ts +4 -0
  233. package/dist/intent/use-intent-target.js +75 -0
  234. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +6 -4
  235. package/dist/navigation/breadcrumbs/breadcrumbs.js +11 -1
  236. package/dist/navigation/floating-toc/floating-toc.d.ts +2 -2
  237. package/dist/navigation/floating-toc/floating-toc.js +5 -0
  238. package/dist/navigation/floating-toc/model.d.ts +2 -1
  239. package/dist/navigation/segmented/segmented.d.ts +3 -2
  240. package/dist/navigation/segmented/segmented.js +11 -1
  241. package/dist/navigation/stepper/stepper.d.ts +4 -2
  242. package/dist/navigation/stepper/stepper.js +3 -0
  243. package/dist/navigation/tabs/tabs-nav.d.ts +5 -4
  244. package/dist/navigation/tabs/tabs-nav.js +11 -0
  245. package/dist/navigation/tabs/tabs.d.ts +5 -4
  246. package/dist/navigation/tabs/tabs.js +20 -1
  247. package/dist/navigation/wizard/wizard.d.ts +4 -3
  248. package/dist/navigation/wizard/wizard.js +9 -1
  249. package/dist/overlays/alert-dialog/alert-dialog.d.ts +5 -4
  250. package/dist/overlays/alert-dialog/alert-dialog.js +20 -3
  251. package/dist/overlays/context-menu/context-menu.d.ts +14 -12
  252. package/dist/overlays/context-menu/context-menu.js +57 -8
  253. package/dist/overlays/dialog/dialog.d.ts +9 -8
  254. package/dist/overlays/dialog/dialog.js +11 -0
  255. package/dist/overlays/drawer/drawer.d.ts +6 -5
  256. package/dist/overlays/drawer/drawer.js +11 -0
  257. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +14 -13
  258. package/dist/overlays/dropdown-menu/dropdown-menu.js +58 -5
  259. package/dist/overlays/hover-card/hover-card.d.ts +4 -3
  260. package/dist/overlays/hover-card/hover-card.js +12 -1
  261. package/dist/overlays/popover/popover.d.ts +3 -2
  262. package/dist/overlays/popover/popover.js +12 -1
  263. package/dist/overlays/tooltip/model.d.ts +1 -0
  264. package/dist/overlays/tooltip/model.js +8 -0
  265. package/dist/overlays/tooltip/tooltip.d.ts +2 -1
  266. package/dist/overlays/tooltip/tooltip.js +8 -2
  267. package/dist/palette/command-palette/command-palette.d.ts +8 -4
  268. package/dist/palette/command-palette/command-palette.js +49 -1
  269. package/dist/palette/command-palette/index.d.ts +1 -0
  270. package/dist/palette/command-palette/index.js +3 -1
  271. package/dist/palette/command-palette/model.d.ts +7 -0
  272. package/dist/palette/command-palette/model.js +11 -0
  273. package/dist/primitives/command/command.js +4 -1
  274. package/dist/primitives/dialog/dialog.js +1 -3
  275. package/dist/primitives/popper/popper.js +15 -4
  276. package/dist/shell/bottom-nav/bottom-nav.js +54 -42
  277. package/dist/shell/sidebar/sidebar.d.ts +5 -3
  278. package/dist/shell/sidebar/sidebar.js +14 -2
  279. package/dist/showcase/bento.js +1 -0
  280. package/dist/utils/is-production.d.ts +1 -0
  281. package/dist/utils/is-production.js +6 -0
  282. package/dist/utils/slot.js +17 -3
  283. package/package.json +2 -2
  284. package/src/ai/attachment/attachment.tsx +10 -3
  285. package/src/ai/chat-message/chat-message.tsx +10 -2
  286. package/src/ai/code-block/code-block.tsx +2 -2
  287. package/src/ai/conversation/conversation.tsx +2 -2
  288. package/src/ai/internal/disclosure.tsx +1 -1
  289. package/src/ai/internal/icon-action.tsx +14 -4
  290. package/src/ai/message-actions/message-actions.tsx +28 -3
  291. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  292. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  293. package/src/ai/source/source.tsx +17 -3
  294. package/src/ai/tool-call/tool-call.tsx +6 -1
  295. package/src/atoms/big-date/big-date.tsx +2 -2
  296. package/src/atoms/button/button.tsx +11 -1
  297. package/src/atoms/checkbox/checkbox.tsx +40 -21
  298. package/src/atoms/chip/chip.tsx +12 -2
  299. package/src/atoms/divider/divider.tsx +2 -2
  300. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  301. package/src/atoms/elapsed-time/model.ts +57 -0
  302. package/src/atoms/icon-button/icon-button.tsx +3 -1
  303. package/src/atoms/internal/labelled-control.tsx +83 -0
  304. package/src/atoms/number-value/number-value.tsx +2 -2
  305. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  306. package/src/atoms/progress/progress.tsx +2 -2
  307. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  308. package/src/atoms/radio-group/radio-group.tsx +5 -1
  309. package/src/atoms/seal/seal.tsx +2 -2
  310. package/src/atoms/status-pill/status-pill.tsx +1 -1
  311. package/src/atoms/switch/switch.tsx +43 -9
  312. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  313. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  314. package/src/auth/login-form/parts.tsx +2 -2
  315. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  316. package/src/calendar/day-chip/day-chip.tsx +14 -2
  317. package/src/calendar/event-block/event-block.tsx +9 -1
  318. package/src/calendar/internal/grid-navigation.ts +47 -0
  319. package/src/calendar/internal/intent.ts +10 -0
  320. package/src/calendar/internal/month-model.ts +23 -0
  321. package/src/calendar/internal/types.ts +4 -0
  322. package/src/calendar/month-view/month-grid.tsx +248 -0
  323. package/src/calendar/month-view/month-view.tsx +32 -148
  324. package/src/calendar/week-view/week-view.tsx +87 -10
  325. package/src/charts/README.md +10 -0
  326. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  327. package/src/charts/core/breadcrumb.tsx +1 -1
  328. package/src/charts/core/chart-states.tsx +1 -1
  329. package/src/charts/core/distribution/xy-points.tsx +4 -2
  330. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  331. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  332. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  333. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  334. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  335. package/src/containers/action-bar/action-bar.tsx +3 -3
  336. package/src/containers/aside/aside.tsx +3 -3
  337. package/src/containers/banner/banner.tsx +2 -2
  338. package/src/containers/card/card.tsx +7 -5
  339. package/src/containers/carousel/carousel.tsx +4 -4
  340. package/src/containers/cols/cols.tsx +3 -3
  341. package/src/containers/comment/comment.tsx +2 -2
  342. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  343. package/src/containers/dashboard/dashboard.tsx +4 -4
  344. package/src/containers/data-grid/column-menu.tsx +1 -1
  345. package/src/containers/data-grid/data-grid.tsx +53 -4
  346. package/src/containers/data-grid/formula-bar.tsx +1 -1
  347. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  348. package/src/containers/data-grid/tool-panel.tsx +1 -1
  349. package/src/containers/description-list/description-list.tsx +2 -2
  350. package/src/containers/detail-header/detail-header.tsx +2 -2
  351. package/src/containers/facts/facts.tsx +2 -2
  352. package/src/containers/feed/feed.tsx +16 -3
  353. package/src/containers/file-tree/file-tree.tsx +11 -0
  354. package/src/containers/file-tree/model.ts +2 -0
  355. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  356. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  357. package/src/containers/floor-plan/index.ts +7 -1
  358. package/src/containers/floor-plan/model.ts +16 -0
  359. package/src/containers/generic-row/generic-row.tsx +9 -6
  360. package/src/containers/grid/grid.tsx +2 -2
  361. package/src/containers/hbars/hbars.tsx +23 -21
  362. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  363. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  364. package/src/containers/kanban/kanban.tsx +13 -0
  365. package/src/containers/kanban/model.ts +2 -0
  366. package/src/containers/kpi/kpi-model.ts +37 -0
  367. package/src/containers/kpi/kpi-parts.tsx +153 -0
  368. package/src/containers/kpi/kpi.tsx +10 -176
  369. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  370. package/src/containers/list-detail/list-detail.tsx +22 -12
  371. package/src/containers/note/note.tsx +2 -2
  372. package/src/containers/order-ticket/index.ts +2 -0
  373. package/src/containers/order-ticket/model.ts +21 -0
  374. package/src/containers/order-ticket/order-ticket.tsx +30 -13
  375. package/src/containers/page/page.tsx +2 -2
  376. package/src/containers/page-header/back.tsx +2 -2
  377. package/src/containers/page-header/page-header.tsx +6 -6
  378. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  379. package/src/containers/pagination/pagination.tsx +4 -4
  380. package/src/containers/resizable/resizable.tsx +7 -5
  381. package/src/containers/row-actions/row-actions.tsx +18 -3
  382. package/src/containers/scrolly/scrolly.tsx +1 -1
  383. package/src/containers/section/section.tsx +21 -8
  384. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  385. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  386. package/src/containers/settings-row/settings-row.tsx +7 -2
  387. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  388. package/src/containers/stack/stack.tsx +2 -2
  389. package/src/containers/table/table.tsx +35 -14
  390. package/src/containers/timeline/timeline.tsx +17 -3
  391. package/src/containers/toolbar/toolbar.tsx +3 -3
  392. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  393. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  394. package/src/forms/chip-group/chip-group.tsx +23 -2
  395. package/src/forms/combobox/combobox.tsx +15 -4
  396. package/src/forms/copy-field/copy-field.tsx +11 -2
  397. package/src/forms/date-picker/date-picker.tsx +23 -12
  398. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  399. package/src/forms/dropzone/dropzone.tsx +18 -3
  400. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  401. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  402. package/src/forms/field/field.tsx +2 -2
  403. package/src/forms/fieldset/fieldset.tsx +2 -2
  404. package/src/forms/form/form.tsx +13 -5
  405. package/src/forms/form-footer/form-footer.tsx +2 -2
  406. package/src/forms/form-grid/form-grid.tsx +3 -3
  407. package/src/forms/form-section/form-section.tsx +2 -2
  408. package/src/forms/inline-select/inline-select.tsx +14 -3
  409. package/src/forms/input/input.tsx +8 -2
  410. package/src/forms/internal/button-option.tsx +2 -0
  411. package/src/forms/label/label.tsx +2 -2
  412. package/src/forms/native-select/native-select.tsx +9 -2
  413. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  414. package/src/forms/password-input/password-input.tsx +12 -0
  415. package/src/forms/pin-input/pin-input.tsx +9 -1
  416. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  417. package/src/forms/rating/rating.tsx +14 -1
  418. package/src/forms/select/select.tsx +14 -4
  419. package/src/forms/select-menu/select-menu.tsx +15 -4
  420. package/src/forms/slider/model.ts +5 -0
  421. package/src/forms/slider/slider.tsx +13 -3
  422. package/src/forms/textarea/textarea.tsx +7 -4
  423. package/src/forms/time-input/time-input.tsx +19 -5
  424. package/src/i18n/strings.ts +18 -0
  425. package/src/intent/attributes.ts +96 -0
  426. package/src/intent/bridge.tsx +25 -0
  427. package/src/intent/index.ts +24 -0
  428. package/src/intent/target-registrations.ts +127 -0
  429. package/src/intent/types.ts +44 -0
  430. package/src/intent/use-intent-target.ts +96 -0
  431. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  432. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  433. package/src/navigation/floating-toc/model.ts +3 -1
  434. package/src/navigation/segmented/segmented.tsx +14 -2
  435. package/src/navigation/stepper/stepper.tsx +7 -2
  436. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  437. package/src/navigation/tabs/tabs.tsx +24 -3
  438. package/src/navigation/wizard/wizard.tsx +12 -4
  439. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  440. package/src/overlays/context-menu/context-menu.tsx +58 -11
  441. package/src/overlays/dialog/dialog.tsx +18 -7
  442. package/src/overlays/drawer/drawer.tsx +15 -4
  443. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  444. package/src/overlays/hover-card/hover-card.tsx +13 -2
  445. package/src/overlays/popover/popover.tsx +12 -1
  446. package/src/overlays/tooltip/model.ts +8 -0
  447. package/src/overlays/tooltip/tooltip.tsx +15 -2
  448. package/src/palette/command-palette/command-palette.tsx +66 -3
  449. package/src/palette/command-palette/index.ts +1 -0
  450. package/src/palette/command-palette/model.ts +15 -0
  451. package/src/primitives/command/command.tsx +4 -1
  452. package/src/primitives/dialog/dialog.tsx +1 -4
  453. package/src/primitives/popper/popper.tsx +16 -5
  454. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  455. package/src/shell/sidebar/sidebar.tsx +22 -4
  456. package/src/showcase/bento.tsx +2 -0
  457. package/src/utils/is-production.ts +3 -0
  458. package/src/utils/slot.tsx +21 -3
  459. package/styles/base.css +34 -0
@@ -1,9 +1,11 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef, HTMLAttributes } from "react";
3
+ import type { ComponentPropsWithRef } from "react";
4
4
  import { Check, ChevronRight } from "../../icons/index.js";
5
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
5
6
  import * as MenuPrimitive from "../../primitives/menu/menu.js";
6
7
  import { cn } from "../../utils/cn.js";
8
+ import { useComposedRefs } from "../../utils/compose.js";
7
9
  import { type Material, materialClass } from "../../utils/material.js";
8
10
  import { ITEM_MOTION, POPPER_MOTION } from "../../utils/overlay-motion.js";
9
11
 
@@ -33,7 +35,7 @@ export const dropdownMenuItemClasses =
33
35
  const surface = `${placement} ${POPPER_MOTION} ${dropdownMenuSurfaceClasses}`;
34
36
  const itemBase = `${dropdownMenuItemClasses} ${ITEM_MOTION}`;
35
37
 
36
- export interface DropdownMenuContentProps extends MenuPrimitive.MenuContentProps {
38
+ export interface DropdownMenuContentProps extends MenuPrimitive.MenuContentProps, IntentProps {
37
39
  /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
38
40
  container?: HTMLElement | null;
39
41
  /**
@@ -59,8 +61,15 @@ export function DropdownMenuContent({
59
61
  container,
60
62
  material,
61
63
  bare = false,
64
+ intent,
65
+ intentKey,
66
+ ref,
62
67
  ...props
63
68
  }: DropdownMenuContentProps) {
69
+ const composedRef = useComposedRefs<HTMLDivElement>(
70
+ ref,
71
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menu" }),
72
+ );
64
73
  return (
65
74
  <MenuPrimitive.Portal container={container}>
66
75
  <MenuPrimitive.Content
@@ -71,15 +80,27 @@ export function DropdownMenuContent({
71
80
  ? cn(placement, POPPER_MOTION, className)
72
81
  : cn(surface, materialClass(material, "surface-solid"), className)
73
82
  }
83
+ {...intentAttributes({ intent, intentKey })}
74
84
  {...props}
85
+ ref={composedRef}
75
86
  />
76
87
  </MenuPrimitive.Portal>
77
88
  );
78
89
  }
79
90
 
80
- export interface DropdownMenuItemProps extends MenuPrimitive.MenuItemProps {}
91
+ export interface DropdownMenuItemProps extends MenuPrimitive.MenuItemProps, IntentProps {}
81
92
 
82
- export function DropdownMenuItem({ className, ...props }: DropdownMenuItemProps) {
93
+ export function DropdownMenuItem({
94
+ className,
95
+ intent,
96
+ intentKey,
97
+ ref,
98
+ ...props
99
+ }: DropdownMenuItemProps) {
100
+ const composedRef = useComposedRefs<HTMLDivElement>(
101
+ ref,
102
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitem" }),
103
+ );
83
104
  return (
84
105
  <MenuPrimitive.Item
85
106
  className={cn(
@@ -87,18 +108,29 @@ export function DropdownMenuItem({ className, ...props }: DropdownMenuItemProps)
87
108
  "data-disabled:pointer-events-none data-disabled:opacity-50",
88
109
  className,
89
110
  )}
111
+ {...intentAttributes({ intent, intentKey })}
90
112
  {...props}
113
+ ref={composedRef}
91
114
  />
92
115
  );
93
116
  }
94
117
 
95
- export interface DropdownMenuCheckboxItemProps extends MenuPrimitive.MenuCheckboxItemProps {}
118
+ export interface DropdownMenuCheckboxItemProps
119
+ extends MenuPrimitive.MenuCheckboxItemProps,
120
+ IntentProps {}
96
121
 
97
122
  export function DropdownMenuCheckboxItem({
98
123
  className,
99
124
  children,
125
+ intent,
126
+ intentKey,
127
+ ref,
100
128
  ...props
101
129
  }: DropdownMenuCheckboxItemProps) {
130
+ const composedRef = useComposedRefs<HTMLDivElement>(
131
+ ref,
132
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitemcheckbox" }),
133
+ );
102
134
  return (
103
135
  <MenuPrimitive.CheckboxItem
104
136
  className={cn(
@@ -106,7 +138,9 @@ export function DropdownMenuCheckboxItem({
106
138
  "relative ps-8 data-disabled:pointer-events-none data-disabled:opacity-50",
107
139
  className,
108
140
  )}
141
+ {...intentAttributes({ intent, intentKey })}
109
142
  {...props}
143
+ ref={composedRef}
110
144
  >
111
145
  <span className="absolute inset-s-2 flex size-4 items-center justify-center">
112
146
  <MenuPrimitive.ItemIndicator>
@@ -118,10 +152,20 @@ export function DropdownMenuCheckboxItem({
118
152
  );
119
153
  }
120
154
 
121
- export interface DropdownMenuRadioItemProps extends MenuPrimitive.MenuRadioItemProps {}
155
+ export interface DropdownMenuRadioItemProps extends MenuPrimitive.MenuRadioItemProps, IntentProps {}
122
156
 
123
157
  /** Exposes `role="menuitemradio"` and `aria-checked`: use it for single-value filters. */
124
- export function DropdownMenuRadioItem({ className, ...props }: DropdownMenuRadioItemProps) {
158
+ export function DropdownMenuRadioItem({
159
+ className,
160
+ intent,
161
+ intentKey,
162
+ ref,
163
+ ...props
164
+ }: DropdownMenuRadioItemProps) {
165
+ const composedRef = useComposedRefs<HTMLDivElement>(
166
+ ref,
167
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitemradio" }),
168
+ );
125
169
  return (
126
170
  <MenuPrimitive.RadioItem
127
171
  className={cn(
@@ -129,12 +173,14 @@ export function DropdownMenuRadioItem({ className, ...props }: DropdownMenuRadio
129
173
  "data-[state=checked]:font-bold data-[state=checked]:text-accent-ink",
130
174
  className,
131
175
  )}
176
+ {...intentAttributes({ intent, intentKey })}
132
177
  {...props}
178
+ ref={composedRef}
133
179
  />
134
180
  );
135
181
  }
136
182
 
137
- export function DropdownMenuLabel({ className, ...props }: HTMLAttributes<HTMLDivElement>) {
183
+ export function DropdownMenuLabel({ className, ...props }: ComponentPropsWithRef<"div">) {
138
184
  return (
139
185
  <MenuPrimitive.Label
140
186
  className={cn("px-2.5 pt-1.5 pb-1 text-overline text-ink-3", className)}
@@ -143,7 +189,7 @@ export function DropdownMenuLabel({ className, ...props }: HTMLAttributes<HTMLDi
143
189
  );
144
190
  }
145
191
 
146
- export interface DropdownMenuSeparatorProps extends ComponentPropsWithoutRef<"div"> {}
192
+ export interface DropdownMenuSeparatorProps extends ComponentPropsWithRef<"div"> {}
147
193
 
148
194
  export function DropdownMenuSeparator({ className, ...props }: DropdownMenuSeparatorProps) {
149
195
  return (
@@ -151,14 +197,23 @@ export function DropdownMenuSeparator({ className, ...props }: DropdownMenuSepar
151
197
  );
152
198
  }
153
199
 
154
- export interface DropdownMenuSubTriggerProps extends MenuPrimitive.MenuSubTriggerProps {}
200
+ export interface DropdownMenuSubTriggerProps
201
+ extends MenuPrimitive.MenuSubTriggerProps,
202
+ IntentProps {}
155
203
 
156
204
  /** Item that opens a nested menu; the chevron is added after the children. */
157
205
  export function DropdownMenuSubTrigger({
158
206
  className,
159
207
  children,
208
+ intent,
209
+ intentKey,
210
+ ref,
160
211
  ...props
161
212
  }: DropdownMenuSubTriggerProps) {
213
+ const composedRef = useComposedRefs<HTMLDivElement>(
214
+ ref,
215
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "menuitem" }),
216
+ );
162
217
  return (
163
218
  <MenuPrimitive.SubTrigger
164
219
  className={cn(
@@ -166,7 +221,9 @@ export function DropdownMenuSubTrigger({
166
221
  "data-disabled:pointer-events-none data-disabled:opacity-50 data-[state=open]:bg-surface-2",
167
222
  className,
168
223
  )}
224
+ {...intentAttributes({ intent, intentKey })}
169
225
  {...props}
226
+ ref={composedRef}
170
227
  >
171
228
  {children}
172
229
  <ChevronRight aria-hidden="true" className="ms-auto size-4 rtl:rotate-180" />
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  createContext,
6
6
  type FocusEvent,
7
7
  type PointerEvent,
@@ -14,8 +14,10 @@ import {
14
14
  useRef,
15
15
  useState,
16
16
  } from "react";
17
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
17
18
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
18
19
  import { cn } from "../../utils/cn.js";
20
+ import { useComposedRefs } from "../../utils/compose.js";
19
21
  import { type Material, materialClass } from "../../utils/material.js";
20
22
  import { POPPER_MOTION } from "../../utils/overlay-motion.js";
21
23
  import { Slot } from "../../utils/slot.js";
@@ -98,7 +100,7 @@ export function HoverCard({
98
100
  );
99
101
  }
100
102
 
101
- export interface HoverCardTriggerProps extends ComponentPropsWithoutRef<"span"> {
103
+ export interface HoverCardTriggerProps extends ComponentPropsWithRef<"span">, IntentProps {
102
104
  /** Use the child element as the trigger instead of wrapping it in a span. */
103
105
  asChild?: boolean;
104
106
  }
@@ -109,9 +111,16 @@ export function HoverCardTrigger({
109
111
  onPointerLeave,
110
112
  onFocus,
111
113
  onBlur,
114
+ intent,
115
+ intentKey,
116
+ ref,
112
117
  ...props
113
118
  }: HoverCardTriggerProps) {
114
119
  const card = useHoverCard();
120
+ const composedRef = useComposedRefs<HTMLSpanElement>(
121
+ ref,
122
+ useIntentTarget<HTMLSpanElement>({ intent, intentKey }),
123
+ );
115
124
  const Comp = asChild ? Slot : "span";
116
125
  return (
117
126
  <PopoverPrimitive.Anchor asChild>
@@ -133,7 +142,9 @@ export function HoverCardTrigger({
133
142
  onBlur?.(event);
134
143
  card.schedule(false, 0);
135
144
  }}
145
+ {...intentAttributes({ intent, intentKey })}
136
146
  {...props}
147
+ ref={composedRef}
137
148
  />
138
149
  </PopoverPrimitive.Anchor>
139
150
  );
@@ -1,7 +1,9 @@
1
1
  "use client";
2
2
 
3
+ import { type IntentProps, intentAttributes, useIntentTarget } from "../../intent/index.js";
3
4
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
4
5
  import { cn } from "../../utils/cn.js";
6
+ import { useComposedRefs } from "../../utils/compose.js";
5
7
  import { type Material, materialClass } from "../../utils/material.js";
6
8
  import { POPPER_MOTION } from "../../utils/overlay-motion.js";
7
9
 
@@ -11,7 +13,7 @@ export const PopoverClose = PopoverPrimitive.Close;
11
13
  export const PopoverAnchor = PopoverPrimitive.Anchor;
12
14
  export const PopoverArrow = PopoverPrimitive.Arrow;
13
15
 
14
- export interface PopoverContentProps extends PopoverPrimitive.PopoverContentProps {
16
+ export interface PopoverContentProps extends PopoverPrimitive.PopoverContentProps, IntentProps {
15
17
  /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
16
18
  container?: HTMLElement | null;
17
19
  /**
@@ -30,8 +32,15 @@ export function PopoverContent({
30
32
  collisionPadding = 8,
31
33
  container,
32
34
  material,
35
+ intent,
36
+ intentKey,
37
+ ref,
33
38
  ...props
34
39
  }: PopoverContentProps) {
40
+ const composedRef = useComposedRefs<HTMLDivElement>(
41
+ ref,
42
+ useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "dialog" }),
43
+ );
35
44
  return (
36
45
  <PopoverPrimitive.Portal container={container}>
37
46
  <PopoverPrimitive.Content
@@ -43,7 +52,9 @@ export function PopoverContent({
43
52
  materialClass(material, "surface-solid"),
44
53
  className,
45
54
  )}
55
+ {...intentAttributes({ intent, intentKey })}
46
56
  {...props}
57
+ ref={composedRef}
47
58
  />
48
59
  </PopoverPrimitive.Portal>
49
60
  );
@@ -16,3 +16,11 @@ export function opensOnFocus({
16
16
  }): boolean {
17
17
  return focusVisible && !pressed;
18
18
  }
19
+
20
+ export function joinIds(...ids: Array<string | undefined>): string | undefined {
21
+ const unique = new Set<string>();
22
+ for (const value of ids) {
23
+ for (const id of (value ?? "").trim().split(/\s+/)) if (id) unique.add(id);
24
+ }
25
+ return unique.size > 0 ? [...unique].join(" ") : undefined;
26
+ }
@@ -19,7 +19,7 @@ import { type Material, materialClass } from "../../utils/material.js";
19
19
  import { POPPER_MOTION } from "../../utils/overlay-motion.js";
20
20
  import { Slot } from "../../utils/slot.js";
21
21
  import { useControllableState } from "../../utils/use-controllable-state.js";
22
- import { opensOnFocus, opensOnHover } from "./model.js";
22
+ import { joinIds, opensOnFocus, opensOnHover } from "./model.js";
23
23
 
24
24
  export type TooltipPart = "content" | "shortcut";
25
25
 
@@ -51,6 +51,7 @@ export interface TooltipProps {
51
51
  classNames?: ClassNames<TooltipPart>;
52
52
  /** The element that gets the tooltip. It receives `aria-describedby` while the tooltip is open. */
53
53
  children: ReactElement;
54
+ describeTrigger?: "whileOpen" | "always";
54
55
  }
55
56
 
56
57
  function focusIsVisible(element: Element): boolean {
@@ -83,6 +84,7 @@ export function Tooltip({
83
84
  material,
84
85
  className,
85
86
  classNames,
87
+ describeTrigger = "whileOpen",
86
88
  children,
87
89
  }: TooltipProps) {
88
90
  const [openState, setOpen] = useControllableState({
@@ -92,6 +94,12 @@ export function Tooltip({
92
94
  });
93
95
  const open = openState && !disabled;
94
96
  const contentId = useId();
97
+ const descriptionId = useId();
98
+ const persistent = describeTrigger === "always";
99
+ const ownDescribedBy = (children.props as { "aria-describedby"?: string })["aria-describedby"];
100
+ const describedBy = persistent
101
+ ? joinIds(ownDescribedBy, descriptionId)
102
+ : joinIds(ownDescribedBy, open ? contentId : undefined);
95
103
  const timer = useRef<number | undefined>(undefined);
96
104
  const pressed = useRef(false);
97
105
 
@@ -108,7 +116,7 @@ export function Tooltip({
108
116
 
109
117
  const trigger = (
110
118
  <Slot
111
- aria-describedby={open ? contentId : undefined}
119
+ aria-describedby={describedBy}
112
120
  onPointerEnter={(event: PointerEvent<HTMLElement>) => {
113
121
  if (opensOnHover(event.pointerType)) schedule(true, openDelay);
114
122
  }}
@@ -137,6 +145,11 @@ export function Tooltip({
137
145
 
138
146
  return (
139
147
  <PopoverPrimitive.Root open={open} onOpenChange={setOpen}>
148
+ {persistent ? (
149
+ <span id={descriptionId} hidden>
150
+ {content}
151
+ </span>
152
+ ) : null}
140
153
  <PopoverPrimitive.Anchor asChild>{trigger}</PopoverPrimitive.Anchor>
141
154
  <PopoverPrimitive.Portal container={container}>
142
155
  <PopoverPrimitive.Content
@@ -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
  }