@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
@@ -1,6 +1,7 @@
1
1
  "use client";
2
2
 
3
3
  import {
4
+ type CSSProperties,
4
5
  type KeyboardEvent,
5
6
  type PointerEvent,
6
7
  useEffect,
@@ -36,12 +37,28 @@ export type ToasterPosition =
36
37
  | "bottom-center"
37
38
  | "bottom-right";
38
39
 
40
+ /**
41
+ * One position, or one per viewport width: `base` always applies, `sm` from 640 px and `lg` from
42
+ * 1024 px of viewport width (a toast is anchored to the viewport, so these are media queries).
43
+ */
44
+ export type ToasterResponsivePosition =
45
+ | ToasterPosition
46
+ | { base: ToasterPosition; sm?: ToasterPosition; lg?: ToasterPosition };
47
+
48
+ /** Distance from the viewport edges: a number is px, a string is any CSS length (`calc(env(safe-area-inset-bottom) + 4rem)`). */
49
+ export type ToasterOffset = number | string | { x?: number | string; y?: number | string };
50
+
39
51
  export type ToasterPart = "root" | "list" | "toast" | "title" | "description" | "action";
40
52
 
41
53
  export interface ToasterProps {
42
54
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
43
55
  classNames?: ClassNames<ToasterPart>;
44
- position?: ToasterPosition;
56
+ position?: ToasterResponsivePosition;
57
+ /**
58
+ * Distance from the edges the region is anchored to. Defaults to 1rem on both axes; `y` is
59
+ * measured from the top or the bottom edge, whichever the position uses.
60
+ */
61
+ offset?: ToasterOffset;
45
62
  /** Default auto dismiss delay in ms; `Infinity` disables it. */
46
63
  duration?: number;
47
64
  /** Toasts shown at once; older ones wait until a newer one leaves. */
@@ -94,14 +111,97 @@ const EXIT_MS = 200;
94
111
  const SWIPE_THRESHOLD = 60;
95
112
 
96
113
  const POSITION: Record<ToasterPosition, string> = {
97
- "top-left": "top-4 left-4 items-start",
98
- "top-center": "top-4 left-1/2 -translate-x-1/2 items-center",
99
- "top-right": "top-4 right-4 items-end",
100
- "bottom-left": "bottom-4 left-4 items-start",
101
- "bottom-center": "bottom-4 left-1/2 -translate-x-1/2 items-center",
102
- "bottom-right": "bottom-4 right-4 items-end",
114
+ "top-left":
115
+ "top-[var(--toast-y,1rem)] bottom-auto left-[var(--toast-x,1rem)] right-auto translate-x-0 items-start",
116
+ "top-center":
117
+ "top-[var(--toast-y,1rem)] bottom-auto left-1/2 right-auto -translate-x-1/2 items-center",
118
+ "top-right":
119
+ "top-[var(--toast-y,1rem)] bottom-auto right-[var(--toast-x,1rem)] left-auto translate-x-0 items-end",
120
+ "bottom-left":
121
+ "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",
122
+ "bottom-center":
123
+ "bottom-[var(--toast-y,calc(var(--app-bottom-bar,0px)_+_1rem))] top-auto left-1/2 right-auto -translate-x-1/2 items-center",
124
+ "bottom-right":
125
+ "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",
103
126
  };
104
127
 
128
+ const POSITION_SM: Record<ToasterPosition, string> = {
129
+ "top-left":
130
+ "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",
131
+ "top-center":
132
+ "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",
133
+ "top-right":
134
+ "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",
135
+ "bottom-left":
136
+ "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",
137
+ "bottom-center":
138
+ "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",
139
+ "bottom-right":
140
+ "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",
141
+ };
142
+
143
+ const POSITION_LG: Record<ToasterPosition, string> = {
144
+ "top-left":
145
+ "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",
146
+ "top-center":
147
+ "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",
148
+ "top-right":
149
+ "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",
150
+ "bottom-left":
151
+ "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",
152
+ "bottom-center":
153
+ "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",
154
+ "bottom-right":
155
+ "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",
156
+ };
157
+
158
+ const LIST_ORDER: Record<ToasterVertical, string> = {
159
+ top: "flex-col-reverse",
160
+ bottom: "flex-col",
161
+ };
162
+
163
+ const LIST_ORDER_SM: Record<ToasterVertical, string> = {
164
+ top: "min-[640px]:flex-col-reverse",
165
+ bottom: "min-[640px]:flex-col",
166
+ };
167
+
168
+ const LIST_ORDER_LG: Record<ToasterVertical, string> = {
169
+ top: "min-[1024px]:flex-col-reverse",
170
+ bottom: "min-[1024px]:flex-col",
171
+ };
172
+ type ToasterVertical = "top" | "bottom";
173
+
174
+ const verticalOf = (position: ToasterPosition): ToasterVertical =>
175
+ position.startsWith("top") ? "top" : "bottom";
176
+
177
+ function sideValue(value: number | string | undefined): string | undefined {
178
+ return typeof value === "number" ? `${value}px` : value;
179
+ }
180
+
181
+ /** Region classes, list direction and offset variables for a position and an offset. */
182
+ export function toasterPlacement(
183
+ position: ToasterResponsivePosition,
184
+ offset?: ToasterOffset,
185
+ ): { region: string; list: string; style: CSSProperties } {
186
+ const base = typeof position === "string" ? position : position.base;
187
+ const sm = typeof position === "string" ? undefined : position.sm;
188
+ const lg = typeof position === "string" ? undefined : position.lg;
189
+ const x = sideValue(typeof offset === "object" ? offset.x : offset);
190
+ const y = sideValue(typeof offset === "object" ? offset.y : offset);
191
+ return {
192
+ region: cn(POSITION[base], sm && POSITION_SM[sm], lg && POSITION_LG[lg]),
193
+ list: cn(
194
+ LIST_ORDER[verticalOf(base)],
195
+ sm && LIST_ORDER_SM[verticalOf(sm)],
196
+ lg && LIST_ORDER_LG[verticalOf(lg)],
197
+ ),
198
+ style: {
199
+ ...(x !== undefined ? { "--toast-x": x } : {}),
200
+ ...(y !== undefined ? { "--toast-y": y } : {}),
201
+ } as CSSProperties,
202
+ };
203
+ }
204
+
105
205
  function documentDir(): "ltr" | "rtl" | undefined {
106
206
  if (typeof document === "undefined") return undefined;
107
207
  const value = document.documentElement.getAttribute("dir");
@@ -252,7 +352,7 @@ function ToastItem({ record, duration, reducedMotion, classNames }: ToastItemPro
252
352
  <button
253
353
  type="button"
254
354
  className={cn(
255
- "h-8 shrink-0 rounded-button px-3 font-bold focus-ring",
355
+ "h-8 shrink-0 rounded-button px-3 font-bold focus-visible:focus-ring",
256
356
  toneActionClasses[tone],
257
357
  classNames?.action,
258
358
  )}
@@ -274,6 +374,7 @@ function ToastItem({ record, duration, reducedMotion, classNames }: ToastItemPro
274
374
  */
275
375
  export function Toaster({
276
376
  position = "bottom-center",
377
+ offset,
277
378
  duration = 6000,
278
379
  visibleToasts = 2,
279
380
  className,
@@ -287,7 +388,7 @@ export function Toaster({
287
388
  const records = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
288
389
  const regionRef = useRef<HTMLElement>(null);
289
390
  const shown = selectVisible(records, visibleToasts);
290
- const fromTop = position.startsWith("top");
391
+ const placement = toasterPlacement(position, offset);
291
392
 
292
393
  useEffect(() => {
293
394
  const onKey = (event: globalThis.KeyboardEvent) => {
@@ -306,20 +407,15 @@ export function Toaster({
306
407
  data-ui-layer-branch=""
307
408
  aria-label={label ?? strings.notifications}
308
409
  tabIndex={-1}
410
+ style={placement.style}
309
411
  className={cn(
310
412
  "pointer-events-none fixed z-[1000] flex outline-none",
311
- POSITION[position],
413
+ placement.region,
312
414
  classNames?.root,
313
415
  className,
314
416
  )}
315
417
  >
316
- <div
317
- className={cn(
318
- "m-0 flex list-none gap-2 p-0",
319
- fromTop ? "flex-col-reverse" : "flex-col",
320
- classNames?.list,
321
- )}
322
- >
418
+ <div className={cn("m-0 flex list-none gap-2 p-0", placement.list, classNames?.list)}>
323
419
  {shown.map((record) => (
324
420
  <ToastItem
325
421
  key={record.id}
@@ -16,6 +16,7 @@ import type { Align, Side } from "../../primitives/popper/geometry.js";
16
16
  import type { ClassNames } from "../../utils/class-names.js";
17
17
  import { cn } from "../../utils/cn.js";
18
18
  import { type Material, materialClass } from "../../utils/material.js";
19
+ import { POPPER_MOTION } from "../../utils/overlay-motion.js";
19
20
  import { Slot } from "../../utils/slot.js";
20
21
  import { useControllableState } from "../../utils/use-controllable-state.js";
21
22
  import { opensOnFocus, opensOnHover } from "./model.js";
@@ -152,6 +153,7 @@ export function Tooltip({
152
153
  onMouseLeave={() => schedule(false, closeDelay)}
153
154
  className={cn(
154
155
  "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",
156
+ POPPER_MOTION,
155
157
  materialClass(material, "surface-solid"),
156
158
  classNames?.content,
157
159
  className,
@@ -66,6 +66,16 @@ export function exitDuration(node: Element): number {
66
66
  return Math.max(animated, transitioned);
67
67
  }
68
68
 
69
+ /** Whether an exit-relevant animation or transition on the node itself is still running. */
70
+ function stillRunning(node: Element): boolean {
71
+ if (typeof node.getAnimations !== "function") return false;
72
+ return node.getAnimations().some((animation) => {
73
+ if (animation.playState !== "running") return false;
74
+ const property = (animation as Animation & { transitionProperty?: string }).transitionProperty;
75
+ return property === undefined || EXIT_PROPERTIES.has(property);
76
+ });
77
+ }
78
+
69
79
  function prefersReducedMotion(): boolean {
70
80
  return typeof window.matchMedia === "function"
71
81
  ? window.matchMedia("(prefers-reduced-motion: reduce)").matches
@@ -95,6 +105,9 @@ export function usePresence(present: boolean, ref: RefObject<HTMLElement | null>
95
105
  if (event.target !== node) return;
96
106
  const property = (event as TransitionEvent).propertyName;
97
107
  if (event.type === "transitionend" && !EXIT_PROPERTIES.has(property)) return;
108
+ // A built-in exit transition and a consumer's own (longer) exit animation can run together:
109
+ // wait for the last one, not the first to end.
110
+ if (stillRunning(node)) return;
98
111
  finish();
99
112
  };
100
113
  node.addEventListener("animationend", onEnd);
@@ -105,6 +105,23 @@ export function useAppShell(): AppShellState | null {
105
105
 
106
106
  export interface AppShellProps extends ComponentPropsWithRef<"div"> {
107
107
  children: ReactNode;
108
+ /**
109
+ * Phone navigation, usually a `BottomNav`. Rendered after the children and fixed to the bottom
110
+ * edge; while the shell is compact it reserves the bar's height and safe-area inset at the
111
+ * bottom and publishes it as the `--app-bottom-bar` CSS variable (on the shell and on the
112
+ * document root), so sticky bars and the `Toaster` stay above it.
113
+ */
114
+ bottomBar?: ReactNode;
115
+ }
116
+
117
+ const BOTTOM_BAR_HEIGHT = "calc(3.5rem + env(safe-area-inset-bottom))";
118
+
119
+ /** Publishes `--app-bottom-bar` on the shell and the document root while the shell is compact. */
120
+ function reserveBottomBar(element: HTMLElement, compact: boolean) {
121
+ for (const target of [element, document.documentElement]) {
122
+ if (compact) target.style.setProperty("--app-bottom-bar", BOTTOM_BAR_HEIGHT);
123
+ else target.style.removeProperty("--app-bottom-bar");
124
+ }
108
125
  }
109
126
 
110
127
  /**
@@ -117,17 +134,52 @@ export interface AppShellProps extends ComponentPropsWithRef<"div"> {
117
134
  * the measure arrives, so nothing above a still-dehydrated Suspense boundary re-renders during
118
135
  * hydration (a provider value that changed there made Next.js client-render those boundaries).
119
136
  */
120
- export function AppShell({ children, className, ref: forwardedRef, ...props }: AppShellProps) {
137
+ export function AppShell({
138
+ children,
139
+ bottomBar,
140
+ className,
141
+ ref: forwardedRef,
142
+ ...props
143
+ }: AppShellProps) {
121
144
  const ref = useRef<HTMLDivElement>(null);
122
145
  const [store] = useState(createAppShellStore);
123
146
  const composedRef = useComposedRefs(ref, forwardedRef);
147
+ const hasBottomBar = bottomBar != null && bottomBar !== false;
124
148
 
125
149
  useEffect(() => (ref.current ? store.observe(ref.current) : undefined), [store]);
126
150
 
151
+ useEffect(() => {
152
+ const element = ref.current;
153
+ if (!hasBottomBar || !element) return;
154
+ const sync = () => reserveBottomBar(element, store.getSnapshot());
155
+ sync();
156
+ const unsubscribe = store.subscribe(sync);
157
+ return () => {
158
+ unsubscribe();
159
+ reserveBottomBar(element, false);
160
+ };
161
+ }, [store, hasBottomBar]);
162
+
127
163
  return (
128
164
  <AppShellContext.Provider value={store}>
129
- <div ref={composedRef} {...props} className={cn("@container/app flex min-w-0", className)}>
165
+ <div
166
+ ref={composedRef}
167
+ {...props}
168
+ className={cn(
169
+ "@container/app flex min-w-0",
170
+ hasBottomBar && "pb-(--app-bottom-bar,0px)",
171
+ className,
172
+ )}
173
+ >
130
174
  {children}
175
+ {hasBottomBar ? (
176
+ <div
177
+ data-app-bottom-bar=""
178
+ className="fixed inset-x-0 bottom-0 z-40 @min-[900px]/app:hidden"
179
+ >
180
+ {bottomBar}
181
+ </div>
182
+ ) : null}
131
183
  </div>
132
184
  </AppShellContext.Provider>
133
185
  );
@@ -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,9 +1,11 @@
1
1
  "use client";
2
2
 
3
- import { type CSSProperties, type ReactNode, useEffect, useRef } from "react";
3
+ import { type CSSProperties, type ReactNode, useEffect, useId, useRef } from "react";
4
+ import { ChevronDown } from "../../icons/index.js";
4
5
  import type { ClassNames } from "../../utils/class-names.js";
5
6
  import { cn } from "../../utils/cn.js";
6
7
  import { type Material, materialClass } from "../../utils/material.js";
8
+ import { useControllableState } from "../../utils/use-controllable-state.js";
7
9
  import { useAppShell, useCompactContainer } from "../app-shell/app-shell.js";
8
10
 
9
11
  export interface SidebarLinkProps {
@@ -35,12 +37,28 @@ export interface SidebarGroup {
35
37
  id: string;
36
38
  label: string;
37
39
  items: SidebarItem[];
40
+ /**
41
+ * Turns the group label into a button that shows or hides the items (`aria-expanded`). Ignored
42
+ * in rail mode, where every item stays visible.
43
+ */
44
+ collapsible?: boolean;
45
+ /**
46
+ * Starts collapsed when `collapsible`. A group that contains the active item starts open
47
+ * regardless, and an uncontrolled group opens when one of its items becomes active later, so
48
+ * the current page is never hidden.
49
+ */
50
+ defaultCollapsed?: boolean;
51
+ /** Controlled collapsed state of a `collapsible` group. */
52
+ collapsed?: boolean;
53
+ onCollapsedChange?: (collapsed: boolean) => void;
38
54
  }
39
55
 
40
56
  export type SidebarPart =
41
57
  | "root"
42
58
  | "group"
43
59
  | "groupLabel"
60
+ | "groupToggle"
61
+ | "groupItems"
44
62
  | "item"
45
63
  | "link"
46
64
  | "label"
@@ -81,6 +99,135 @@ const defaultRenderLink: SidebarRenderLink = ({ children, ...props }) => (
81
99
  <a {...props}>{children}</a>
82
100
  );
83
101
 
102
+ interface SidebarGroupSectionProps {
103
+ group: SidebarGroup;
104
+ rail: boolean;
105
+ renderLink: SidebarRenderLink;
106
+ classNames: ClassNames<SidebarPart> | undefined;
107
+ }
108
+
109
+ /** Whether an uncontrolled group must open: one of its items just became the active page. */
110
+ export function opensOnActivation(
111
+ wasActive: boolean,
112
+ isActive: boolean,
113
+ controlled: boolean,
114
+ ): boolean {
115
+ return isActive && !wasActive && !controlled;
116
+ }
117
+
118
+ function SidebarGroupSection({ group, rail, renderLink, classNames }: SidebarGroupSectionProps) {
119
+ const itemsId = useId();
120
+ const collapsible = group.collapsible === true && !rail;
121
+ const holdsActive = group.items.some((item) => item.active);
122
+ const [collapsedState, setCollapsed] = useControllableState<boolean>({
123
+ prop: group.collapsed,
124
+ defaultProp: (group.defaultCollapsed ?? false) && !holdsActive,
125
+ onChange: group.onCollapsedChange,
126
+ });
127
+ const collapsed = collapsible && collapsedState;
128
+ const wasActive = useRef(holdsActive);
129
+ const uncontrolled = group.collapsed === undefined;
130
+ useEffect(() => {
131
+ if (opensOnActivation(wasActive.current, holdsActive, !uncontrolled)) setCollapsed(false);
132
+ wasActive.current = holdsActive;
133
+ }, [holdsActive, uncontrolled, setCollapsed]);
134
+ return (
135
+ <nav aria-label={group.label} className={cn("flex flex-col gap-px", classNames?.group)}>
136
+ {collapsible ? (
137
+ <button
138
+ type="button"
139
+ aria-expanded={!collapsed}
140
+ aria-controls={itemsId}
141
+ onClick={() => setCollapsed(!collapsed)}
142
+ className={cn(
143
+ "flex w-full items-center gap-1 rounded-control px-2.5 pb-1.5 text-left text-overline text-ink-3 hover:text-ink focus-visible:focus-ring",
144
+ classNames?.groupLabel,
145
+ classNames?.groupToggle,
146
+ )}
147
+ >
148
+ <span className="min-w-0 flex-1 truncate">{group.label}</span>
149
+ <ChevronDown
150
+ aria-hidden="true"
151
+ className={cn("size-3.5 shrink-0 transition-transform", collapsed && "-rotate-90")}
152
+ />
153
+ </button>
154
+ ) : (
155
+ <div
156
+ className={cn(
157
+ "px-2.5 pb-1.5 text-overline text-ink-3",
158
+ rail && "sr-only",
159
+ classNames?.groupLabel,
160
+ )}
161
+ >
162
+ {group.label}
163
+ </div>
164
+ )}
165
+ <div
166
+ id={itemsId}
167
+ hidden={collapsed}
168
+ className={cn("flex flex-col gap-px", classNames?.groupItems)}
169
+ >
170
+ {group.items.map((item) => {
171
+ const badgeTone =
172
+ item.badgeTone === "danger" ? "bg-danger-soft text-danger" : "bg-surface-2 text-ink-2";
173
+ return (
174
+ <div key={item.id} className={classNames?.item}>
175
+ {renderLink({
176
+ href: item.href,
177
+ "aria-current": item.active ? "page" : undefined,
178
+ title: rail ? item.label : undefined,
179
+ className: cn(
180
+ "flex min-h-(--touch-target) items-center gap-2.5 rounded-control px-2.5 py-2 text-control text-ink-2 hover:bg-surface-2 hover:text-ink [&_svg]:size-4.25 [&_svg]:shrink-0",
181
+ rail && "relative justify-center",
182
+ item.active && "bg-accent-soft font-bold text-accent-ink",
183
+ classNames?.link,
184
+ ),
185
+ children: (
186
+ <>
187
+ {item.icon}
188
+ <span className={cn("min-w-0 truncate", rail && "sr-only", classNames?.label)}>
189
+ {item.label}
190
+ </span>
191
+ {item.badge !== undefined && rail ? (
192
+ <>
193
+ <span
194
+ aria-hidden="true"
195
+ className={cn(
196
+ "absolute top-1 right-1 size-2 rounded-full ring-2 ring-surface",
197
+ item.badgeTone === "danger" ? "bg-danger" : "bg-accent",
198
+ classNames?.badge,
199
+ )}
200
+ />
201
+ <span className="sr-only">
202
+ {item.badge}
203
+ {item.badgeLabel ? ` ${item.badgeLabel}` : null}
204
+ </span>
205
+ </>
206
+ ) : item.badge !== undefined ? (
207
+ <span
208
+ className={cn(
209
+ "ml-auto shrink-0 rounded-chip px-1.5 py-0.75 text-count",
210
+ badgeTone,
211
+ classNames?.badge,
212
+ )}
213
+ >
214
+ {item.badge}
215
+ {item.badgeLabel ? (
216
+ <span className="sr-only"> {item.badgeLabel}</span>
217
+ ) : null}
218
+ </span>
219
+ ) : null}
220
+ </>
221
+ ),
222
+ })}
223
+ </div>
224
+ );
225
+ })}
226
+ </div>
227
+ </nav>
228
+ );
229
+ }
230
+
84
231
  /**
85
232
  * Main navigation. Always visible when its app container is wide; an off-canvas drawer under
86
233
  * 900 px of container width, `inert` while closed so it is not reachable by keyboard.
@@ -153,81 +300,13 @@ export function Sidebar({
153
300
  >
154
301
  {header}
155
302
  {groups.map((group) => (
156
- <nav
303
+ <SidebarGroupSection
157
304
  key={group.id}
158
- aria-label={group.label}
159
- className={cn("flex flex-col gap-px", classNames?.group)}
160
- >
161
- <div
162
- className={cn(
163
- "px-2.5 pb-1.5 text-overline text-ink-3",
164
- rail && "sr-only",
165
- classNames?.groupLabel,
166
- )}
167
- >
168
- {group.label}
169
- </div>
170
- {group.items.map((item) => {
171
- const badgeTone =
172
- item.badgeTone === "danger"
173
- ? "bg-danger-soft text-danger"
174
- : "bg-surface-2 text-ink-2";
175
- return (
176
- <div key={item.id} className={classNames?.item}>
177
- {renderLink({
178
- href: item.href,
179
- "aria-current": item.active ? "page" : undefined,
180
- title: rail ? item.label : undefined,
181
- className: cn(
182
- "flex items-center gap-2.5 rounded-control px-2.5 py-2 text-control text-ink-2 hover:bg-surface-2 hover:text-ink [&_svg]:size-4.25 [&_svg]:shrink-0",
183
- rail && "relative justify-center in-data-[density=touch]:min-h-11",
184
- item.active && "bg-accent-soft font-bold text-accent-ink",
185
- classNames?.link,
186
- ),
187
- children: (
188
- <>
189
- {item.icon}
190
- <span
191
- className={cn("min-w-0 truncate", rail && "sr-only", classNames?.label)}
192
- >
193
- {item.label}
194
- </span>
195
- {item.badge !== undefined && rail ? (
196
- <>
197
- <span
198
- aria-hidden="true"
199
- className={cn(
200
- "absolute top-1 right-1 size-2 rounded-full ring-2 ring-surface",
201
- item.badgeTone === "danger" ? "bg-danger" : "bg-accent",
202
- classNames?.badge,
203
- )}
204
- />
205
- <span className="sr-only">
206
- {item.badge}
207
- {item.badgeLabel ? ` ${item.badgeLabel}` : null}
208
- </span>
209
- </>
210
- ) : item.badge !== undefined ? (
211
- <span
212
- className={cn(
213
- "ml-auto shrink-0 rounded-chip px-1.5 py-0.75 text-count",
214
- badgeTone,
215
- classNames?.badge,
216
- )}
217
- >
218
- {item.badge}
219
- {item.badgeLabel ? (
220
- <span className="sr-only"> {item.badgeLabel}</span>
221
- ) : null}
222
- </span>
223
- ) : null}
224
- </>
225
- ),
226
- })}
227
- </div>
228
- );
229
- })}
230
- </nav>
305
+ group={group}
306
+ rail={rail}
307
+ renderLink={renderLink}
308
+ classNames={classNames}
309
+ />
231
310
  ))}
232
311
  {footer ? <div className={cn("mt-auto", classNames?.footer)}>{footer}</div> : null}
233
312
  </aside>
@@ -15,6 +15,7 @@ export type TopbarPart =
15
15
  | "root"
16
16
  | "inner"
17
17
  | "menuButton"
18
+ | "start"
18
19
  | "breadcrumbs"
19
20
  | "crumb"
20
21
  | "separator"
@@ -24,6 +25,8 @@ export type TopbarPart =
24
25
  | "shortcut";
25
26
 
26
27
  export interface TopbarProps {
28
+ /** Slot at the far start, after the menu button and before the breadcrumbs (a logo, a venue switcher). */
29
+ start?: ReactNode;
27
30
  /** Breadcrumb trail in order; the last entry is the current view. Nothing renders when absent or empty. */
28
31
  breadcrumbs?: string[];
29
32
  /** Accessible name of the breadcrumb landmark. */
@@ -57,6 +60,7 @@ export interface TopbarProps {
57
60
  }
58
61
 
59
62
  export function Topbar({
63
+ start,
60
64
  breadcrumbs,
61
65
  breadcrumbsLabel,
62
66
  onOpenMenu,
@@ -124,6 +128,10 @@ export function Topbar({
124
128
  </button>
125
129
  ) : null}
126
130
 
131
+ {start ? (
132
+ <div className={cn("flex shrink-0 items-center", classNames?.start)}>{start}</div>
133
+ ) : null}
134
+
127
135
  {trail.length > 0 ? (
128
136
  <nav
129
137
  aria-label={breadcrumbsLabel}
@@ -395,7 +395,7 @@ export function OperationsBento() {
395
395
  rows={4}
396
396
  index={0}
397
397
  flush
398
- aside={<StatusPill status="success" label="Caja abierta" />}
398
+ aside={<StatusPill status="success" label="Caja abierta" collapseLabel />}
399
399
  >
400
400
  <div className="h-full pl-3">
401
401
  <WeekView
@@ -443,7 +443,7 @@ export function OperationsBento() {
443
443
  </div>
444
444
  <Progress value={barbero.carga} aria-label={`Carga de ${barbero.name}`} />
445
445
  </div>
446
- <StatusPill status={barbero.estado} label={barbero.texto} />
446
+ <StatusPill status={barbero.estado} label={barbero.texto} collapseLabel />
447
447
  </li>
448
448
  ))}
449
449
  </ul>