@jcsoftdev/ui 0.5.0 → 0.7.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 (392) hide show
  1. package/CHANGELOG.md +361 -0
  2. package/README.md +31 -5
  3. package/bin/ui-theme.mjs +40 -6
  4. package/dist/ai/code-block/code-block.js +1 -1
  5. package/dist/atoms/avatar/avatar.d.ts +6 -1
  6. package/dist/atoms/avatar/avatar.js +3 -2
  7. package/dist/atoms/big-date/big-date.js +2 -2
  8. package/dist/atoms/button/button.d.ts +6 -1
  9. package/dist/atoms/button/button.js +2 -2
  10. package/dist/atoms/chip/chip.d.ts +5 -0
  11. package/dist/atoms/chip/chip.js +3 -3
  12. package/dist/atoms/icon-button/icon-button.js +1 -1
  13. package/dist/atoms/internal/hit-area.d.ts +5 -4
  14. package/dist/atoms/internal/hit-area.js +1 -1
  15. package/dist/atoms/progress/index.d.ts +1 -1
  16. package/dist/atoms/progress/index.js +4 -1
  17. package/dist/atoms/progress/progress.d.ts +6 -1
  18. package/dist/atoms/progress/progress.js +19 -1
  19. package/dist/atoms/radio-group/radio-group.js +1 -1
  20. package/dist/atoms/status-pill/status-pill.d.ts +16 -5
  21. package/dist/atoms/status-pill/status-pill.js +43 -18
  22. package/dist/brand/logo-forge.js +1 -1
  23. package/dist/charts/candlestick-chart/candlestick-chart.js +2 -2
  24. package/dist/charts/chart-grid/chart-grid.js +2 -2
  25. package/dist/charts/chord-chart/chord-chart.js +1 -1
  26. package/dist/charts/core/axes.js +2 -2
  27. package/dist/charts/core/cartesian/annotations.js +2 -2
  28. package/dist/charts/core/cartesian/marks.js +1 -1
  29. package/dist/charts/core/distribution/marks.js +1 -1
  30. package/dist/charts/core/distribution/xy-points.js +1 -1
  31. package/dist/charts/core/export-menu.js +1 -1
  32. package/dist/charts/funnel-chart/funnel-chart.js +1 -1
  33. package/dist/charts/gantt-chart/gantt-chart.js +4 -4
  34. package/dist/charts/gantt-chart/gantt-marks.js +3 -3
  35. package/dist/charts/index.d.ts +2 -0
  36. package/dist/charts/index.js +2 -0
  37. package/dist/charts/maps/geo/map-data-table.js +1 -1
  38. package/dist/charts/polar-area-chart/polar-area-chart.js +1 -1
  39. package/dist/charts/radar-chart/radar-chart.js +1 -1
  40. package/dist/charts/stock-chart/stock-chart.js +1 -1
  41. package/dist/charts/stock-chart/stock-drawing-layer.js +3 -3
  42. package/dist/charts/stock-chart/stock-plot.js +2 -2
  43. package/dist/containers/chat-thread/chat-thread.d.ts +98 -0
  44. package/dist/containers/chat-thread/chat-thread.js +219 -0
  45. package/dist/containers/chat-thread/format.d.ts +20 -0
  46. package/dist/containers/chat-thread/format.js +50 -0
  47. package/dist/containers/chat-thread/index.d.ts +1 -0
  48. package/dist/containers/chat-thread/index.js +8 -0
  49. package/dist/containers/cols/cols.d.ts +1 -1
  50. package/dist/containers/cols/cols.js +7 -0
  51. package/dist/containers/comment/comment.js +1 -1
  52. package/dist/containers/context-rail/context-rail.d.ts +62 -0
  53. package/dist/containers/context-rail/context-rail.js +175 -0
  54. package/dist/containers/context-rail/index.d.ts +1 -0
  55. package/dist/containers/context-rail/index.js +6 -0
  56. package/dist/containers/dashboard/dashboard.d.ts +40 -0
  57. package/dist/containers/dashboard/dashboard.js +84 -0
  58. package/dist/containers/dashboard/index.d.ts +1 -0
  59. package/dist/containers/dashboard/index.js +14 -0
  60. package/dist/containers/data-grid/data-grid.demos.js +4 -4
  61. package/dist/containers/data-grid/data-grid.js +6 -6
  62. package/dist/containers/data-grid/filter-builder-editor.js +2 -2
  63. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  64. package/dist/containers/data-grid/spreadsheet.demos.d.ts +1 -1
  65. package/dist/containers/data-grid/spreadsheet.demos.js +1 -1
  66. package/dist/containers/detail-header/detail-header.d.ts +24 -0
  67. package/dist/containers/detail-header/detail-header.js +32 -0
  68. package/dist/containers/detail-header/index.d.ts +1 -0
  69. package/dist/containers/detail-header/index.js +6 -0
  70. package/dist/containers/facts/facts.js +1 -1
  71. package/dist/containers/filter-bar/filter-bar.d.ts +58 -0
  72. package/dist/containers/filter-bar/filter-bar.js +123 -0
  73. package/dist/containers/filter-bar/index.d.ts +1 -0
  74. package/dist/containers/filter-bar/index.js +6 -0
  75. package/dist/containers/hbars/hbars.js +2 -2
  76. package/dist/containers/index.d.ts +9 -0
  77. package/dist/containers/index.js +9 -0
  78. package/dist/containers/kanban/kanban.d.ts +23 -2
  79. package/dist/containers/kanban/kanban.js +103 -21
  80. package/dist/containers/kanban/model.d.ts +12 -0
  81. package/dist/containers/kanban/model.js +8 -0
  82. package/dist/containers/kpi/kpi.js +1 -1
  83. package/dist/containers/kpi-group/kpi-group.d.ts +6 -1
  84. package/dist/containers/kpi-group/kpi-group.js +6 -2
  85. package/dist/containers/list-detail/index.d.ts +1 -1
  86. package/dist/containers/list-detail/index.js +4 -0
  87. package/dist/containers/list-detail/list-detail.d.ts +51 -3
  88. package/dist/containers/list-detail/list-detail.js +111 -15
  89. package/dist/containers/page/page.d.ts +17 -4
  90. package/dist/containers/page/page.js +33 -4
  91. package/dist/containers/page-header/back.d.ts +10 -0
  92. package/dist/containers/page-header/back.js +28 -0
  93. package/dist/containers/page-header/index.d.ts +1 -0
  94. package/dist/containers/page-header/index.js +1 -0
  95. package/dist/containers/page-header/page-header.d.ts +19 -2
  96. package/dist/containers/page-header/page-header.js +26 -2
  97. package/dist/containers/pagination/cursor-pagination.d.ts +28 -0
  98. package/dist/containers/pagination/cursor-pagination.js +48 -0
  99. package/dist/containers/pagination/index.d.ts +3 -0
  100. package/dist/containers/pagination/index.js +10 -0
  101. package/dist/containers/pagination/pagination.d.ts +52 -0
  102. package/dist/containers/pagination/pagination.js +216 -0
  103. package/dist/containers/pagination/range.d.ts +29 -0
  104. package/dist/containers/pagination/range.js +42 -0
  105. package/dist/containers/pagination/use-pagination.d.ts +18 -0
  106. package/dist/containers/pagination/use-pagination.js +22 -0
  107. package/dist/containers/responsive-list/responsive-list.d.ts +29 -3
  108. package/dist/containers/responsive-list/responsive-list.js +202 -82
  109. package/dist/containers/row-actions/index.d.ts +1 -0
  110. package/dist/containers/row-actions/index.js +4 -0
  111. package/dist/containers/row-actions/row-actions.d.ts +26 -0
  112. package/dist/containers/row-actions/row-actions.js +78 -0
  113. package/dist/containers/selectable-card/index.d.ts +1 -0
  114. package/dist/containers/selectable-card/index.js +6 -0
  115. package/dist/containers/selectable-card/selectable-card.d.ts +26 -0
  116. package/dist/containers/selectable-card/selectable-card.js +57 -0
  117. package/dist/containers/settings-layout/settings-layout.d.ts +24 -7
  118. package/dist/containers/settings-layout/settings-layout.js +63 -8
  119. package/dist/containers/shortcuts/shortcuts.js +1 -1
  120. package/dist/containers/table/cell-padding.d.ts +2 -0
  121. package/dist/containers/table/cell-padding.js +4 -0
  122. package/dist/containers/table/index.d.ts +1 -0
  123. package/dist/containers/table/index.js +8 -0
  124. package/dist/containers/table/sort.d.ts +14 -0
  125. package/dist/containers/table/sort.js +11 -0
  126. package/dist/containers/table/table-parts.d.ts +24 -0
  127. package/dist/containers/table/table-parts.js +52 -0
  128. package/dist/containers/table/table.d.ts +37 -3
  129. package/dist/containers/table/table.js +120 -19
  130. package/dist/containers/table-columns-menu/index.d.ts +1 -0
  131. package/dist/containers/table-columns-menu/index.js +6 -0
  132. package/dist/containers/table-columns-menu/table-columns-menu.d.ts +14 -0
  133. package/dist/containers/table-columns-menu/table-columns-menu.js +46 -0
  134. package/dist/dashboards/layout.d.ts +1 -27
  135. package/dist/dashboards/layout.js +8 -40
  136. package/dist/forms/chip-group/chip-group.d.ts +5 -0
  137. package/dist/forms/chip-group/chip-group.js +3 -1
  138. package/dist/forms/combobox/combobox.js +1 -1
  139. package/dist/forms/copy-field/copy-field.js +1 -1
  140. package/dist/forms/date-picker/date-picker.d.ts +3 -1
  141. package/dist/forms/date-picker/date-picker.js +4 -2
  142. package/dist/forms/date-picker/date-time-picker.d.ts +8 -2
  143. package/dist/forms/date-picker/date-time-picker.js +13 -2
  144. package/dist/forms/field/field.d.ts +9 -2
  145. package/dist/forms/field/field.js +18 -4
  146. package/dist/forms/fieldset/fieldset.d.ts +11 -0
  147. package/dist/forms/fieldset/fieldset.js +12 -0
  148. package/dist/forms/fieldset/index.d.ts +1 -0
  149. package/dist/forms/fieldset/index.js +4 -0
  150. package/dist/forms/form-footer/form-footer.d.ts +26 -0
  151. package/dist/forms/form-footer/form-footer.js +44 -0
  152. package/dist/forms/form-footer/index.d.ts +1 -0
  153. package/dist/forms/form-footer/index.js +4 -0
  154. package/dist/forms/form-grid/form-grid.d.ts +21 -4
  155. package/dist/forms/form-grid/form-grid.js +20 -3
  156. package/dist/forms/form-grid/index.d.ts +1 -1
  157. package/dist/forms/form-grid/index.js +6 -2
  158. package/dist/forms/form-section/form-section.d.ts +12 -0
  159. package/dist/forms/form-section/form-section.js +30 -0
  160. package/dist/forms/form-section/index.d.ts +1 -0
  161. package/dist/forms/form-section/index.js +4 -0
  162. package/dist/forms/index.d.ts +3 -0
  163. package/dist/forms/index.js +3 -0
  164. package/dist/forms/input/input.d.ts +6 -2
  165. package/dist/forms/input/input.js +4 -1
  166. package/dist/forms/internal/listbox-items.d.ts +1 -1
  167. package/dist/forms/internal/listbox-items.js +3 -2
  168. package/dist/forms/native-select/native-select.js +1 -1
  169. package/dist/forms/number-stepper/index.d.ts +1 -1
  170. package/dist/forms/number-stepper/number-stepper.d.ts +7 -0
  171. package/dist/forms/number-stepper/number-stepper.js +37 -6
  172. package/dist/forms/select/index.d.ts +1 -1
  173. package/dist/forms/select/select.d.ts +5 -2
  174. package/dist/forms/select/select.js +7 -2
  175. package/dist/forms/select-menu/select-menu.js +1 -1
  176. package/dist/forms/time-input/time-input.d.ts +4 -2
  177. package/dist/forms/time-input/time-input.js +3 -1
  178. package/dist/i18n/strings.d.ts +94 -0
  179. package/dist/i18n/strings.js +50 -0
  180. package/dist/motion/count-up.d.ts +20 -0
  181. package/dist/motion/count-up.js +59 -0
  182. package/dist/motion/cross-fade.d.ts +21 -0
  183. package/dist/motion/cross-fade.js +86 -0
  184. package/dist/motion/index.d.ts +5 -0
  185. package/dist/motion/index.js +14 -0
  186. package/dist/motion/model.d.ts +15 -0
  187. package/dist/motion/model.js +68 -0
  188. package/dist/motion/motion-styles.d.ts +1 -0
  189. package/dist/motion/motion-styles.js +35 -0
  190. package/dist/motion/reveal.d.ts +37 -0
  191. package/dist/motion/reveal.js +69 -0
  192. package/dist/motion/use-enter-phase.d.ts +11 -0
  193. package/dist/motion/use-enter-phase.js +40 -0
  194. package/dist/motion/use-highlight-row.d.ts +22 -0
  195. package/dist/motion/use-highlight-row.js +38 -0
  196. package/dist/navigation/tabs/tabs.js +1 -1
  197. package/dist/navigation/wizard/wizard.d.ts +4 -1
  198. package/dist/navigation/wizard/wizard.js +3 -0
  199. package/dist/overlays/alert-dialog/alert-dialog.js +8 -1
  200. package/dist/overlays/context-menu/context-menu.js +3 -1
  201. package/dist/overlays/dialog/dialog.d.ts +1 -0
  202. package/dist/overlays/dialog/dialog.js +11 -3
  203. package/dist/overlays/drawer/drawer.d.ts +18 -4
  204. package/dist/overlays/drawer/drawer.js +53 -4
  205. package/dist/overlays/drawer/index.d.ts +1 -1
  206. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +1 -1
  207. package/dist/overlays/dropdown-menu/dropdown-menu.js +5 -4
  208. package/dist/overlays/hover-card/hover-card.js +2 -0
  209. package/dist/overlays/popover/popover.js +2 -0
  210. package/dist/overlays/toaster/index.d.ts +1 -1
  211. package/dist/overlays/toaster/toast-store.d.ts +2 -0
  212. package/dist/overlays/toaster/toast-store.js +6 -1
  213. package/dist/overlays/toaster/toaster.d.ts +28 -2
  214. package/dist/overlays/toaster/toaster.js +86 -29
  215. package/dist/overlays/tooltip/tooltip.js +2 -0
  216. package/dist/primitives/use-presence.js +9 -0
  217. package/dist/shell/app-shell/app-shell.d.ts +8 -1
  218. package/dist/shell/app-shell/app-shell.js +50 -3
  219. package/dist/shell/index.d.ts +1 -0
  220. package/dist/shell/index.js +1 -0
  221. package/dist/shell/sidebar/sidebar.d.ts +17 -1
  222. package/dist/shell/sidebar/sidebar.js +126 -76
  223. package/dist/shell/topbar/topbar.d.ts +4 -2
  224. package/dist/shell/topbar/topbar.js +2 -0
  225. package/dist/showcase/operations-bento.js +2 -2
  226. package/dist/states/empty-state/empty-state.d.ts +10 -3
  227. package/dist/states/empty-state/empty-state.js +46 -5
  228. package/dist/states/error-state/error-state.js +1 -1
  229. package/dist/states/skeleton/skeleton.d.ts +16 -1
  230. package/dist/states/skeleton/skeleton.js +13 -5
  231. package/dist/utils/class-tokens.generated.js +4 -6
  232. package/dist/utils/focus-chain.d.ts +11 -0
  233. package/dist/utils/focus-chain.js +39 -0
  234. package/dist/utils/focus-rescue.d.ts +13 -0
  235. package/dist/utils/focus-rescue.js +48 -0
  236. package/dist/utils/list-navigation.d.ts +14 -0
  237. package/dist/utils/list-navigation.js +44 -0
  238. package/dist/utils/overlay-motion.d.ts +12 -0
  239. package/dist/utils/overlay-motion.js +14 -0
  240. package/dist/utils/use-container-width.d.ts +6 -0
  241. package/dist/utils/use-container-width.js +19 -0
  242. package/package.json +2 -2
  243. package/scripts/build-theme.mjs +46 -5
  244. package/src/ai/code-block/code-block.tsx +1 -1
  245. package/src/atoms/avatar/avatar.tsx +8 -2
  246. package/src/atoms/big-date/big-date.tsx +2 -2
  247. package/src/atoms/button/button.tsx +8 -3
  248. package/src/atoms/chip/chip.tsx +8 -3
  249. package/src/atoms/icon-button/icon-button.tsx +1 -1
  250. package/src/atoms/internal/hit-area.ts +5 -4
  251. package/src/atoms/progress/index.ts +8 -1
  252. package/src/atoms/progress/progress.tsx +30 -1
  253. package/src/atoms/radio-group/radio-group.tsx +1 -1
  254. package/src/atoms/status-pill/status-pill.tsx +59 -18
  255. package/src/brand/logo-forge.tsx +1 -1
  256. package/src/charts/candlestick-chart/candlestick-chart.tsx +2 -2
  257. package/src/charts/chart-grid/chart-grid.tsx +2 -2
  258. package/src/charts/chord-chart/chord-chart.tsx +1 -1
  259. package/src/charts/core/axes.tsx +2 -2
  260. package/src/charts/core/cartesian/annotations.tsx +2 -2
  261. package/src/charts/core/cartesian/marks.tsx +1 -1
  262. package/src/charts/core/distribution/marks.tsx +1 -1
  263. package/src/charts/core/distribution/xy-points.tsx +1 -1
  264. package/src/charts/core/export-menu.tsx +1 -1
  265. package/src/charts/funnel-chart/funnel-chart.tsx +1 -1
  266. package/src/charts/gantt-chart/gantt-chart.tsx +4 -4
  267. package/src/charts/gantt-chart/gantt-marks.tsx +3 -3
  268. package/src/charts/index.ts +2 -0
  269. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  270. package/src/charts/polar-area-chart/polar-area-chart.tsx +1 -1
  271. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  272. package/src/charts/stock-chart/stock-chart.tsx +1 -1
  273. package/src/charts/stock-chart/stock-drawing-layer.tsx +3 -3
  274. package/src/charts/stock-chart/stock-plot.tsx +2 -2
  275. package/src/containers/chat-thread/chat-thread.tsx +331 -0
  276. package/src/containers/chat-thread/format.ts +67 -0
  277. package/src/containers/chat-thread/index.ts +12 -0
  278. package/src/containers/cols/cols.tsx +13 -1
  279. package/src/containers/comment/comment.tsx +1 -1
  280. package/src/containers/context-rail/context-rail.tsx +229 -0
  281. package/src/containers/context-rail/index.ts +7 -0
  282. package/src/containers/dashboard/dashboard.tsx +142 -0
  283. package/src/containers/dashboard/index.ts +12 -0
  284. package/src/containers/data-grid/data-grid.demos.tsx +4 -4
  285. package/src/containers/data-grid/data-grid.tsx +6 -6
  286. package/src/containers/data-grid/filter-builder-editor.tsx +2 -2
  287. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  288. package/src/containers/data-grid/spreadsheet.demos.tsx +1 -1
  289. package/src/containers/detail-header/detail-header.tsx +64 -0
  290. package/src/containers/detail-header/index.ts +5 -0
  291. package/src/containers/facts/facts.tsx +1 -1
  292. package/src/containers/filter-bar/filter-bar.tsx +201 -0
  293. package/src/containers/filter-bar/index.ts +7 -0
  294. package/src/containers/hbars/hbars.tsx +2 -2
  295. package/src/containers/index.ts +9 -0
  296. package/src/containers/kanban/kanban.tsx +148 -39
  297. package/src/containers/kanban/model.ts +20 -0
  298. package/src/containers/kpi/kpi.tsx +1 -1
  299. package/src/containers/kpi-group/kpi-group.tsx +17 -2
  300. package/src/containers/list-detail/index.ts +5 -0
  301. package/src/containers/list-detail/list-detail.tsx +159 -9
  302. package/src/containers/page/page.tsx +61 -7
  303. package/src/containers/page-header/back.tsx +42 -0
  304. package/src/containers/page-header/index.ts +1 -0
  305. package/src/containers/page-header/page-header.tsx +49 -3
  306. package/src/containers/pagination/cursor-pagination.tsx +79 -0
  307. package/src/containers/pagination/index.ts +7 -0
  308. package/src/containers/pagination/pagination.tsx +266 -0
  309. package/src/containers/pagination/range.ts +68 -0
  310. package/src/containers/pagination/use-pagination.ts +44 -0
  311. package/src/containers/responsive-list/responsive-list.tsx +190 -47
  312. package/src/containers/row-actions/index.ts +1 -0
  313. package/src/containers/row-actions/row-actions.tsx +114 -0
  314. package/src/containers/selectable-card/index.ts +5 -0
  315. package/src/containers/selectable-card/selectable-card.tsx +84 -0
  316. package/src/containers/settings-layout/settings-layout.tsx +104 -13
  317. package/src/containers/shortcuts/shortcuts.tsx +1 -1
  318. package/src/containers/table/cell-padding.ts +2 -0
  319. package/src/containers/table/index.ts +6 -0
  320. package/src/containers/table/sort.ts +23 -0
  321. package/src/containers/table/table-parts.tsx +81 -0
  322. package/src/containers/table/table.tsx +212 -45
  323. package/src/containers/table-columns-menu/index.ts +5 -0
  324. package/src/containers/table-columns-menu/table-columns-menu.tsx +68 -0
  325. package/src/dashboards/layout.tsx +8 -75
  326. package/src/forms/chip-group/chip-group.tsx +8 -1
  327. package/src/forms/combobox/combobox.tsx +1 -1
  328. package/src/forms/copy-field/copy-field.tsx +1 -1
  329. package/src/forms/date-picker/date-picker.tsx +7 -2
  330. package/src/forms/date-picker/date-time-picker.tsx +28 -2
  331. package/src/forms/field/field.tsx +30 -3
  332. package/src/forms/fieldset/fieldset.tsx +22 -0
  333. package/src/forms/fieldset/index.ts +1 -0
  334. package/src/forms/form-footer/form-footer.tsx +74 -0
  335. package/src/forms/form-footer/index.ts +1 -0
  336. package/src/forms/form-grid/form-grid.tsx +42 -5
  337. package/src/forms/form-grid/index.ts +8 -1
  338. package/src/forms/form-section/form-section.tsx +41 -0
  339. package/src/forms/form-section/index.ts +1 -0
  340. package/src/forms/index.ts +3 -0
  341. package/src/forms/input/input.tsx +10 -3
  342. package/src/forms/internal/listbox-items.tsx +3 -4
  343. package/src/forms/native-select/native-select.tsx +1 -1
  344. package/src/forms/number-stepper/index.ts +1 -0
  345. package/src/forms/number-stepper/number-stepper.tsx +51 -6
  346. package/src/forms/select/index.ts +1 -1
  347. package/src/forms/select/select.tsx +14 -3
  348. package/src/forms/select-menu/select-menu.tsx +1 -1
  349. package/src/forms/time-input/time-input.tsx +6 -2
  350. package/src/i18n/strings.ts +94 -0
  351. package/src/motion/count-up.tsx +83 -0
  352. package/src/motion/cross-fade.tsx +139 -0
  353. package/src/motion/index.ts +5 -0
  354. package/src/motion/model.ts +86 -0
  355. package/src/motion/motion-styles.tsx +47 -0
  356. package/src/motion/reveal.tsx +115 -0
  357. package/src/motion/use-enter-phase.ts +50 -0
  358. package/src/motion/use-highlight-row.ts +63 -0
  359. package/src/navigation/tabs/tabs.tsx +1 -1
  360. package/src/navigation/wizard/wizard.tsx +6 -1
  361. package/src/overlays/alert-dialog/alert-dialog.tsx +5 -1
  362. package/src/overlays/context-menu/context-menu.tsx +3 -2
  363. package/src/overlays/dialog/dialog.tsx +9 -3
  364. package/src/overlays/drawer/drawer.tsx +68 -6
  365. package/src/overlays/drawer/index.ts +1 -0
  366. package/src/overlays/dropdown-menu/dropdown-menu.tsx +5 -4
  367. package/src/overlays/hover-card/hover-card.tsx +2 -0
  368. package/src/overlays/popover/popover.tsx +2 -0
  369. package/src/overlays/toaster/index.ts +2 -0
  370. package/src/overlays/toaster/toast-store.ts +8 -0
  371. package/src/overlays/toaster/toaster.tsx +127 -17
  372. package/src/overlays/tooltip/tooltip.tsx +2 -0
  373. package/src/primitives/use-presence.ts +13 -0
  374. package/src/shell/app-shell/app-shell.tsx +54 -2
  375. package/src/shell/index.ts +1 -0
  376. package/src/shell/sidebar/sidebar.tsx +154 -75
  377. package/src/shell/topbar/topbar.tsx +8 -0
  378. package/src/showcase/operations-bento.tsx +2 -2
  379. package/src/states/empty-state/empty-state.tsx +52 -9
  380. package/src/states/error-state/error-state.tsx +1 -1
  381. package/src/states/skeleton/skeleton.tsx +33 -5
  382. package/src/utils/class-tokens.generated.ts +4 -6
  383. package/src/utils/focus-chain.ts +53 -0
  384. package/src/utils/focus-rescue.ts +68 -0
  385. package/src/utils/list-navigation.ts +63 -0
  386. package/src/utils/overlay-motion.ts +33 -0
  387. package/src/utils/use-container-width.ts +24 -0
  388. package/styles/Theme.kt +15 -18
  389. package/styles/tailwind.css +29 -28
  390. package/styles/theme.css +29 -28
  391. package/styles/tokens.css +46 -0
  392. package/tokens/default.json +51 -29
