@jcsoftdev/ui 0.4.0 → 0.6.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 (489) hide show
  1. package/CHANGELOG.md +434 -0
  2. package/README.md +26 -4
  3. package/bin/ui-theme.mjs +40 -6
  4. package/dist/ai/code-block/code-block.js +1 -1
  5. package/dist/atoms/big-date/big-date.js +2 -2
  6. package/dist/atoms/button/button.d.ts +14 -2
  7. package/dist/atoms/button/button.js +12 -5
  8. package/dist/atoms/chip/chip.d.ts +5 -0
  9. package/dist/atoms/chip/chip.js +3 -3
  10. package/dist/atoms/divider/divider.d.ts +15 -0
  11. package/dist/atoms/divider/divider.js +27 -0
  12. package/dist/atoms/divider/index.d.ts +1 -0
  13. package/dist/atoms/divider/index.js +1 -0
  14. package/dist/atoms/icon-button/icon-button.d.ts +1 -1
  15. package/dist/atoms/icon-button/icon-button.js +1 -1
  16. package/dist/atoms/index.d.ts +1 -0
  17. package/dist/atoms/index.js +1 -0
  18. package/dist/atoms/internal/hit-area.d.ts +5 -4
  19. package/dist/atoms/internal/hit-area.js +1 -1
  20. package/dist/atoms/progress/index.d.ts +1 -1
  21. package/dist/atoms/progress/index.js +4 -1
  22. package/dist/atoms/progress/progress.d.ts +6 -1
  23. package/dist/atoms/progress/progress.js +19 -1
  24. package/dist/atoms/radio-group/radio-group.js +1 -1
  25. package/dist/atoms/status-pill/status-pill.d.ts +16 -5
  26. package/dist/atoms/status-pill/status-pill.js +43 -18
  27. package/dist/auth/auth-illustration/auth-illustration.d.ts +35 -0
  28. package/dist/auth/auth-illustration/auth-illustration.js +72 -0
  29. package/dist/auth/auth-illustration/index.d.ts +3 -0
  30. package/dist/auth/auth-illustration/index.js +11 -0
  31. package/dist/auth/auth-illustration/look.d.ts +30 -0
  32. package/dist/auth/auth-illustration/look.js +0 -0
  33. package/dist/auth/auth-illustration/model.d.ts +133 -0
  34. package/dist/auth/auth-illustration/model.js +202 -0
  35. package/dist/auth/auth-illustration/use-art-pointer.d.ts +9 -0
  36. package/dist/auth/auth-illustration/use-art-pointer.js +69 -0
  37. package/dist/auth/auth-layout/auth-layout.d.ts +80 -0
  38. package/dist/auth/auth-layout/auth-layout.js +190 -0
  39. package/dist/auth/auth-layout/index.d.ts +1 -0
  40. package/dist/auth/auth-layout/index.js +1 -0
  41. package/dist/auth/character/character.d.ts +12 -0
  42. package/dist/auth/character/character.js +333 -0
  43. package/dist/auth/character/index.d.ts +1 -0
  44. package/dist/auth/character/index.js +1 -0
  45. package/dist/auth/index.d.ts +4 -0
  46. package/dist/auth/index.js +4 -0
  47. package/dist/auth/internal/auth-context.d.ts +17 -0
  48. package/dist/auth/internal/auth-context.js +10 -0
  49. package/dist/auth/internal/auth-styles.d.ts +1 -0
  50. package/dist/auth/internal/auth-styles.js +29 -0
  51. package/dist/auth/internal/portal-glyphs.d.ts +6 -0
  52. package/dist/auth/internal/portal-glyphs.js +39 -0
  53. package/dist/auth/login-form/context.d.ts +51 -0
  54. package/dist/auth/login-form/context.js +12 -0
  55. package/dist/auth/login-form/index.d.ts +2 -0
  56. package/dist/auth/login-form/index.js +23 -0
  57. package/dist/auth/login-form/login-form.d.ts +66 -0
  58. package/dist/auth/login-form/login-form.js +233 -0
  59. package/dist/auth/login-form/parts.d.ts +71 -0
  60. package/dist/auth/login-form/parts.js +371 -0
  61. package/dist/auth/looks/auth-illustration-any.d.ts +16 -0
  62. package/dist/auth/looks/auth-illustration-any.js +24 -0
  63. package/dist/auth/looks/index.d.ts +1 -0
  64. package/dist/auth/looks/index.js +1 -0
  65. package/dist/auth/mosaic/index.d.ts +1 -0
  66. package/dist/auth/mosaic/index.js +1 -0
  67. package/dist/auth/mosaic/mosaic.d.ts +11 -0
  68. package/dist/auth/mosaic/mosaic.js +195 -0
  69. package/dist/auth/slabs/index.d.ts +1 -0
  70. package/dist/auth/slabs/index.js +1 -0
  71. package/dist/auth/slabs/slabs.d.ts +13 -0
  72. package/dist/auth/slabs/slabs.js +136 -0
  73. package/dist/auth/stack/index.d.ts +1 -0
  74. package/dist/auth/stack/index.js +1 -0
  75. package/dist/auth/stack/stack.d.ts +6 -0
  76. package/dist/auth/stack/stack.js +222 -0
  77. package/dist/auth/statement/index.d.ts +1 -0
  78. package/dist/auth/statement/index.js +1 -0
  79. package/dist/auth/statement/statement.d.ts +13 -0
  80. package/dist/auth/statement/statement.js +99 -0
  81. package/dist/brand/logo-forge.js +1 -1
  82. package/dist/charts/candlestick-chart/candlestick-chart.js +2 -2
  83. package/dist/charts/chart-grid/chart-grid.js +2 -2
  84. package/dist/charts/chord-chart/chord-chart.js +1 -1
  85. package/dist/charts/core/axes.js +2 -2
  86. package/dist/charts/core/cartesian/annotations.js +2 -2
  87. package/dist/charts/core/cartesian/marks.js +1 -1
  88. package/dist/charts/core/distribution/marks.js +1 -1
  89. package/dist/charts/core/distribution/xy-points.js +1 -1
  90. package/dist/charts/core/export-menu.js +1 -1
  91. package/dist/charts/funnel-chart/funnel-chart.js +1 -1
  92. package/dist/charts/gantt-chart/gantt-chart.js +4 -4
  93. package/dist/charts/gantt-chart/gantt-marks.js +3 -3
  94. package/dist/charts/index.d.ts +2 -0
  95. package/dist/charts/index.js +2 -0
  96. package/dist/charts/maps/geo/map-data-table.js +1 -1
  97. package/dist/charts/polar-area-chart/polar-area-chart.js +1 -1
  98. package/dist/charts/radar-chart/radar-chart.js +1 -1
  99. package/dist/charts/stock-chart/stock-chart.js +1 -1
  100. package/dist/charts/stock-chart/stock-drawing-layer.js +3 -3
  101. package/dist/charts/stock-chart/stock-plot.js +2 -2
  102. package/dist/containers/chat-thread/chat-thread.d.ts +98 -0
  103. package/dist/containers/chat-thread/chat-thread.js +219 -0
  104. package/dist/containers/chat-thread/format.d.ts +20 -0
  105. package/dist/containers/chat-thread/format.js +50 -0
  106. package/dist/containers/chat-thread/index.d.ts +1 -0
  107. package/dist/containers/chat-thread/index.js +8 -0
  108. package/dist/containers/cols/cols.d.ts +1 -1
  109. package/dist/containers/cols/cols.js +7 -0
  110. package/dist/containers/comment/comment.js +1 -1
  111. package/dist/containers/context-rail/context-rail.d.ts +62 -0
  112. package/dist/containers/context-rail/context-rail.js +175 -0
  113. package/dist/containers/context-rail/index.d.ts +1 -0
  114. package/dist/containers/context-rail/index.js +6 -0
  115. package/dist/containers/dashboard/dashboard.d.ts +40 -0
  116. package/dist/containers/dashboard/dashboard.js +84 -0
  117. package/dist/containers/dashboard/index.d.ts +1 -0
  118. package/dist/containers/dashboard/index.js +14 -0
  119. package/dist/containers/data-grid/data-grid.demos.js +4 -4
  120. package/dist/containers/data-grid/data-grid.js +6 -6
  121. package/dist/containers/data-grid/filter-builder-editor.js +2 -2
  122. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  123. package/dist/containers/data-grid/spreadsheet.demos.d.ts +1 -1
  124. package/dist/containers/data-grid/spreadsheet.demos.js +1 -1
  125. package/dist/containers/detail-header/detail-header.d.ts +24 -0
  126. package/dist/containers/detail-header/detail-header.js +32 -0
  127. package/dist/containers/detail-header/index.d.ts +1 -0
  128. package/dist/containers/detail-header/index.js +6 -0
  129. package/dist/containers/facts/facts.js +1 -1
  130. package/dist/containers/filter-bar/filter-bar.d.ts +58 -0
  131. package/dist/containers/filter-bar/filter-bar.js +123 -0
  132. package/dist/containers/filter-bar/index.d.ts +1 -0
  133. package/dist/containers/filter-bar/index.js +6 -0
  134. package/dist/containers/hbars/hbars.js +2 -2
  135. package/dist/containers/index.d.ts +9 -0
  136. package/dist/containers/index.js +9 -0
  137. package/dist/containers/kanban/kanban.d.ts +23 -2
  138. package/dist/containers/kanban/kanban.js +101 -21
  139. package/dist/containers/kanban/model.d.ts +12 -0
  140. package/dist/containers/kanban/model.js +8 -0
  141. package/dist/containers/kpi/kpi.js +1 -1
  142. package/dist/containers/kpi-group/kpi-group.d.ts +6 -1
  143. package/dist/containers/kpi-group/kpi-group.js +6 -2
  144. package/dist/containers/list-detail/index.d.ts +1 -1
  145. package/dist/containers/list-detail/index.js +4 -0
  146. package/dist/containers/list-detail/list-detail.d.ts +51 -3
  147. package/dist/containers/list-detail/list-detail.js +109 -15
  148. package/dist/containers/page/page.d.ts +17 -4
  149. package/dist/containers/page/page.js +33 -4
  150. package/dist/containers/page-header/back.d.ts +10 -0
  151. package/dist/containers/page-header/back.js +28 -0
  152. package/dist/containers/page-header/index.d.ts +1 -0
  153. package/dist/containers/page-header/index.js +1 -0
  154. package/dist/containers/page-header/page-header.d.ts +19 -2
  155. package/dist/containers/page-header/page-header.js +26 -2
  156. package/dist/containers/pagination/cursor-pagination.d.ts +28 -0
  157. package/dist/containers/pagination/cursor-pagination.js +48 -0
  158. package/dist/containers/pagination/index.d.ts +3 -0
  159. package/dist/containers/pagination/index.js +10 -0
  160. package/dist/containers/pagination/pagination.d.ts +52 -0
  161. package/dist/containers/pagination/pagination.js +216 -0
  162. package/dist/containers/pagination/range.d.ts +29 -0
  163. package/dist/containers/pagination/range.js +42 -0
  164. package/dist/containers/pagination/use-pagination.d.ts +18 -0
  165. package/dist/containers/pagination/use-pagination.js +22 -0
  166. package/dist/containers/responsive-list/responsive-list.d.ts +28 -2
  167. package/dist/containers/responsive-list/responsive-list.js +134 -25
  168. package/dist/containers/row-actions/index.d.ts +1 -0
  169. package/dist/containers/row-actions/index.js +4 -0
  170. package/dist/containers/row-actions/row-actions.d.ts +26 -0
  171. package/dist/containers/row-actions/row-actions.js +78 -0
  172. package/dist/containers/selectable-card/index.d.ts +1 -0
  173. package/dist/containers/selectable-card/index.js +6 -0
  174. package/dist/containers/selectable-card/selectable-card.d.ts +26 -0
  175. package/dist/containers/selectable-card/selectable-card.js +57 -0
  176. package/dist/containers/settings-layout/settings-layout.d.ts +24 -7
  177. package/dist/containers/settings-layout/settings-layout.js +63 -8
  178. package/dist/containers/shortcuts/shortcuts.js +1 -1
  179. package/dist/containers/table/cell-padding.d.ts +2 -0
  180. package/dist/containers/table/cell-padding.js +4 -0
  181. package/dist/containers/table/index.d.ts +1 -0
  182. package/dist/containers/table/index.js +8 -0
  183. package/dist/containers/table/sort.d.ts +14 -0
  184. package/dist/containers/table/sort.js +11 -0
  185. package/dist/containers/table/table-parts.d.ts +24 -0
  186. package/dist/containers/table/table-parts.js +52 -0
  187. package/dist/containers/table/table.d.ts +37 -3
  188. package/dist/containers/table/table.js +120 -19
  189. package/dist/containers/table-columns-menu/index.d.ts +1 -0
  190. package/dist/containers/table-columns-menu/index.js +6 -0
  191. package/dist/containers/table-columns-menu/table-columns-menu.d.ts +14 -0
  192. package/dist/containers/table-columns-menu/table-columns-menu.js +46 -0
  193. package/dist/dashboards/layout.d.ts +1 -27
  194. package/dist/dashboards/layout.js +8 -40
  195. package/dist/forms/chip-group/chip-group.d.ts +5 -0
  196. package/dist/forms/chip-group/chip-group.js +3 -1
  197. package/dist/forms/combobox/combobox.js +1 -1
  198. package/dist/forms/copy-field/copy-field.js +1 -1
  199. package/dist/forms/date-picker/date-picker.d.ts +3 -1
  200. package/dist/forms/date-picker/date-picker.js +4 -2
  201. package/dist/forms/date-picker/date-time-picker.d.ts +8 -2
  202. package/dist/forms/date-picker/date-time-picker.js +13 -2
  203. package/dist/forms/field/field.d.ts +9 -2
  204. package/dist/forms/field/field.js +18 -4
  205. package/dist/forms/fieldset/fieldset.d.ts +11 -0
  206. package/dist/forms/fieldset/fieldset.js +12 -0
  207. package/dist/forms/fieldset/index.d.ts +1 -0
  208. package/dist/forms/fieldset/index.js +4 -0
  209. package/dist/forms/form-footer/form-footer.d.ts +26 -0
  210. package/dist/forms/form-footer/form-footer.js +44 -0
  211. package/dist/forms/form-footer/index.d.ts +1 -0
  212. package/dist/forms/form-footer/index.js +4 -0
  213. package/dist/forms/form-grid/form-grid.d.ts +21 -4
  214. package/dist/forms/form-grid/form-grid.js +20 -3
  215. package/dist/forms/form-grid/index.d.ts +1 -1
  216. package/dist/forms/form-grid/index.js +6 -2
  217. package/dist/forms/form-section/form-section.d.ts +12 -0
  218. package/dist/forms/form-section/form-section.js +30 -0
  219. package/dist/forms/form-section/index.d.ts +1 -0
  220. package/dist/forms/form-section/index.js +4 -0
  221. package/dist/forms/index.d.ts +4 -0
  222. package/dist/forms/index.js +4 -0
  223. package/dist/forms/input/input.d.ts +6 -2
  224. package/dist/forms/input/input.js +6 -2
  225. package/dist/forms/internal/listbox-items.d.ts +1 -1
  226. package/dist/forms/internal/listbox-items.js +3 -2
  227. package/dist/forms/native-select/native-select.js +1 -1
  228. package/dist/forms/password-input/index.d.ts +1 -0
  229. package/dist/forms/password-input/index.js +1 -0
  230. package/dist/forms/password-input/password-input.d.ts +16 -0
  231. package/dist/forms/password-input/password-input.js +45 -0
  232. package/dist/forms/select/index.d.ts +1 -1
  233. package/dist/forms/select/select.d.ts +5 -2
  234. package/dist/forms/select/select.js +7 -2
  235. package/dist/forms/select-menu/select-menu.js +1 -1
  236. package/dist/forms/time-input/time-input.d.ts +4 -2
  237. package/dist/forms/time-input/time-input.js +3 -1
  238. package/dist/i18n/strings.d.ts +150 -0
  239. package/dist/i18n/strings.js +80 -2
  240. package/dist/icons/eye.d.ts +2 -0
  241. package/dist/icons/eye.js +11 -0
  242. package/dist/icons/graduation-cap.d.ts +2 -0
  243. package/dist/icons/graduation-cap.js +12 -0
  244. package/dist/icons/house.d.ts +2 -0
  245. package/dist/icons/house.js +11 -0
  246. package/dist/icons/index.d.ts +4 -0
  247. package/dist/icons/index.js +8 -0
  248. package/dist/icons/mail.d.ts +2 -0
  249. package/dist/icons/mail.js +11 -0
  250. package/dist/motion/count-up.d.ts +20 -0
  251. package/dist/motion/count-up.js +59 -0
  252. package/dist/motion/cross-fade.d.ts +21 -0
  253. package/dist/motion/cross-fade.js +86 -0
  254. package/dist/motion/index.d.ts +5 -0
  255. package/dist/motion/index.js +14 -0
  256. package/dist/motion/model.d.ts +15 -0
  257. package/dist/motion/model.js +68 -0
  258. package/dist/motion/motion-styles.d.ts +1 -0
  259. package/dist/motion/motion-styles.js +35 -0
  260. package/dist/motion/reveal.d.ts +37 -0
  261. package/dist/motion/reveal.js +69 -0
  262. package/dist/motion/use-enter-phase.d.ts +11 -0
  263. package/dist/motion/use-enter-phase.js +40 -0
  264. package/dist/motion/use-highlight-row.d.ts +22 -0
  265. package/dist/motion/use-highlight-row.js +38 -0
  266. package/dist/navigation/tabs/tabs.js +1 -1
  267. package/dist/navigation/wizard/wizard.d.ts +4 -1
  268. package/dist/navigation/wizard/wizard.js +3 -0
  269. package/dist/overlays/alert-dialog/alert-dialog.js +8 -1
  270. package/dist/overlays/context-menu/context-menu.js +3 -1
  271. package/dist/overlays/dialog/dialog.js +10 -2
  272. package/dist/overlays/drawer/drawer.d.ts +18 -4
  273. package/dist/overlays/drawer/drawer.js +53 -4
  274. package/dist/overlays/drawer/index.d.ts +1 -1
  275. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +1 -1
  276. package/dist/overlays/dropdown-menu/dropdown-menu.js +5 -4
  277. package/dist/overlays/hover-card/hover-card.js +2 -0
  278. package/dist/overlays/popover/popover.js +2 -0
  279. package/dist/overlays/toaster/index.d.ts +1 -1
  280. package/dist/overlays/toaster/toaster.d.ts +28 -2
  281. package/dist/overlays/toaster/toaster.js +73 -29
  282. package/dist/overlays/tooltip/tooltip.js +2 -0
  283. package/dist/primitives/use-presence.js +9 -0
  284. package/dist/shell/app-shell/app-shell.d.ts +8 -1
  285. package/dist/shell/app-shell/app-shell.js +50 -3
  286. package/dist/shell/index.d.ts +1 -0
  287. package/dist/shell/index.js +1 -0
  288. package/dist/shell/sidebar/sidebar.d.ts +17 -1
  289. package/dist/shell/sidebar/sidebar.js +126 -76
  290. package/dist/shell/topbar/topbar.d.ts +4 -2
  291. package/dist/shell/topbar/topbar.js +2 -0
  292. package/dist/showcase/operations-bento.js +2 -2
  293. package/dist/states/empty-state/empty-state.d.ts +10 -3
  294. package/dist/states/empty-state/empty-state.js +46 -5
  295. package/dist/states/error-state/error-state.js +1 -1
  296. package/dist/states/skeleton/skeleton.js +1 -1
  297. package/dist/utils/class-tokens.generated.js +4 -6
  298. package/dist/utils/list-navigation.d.ts +14 -0
  299. package/dist/utils/list-navigation.js +44 -0
  300. package/dist/utils/overlay-motion.d.ts +12 -0
  301. package/dist/utils/overlay-motion.js +14 -0
  302. package/dist/utils/use-container-width.d.ts +6 -0
  303. package/dist/utils/use-container-width.js +19 -0
  304. package/icons/svg/eye.svg +4 -0
  305. package/icons/svg/graduation-cap.svg +5 -0
  306. package/icons/svg/house.svg +4 -0
  307. package/icons/svg/mail.svg +4 -0
  308. package/package.json +2 -2
  309. package/scripts/build-theme.mjs +46 -5
  310. package/src/ai/code-block/code-block.tsx +1 -1
  311. package/src/atoms/big-date/big-date.tsx +2 -2
  312. package/src/atoms/button/button.tsx +33 -6
  313. package/src/atoms/chip/chip.tsx +8 -3
  314. package/src/atoms/divider/divider.tsx +40 -0
  315. package/src/atoms/divider/index.ts +1 -0
  316. package/src/atoms/icon-button/icon-button.tsx +2 -2
  317. package/src/atoms/index.ts +1 -0
  318. package/src/atoms/internal/hit-area.ts +5 -4
  319. package/src/atoms/progress/index.ts +8 -1
  320. package/src/atoms/progress/progress.tsx +30 -1
  321. package/src/atoms/radio-group/radio-group.tsx +1 -1
  322. package/src/atoms/status-pill/status-pill.tsx +59 -18
  323. package/src/auth/auth-illustration/auth-illustration.tsx +100 -0
  324. package/src/auth/auth-illustration/index.ts +8 -0
  325. package/src/auth/auth-illustration/look.ts +32 -0
  326. package/src/auth/auth-illustration/model.ts +330 -0
  327. package/src/auth/auth-illustration/use-art-pointer.ts +78 -0
  328. package/src/auth/auth-layout/auth-layout.tsx +282 -0
  329. package/src/auth/auth-layout/index.ts +1 -0
  330. package/src/auth/character/character.tsx +346 -0
  331. package/src/auth/character/index.ts +1 -0
  332. package/src/auth/index.ts +4 -0
  333. package/src/auth/internal/auth-context.ts +26 -0
  334. package/src/auth/internal/auth-styles.tsx +39 -0
  335. package/src/auth/internal/portal-glyphs.tsx +32 -0
  336. package/src/auth/login-form/context.ts +78 -0
  337. package/src/auth/login-form/index.ts +21 -0
  338. package/src/auth/login-form/login-form.tsx +330 -0
  339. package/src/auth/login-form/parts.tsx +457 -0
  340. package/src/auth/looks/auth-illustration-any.tsx +38 -0
  341. package/src/auth/looks/index.ts +1 -0
  342. package/src/auth/mosaic/index.ts +1 -0
  343. package/src/auth/mosaic/mosaic.tsx +255 -0
  344. package/src/auth/slabs/index.ts +1 -0
  345. package/src/auth/slabs/slabs.tsx +181 -0
  346. package/src/auth/stack/index.ts +1 -0
  347. package/src/auth/stack/stack.tsx +267 -0
  348. package/src/auth/statement/index.ts +1 -0
  349. package/src/auth/statement/statement.tsx +122 -0
  350. package/src/brand/logo-forge.tsx +1 -1
  351. package/src/charts/candlestick-chart/candlestick-chart.tsx +2 -2
  352. package/src/charts/chart-grid/chart-grid.tsx +2 -2
  353. package/src/charts/chord-chart/chord-chart.tsx +1 -1
  354. package/src/charts/core/axes.tsx +2 -2
  355. package/src/charts/core/cartesian/annotations.tsx +2 -2
  356. package/src/charts/core/cartesian/marks.tsx +1 -1
  357. package/src/charts/core/distribution/marks.tsx +1 -1
  358. package/src/charts/core/distribution/xy-points.tsx +1 -1
  359. package/src/charts/core/export-menu.tsx +1 -1
  360. package/src/charts/funnel-chart/funnel-chart.tsx +1 -1
  361. package/src/charts/gantt-chart/gantt-chart.tsx +4 -4
  362. package/src/charts/gantt-chart/gantt-marks.tsx +3 -3
  363. package/src/charts/index.ts +2 -0
  364. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  365. package/src/charts/polar-area-chart/polar-area-chart.tsx +1 -1
  366. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  367. package/src/charts/stock-chart/stock-chart.tsx +1 -1
  368. package/src/charts/stock-chart/stock-drawing-layer.tsx +3 -3
  369. package/src/charts/stock-chart/stock-plot.tsx +2 -2
  370. package/src/containers/chat-thread/chat-thread.tsx +331 -0
  371. package/src/containers/chat-thread/format.ts +67 -0
  372. package/src/containers/chat-thread/index.ts +12 -0
  373. package/src/containers/cols/cols.tsx +13 -1
  374. package/src/containers/comment/comment.tsx +1 -1
  375. package/src/containers/context-rail/context-rail.tsx +229 -0
  376. package/src/containers/context-rail/index.ts +7 -0
  377. package/src/containers/dashboard/dashboard.tsx +142 -0
  378. package/src/containers/dashboard/index.ts +12 -0
  379. package/src/containers/data-grid/data-grid.demos.tsx +4 -4
  380. package/src/containers/data-grid/data-grid.tsx +6 -6
  381. package/src/containers/data-grid/filter-builder-editor.tsx +2 -2
  382. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  383. package/src/containers/data-grid/spreadsheet.demos.tsx +1 -1
  384. package/src/containers/detail-header/detail-header.tsx +64 -0
  385. package/src/containers/detail-header/index.ts +5 -0
  386. package/src/containers/facts/facts.tsx +1 -1
  387. package/src/containers/filter-bar/filter-bar.tsx +201 -0
  388. package/src/containers/filter-bar/index.ts +7 -0
  389. package/src/containers/hbars/hbars.tsx +2 -2
  390. package/src/containers/index.ts +9 -0
  391. package/src/containers/kanban/kanban.tsx +146 -39
  392. package/src/containers/kanban/model.ts +20 -0
  393. package/src/containers/kpi/kpi.tsx +1 -1
  394. package/src/containers/kpi-group/kpi-group.tsx +17 -2
  395. package/src/containers/list-detail/index.ts +5 -0
  396. package/src/containers/list-detail/list-detail.tsx +157 -9
  397. package/src/containers/page/page.tsx +61 -7
  398. package/src/containers/page-header/back.tsx +42 -0
  399. package/src/containers/page-header/index.ts +1 -0
  400. package/src/containers/page-header/page-header.tsx +49 -3
  401. package/src/containers/pagination/cursor-pagination.tsx +79 -0
  402. package/src/containers/pagination/index.ts +7 -0
  403. package/src/containers/pagination/pagination.tsx +266 -0
  404. package/src/containers/pagination/range.ts +68 -0
  405. package/src/containers/pagination/use-pagination.ts +44 -0
  406. package/src/containers/responsive-list/responsive-list.tsx +183 -46
  407. package/src/containers/row-actions/index.ts +1 -0
  408. package/src/containers/row-actions/row-actions.tsx +114 -0
  409. package/src/containers/selectable-card/index.ts +5 -0
  410. package/src/containers/selectable-card/selectable-card.tsx +84 -0
  411. package/src/containers/settings-layout/settings-layout.tsx +104 -13
  412. package/src/containers/shortcuts/shortcuts.tsx +1 -1
  413. package/src/containers/table/cell-padding.ts +2 -0
  414. package/src/containers/table/index.ts +6 -0
  415. package/src/containers/table/sort.ts +23 -0
  416. package/src/containers/table/table-parts.tsx +81 -0
  417. package/src/containers/table/table.tsx +212 -45
  418. package/src/containers/table-columns-menu/index.ts +5 -0
  419. package/src/containers/table-columns-menu/table-columns-menu.tsx +68 -0
  420. package/src/dashboards/layout.tsx +8 -75
  421. package/src/forms/chip-group/chip-group.tsx +8 -1
  422. package/src/forms/combobox/combobox.tsx +1 -1
  423. package/src/forms/copy-field/copy-field.tsx +1 -1
  424. package/src/forms/date-picker/date-picker.tsx +7 -2
  425. package/src/forms/date-picker/date-time-picker.tsx +28 -2
  426. package/src/forms/field/field.tsx +30 -3
  427. package/src/forms/fieldset/fieldset.tsx +22 -0
  428. package/src/forms/fieldset/index.ts +1 -0
  429. package/src/forms/form-footer/form-footer.tsx +74 -0
  430. package/src/forms/form-footer/index.ts +1 -0
  431. package/src/forms/form-grid/form-grid.tsx +42 -5
  432. package/src/forms/form-grid/index.ts +8 -1
  433. package/src/forms/form-section/form-section.tsx +41 -0
  434. package/src/forms/form-section/index.ts +1 -0
  435. package/src/forms/index.ts +4 -0
  436. package/src/forms/input/input.tsx +12 -3
  437. package/src/forms/internal/listbox-items.tsx +3 -4
  438. package/src/forms/native-select/native-select.tsx +1 -1
  439. package/src/forms/password-input/index.ts +1 -0
  440. package/src/forms/password-input/password-input.tsx +57 -0
  441. package/src/forms/select/index.ts +1 -1
  442. package/src/forms/select/select.tsx +14 -3
  443. package/src/forms/select-menu/select-menu.tsx +1 -1
  444. package/src/forms/time-input/time-input.tsx +6 -2
  445. package/src/i18n/strings.ts +150 -0
  446. package/src/icons/eye.tsx +12 -0
  447. package/src/icons/graduation-cap.tsx +13 -0
  448. package/src/icons/house.tsx +12 -0
  449. package/src/icons/index.ts +4 -0
  450. package/src/icons/mail.tsx +12 -0
  451. package/src/motion/count-up.tsx +83 -0
  452. package/src/motion/cross-fade.tsx +139 -0
  453. package/src/motion/index.ts +5 -0
  454. package/src/motion/model.ts +86 -0
  455. package/src/motion/motion-styles.tsx +47 -0
  456. package/src/motion/reveal.tsx +115 -0
  457. package/src/motion/use-enter-phase.ts +50 -0
  458. package/src/motion/use-highlight-row.ts +63 -0
  459. package/src/navigation/tabs/tabs.tsx +1 -1
  460. package/src/navigation/wizard/wizard.tsx +6 -1
  461. package/src/overlays/alert-dialog/alert-dialog.tsx +5 -1
  462. package/src/overlays/context-menu/context-menu.tsx +3 -2
  463. package/src/overlays/dialog/dialog.tsx +7 -2
  464. package/src/overlays/drawer/drawer.tsx +68 -6
  465. package/src/overlays/drawer/index.ts +1 -0
  466. package/src/overlays/dropdown-menu/dropdown-menu.tsx +5 -4
  467. package/src/overlays/hover-card/hover-card.tsx +2 -0
  468. package/src/overlays/popover/popover.tsx +2 -0
  469. package/src/overlays/toaster/index.ts +2 -0
  470. package/src/overlays/toaster/toaster.tsx +113 -17
  471. package/src/overlays/tooltip/tooltip.tsx +2 -0
  472. package/src/primitives/use-presence.ts +13 -0
  473. package/src/shell/app-shell/app-shell.tsx +54 -2
  474. package/src/shell/index.ts +1 -0
  475. package/src/shell/sidebar/sidebar.tsx +154 -75
  476. package/src/shell/topbar/topbar.tsx +8 -0
  477. package/src/showcase/operations-bento.tsx +2 -2
  478. package/src/states/empty-state/empty-state.tsx +52 -9
  479. package/src/states/error-state/error-state.tsx +1 -1
  480. package/src/states/skeleton/skeleton.tsx +1 -1
  481. package/src/utils/class-tokens.generated.ts +4 -6
  482. package/src/utils/list-navigation.ts +63 -0
  483. package/src/utils/overlay-motion.ts +33 -0
  484. package/src/utils/use-container-width.ts +24 -0
  485. package/styles/Theme.kt +15 -18
  486. package/styles/tailwind.css +29 -28
  487. package/styles/theme.css +29 -28
  488. package/styles/tokens.css +46 -0
  489. package/tokens/default.json +51 -29
