@jcsoftdev/ui 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (392) hide show
  1. package/CHANGELOG.md +361 -0
  2. package/README.md +31 -5
  3. package/bin/ui-theme.mjs +40 -6
  4. package/dist/ai/code-block/code-block.js +1 -1
  5. package/dist/atoms/avatar/avatar.d.ts +6 -1
  6. package/dist/atoms/avatar/avatar.js +3 -2
  7. package/dist/atoms/big-date/big-date.js +2 -2
  8. package/dist/atoms/button/button.d.ts +6 -1
  9. package/dist/atoms/button/button.js +2 -2
  10. package/dist/atoms/chip/chip.d.ts +5 -0
  11. package/dist/atoms/chip/chip.js +3 -3
  12. package/dist/atoms/icon-button/icon-button.js +1 -1
  13. package/dist/atoms/internal/hit-area.d.ts +5 -4
  14. package/dist/atoms/internal/hit-area.js +1 -1
  15. package/dist/atoms/progress/index.d.ts +1 -1
  16. package/dist/atoms/progress/index.js +4 -1
  17. package/dist/atoms/progress/progress.d.ts +6 -1
  18. package/dist/atoms/progress/progress.js +19 -1
  19. package/dist/atoms/radio-group/radio-group.js +1 -1
  20. package/dist/atoms/status-pill/status-pill.d.ts +16 -5
  21. package/dist/atoms/status-pill/status-pill.js +43 -18
  22. package/dist/brand/logo-forge.js +1 -1
  23. package/dist/charts/candlestick-chart/candlestick-chart.js +2 -2
  24. package/dist/charts/chart-grid/chart-grid.js +2 -2
  25. package/dist/charts/chord-chart/chord-chart.js +1 -1
  26. package/dist/charts/core/axes.js +2 -2
  27. package/dist/charts/core/cartesian/annotations.js +2 -2
  28. package/dist/charts/core/cartesian/marks.js +1 -1
  29. package/dist/charts/core/distribution/marks.js +1 -1
  30. package/dist/charts/core/distribution/xy-points.js +1 -1
  31. package/dist/charts/core/export-menu.js +1 -1
  32. package/dist/charts/funnel-chart/funnel-chart.js +1 -1
  33. package/dist/charts/gantt-chart/gantt-chart.js +4 -4
  34. package/dist/charts/gantt-chart/gantt-marks.js +3 -3
  35. package/dist/charts/index.d.ts +2 -0
  36. package/dist/charts/index.js +2 -0
  37. package/dist/charts/maps/geo/map-data-table.js +1 -1
  38. package/dist/charts/polar-area-chart/polar-area-chart.js +1 -1
  39. package/dist/charts/radar-chart/radar-chart.js +1 -1
  40. package/dist/charts/stock-chart/stock-chart.js +1 -1
  41. package/dist/charts/stock-chart/stock-drawing-layer.js +3 -3
  42. package/dist/charts/stock-chart/stock-plot.js +2 -2
  43. package/dist/containers/chat-thread/chat-thread.d.ts +98 -0
  44. package/dist/containers/chat-thread/chat-thread.js +219 -0
  45. package/dist/containers/chat-thread/format.d.ts +20 -0
  46. package/dist/containers/chat-thread/format.js +50 -0
  47. package/dist/containers/chat-thread/index.d.ts +1 -0
  48. package/dist/containers/chat-thread/index.js +8 -0
  49. package/dist/containers/cols/cols.d.ts +1 -1
  50. package/dist/containers/cols/cols.js +7 -0
  51. package/dist/containers/comment/comment.js +1 -1
  52. package/dist/containers/context-rail/context-rail.d.ts +62 -0
  53. package/dist/containers/context-rail/context-rail.js +175 -0
  54. package/dist/containers/context-rail/index.d.ts +1 -0
  55. package/dist/containers/context-rail/index.js +6 -0
  56. package/dist/containers/dashboard/dashboard.d.ts +40 -0
  57. package/dist/containers/dashboard/dashboard.js +84 -0
  58. package/dist/containers/dashboard/index.d.ts +1 -0
  59. package/dist/containers/dashboard/index.js +14 -0
  60. package/dist/containers/data-grid/data-grid.demos.js +4 -4
  61. package/dist/containers/data-grid/data-grid.js +6 -6
  62. package/dist/containers/data-grid/filter-builder-editor.js +2 -2
  63. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  64. package/dist/containers/data-grid/spreadsheet.demos.d.ts +1 -1
  65. package/dist/containers/data-grid/spreadsheet.demos.js +1 -1
  66. package/dist/containers/detail-header/detail-header.d.ts +24 -0
  67. package/dist/containers/detail-header/detail-header.js +32 -0
  68. package/dist/containers/detail-header/index.d.ts +1 -0
  69. package/dist/containers/detail-header/index.js +6 -0
  70. package/dist/containers/facts/facts.js +1 -1
  71. package/dist/containers/filter-bar/filter-bar.d.ts +58 -0
  72. package/dist/containers/filter-bar/filter-bar.js +123 -0
  73. package/dist/containers/filter-bar/index.d.ts +1 -0
  74. package/dist/containers/filter-bar/index.js +6 -0
  75. package/dist/containers/hbars/hbars.js +2 -2
  76. package/dist/containers/index.d.ts +9 -0
  77. package/dist/containers/index.js +9 -0
  78. package/dist/containers/kanban/kanban.d.ts +23 -2
  79. package/dist/containers/kanban/kanban.js +103 -21
  80. package/dist/containers/kanban/model.d.ts +12 -0
  81. package/dist/containers/kanban/model.js +8 -0
  82. package/dist/containers/kpi/kpi.js +1 -1
  83. package/dist/containers/kpi-group/kpi-group.d.ts +6 -1
  84. package/dist/containers/kpi-group/kpi-group.js +6 -2
  85. package/dist/containers/list-detail/index.d.ts +1 -1
  86. package/dist/containers/list-detail/index.js +4 -0
  87. package/dist/containers/list-detail/list-detail.d.ts +51 -3
  88. package/dist/containers/list-detail/list-detail.js +111 -15
  89. package/dist/containers/page/page.d.ts +17 -4
  90. package/dist/containers/page/page.js +33 -4
  91. package/dist/containers/page-header/back.d.ts +10 -0
  92. package/dist/containers/page-header/back.js +28 -0
  93. package/dist/containers/page-header/index.d.ts +1 -0
  94. package/dist/containers/page-header/index.js +1 -0
  95. package/dist/containers/page-header/page-header.d.ts +19 -2
  96. package/dist/containers/page-header/page-header.js +26 -2
  97. package/dist/containers/pagination/cursor-pagination.d.ts +28 -0
  98. package/dist/containers/pagination/cursor-pagination.js +48 -0
  99. package/dist/containers/pagination/index.d.ts +3 -0
  100. package/dist/containers/pagination/index.js +10 -0
  101. package/dist/containers/pagination/pagination.d.ts +52 -0
  102. package/dist/containers/pagination/pagination.js +216 -0
  103. package/dist/containers/pagination/range.d.ts +29 -0
  104. package/dist/containers/pagination/range.js +42 -0
  105. package/dist/containers/pagination/use-pagination.d.ts +18 -0
  106. package/dist/containers/pagination/use-pagination.js +22 -0
  107. package/dist/containers/responsive-list/responsive-list.d.ts +29 -3
  108. package/dist/containers/responsive-list/responsive-list.js +202 -82
  109. package/dist/containers/row-actions/index.d.ts +1 -0
  110. package/dist/containers/row-actions/index.js +4 -0
  111. package/dist/containers/row-actions/row-actions.d.ts +26 -0
  112. package/dist/containers/row-actions/row-actions.js +78 -0
  113. package/dist/containers/selectable-card/index.d.ts +1 -0
  114. package/dist/containers/selectable-card/index.js +6 -0
  115. package/dist/containers/selectable-card/selectable-card.d.ts +26 -0
  116. package/dist/containers/selectable-card/selectable-card.js +57 -0
  117. package/dist/containers/settings-layout/settings-layout.d.ts +24 -7
  118. package/dist/containers/settings-layout/settings-layout.js +63 -8
  119. package/dist/containers/shortcuts/shortcuts.js +1 -1
  120. package/dist/containers/table/cell-padding.d.ts +2 -0
  121. package/dist/containers/table/cell-padding.js +4 -0
  122. package/dist/containers/table/index.d.ts +1 -0
  123. package/dist/containers/table/index.js +8 -0
  124. package/dist/containers/table/sort.d.ts +14 -0
  125. package/dist/containers/table/sort.js +11 -0
  126. package/dist/containers/table/table-parts.d.ts +24 -0
  127. package/dist/containers/table/table-parts.js +52 -0
  128. package/dist/containers/table/table.d.ts +37 -3
  129. package/dist/containers/table/table.js +120 -19
  130. package/dist/containers/table-columns-menu/index.d.ts +1 -0
  131. package/dist/containers/table-columns-menu/index.js +6 -0
  132. package/dist/containers/table-columns-menu/table-columns-menu.d.ts +14 -0
  133. package/dist/containers/table-columns-menu/table-columns-menu.js +46 -0
  134. package/dist/dashboards/layout.d.ts +1 -27
  135. package/dist/dashboards/layout.js +8 -40
  136. package/dist/forms/chip-group/chip-group.d.ts +5 -0
  137. package/dist/forms/chip-group/chip-group.js +3 -1
  138. package/dist/forms/combobox/combobox.js +1 -1
  139. package/dist/forms/copy-field/copy-field.js +1 -1
  140. package/dist/forms/date-picker/date-picker.d.ts +3 -1
  141. package/dist/forms/date-picker/date-picker.js +4 -2
  142. package/dist/forms/date-picker/date-time-picker.d.ts +8 -2
  143. package/dist/forms/date-picker/date-time-picker.js +13 -2
  144. package/dist/forms/field/field.d.ts +9 -2
  145. package/dist/forms/field/field.js +18 -4
  146. package/dist/forms/fieldset/fieldset.d.ts +11 -0
  147. package/dist/forms/fieldset/fieldset.js +12 -0
  148. package/dist/forms/fieldset/index.d.ts +1 -0
  149. package/dist/forms/fieldset/index.js +4 -0
  150. package/dist/forms/form-footer/form-footer.d.ts +26 -0
  151. package/dist/forms/form-footer/form-footer.js +44 -0
  152. package/dist/forms/form-footer/index.d.ts +1 -0
  153. package/dist/forms/form-footer/index.js +4 -0
  154. package/dist/forms/form-grid/form-grid.d.ts +21 -4
  155. package/dist/forms/form-grid/form-grid.js +20 -3
  156. package/dist/forms/form-grid/index.d.ts +1 -1
  157. package/dist/forms/form-grid/index.js +6 -2
  158. package/dist/forms/form-section/form-section.d.ts +12 -0
  159. package/dist/forms/form-section/form-section.js +30 -0
  160. package/dist/forms/form-section/index.d.ts +1 -0
  161. package/dist/forms/form-section/index.js +4 -0
  162. package/dist/forms/index.d.ts +3 -0
  163. package/dist/forms/index.js +3 -0
  164. package/dist/forms/input/input.d.ts +6 -2
  165. package/dist/forms/input/input.js +4 -1
  166. package/dist/forms/internal/listbox-items.d.ts +1 -1
  167. package/dist/forms/internal/listbox-items.js +3 -2
  168. package/dist/forms/native-select/native-select.js +1 -1
  169. package/dist/forms/number-stepper/index.d.ts +1 -1
  170. package/dist/forms/number-stepper/number-stepper.d.ts +7 -0
  171. package/dist/forms/number-stepper/number-stepper.js +37 -6
  172. package/dist/forms/select/index.d.ts +1 -1
  173. package/dist/forms/select/select.d.ts +5 -2
  174. package/dist/forms/select/select.js +7 -2
  175. package/dist/forms/select-menu/select-menu.js +1 -1
  176. package/dist/forms/time-input/time-input.d.ts +4 -2
  177. package/dist/forms/time-input/time-input.js +3 -1
  178. package/dist/i18n/strings.d.ts +94 -0
  179. package/dist/i18n/strings.js +50 -0
  180. package/dist/motion/count-up.d.ts +20 -0
  181. package/dist/motion/count-up.js +59 -0
  182. package/dist/motion/cross-fade.d.ts +21 -0
  183. package/dist/motion/cross-fade.js +86 -0
  184. package/dist/motion/index.d.ts +5 -0
  185. package/dist/motion/index.js +14 -0
  186. package/dist/motion/model.d.ts +15 -0
  187. package/dist/motion/model.js +68 -0
  188. package/dist/motion/motion-styles.d.ts +1 -0
  189. package/dist/motion/motion-styles.js +35 -0
  190. package/dist/motion/reveal.d.ts +37 -0
  191. package/dist/motion/reveal.js +69 -0
  192. package/dist/motion/use-enter-phase.d.ts +11 -0
  193. package/dist/motion/use-enter-phase.js +40 -0
  194. package/dist/motion/use-highlight-row.d.ts +22 -0
  195. package/dist/motion/use-highlight-row.js +38 -0
  196. package/dist/navigation/tabs/tabs.js +1 -1
  197. package/dist/navigation/wizard/wizard.d.ts +4 -1
  198. package/dist/navigation/wizard/wizard.js +3 -0
  199. package/dist/overlays/alert-dialog/alert-dialog.js +8 -1
  200. package/dist/overlays/context-menu/context-menu.js +3 -1
  201. package/dist/overlays/dialog/dialog.d.ts +1 -0
  202. package/dist/overlays/dialog/dialog.js +11 -3
  203. package/dist/overlays/drawer/drawer.d.ts +18 -4
  204. package/dist/overlays/drawer/drawer.js +53 -4
  205. package/dist/overlays/drawer/index.d.ts +1 -1
  206. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +1 -1
  207. package/dist/overlays/dropdown-menu/dropdown-menu.js +5 -4
  208. package/dist/overlays/hover-card/hover-card.js +2 -0
  209. package/dist/overlays/popover/popover.js +2 -0
  210. package/dist/overlays/toaster/index.d.ts +1 -1
  211. package/dist/overlays/toaster/toast-store.d.ts +2 -0
  212. package/dist/overlays/toaster/toast-store.js +6 -1
  213. package/dist/overlays/toaster/toaster.d.ts +28 -2
  214. package/dist/overlays/toaster/toaster.js +86 -29
  215. package/dist/overlays/tooltip/tooltip.js +2 -0
  216. package/dist/primitives/use-presence.js +9 -0
  217. package/dist/shell/app-shell/app-shell.d.ts +8 -1
  218. package/dist/shell/app-shell/app-shell.js +50 -3
  219. package/dist/shell/index.d.ts +1 -0
  220. package/dist/shell/index.js +1 -0
  221. package/dist/shell/sidebar/sidebar.d.ts +17 -1
  222. package/dist/shell/sidebar/sidebar.js +126 -76
  223. package/dist/shell/topbar/topbar.d.ts +4 -2
  224. package/dist/shell/topbar/topbar.js +2 -0
  225. package/dist/showcase/operations-bento.js +2 -2
  226. package/dist/states/empty-state/empty-state.d.ts +10 -3
  227. package/dist/states/empty-state/empty-state.js +46 -5
  228. package/dist/states/error-state/error-state.js +1 -1
  229. package/dist/states/skeleton/skeleton.d.ts +16 -1
  230. package/dist/states/skeleton/skeleton.js +13 -5
  231. package/dist/utils/class-tokens.generated.js +4 -6
  232. package/dist/utils/focus-chain.d.ts +11 -0
  233. package/dist/utils/focus-chain.js +39 -0
  234. package/dist/utils/focus-rescue.d.ts +13 -0
  235. package/dist/utils/focus-rescue.js +48 -0
  236. package/dist/utils/list-navigation.d.ts +14 -0
  237. package/dist/utils/list-navigation.js +44 -0
  238. package/dist/utils/overlay-motion.d.ts +12 -0
  239. package/dist/utils/overlay-motion.js +14 -0
  240. package/dist/utils/use-container-width.d.ts +6 -0
  241. package/dist/utils/use-container-width.js +19 -0
  242. package/package.json +2 -2
  243. package/scripts/build-theme.mjs +46 -5
  244. package/src/ai/code-block/code-block.tsx +1 -1
  245. package/src/atoms/avatar/avatar.tsx +8 -2
  246. package/src/atoms/big-date/big-date.tsx +2 -2
  247. package/src/atoms/button/button.tsx +8 -3
  248. package/src/atoms/chip/chip.tsx +8 -3
  249. package/src/atoms/icon-button/icon-button.tsx +1 -1
  250. package/src/atoms/internal/hit-area.ts +5 -4
  251. package/src/atoms/progress/index.ts +8 -1
  252. package/src/atoms/progress/progress.tsx +30 -1
  253. package/src/atoms/radio-group/radio-group.tsx +1 -1
  254. package/src/atoms/status-pill/status-pill.tsx +59 -18
  255. package/src/brand/logo-forge.tsx +1 -1
  256. package/src/charts/candlestick-chart/candlestick-chart.tsx +2 -2
  257. package/src/charts/chart-grid/chart-grid.tsx +2 -2
  258. package/src/charts/chord-chart/chord-chart.tsx +1 -1
  259. package/src/charts/core/axes.tsx +2 -2
  260. package/src/charts/core/cartesian/annotations.tsx +2 -2
  261. package/src/charts/core/cartesian/marks.tsx +1 -1
  262. package/src/charts/core/distribution/marks.tsx +1 -1
  263. package/src/charts/core/distribution/xy-points.tsx +1 -1
  264. package/src/charts/core/export-menu.tsx +1 -1
  265. package/src/charts/funnel-chart/funnel-chart.tsx +1 -1
  266. package/src/charts/gantt-chart/gantt-chart.tsx +4 -4
  267. package/src/charts/gantt-chart/gantt-marks.tsx +3 -3
  268. package/src/charts/index.ts +2 -0
  269. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  270. package/src/charts/polar-area-chart/polar-area-chart.tsx +1 -1
  271. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  272. package/src/charts/stock-chart/stock-chart.tsx +1 -1
  273. package/src/charts/stock-chart/stock-drawing-layer.tsx +3 -3
  274. package/src/charts/stock-chart/stock-plot.tsx +2 -2
  275. package/src/containers/chat-thread/chat-thread.tsx +331 -0
  276. package/src/containers/chat-thread/format.ts +67 -0
  277. package/src/containers/chat-thread/index.ts +12 -0
  278. package/src/containers/cols/cols.tsx +13 -1
  279. package/src/containers/comment/comment.tsx +1 -1
  280. package/src/containers/context-rail/context-rail.tsx +229 -0
  281. package/src/containers/context-rail/index.ts +7 -0
  282. package/src/containers/dashboard/dashboard.tsx +142 -0
  283. package/src/containers/dashboard/index.ts +12 -0
  284. package/src/containers/data-grid/data-grid.demos.tsx +4 -4
  285. package/src/containers/data-grid/data-grid.tsx +6 -6
  286. package/src/containers/data-grid/filter-builder-editor.tsx +2 -2
  287. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  288. package/src/containers/data-grid/spreadsheet.demos.tsx +1 -1
  289. package/src/containers/detail-header/detail-header.tsx +64 -0
  290. package/src/containers/detail-header/index.ts +5 -0
  291. package/src/containers/facts/facts.tsx +1 -1
  292. package/src/containers/filter-bar/filter-bar.tsx +201 -0
  293. package/src/containers/filter-bar/index.ts +7 -0
  294. package/src/containers/hbars/hbars.tsx +2 -2
  295. package/src/containers/index.ts +9 -0
  296. package/src/containers/kanban/kanban.tsx +148 -39
  297. package/src/containers/kanban/model.ts +20 -0
  298. package/src/containers/kpi/kpi.tsx +1 -1
  299. package/src/containers/kpi-group/kpi-group.tsx +17 -2
  300. package/src/containers/list-detail/index.ts +5 -0
  301. package/src/containers/list-detail/list-detail.tsx +159 -9
  302. package/src/containers/page/page.tsx +61 -7
  303. package/src/containers/page-header/back.tsx +42 -0
  304. package/src/containers/page-header/index.ts +1 -0
  305. package/src/containers/page-header/page-header.tsx +49 -3
  306. package/src/containers/pagination/cursor-pagination.tsx +79 -0
  307. package/src/containers/pagination/index.ts +7 -0
  308. package/src/containers/pagination/pagination.tsx +266 -0
  309. package/src/containers/pagination/range.ts +68 -0
  310. package/src/containers/pagination/use-pagination.ts +44 -0
  311. package/src/containers/responsive-list/responsive-list.tsx +190 -47
  312. package/src/containers/row-actions/index.ts +1 -0
  313. package/src/containers/row-actions/row-actions.tsx +114 -0
  314. package/src/containers/selectable-card/index.ts +5 -0
  315. package/src/containers/selectable-card/selectable-card.tsx +84 -0
  316. package/src/containers/settings-layout/settings-layout.tsx +104 -13
  317. package/src/containers/shortcuts/shortcuts.tsx +1 -1
  318. package/src/containers/table/cell-padding.ts +2 -0
  319. package/src/containers/table/index.ts +6 -0
  320. package/src/containers/table/sort.ts +23 -0
  321. package/src/containers/table/table-parts.tsx +81 -0
  322. package/src/containers/table/table.tsx +212 -45
  323. package/src/containers/table-columns-menu/index.ts +5 -0
  324. package/src/containers/table-columns-menu/table-columns-menu.tsx +68 -0
  325. package/src/dashboards/layout.tsx +8 -75
  326. package/src/forms/chip-group/chip-group.tsx +8 -1
  327. package/src/forms/combobox/combobox.tsx +1 -1
  328. package/src/forms/copy-field/copy-field.tsx +1 -1
  329. package/src/forms/date-picker/date-picker.tsx +7 -2
  330. package/src/forms/date-picker/date-time-picker.tsx +28 -2
  331. package/src/forms/field/field.tsx +30 -3
  332. package/src/forms/fieldset/fieldset.tsx +22 -0
  333. package/src/forms/fieldset/index.ts +1 -0
  334. package/src/forms/form-footer/form-footer.tsx +74 -0
  335. package/src/forms/form-footer/index.ts +1 -0
  336. package/src/forms/form-grid/form-grid.tsx +42 -5
  337. package/src/forms/form-grid/index.ts +8 -1
  338. package/src/forms/form-section/form-section.tsx +41 -0
  339. package/src/forms/form-section/index.ts +1 -0
  340. package/src/forms/index.ts +3 -0
  341. package/src/forms/input/input.tsx +10 -3
  342. package/src/forms/internal/listbox-items.tsx +3 -4
  343. package/src/forms/native-select/native-select.tsx +1 -1
  344. package/src/forms/number-stepper/index.ts +1 -0
  345. package/src/forms/number-stepper/number-stepper.tsx +51 -6
  346. package/src/forms/select/index.ts +1 -1
  347. package/src/forms/select/select.tsx +14 -3
  348. package/src/forms/select-menu/select-menu.tsx +1 -1
  349. package/src/forms/time-input/time-input.tsx +6 -2
  350. package/src/i18n/strings.ts +94 -0
  351. package/src/motion/count-up.tsx +83 -0
  352. package/src/motion/cross-fade.tsx +139 -0
  353. package/src/motion/index.ts +5 -0
  354. package/src/motion/model.ts +86 -0
  355. package/src/motion/motion-styles.tsx +47 -0
  356. package/src/motion/reveal.tsx +115 -0
  357. package/src/motion/use-enter-phase.ts +50 -0
  358. package/src/motion/use-highlight-row.ts +63 -0
  359. package/src/navigation/tabs/tabs.tsx +1 -1
  360. package/src/navigation/wizard/wizard.tsx +6 -1
  361. package/src/overlays/alert-dialog/alert-dialog.tsx +5 -1
  362. package/src/overlays/context-menu/context-menu.tsx +3 -2
  363. package/src/overlays/dialog/dialog.tsx +9 -3
  364. package/src/overlays/drawer/drawer.tsx +68 -6
  365. package/src/overlays/drawer/index.ts +1 -0
  366. package/src/overlays/dropdown-menu/dropdown-menu.tsx +5 -4
  367. package/src/overlays/hover-card/hover-card.tsx +2 -0
  368. package/src/overlays/popover/popover.tsx +2 -0
  369. package/src/overlays/toaster/index.ts +2 -0
  370. package/src/overlays/toaster/toast-store.ts +8 -0
  371. package/src/overlays/toaster/toaster.tsx +127 -17
  372. package/src/overlays/tooltip/tooltip.tsx +2 -0
  373. package/src/primitives/use-presence.ts +13 -0
  374. package/src/shell/app-shell/app-shell.tsx +54 -2
  375. package/src/shell/index.ts +1 -0
  376. package/src/shell/sidebar/sidebar.tsx +154 -75
  377. package/src/shell/topbar/topbar.tsx +8 -0
  378. package/src/showcase/operations-bento.tsx +2 -2
  379. package/src/states/empty-state/empty-state.tsx +52 -9
  380. package/src/states/error-state/error-state.tsx +1 -1
  381. package/src/states/skeleton/skeleton.tsx +33 -5
  382. package/src/utils/class-tokens.generated.ts +4 -6
  383. package/src/utils/focus-chain.ts +53 -0
  384. package/src/utils/focus-rescue.ts +68 -0
  385. package/src/utils/list-navigation.ts +63 -0
  386. package/src/utils/overlay-motion.ts +33 -0
  387. package/src/utils/use-container-width.ts +24 -0
  388. package/styles/Theme.kt +15 -18
  389. package/styles/tailwind.css +29 -28
  390. package/styles/theme.css +29 -28
  391. package/styles/tokens.css +46 -0
  392. package/tokens/default.json +51 -29
