@jcsoftdev/ui 0.9.0 → 0.10.1

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 (461) hide show
  1. package/CHANGELOG.md +132 -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 +11 -3
  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 +6 -5
  246. package/dist/navigation/tabs/tabs.js +44 -2
  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 +14 -8
  254. package/dist/overlays/dialog/dialog.js +29 -6
  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/shell/topbar/topbar.js +2 -2
  280. package/dist/showcase/bento.js +1 -0
  281. package/dist/utils/is-production.d.ts +1 -0
  282. package/dist/utils/is-production.js +6 -0
  283. package/dist/utils/slot.js +17 -3
  284. package/package.json +2 -2
  285. package/src/ai/attachment/attachment.tsx +10 -3
  286. package/src/ai/chat-message/chat-message.tsx +10 -2
  287. package/src/ai/code-block/code-block.tsx +2 -2
  288. package/src/ai/conversation/conversation.tsx +2 -2
  289. package/src/ai/internal/disclosure.tsx +1 -1
  290. package/src/ai/internal/icon-action.tsx +14 -4
  291. package/src/ai/message-actions/message-actions.tsx +28 -3
  292. package/src/ai/prompt-input/prompt-input.tsx +15 -4
  293. package/src/ai/prompt-suggestion/prompt-suggestion.tsx +9 -3
  294. package/src/ai/source/source.tsx +17 -3
  295. package/src/ai/tool-call/tool-call.tsx +6 -1
  296. package/src/atoms/big-date/big-date.tsx +2 -2
  297. package/src/atoms/button/button.tsx +11 -1
  298. package/src/atoms/checkbox/checkbox.tsx +40 -21
  299. package/src/atoms/chip/chip.tsx +12 -2
  300. package/src/atoms/divider/divider.tsx +2 -2
  301. package/src/atoms/elapsed-time/elapsed-time.tsx +14 -10
  302. package/src/atoms/elapsed-time/model.ts +57 -0
  303. package/src/atoms/icon-button/icon-button.tsx +3 -1
  304. package/src/atoms/internal/labelled-control.tsx +83 -0
  305. package/src/atoms/number-value/number-value.tsx +2 -2
  306. package/src/atoms/pressable-feedback/pressable-feedback.tsx +16 -3
  307. package/src/atoms/progress/progress.tsx +2 -2
  308. package/src/atoms/radio-group/radio-group-primitive.tsx +13 -2
  309. package/src/atoms/radio-group/radio-group.tsx +5 -1
  310. package/src/atoms/seal/seal.tsx +2 -2
  311. package/src/atoms/status-pill/status-pill.tsx +1 -1
  312. package/src/atoms/switch/switch.tsx +43 -9
  313. package/src/atoms/table-glyph/table-glyph.tsx +2 -2
  314. package/src/atoms/trend-chip/trend-chip.tsx +2 -2
  315. package/src/auth/login-form/parts.tsx +2 -2
  316. package/src/calendar/date-calendar/date-calendar.tsx +1 -1
  317. package/src/calendar/day-chip/day-chip.tsx +14 -2
  318. package/src/calendar/event-block/event-block.tsx +9 -1
  319. package/src/calendar/internal/grid-navigation.ts +47 -0
  320. package/src/calendar/internal/intent.ts +10 -0
  321. package/src/calendar/internal/month-model.ts +23 -0
  322. package/src/calendar/internal/types.ts +4 -0
  323. package/src/calendar/month-view/month-grid.tsx +248 -0
  324. package/src/calendar/month-view/month-view.tsx +32 -148
  325. package/src/calendar/week-view/week-view.tsx +87 -10
  326. package/src/charts/README.md +10 -0
  327. package/src/charts/bar-chart/bar-race-chart.tsx +1 -1
  328. package/src/charts/core/breadcrumb.tsx +1 -1
  329. package/src/charts/core/chart-states.tsx +1 -1
  330. package/src/charts/core/distribution/xy-points.tsx +4 -2
  331. package/src/charts/crossfilter/crossfilter.tsx +1 -1
  332. package/src/charts/gantt-chart/gantt-chart.tsx +1 -1
  333. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  334. package/src/charts/sankey-chart/sankey-chart.tsx +1 -4
  335. package/src/charts/tree-chart/tree-chart.tsx +1 -1
  336. package/src/containers/action-bar/action-bar.tsx +3 -3
  337. package/src/containers/aside/aside.tsx +3 -3
  338. package/src/containers/banner/banner.tsx +2 -2
  339. package/src/containers/card/card.tsx +7 -5
  340. package/src/containers/carousel/carousel.tsx +4 -4
  341. package/src/containers/cols/cols.tsx +3 -3
  342. package/src/containers/comment/comment.tsx +2 -2
  343. package/src/containers/confirm-action/confirm-action.tsx +11 -2
  344. package/src/containers/dashboard/dashboard.tsx +4 -4
  345. package/src/containers/data-grid/column-menu.tsx +1 -1
  346. package/src/containers/data-grid/data-grid.tsx +53 -4
  347. package/src/containers/data-grid/formula-bar.tsx +1 -1
  348. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  349. package/src/containers/data-grid/tool-panel.tsx +1 -1
  350. package/src/containers/description-list/description-list.tsx +2 -2
  351. package/src/containers/detail-header/detail-header.tsx +2 -2
  352. package/src/containers/facts/facts.tsx +2 -2
  353. package/src/containers/feed/feed.tsx +16 -3
  354. package/src/containers/file-tree/file-tree.tsx +11 -0
  355. package/src/containers/file-tree/model.ts +2 -0
  356. package/src/containers/filter-bar/filter-bar.tsx +2 -2
  357. package/src/containers/floor-plan/floor-plan.tsx +18 -10
  358. package/src/containers/floor-plan/index.ts +7 -1
  359. package/src/containers/floor-plan/model.ts +16 -0
  360. package/src/containers/generic-row/generic-row.tsx +9 -6
  361. package/src/containers/grid/grid.tsx +2 -2
  362. package/src/containers/hbars/hbars.tsx +23 -21
  363. package/src/containers/highlight-line/highlight-line.tsx +2 -2
  364. package/src/containers/item-card-group/item-card-group.tsx +10 -2
  365. package/src/containers/kanban/kanban.tsx +13 -0
  366. package/src/containers/kanban/model.ts +2 -0
  367. package/src/containers/kpi/kpi-model.ts +37 -0
  368. package/src/containers/kpi/kpi-parts.tsx +153 -0
  369. package/src/containers/kpi/kpi.tsx +10 -176
  370. package/src/containers/kpi-group/kpi-group.tsx +2 -2
  371. package/src/containers/list-detail/list-detail.tsx +22 -12
  372. package/src/containers/note/note.tsx +2 -2
  373. package/src/containers/order-ticket/index.ts +2 -0
  374. package/src/containers/order-ticket/model.ts +21 -0
  375. package/src/containers/order-ticket/order-ticket.tsx +30 -13
  376. package/src/containers/page/page.tsx +2 -2
  377. package/src/containers/page-header/back.tsx +2 -2
  378. package/src/containers/page-header/page-header.tsx +6 -6
  379. package/src/containers/pagination/cursor-pagination.tsx +2 -2
  380. package/src/containers/pagination/pagination.tsx +4 -4
  381. package/src/containers/resizable/resizable.tsx +7 -5
  382. package/src/containers/row-actions/row-actions.tsx +18 -3
  383. package/src/containers/scrolly/scrolly.tsx +1 -1
  384. package/src/containers/section/section.tsx +21 -8
  385. package/src/containers/selectable-card/selectable-card.tsx +13 -2
  386. package/src/containers/settings-layout/settings-layout.tsx +15 -5
  387. package/src/containers/settings-row/settings-row.tsx +7 -2
  388. package/src/containers/shortcuts/shortcuts.tsx +4 -4
  389. package/src/containers/stack/stack.tsx +2 -2
  390. package/src/containers/table/table.tsx +35 -14
  391. package/src/containers/timeline/timeline.tsx +17 -3
  392. package/src/containers/toolbar/toolbar.tsx +3 -3
  393. package/src/forms/accent-picker/accent-picker.tsx +27 -2
  394. package/src/forms/checkbox-button-group/checkbox-button-group.tsx +18 -1
  395. package/src/forms/chip-group/chip-group.tsx +23 -2
  396. package/src/forms/combobox/combobox.tsx +15 -4
  397. package/src/forms/copy-field/copy-field.tsx +11 -2
  398. package/src/forms/date-picker/date-picker.tsx +23 -12
  399. package/src/forms/date-picker/date-time-picker.tsx +9 -3
  400. package/src/forms/dropzone/dropzone.tsx +18 -3
  401. package/src/forms/emoji-picker/emoji-picker.tsx +10 -2
  402. package/src/forms/emoji-reaction-button/emoji-reaction-button.tsx +9 -1
  403. package/src/forms/field/field.tsx +2 -2
  404. package/src/forms/fieldset/fieldset.tsx +2 -2
  405. package/src/forms/form/form.tsx +13 -5
  406. package/src/forms/form-footer/form-footer.tsx +2 -2
  407. package/src/forms/form-grid/form-grid.tsx +3 -3
  408. package/src/forms/form-section/form-section.tsx +2 -2
  409. package/src/forms/inline-select/inline-select.tsx +14 -3
  410. package/src/forms/input/input.tsx +14 -3
  411. package/src/forms/internal/button-option.tsx +2 -0
  412. package/src/forms/label/label.tsx +2 -2
  413. package/src/forms/native-select/native-select.tsx +9 -2
  414. package/src/forms/number-stepper/number-stepper.tsx +14 -3
  415. package/src/forms/password-input/password-input.tsx +12 -0
  416. package/src/forms/pin-input/pin-input.tsx +9 -1
  417. package/src/forms/radio-button-group/radio-button-group.tsx +18 -1
  418. package/src/forms/rating/rating.tsx +14 -1
  419. package/src/forms/select/select.tsx +14 -4
  420. package/src/forms/select-menu/select-menu.tsx +15 -4
  421. package/src/forms/slider/model.ts +5 -0
  422. package/src/forms/slider/slider.tsx +13 -3
  423. package/src/forms/textarea/textarea.tsx +7 -4
  424. package/src/forms/time-input/time-input.tsx +19 -5
  425. package/src/i18n/strings.ts +18 -0
  426. package/src/intent/attributes.ts +96 -0
  427. package/src/intent/bridge.tsx +25 -0
  428. package/src/intent/index.ts +24 -0
  429. package/src/intent/target-registrations.ts +127 -0
  430. package/src/intent/types.ts +44 -0
  431. package/src/intent/use-intent-target.ts +96 -0
  432. package/src/navigation/breadcrumbs/breadcrumbs.tsx +18 -5
  433. package/src/navigation/floating-toc/floating-toc.tsx +7 -2
  434. package/src/navigation/floating-toc/model.ts +3 -1
  435. package/src/navigation/segmented/segmented.tsx +14 -2
  436. package/src/navigation/stepper/stepper.tsx +7 -2
  437. package/src/navigation/tabs/tabs-nav.tsx +16 -3
  438. package/src/navigation/tabs/tabs.tsx +57 -4
  439. package/src/navigation/wizard/wizard.tsx +12 -4
  440. package/src/overlays/alert-dialog/alert-dialog.tsx +21 -4
  441. package/src/overlays/context-menu/context-menu.tsx +58 -11
  442. package/src/overlays/dialog/dialog.tsx +49 -20
  443. package/src/overlays/drawer/drawer.tsx +15 -4
  444. package/src/overlays/dropdown-menu/dropdown-menu.tsx +67 -10
  445. package/src/overlays/hover-card/hover-card.tsx +13 -2
  446. package/src/overlays/popover/popover.tsx +12 -1
  447. package/src/overlays/tooltip/model.ts +8 -0
  448. package/src/overlays/tooltip/tooltip.tsx +15 -2
  449. package/src/palette/command-palette/command-palette.tsx +66 -3
  450. package/src/palette/command-palette/index.ts +1 -0
  451. package/src/palette/command-palette/model.ts +15 -0
  452. package/src/primitives/command/command.tsx +4 -1
  453. package/src/primitives/dialog/dialog.tsx +1 -4
  454. package/src/primitives/popper/popper.tsx +16 -5
  455. package/src/shell/bottom-nav/bottom-nav.tsx +67 -55
  456. package/src/shell/sidebar/sidebar.tsx +22 -4
  457. package/src/shell/topbar/topbar.tsx +2 -2
  458. package/src/showcase/bento.tsx +2 -0
  459. package/src/utils/is-production.ts +3 -0
  460. package/src/utils/slot.tsx +21 -3
  461. package/styles/base.css +39 -0