@@ -0,0 +1,115 @@
1
+ "use client";
2
+
3
+ import {
4
+ Children,
5
+ type CSSProperties,
6
+ type HTMLAttributes,
7
+ isValidElement,
8
+ type ReactNode,
9
+ type Ref,
10
+ } from "react";
11
+ import { composeRefs, Slot } from "../utils/slot.js";
12
+ import { MotionStyles } from "./motion-styles.js";
13
+ import { type EnterPhase, useEnterPhase } from "./use-enter-phase.js";
14
+
15
+ type MotionVars = CSSProperties & Record<`--ui-motion-${string}`, string | number>;
16
+
17
+ function phaseProps(phase: EnterPhase, vars: MotionVars, style?: CSSProperties) {
18
+ if (phase === "static") return { style };
19
+ return { "data-motion": phase, style: { ...vars, ...style } };
20
+ }
21
+
22
+ export interface RevealProps extends HTMLAttributes<HTMLElement> {
23
+ /** Extra wait before entering, in ms. */
24
+ delay?: number;
25
+ /** Enter when the element first scrolls into view instead of on mount. */
26
+ inView?: boolean;
27
+ /** Animate the single child element instead of rendering a `div`. */
28
+ asChild?: boolean;
29
+ ref?: Ref<HTMLElement>;
30
+ }
31
+
32
+ /**
33
+ * Fades its content in with a small rise when it mounts on the client, or first scrolls into view
34
+ * with `inView`. Server-rendered content and reduced motion show the end state at once. The
35
+ * content stays in the accessibility tree the whole time: hiding uses `opacity` only.
36
+ */
37
+ export function Reveal({ delay, inView = false, asChild, style, ref, ...props }: RevealProps) {
38
+ const [phaseRef, phase] = useEnterPhase(inView);
39
+ const Comp = asChild ? Slot : "div";
40
+ const vars: MotionVars = { "--ui-motion-i": 0 };
41
+ if (delay) vars["--ui-motion-delay"] = `${delay}ms`;
42
+ return (
43
+ <>
44
+ <MotionStyles />
45
+ <Comp
46
+ ref={composeRefs<HTMLElement>(ref, phaseRef) as Ref<HTMLDivElement>}
47
+ {...phaseProps(phase, vars, style)}
48
+ {...props}
49
+ />
50
+ </>
51
+ );
52
+ }
53
+
54
+ export interface StaggerProps extends HTMLAttributes<HTMLElement> {
55
+ /** Extra wait before the first child enters, in ms. */
56
+ delay?: number;
57
+ /** Start when the group first scrolls into view instead of on mount. */
58
+ inView?: boolean;
59
+ /**
60
+ * Longest gap between the first and the last child's start, in ms. Each step is a quarter of
61
+ * `--motion-duration`, shortened so long lists still fit in this span (default 1.5 durations).
62
+ */
63
+ maxStagger?: number;
64
+ /** Element that wraps the children, e.g. `ul` for a list of `li`. */
65
+ as?: "div" | "ul" | "ol" | "section";
66
+ ref?: Ref<HTMLElement>;
67
+ children?: ReactNode;
68
+ }
69
+
70
+ /**
71
+ * Its children enter one after another, like `Reveal`, with the whole sequence capped by
72
+ * `maxStagger`. Each child element receives `data-motion` and a `style` variable, so it must
73
+ * pass `style` and `data-*` props to its DOM element (every element and most components do).
74
+ */
75
+ export function Stagger({
76
+ delay,
77
+ inView = false,
78
+ maxStagger,
79
+ as: Tag = "div",
80
+ style,
81
+ ref,
82
+ children,
83
+ ...props
84
+ }: StaggerProps) {
85
+ const [phaseRef, phase] = useEnterPhase(inView);
86
+ const items = Children.toArray(children);
87
+ const vars: MotionVars = { "--ui-motion-n": Math.max(1, items.length - 1) };
88
+ if (maxStagger !== undefined) vars["--ui-motion-span"] = `${Math.max(0, maxStagger)}ms`;
89
+ const itemVars = (i: number): MotionVars => {
90
+ const next: MotionVars = { "--ui-motion-i": i };
91
+ if (delay) next["--ui-motion-delay"] = `${delay}ms`;
92
+ return next;
93
+ };
94
+ return (
95
+ <>
96
+ <MotionStyles />
97
+ <Tag
98
+ ref={composeRefs<HTMLElement>(ref, phaseRef) as Ref<never>}
99
+ data-motion-stagger={phase === "static" ? undefined : ""}
100
+ style={phase === "static" ? style : { ...vars, ...style }}
101
+ {...props}
102
+ >
103
+ {items.map((child, i) =>
104
+ isValidElement(child) ? (
105
+ <Slot key={child.key} {...phaseProps(phase, itemVars(i))}>
106
+ {child}
107
+ </Slot>
108
+ ) : (
109
+ child
110
+ ),
111
+ )}
112
+ </Tag>
113
+ </>
114
+ );
115
+ }
@@ -0,0 +1,50 @@
1
+ "use client";
2
+
3
+ import { type RefCallback, useEffect, useState, useSyncExternalStore } from "react";
4
+ import { usePrefersReducedMotion } from "../utils/reduced-motion.js";
5
+
6
+ const subscribeNever = () => () => {};
7
+
8
+ /**
9
+ * True when this component's first render came from server HTML (on the server and while
10
+ * hydrating), false when it mounted on the client. Fixed for the component's lifetime, so server
11
+ * markup is never animated after hydration and hydration always matches it.
12
+ */
13
+ export function useStartedOnServer(): boolean {
14
+ const hydrating = useSyncExternalStore(
15
+ subscribeNever,
16
+ () => false,
17
+ () => true,
18
+ );
19
+ const [started] = useState(hydrating);
20
+ return started;
21
+ }
22
+
23
+ /** `static`: no motion (server HTML or reduced motion). `wait`: hidden until in view. `enter`: animating in. */
24
+ export type EnterPhase = "static" | "wait" | "enter";
25
+
26
+ /** Phase of an enter animation, on mount or (with `inView`) when the element first scrolls into view. */
27
+ export function useEnterPhase(inView: boolean): [RefCallback<HTMLElement>, EnterPhase] {
28
+ const startedOnServer = useStartedOnServer();
29
+ const reduced = usePrefersReducedMotion();
30
+ const [seen, setSeen] = useState(!inView);
31
+ const [node, setNode] = useState<HTMLElement | null>(null);
32
+ const animate = !startedOnServer && !reduced;
33
+
34
+ useEffect(() => {
35
+ if (!animate || seen || !node) return;
36
+ if (typeof IntersectionObserver === "undefined") {
37
+ setSeen(true);
38
+ return;
39
+ }
40
+ const observer = new IntersectionObserver((entries) => {
41
+ if (!entries.some((entry) => entry.isIntersecting)) return;
42
+ observer.disconnect();
43
+ setSeen(true);
44
+ });
45
+ observer.observe(node);
46
+ return () => observer.disconnect();
47
+ }, [animate, seen, node]);
48
+
49
+ return [setNode, !animate ? "static" : seen ? "enter" : "wait"];
50
+ }
@@ -0,0 +1,63 @@
1
+ "use client";
2
+
3
+ import { type AnimationEvent, type Key, useCallback, useEffect, useRef, useState } from "react";
4
+ import { usePrefersReducedMotion } from "../utils/reduced-motion.js";
5
+
6
+ type Pulse = "a" | "b";
7
+
8
+ /** Props for a highlighted row: spread them on the row element (`tr`, `li`, `div`). */
9
+ export interface HighlightRowProps {
10
+ "data-motion-pulse"?: Pulse;
11
+ onAnimationEnd: (event: AnimationEvent<HTMLElement>) => void;
12
+ }
13
+
14
+ export interface HighlightRow<K extends Key> {
15
+ /** Pulses the row with this key, e.g. after it was updated. Calling it again restarts the pulse. */
16
+ highlight: (key: K) => void;
17
+ /** Props for the row with this key. Render `<MotionStyles />` or any motion component once on the page. */
18
+ rowProps: (key: K) => HighlightRowProps;
19
+ }
20
+
21
+ /**
22
+ * A brief background pulse (accent tint fading out over 1.6 `--motion-duration`s) on rows that
23
+ * were inserted or updated. Pass the current row keys to pulse every key that appears after the
24
+ * first render automatically; call `highlight(key)` for updates. The rows on the first render
25
+ * (and in server HTML) never pulse, and under reduced motion nothing pulses.
26
+ * In a `tr` the cells carry the pulse, so it shows through cell backgrounds.
27
+ */
28
+ export function useHighlightRow<K extends Key>(keys?: readonly K[]): HighlightRow<K> {
29
+ const reduced = usePrefersReducedMotion();
30
+ const [pulses, setPulses] = useState<ReadonlyMap<K, Pulse>>(() => new Map());
31
+ const known = useRef<ReadonlySet<K> | null>(null);
32
+
33
+ const highlight = useCallback(
34
+ (key: K) => {
35
+ if (reduced) return;
36
+ setPulses((map) => new Map(map).set(key, map.get(key) === "a" ? "b" : "a"));
37
+ },
38
+ [reduced],
39
+ );
40
+
41
+ useEffect(() => {
42
+ if (!keys) return;
43
+ const previous = known.current;
44
+ known.current = new Set(keys);
45
+ if (!previous) return;
46
+ for (const key of keys) if (!previous.has(key)) highlight(key);
47
+ }, [keys, highlight]);
48
+
49
+ const rowProps = (key: K): HighlightRowProps => ({
50
+ "data-motion-pulse": pulses.get(key),
51
+ onAnimationEnd: (event) => {
52
+ if (!event.animationName.startsWith("ui-motion-pulse")) return;
53
+ setPulses((map) => {
54
+ if (!map.has(key)) return map;
55
+ const next = new Map(map);
56
+ next.delete(key);
57
+ return next;
58
+ });
59
+ },
60
+ });
61
+
62
+ return { highlight, rowProps };
63
+ }
@@ -176,7 +176,7 @@ export function TabsTrigger({
176
176
  }
177
177
  })}