@@ -1,9 +1,11 @@
1
1
  "use client";
2
2
 
3
- import type { ReactNode } from "react";
3
+ import { type KeyboardEvent, type MouseEvent, type ReactNode, useRef } from "react";
4
4
  import { useUiStrings } from "../../i18n/index.js";
5
5
  import type { ClassNames } from "../../utils/class-names.js";
6
6
  import { cn } from "../../utils/cn.js";
7
+ import { useFocusRescue } from "../../utils/focus-rescue.js";
8
+ import { focusRowByKey } from "../../utils/list-navigation.js";
7
9
  import {
8
10
  Table,
9
11
  TableBody,
@@ -13,6 +15,36 @@ import {
13
15
  TableRow,
14
16
  } from "../table/table.js";
15
17
 
18
+ /** Container widths (px) from which `layout="auto"` shows the table. The set is closed so every query is a literal class. */
19
+ export type ResponsiveListBreakpoint = 480 | 640 | 672 | 768 | 960 | 1280;
20
+
21
+ const tableClasses: Record<ResponsiveListBreakpoint, { table: string; cards: string }> = {
22
+ 480: {
23
+ table: "hidden @min-[480px]/responsive-list:block",
24
+ cards: "@min-[480px]/responsive-list:hidden",
25
+ },
26
+ 640: {
27
+ table: "hidden @min-[640px]/responsive-list:block",
28
+ cards: "@min-[640px]/responsive-list:hidden",
29
+ },
30
+ 672: {
31
+ table: "hidden @min-[42rem]/responsive-list:block",
32
+ cards: "@min-[42rem]/responsive-list:hidden",
33
+ },
34
+ 768: {
35
+ table: "hidden @min-[768px]/responsive-list:block",
36
+ cards: "@min-[768px]/responsive-list:hidden",
37
+ },
38
+ 960: {
39
+ table: "hidden @min-[960px]/responsive-list:block",
40
+ cards: "@min-[960px]/responsive-list:hidden",
41
+ },
42
+ 1280: {
43
+ table: "hidden @min-[1280px]/responsive-list:block",
44
+ cards: "@min-[1280px]/responsive-list:hidden",
45
+ },
46
+ };
47
+
16
48
  export interface ResponsiveListColumn<T> {
17
49
  key: string;
18
50
  header: string;
@@ -45,12 +77,36 @@ export interface ResponsiveListProps<T> {
45
77
  /** Header of the actions column. Defaults to the localized "Actions". */
46
78
  actionsHeader?: string;
47
79
  rowClassName?: (item: T) => string | undefined;
80
+ /**
81
+ * `"auto"` (default) is a table from `breakpoint` of the list's own container width up and cards
82
+ * below it. `"cards"` always renders the cards, for a list that sits in a narrow pane (a master
83
+ * list next to its detail).
84
+ */
85
+ layout?: "auto" | "cards";
86
+ /** Container width (px) from which `layout="auto"` shows the table. Defaults to 672 (42rem). */
87
+ breakpoint?: ResponsiveListBreakpoint;
88
+ /**
89
+ * `"visible"` (default) shows each field label in the cards. `"hidden"` keeps them for screen
90
+ * readers only, for cards whose values explain themselves (a price, a status).
91
+ */
92
+ cardLabels?: "visible" | "hidden";
93
+ /** Key of the selected row, or `null`/`undefined` for none. Only used together with `onSelect`. */
94
+ selectedKey?: string | null;
95
+ /**
96
+ * Makes rows selectable (click, Enter or Space) and adds keyboard navigation (arrows, Home, End).
97
+ * Without `renderActions` the cards are a `listbox` of `option`s and the table a `grid` whose
98
+ * rows carry `aria-selected`; with it the rows keep plain list/table semantics and the selected
99
+ * one gets `aria-current="true"`, because actions cannot live inside an option.
100
+ */
101
+ onSelect?: (key: string, item: T) => void;
102
+ /** Arrow keys select the row they land on, not only move focus. Off by default. */
103
+ selectOnFocus?: boolean;
48
104
  className?: string;
49
105
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
50
106
  classNames?: ClassNames<ResponsiveListPart>;
51
107
  }
52
108
 
53
- /** A table once its own container is 42rem wide and a stack of cards below that, from one column definition. */
109
+ /** A table from `breakpoint` of its own width up and a stack of cards below it, from one column definition. */
54
110
  export function ResponsiveList<T>({
55
111
  caption,
56
112
  items,
@@ -59,65 +115,141 @@ export function ResponsiveList<T>({
59
115
  renderActions,
60
116
  actionsHeader,
61
117
  rowClassName,
118
+ layout = "auto",
119
+ breakpoint = 672,
120
+ cardLabels = "visible",
121
+ selectedKey,
122
+ onSelect,
123
+ selectOnFocus = false,
62
124
  className,
63
125
  classNames,
64
126
  }: ResponsiveListProps<T>) {
65
127
  const strings = useUiStrings();
128
+ const rootRef = useRef<HTMLDivElement>(null);
129
+ useFocusRescue(rootRef, { item: "[data-row-key]", group: "tbody, ul" });
66
130
  const primary = columns.find((column) => column.primary) ?? columns[0];
67
131
  const details = columns.filter((column) => column !== primary);
132
+ const selectable = onSelect !== undefined;
133
+ const listbox = selectable && !renderActions;
134
+ const firstKey = items[0] ? rowKey(items[0]) : undefined;
135
+ const stopKey =
136
+ selectedKey != null && items.some((item) => rowKey(item) === selectedKey)
137
+ ? selectedKey
138
+ : firstKey;
139
+
140
+ const rowProps = (item: T, kind: "grid" | "card") => {
141
+ if (!selectable) return {};
142
+ const key = rowKey(item);
143
+ const selected = key === selectedKey;
144
+ const select = () => onSelect(key, item);
145
+ return {
146
+ tabIndex: key === stopKey ? 0 : -1,
147
+ "data-selected": selected ? "true" : undefined,
148
+ ...(kind === "grid" || listbox
149
+ ? { "aria-selected": selected }
150
+ : { "aria-current": selected ? ("true" as const) : undefined }),
151
+ ...(kind === "card" && listbox ? { role: "option" as const } : {}),
152
+ onClick: (event: MouseEvent<HTMLElement>) => {
153
+ if (
154
+ (event.target as HTMLElement).closest(
155
+ "a, button, input, select, textarea, [data-row-actions]",
156
+ )
157
+ )
158
+ return;
159
+ select();
160
+ },
161
+ onKeyDown: (event: KeyboardEvent<HTMLElement>) => {
162
+ if (event.target !== event.currentTarget) return;
163
+ if (event.key === "Enter" || event.key === " ") {
164
+ event.preventDefault();
165
+ select();
166
+ return;
167
+ }
168
+ const scope = event.currentTarget.closest("[data-row-scope]");
169
+ if (!scope || event.altKey || event.ctrlKey || event.metaKey) return;
170
+ const row = focusRowByKey(scope, event.currentTarget, event.key);
171
+ if (!row) return;
172
+ event.preventDefault();
173
+ if (selectOnFocus) {
174
+ const nextKey = row.getAttribute("data-row-key");
175
+ const next = items.find((candidate) => rowKey(candidate) === nextKey);
176
+ if (next) onSelect(rowKey(next), next);
177
+ }
178
+ },
179
+ };
180
+ };
68
181
 
69
182
  return (
70
- <div className={cn("@container/responsive-list min-w-0", classNames?.root, className)}>
71
- <div
72
- className={cn(
73
- "hidden rounded-card border-card shadow-card surface-card @min-[42rem]/responsive-list:block",
74
- classNames?.tableWrapper,
75
- )}
76
- >
77
- <Table>
78
- <caption className="sr-only">{caption}</caption>
79
- <TableHead>
80
- <TableRow className="hover:bg-transparent">
81
- {columns.map((column) => (
82
- <TableHeaderCell key={column.key} scope="col" alignRight={column.align === "end"}>
83
- {column.header}
84
- </TableHeaderCell>
85
- ))}
86
- {renderActions ? (
87
- <TableHeaderCell scope="col" alignRight>
88
- {actionsHeader ?? strings.actions}
89
- </TableHeaderCell>
90
- ) : null}
91
- </TableRow>
92
- </TableHead>
93
- <TableBody>
94
- {items.map((item) => (
95
- <TableRow
96
- key={rowKey(item)}
97
- data-row-key={rowKey(item)}
98
- className={rowClassName?.(item)}
99
- >
183
+ <div
184
+ ref={rootRef}
185
+ className={cn("@container/responsive-list min-w-0", classNames?.root, className)}
186
+ >
187
+ {layout === "auto" ? (
188
+ <div
189
+ className={cn(
190
+ "rounded-card border-card shadow-card surface-card",
191
+ tableClasses[breakpoint].table,
192
+ classNames?.tableWrapper,
193
+ )}
194
+ >
195
+ <Table
196
+ {...(selectable ? { role: "grid", "aria-label": caption, "data-row-scope": "" } : {})}
197
+ >
198
+ <caption className="sr-only">{caption}</caption>
199
+ <TableHead>
200
+ <TableRow className="hover:bg-transparent">
100
201
  {columns.map((column) => (
101
- <TableCell key={column.key} alignRight={column.align === "end"}>
102
- {column.cell(item)}
103
- </TableCell>
202
+ <TableHeaderCell key={column.key} scope="col" alignRight={column.align === "end"}>
203
+ {column.header}
204
+ </TableHeaderCell>
104
205
  ))}
105
206
  {renderActions ? (
106
- <TableCell alignRight>
107
- <div className={cn("flex flex-wrap justify-end gap-2", classNames?.actions)}>
108
- {renderActions(item)}
109
- </div>
110
- </TableCell>
207
+ <TableHeaderCell scope="col" alignRight>
208
+ {actionsHeader ?? strings.actions}
209
+ </TableHeaderCell>
111
210
  ) : null}
112
211
  </TableRow>
113
- ))}
114
- </TableBody>
115
- </Table>
116
- </div>
212
+ </TableHead>
213
+ <TableBody>
214
+ {items.map((item) => (
215
+ <TableRow
216
+ key={rowKey(item)}
217
+ data-row-key={rowKey(item)}
218
+ className={cn(
219
+ rowClassName?.(item),
220
+ selectable &&
221
+ "cursor-pointer focus-visible:focus-ring data-[selected=true]:bg-accent-soft",
222
+ )}
223
+ {...rowProps(item, "grid")}
224
+ >
225
+ {columns.map((column) => (
226
+ <TableCell key={column.key} alignRight={column.align === "end"}>
227
+ {column.cell(item)}
228
+ </TableCell>
229
+ ))}
230
+ {renderActions ? (
231
+ <TableCell alignRight>
232
+ <div
233
+ data-row-actions=""
234
+ className={cn("flex flex-wrap justify-end gap-2", classNames?.actions)}
235
+ >
236
+ {renderActions(item)}
237
+ </div>
238
+ </TableCell>
239
+ ) : null}
240
+ </TableRow>
241
+ ))}
242
+ </TableBody>
243
+ </Table>
244
+ </div>
245
+ ) : null}
117
246
  <ul
118
247
  aria-label={caption}
248
+ {...(listbox ? { role: "listbox" } : {})}
249
+ {...(selectable ? { "data-row-scope": "" } : {})}
119
250
  className={cn(
120
- "m-0 flex list-none flex-col gap-density p-0 @min-[42rem]/responsive-list:hidden",
251
+ "m-0 flex list-none flex-col gap-density p-0",
252
+ layout === "auto" && tableClasses[breakpoint].cards,
121
253
  classNames?.cards,
122
254
  )}
123
255
  >
@@ -127,9 +259,12 @@ export function ResponsiveList<T>({
127
259
  data-row-key={rowKey(item)}
128
260
  className={cn(
129
261
  "flex min-w-0 flex-col gap-3 rounded-card border-card p-card shadow-card surface-card",
262
+ selectable &&
263
+ "cursor-pointer focus-visible:focus-ring data-[selected=true]:bg-accent-soft data-[selected=true]:shadow-selected",
130
264
  rowClassName?.(item),
131
265
  classNames?.card,
132
266
  )}
267
+ {...rowProps(item, "card")}
133
268
  >
134
269
  <div
135
270
  className={cn(
@@ -146,15 +281,23 @@ export function ResponsiveList<T>({
146
281
  key={column.key}
147
282
  className={cn(
148
283
  "flex items-baseline justify-between gap-4",
284
+ cardLabels === "hidden" && "justify-start",
149
285
  classNames?.cardDetail,
150
286
  )}
151
287
  >
152
- <dt className={cn("shrink-0 text-ink-3 text-meta", classNames?.cardLabel)}>
288
+ <dt
289
+ className={cn(
290
+ "shrink-0 text-ink-3 text-meta",
291
+ cardLabels === "hidden" && "sr-only",
292
+ classNames?.cardLabel,
293
+ )}
294
+ >
153
295
  {column.header}
154
296
  </dt>
155
297
  <dd
156
298
  className={cn(
157
299
  "m-0 min-w-0 text-right text-body text-ink [overflow-wrap:anywhere]",
300
+ cardLabels === "hidden" && "text-left",
158
301
  classNames?.cardValue,
159
302
  )}
160
303
  >
@@ -165,7 +308,7 @@ export function ResponsiveList<T>({
165
308
  </dl>
166
309
  ) : null}
167
310
  {renderActions ? (
168
- <div className={cn("flex flex-wrap gap-2", classNames?.actions)}>
311
+ <div data-row-actions="" className={cn("flex flex-wrap gap-2", classNames?.actions)}>
169
312
  {renderActions(item)}
170
313
  </div>
171
314
  ) : null}
@@ -0,0 +1 @@
1
+ export { type RowActionItem, RowActions, type RowActionsProps } from "./row-actions.js";
@@ -0,0 +1,114 @@
1
+ "use client";
2
+
3
+ import {
4
+ type ComponentPropsWithoutRef,
5
+ Fragment,
6
+ type KeyboardEvent,
7
+ type MouseEvent,
8
+ type ReactNode,
9
+ } from "react";
10
+ import { IconButton } from "../../atoms/icon-button/icon-button.js";
11
+ import { EllipsisVertical } from "../../icons/index.js";
12
+ import {
13
+ DropdownMenu,
14
+ DropdownMenuContent,
15
+ DropdownMenuItem,
16
+ DropdownMenuSeparator,
17
+ DropdownMenuTrigger,
18
+ } from "../../overlays/dropdown-menu/dropdown-menu.js";
19
+ import { cn } from "../../utils/cn.js";
20
+
21
+ export interface RowActionItem {
22
+ /** Stable key of the item. */
23
+ id: string;
24
+ label: string;
25
+ onSelect: () => void;
26
+ /** Leading decorative icon. */
27
+ icon?: ReactNode;
28
+ /** `danger` items sort to the end of the menu, behind a separator, and read in the danger colour. */
29
+ tone?: "default" | "danger";
30
+ disabled?: boolean;
31
+ }
32
+
33
+ export interface RowActionsProps
34
+ extends Omit<ComponentPropsWithoutRef<"span">, "children" | "onClick" | "onKeyDown"> {
35
+ /** Accessible name of the overflow trigger. Name the row: "Actions for Ana Quispe". */
36
+ label: string;
37
+ /** At most one inline action, typically a `Button size="sm"`: the one thing the row is mostly for. */
38
+ primary?: ReactNode;
39
+ /** The rest, in the overflow menu. No trigger renders when it is empty. */
40
+ items: readonly RowActionItem[];
41
+ }
42
+
43
+ /**
44
+ * A click or a key inside the actions (the menu is portaled, but React events still bubble
45
+ * through the component tree) never reaches the row, so a clickable row does not also activate.
46
+ */
47
+ function contain(event: MouseEvent | KeyboardEvent): void {
48
+ event.stopPropagation();
49
+ }
50
+
51
+ /**
52
+ * One row's actions: at most one inline primary action, the rest in an overflow menu behind a
53
+ * 30px "more" button. It never wraps, so the row keeps its height; destructive items sort last,
54
+ * behind a separator. The menu is a WAI-ARIA menu: arrows, Home/End, typeahead, Escape.
55
+ */
56
+ export function RowActions({ label, primary, items, className, ...props }: RowActionsProps) {
57
+ const regular = items.filter((item) => item.tone !== "danger");
58
+ const destructive = items.filter((item) => item.tone === "danger");
59
+ return (
60
+ // biome-ignore lint/a11y/noStaticElementInteractions: only stops events from bubbling to the row; the controls inside are the interactive parts
61
+ <span
62
+ data-slot="row-actions"
63
+ className={cn(
64
+ "inline-flex flex-nowrap items-center justify-end gap-1.5 whitespace-nowrap",
65
+ className,
66
+ )}
67
+ {...props}
68
+ onClick={contain}
69
+ onKeyDown={contain}
70
+ >
71
+ {primary}
72
+ {items.length > 0 ? (
73
+ <DropdownMenu>
74
+ <DropdownMenuTrigger asChild>
75
+ <IconButton
76
+ size="sm"
77
+ variant="secondary"
78
+ label={label}
79
+ // Reveal: on a pointer that hovers, the glyph is muted until its row is hovered or
80
+ // holds focus; it never hides, so touch and keyboard users always see it.
81
+ className="transition-[scale,color] duration-(--motion-duration) ease-(--motion-ease) motion-reduce:transition-none [@media(hover:hover)]:text-ink-3 [@media(hover:hover)]:group-focus-within/row:text-ink [@media(hover:hover)]:group-hover/row:text-ink data-[state=open]:text-ink"
82
+ >
83
+ <EllipsisVertical aria-hidden="true" />
84
+ </IconButton>
85
+ </DropdownMenuTrigger>
86
+ <DropdownMenuContent align="end">
87
+ {[regular, destructive].map((group, index) =>
88
+ group.length === 0 ? null : (
89
+ <Fragment key={index === 0 ? "regular" : "destructive"}>
90
+ {index === 1 && regular.length > 0 ? <DropdownMenuSeparator /> : null}
91
+ {group.map((item) => (
92
+ <DropdownMenuItem
93
+ key={item.id}
94
+ disabled={item.disabled}
95
+ onSelect={() => item.onSelect()}
96
+ data-tone={item.tone === "danger" ? "danger" : undefined}
97
+ className={cn(
98
+ "[&_svg]:size-4 [&_svg]:shrink-0",
99
+ item.tone === "danger" && "text-danger data-highlighted:bg-danger-soft",
100
+ )}
101
+ >
102
+ {item.icon}
103
+ {item.label}
104
+ </DropdownMenuItem>
105
+ ))}
106
+ </Fragment>
107
+ ),
108
+ )}
109
+ </DropdownMenuContent>
110
+ </DropdownMenu>
111
+ ) : null}
112
+ </span>
113
+ );
114
+ }
@@ -0,0 +1,5 @@
1
+ export {
2
+ SelectableCard,
3
+ type SelectableCardPart,
4
+ type SelectableCardProps,
5
+ } from "./selectable-card.js";
@@ -0,0 +1,84 @@
1
+ "use client";
2
+
3
+ import { type ComponentPropsWithRef, type MouseEvent, type ReactNode, useId } from "react";
4
+ import type { ClassNames } from "../../utils/class-names.js";
5
+ import { cn } from "../../utils/cn.js";
6
+
7
+ export type SelectableCardPart = "root" | "content" | "reason";
8
+
9
+ export interface SelectableCardProps
10
+ extends Omit<ComponentPropsWithRef<"button">, "children" | "role" | "aria-checked"> {
11
+ /** Card content. It sits inside a button, so use phrasing content only (spans, text, icons). */
12
+ children: ReactNode;
13
+ /**
14
+ * Selectable mode. Omitted: the card is a plain button that runs `onClick`. A boolean makes it
15
+ * a toggle (`aria-pressed`), or a radio (`aria-checked`) with `semantics="radio"`.
16
+ */
17
+ selected?: boolean;
18
+ /** `"pressed"` for a toggle (default), `"radio"` when exactly one card of a group is selected; wrap the group in `role="radiogroup"`. */
19
+ semantics?: "pressed" | "radio";
20
+ /** The card stays focusable and ignores clicks (`aria-disabled`), and the reason is read out with it. */
21
+ disabled?: boolean;
22
+ /** Visible text explaining why the card is disabled; announced as its description. */
23
+ disabledReason?: string;
24
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
25
+ classNames?: ClassNames<SelectableCardPart>;
26
+ }
27
+
28
+ /**
29
+ * A card that is itself the interactive element: one `button`, no overlay and no nested
30
+ * controls. Use it as a button (`onClick`) or as a selectable option (`selected`). A disabled card
31
+ * keeps focus so its reason can be reached.
32
+ */
33
+ export function SelectableCard({
34
+ children,
35
+ selected,
36
+ semantics = "pressed",
37
+ disabled = false,
38
+ disabledReason,
39
+ onClick,
40
+ className,
41
+ classNames,
42
+ "aria-describedby": describedBy,
43
+ ...props
44
+ }: SelectableCardProps) {
45
+ const reasonId = useId();
46
+ const showReason = disabled && Boolean(disabledReason);
47
+ const radio = semantics === "radio" && selected !== undefined;
48
+ const handleClick = (event: MouseEvent<HTMLButtonElement>) => {
49
+ if (disabled) {
50
+ event.preventDefault();
51
+ return;
52
+ }
53
+ onClick?.(event);
54
+ };
55
+ return (
56
+ // biome-ignore lint/a11y/useAriaPropsSupportedByRole: aria-checked is only set together with role="radio"
57
+ <button
58
+ type="button"
59
+ {...props}
60
+ role={radio ? "radio" : undefined}
61
+ aria-checked={radio ? selected : undefined}
62
+ aria-pressed={!radio && selected !== undefined ? selected : undefined}
63
+ aria-disabled={disabled || undefined}
64
+ aria-describedby={
65
+ [describedBy, showReason ? reasonId : undefined].filter(Boolean).join(" ") || undefined
66
+ }
67
+ onClick={handleClick}
68
+ className={cn(
69
+ "pressable flex w-full min-w-0 flex-col gap-1 rounded-card border-card p-card text-left shadow-card surface-card focus-visible:focus-ring",
70
+ selected && "border-accent-line bg-accent-soft shadow-selected",
71
+ disabled ? "cursor-not-allowed opacity-60" : "cursor-pointer",
72
+ classNames?.root,
73
+ className,
74
+ )}
75
+ >
76
+ <span className={cn("flex min-w-0 flex-col gap-1", classNames?.content)}>{children}</span>
77
+ {showReason ? (
78
+ <span id={reasonId} className={cn("text-ink-3 text-meta", classNames?.reason)}>
79
+ {disabledReason}
80
+ </span>
81
+ ) : null}
82
+ </button>
83
+ );
84
+ }
@@ -1,39 +1,130 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ "use client";
2
+
3
+ import { type ComponentPropsWithoutRef, createContext, use } from "react";
2
4
  import { cn } from "../../utils/cn.js";
3
5
 
4
- export type SettingsLayoutProps = ComponentPropsWithoutRef<"div">;
6
+ /** Container widths (px) under which the layout stacks. The set is closed so every query is a literal class. */
7
+ export type SettingsLayoutBreakpoint = 720 | 940 | 1080 | 1280;
8
+
9
+ export type SettingsLayoutContainer = "page" | "self";
10
+
11
+ interface SettingsLayoutConfig {
12
+ breakpoint: SettingsLayoutBreakpoint | "never";
13
+ container: SettingsLayoutContainer;
14
+ }
15
+
16
+ const SettingsLayoutContext = createContext<SettingsLayoutConfig>({
17
+ breakpoint: 940,
18
+ container: "page",
19
+ });
20
+
21
+ const stackClasses: Record<
22
+ SettingsLayoutContainer,
23
+ Record<SettingsLayoutBreakpoint, { grid: string; nav: string }>
24
+ > = {
25
+ page: {
26
+ 720: {
27
+ grid: "@max-[720px]/page:grid-cols-1",
28
+ nav: "@max-[720px]/page:static @max-[720px]/page:flex-row @max-[720px]/page:overflow-x-auto",
29
+ },
30
+ 940: {
31
+ grid: "@max-[940px]/page:grid-cols-1",
32
+ nav: "@max-[940px]/page:static @max-[940px]/page:flex-row @max-[940px]/page:overflow-x-auto",
33
+ },
34
+ 1080: {
35
+ grid: "@max-[1080px]/page:grid-cols-1",
36
+ nav: "@max-[1080px]/page:static @max-[1080px]/page:flex-row @max-[1080px]/page:overflow-x-auto",
37
+ },
38
+ 1280: {
39
+ grid: "@max-[1280px]/page:grid-cols-1",
40
+ nav: "@max-[1280px]/page:static @max-[1280px]/page:flex-row @max-[1280px]/page:overflow-x-auto",
41
+ },
42
+ },
43
+ self: {
44
+ 720: {
45
+ grid: "@max-[720px]/settings:grid-cols-1",
46
+ nav: "@max-[720px]/settings:static @max-[720px]/settings:flex-row @max-[720px]/settings:overflow-x-auto",
47
+ },
48
+ 940: {
49
+ grid: "@max-[940px]/settings:grid-cols-1",
50
+ nav: "@max-[940px]/settings:static @max-[940px]/settings:flex-row @max-[940px]/settings:overflow-x-auto",
51
+ },
52
+ 1080: {
53
+ grid: "@max-[1080px]/settings:grid-cols-1",
54
+ nav: "@max-[1080px]/settings:static @max-[1080px]/settings:flex-row @max-[1080px]/settings:overflow-x-auto",
55
+ },
56
+ 1280: {
57
+ grid: "@max-[1280px]/settings:grid-cols-1",
58
+ nav: "@max-[1280px]/settings:static @max-[1280px]/settings:flex-row @max-[1280px]/settings:overflow-x-auto",
59
+ },
60
+ },
61
+ };
62
+
63
+ function stackFor(config: SettingsLayoutConfig, part: "grid" | "nav") {
64
+ return config.breakpoint === "never"
65
+ ? undefined
66
+ : stackClasses[config.container][config.breakpoint][part];
67
+ }
68
+
69
+ export interface SettingsLayoutProps extends ComponentPropsWithoutRef<"div"> {
70
+ /**
71
+ * Container width (px) under which the nav and the content stack. `"never"` keeps two columns.
72
+ * Defaults to 940. `SettingsLayoutNav` follows it without being told.
73
+ */
74
+ breakpoint?: SettingsLayoutBreakpoint | "never";
75
+ /**
76
+ * Which container is measured. `"page"` (default) is the ancestor `@container/page`;
77
+ * `"self"` wraps the layout in its own container, for use outside a page shell.
78
+ */
79
+ container?: SettingsLayoutContainer;
80
+ }
5
81
 
6
82
  /**
7
- * Two-column settings grid (side nav + content). Collapses to one column at
8
- * 940px or less of the ancestor `@container/page`.
83
+ * Two-column settings grid (side nav + content). Stacks to one column under `breakpoint`
84
+ * (940 px by default) of the measured container, never of the viewport.
9
85
  */
10
- export function SettingsLayout({ className, ...props }: SettingsLayoutProps) {
11
- return (
86
+ export function SettingsLayout({
87
+ breakpoint = 940,
88
+ container = "page",
89
+ className,
90
+ ...props
91
+ }: SettingsLayoutProps) {
92
+ const config = { breakpoint, container };
93
+ const grid = (
12
94
  <div
13
95
  className={cn(
14
- "grid grid-cols-[220px_minmax(0,1fr)] items-start gap-6 @max-[940px]/page:grid-cols-1",
96
+ "grid grid-cols-[220px_minmax(0,1fr)] items-start gap-6",
97
+ stackFor(config, "grid"),
15
98
  className,
16
99
  )}
17
100
  {...props}
18
101
  />
19
102
  );
103
+ return (
104
+ <SettingsLayoutContext value={config}>
105
+ {container === "self" ? <div className="@container/settings min-w-0">{grid}</div> : grid}
106
+ </SettingsLayoutContext>
107
+ );
20
108
  }
21
109
 
22
- export type SettingsLayoutNavProps = ComponentPropsWithoutRef<"nav">;
110
+ export interface SettingsLayoutNavProps extends ComponentPropsWithoutRef<"nav"> {
111
+ /** Overrides the breakpoint the surrounding `SettingsLayout` set. */
112
+ breakpoint?: SettingsLayoutBreakpoint | "never";
113
+ }
23
114
 
24
115
  /** Sticky side nav that becomes a scrollable horizontal row on narrow pages. */
25
116
  export function SettingsLayoutNav({
26
117
  "aria-label": ariaLabel = "Sections",
118
+ breakpoint,
27
119
  className,
28
120
  ...props
29
121
  }: SettingsLayoutNavProps) {
122
+ const inherited = use(SettingsLayoutContext);
123
+ const config = { ...inherited, breakpoint: breakpoint ?? inherited.breakpoint };
30
124
  return (
31
125
  <nav
32
126
  aria-label={ariaLabel}
33
- className={cn(
34
- "sticky top-20 flex flex-col gap-px @max-[940px]/page:static @max-[940px]/page:flex-row @max-[940px]/page:overflow-x-auto",
35
- className,
36
- )}
127
+ className={cn("sticky top-20 flex flex-col gap-px", stackFor(config, "nav"), className)}
37
128
  {...props}
38
129
  />
39
130
  );
@@ -55,7 +146,7 @@ export function SettingsLayoutNavItem({
55
146
  type={type}
56
147
  aria-current={active ? "true" : undefined}
57
148
  className={cn(
58
- "flex shrink-0 items-center gap-2.5 rounded-control px-2.5 py-1.75 font-medium text-fs-130 text-ink-2 hover:bg-surface-2 hover:text-ink",
149
+ "flex min-h-(--touch-target) shrink-0 items-center gap-2.5 rounded-control px-2.5 py-1.75 font-medium text-fs-130 text-ink-2 hover:bg-surface-2 hover:text-ink",
59
150
  active && "bg-accent-soft font-semibold text-accent-ink",
60
151
  className,
61
152
  )}