@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
@@ -5,6 +5,7 @@ import { X } from "../../icons/index.js";
5
5
  import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
6
6
  import { cn } from "../../utils/cn.js";
7
7
  import { materialClass } from "../../utils/material.js";
8
+ import { DIALOG_MOTION, OVERLAY_MOTION } from "../../utils/overlay-motion.js";
8
9
  import {
9
10
  PreviousFocusProvider,
10
11
  restoreFocusOnClose,
@@ -39,13 +40,19 @@ function DialogContent({
39
40
  const previousFocusRef = usePreviousFocus();
40
41
  const strings = useUiStrings();
41
42
  return /* @__PURE__ */ jsxs(DialogPrimitive.Portal, { container, children: [
42
- /* @__PURE__ */ jsx(DialogPrimitive.Overlay, { className: cn("fixed inset-0 z-70 bg-scrim", classNames?.overlay) }),
43
+ /* @__PURE__ */ jsx(
44
+ DialogPrimitive.Overlay,
45
+ {
46
+ className: cn("fixed inset-0 z-70 bg-scrim", OVERLAY_MOTION, classNames?.overlay)
47
+ }
48
+ ),
43
49
  /* @__PURE__ */ jsxs(
44
50
  DialogPrimitive.Content,
45
51
  {
46
52
  className: cn(
47
53
  "@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",
48
54
  widthClasses[width],
55
+ DIALOG_MOTION,
49
56
  materialClass(material, "surface-solid"),
50
57
  classNames?.root,
51
58
  className
@@ -74,7 +81,8 @@ function DialogContent({
74
81
  {
75
82
  "aria-label": closeLabel ?? strings.close,
76
83
  className: cn(
77
- "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",
84
+ // A 30px square (44px under touch) centred where the 24px button was, so the glyph stays put.
85
+ "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",
78
86
  classNames?.close
79
87
  ),
80
88
  children: /* @__PURE__ */ jsx(X, { "aria-hidden": "true", className: "size-4" })
@@ -1,4 +1,4 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import { type ComponentPropsWithoutRef } from "react";
2
2
  import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
3
3
  import type { ClassNames } from "../../utils/class-names.js";
4
4
  import { type Material } from "../../utils/material.js";
@@ -11,7 +11,10 @@ export declare const DrawerTrigger: typeof DialogPrimitive.Trigger;
11
11
  export declare const DrawerClose: typeof DialogPrimitive.Close;
12
12
  export declare function DrawerTitle({ className, ...props }: ComponentPropsWithoutRef<typeof DialogPrimitive.Title>): import("react").JSX.Element;
13
13
  export declare function DrawerDescription({ className, ...props }: ComponentPropsWithoutRef<typeof DialogPrimitive.Description>): import("react").JSX.Element;
14
- export type DrawerContentPart = "root" | "overlay" | "close";
14
+ export type DrawerContentPart = "root" | "overlay" | "close" | "handle";
15
+ export type DrawerSide = "right" | "bottom";
16
+ /** Classes of the content box for a side; exported for tests and for wrappers that restyle it. */
17
+ export declare function drawerSideClass(side: DrawerSide): string;
15
18
  export interface DrawerContentProps extends DialogPrimitive.DialogContentProps {
16
19
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the content and is merged last. */
17
20
  classNames?: ClassNames<DrawerContentPart>;
@@ -26,6 +29,17 @@ export interface DrawerContentProps extends DialogPrimitive.DialogContentProps {
26
29
  blocking?: boolean;
27
30
  /** Accessible label of the close button. */
28
31
  closeLabel?: string;
32
+ /**
33
+ * Edge the panel is anchored to. `"right"` (default) is a side panel up to 430 px wide;
34
+ * `"bottom"` is a bottom sheet across the width, padded by the safe-area inset and capped at
35
+ * 85dvh with its own scroll. Focus is trapped and Escape closes it on both.
36
+ */
37
+ side?: DrawerSide;
38
+ /**
39
+ * Shows a grab handle at the top of a `side="bottom"` sheet. It is decorative (hidden from
40
+ * assistive tech); dragging it down closes the sheet unless `blocking`. Ignored on other sides.
41
+ */
42
+ handle?: boolean;
29
43
  }
30
- /** Right-anchored side panel for secondary flows. */
31
- export declare function DrawerContent({ className, classNames, material, blocking, closeLabel, children, onEscapeKeyDown, onPointerDownOutside, onInteractOutside, onCloseAutoFocus, ...props }: DrawerContentProps): import("react").JSX.Element;
44
+ /** Side panel (right) or bottom sheet for secondary flows. */
45
+ export declare function DrawerContent({ className, classNames, material, blocking, closeLabel, side, handle, children, onEscapeKeyDown, onPointerDownOutside, onInteractOutside, onCloseAutoFocus, ...props }: DrawerContentProps): import("react").JSX.Element;
@@ -1,10 +1,12 @@
1
1
  "use client";
2
2
  import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { useRef } from "react";
3
4
  import { useUiStrings } from "../../i18n/index.js";
4
5
  import { X } from "../../icons/index.js";
5
6
  import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
6
7
  import { cn } from "../../utils/cn.js";
7
8
  import { materialClass } from "../../utils/material.js";
9
+ import { DRAWER_MOTION, OVERLAY_MOTION, SHEET_MOTION } from "../../utils/overlay-motion.js";
8
10
  import {
9
11
  PreviousFocusProvider,
10
12
  restoreFocusOnClose,
@@ -29,12 +31,22 @@ function DrawerDescription({
29
31
  }) {
30
32
  return /* @__PURE__ */ jsx(DialogPrimitive.Description, { className: cn("m-0 text-ink-2", className), ...props });
31
33
  }
34
+ const SWIPE_CLOSE_PX = 60;
35
+ const sideClasses = {
36
+ right: "inset-y-0 right-0 h-full w-[min(430px,100%)] max-w-full",
37
+ bottom: "inset-x-0 bottom-0 max-h-[min(85dvh,100%)] w-full rounded-t-card pb-[env(safe-area-inset-bottom)]"
38
+ };
39
+ function drawerSideClass(side) {
40
+ return sideClasses[side];
41
+ }
32
42
  function DrawerContent({
33
43
  className,
34
44
  classNames,
35
45
  material,
36
46
  blocking = false,
37
47
  closeLabel,
48
+ side = "right",
49
+ handle = false,
38
50
  children,
39
51
  onEscapeKeyDown,
40
52
  onPointerDownOutside,
@@ -44,13 +56,35 @@ function DrawerContent({
44
56
  }) {
45
57
  const previousFocusRef = usePreviousFocus();
46
58
  const strings = useUiStrings();
59
+ const closeRef = useRef(null);
60
+ const swipe = useRef(null);
61
+ const bottom = side === "bottom";
62
+ const showHandle = bottom && handle;
63
+ const swipeStart = (event) => {
64
+ swipe.current = event.clientY;
65
+ event.currentTarget.setPointerCapture?.(event.pointerId);
66
+ };
67
+ const swipeEnd = (event) => {
68
+ const from = swipe.current;
69
+ swipe.current = null;
70
+ if (from !== null && !blocking && event.clientY - from >= SWIPE_CLOSE_PX) {
71
+ closeRef.current?.click();
72
+ }
73
+ };
47
74
  return /* @__PURE__ */ jsxs(DialogPrimitive.Portal, { children: [
48
- /* @__PURE__ */ jsx(DialogPrimitive.Overlay, { className: cn("fixed inset-0 z-70 bg-scrim", classNames?.overlay) }),
75
+ /* @__PURE__ */ jsx(
76
+ DialogPrimitive.Overlay,
77
+ {
78
+ className: cn("fixed inset-0 z-70 bg-scrim", OVERLAY_MOTION, classNames?.overlay)
79
+ }
80
+ ),
49
81
  /* @__PURE__ */ jsxs(
50
82
  DialogPrimitive.Content,
51
83
  {
52
84
  className: cn(
53
- "@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",
85
+ "@container/drawer fixed z-70 flex flex-col overflow-y-auto outline-none surface-overlay shadow-overlay",
86
+ sideClasses[side],
87
+ side === "bottom" ? SHEET_MOTION : DRAWER_MOTION,
54
88
  materialClass(material, "surface-solid"),
55
89
  classNames?.root,
56
90
  className
@@ -73,13 +107,27 @@ function DrawerContent({
73
107
  },
74
108
  ...props,
75
109
  children: [
110
+ showHandle ? /* @__PURE__ */ jsx(
111
+ "div",
112
+ {
113
+ "aria-hidden": "true",
114
+ onPointerDown: swipeStart,
115
+ onPointerUp: swipeEnd,
116
+ onPointerCancel: () => {
117
+ swipe.current = null;
118
+ },
119
+ className: cn("flex shrink-0 touch-none justify-center pt-2 pb-1", classNames?.handle),
120
+ children: /* @__PURE__ */ jsx("span", { className: "h-1 w-9 rounded-pill bg-line-strong" })
121
+ }
122
+ ) : null,
76
123
  children,
77
124
  !blocking && /* @__PURE__ */ jsx(
78
125
  DialogPrimitive.Close,
79
126
  {
127
+ ref: closeRef,
80
128
  "aria-label": closeLabel ?? strings.close,
81
129
  className: cn(
82
- "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",
130
+ "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",
83
131
  classNames?.close
84
132
  ),
85
133
  children: /* @__PURE__ */ jsx(X, { "aria-hidden": "true", className: "size-4" })
@@ -96,5 +144,6 @@ export {
96
144
  DrawerContent,
97
145
  DrawerDescription,
98
146
  DrawerTitle,
99
- DrawerTrigger
147
+ DrawerTrigger,
148
+ drawerSideClass
100
149
  };
@@ -1 +1 @@
1
- export { Drawer, DrawerClose, DrawerContent, type DrawerContentPart, type DrawerContentProps, DrawerDescription, DrawerTitle, DrawerTrigger, } from "./drawer.js";
1
+ export { Drawer, DrawerClose, DrawerContent, type DrawerContentPart, type DrawerContentProps, DrawerDescription, type DrawerSide, DrawerTitle, DrawerTrigger, } from "./drawer.js";
@@ -15,7 +15,7 @@ export declare const DropdownMenuAnchor: typeof MenuPrimitive.Anchor;
15
15
  /** The default look of a menu panel: radius, surface, padding and shadow. */
16
16
  export declare const dropdownMenuSurfaceClasses = "rounded-popover surface-overlay p-1.5 shadow-overlay";
17
17
  /** The default look of a menu item, for your own `DropdownMenuItem asChild` or `MenuPrimitive.Item`. */
18
- export declare const dropdownMenuItemClasses = "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";
18
+ export declare const dropdownMenuItemClasses = "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";
19
19
  export interface DropdownMenuContentProps extends MenuPrimitive.MenuContentProps {
20
20
  /** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
21
21
  container?: HTMLElement | null;
@@ -4,6 +4,7 @@ import { Check, ChevronRight } from "../../icons/index.js";
4
4
  import * as MenuPrimitive from "../../primitives/menu/menu.js";
5
5
  import { cn } from "../../utils/cn.js";
6
6
  import { materialClass } from "../../utils/material.js";
7
+ import { ITEM_MOTION, POPPER_MOTION } from "../../utils/overlay-motion.js";
7
8
  const DropdownMenu = MenuPrimitive.Root;
8
9
  const DropdownMenuTrigger = MenuPrimitive.Trigger;
9
10
  const DropdownMenuRadioGroup = MenuPrimitive.RadioGroup;
@@ -13,9 +14,9 @@ const DropdownMenuArrow = MenuPrimitive.Arrow;
13
14
  const DropdownMenuAnchor = MenuPrimitive.Anchor;
14
15
  const placement = "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";
15
16
  const dropdownMenuSurfaceClasses = "rounded-popover surface-overlay p-1.5 shadow-overlay";
16
- const dropdownMenuItemClasses = "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";
17
- const surface = `${placement} ${dropdownMenuSurfaceClasses}`;
18
- const itemBase = dropdownMenuItemClasses;
17
+ const dropdownMenuItemClasses = "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";
18
+ const surface = `${placement} ${POPPER_MOTION} ${dropdownMenuSurfaceClasses}`;
19
+ const itemBase = `${dropdownMenuItemClasses} ${ITEM_MOTION}`;
19
20
  function DropdownMenuContent({
20
21
  className,
21
22
  sideOffset = 6,
@@ -30,7 +31,7 @@ function DropdownMenuContent({
30
31
  {
31
32
  sideOffset,
32
33
  collisionPadding,
33
- className: bare ? cn(placement, className) : cn(surface, materialClass(material, "surface-solid"), className),
34
+ className: bare ? cn(placement, POPPER_MOTION, className) : cn(surface, materialClass(material, "surface-solid"), className),
34
35
  ...props
35
36
  }
36
37
  ) });
@@ -13,6 +13,7 @@ import {
13
13
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
14
14
  import { cn } from "../../utils/cn.js";
15
15
  import { materialClass } from "../../utils/material.js";
16
+ import { POPPER_MOTION } from "../../utils/overlay-motion.js";
16
17
  import { Slot } from "../../utils/slot.js";
17
18
  const HoverCardContext = createContext(null);
18
19
  function useHoverCard() {
@@ -122,6 +123,7 @@ function HoverCardContent({
122
123
  },
123
124
  className: cn(
124
125
  "z-85 w-72 max-w-(--ui-popper-available-width) rounded-popover border-card surface-overlay p-card text-body text-ink shadow-overlay",
126
+ POPPER_MOTION,
125
127
  materialClass(material, "surface-solid"),
126
128
  className
127
129
  ),
@@ -3,6 +3,7 @@ import { jsx } from "react/jsx-runtime";
3
3
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
4
4
  import { cn } from "../../utils/cn.js";
5
5
  import { materialClass } from "../../utils/material.js";
6
+ import { POPPER_MOTION } from "../../utils/overlay-motion.js";
6
7
  const Popover = PopoverPrimitive.Root;
7
8
  const PopoverTrigger = PopoverPrimitive.Trigger;
8
9
  const PopoverClose = PopoverPrimitive.Close;
@@ -23,6 +24,7 @@ function PopoverContent({
23
24
  collisionPadding,
24
25
  className: cn(
25
26
  "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",
27
+ POPPER_MOTION,
26
28
  materialClass(material, "surface-solid"),
27
29
  className
28
30
  ),
@@ -1,2 +1,2 @@
1
1
  export type { ToastTone } from "./toast-store.js";
2
- export { type ToastAction, Toaster, type ToasterPart, type ToasterPosition, type ToasterProps, type ToastOptions, toast, toastToneClasses, } from "./toaster.js";
2
+ export { type ToastAction, Toaster, type ToasterOffset, type ToasterPart, type ToasterPosition, type ToasterProps, type ToasterResponsivePosition, type ToastOptions, toast, toastToneClasses, } from "./toaster.js";
@@ -1,13 +1,33 @@
1
+ import { type CSSProperties } from "react";
1
2
  import type { ClassNames } from "../../utils/class-names.js";
2
3
  import { type ToastTone } from "./toast-store.js";
3
4
  export type { ToastAction, ToastOptions } from "./toast.js";
4
5
  export { toast } from "./toast.js";
5
6
  export type ToasterPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
7
+ /**
8
+ * One position, or one per viewport width: `base` always applies, `sm` from 640 px and `lg` from
9
+ * 1024 px of viewport width (a toast is anchored to the viewport, so these are media queries).
10
+ */
11
+ export type ToasterResponsivePosition = ToasterPosition | {
12
+ base: ToasterPosition;
13
+ sm?: ToasterPosition;
14
+ lg?: ToasterPosition;
15
+ };
16
+ /** Distance from the viewport edges: a number is px, a string is any CSS length (`calc(env(safe-area-inset-bottom) + 4rem)`). */
17
+ export type ToasterOffset = number | string | {
18
+ x?: number | string;
19
+ y?: number | string;
20
+ };
6
21
  export type ToasterPart = "root" | "list" | "toast" | "title" | "description" | "action";
7
22
  export interface ToasterProps {
8
23
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
9
24
  classNames?: ClassNames<ToasterPart>;
10
- position?: ToasterPosition;
25
+ position?: ToasterResponsivePosition;
26
+ /**
27
+ * Distance from the edges the region is anchored to. Defaults to 1rem on both axes; `y` is
28
+ * measured from the top or the bottom edge, whichever the position uses.
29
+ */
30
+ offset?: ToasterOffset;
11
31
  /** Default auto dismiss delay in ms; `Infinity` disables it. */
12
32
  duration?: number;
13
33
  /** Toasts shown at once; older ones wait until a newer one leaves. */
@@ -25,8 +45,14 @@ export interface ToasterProps {
25
45
  }
26
46
  /** Class map behind each tone. `default` is the inverted neutral toast; the others tint the surface. */
27
47
  export declare const toastToneClasses: Readonly<Record<ToastTone, string>>;
48
+ /** Region classes, list direction and offset variables for a position and an offset. */
49
+ export declare function toasterPlacement(position: ToasterResponsivePosition, offset?: ToasterOffset): {
50
+ region: string;
51
+ list: string;
52
+ style: CSSProperties;
53
+ };
28
54
  /**
29
55
  * Ephemeral, non-critical confirmations. Pass `action: { label, onClick }` to
30
56
  * `toast()` for an undo button. Critical messages belong in a banner instead.
31
57
  */
32
- export declare function Toaster({ position, duration, visibleToasts, className, classNames, label, container, dir, }: ToasterProps): import("react").JSX.Element;
58
+ export declare function Toaster({ position, offset, duration, visibleToasts, className, classNames, label, container, dir, }: ToasterProps): import("react").JSX.Element;
@@ -50,13 +50,64 @@ const toneGlyphColor = {
50
50
  const EXIT_MS = 200;
51
51
  const SWIPE_THRESHOLD = 60;
52
52
  const POSITION = {
53
- "top-left": "top-4 left-4 items-start",
54
- "top-center": "top-4 left-1/2 -translate-x-1/2 items-center",
55
- "top-right": "top-4 right-4 items-end",
56
- "bottom-left": "bottom-4 left-4 items-start",
57
- "bottom-center": "bottom-4 left-1/2 -translate-x-1/2 items-center",
58
- "bottom-right": "bottom-4 right-4 items-end"
53
+ "top-left": "top-[var(--toast-y,1rem)] bottom-auto left-[var(--toast-x,1rem)] right-auto translate-x-0 items-start",
54
+ "top-center": "top-[var(--toast-y,1rem)] bottom-auto left-1/2 right-auto -translate-x-1/2 items-center",
55
+ "top-right": "top-[var(--toast-y,1rem)] bottom-auto right-[var(--toast-x,1rem)] left-auto translate-x-0 items-end",
56
+ "bottom-left": "bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] top-auto left-[var(--toast-x,1rem)] right-auto translate-x-0 items-start",
57
+ "bottom-center": "bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] top-auto left-1/2 right-auto -translate-x-1/2 items-center",
58
+ "bottom-right": "bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] top-auto right-[var(--toast-x,1rem)] left-auto translate-x-0 items-end"
59
59
  };
60
+ const POSITION_SM = {
61
+ "top-left": "min-[640px]:top-[var(--toast-y,1rem)] min-[640px]:bottom-auto min-[640px]:left-[var(--toast-x,1rem)] min-[640px]:right-auto min-[640px]:translate-x-0 min-[640px]:items-start",
62
+ "top-center": "min-[640px]:top-[var(--toast-y,1rem)] min-[640px]:bottom-auto min-[640px]:left-1/2 min-[640px]:right-auto min-[640px]:-translate-x-1/2 min-[640px]:items-center",
63
+ "top-right": "min-[640px]:top-[var(--toast-y,1rem)] min-[640px]:bottom-auto min-[640px]:right-[var(--toast-x,1rem)] min-[640px]:left-auto min-[640px]:translate-x-0 min-[640px]:items-end",
64
+ "bottom-left": "min-[640px]:bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] min-[640px]:top-auto min-[640px]:left-[var(--toast-x,1rem)] min-[640px]:right-auto min-[640px]:translate-x-0 min-[640px]:items-start",
65
+ "bottom-center": "min-[640px]:bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] min-[640px]:top-auto min-[640px]:left-1/2 min-[640px]:right-auto min-[640px]:-translate-x-1/2 min-[640px]:items-center",
66
+ "bottom-right": "min-[640px]:bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] min-[640px]:top-auto min-[640px]:right-[var(--toast-x,1rem)] min-[640px]:left-auto min-[640px]:translate-x-0 min-[640px]:items-end"
67
+ };
68
+ const POSITION_LG = {
69
+ "top-left": "min-[1024px]:top-[var(--toast-y,1rem)] min-[1024px]:bottom-auto min-[1024px]:left-[var(--toast-x,1rem)] min-[1024px]:right-auto min-[1024px]:translate-x-0 min-[1024px]:items-start",
70
+ "top-center": "min-[1024px]:top-[var(--toast-y,1rem)] min-[1024px]:bottom-auto min-[1024px]:left-1/2 min-[1024px]:right-auto min-[1024px]:-translate-x-1/2 min-[1024px]:items-center",
71
+ "top-right": "min-[1024px]:top-[var(--toast-y,1rem)] min-[1024px]:bottom-auto min-[1024px]:right-[var(--toast-x,1rem)] min-[1024px]:left-auto min-[1024px]:translate-x-0 min-[1024px]:items-end",
72
+ "bottom-left": "min-[1024px]:bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] min-[1024px]:top-auto min-[1024px]:left-[var(--toast-x,1rem)] min-[1024px]:right-auto min-[1024px]:translate-x-0 min-[1024px]:items-start",
73
+ "bottom-center": "min-[1024px]:bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] min-[1024px]:top-auto min-[1024px]:left-1/2 min-[1024px]:right-auto min-[1024px]:-translate-x-1/2 min-[1024px]:items-center",
74
+ "bottom-right": "min-[1024px]:bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] min-[1024px]:top-auto min-[1024px]:right-[var(--toast-x,1rem)] min-[1024px]:left-auto min-[1024px]:translate-x-0 min-[1024px]:items-end"
75
+ };
76
+ const LIST_ORDER = {
77
+ top: "flex-col-reverse",
78
+ bottom: "flex-col"
79
+ };
80
+ const LIST_ORDER_SM = {
81
+ top: "min-[640px]:flex-col-reverse",
82
+ bottom: "min-[640px]:flex-col"
83
+ };
84
+ const LIST_ORDER_LG = {
85
+ top: "min-[1024px]:flex-col-reverse",
86
+ bottom: "min-[1024px]:flex-col"
87
+ };
88
+ const verticalOf = (position) => position.startsWith("top") ? "top" : "bottom";
89
+ function sideValue(value) {
90
+ return typeof value === "number" ? `${value}px` : value;
91
+ }
92
+ function toasterPlacement(position, offset) {
93
+ const base = typeof position === "string" ? position : position.base;
94
+ const sm = typeof position === "string" ? void 0 : position.sm;
95
+ const lg = typeof position === "string" ? void 0 : position.lg;
96
+ const x = sideValue(typeof offset === "object" ? offset.x : offset);
97
+ const y = sideValue(typeof offset === "object" ? offset.y : offset);
98
+ return {
99
+ region: cn(POSITION[base], sm && POSITION_SM[sm], lg && POSITION_LG[lg]),
100
+ list: cn(
101
+ LIST_ORDER[verticalOf(base)],
102
+ sm && LIST_ORDER_SM[verticalOf(sm)],
103
+ lg && LIST_ORDER_LG[verticalOf(lg)]
104
+ ),
105
+ style: {
106
+ ...x !== void 0 ? { "--toast-x": x } : {},
107
+ ...y !== void 0 ? { "--toast-y": y } : {}
108
+ }
109
+ };
110
+ }
60
111
  function documentDir() {
61
112
  if (typeof document === "undefined") return void 0;
62
113
  const value = document.documentElement.getAttribute("dir");
@@ -181,7 +232,7 @@ function ToastItem({ record, duration, reducedMotion, classNames }) {
181
232
  {
182
233
  type: "button",
183
234
  className: cn(
184
- "h-8 shrink-0 rounded-button px-3 font-bold focus-ring",
235
+ "h-8 shrink-0 rounded-button px-3 font-bold focus-visible:focus-ring",
185
236
  toneActionClasses[tone],
186
237
  classNames?.action
187
238
  ),
@@ -199,6 +250,7 @@ function ToastItem({ record, duration, reducedMotion, classNames }) {
199
250
  }
200
251
  function Toaster({
201
252
  position = "bottom-center",
253
+ offset,
202
254
  duration = 6e3,
203
255
  visibleToasts = 2,
204
256
  className,
@@ -212,7 +264,7 @@ function Toaster({
212
264
  const records = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
213
265
  const regionRef = useRef(null);
214
266
  const shown = selectVisible(records, visibleToasts);
215
- const fromTop = position.startsWith("top");
267
+ const placement = toasterPlacement(position, offset);
216
268
  useEffect(() => {
217
269
  const onKey = (event) => {
218
270
  if (event.altKey && event.code === "KeyT") regionRef.current?.focus();
@@ -229,37 +281,29 @@ function Toaster({
229
281
  "data-ui-layer-branch": "",
230
282
  "aria-label": label ?? strings.notifications,
231
283
  tabIndex: -1,
284
+ style: placement.style,
232
285
  className: cn(
233
286
  "pointer-events-none fixed z-[1000] flex outline-none",
234
- POSITION[position],
287
+ placement.region,
235
288
  classNames?.root,
236
289
  className
237
290
  ),
238
- children: /* @__PURE__ */ jsx(
239
- "div",
291
+ children: /* @__PURE__ */ jsx("div", { className: cn("m-0 flex list-none gap-2 p-0", placement.list, classNames?.list), children: shown.map((record) => /* @__PURE__ */ jsx(
292
+ ToastItem,
240
293
  {
241
- className: cn(
242
- "m-0 flex list-none gap-2 p-0",
243
- fromTop ? "flex-col-reverse" : "flex-col",
244
- classNames?.list
245
- ),
246
- children: shown.map((record) => /* @__PURE__ */ jsx(
247
- ToastItem,
248
- {
249
- record,
250
- duration,
251
- reducedMotion,
252
- classNames
253
- },
254
- record.id
255
- ))
256
- }
257
- )
294
+ record,
295
+ duration,
296
+ reducedMotion,
297
+ classNames
298
+ },
299
+ record.id
300
+ )) })
258
301
  }
259
302
  ) });
260
303
  }
261
304
  export {
262
305
  Toaster,
263
306
  toast,
264
- toastToneClasses
307
+ toastToneClasses,
308
+ toasterPlacement
265
309
  };
@@ -10,6 +10,7 @@ import { Kbd } from "../../atoms/kbd/kbd.js";
10
10
  import * as PopoverPrimitive from "../../primitives/popover/popover.js";
11
11
  import { cn } from "../../utils/cn.js";
12
12
  import { materialClass } from "../../utils/material.js";
13
+ import { POPPER_MOTION } from "../../utils/overlay-motion.js";
13
14
  import { Slot } from "../../utils/slot.js";
14
15
  import { useControllableState } from "../../utils/use-controllable-state.js";
15
16
  import { opensOnFocus, opensOnHover } from "./model.js";
@@ -99,6 +100,7 @@ function Tooltip({
99
100
  onMouseLeave: () => schedule(false, closeDelay),
100
101
  className: cn(
101
102
  "z-85 flex w-max max-w-[min(16rem,var(--ui-popper-available-width))] items-center gap-2 rounded-popover surface-overlay px-2.5 py-1.5 text-meta text-ink shadow-overlay",
103
+ POPPER_MOTION,
102
104
  materialClass(material, "surface-solid"),
103
105
  classNames?.content,
104
106
  className
@@ -49,6 +49,14 @@ function exitDuration(node) {
49
49
  );
50
50
  return Math.max(animated, transitioned);
51
51
  }
52
+ function stillRunning(node) {
53
+ if (typeof node.getAnimations !== "function") return false;
54
+ return node.getAnimations().some((animation) => {
55
+ if (animation.playState !== "running") return false;
56
+ const property = animation.transitionProperty;
57
+ return property === void 0 || EXIT_PROPERTIES.has(property);
58
+ });
59
+ }
52
60
  function prefersReducedMotion() {
53
61
  return typeof window.matchMedia === "function" ? window.matchMedia("(prefers-reduced-motion: reduce)").matches : false;
54
62
  }
@@ -68,6 +76,7 @@ function usePresence(present, ref) {
68
76
  if (event.target !== node) return;
69
77
  const property = event.propertyName;
70
78
  if (event.type === "transitionend" && !EXIT_PROPERTIES.has(property)) return;
79
+ if (stillRunning(node)) return;
71
80
  finish();
72
81
  };
73
82
  node.addEventListener("animationend", onEnd);
@@ -25,6 +25,13 @@ export declare const AppShellContext: import("react").Context<AppShellStore | nu
25
25
  export declare function useAppShell(): AppShellState | null;
26
26
  export interface AppShellProps extends ComponentPropsWithRef<"div"> {
27
27
  children: ReactNode;
28
+ /**
29
+ * Phone navigation, usually a `BottomNav`. Rendered after the children and fixed to the bottom
30
+ * edge; while the shell is compact it reserves the bar's height and safe-area inset at the
31
+ * bottom and publishes it as the `--app-bottom-bar` CSS variable (on the shell and on the
32
+ * document root), so sticky bars and the `Toaster` stay above it.
33
+ */
34
+ bottomBar?: ReactNode;
28
35
  }
29
36
  /**
30
37
  * Root of the app frame (sidebar + topbar + page). It is the `app` container: the sidebar turns
@@ -36,5 +43,5 @@ export interface AppShellProps extends ComponentPropsWithRef<"div"> {
36
43
  * the measure arrives, so nothing above a still-dehydrated Suspense boundary re-renders during
37
44
  * hydration (a provider value that changed there made Next.js client-render those boundaries).
38
45
  */
39
- export declare function AppShell({ children, className, ref: forwardedRef, ...props }: AppShellProps): import("react").JSX.Element;
46
+ export declare function AppShell({ children, bottomBar, className, ref: forwardedRef, ...props }: AppShellProps): import("react").JSX.Element;
40
47
  export {};
@@ -1,5 +1,5 @@
1
1
  "use client";
2
- import { jsx } from "react/jsx-runtime";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
3
  import {
4
4
  createContext,
5
5
  useContext,
@@ -67,12 +67,59 @@ function useAppShell() {
67
67
  );
68
68
  return useMemo(() => store ? { compact } : null, [store, compact]);
69
69
  }
70
- function AppShell({ children, className, ref: forwardedRef, ...props }) {
70
+ const BOTTOM_BAR_HEIGHT = "calc(3.5rem + env(safe-area-inset-bottom))";
71
+ function reserveBottomBar(element, compact) {
72
+ for (const target of [element, document.documentElement]) {
73
+ if (compact) target.style.setProperty("--app-bottom-bar", BOTTOM_BAR_HEIGHT);
74
+ else target.style.removeProperty("--app-bottom-bar");
75
+ }
76
+ }
77
+ function AppShell({
78
+ children,
79
+ bottomBar,
80
+ className,
81
+ ref: forwardedRef,
82
+ ...props
83
+ }) {
71
84
  const ref = useRef(null);
72
85
  const [store] = useState(createAppShellStore);
73
86
  const composedRef = useComposedRefs(ref, forwardedRef);
87
+ const hasBottomBar = bottomBar != null && bottomBar !== false;
74
88
  useEffect(() => ref.current ? store.observe(ref.current) : void 0, [store]);
75
- return /* @__PURE__ */ jsx(AppShellContext.Provider, { value: store, children: /* @__PURE__ */ jsx("div", { ref: composedRef, ...props, className: cn("@container/app flex min-w-0", className), children }) });
89
+ useEffect(() => {
90
+ const element = ref.current;
91
+ if (!hasBottomBar || !element) return;
92
+ const sync = () => reserveBottomBar(element, store.getSnapshot());
93
+ sync();
94
+ const unsubscribe = store.subscribe(sync);
95
+ return () => {
96
+ unsubscribe();
97
+ reserveBottomBar(element, false);
98
+ };
99
+ }, [store, hasBottomBar]);
100
+ return /* @__PURE__ */ jsx(AppShellContext.Provider, { value: store, children: /* @__PURE__ */ jsxs(
101
+ "div",
102
+ {
103
+ ref: composedRef,
104
+ ...props,
105
+ className: cn(
106
+ "@container/app flex min-w-0",
107
+ hasBottomBar && "pb-(--app-bottom-bar,0px)",
108
+ className
109
+ ),
110
+ children: [
111
+ children,
112
+ hasBottomBar ? /* @__PURE__ */ jsx(
113
+ "div",
114
+ {
115
+ "data-app-bottom-bar": "",
116
+ className: "fixed inset-x-0 bottom-0 z-40 @min-[900px]/app:hidden",
117
+ children: bottomBar
118
+ }
119
+ ) : null
120
+ ]
121
+ }
122
+ ) });
76
123
  }
77
124
  export {
78
125
  APP_SHELL_BREAKPOINT,
@@ -1,3 +1,4 @@
1
1
  export * from "./app-shell/index.js";
2
+ export * from "./bottom-nav/index.js";
2
3
  export * from "./sidebar/index.js";
3
4
  export * from "./topbar/index.js";
@@ -1,3 +1,4 @@
1
1
  export * from "./app-shell/index.js";
2
+ export * from "./bottom-nav/index.js";
2
3
  export * from "./sidebar/index.js";
3
4
  export * from "./topbar/index.js";
@@ -27,8 +27,22 @@ export interface SidebarGroup {
27
27
  id: string;
28
28
  label: string;
29
29
  items: SidebarItem[];
30
+ /**
31
+ * Turns the group label into a button that shows or hides the items (`aria-expanded`). Ignored
32
+ * in rail mode, where every item stays visible.
33
+ */
34
+ collapsible?: boolean;
35
+ /**
36
+ * Starts collapsed when `collapsible`. A group that contains the active item starts open
37
+ * regardless, and an uncontrolled group opens when one of its items becomes active later, so
38
+ * the current page is never hidden.
39
+ */
40
+ defaultCollapsed?: boolean;
41
+ /** Controlled collapsed state of a `collapsible` group. */
42
+ collapsed?: boolean;
43
+ onCollapsedChange?: (collapsed: boolean) => void;
30
44
  }
31
- export type SidebarPart = "root" | "group" | "groupLabel" | "item" | "link" | "label" | "badge" | "footer" | "scrim";
45
+ export type SidebarPart = "root" | "group" | "groupLabel" | "groupToggle" | "groupItems" | "item" | "link" | "label" | "badge" | "footer" | "scrim";
32
46
  export interface SidebarProps {
33
47
  groups: SidebarGroup[];
34
48
  /** Accessible name of the sidebar landmark. */
@@ -57,6 +71,8 @@ export interface SidebarProps {
57
71
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
58
72
  classNames?: ClassNames<SidebarPart>;
59
73
  }
74
+ /** Whether an uncontrolled group must open: one of its items just became the active page. */
75
+ export declare function opensOnActivation(wasActive: boolean, isActive: boolean, controlled: boolean): boolean;
60
76
  /**
61
77
  * Main navigation. Always visible when its app container is wide; an off-canvas drawer under
62
78
  * 900 px of container width, `inert` while closed so it is not reachable by keyboard.