178
178
  className={cn(
179
- "inline-flex shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap border-b-2 border-transparent px-2.5 @max-[420px]/tabs:px-2 pt-2.75 pb-2.5 text-control text-ink-3 hover:text-ink focus-visible:-outline-offset-2 data-[state=active]:border-accent-word data-[state=active]:text-ink",
179
+ "inline-flex min-h-(--touch-target) shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap border-b-2 border-transparent px-2.5 @max-[420px]/tabs:px-2 pt-2.75 pb-2.5 text-control text-ink-3 hover:text-ink focus-visible:-outline-offset-2 data-[state=active]:border-accent-word data-[state=active]:text-ink",
180
180
  className,
181
181
  )}
182
182
  >
@@ -8,7 +8,7 @@ import {
8
8
  useRef,
9
9
  useState,
10
10
  } from "react";
11
- import { Button } from "../../atoms/button/button.js";
11
+ import { Button, type ButtonSize } from "../../atoms/button/button.js";
12
12
  import { useUiStrings } from "../../i18n/index.js";
13
13
  import type { ClassNames } from "../../utils/class-names.js";
14
14
  import { cn } from "../../utils/cn.js";
@@ -59,6 +59,8 @@ export interface WizardProps
59
59
  backLabel?: string | undefined;