@@ -1,80 +1,13 @@
1
1
  import type { Decorator } from "@storybook/react-vite";
2
- import type { ReactNode } from "react";
3
- import { Card, CardBody, CardHeader } from "../containers/card/index.js";
4
- import { cn } from "../utils/cn.js";
5
2
 
6
- /** Vertical rhythm of a dashboard page. */
7
- export function DashboardPage({ children }: { children: ReactNode }) {
8
- return <div className="flex min-w-0 flex-col gap-4">{children}</div>;
9
- }
10
-
11
- /** Joined KPI tiles: two per row when narrow, four from 720 px of page width. */
12
- export function KpiRow({ children }: { children: ReactNode }) {
13
- return (
14
- <div className="grid grid-cols-2 gap-px overflow-hidden rounded-card bg-line border-card shadow-card @min-[720px]/page:grid-cols-4">
15
- {children}
16
- </div>
17
- );
18
- }
19
-
20
- const gridClasses = {
21
- 2: "grid-cols-1 @min-[720px]/page:grid-cols-2",
22
- 3: "grid-cols-1 @min-[720px]/page:grid-cols-2 @min-[1180px]/page:grid-cols-3",
23
- } as const;
24
-
25
- /** Equal cards that stack under 720 px of page width. */
26
- export function CardGrid({ columns = 2, children }: { columns?: 2 | 3; children: ReactNode }) {
27
- return <div className={cn("grid items-start gap-4", gridClasses[columns])}>{children}</div>;
28
- }
29
-
30
- export interface ChartCardProps {
31
- title: string;
32
- subtitle?: string;
33
- /** Slot at the end of the header (a chip, a button). */
34
- aside?: ReactNode;
35
- /** Fixed height of the body in px; the chart inside uses `height="fill"`. */
36
- height?: number;
37
- children: ReactNode;
38
- }
39
-
40
- function CardTitle({ title, subtitle }: { title: string; subtitle?: string }) {
41
- return (
42
- <div className="min-w-0 flex-1">
43
- <h2 className="m-0 break-words font-semibold text-fs-140 text-ink">{title}</h2>
44
- {subtitle ? <p className="m-0 break-words text-fs-120 text-ink-3">{subtitle}</p> : null}
45
- </div>
46
- );
47
- }
48
-
49
- /** Card with a fixed-height body so `height="fill"` charts take exactly the space left. */
50
- export function ChartCard({ title, subtitle, aside, height = 300, children }: ChartCardProps) {
51
- return (
52
- <Card>
53
- <CardHeader>
54
- <CardTitle title={title} subtitle={subtitle} />
55
- {aside}
56
- </CardHeader>
57
- <CardBody>
58
- <div className="min-w-0" style={{ height }}>
59
- {children}
60
- </div>
61
- </CardBody>
62
- </Card>
63
- );
64
- }
65
-
66
- /** Card whose body is a table or grid that scrolls inside its own wrapper. */
67
- export function TableCard({ title, subtitle, aside, children }: Omit<ChartCardProps, "height">) {
68
- return (
69
- <Card>
70
- <CardHeader>
71
- <CardTitle title={title} subtitle={subtitle} />
72
- {aside}
73
- </CardHeader>
74
- <div className="min-w-0">{children}</div>
75
- </Card>
76
- );
77
- }
3
+ export {
4
+ CardGrid,
5
+ ChartCard,
6
+ type ChartCardProps,
7
+ DashboardPage,
8
+ KpiRow,
9
+ TableCard,
10
+ } from "../containers/dashboard/index.js";
78
11
 
