@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
package/CHANGELOG.md CHANGED
@@ -1,5 +1,155 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.10.0 (2026-11-15)
4
+
5
+ ### Intent-aware components and accessibility
6
+
7
+ #### Added
8
+
9
+ - **`@jcsoftdev/ui/intent`**: `IntentBridge` (`registerTarget(ref, element, expectation)`), `IntentBridgeProvider`, a no-op default bridge, `intentAttributes`, `useIntentTarget` and `useIntentTargets`. See the README section «Intent targets».
10
+ - **Intent props per family**: optional `intent` and `intentKey` on atoms, forms, containers, overlays, navigation, shell, AI and palette components. `MessageActions` takes `actionIntents`. A range `Slider` with `intent` registers its two thumbs under the keys `start` and `end`, or `<intentKey>:start` and `<intentKey>:end`. `DateTimePicker` and `CopyField` put `data-intent` on their inner input. `Step` accepts `ref`, and `renderLink` callbacks receive a `ref` and `data-intent` attributes to spread on the link.
11
+ - **`DataGrid`**: `rowIntent`, `data-row-id` (needs `getRowId`), `data-col-id`, and the rest of the root `div` props. Select and tools columns have no `data-col-id`.
12
+ - **`FloorPlan`**: item `intent` and `intentKey`, and `floorPlanItemName` for table names that include status and seats.
13
+ - **`CommandPalette`**: `onSubmitQuery`, `inputEnd` and `keepOpenOnSelect`.
14
+ - **`Tooltip`**: `describeTrigger` (`"whileOpen"` or `"always"`); an existing `aria-describedby` on the trigger is kept.
15
+ - **`Switch`** `label` and `description`, **`Checkbox`** `description`, wired through `aria-describedby`.
16
+ - **Calendar**: `MonthView` and `WeekView` have ARIA grid semantics, a roving keyboard and `dayIntent`.
17
+ - **`orderTicketTitle`**.
18
+ - **Durations in hours**: `ElapsedTime` and `OrderTicket` keep `mm:ss` and `N min` under 60 minutes and read "22 h 30 min", "9 h 28 min" or "1 h" from 60 minutes on (the clock drops seconds; the late overrun reads "+22 h 15 min"). The accessible text follows ("9 hours 28 minutes"). New `UiStrings` keys `hoursShort`, `hoursMinutesShort`, `elapsedHoursOne` and `elapsedHours` for `en` and `es`; custom locales must add them. The pure helpers `formatClockText`, `formatMinutesText`, `formatOverrunText` and `spokenDuration` live in the elapsed-time model; `formatClock` is unchanged.
19
+ - **Highlight styles**: `data-intent-highlight` and `data-intent-changed` outlines with `--intent-highlight-*` custom properties, reduced-motion and forced-colors fallbacks.
20
+
21
+ #### Changed
22
+
23
+ - **`IntentBridge` timing**: `registerTarget`'s unregister runs one microtask after the element detaches; a re-attach of the same element with the same role and `requireName` in the same commit reuses the registration. Stale entries of other identities may stay live until that microtask. Await `act` (or flush microtasks) before asserting that a target is gone. A ref forwarder that passes only non-null nodes leaks one registration on unmount, so forward `null` too. A development warning fires once for a duplicate live intent and key. Keep the bridge object stable (memoize it): when its identity changes, the old bridge unregisters one microtask after the new one registers.
24
+ - **Ref typing**: the props of the components that gained intent props now extend `ComponentPropsWithRef` instead of `ComponentPropsWithoutRef`, so `ref` is a typed prop (React 19 `ref` as a prop) and reaches the element that carries the component's role and accessible name: the button, the input, the thumb, the panel. Components that did not take a ref before accept one now; `DataGrid`'s `ref` lands on its root `div`, which contains `table[role=grid]`.
25
+ - **`DataGridProps`** is now `DataGridOwnProps & DataGridRootAttributes`: root `div` attributes that 0.9.0 silently dropped now reach the root. `data-col-id` is rendered on every header and gridcell whether or not intents are used, except the select and tools columns.
26
+ - **`MonthView`** keeps its 0.9.0 props and stays a server component: it computes the weekday names, month title, full dates and `formatMore` labels, then hands only serializable data and the optional handlers to a client `MonthGrid`.
27
+ - **Biome**: `biome.json` overrides turn off `useSemanticElements` and `useFocusableInteractive` for the calendar grid views.
28
+ - **Size budgets** raised to the measured gzip size plus about 5% for `ui/ai`, `ui/atoms`, `ui/auth`, `ui/brand`, `ui/calendar`, `ui/containers`, `ui/forms`, `ui/glass`, `ui/i18n`, `ui/motion`, `ui/navigation`, `ui/overlays`, `ui/shell` and `ui-tokens styles/base.css`. Against the 0.9.0 dist, `ui/calendar` grew 15643 to 18360 B gzip (+17%) and `ui/navigation` 16734 to 18626 B (+11%). Nothing accidental is bundled: the intent runtime (target registrations, attributes and the registration hook, about 3.5 kB minified) now ships with every client component family, and calendar adds the grid keyboard and ARIA semantics on top. `ui/glass` was already 31 B over before this work.
29
+
30
+ #### Fixed
31
+
32
+ - **`OrderTicket`**: the ticket state no longer leaks into the heading name.
33
+ - **`FloorPlan`** tables are named with their status and seats.
34
+ - **`Tooltip`** keeps an existing `aria-describedby`.
35
+ - **Charts**: every chart component exported from `@jcsoftdev/ui/charts` now has a data-table alternative.
36
+
37
+ #### Upgrade notes from 0.9.0
38
+
39
+ - **`OrderTicket` titles**: a ticket that receives both `table` and `number` now reads "Mesa 1 · N.º 4" (en: "T1 · No. 4"). 0.9.0 showed only the table. An app that already appends the number itself now shows it twice: remove that workaround, or pass `number` only for tickets without a table. The article always carries `aria-describedby`.
40
+ - **`FloorPlan` names**: each item is named `"<label>, <status>, <n> seats"` (plus the late text) through `aria-label`; the sr-only seats span is gone. Queries and tests that used the old computed name or DOM must use the new name, built by `floorPlanItemName`.
41
+ - **`MonthView` and `WeekView` DOM**: the grid has `role="row"` wrappers (CSS subgrid) and adds one tab stop before the event buttons (arrow keys, Home and End move between days). In `MonthView` only, the day number is `aria-hidden` with a screen-reader date in its place, and Enter on a focused day calls `onSelectDate`. Selectors tied to the old flat structure must be updated.
42
+ - **`DataGrid`**: see Changed for `data-col-id` and the root props spread.
43
+ - **Popper anchors (`Slot` and `PopperPrimitive.Anchor`)**: the last mounted anchor wins, and it registers from a layout effect, so a hand-forwarded ref called with `null` no longer leaves a detached anchor. `Slot` clears object refs on detach.
44
+ - **`PopoverContent`**: it renders `role="dialog"` as before and now registers that role as its expectation. The intent attributes are spread before the consumer's props and the `ref` is composed after them, so a consumer-passed `data-intent` overrides the component's and a consumer `ref` still receives the node.
45
+ - **Command primitive**: an element inside the command root with `data-ui-command-skip-keys` bypasses the command key handling (used by the palette's `inputEnd`), and an item's derived value no longer resets to an empty string when its text is not available.
46
+
47
+ ### Client directive
48
+
49
+ #### Fixed
50
+
51
+ - **`Kpi` and the showcase `Bento`**: both use `createContext` but shipped without a `"use client"`
52
+ directive, so importing them from a Next.js Server Component failed. They now declare it like the
53
+ other 20 context-using modules.
54
+
55
+ ### AI, auth, calendar, shell and primitives polish
56
+
57
+ #### Fixed
58
+
59
+ - **`CodeBlock` dark theme**: function and type names use `text-info` and `text-pal-orquidea-ink` instead of the
60
+ fixed dark `-deep` swatches, which were nearly invisible on the dark code surface (1.02:1).
61
+ - **Pointer areas**: the `Attachment` and `PromptInput` remove button is 24px (20px before), the disclosure
62
+ header of `ChainOfThought` and `ToolCall` is at least 24px tall (18px), the collapsible `Sidebar`
63
+ group toggle is at least 24px tall (23px), and the `LoginForm` forgot-password and help links are at least
64
+ 24px tall (16px).
65
+ - **Disabled cues**: the `DateCalendar` month arrows dim at 0.5 with the not-allowed cursor (0.4 and the default
66
+ cursor before), the `PromptInput` send button and the `ai` icon actions dim at 0.5 (0.45), and the disabled
67
+ `PromptInput` textarea dims at 0.5 like the other text controls.
68
+
69
+ ### Charts polish
70
+
71
+ #### Fixed
72
+
73
+ - **`ScatterChart` trend-line R² label**: it wears the ink color with a surface halo instead of the series color,
74
+ so it keeps 4.5:1 contrast and stays readable over data points.
75
+ - **Pointer areas**: the chart breadcrumb buttons and the map data table sort buttons are 30px tall (18px before),
76
+ the `Crossfilter` clear button is 24px (21px), the `BarRaceChart` slider is 24px (6px), and the `TreeChart`
77
+ collapse badge and the `GanttChart` row toggle get a 24px area through an invisible extension.
78
+ - **Loading skeleton (`shape="ring"`)**: the ring is clipped instead of overflowing a container narrower than
79
+ its height.
80
+
81
+ ### Containers polish
82
+
83
+ #### Fixed
84
+
85
+ - **`Carousel` dots**: each dot has a 24px tall pointer area (was 8px) through an invisible extension; the dots
86
+ keep their size and spacing. The disabled arrows now dim at 0.5 like the rest of the kit (was 0.4).
87
+ - **`Table` sort and pin buttons, `Resizable` handle**: the sort button, the pin buttons and the resize handle
88
+ have a 24px pointer area (17px, 20px and 8px before) through an invisible extension, without changing layout.
89
+ - **`ActionBar` clear button**: it no longer shrinks to 16px wide in a narrow bar.
90
+ - **`Pagination` (`variant="pages"`)**: the page buttons wrap instead of overflowing a 320px screen.
91
+ - **`HBars`**: the screen-reader table is clipped, so it no longer adds horizontal scroll on a narrow screen.
92
+ - **`Scrolly` steps**: inactive steps dim to 0.8 (was 0.6) so their text keeps 4.5:1 contrast.
93
+ - **Disabled cues**: `Pagination` and `DataGrid` step buttons, the `DataGrid` toolbar buttons, the formula bar and the
94
+ tool panel and column menu buttons now dim at 0.5 with the not-allowed cursor (the toolbar buttons had no
95
+ cue; the others dimmed at 0.3 to 0.4 with the default cursor). `SelectableCard` dims at 0.5 (was 0.6).
96
+
97
+ ### Navigation, overlays and states polish
98
+
99
+ #### Fixed
100
+
101
+ - **`TabsTrigger` and `SegmentedItem`**: a disabled tab or segment now dims and shows the not-allowed cursor;
102
+ before there was no cue.
103
+ - **`Breadcrumbs` links**: the pointer area is 30px tall (was 18px) through an invisible extension; the row
104
+ keeps its height and layout.
105
+
106
+ ### Forms polish
107
+
108
+ #### Fixed
109
+
110
+ - **`Input` (plain and bare), `Textarea`, `Select`, `TimeInput` and `AccentPicker` options**: a disabled control
111
+ now dims and shows the not-allowed cursor like `NativeSelect` and `SelectMenu` already did; before there was
112
+ no cue. `NumberStepper` dims at 0.5 with the not-allowed cursor (was 0.6, default cursor).
113
+ - **`Slider`**: the track pointer area is 24px (was 20px); the root keeps its height.
114
+
115
+ ### Atoms polish
116
+
117
+ #### Fixed
118
+
119
+ - **`Checkbox` and `Switch`**: the keyboard focus ring now follows the visible box and track instead of the
120
+ invisible 40px hit area.
121
+ - **`Switch`, `RadioGroup` options and `StatusPill` buttons**: a disabled control now dims and shows the
122
+ not-allowed cursor like `Checkbox` and `Button` already did; before there was no cue.
123
+ - **`Chip` remove button**: the hit area is 24px at the default density (was 16px). The chip keeps its width
124
+ and the icon its place; the touch density still gets 44px.
125
+
126
+ ## 0.9.0 (2026-11-04)
127
+
128
+ ### Kitchen ticket
129
+
130
+ A paper-style kitchen display ticket for order queues and wall screens.
131
+
132
+ #### Added
133
+
134
+ - **`OrderTicket`** (`containers`): a ticket with a table title, or the channel icon plus «N.º n» for
135
+ orders without a table, and a meta line with channel, guests and server. The header shows the
136
+ elapsed time and progress against `targetMinutes`. `warn` uses an hourglass and warning text.
137
+ `late` fills the header band with danger and shows «Demorada +m:ss». Lines carry quantity,
138
+ modifiers, note and an allergy callout (danger outline, never warning amber). Each line has a
139
+ toggle with `aria-pressed` for pending, in progress and done. «Empezar todo» and «Listo todo»
140
+ act only on the lines of the card shown. `readOnly` renders no buttons. `partIndex` and
141
+ `partCount` label continued tickets «(1 de n)» and «(cont.)». Also takes `recovered`, `chip`,
142
+ an `actions` slot and `viewTransitionName`. Motion is off under reduced motion.
143
+ - **Helpers**: `orderTicketState`, `warnLeadSeconds` (max of 2 minutes and 25% of the target),
144
+ `splitTicketLines` and `ticketLineCost`.
145
+ - **Icons**: `AlarmClock` and `Hourglass`.
146
+ - **UI strings** (en, es) for the ticket.
147
+
148
+ #### Changed
149
+
150
+ - **Size budgets raised** by about 2% for 13 entries that carry the larger string table or the new
151
+ container.
152
+
3
153
  ## 0.8.0 (2026-11-04)
4
154
 
5
155
  ### Floor plan
@@ -771,6 +921,7 @@ From 0.2.x: nothing changes unless you adopt Liquid Glass.
771
921
  ### Crystal lens
772
922
 
773
923
  - **`profile: "crystal"`** and the `crystal` preset (`data-glass="liquid-crystal"`): a thick, fully clear convex lens that minifies the backdrop, bends it hard towards the rim, splits colour at the edge and has no frost, veil or tint. `refraction` accepts 0 to 2 for it (defaults and the other profiles are unchanged; above 1 they behave as 1). The minifying map cannot fold; the filter runs on a layer that extends past the surface and is clipped to it. No contrast guarantee.
924
+ - **Crystal near the edge of a clipping ancestor.** A side with less backdrop than the lens reaches (a surface at the edge of an `overflow` or `clip-path` stage) now bends less on that side, eased across the surface, so its silhouette still samples inside the backdrop. Before, every sample past the room was pinned to its edge, which smeared one column of backdrop over a band of the surface with a hard boundary. With the whole margin on every side the map is byte-identical to before.
774
925
 
775
926
  ### Configurable Liquid Glass and liquid motion
776
927
 
package/README.md CHANGED
@@ -191,9 +191,10 @@ https://ui.jcsoftdev.com/docs/blocks/
191
191
  | `DueChip` | `atoms` | Due-date chip: overdue, soon (`soonDays`) and ok states with a glyph and sr-only suffix; time-zone safe. |
192
192
  | `ElapsedTime` | `atoms` | Live `<time>` timer on one shared 1 s ticker: `since`, `serverOffsetMs`, `format`, `warnAt`, `dangerAt`, `countdownTo`; no `aria-live`. |
193
193
  | `TableGlyph` | `atoms` | SVG table with chairs placed from `shape` (`round`, `square`, `rect`, `bar`) and `seats`; `occupied`, `size`, `pattern`. |
194
- | `FloorPlan` | `containers` | Read-only salon plan on a grid-unit canvas: items as roving-focus buttons, landmarks, group outlines, `late`/`selected` rings. |
194
+ | `FloorPlan` | `containers` | Read-only salon plan on a grid-unit canvas: items as roving-focus buttons named with their status and seats (`floorPlanItemName`), item `intent`s, landmarks, group outlines, `late`/`selected` rings. |
195
+ | `OrderTicket` | `containers` | Paper kitchen ticket: title from the table, the channel and number, or both ("Mesa 1 · N.º 4" when `table` and `number` are passed; see `orderTicketTitle`), `ElapsedTime`, progress against `targetMinutes`, ok/warn/late state (late is a filled band), lines with `aria-pressed` toggles, `readOnly`, `part`/`parts` continuation; `orderTicketState` and `splitTicketLines` helpers. |
195
196
  | `Seal` | `atoms` | Stamp mark: `title`, `icon`, `tone`, optional named `label`. |
196
- | `Tooltip` | `overlays` | Hover and focus tip: `content`, `shortcut`, `side`, `openDelay`, `closeDelay`; `role="tooltip"`. |
197
+ | `Tooltip` | `overlays` | Hover and focus tip: `content`, `shortcut`, `side`, `openDelay`, `closeDelay`; `role="tooltip"`. `describeTrigger="always"` keeps the content as a hidden description of the trigger even while closed (default `"whileOpen"`); the trigger's own `aria-describedby` is always kept. |
197
198
  | `AlertDialog` | `overlays` | `role="alertdialog"` with cancel and confirm, `tone="danger"`, async `onConfirm` with a pending state. |
198
199
  | `SelectMenu` | `forms` | Custom listbox select over `options` (groups, disabled options, typeahead, hidden `name` input). |
199
200
  | `Combobox` | `forms` | Filterable, async-friendly (`onSearchChange`, `loading`), `clearable`, `emptyText`. |
@@ -277,6 +278,25 @@ A table from `md` up (library `Table` styling) and a stack of cards below it; th
277
278
  (default: the first) titles each card and the other columns become label/value rows. Every row
278
279
  carries `data-row-key`; `rowClassName` applies to both layouts.
279
280
 
281
+ ## Intent targets
282
+
283
+ Components accept optional `intent` and `intentKey` props. When `intent` is a non-empty string the component renders `data-intent="<intent>"`, and `data-intent-key="<key>"` when `intentKey` is also non-empty; with no `intent` nothing is rendered or registered, even if `intentKey` is set. The attributes sit on the element that carries the component's role and accessible name, which is the element that receives the rest props. `DataGrid` is the exception: root props go on the wrapper while the intent goes on `table[role=grid]`. For `DateTimePicker` and `CopyField` the attributes sit on the inner input. `MessageActions` takes `actionIntents` to target each action by name.
284
+
285
+ ```tsx
286
+ <Button intent="order-save">Save</Button>
287
+ <DataGrid data={orders} getRowId={(row) => row.id} rowIntent="order-row" columns={columns} />
288
+ ```
289
+
290
+ `@jcsoftdev/ui/intent` exports `IntentBridge`, `{ registerTarget(ref, element, expectation): () => void }`, and `IntentBridgeProvider`. Without a provider the bridge is a no-op (`noopIntentBridge`), so nothing changes for apps that do not use it. `ref` is `{ intent, key? }` and `expectation` is `{ role, requireName }`.
291
+
292
+ Client components register through the bridge. Server-safe components (`Input`, `Textarea`, `Select`, `NativeSelect`, `Form`, `Card`, `DayChip`, `EventBlock` and similar) render the attributes but do not register, so a consumer must also be able to find them by `[data-intent][data-intent-key]`.
293
+
294
+ `rowIntent` on `DataGrid` needs `getRowId`: rows then carry `data-row-id` and cells `data-col-id`. `data-col-id` is always rendered, except on the select and tools columns. Without `getRowId` (or under pivot), index-based ids are unstable, so `rowIntent` is ignored and a development `console.error` is logged.
295
+
296
+ An unregister runs one microtask after the element detaches, and a re-attach of the same element with the same role in that window reuses the registration. A ref forwarder that passes only non-null nodes leaks one registration on unmount, so forward `null` too. In development a duplicate live intent and key logs one warning.
297
+
298
+ Highlights are driven by `data-intent-highlight` (a pulse) and `data-intent-changed` (a dashed outline), styled by the base stylesheet. Tune them with `--intent-highlight-color`, `--intent-highlight-width`, `--intent-highlight-offset`, `--intent-highlight-duration` and `--intent-highlight-tint`. Apps that vendor `base.css` must regenerate it to get them.
299
+
280
300
  ## Install a single component (tree shaking)
281
301
 
282
302
  The package is unbundled ESM, `"sideEffects": ["**/*.css"]`, and every component has its own entry point:
@@ -1,9 +1,10 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  import type { ClassNames } from "../../utils/class-names.js";
3
4
  export type AttachmentStatus = "done" | "uploading" | "error";
4
5
  export type AttachmentVariant = "chip" | "preview";
5
6
  export type AttachmentPart = "root" | "thumbnail" | "text" | "name" | "detail" | "progress" | "remove";
6
- export interface AttachmentProps extends Omit<ComponentPropsWithoutRef<"fieldset">, "children"> {
7
+ export interface AttachmentProps extends Omit<ComponentPropsWithRef<"fieldset">, "children">, IntentProps {
7
8
  name: string;
8
9
  /** Pre-formatted size, e.g. `240 KB`. */
9
10
  size?: string;
@@ -20,4 +21,4 @@ export interface AttachmentProps extends Omit<ComponentPropsWithoutRef<"fieldset
20
21
  classNames?: ClassNames<AttachmentPart>;
21
22
  }
22
23
  /** File chip or preview tile for prompt attachments, with an optional remove button. */
23
- export declare function Attachment({ name, size, previewSrc, status, progress, variant, onRemove, className, classNames, ...props }: AttachmentProps): import("react").JSX.Element;
24
+ export declare function Attachment({ name, size, previewSrc, status, progress, variant, onRemove, className, classNames, intent, intentKey, ...props }: AttachmentProps): import("react").JSX.Element;
@@ -12,6 +12,8 @@ function Attachment({
12
12
  onRemove,
13
13
  className,
14
14
  classNames,
15
+ intent,
16
+ intentKey,
15
17
  ...props
16
18
  }) {
17
19
  const preview = variant === "preview";
@@ -80,9 +82,11 @@ function Attachment({
80
82
  IconAction,
81
83
  {
82
84
  label: `Quitar ${name}`,
85
+ intent,
86
+ intentKey,
83
87
  onClick: onRemove,
84
88
  className: cn(
85
- "size-5",
89
+ "size-6",
86
90
  preview && "absolute right-2.5 top-2.5 surface-overlay shadow-control",
87
91
  classNames?.remove
88
92
  ),
@@ -1,9 +1,10 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, ReactNode } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  import type { ClassNames } from "../../utils/class-names.js";
3
4
  export type ChatRole = "user" | "assistant" | "system";
4
5
  export type ChatMessageStatus = "sending" | "streaming" | "done" | "error";
5
6
  export type ChatMessagePart = "root" | "avatar" | "content" | "bubble" | "error" | "time";
6
- export interface ChatMessageProps extends Omit<ComponentPropsWithoutRef<"article">, "content"> {
7
+ export interface ChatMessageProps extends Omit<ComponentPropsWithRef<"article">, "content">, IntentProps {
7
8
  author: ChatRole;
8
9
  /** Display name, also the avatar's accessible name. */
9
10
  name?: string;
@@ -24,4 +25,4 @@ export interface ChatMessageProps extends Omit<ComponentPropsWithoutRef<"article
24
25
  classNames?: ClassNames<ChatMessagePart>;
25
26
  }
26
27
  /** One chat turn: avatar, bubble, status, streaming caret and an optional footer slot. */
27
- export declare function ChatMessage({ author, name, avatarSrc, status, time, content, children, footer, errorText, className, classNames, ...props }: ChatMessageProps): import("react").JSX.Element;
28
+ export declare function ChatMessage({ author, name, avatarSrc, status, time, content, children, footer, errorText, className, classNames, intent, intentKey, ...props }: ChatMessageProps): import("react").JSX.Element;
@@ -1,6 +1,7 @@
1
1
  import { jsx, jsxs } from "react/jsx-runtime";
2
2
  import { Avatar } from "../../atoms/avatar/avatar.js";
3
3
  import { CircleAlert } from "../../icons/index.js";
4
+ import { intentAttributes } from "../../intent/attributes.js";
4
5
  import { cn } from "../../utils/cn.js";
5
6
  import { Loader } from "../loader/loader.js";
6
7
  import { Markdown } from "../markdown/markdown.js";
@@ -16,6 +17,8 @@ function ChatMessage({
16
17
  errorText = "No se pudo enviar el mensaje.",
17
18
  className,
18
19
  classNames,
20
+ intent,
21
+ intentKey,
19
22
  ...props
20
23
  }) {
21
24
  const streaming = status === "streaming";
@@ -23,6 +26,7 @@ function ChatMessage({
23
26
  return /* @__PURE__ */ jsx(
24
27
  "article",
25
28
  {
29
+ ...intentAttributes({ intent, intentKey }),
26
30
  className: cn("flex justify-center", classNames?.root, className),
27
31
  "aria-label": name ?? "Sistema",
28
32
  ...props,
@@ -45,6 +49,7 @@ function ChatMessage({
45
49
  return /* @__PURE__ */ jsxs(
46
50
  "article",
47
51
  {
52
+ ...intentAttributes({ intent, intentKey }),
48
53
  "aria-label": name ?? (user ? "T\xFA" : "Asistente"),
49
54
  "aria-busy": streaming || status === "sending" ? "true" : void 0,
50
55
  className: cn(
@@ -13,8 +13,8 @@ const tokenClasses = {
13
13
  string: "text-success",
14
14
  comment: "text-ink-3 italic",
15
15
  number: "text-warning",
16
- function: "text-pal-cielo-deep",
17
- type: "text-pal-orquidea-deep",
16
+ function: "text-info",
17
+ type: "text-pal-orquidea-ink",
18
18
  property: "text-pal-cielo-ink",
19
19
  variable: "text-warning"
20
20
  };
@@ -1,7 +1,7 @@
1
- import { type ComponentPropsWithoutRef } from "react";
1
+ import { type ComponentPropsWithRef } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  export type ConversationPart = "root" | "scroller" | "content" | "jump";
4
- export interface ConversationProps extends Omit<ComponentPropsWithoutRef<"div">, "role"> {
4
+ export interface ConversationProps extends Omit<ComponentPropsWithRef<"div">, "role"> {
5
5
  /** Accessible name of the message log. */
6
6
  label?: string;
7
7
  /** Label of the "jump to latest" button. */
@@ -29,7 +29,7 @@ function Disclosure({
29
29
  "aria-controls": panelId,
30
30
  onClick: toggle,
31
31
  className: cn(
32
- "flex w-full min-w-0 cursor-pointer items-center gap-density-sm rounded-button text-left focus-visible:focus-ring",
32
+ "flex min-h-6 w-full min-w-0 cursor-pointer items-center gap-density-sm rounded-button text-left focus-visible:focus-ring",
33
33
  triggerClassName
34
34
  ),
35
35
  children: [
@@ -1,7 +1,8 @@
1
- import type { ComponentPropsWithoutRef } from "react";
2
- export interface IconActionProps extends ComponentPropsWithoutRef<"button"> {
1
+ import type { ComponentPropsWithRef } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
3
+ export interface IconActionProps extends ComponentPropsWithRef<"button">, IntentProps {
3
4
  /** Accessible name; the icon alone carries no text. */
4
5
  label: string;
5
6
  }
6
7
  /** Square ghost icon button used by the AI set (copy, regenerate, remove…). */
7
- export declare function IconAction({ label, className, children, ...props }: IconActionProps): import("react").JSX.Element;
8
+ export declare function IconAction({ label, className, children, intent, intentKey, ...props }: IconActionProps): import("react").JSX.Element;
@@ -1,14 +1,23 @@
1
1
  import { jsx } from "react/jsx-runtime";
2
+ import { intentAttributes } from "../../intent/attributes.js";
2
3
  import { cn } from "../../utils/cn.js";
3
- function IconAction({ label, className, children, ...props }) {
4
+ function IconAction({
5
+ label,
6
+ className,
7
+ children,
8
+ intent,
9
+ intentKey,
10
+ ...props
11
+ }) {
4
12
  return /* @__PURE__ */ jsx(
5
13
  "button",
6
14
  {
15
+ ...intentAttributes({ intent, intentKey }),
7
16
  type: "button",
8
17
  "aria-label": label,
9
18
  title: label,
10
19
  className: cn(
11
- "inline-grid size-7 shrink-0 cursor-pointer place-items-center rounded-button text-ink-3 pressable hover:bg-surface-2 hover:text-ink focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-45 aria-pressed:bg-accent-soft aria-pressed:text-accent-ink [&_svg]:size-3.5",
20
+ "inline-grid size-7 shrink-0 cursor-pointer place-items-center rounded-button text-ink-3 pressable hover:bg-surface-2 hover:text-ink focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-50 aria-pressed:bg-accent-soft aria-pressed:text-accent-ink [&_svg]:size-3.5",
12
21
  className
13
22
  ),
14
23
  ...props,
@@ -1,6 +1,9 @@
1
- import { type ComponentPropsWithoutRef } from "react";
1
+ import { type ComponentPropsWithRef } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  export type MessageFeedback = "like" | "dislike" | null;
3
- export interface MessageActionsProps extends Omit<ComponentPropsWithoutRef<"div">, "onCopy"> {
4
+ export type MessageActionName = "copy" | "regenerate" | "like" | "dislike";
5
+ export interface MessageActionsProps extends Omit<ComponentPropsWithRef<"div">, "onCopy"> {
6
+ actionIntents?: Partial<Record<MessageActionName, IntentProps>>;
4
7
  /** Text copied by the copy button. */
5
8
  text: string;
6
9
  onCopy?: (text: string) => void;
@@ -12,4 +15,4 @@ export interface MessageActionsProps extends Omit<ComponentPropsWithoutRef<"div"
12
15
  defaultFeedback?: MessageFeedback;
13
16
  }
14
17
  /** Copy, regenerate, like and dislike for an assistant message. Feedback toggles off on re-press. */
15
- export declare function MessageActions({ text, onCopy, onRegenerate, onFeedback, feedback: feedbackProp, defaultFeedback, className, ...props }: MessageActionsProps): import("react").JSX.Element;
18
+ export declare function MessageActions({ text, onCopy, onRegenerate, onFeedback, feedback: feedbackProp, defaultFeedback, actionIntents, className, ...props }: MessageActionsProps): import("react").JSX.Element;
@@ -2,6 +2,7 @@
2
2
  import { Fragment, jsx, jsxs } from "react/jsx-runtime";
3
3
  import { useState } from "react";
4
4
  import { Check, Copy, RefreshCw, ThumbsDown, ThumbsUp } from "../../icons/index.js";
5
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
5
6
  import { cn } from "../../utils/cn.js";
6
7
  import { IconAction } from "../internal/icon-action.js";
7
8
  import { useCopy } from "../internal/use-copy.js";
@@ -12,9 +13,18 @@ function MessageActions({
12
13
  onFeedback,
13
14
  feedback: feedbackProp,
14
15
  defaultFeedback = null,
16
+ actionIntents,
15
17
  className,
16
18
  ...props
17
19
  }) {
20
+ const copyIntent = actionIntents?.copy;
21
+ const regenerateIntent = actionIntents?.regenerate;
22
+ const likeIntent = actionIntents?.like;
23
+ const dislikeIntent = actionIntents?.dislike;
24
+ const copyRef = useIntentTarget({ ...copyIntent });
25
+ const regenerateRef = useIntentTarget({ ...regenerateIntent });
26
+ const likeRef = useIntentTarget({ ...likeIntent });
27
+ const dislikeRef = useIntentTarget({ ...dislikeIntent });
18
28
  const { copied, copy } = useCopy();
19
29
  const [state, setState] = useState(defaultFeedback);
20
30
  const feedback = feedbackProp === void 0 ? state : feedbackProp;
@@ -34,6 +44,8 @@ function MessageActions({
34
44
  /* @__PURE__ */ jsx(
35
45
  IconAction,
36
46
  {
47
+ ...copyIntent,
48
+ ref: copyRef,
37
49
  label: copied ? "Mensaje copiado" : "Copiar mensaje",
38
50
  onClick: () => {
39
51
  copy(text);
@@ -42,11 +54,22 @@ function MessageActions({
42
54
  children: copied ? /* @__PURE__ */ jsx(Check, { "aria-hidden": true }) : /* @__PURE__ */ jsx(Copy, { "aria-hidden": true })
43
55
  }
44
56
  ),
45
- onRegenerate ? /* @__PURE__ */ jsx(IconAction, { label: "Regenerar respuesta", onClick: onRegenerate, children: /* @__PURE__ */ jsx(RefreshCw, { "aria-hidden": true }) }) : null,
57
+ onRegenerate ? /* @__PURE__ */ jsx(
58
+ IconAction,
59
+ {
60
+ ...regenerateIntent,
61
+ ref: regenerateRef,
62
+ label: "Regenerar respuesta",
63
+ onClick: onRegenerate,
64
+ children: /* @__PURE__ */ jsx(RefreshCw, { "aria-hidden": true })
65
+ }
66
+ ) : null,
46
67
  onFeedback ? /* @__PURE__ */ jsxs(Fragment, { children: [
47
68
  /* @__PURE__ */ jsx(
48
69
  IconAction,
49
70
  {
71
+ ...likeIntent,
72
+ ref: likeRef,
50
73
  label: "Me gusta",
51
74
  "aria-pressed": feedback === "like",
52
75
  onClick: () => choose("like"),
@@ -56,6 +79,8 @@ function MessageActions({
56
79
  /* @__PURE__ */ jsx(
57
80
  IconAction,
58
81
  {
82
+ ...dislikeIntent,
83
+ ref: dislikeRef,
59
84
  label: "No me gusta",
60
85
  "aria-pressed": feedback === "dislike",
61
86
  onClick: () => choose("dislike"),
@@ -1,7 +1,8 @@
1
1
  import { type ReactNode } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  import type { ClassNames } from "../../utils/class-names.js";
3
4
  export type PromptInputPart = "root" | "box" | "attachments" | "textarea" | "toolbar" | "actions" | "send" | "stop" | "hint";
4
- export interface PromptInputProps {
5
+ export interface PromptInputProps extends IntentProps {
5
6
  value?: string;
6
7
  defaultValue?: string;
7
8
  onValueChange?: (value: string) => void;
@@ -30,4 +31,4 @@ export interface PromptInputProps {
30
31
  * Composer: autosizing textarea, Enter to send, Shift+Enter for a new line, attachments slot
31
32
  * and a stop button while a response streams.
32
33
  */
33
- export declare function PromptInput({ value: valueProp, defaultValue, onValueChange, onSubmit, streaming, onStop, placeholder, label, disabled, maxRows, attachments, actions, hint, className, classNames, }: PromptInputProps): import("react").JSX.Element;
34
+ export declare function PromptInput({ value: valueProp, defaultValue, onValueChange, onSubmit, streaming, onStop, placeholder, label, disabled, maxRows, attachments, actions, hint, className, classNames, intent, intentKey, }: PromptInputProps): import("react").JSX.Element;
@@ -6,7 +6,10 @@ import {
6
6
  useState
7
7
  } from "react";
8
8
  import { ArrowUp, Square } from "../../icons/index.js";
9
+ import { intentAttributes } from "../../intent/attributes.js";
10
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
9
11
  import { cn } from "../../utils/cn.js";
12
+ import { useComposedRefs } from "../../utils/compose.js";
10
13
  import { shouldSubmit } from "./keys.js";
11
14
  function PromptInput({
12
15
  value: valueProp,
@@ -23,11 +26,17 @@ function PromptInput({
23
26
  actions,
24
27
  hint,
25
28
  className,
26
- classNames
29
+ classNames,
30
+ intent,
31
+ intentKey
27
32
  }) {
28
33
  const [state, setState] = useState(defaultValue);
29
34
  const value = valueProp ?? state;
30
35
  const area = useRef(null);
36
+ const textareaRef = useComposedRefs(
37
+ area,
38
+ useIntentTarget({ intent, intentKey })
39
+ );
31
40
  useLayoutEffect(() => {
32
41
  const el = area.current;
33
42
  if (!el) return;
@@ -82,7 +91,8 @@ function PromptInput({
82
91
  /* @__PURE__ */ jsx(
83
92
  "textarea",
84
93
  {
85
- ref: area,
94
+ ...intentAttributes({ intent, intentKey }),
95
+ ref: textareaRef,
86
96
  rows: 1,
87
97
  value,
88
98
  disabled,
@@ -91,7 +101,7 @@ function PromptInput({
91
101
  onChange: (event) => set(event.target.value),
92
102
  onKeyDown,
93
103
  className: cn(
94
- "block max-h-none w-full min-w-0 resize-none bg-transparent px-1 py-1 text-body leading-normal text-ink outline-none placeholder:text-ink-3 disabled:cursor-not-allowed",
104
+ "block max-h-none w-full min-w-0 resize-none bg-transparent px-1 py-1 text-body leading-normal text-ink outline-none placeholder:text-ink-3 disabled:cursor-not-allowed disabled:opacity-50",
95
105
  classNames?.textarea
96
106
  )
97
107
  }
@@ -120,7 +130,7 @@ function PromptInput({
120
130
  "aria-label": "Enviar mensaje",
121
131
  disabled: !canSend,
122
132
  className: cn(
123
- "inline-grid size-8 shrink-0 cursor-pointer place-items-center rounded-button bg-accent text-on-accent pressable focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-45",
133
+ "inline-grid size-8 shrink-0 cursor-pointer place-items-center rounded-button bg-accent text-on-accent pressable focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-50",
124
134
  classNames?.send
125
135
  ),
126
136
  children: /* @__PURE__ */ jsx(ArrowUp, { "aria-hidden": true, className: "size-4" })
@@ -1,12 +1,13 @@
1
- import type { ComponentPropsWithoutRef } from "react";
2
- export interface PromptSuggestionProps extends Omit<ComponentPropsWithoutRef<"button">, "onSelect" | "children"> {
1
+ import type { ComponentPropsWithRef } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
3
+ export interface PromptSuggestionProps extends Omit<ComponentPropsWithRef<"button">, "onSelect" | "children">, IntentProps {
3
4
  /** Receives the suggestion text when pressed (the visible label is the text). */
4
5
  onSelect?: (text: string) => void;
5
6
  children: string;
6
7
  }
7
8
  /** Chip with a suggested prompt. Pressing it hands the text to `onSelect`. */
8
- export declare function PromptSuggestion({ onSelect, children, className, onClick, ...props }: PromptSuggestionProps): import("react").JSX.Element;
9
- export interface PromptSuggestionListProps extends ComponentPropsWithoutRef<"fieldset"> {
9
+ export declare function PromptSuggestion({ onSelect, children, className, onClick, intent, intentKey, ...props }: PromptSuggestionProps): import("react").JSX.Element;
10
+ export interface PromptSuggestionListProps extends ComponentPropsWithRef<"fieldset"> {
10
11
  label?: string;
11
12
  }
12
13
  /** Wrapping group of suggestion chips. */
@@ -1,16 +1,20 @@
1
1
  import { jsx } from "react/jsx-runtime";
2
+ import { intentAttributes } from "../../intent/attributes.js";
2
3
  import { cn } from "../../utils/cn.js";
3
4
  function PromptSuggestion({
4
5
  onSelect,
5
6
  children,
6
7
  className,
7
8
  onClick,
9
+ intent,
10
+ intentKey,
8
11
  ...props
9
12
  }) {
10
13
  return /* @__PURE__ */ jsx(
11
14
  "button",
12
15
  {
13
16
  type: "button",
17
+ ...intentAttributes({ intent, intentKey }),
14
18
  onClick: (event) => {
15
19
  onClick?.(event);
16
20
  onSelect?.(children);
@@ -1,7 +1,8 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
+ import type { IntentProps } from "../../intent/types.js";
2
3
  import type { ClassNames } from "../../utils/class-names.js";
3
4
  export type SourcePart = "root" | "index" | "host" | "card" | "cardHost" | "cardTitle" | "cardSnippet";
4
- export interface SourceProps extends Omit<ComponentPropsWithoutRef<"a">, "href" | "title"> {
5
+ export interface SourceProps extends Omit<ComponentPropsWithRef<"a">, "href" | "title">, IntentProps {
5
6
  /** Citation number shown in the chip. */
6
7
  index?: number;
7
8
  title: string;
@@ -13,4 +14,4 @@ export interface SourceProps extends Omit<ComponentPropsWithoutRef<"a">, "href"
13
14
  classNames?: ClassNames<SourcePart>;
14
15
  }
15
16
  /** Citation chip with a hover/focus preview of the source (title, host and excerpt). */
16
- export declare function Source({ index, title, url, snippet, className, classNames, ...props }: SourceProps): import("react").JSX.Element;
17
+ export declare function Source({ index, title, url, snippet, className, classNames, intent, intentKey, ref, ...props }: SourceProps): import("react").JSX.Element;