@@ -3,6 +3,7 @@
3
3
  import { type ComponentProps, useEffect, useId, useMemo, useState } from "react";
4
4
  import { isIsoDate, type WeekStart } from "../../calendar/internal/date-utils.js";
5
5
  import { useUiStrings } from "../../i18n/index.js";
6
+ import type { IntentProps } from "../../intent/types.js";
6
7
  import type { ClassNames } from "../../utils/class-names.js";
7
8
  import { cn } from "../../utils/cn.js";
8
9
  import type { Material } from "../../utils/material.js";
@@ -28,9 +29,10 @@ export type DateTimePickerPart =
28
29
 
29
30
  export interface DateTimePickerProps
30
31
  extends Omit<
31
- ComponentProps<"div">,
32
- "defaultValue" | "onChange" | "children" | "role" | "id" | "aria-label" | "aria-labelledby"
33
- > {
32
+ ComponentProps<"div">,
33
+ "defaultValue" | "onChange" | "children" | "role" | "id" | "aria-label" | "aria-labelledby"
34
+ >,
35
+ IntentProps {
34
36
  /**
35
37
  * "YYYY-MM-DDTHH:mm" (controlled), a wall-clock date and time with no zone: the component never
36
38
  * converts it, so "2026-09-07T09:30" stays that string whatever the browser's time zone is.
@@ -96,6 +98,8 @@ export function DateTimePicker({
96
98
  "aria-labelledby": ariaLabelledBy,
97
99
  "aria-describedby": ariaDescribedBy,
98
100
  "aria-invalid": ariaInvalid,
101
+ intent,
102
+ intentKey,
99
103
  ...props
100
104
  }: DateTimePickerProps) {
101
105
  const strings = useUiStrings();
@@ -161,6 +165,8 @@ export function DateTimePicker({
161
165
  >
162
166
  <DatePicker
163
167
  {...shared}
168
+ intent={intent}
169
+ intentKey={intentKey}
164
170
  id={dateId}
165
171
  value={parts.date}
166
172
  onValueChange={(date) => update({ ...parts, date })}
@@ -12,8 +12,12 @@ import {
12
12
  } from "react";
13
13
  import { useUiStrings } from "../../i18n/index.js";
14
14
  import { Upload, X } from "../../icons/index.js";
15
+ import { intentAttributes } from "../../intent/attributes.js";
16
+ import type { IntentProps } from "../../intent/types.js";
17
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
15
18
  import type { ClassNames } from "../../utils/class-names.js";
16
19
  import { cn } from "../../utils/cn.js";
20
+ import { useComposedRefs } from "../../utils/compose.js";
17
21
 
18
22
  export type DropzoneRejectionReason = "type" | "size";
19
23
 
@@ -24,7 +28,7 @@ export interface DropzoneRejection {
24
28
 
25
29
  export type DropzonePart = "root" | "icon" | "title" | "hint" | "browse" | "list" | "file";
26
30
 
27
- export interface DropzoneProps {
31
+ export interface DropzoneProps extends IntentProps {
28
32
  onFiles: (files: File[]) => void;
29
33
  /** Called with the rejected files; the caller composes the user-facing message. */
30
34
  onReject?: (rejections: DropzoneRejection[]) => void;
@@ -133,9 +137,13 @@ export function Dropzone({
133
137
  "aria-invalid": ariaInvalid,
134
138
  className,
135
139
  classNames,
140
+ intent,
141
+ intentKey,
136
142
  }: DropzoneProps) {
137
143
  const strings = useUiStrings();
138
144
  const inputRef = useRef<HTMLInputElement>(null);
145
+ const targetRef = useIntentTarget({ intent, intentKey });
146
+ const fieldInputRef = useComposedRefs<HTMLInputElement>(inputRef, targetRef);
139
147
  const [dragging, setDragging] = useState(false);
140
148
  const [selected, setSelected] = useState<File[]>([]);
141
149
  const autoId = useId();
@@ -259,7 +267,13 @@ export function Dropzone({
259
267
  {browseLabel}
260
268
  </span>
261
269
  ) : (
262
- <button type="button" className={browse} onClick={() => inputRef.current?.click()}>
270
+ <button
271
+ type="button"
272
+ {...intentAttributes({ intent, intentKey })}
273
+ ref={targetRef}
274
+ className={browse}
275
+ onClick={() => inputRef.current?.click()}
276
+ >
263
277
  {browseLabel}
264
278
  </button>
265
279
  )}
@@ -296,7 +310,8 @@ export function Dropzone({
296
310
  ) : null}
297
311
  {field ? (
298
312
  <input
299
- ref={inputRef}
313
+ {...intentAttributes({ intent, intentKey })}
314
+ ref={fieldInputRef}
300
315
  id={inputId}
301
316
  name={name}
302
317
  type="file"
@@ -2,8 +2,12 @@
2
2
 
3
3
  import { type KeyboardEvent, useId, useMemo, useRef, useState } from "react";
4
4
  import { Search } from "../../icons/index.js";
5
+ import { intentAttributes } from "../../intent/attributes.js";
6
+ import type { IntentProps } from "../../intent/types.js";
7
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
5
8
  import type { ClassNames } from "../../utils/class-names.js";
6
9
  import { cn } from "../../utils/cn.js";
10
+ import { useComposedRefs } from "../../utils/compose.js";
7
11
  import { EMOJI_CATEGORIES, type EmojiCategory, type EmojiEntry } from "./emoji-data.js";
8
12
  import { gridMove, searchEmojis } from "./model.js";
9
13
 
@@ -19,7 +23,7 @@ export type EmojiPickerPart =
19
23
  | "emoji"
20
24
  | "empty";
21
25
 
22
- export interface EmojiPickerProps {
26
+ export interface EmojiPickerProps extends IntentProps {
23
27
  onSelect?: (emoji: string) => void;
24
28
  /** Replaces the built-in dataset (`EMOJI_CATEGORIES`). */
25
29
  categories?: EmojiCategory[];
@@ -43,9 +47,12 @@ export function EmojiPicker({
43
47
  searchPlaceholder = "Buscar emoji",
44
48
  className,
45
49
  classNames,
50
+ intent,
51
+ intentKey,
46
52
  }: EmojiPickerProps) {
47
53
  const baseId = useId();
48
54
  const grid = useRef<HTMLDivElement>(null);
55
+ const gridRef = useComposedRefs<HTMLDivElement>(grid, useIntentTarget({ intent, intentKey }));
49
56
  const [query, setQuery] = useState("");
50
57
  const [categoryId, setCategoryId] = useState(defaultCategory ?? categories[0]?.id);
51
58
  const [active, setActive] = useState(0);
@@ -142,7 +149,8 @@ export function EmojiPicker({
142
149
 
143
150
  {/* biome-ignore lint/a11y/useSemanticElements: arrow-key grid of buttons with a roving tabindex */}
144
151
  <div
145
- ref={grid}
152
+ {...intentAttributes({ intent, intentKey })}
153
+ ref={gridRef}
146
154
  role="group"
147
155
  aria-labelledby={`${baseId}-title`}
148
156
  onKeyDown={onKeyDown}
@@ -2,6 +2,9 @@
2
2
 
3
3
  import { useState } from "react";
4
4
  import { SmilePlus } from "../../icons/index.js";
5
+ import { intentAttributes } from "../../intent/attributes.js";
6
+ import type { IntentProps } from "../../intent/types.js";
7
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
5
8
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
6
9
  import type { ClassNames } from "../../utils/class-names.js";
7
10
  import { cn } from "../../utils/cn.js";
@@ -9,7 +12,7 @@ import { EmojiPicker } from "../emoji-picker/emoji-picker.js";
9
12
 
10
13
  export type EmojiReactionButtonPart = "root" | "emoji" | "count";
11
14
 
12
- export interface EmojiReactionButtonProps {
15
+ export interface EmojiReactionButtonProps extends IntentProps {
13
16
  emoji: string;
14
17
  count: number;
15
18
  /** Whether the current user has used this reaction. */
@@ -30,9 +33,14 @@ export function EmojiReactionButton({
30
33
  disabled,
31
34
  className,
32
35
  classNames,
36
+ intent,
37
+ intentKey,
33
38
  }: EmojiReactionButtonProps) {
39
+ const buttonRef = useIntentTarget<HTMLButtonElement>({ intent, intentKey });
34
40
  return (
35
41
  <button
42
+ {...intentAttributes({ intent, intentKey })}
43
+ ref={buttonRef}
36
44
  type="button"
37
45
  aria-pressed={reacted}
38
46
  aria-label={`${emoji} ${count}`}
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
- type ComponentPropsWithoutRef,
4
+ type ComponentPropsWithRef,
5
5
  cloneElement,
6
6
  Fragment,
7
7
  isValidElement,
@@ -33,7 +33,7 @@ const FALLBACK_CONTROL = 'button:not([tabindex="-1"]), [tabindex]:not([tabindex=
33
33
 
34
34
  export type FieldPart = "root" | "label" | "optional" | "required" | "hint" | "error";
35
35
 
36
- export interface FieldProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "id"> {
36
+ export interface FieldProps extends Omit<ComponentPropsWithRef<"div">, "children" | "id"> {
37
37
  /** The label content: text or any node (an icon, a tooltip trigger). */
38
38
  label: ReactNode;
39
39
  hint?: string;
@@ -1,7 +1,7 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, ReactNode } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export interface FieldsetProps extends Omit<ComponentPropsWithoutRef<"fieldset">, "title"> {
4
+ export interface FieldsetProps extends Omit<ComponentPropsWithRef<"fieldset">, "title"> {
5
5
  /** The group name; announced with each control inside. */
6
6
  legend: ReactNode;
7
7
  description?: ReactNode;
@@ -1,14 +1,22 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, ReactNode } from "react";
2
+ import { intentAttributes } from "../../intent/attributes.js";
3
+ import type { IntentProps } from "../../intent/types.js";
2
4
  import { cn } from "../../utils/cn.js";
3
5
 
4
- export type FormProps = ComponentPropsWithoutRef<"form">;
6
+ export interface FormProps extends ComponentPropsWithRef<"form">, IntentProps {}
5
7
 
6
8
  /** Vertical form layout; every `<form>` attribute and handler passes through. */
7
- export function Form({ className, ...props }: FormProps) {
8
- return <form className={cn("flex min-w-0 flex-col gap-4", className)} {...props} />;
9
+ export function Form({ className, intent, intentKey, ...props }: FormProps) {
10
+ return (
11
+ <form
12
+ className={cn("flex min-w-0 flex-col gap-4", className)}
13
+ {...intentAttributes({ intent, intentKey })}
14
+ {...props}
15
+ />
16
+ );
9
17
  }
10
18
 
11
- interface FormMessageProps extends Omit<ComponentPropsWithoutRef<"p">, "role" | "children"> {
19
+ interface FormMessageProps extends Omit<ComponentPropsWithRef<"p">, "role" | "children"> {
12
20
  /** Message text; `null`, `undefined` and an empty string render nothing. */
13
21
  message: ReactNode | null | undefined;
14
22
  }
@@ -1,11 +1,11 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
3
+ import type { ComponentPropsWithRef, ReactNode } from "react";
4
4
  import { Button } from "../../atoms/button/index.js";
5
5
  import { useUiStrings } from "../../i18n/index.js";
6
6
  import { cn } from "../../utils/cn.js";
7
7
 
8
- export interface FormFooterProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
8
+ export interface FormFooterProps extends Omit<ComponentPropsWithRef<"div">, "children"> {
9
9
  /** Called by the cancel button; without it no cancel button renders. */
10
10
  onCancel?: () => void;
11
11
  cancelLabel?: string;
@@ -1,10 +1,10 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
4
  export type FormGridColumns = 1 | 2 | 3;
5
5
  export type FormGridSpan = 1 | 2 | 3 | "full";
6
6
 
7
- export interface FormGridProps extends ComponentPropsWithoutRef<"div"> {
7
+ export interface FormGridProps extends ComponentPropsWithRef<"div"> {
8
8
  /**
9
9
  * Largest column count, reached by container width: 2 columns from 620px, 3 from 900px
10
10
  * (the wrapper is the size container). `1` never splits. Default `2`.
@@ -38,7 +38,7 @@ export function FormGrid({ columns = 2, className, ...props }: FormGridProps) {
38
38
  );
39
39
  }
40
40
 
41
- export interface FormGridItemProps extends ComponentPropsWithoutRef<"div"> {
41
+ export interface FormGridItemProps extends ComponentPropsWithRef<"div"> {
42
42
  /**
43
43
  * Columns the item spans once the grid has them; it never adds a column the grid does not
44
44
  * have. `"full"` spans every column at any width. Default `1`.
@@ -1,7 +1,7 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import type { ComponentPropsWithRef, ReactNode } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export interface FormSectionProps extends Omit<ComponentPropsWithoutRef<"section">, "title"> {
4
+ export interface FormSectionProps extends Omit<ComponentPropsWithRef<"section">, "title"> {
5
5
  title: ReactNode;
6
6
  description?: ReactNode;
7
7
  /** The fields; usually a `FormGrid`. */
@@ -1,5 +1,7 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
2
  import { ChevronsUpDown } from "../../icons/index.js";
3
+ import { intentAttributes } from "../../intent/attributes.js";
4
+ import type { IntentProps } from "../../intent/types.js";
3
5
  import { cn } from "../../utils/cn.js";
4
6
 
5
7
  export interface InlineSelectOption {
@@ -8,7 +10,9 @@ export interface InlineSelectOption {
8
10
  disabled?: boolean;
9
11
  }
10
12
 
11
- export interface InlineSelectProps extends Omit<ComponentPropsWithoutRef<"select">, "size"> {
13
+ export interface InlineSelectProps
14
+ extends Omit<ComponentPropsWithRef<"select">, "size">,
15
+ IntentProps {
12
16
  options: InlineSelectOption[];
13
17
  }
14
18
 
@@ -16,7 +20,13 @@ export interface InlineSelectProps extends Omit<ComponentPropsWithoutRef<"select
16
20
  * Borderless select that reads as part of a sentence or a row ("Repetir cada [semana v]").
17
21
  * Native `<select>` underneath, so the system picker and keyboard behaviour are kept.
18
22
  */
19
- export function InlineSelect({ options, className, ...props }: InlineSelectProps) {
23
+ export function InlineSelect({
24
+ options,
25
+ className,
26
+ intent,
27
+ intentKey,
28
+ ...props
29
+ }: InlineSelectProps) {
20
30
  return (
21
31
  <span className="relative inline-flex max-w-full items-center rounded-chip hover:bg-surface-sunken has-[:focus-visible]:focus-ring">
22
32
  <select
@@ -24,6 +34,7 @@ export function InlineSelect({ options, className, ...props }: InlineSelectProps
24
34
  "h-control-sm max-w-full cursor-pointer appearance-none truncate rounded-chip bg-transparent py-0 pr-6 pl-2 font-semibold text-control text-ink outline-none disabled:cursor-not-allowed disabled:opacity-50",
25
35
  className,
26
36
  )}
37
+ {...intentAttributes({ intent, intentKey })}
27
38
  {...props}
28
39
  >
29
40
  {options.map((o) => (
@@ -1,4 +1,6 @@
1
1
  import type { ComponentPropsWithRef, ReactNode } from "react";
2
+ import { intentAttributes } from "../../intent/attributes.js";
3
+ import type { IntentProps } from "../../intent/types.js";
2
4
  import type { ClassNames } from "../../utils/class-names.js";
3
5
  import { cn } from "../../utils/cn.js";
4
6
 
@@ -32,8 +34,12 @@ const TEXT = "min-w-0 text-control text-ink placeholder:text-ink-3";
32
34
  const RING =
33
35
  "focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1";
34
36
  const INVALID = "aria-[invalid=true]:border-danger";
37
+ const READ_ONLY =
38
+ "[&[readonly]]:cursor-default [&[readonly]]:border-transparent [&[readonly]]:bg-surface-sunken [&[readonly]]:text-ink-2";
39
+ const READ_ONLY_WRAPPER =
40
+ "has-[input[readonly]]:border-transparent has-[input[readonly]]:bg-surface-sunken has-[input[readonly]]:text-ink-2";
35
41
 
36
- export interface InputProps extends Omit<ComponentPropsWithRef<"input">, "size"> {
42
+ export interface InputProps extends Omit<ComponentPropsWithRef<"input">, "size">, IntentProps {
37
43
  /**
38
44
  * `sm` is the 30px compact field and `md` (default) the 38px one: the heights of `Button` `sm` and
39
45
  * `md`. `xs` is the same as `sm`; `lg` is the thumb-friendly field.
@@ -61,6 +67,8 @@ export function Input({
61
67
  end,
62
68
  className,
63
69
  classNames,
70
+ intent,
71
+ intentKey,
64
72
  ...props
65
73
  }: InputProps) {
66
74
  const bare = variant === "bare";
@@ -69,17 +77,18 @@ export function Input({
69
77
  return (
70
78
  <input
71
79
  className={cn(
72
- "w-full",
80
+ "w-full disabled:cursor-not-allowed disabled:opacity-50",
73
81
  TEXT,
74
82
  bare
75
83
  ? [
76
84
  height[size],
77
85
  "bg-transparent outline-none focus-visible:outline-2 focus-visible:outline-accent-ink",
78
86
  ]
79
- : [CHROME, RING, INVALID, inputSizeClasses[size]],
87
+ : [CHROME, RING, INVALID, READ_ONLY, inputSizeClasses[size]],
80
88
  classNames?.input,
81
89
  className,
82
90
  )}
91
+ {...intentAttributes({ intent, intentKey })}
83
92
  {...props}
84
93
  />
85
94
  );
@@ -97,6 +106,7 @@ export function Input({
97
106
  CHROME,
98
107
  paddingX[size],
99
108
  "focus-within:border-transparent focus-within:outline-2 focus-within:outline-accent-ink focus-within:-outline-offset-1 has-[input[aria-invalid=true]]:border-danger",
109
+ READ_ONLY_WRAPPER,
100
110
  ],
101
111
  "has-[input:disabled]:cursor-not-allowed has-[input:disabled]:opacity-50",
102
112
  classNames?.root,
@@ -111,6 +121,7 @@ export function Input({
111
121
  size === "lg" && "text-fs-140",
112
122
  classNames?.input,
113
123
  )}
124
+ {...intentAttributes({ intent, intentKey })}
114
125
  {...props}
115
126
  // The wrapper draws the ring; the unlayered base `:focus-visible` rule outranks `outline-none`.
116
127
  style={{ outline: "none", ...props.style }}
@@ -10,6 +10,8 @@ export interface ButtonOption {
10
10
  description?: ReactNode;
11
11
  icon?: ReactNode;
12
12
  disabled?: boolean;
13
+ intent?: string | undefined;
14
+ intentKey?: string | undefined;
13
15
  }
14
16
 
15
17
  export const optionGridClass =
@@ -1,7 +1,7 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export interface LabelProps extends ComponentPropsWithoutRef<"label"> {}
4
+ export interface LabelProps extends ComponentPropsWithRef<"label"> {}
5
5
 
6
6
  export function Label({ className, ...props }: LabelProps) {
7
7
  return (
@@ -1,5 +1,7 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithRef } from "react";
2
2
  import { ChevronDown } from "../../icons/index.js";
3
+ import { intentAttributes } from "../../intent/attributes.js";
4
+ import type { IntentProps } from "../../intent/types.js";
3
5
  import type { ClassNames } from "../../utils/class-names.js";
4
6
  import { cn } from "../../utils/cn.js";
5
7
 
@@ -16,7 +18,9 @@ export interface NativeSelectGroup {
16
18
 
17
19
  export type NativeSelectPart = "root" | "select" | "icon";
18
20
 
19
- export interface NativeSelectProps extends Omit<ComponentPropsWithoutRef<"select">, "size"> {
21
+ export interface NativeSelectProps
22
+ extends Omit<ComponentPropsWithRef<"select">, "size">,
23
+ IntentProps {
20
24
  /** Data-driven alternative to `<option>` children; groups render as `<optgroup>`. */
21
25
  options?: (NativeSelectOption | NativeSelectGroup)[];
22
26
  /** Disabled first option shown while nothing is chosen. */
@@ -45,6 +49,8 @@ export function NativeSelect({
45
49
  children,
46
50
  defaultValue,
47
51
  value,
52
+ intent,
53
+ intentKey,
48
54
  ...props
49
55
  }: NativeSelectProps) {
50
56
  const fallbackDefault =
@@ -61,6 +67,7 @@ export function NativeSelect({
61
67
  classNames?.select,
62
68
  className,
63
69
  )}
70
+ {...intentAttributes({ intent, intentKey })}
64
71
  {...props}
65
72
  >
66
73
  {placeholder ? (
@@ -11,8 +11,12 @@ import {
11
11
  } from "react";
12
12
  import { useUiStrings } from "../../i18n/index.js";
13
13
  import { Minus, Plus } from "../../icons/index.js";
14
+ import { intentAttributes } from "../../intent/attributes.js";
15
+ import type { IntentProps } from "../../intent/types.js";
16
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
14
17
  import type { ClassNames } from "../../utils/class-names.js";
15
18
  import { cn } from "../../utils/cn.js";
19
+ import { useComposedRefs } from "../../utils/compose.js";
16
20
  import { snapToStep } from "../slider/model.js";
17
21
  import { canStep, parseNumber, stepText } from "./model.js";
18
22
 
@@ -25,7 +29,7 @@ const sizeClasses: Readonly<Record<NumberStepperSize, { root: string; button: st
25
29
  md: { root: "h-input", button: "w-9" },
26
30
  };
27
31
 
28
- interface NumberStepperBaseProps {
32
+ interface NumberStepperBaseProps extends IntentProps {
29
33
  /** `sm` (30px) matches a small `Button` or `Input` for dense rows; `md` (default) is the regular field height. */
30
34
  size?: NumberStepperSize;
31
35
  /** Accessible name of the plus button. Defaults to the localized verb followed by the field label. */
@@ -102,6 +106,8 @@ export function NumberStepper(props: NumberStepperProps) {
102
106
  "aria-labelledby": ariaLabelledBy,
103
107
  "aria-describedby": ariaDescribedBy,
104
108
  "aria-invalid": ariaInvalid,
109
+ intent,
110
+ intentKey,
105
111
  } = props;
106
112
  const strings = useUiStrings();
107
113
  const autoId = useId();
@@ -110,6 +116,10 @@ export function NumberStepper(props: NumberStepperProps) {
110
116
  const incrementId = `${autoId}-increment`;
111
117
  const [fieldLabel, setFieldLabel] = useState("");
112
118
  const inputRef = useRef<HTMLInputElement | null>(null);
119
+ const inputTargetRef = useComposedRefs<HTMLInputElement>(
120
+ inputRef,
121
+ useIntentTarget({ intent, intentKey }, { role: "spinbutton" }),
122
+ );
113
123
 
114
124
  useEffect(() => {
115
125
  if (ariaLabel || ariaLabelledBy) return;
@@ -198,7 +208,7 @@ export function NumberStepper(props: NumberStepperProps) {
198
208
  className={cn(
199
209
  "inline-flex min-w-32 max-w-full items-stretch overflow-hidden rounded-input border-control bg-surface-control",
200
210
  sizeClasses[size].root,
201
- disabled && "opacity-60",
211
+ disabled && "cursor-not-allowed opacity-50",
202
212
  (invalid || ariaInvalid) && "border-danger",
203
213
  classNames?.root,
204
214
  className,
@@ -217,7 +227,8 @@ export function NumberStepper(props: NumberStepperProps) {
217
227
  <Minus aria-hidden="true" className="size-3.5" />
218
228
  </button>
219
229
  <input
220
- ref={inputRef}
230
+ {...intentAttributes({ intent, intentKey })}
231
+ ref={inputTargetRef}
221
232
  id={id}
222
233
  name={name}
223
234
  role="spinbutton"
@@ -3,6 +3,8 @@
3
3
  import { IconButton } from "../../atoms/icon-button/icon-button.js";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { Eye, EyeOff } from "../../icons/index.js";
6
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
7
+ import { useComposedRefs } from "../../utils/compose.js";
6
8
  import { useControllableState } from "../../utils/use-controllable-state.js";
7
9
  import { Input, type InputProps } from "../input/input.js";
8
10
 
@@ -27,9 +29,16 @@ export function PasswordInput({
27
29
  onRevealedChange,
28
30
  revealLabel,
29
31
  autoComplete = "current-password",
32
+ intent,
33
+ intentKey,
34
+ ref,
30
35
  ...props
31
36
  }: PasswordInputProps) {
32
37
  const strings = useUiStrings();
38
+ const composedRef = useComposedRefs<HTMLInputElement>(
39
+ ref,
40
+ useIntentTarget({ intent, intentKey }),
41
+ );
33
42
  const [revealed, setRevealed] = useControllableState({
34
43
  prop: revealedProp,
35
44
  defaultProp: defaultRevealed,
@@ -38,6 +47,9 @@ export function PasswordInput({
38
47
  return (
39
48
  <Input
40
49
  {...props}
50
+ ref={composedRef}
51
+ intent={intent}
52
+ intentKey={intentKey}
41
53
  type={revealed ? "text" : "password"}
42
54
  autoComplete={autoComplete}
43
55
  end={
@@ -1,12 +1,15 @@
1
1
  "use client";
2
2
 
3
3
  import { type ChangeEvent, useId, useState } from "react";
4
+ import { intentAttributes } from "../../intent/attributes.js";
5
+ import type { IntentProps } from "../../intent/types.js";
6
+ import { useIntentTarget } from "../../intent/use-intent-target.js";
4
7
  import type { ClassNames } from "../../utils/class-names.js";
5
8
  import { cn } from "../../utils/cn.js";
6
9
 
7
10
  export type PinInputPart = "root" | "dots" | "dot" | "input";
8
11
 
9
- export interface PinInputProps {
12
+ export interface PinInputProps extends IntentProps {
10
13
  length?: number;
11
14
  value?: string;
12
15
  defaultValue?: string;
@@ -36,7 +39,10 @@ export function PinInput({
36
39
  statusLabel = defaultStatusLabel,
37
40
  className,
38
41
  classNames,
42
+ intent,
43
+ intentKey,
39
44
  }: PinInputProps) {
45
+ const inputRef = useIntentTarget<HTMLInputElement>({ intent, intentKey });
40
46
  const statusId = useId();
41
47
  const [internal, setInternal] = useState(defaultValue);
42
48
  const current = value ?? internal;
@@ -81,6 +87,8 @@ export function PinInput({
81
87
  "h-input w-full min-w-0 rounded-input border-control bg-surface-control px-2 text-center font-mono text-control text-ink tracking-[0.15em] @min-[240px]/pin:px-3 @min-[240px]/pin:tracking-[0.3em] focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1",
82
88
  classNames?.input,
83
89
  )}
90
+ {...intentAttributes({ intent, intentKey })}
91
+ ref={inputRef}
84
92
  type="password"
85
93
  inputMode="numeric"
86
94
  maxLength={length}
@@ -1,6 +1,9 @@
1
1
  "use client";
2
2
 
3
3
  import { useId, useState } from "react";
4
+ import { intentAttributes } from "../../intent/attributes.js";
5
+ import type { IntentProps } from "../../intent/types.js";
6
+ import { useIntentTarget, useIntentTargets } from "../../intent/use-intent-target.js";
4
7
  import type { ClassNames } from "../../utils/class-names.js";
5
8
  import { cn } from "../../utils/cn.js";
6
9
  import {
@@ -14,7 +17,7 @@ export type RadioButtonOption = ButtonOption;
14
17
 
15
18
  export type RadioButtonGroupPart = "root" | ButtonOptionPart;
16
19
 
17
- export interface RadioButtonGroupProps {
20
+ export interface RadioButtonGroupProps extends IntentProps {
18
21
  options: RadioButtonOption[];
19
22
  value?: string;
20
23
  defaultValue?: string;
@@ -42,9 +45,13 @@ export function RadioButtonGroup({
42
45
  disabled,
43
46
  className,
44
47
  classNames,
48
+ intent,
49
+ intentKey,
45
50
  ...aria
46
51
  }: RadioButtonGroupProps) {
47
52
  const generated = useId();
53
+ const rootRef = useIntentTarget<HTMLDivElement>({ intent, intentKey }, { role: "radiogroup" });
54
+ const bindOption = useIntentTargets();
48
55
  const [inner, setInner] = useState(defaultValue);
49
56
  const value = valueProp ?? inner;
50
57
 
@@ -52,7 +59,9 @@ export function RadioButtonGroup({
52
59
  <div
53
60
  role="radiogroup"
54
61
  className={cn("@container/options", optionGridClass, classNames?.root, className)}
62
+ {...intentAttributes({ intent, intentKey })}
55
63
  {...aria}
64
+ ref={rootRef}
56
65
  >
57
66
  {options.map((option) => (
58
67
  <OptionShell
@@ -61,6 +70,14 @@ export function RadioButtonGroup({
61
70
  classNames={classNames}
62
71
  input={
63
72
  <input
73
+ {...intentAttributes({
74
+ intent: option.intent,
75
+ intentKey: option.intentKey ?? option.value,
76
+ })}
77
+ ref={bindOption({
78
+ intent: option.intent,
79
+ intentKey: option.intentKey ?? option.value,
80
+ })}
64
81
  type="radio"
65
82
  name={name ?? generated}
66
83
  value={option.value}