79
12
  /** Container-width frames for the `Narrow` (320) and `Tablet` (768) variants. */
80
13
  export const narrowFrame: Decorator = (Story) => (
@@ -33,6 +33,11 @@ interface ChipGroupCommon {
33
33
  "aria-labelledby"?: string | undefined;
34
34
  "aria-describedby"?: string | undefined;
35
35
  "aria-invalid"?: boolean | "true" | "false" | undefined;
36
+ /**
37
+ * Minimum chip height: `sm` (default) is 30px (`--control-height-sm`), `md` 38px
38
+ * (`--control-height-md`), the heights of `Button` and `Input` of the same size.
39
+ */
40
+ size?: "sm" | "md" | undefined;
36
41
  className?: string | undefined;
37
42
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root. */
38
43
  classNames?: ClassNames<ChipGroupPart>;
@@ -71,6 +76,7 @@ export function ChipGroup(props: ChipGroupProps) {
71
76
  name,
72
77
  invalid,
73
78
  id,
79
+ size = "sm",
74
80
  className,
75
81
  classNames,
76
82
  "aria-label": ariaLabel,
@@ -156,7 +162,8 @@ export function ChipGroup(props: ChipGroupProps) {
156
162
  {...item}
157
163
  onClick={() => toggle(option.value)}
158
164
  className={cn(
159
- "inline-flex min-h-7 cursor-pointer items-center gap-1.5 rounded-badge border-control bg-surface-control px-3 font-medium text-fs-130 text-ink-2 hover:bg-surface-2 focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-50 aria-pressed:border-accent aria-pressed:bg-accent-soft aria-pressed:text-accent-ink group-data-[invalid]/chips:border-danger in-data-[density=touch]:min-h-11 [&_svg]:size-3",
165
+ "inline-flex cursor-pointer items-center gap-1.5 rounded-badge border-control bg-surface-control px-3 font-medium text-fs-130 text-ink-2 hover:bg-surface-2 focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-50 aria-pressed:border-accent aria-pressed:bg-accent-soft aria-pressed:text-accent-ink group-data-[invalid]/chips:border-danger min-h-(--touch-target) [&_svg]:size-3",
166
+ size === "md" ? "min-h-control-md" : "min-h-control-sm",
160
167
  classNames?.chip,
161
168
  )}
162
169
  >
@@ -271,7 +271,7 @@ export function Combobox({
271
271
  onKeyDown={handleKeyDown}
272
272
  className={cn(
273
273
  "w-full min-w-0 rounded-input border-control bg-surface-control pl-3 text-control text-ink placeholder:text-ink-3 focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1 disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-danger",
274
- size === "sm" ? "h-control-sm" : "h-input min-h-(--touch-target)",
274
+ size === "sm" ? "h-control-sm" : "h-control-md min-h-(--touch-target)",
275
275
  hasClear ? "pr-8" : "pr-3",
276
276
  classNames?.input,
277
277
  )}
@@ -67,7 +67,7 @@ export function CopyField({
67
67
  onCopy?.(value);
68
68
  }}
69
69
  className={cn(
70
- "inline-flex h-control-sm shrink-0 cursor-pointer items-center gap-1.5 rounded-button px-2.5 font-semibold text-ink-2 text-meta hover:bg-surface-2 hover:text-ink focus-visible:focus-ring in-data-[density=touch]:h-11",
70
+ "inline-flex h-control-sm shrink-0 cursor-pointer items-center gap-1.5 rounded-button px-2.5 font-semibold text-ink-2 text-meta hover:bg-surface-2 hover:text-ink focus-visible:focus-ring",
71
71
  copied && "text-success",
72
72
  classNames?.button,
73
73
  )}
@@ -49,6 +49,8 @@ export interface DatePickerProps
49
49
  locale?: string;
50
50
  /** First day of the week in the calendar, 0 (Sunday) to 6. Defaults from the locale (es-PE: Monday). */
51
51
  weekStartsOn?: WeekStart;
52
+ /** `sm` is 30px and `md` (default) 38px, the heights of `Button` and `Input` of the same size. */
53
+ size?: "sm" | "md";
52
54
  /** Shows a button that clears the date. Default `true`. */
53
55
  clearable?: boolean;
54
56
  clearLabel?: string;
@@ -63,8 +65,9 @@ export interface DatePickerProps
63
65
  classNames?: ClassNames<DatePickerPart>;
64
66
  }
65
67
 
68
+ // The clear and calendar buttons wrap a 14-16px glyph; `min-h-control-sm` gives each a 30px hit area.
66
69
  const ICON_BUTTON =
67
- "flex w-8 items-center justify-center rounded-input text-ink-3 outline-none hover:text-ink focus-visible:focus-ring disabled:pointer-events-none disabled:opacity-50";
70
+ "flex min-h-control-sm w-8 items-center justify-center rounded-input text-ink-3 outline-none hover:text-ink focus-visible:focus-ring disabled:pointer-events-none disabled:opacity-50";
68
71
 
69
72
  /**
70
73
  * Typed date field plus a calendar popover. The value is an ISO "YYYY-MM-DD" string end to end,
@@ -80,6 +83,7 @@ export function DatePicker({
80
83
  isDateDisabled,
81
84
  locale: localeProp,
82
85
  weekStartsOn,
86
+ size = "md",
83
87
  clearable = true,
84
88
  clearLabel,
85
89
  name,
@@ -167,7 +171,8 @@ export function DatePicker({
167
171
  }}
168
172
  onKeyDown={handleKeyDown}
169
173
  className={cn(
170
- "h-input min-h-(--touch-target) w-full min-w-0 rounded-input border-control bg-surface-control pl-3 text-control text-ink tabular-nums placeholder:text-ink-3 focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1 disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-danger",
174
+ size === "sm" ? "h-control-sm" : "h-control-md",
175
+ "min-h-(--touch-target) w-full min-w-0 rounded-input border-control bg-surface-control pl-3 text-control text-ink tabular-nums placeholder:text-ink-3 focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1 disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-danger",
171
176
  hasClear ? "pr-16" : "pr-9",
172
177
  classNames?.input,
173
178
  className,
@@ -11,7 +11,20 @@ import { TimeInput } from "../time-input/time-input.js";
11
11
  import { DatePicker } from "./date-picker.js";
12
12
  import { dateTimeInRange, joinDateTime, splitDateTime } from "./model.js";
13
13
 
14
- export type DateTimePickerPart = "root" | "date" | "time";
14
+ /**
15
+ * `date` is the date picker's root and `time` the wrapper of the time field; `dateInput`, `clear`,
16
+ * `trigger`, `content` and `calendar` reach the inner `DatePicker` parts, `timeInput` the time field.
17
+ */
18
+ export type DateTimePickerPart =
19
+ | "root"
20
+ | "date"
21
+ | "time"
22
+ | "dateInput"
23
+ | "clear"
24
+ | "trigger"
25
+ | "content"
26
+ | "calendar"
27
+ | "timeInput";
15
28
 
16
29
  export interface DateTimePickerProps
17
30
  extends Omit<
@@ -47,6 +60,8 @@ export interface DateTimePickerProps
47
60
  "aria-invalid"?: boolean | "true" | "false";
48
61
  container?: HTMLElement | null;
49
62
  material?: Material;
63
+ /** Height of both halves: `sm` is 30px and `md` (default) 38px, like `Button` and `Input`. */
64
+ size?: "sm" | "md";
50
65
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
51
66
  classNames?: ClassNames<DateTimePickerPart>;
52
67
  }
@@ -74,6 +89,7 @@ export function DateTimePicker({
74
89
  invalid,
75
90
  container,
76
91
  material,
92
+ size = "md",
77
93
  className,
78
94
  classNames,
79
95
  "aria-label": ariaLabel,
@@ -158,8 +174,16 @@ export function DateTimePicker({
158
174
  aria-labelledby={ariaLabelledBy}
159
175
  container={container}
160
176
  material={material}
177
+ size={size}
161
178
  className={undefined}
162
- classNames={{ root: cn("flex-[3_1_10rem]", classNames?.date) }}
179
+ classNames={{
180
+ root: cn("flex-[3_1_10rem]", classNames?.date),
181
+ input: classNames?.dateInput,
182
+ clear: classNames?.clear,
183
+ trigger: classNames?.trigger,
184
+ content: classNames?.content,
185
+ calendar: classNames?.calendar,
186
+ }}
163
187
  />
164
188
  <div className={cn("flex min-w-0 flex-[2_1_6rem]", classNames?.time)}>
165
189
  <TimeInput
@@ -170,6 +194,8 @@ export function DateTimePicker({
170
194
  onValueChange={(time) => update({ ...parts, time })}
171
195
  required={required}
172
196
  step={step}
197
+ size={size}
198
+ className={classNames?.timeInput}
173
199
  />
174
200
  </div>
175
201
  {name ? <input type="hidden" name={name} value={current} disabled={disabled} /> : null}
@@ -21,14 +21,17 @@ interface ControlProps {
21
21
  id?: string;
22
22
  "aria-describedby"?: string;
23
23
  "aria-invalid"?: boolean;
24
+ "aria-required"?: boolean;
25
+ disabled?: boolean;
24
26
  }
25
27
 
28
+ const NATIVE = new Set(["INPUT", "SELECT", "TEXTAREA", "BUTTON"]);
26
29
  const FORM_TAGS = new Set(["input", "select", "textarea", "button"]);
27
30
  const CONTROL =
28
31
  'input:not([type="hidden"]):not([disabled]), select, textarea, [role="combobox"], [role="spinbutton"], [role="slider"], [contenteditable="true"]';
29
32
  const FALLBACK_CONTROL = 'button:not([tabindex="-1"]), [tabindex]:not([tabindex="-1"])';
30
33
 
31
- export type FieldPart = "root" | "label" | "optional" | "hint" | "error";
34
+ export type FieldPart = "root" | "label" | "optional" | "required" | "hint" | "error";
32
35
 
33
36
  export interface FieldProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "id"> {
34
37
  /** The label content: text or any node (an icon, a tooltip trigger). */
@@ -38,6 +41,13 @@ export interface FieldProps extends Omit<ComponentPropsWithoutRef<"div">, "child
38
41
  error?: string | null;
39
42
  /** Marks the field as optional by appending the localized marker to the label. */
40
43
  optional?: boolean;
44
+ /**
45
+ * Marks the field as required: a visible `*` marker (hidden from assistive tech, which gets
46
+ * `aria-required` on the control instead). Native validation is not turned on.
47
+ */
48
+ required?: boolean;
49
+ /** Disables the control and mutes the label. */
50
+ disabled?: boolean;
41
51
  /** Id of the control the label and messages belong to. Generated when omitted. */
42
52
  id?: string;
43
53
  /**
@@ -60,6 +70,8 @@ export function Field({
60
70
  hint,
61
71
  error,
62
72
  optional,
73
+ required,
74
+ disabled,
63
75
  id: idProp,
64
76
  controlId: controlIdProp,
65
77
  children,
@@ -86,6 +98,8 @@ export function Field({
86
98
  id: controlId,
87
99
  "aria-describedby": describedBy,
88
100
  "aria-invalid": error ? true : undefined,
101
+ ...(required ? { "aria-required": true } : null),
102
+ ...(disabled ? { disabled: true } : null),
89
103
  })
90
104
  : children;
91
105
 
@@ -107,21 +121,34 @@ export function Field({
107
121
  const merged = [before.describedby, describedBy].filter(Boolean).join(" ");
108
122
  if (merged) target.setAttribute("aria-describedby", merged);
109
123
  if (error) target.setAttribute("aria-invalid", "true");
124
+ const beforeRequired = target.getAttribute("aria-required");
125
+ if (required) target.setAttribute("aria-required", "true");
126
+ const native = NATIVE.has(target.tagName);
127
+ const disabledName = native ? "disabled" : "aria-disabled";
128
+ const beforeDisabled = target.getAttribute(disabledName);
129
+ if (disabled) target.setAttribute(disabledName, native ? "" : "true");
110
130
  return () => {
111
131
  for (const [name, value] of [
112
132
  ["aria-describedby", before.describedby],
113
133
  ["aria-invalid", before.invalid],
134
+ ["aria-required", beforeRequired],
135
+ [disabledName, beforeDisabled],
114
136
  ] as const) {
115
137
  if (value === null) target.removeAttribute(name);
116
138
  else target.setAttribute(name, value);
117
139
  }
118
140
  };
119
- }, [single, baseId, controlIdProp, idProp, describedBy, error]);
141
+ }, [single, baseId, controlIdProp, idProp, describedBy, error, required, disabled]);
120
142
 
121
143
  return (
122
144
  <div {...props} className={cn("flex min-w-0 flex-col gap-1.25", classNames?.root, className)}>
123
- <Label htmlFor={controlId} className={classNames?.label}>
145
+ <Label htmlFor={controlId} className={cn(disabled && "text-ink-3", classNames?.label)}>
124
146
  {label}
147
+ {required ? (
148
+ <span aria-hidden="true" className={cn("ms-0.5 text-danger", classNames?.required)}>
149
+ *
150
+ </span>
151
+ ) : null}
125
152
  {optional ? (
126
153
  <span className={cn("font-normal text-ink-3", classNames?.optional)}>
127
154
  {" "}
@@ -0,0 +1,22 @@
1
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
+ import { cn } from "../../utils/cn.js";
3
+
4
+ export interface FieldsetProps extends Omit<ComponentPropsWithoutRef<"fieldset">, "title"> {
5
+ /** The group name; announced with each control inside. */
6
+ legend: ReactNode;
7
+ description?: ReactNode;
8
+ }
9
+
10
+ /**
11
+ * Native `<fieldset>` for a group of related controls (a radio set, an address). `disabled`
12
+ * disables every control inside, as the platform does.
13
+ */
14
+ export function Fieldset({ legend, description, children, className, ...props }: FieldsetProps) {
15
+ return (
16
+ <fieldset {...props} className={cn("m-0 flex min-w-0 flex-col gap-3 border-0 p-0", className)}>
17
+ <legend className="float-left w-full p-0 font-semibold text-ink-2 text-meta">{legend}</legend>
18
+ {description ? <p className="-mt-1.5 text-meta text-ink-3">{description}</p> : null}
19
+ {children}
20
+ </fieldset>
21
+ );
22
+ }
@@ -0,0 +1 @@
1
+ export { Fieldset, type FieldsetProps } from "./fieldset.js";
@@ -0,0 +1,74 @@
1
+ "use client";
2
+
3
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
4
+ import { Button } from "../../atoms/button/index.js";
5
+ import { useUiStrings } from "../../i18n/index.js";
6
+ import { cn } from "../../utils/cn.js";
7
+
8
+ export interface FormFooterProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
9
+ /** Called by the cancel button; without it no cancel button renders. */
10
+ onCancel?: () => void;
11
+ cancelLabel?: string;
12
+ /** Default: the localized "Save". */
13
+ submitLabel?: string;
14
+ /** Submit in flight: the submit button is busy (stays focusable, ignores presses), cancel is disabled. */
15
+ busy?: boolean;
16
+ /** Shows the localized "Unsaved changes" hint (polite live region) beside the actions. */
17
+ dirty?: boolean;
18
+ /** Disables the submit button, e.g. while the form is invalid. */
19
+ submitDisabled?: boolean;
20
+ /** Replaces the dirty hint text. */
21
+ hint?: ReactNode;
22
+ /** Extra actions placed before cancel. */
23
+ children?: ReactNode;
24
+ /** Pins the footer to the bottom of its scroll container. Default `true`. */
25
+ sticky?: boolean;
26
+ }
27
+
28
+ /**
29
+ * Action row of a form: cancel and submit on the end, an optional dirty hint on the start.
30
+ * Sticky by default, so the actions stay in reach in a long form or a drawer. Place it inside the
31
+ * `<form>` so the submit button submits it.
32
+ */
33
+ export function FormFooter({
34
+ onCancel,
35
+ cancelLabel,
36
+ submitLabel,
37
+ busy,
38
+ dirty,
39
+ submitDisabled,
40
+ hint,
41
+ children,
42
+ sticky = true,
43
+ className,
44
+ ...props
45
+ }: FormFooterProps) {
46
+ const strings = useUiStrings();
47
+ const hintContent = hint ?? (dirty ? strings.unsavedChanges : null);
48
+ return (
49
+ <div
50
+ {...props}
51
+ aria-busy={busy ? "true" : undefined}
52
+ className={cn(
53
+ "@container/form-footer flex min-w-0 flex-wrap items-center gap-x-4 gap-y-2 border-line border-t bg-surface py-3",
54
+ sticky && "sticky bottom-0 z-10",
55
+ className,
56
+ )}
57
+ >
58
+ <p role="status" className="me-auto min-w-0 text-meta text-ink-3">
59
+ {hintContent}
60
+ </p>
61
+ <div className="flex flex-wrap items-center justify-end gap-2">
62
+ {children}
63
+ {onCancel ? (
64
+ <Button type="button" variant="ghost" disabled={busy} onClick={onCancel}>
65
+ {cancelLabel ?? strings.cancel}
66
+ </Button>
67
+ ) : null}
68
+ <Button type="submit" variant="primary" loading={busy} disabled={submitDisabled}>
69
+ {submitLabel ?? strings.save}
70
+ </Button>
71
+ </div>
72
+ </div>
73
+ );
74
+ }
@@ -0,0 +1 @@
1
+ export { FormFooter, type FormFooterProps } from "./form-footer.js";
@@ -1,18 +1,35 @@
1
1
  import type { ComponentPropsWithoutRef } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export type FormGridProps = ComponentPropsWithoutRef<"div">;
4
+ export type FormGridColumns = 1 | 2 | 3;
5
+ export type FormGridSpan = 1 | 2 | 3 | "full";
6
+
7
+ export interface FormGridProps extends ComponentPropsWithoutRef<"div"> {
8
+ /**
9
+ * Largest column count, reached by container width: 2 columns from 620px, 3 from 900px
10
+ * (the wrapper is the size container). `1` never splits. Default `2`.
11
+ */
12
+ columns?: FormGridColumns;
13
+ }
14
+
15
+ const COLUMNS: Record<FormGridColumns, string> = {
16
+ 1: "",
17
+ 2: "@min-[620px]/form-grid:grid-cols-[repeat(2,minmax(0,1fr))]",
18
+ 3: "@min-[620px]/form-grid:grid-cols-[repeat(2,minmax(0,1fr))] @min-[900px]/form-grid:grid-cols-[repeat(3,minmax(0,1fr))]",
19
+ };
5
20
 
6
21
  /**
7
- * Grid for pairs of fields. One column in a narrow container, two columns from 620px of
8
- * container width (the wrapper is the size container; the grid keeps `className` and props).
22
+ * Grid for fields. One column in a narrow container, then up to `columns` by container width (the
23
+ * wrapper is the size container; the grid keeps `className` and props).
9
24
  */
10
- export function FormGrid({ className, ...props }: FormGridProps) {
25
+ export function FormGrid({ columns = 2, className, ...props }: FormGridProps) {
11
26
  return (
12
27
  <div className="@container/form-grid min-w-0">
13
28
  <div
29
+ data-columns={columns}
14
30
  className={cn(
15
- "grid grid-cols-[minmax(0,1fr)] gap-3.5 @min-[620px]/form-grid:grid-cols-[repeat(2,minmax(0,1fr))]",
31
+ "group/form-grid grid grid-cols-[minmax(0,1fr)] gap-3.5",
32
+ COLUMNS[columns],
16
33
  className,
17
34
  )}
18
35
  {...props}
@@ -20,3 +37,23 @@ export function FormGrid({ className, ...props }: FormGridProps) {
20
37
  </div>
21
38
  );
22
39
  }
40
+
41
+ export interface FormGridItemProps extends ComponentPropsWithoutRef<"div"> {
42
+ /**
43
+ * Columns the item spans once the grid has them; it never adds a column the grid does not
44
+ * have. `"full"` spans every column at any width. Default `1`.
45
+ */
46
+ span?: FormGridSpan;
47
+ }
48
+
49
+ const SPAN: Record<FormGridSpan, string> = {
50
+ 1: "",
51
+ 2: "group-data-[columns=2]/form-grid:@min-[620px]/form-grid:col-span-2 group-data-[columns=3]/form-grid:@min-[620px]/form-grid:col-span-2",
52
+ 3: "group-data-[columns=3]/form-grid:@min-[620px]/form-grid:col-span-2 group-data-[columns=3]/form-grid:@min-[900px]/form-grid:col-span-3",
53
+ full: "col-span-full",
54
+ };
55
+
56
+ /** Grid cell that spans several columns; use it around a `Field` that needs the full row. */
57
+ export function FormGridItem({ span = 1, className, ...props }: FormGridItemProps) {
58
+ return <div className={cn("min-w-0", SPAN[span], className)} {...props} />;
59
+ }
@@ -1 +1,8 @@
1
- export { FormGrid, type FormGridProps } from "./form-grid.js";
1
+ export {
2
+ FormGrid,
3
+ type FormGridColumns,
4
+ FormGridItem,
5
+ type FormGridItemProps,
6
+ type FormGridProps,
7
+ type FormGridSpan,
8
+ } from "./form-grid.js";
@@ -0,0 +1,41 @@
1
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
+ import { cn } from "../../utils/cn.js";
3
+
4
+ export interface FormSectionProps extends Omit<ComponentPropsWithoutRef<"section">, "title"> {
5
+ title: ReactNode;
6
+ description?: ReactNode;
7
+ /** The fields; usually a `FormGrid`. */
8
+ children: ReactNode;
9
+ }
10
+
11
+ /**
12
+ * Titled block of a form: the title and description beside the fields from 640px of container
13
+ * width, stacked above them in a narrower container (the wrapper is the size container).
14
+ */
15
+ export function FormSection({
16
+ title,
17
+ description,
18
+ children,
19
+ className,
20
+ ...props
21
+ }: FormSectionProps) {
22
+ return (
23
+ <section
24
+ {...props}
25
+ className={cn(
26
+ "@container/form-section min-w-0 [&+&]:border-line [&+&]:border-t [&+&]:pt-6",
27
+ className,
28
+ )}
29
+ >
30
+ <div className="grid min-w-0 grid-cols-[minmax(0,1fr)] gap-x-8 gap-y-4 @min-[640px]/form-section:grid-cols-[minmax(0,1fr)_minmax(0,2fr)]">
31
+ <header className="flex min-w-0 flex-col gap-1">
32
+ <h3 className="font-semibold text-fs-140 text-ink [overflow-wrap:anywhere]">{title}</h3>
33
+ {description ? (
34
+ <p className="text-fs-130 text-ink-3 [overflow-wrap:anywhere]">{description}</p>
35
+ ) : null}
36
+ </header>
37
+ <div className="min-w-0">{children}</div>
38
+ </div>
39
+ </section>
40
+ );
41
+ }
@@ -0,0 +1 @@
1
+ export { FormSection, type FormSectionProps } from "./form-section.js";
@@ -8,8 +8,11 @@ export * from "./dropzone/index.js";
8
8
  export * from "./emoji-picker/index.js";
9
9
  export * from "./emoji-reaction-button/index.js";
10
10
  export * from "./field/index.js";
11
+ export * from "./fieldset/index.js";
11
12
  export * from "./form/index.js";
13
+ export * from "./form-footer/index.js";
12
14
  export * from "./form-grid/index.js";
15
+ export * from "./form-section/index.js";
13
16
  export * from "./inline-select/index.js";
14
17
  export * from "./input/index.js";
15
18
  export * from "./input-icon/index.js";
@@ -2,23 +2,27 @@ import type { ComponentPropsWithRef, ReactNode } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  import { cn } from "../../utils/cn.js";
4
4
 
5
- export type InputSize = "xs" | "md" | "lg";
5
+ /** `sm` (30px) and `md` (38px) are the heights every control shares; `xs` is the older name of `sm`. */
6
+ export type InputSize = "xs" | "sm" | "md" | "lg";
6
7
  export type InputVariant = "default" | "bare";
7
8
  export type InputPart = "root" | "start" | "end" | "input";
8
9
 
9
10
  const height: Readonly<Record<InputSize, string>> = {
10
11
  xs: "h-control-sm",
11
- md: "h-input",
12
+ sm: "h-control-sm",
13
+ md: "h-control-md",
12
14
  lg: "h-control-lg text-fs-140",
13
15
  };
14
16
  const paddingX: Readonly<Record<InputSize, string>> = {
15
17
  xs: "px-2.5",
18
+ sm: "px-2.5",
16
19
  md: "px-3",
17
20
  lg: "px-4",
18
21
  };
19
22
 
20
23
  export const inputSizeClasses: Readonly<Record<InputSize, string>> = {
21
24
  xs: `${height.xs} ${paddingX.xs}`,
25
+ sm: `${height.sm} ${paddingX.sm}`,
22
26
  md: `${height.md} ${paddingX.md}`,
23
27
  lg: `${height.lg} ${paddingX.lg}`,
24
28
  };
@@ -30,7 +34,10 @@ const RING =
30
34
  const INVALID = "aria-[invalid=true]:border-danger";
31
35
 
32
36
  export interface InputProps extends Omit<ComponentPropsWithRef<"input">, "size"> {
33
- /** `xs` is the 30px compact field (the height of the small `Button`), `lg` the thumb-friendly one. Default `md`. */
37
+ /**
38
+ * `sm` is the 30px compact field and `md` (default) the 38px one: the heights of `Button` `sm` and
39
+ * `md`. `xs` is the same as `sm`; `lg` is the thumb-friendly field.
40
+ */
34
41
  size?: InputSize;
35
42
  /** `bare` drops the border, background and side padding, for a field that sits inside chrome of its own. */
36
43
  variant?: InputVariant;
@@ -1,13 +1,12 @@
1
1
  import { type ReactNode, useId, useMemo } from "react";
2
2
  import { Check } from "../../icons/index.js";
3
3
  import { cn } from "../../utils/cn.js";
4
+ import { ITEM_MOTION, POPPER_MOTION } from "../../utils/overlay-motion.js";
4
5
  import { isGroup, type ListboxItem, type ListboxOption } from "./listbox.js";
5
6
 
6
- export const LISTBOX_SURFACE =
7
- "z-85 min-w-(--ui-popper-anchor-width) max-h-[min(20rem,var(--ui-popper-available-height))] max-w-(--ui-popper-available-width) overflow-y-auto overscroll-contain rounded-popover surface-overlay p-1.5 text-ink shadow-overlay";
7
+ export const LISTBOX_SURFACE = `z-85 min-w-(--ui-popper-anchor-width) max-h-[min(20rem,var(--ui-popper-available-height))] max-w-(--ui-popper-available-width) overflow-y-auto overscroll-contain rounded-popover surface-overlay p-1.5 text-ink shadow-overlay ${POPPER_MOTION}`;
8
8
 
9
- const OPTION =
10
- "flex min-h-[max(2rem,var(--touch-target))] w-full cursor-pointer items-center gap-2 rounded-event px-2.5 py-1.5 text-body text-ink outline-none data-[highlighted]:bg-surface-2 data-[disabled]:cursor-not-allowed data-[disabled]:opacity-50";
9
+ const OPTION = `flex min-h-[max(2rem,var(--touch-target))] w-full cursor-pointer items-center gap-2 rounded-event px-2.5 py-1.5 text-body text-ink outline-none data-[highlighted]:bg-surface-2 data-[disabled]:cursor-not-allowed data-[disabled]:opacity-50 ${ITEM_MOTION}`;
11
10
 
12
11
  export function optionDomId(base: string, index: number): string {
13
12
  return `${base}-opt-${index}`;
@@ -57,7 +57,7 @@ export function NativeSelect({
57
57
  aria-invalid={invalid || undefined}
58
58
  className={cn(
59
59
  "w-full min-w-0 appearance-none rounded-input border-control bg-surface-control py-0 pl-3 text-control text-ink focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1 disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-danger",
60
- size === "sm" ? "h-control-sm pr-7" : "h-input pr-8",
60
+ size === "sm" ? "h-control-sm pr-7" : "h-control-md pr-8",
61
61
  classNames?.select,
62
62
  className,
63
63
  )}
@@ -2,4 +2,5 @@ export {
2
2
  NumberStepper,
3
3
  type NumberStepperPart,
4
4
  type NumberStepperProps,
5
+ type NumberStepperSize,
5
6
  } from "./number-stepper.js";