60
60
  nextLabel?: string | undefined;
61
61
  finishLabel?: string | undefined;
62
+ /** Size of the Back and Next/Finish buttons. Default `md` (38px, the height of a default field). */
63
+ buttonSize?: ButtonSize | undefined;
62
64
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root. */
63
65
  classNames?: ClassNames<WizardPart>;
64
66
  }
@@ -79,6 +81,7 @@ export function Wizard({
79
81
  onComplete,
80
82
  backLabel,
81
83
  nextLabel,
84
+ buttonSize = "md",
82
85
  finishLabel,
83
86
  className,
84
87
  classNames,
@@ -200,6 +203,7 @@ export function Wizard({
200
203
  >
201
204
  <Button
202
205
  variant="secondary"
206
+ size={buttonSize}
203
207
  disabled={index === 0 || pending !== null}
204
208
  onClick={() => goTo(index - 1)}
205
209
  className={classNames?.back}
@@ -208,6 +212,7 @@ export function Wizard({
208
212
  </Button>
209
213
  <Button
210
214
  variant="primary"
215
+ size={buttonSize}
211
216
  loading={pending !== null}
212
217
  loadingLabel={strings.processing}
213
218
  disabled={blocked}
@@ -20,6 +20,7 @@ import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
20
20
  import type { ClassNames } from "../../utils/class-names.js";
21
21
  import { cn } from "../../utils/cn.js";
22
22
  import { type Material, materialClass } from "../../utils/material.js";
23
+ import { DIALOG_MOTION, OVERLAY_MOTION } from "../../utils/overlay-motion.js";
23
24
  import { useControllableState } from "../../utils/use-controllable-state.js";
24
25
  import {
25
26
  PreviousFocusProvider,
@@ -278,7 +279,9 @@ function AlertDialogPanel({
278
279
  const previousFocusRef = usePreviousFocus();
279
280
  return (
280
281
  <DialogPrimitive.Portal container={container}>
281
- <DialogPrimitive.Overlay className={cn("fixed inset-0 z-70 bg-scrim", classNames?.overlay)} />
282
+ <DialogPrimitive.Overlay
283
+ className={cn("fixed inset-0 z-70 bg-scrim", OVERLAY_MOTION, classNames?.overlay)}
284
+ />
282
285
  <DialogPrimitive.Content
283
286
  ref={panelRef}
284
287
  role="alertdialog"
@@ -290,6 +293,7 @@ function AlertDialogPanel({
290
293
  onCloseAutoFocus={(event) => restoreFocusOnClose(event, previousFocusRef)}
291
294
  className={cn(
292
295
  "@container/dialog fixed top-[9dvh] left-1/2 z-70 flex max-h-[84dvh] w-[min(420px,100%)] max-w-full -translate-x-1/2 flex-col overflow-auto rounded-dialog outline-none surface-overlay shadow-overlay",
296
+ DIALOG_MOTION,
293
297
  materialClass(material, "surface-solid"),
294
298
  classNames?.root,
295
299
  className,
@@ -18,6 +18,7 @@ import { Check } from "../../icons/index.js";
18
18
  import * as MenuPrimitive from "../../primitives/menu/menu.js";
19
19
  import { cn } from "../../utils/cn.js";
20
20
  import { type Material, materialClass } from "../../utils/material.js";
21
+ import { ITEM_MOTION, POPPER_MOTION } from "../../utils/overlay-motion.js";
21
22
 
22
23
  interface ContextMenuState {
23
24
  open: (x: number, y: number) => void;
@@ -192,6 +193,7 @@ export function ContextMenuContent({
192
193
  }}
193
194
  className={cn(
194
195
  "z-85 max-h-(--ui-popper-available-height) min-w-48 max-w-(--ui-popper-available-width) overflow-y-auto rounded-popover border-card surface-overlay p-1.5 text-ink shadow-overlay",
196
+ POPPER_MOTION,
195
197
  materialClass(material, "surface-solid"),
196
198
  className,
197
199
  )}
@@ -201,8 +203,7 @@ export function ContextMenuContent({
201
203
  );
202
204
  }
203
205
 
204
- const itemBase =
205
- "relative flex min-h-control-sm w-full cursor-pointer select-none items-center gap-density-sm rounded-button px-control-x text-body outline-none data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-surface-2 [&_svg]:size-4 [&_svg]:shrink-0";
206
+ const itemBase = `relative flex min-h-control-sm w-full cursor-pointer select-none items-center gap-density-sm rounded-button px-control-x text-body outline-none data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-surface-2 [&_svg]:size-4 [&_svg]:shrink-0 ${ITEM_MOTION}`;
206
207
 
207
208
  export interface ContextMenuItemProps extends MenuPrimitive.MenuItemProps {
208
209
  /** Destructive action styling. */
@@ -7,6 +7,7 @@ import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
7
7
  import type { ClassNames } from "../../utils/class-names.js";
8
8
  import { cn } from "../../utils/cn.js";
9
9
  import { type Material, materialClass } from "../../utils/material.js";
10
+ import { DIALOG_MOTION, OVERLAY_MOTION } from "../../utils/overlay-motion.js";
10
11
  import {
11
12
  PreviousFocusProvider,
12
13
  restoreFocusOnClose,
@@ -80,11 +81,14 @@ export function DialogContent({
80
81
  const strings = useUiStrings();
81
82
  return (
82
83
  <DialogPrimitive.Portal container={container}>
83
- <DialogPrimitive.Overlay className={cn("fixed inset-0 z-70 bg-scrim", classNames?.overlay)} />
84
+ <DialogPrimitive.Overlay
85
+ className={cn("fixed inset-0 z-70 bg-scrim", OVERLAY_MOTION, classNames?.overlay)}
86
+ />
84
87
  <DialogPrimitive.Content
85
88
  className={cn(
86
89
  "@container/dialog fixed top-[9dvh] left-1/2 z-70 flex max-h-[84dvh] max-w-full -translate-x-1/2 flex-col overflow-auto rounded-dialog outline-none surface-overlay shadow-overlay",
87
90
  widthClasses[width],
91
+ DIALOG_MOTION,
88
92
  materialClass(material, "surface-solid"),
89
93
  classNames?.root,
90
94
  className,
@@ -112,7 +116,8 @@ export function DialogContent({
112
116
  <DialogPrimitive.Close
113
117
  aria-label={closeLabel ?? strings.close}
114
118
  className={cn(
115
- "absolute top-3 right-3 rounded-event p-1 text-ink-3 hover:text-ink in-data-[density=touch]:top-0.5 in-data-[density=touch]:right-0.5 in-data-[density=touch]:p-3.5",
119
+ // A 30px square (44px under touch) centred where the 24px button was, so the glyph stays put.
120
+ "absolute top-[calc(0.5625rem-0.4375rem*var(--touch))] right-[calc(0.5625rem-0.4375rem*var(--touch))] flex size-control-sm items-center justify-center rounded-event text-ink-3 hover:text-ink",
116
121
  classNames?.close,
117
122
  )}
118
123
  >
@@ -1,12 +1,13 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithoutRef } from "react";
3
+ import { type ComponentPropsWithoutRef, type PointerEvent, useRef } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import { X } from "../../icons/index.js";
6
6
  import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
7
7
  import type { ClassNames } from "../../utils/class-names.js";
8
8
  import { cn } from "../../utils/cn.js";
9
9
  import { type Material, materialClass } from "../../utils/material.js";
10
+ import { DRAWER_MOTION, OVERLAY_MOTION, SHEET_MOTION } from "../../utils/overlay-motion.js";
10
11
  import {
11
12
  PreviousFocusProvider,
12
13
  restoreFocusOnClose,
@@ -42,7 +43,22 @@ export function DrawerDescription({
42
43
  return <DialogPrimitive.Description className={cn("m-0 text-ink-2", className)} {...props} />;
43
44
  }
44
45
 
45
- export type DrawerContentPart = "root" | "overlay" | "close";
46
+ export type DrawerContentPart = "root" | "overlay" | "close" | "handle";
47
+
48
+ export type DrawerSide = "right" | "bottom";
49
+
50
+ const SWIPE_CLOSE_PX = 60;
51
+
52
+ const sideClasses: Record<DrawerSide, string> = {
53
+ right: "inset-y-0 right-0 h-full w-[min(430px,100%)] max-w-full",
54
+ bottom:
55
+ "inset-x-0 bottom-0 max-h-[min(85dvh,100%)] w-full rounded-t-card pb-[env(safe-area-inset-bottom)]",
56
+ };
57
+
58
+ /** Classes of the content box for a side; exported for tests and for wrappers that restyle it. */
59
+ export function drawerSideClass(side: DrawerSide): string {
60
+ return sideClasses[side];
61
+ }
46
62
 
47
63
  export interface DrawerContentProps extends DialogPrimitive.DialogContentProps {
48
64
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the content and is merged last. */
@@ -58,15 +74,28 @@ export interface DrawerContentProps extends DialogPrimitive.DialogContentProps {
58
74
  blocking?: boolean;
59
75
  /** Accessible label of the close button. */
60
76
  closeLabel?: string;
77
+ /**
78
+ * Edge the panel is anchored to. `"right"` (default) is a side panel up to 430 px wide;
79
+ * `"bottom"` is a bottom sheet across the width, padded by the safe-area inset and capped at
80
+ * 85dvh with its own scroll. Focus is trapped and Escape closes it on both.
81
+ */
82
+ side?: DrawerSide;
83
+ /**
84
+ * Shows a grab handle at the top of a `side="bottom"` sheet. It is decorative (hidden from
85
+ * assistive tech); dragging it down closes the sheet unless `blocking`. Ignored on other sides.
86
+ */
87
+ handle?: boolean;
61
88
  }
62
89
 
63
- /** Right-anchored side panel for secondary flows. */
90
+ /** Side panel (right) or bottom sheet for secondary flows. */
64
91
  export function DrawerContent({
65
92
  className,
66
93
  classNames,
67
94
  material,
68
95
  blocking = false,
69
96
  closeLabel,
97
+ side = "right",
98
+ handle = false,
70
99
  children,
71
100
  onEscapeKeyDown,
72
101
  onPointerDownOutside,
@@ -76,12 +105,31 @@ export function DrawerContent({
76
105
  }: DrawerContentProps) {
77
106
  const previousFocusRef = usePreviousFocus();
78
107
  const strings = useUiStrings();
108
+ const closeRef = useRef<HTMLButtonElement>(null);
109
+ const swipe = useRef<number | null>(null);
110
+ const bottom = side === "bottom";
111
+ const showHandle = bottom && handle;
112
+ const swipeStart = (event: PointerEvent<HTMLDivElement>) => {
113
+ swipe.current = event.clientY;
114
+ event.currentTarget.setPointerCapture?.(event.pointerId);
115
+ };
116
+ const swipeEnd = (event: PointerEvent<HTMLDivElement>) => {
117
+ const from = swipe.current;
118
+ swipe.current = null;
119
+ if (from !== null && !blocking && event.clientY - from >= SWIPE_CLOSE_PX) {
120
+ closeRef.current?.click();
121
+ }
122
+ };
79
123
  return (
80
124
  <DialogPrimitive.Portal>
81
- <DialogPrimitive.Overlay className={cn("fixed inset-0 z-70 bg-scrim", classNames?.overlay)} />
125
+ <DialogPrimitive.Overlay
126
+ className={cn("fixed inset-0 z-70 bg-scrim", OVERLAY_MOTION, classNames?.overlay)}
127
+ />
82
128
  <DialogPrimitive.Content
83
129
  className={cn(
84
- "@container/drawer fixed inset-y-0 right-0 z-70 flex h-full w-[min(430px,100%)] max-w-full flex-col overflow-y-auto outline-none surface-overlay shadow-overlay",
130
+ "@container/drawer fixed z-70 flex flex-col overflow-y-auto outline-none surface-overlay shadow-overlay",
131
+ sideClasses[side],
132
+ side === "bottom" ? SHEET_MOTION : DRAWER_MOTION,
85
133
  materialClass(material, "surface-solid"),
86
134
  classNames?.root,
87
135
  className,
@@ -104,12 +152,26 @@ export function DrawerContent({
104
152
  }}
105
153
  {...props}
106
154
  >
155
+ {showHandle ? (
156
+ <div
157
+ aria-hidden="true"
158
+ onPointerDown={swipeStart}
159
+ onPointerUp={swipeEnd}
160
+ onPointerCancel={() => {
161
+ swipe.current = null;
162
+ }}
163
+ className={cn("flex shrink-0 touch-none justify-center pt-2 pb-1", classNames?.handle)}
164
+ >
165
+ <span className="h-1 w-9 rounded-pill bg-line-strong" />
166
+ </div>
167
+ ) : null}
107
168
  {children}
108
169
  {!blocking && (
109
170
  <DialogPrimitive.Close
171
+ ref={closeRef}
110
172
  aria-label={closeLabel ?? strings.close}
111
173
  className={cn(
112
- "absolute top-3 right-3 rounded-event p-1 text-ink-3 hover:text-ink in-data-[density=touch]:top-0.5 in-data-[density=touch]:right-0.5 in-data-[density=touch]:p-3.5",
174
+ "absolute top-[calc(0.5625rem-0.4375rem*var(--touch))] right-[calc(0.5625rem-0.4375rem*var(--touch))] flex size-control-sm items-center justify-center rounded-event text-ink-3 hover:text-ink",
113
175
  classNames?.close,
114
176
  )}
115
177
  >
@@ -5,6 +5,7 @@ export {
5
5
  type DrawerContentPart,
6
6
  type DrawerContentProps,
7
7
  DrawerDescription,
8
+ type DrawerSide,
8
9
  DrawerTitle,
9
10
  DrawerTrigger,
10
11
  } from "./drawer.js";
@@ -5,6 +5,7 @@ import { Check, ChevronRight } from "../../icons/index.js";
5
5
  import * as MenuPrimitive from "../../primitives/menu/menu.js";
6
6
  import { cn } from "../../utils/cn.js";
7
7
  import { type Material, materialClass } from "../../utils/material.js";
8
+ import { ITEM_MOTION, POPPER_MOTION } from "../../utils/overlay-motion.js";
8
9
 
9
10
  export const DropdownMenu = MenuPrimitive.Root;
10
11
  export const DropdownMenuTrigger = MenuPrimitive.Trigger;
@@ -27,10 +28,10 @@ export const dropdownMenuSurfaceClasses = "rounded-popover surface-overlay p-1.5
27
28
 
28
29
  /** The default look of a menu item, for your own `DropdownMenuItem asChild` or `MenuPrimitive.Item`. */
29
30
  export const dropdownMenuItemClasses =
30
- "flex w-full cursor-pointer items-center gap-2 rounded-event px-2.5 py-1.75 text-body text-ink outline-none data-highlighted:bg-surface-2";
31
+ "flex min-h-(--touch-target) w-full cursor-pointer items-center gap-2 rounded-event px-2.5 py-1.75 text-body text-ink outline-none data-highlighted:bg-surface-2";
31
32
 
32
- const surface = `${placement} ${dropdownMenuSurfaceClasses}`;
33
- const itemBase = dropdownMenuItemClasses;
33
+ const surface = `${placement} ${POPPER_MOTION} ${dropdownMenuSurfaceClasses}`;
34
+ const itemBase = `${dropdownMenuItemClasses} ${ITEM_MOTION}`;
34
35
 
35
36
  export interface DropdownMenuContentProps extends MenuPrimitive.MenuContentProps {
36
37
  /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
@@ -67,7 +68,7 @@ export function DropdownMenuContent({
67
68
  collisionPadding={collisionPadding}
68
69
  className={
69
70
  bare
70
- ? cn(placement, className)
71
+ ? cn(placement, POPPER_MOTION, className)
71
72
  : cn(surface, materialClass(material, "surface-solid"), className)
72
73
  }
73
74
  {...props}
@@ -17,6 +17,7 @@ import {
17
17
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
18
18
  import { cn } from "../../utils/cn.js";
19
19
  import { type Material, materialClass } from "../../utils/material.js";
20
+ import { POPPER_MOTION } from "../../utils/overlay-motion.js";
20
21
  import { Slot } from "../../utils/slot.js";
21
22
 
22
23
  interface HoverCardContextValue {
@@ -187,6 +188,7 @@ export function HoverCardContent({
187
188
  }}
188
189
  className={cn(
189
190
  "z-85 w-72 max-w-(--ui-popper-available-width) rounded-popover border-card surface-overlay p-card text-body text-ink shadow-overlay",
191
+ POPPER_MOTION,
190
192
  materialClass(material, "surface-solid"),
191
193
  className,
192
194
  )}
@@ -3,6 +3,7 @@
3
3
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
4
4
  import { cn } from "../../utils/cn.js";
5
5
  import { type Material, materialClass } from "../../utils/material.js";
6
+ import { POPPER_MOTION } from "../../utils/overlay-motion.js";
6
7
 
7
8
  export const Popover = PopoverPrimitive.Root;
8
9
  export const PopoverTrigger = PopoverPrimitive.Trigger;
@@ -38,6 +39,7 @@ export function PopoverContent({
38
39
  collisionPadding={collisionPadding}
39
40
  className={cn(
40
41
  "z-85 min-w-[min(14.375rem,var(--ui-popper-available-width))] max-h-(--ui-popper-available-height) max-w-(--ui-popper-available-width) overflow-y-auto rounded-popover surface-overlay p-1.5 text-ink shadow-overlay",
42
+ POPPER_MOTION,
41
43
  materialClass(material, "surface-solid"),
42
44
  className,
43
45
  )}
@@ -2,9 +2,11 @@ export type { ToastTone } from "./toast-store.js";
2
2
  export {
3
3
  type ToastAction,
4
4
  Toaster,
5
+ type ToasterOffset,
5
6
  type ToasterPart,
6
7
  type ToasterPosition,
7
8
  type ToasterProps,
9
+ type ToasterResponsivePosition,
8
10
  type ToastOptions,
9
11
  toast,
10
12
  toastToneClasses,