@jcsoftdev/ui 0.5.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 (373) hide show
  1. package/CHANGELOG.md +337 -0
  2. package/README.md +25 -3
  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 +6 -1
  7. package/dist/atoms/button/button.js +2 -2
  8. package/dist/atoms/chip/chip.d.ts +5 -0
  9. package/dist/atoms/chip/chip.js +3 -3
  10. package/dist/atoms/icon-button/icon-button.js +1 -1
  11. package/dist/atoms/internal/hit-area.d.ts +5 -4
  12. package/dist/atoms/internal/hit-area.js +1 -1
  13. package/dist/atoms/progress/index.d.ts +1 -1
  14. package/dist/atoms/progress/index.js +4 -1
  15. package/dist/atoms/progress/progress.d.ts +6 -1
  16. package/dist/atoms/progress/progress.js +19 -1
  17. package/dist/atoms/radio-group/radio-group.js +1 -1
  18. package/dist/atoms/status-pill/status-pill.d.ts +16 -5
  19. package/dist/atoms/status-pill/status-pill.js +43 -18
  20. package/dist/brand/logo-forge.js +1 -1
  21. package/dist/charts/candlestick-chart/candlestick-chart.js +2 -2
  22. package/dist/charts/chart-grid/chart-grid.js +2 -2
  23. package/dist/charts/chord-chart/chord-chart.js +1 -1
  24. package/dist/charts/core/axes.js +2 -2
  25. package/dist/charts/core/cartesian/annotations.js +2 -2
  26. package/dist/charts/core/cartesian/marks.js +1 -1
  27. package/dist/charts/core/distribution/marks.js +1 -1
  28. package/dist/charts/core/distribution/xy-points.js +1 -1
  29. package/dist/charts/core/export-menu.js +1 -1
  30. package/dist/charts/funnel-chart/funnel-chart.js +1 -1
  31. package/dist/charts/gantt-chart/gantt-chart.js +4 -4
  32. package/dist/charts/gantt-chart/gantt-marks.js +3 -3
  33. package/dist/charts/index.d.ts +2 -0
  34. package/dist/charts/index.js +2 -0
  35. package/dist/charts/maps/geo/map-data-table.js +1 -1
  36. package/dist/charts/polar-area-chart/polar-area-chart.js +1 -1
  37. package/dist/charts/radar-chart/radar-chart.js +1 -1
  38. package/dist/charts/stock-chart/stock-chart.js +1 -1
  39. package/dist/charts/stock-chart/stock-drawing-layer.js +3 -3
  40. package/dist/charts/stock-chart/stock-plot.js +2 -2
  41. package/dist/containers/chat-thread/chat-thread.d.ts +98 -0
  42. package/dist/containers/chat-thread/chat-thread.js +219 -0
  43. package/dist/containers/chat-thread/format.d.ts +20 -0
  44. package/dist/containers/chat-thread/format.js +50 -0
  45. package/dist/containers/chat-thread/index.d.ts +1 -0
  46. package/dist/containers/chat-thread/index.js +8 -0
  47. package/dist/containers/cols/cols.d.ts +1 -1
  48. package/dist/containers/cols/cols.js +7 -0
  49. package/dist/containers/comment/comment.js +1 -1
  50. package/dist/containers/context-rail/context-rail.d.ts +62 -0
  51. package/dist/containers/context-rail/context-rail.js +175 -0
  52. package/dist/containers/context-rail/index.d.ts +1 -0
  53. package/dist/containers/context-rail/index.js +6 -0
  54. package/dist/containers/dashboard/dashboard.d.ts +40 -0
  55. package/dist/containers/dashboard/dashboard.js +84 -0
  56. package/dist/containers/dashboard/index.d.ts +1 -0
  57. package/dist/containers/dashboard/index.js +14 -0
  58. package/dist/containers/data-grid/data-grid.demos.js +4 -4
  59. package/dist/containers/data-grid/data-grid.js +6 -6
  60. package/dist/containers/data-grid/filter-builder-editor.js +2 -2
  61. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  62. package/dist/containers/data-grid/spreadsheet.demos.d.ts +1 -1
  63. package/dist/containers/data-grid/spreadsheet.demos.js +1 -1
  64. package/dist/containers/detail-header/detail-header.d.ts +24 -0
  65. package/dist/containers/detail-header/detail-header.js +32 -0
  66. package/dist/containers/detail-header/index.d.ts +1 -0
  67. package/dist/containers/detail-header/index.js +6 -0
  68. package/dist/containers/facts/facts.js +1 -1
  69. package/dist/containers/filter-bar/filter-bar.d.ts +58 -0
  70. package/dist/containers/filter-bar/filter-bar.js +123 -0
  71. package/dist/containers/filter-bar/index.d.ts +1 -0
  72. package/dist/containers/filter-bar/index.js +6 -0
  73. package/dist/containers/hbars/hbars.js +2 -2
  74. package/dist/containers/index.d.ts +9 -0
  75. package/dist/containers/index.js +9 -0
  76. package/dist/containers/kanban/kanban.d.ts +23 -2
  77. package/dist/containers/kanban/kanban.js +101 -21
  78. package/dist/containers/kanban/model.d.ts +12 -0
  79. package/dist/containers/kanban/model.js +8 -0
  80. package/dist/containers/kpi/kpi.js +1 -1
  81. package/dist/containers/kpi-group/kpi-group.d.ts +6 -1
  82. package/dist/containers/kpi-group/kpi-group.js +6 -2
  83. package/dist/containers/list-detail/index.d.ts +1 -1
  84. package/dist/containers/list-detail/index.js +4 -0
  85. package/dist/containers/list-detail/list-detail.d.ts +51 -3
  86. package/dist/containers/list-detail/list-detail.js +109 -15
  87. package/dist/containers/page/page.d.ts +17 -4
  88. package/dist/containers/page/page.js +33 -4
  89. package/dist/containers/page-header/back.d.ts +10 -0
  90. package/dist/containers/page-header/back.js +28 -0
  91. package/dist/containers/page-header/index.d.ts +1 -0
  92. package/dist/containers/page-header/index.js +1 -0
  93. package/dist/containers/page-header/page-header.d.ts +19 -2
  94. package/dist/containers/page-header/page-header.js +26 -2
  95. package/dist/containers/pagination/cursor-pagination.d.ts +28 -0
  96. package/dist/containers/pagination/cursor-pagination.js +48 -0
  97. package/dist/containers/pagination/index.d.ts +3 -0
  98. package/dist/containers/pagination/index.js +10 -0
  99. package/dist/containers/pagination/pagination.d.ts +52 -0
  100. package/dist/containers/pagination/pagination.js +216 -0
  101. package/dist/containers/pagination/range.d.ts +29 -0
  102. package/dist/containers/pagination/range.js +42 -0
  103. package/dist/containers/pagination/use-pagination.d.ts +18 -0
  104. package/dist/containers/pagination/use-pagination.js +22 -0
  105. package/dist/containers/responsive-list/responsive-list.d.ts +28 -2
  106. package/dist/containers/responsive-list/responsive-list.js +134 -25
  107. package/dist/containers/row-actions/index.d.ts +1 -0
  108. package/dist/containers/row-actions/index.js +4 -0
  109. package/dist/containers/row-actions/row-actions.d.ts +26 -0
  110. package/dist/containers/row-actions/row-actions.js +78 -0
  111. package/dist/containers/selectable-card/index.d.ts +1 -0
  112. package/dist/containers/selectable-card/index.js +6 -0
  113. package/dist/containers/selectable-card/selectable-card.d.ts +26 -0
  114. package/dist/containers/selectable-card/selectable-card.js +57 -0
  115. package/dist/containers/settings-layout/settings-layout.d.ts +24 -7
  116. package/dist/containers/settings-layout/settings-layout.js +63 -8
  117. package/dist/containers/shortcuts/shortcuts.js +1 -1
  118. package/dist/containers/table/cell-padding.d.ts +2 -0
  119. package/dist/containers/table/cell-padding.js +4 -0
  120. package/dist/containers/table/index.d.ts +1 -0
  121. package/dist/containers/table/index.js +8 -0
  122. package/dist/containers/table/sort.d.ts +14 -0
  123. package/dist/containers/table/sort.js +11 -0
  124. package/dist/containers/table/table-parts.d.ts +24 -0
  125. package/dist/containers/table/table-parts.js +52 -0
  126. package/dist/containers/table/table.d.ts +37 -3
  127. package/dist/containers/table/table.js +120 -19
  128. package/dist/containers/table-columns-menu/index.d.ts +1 -0
  129. package/dist/containers/table-columns-menu/index.js +6 -0
  130. package/dist/containers/table-columns-menu/table-columns-menu.d.ts +14 -0
  131. package/dist/containers/table-columns-menu/table-columns-menu.js +46 -0
  132. package/dist/dashboards/layout.d.ts +1 -27
  133. package/dist/dashboards/layout.js +8 -40
  134. package/dist/forms/chip-group/chip-group.d.ts +5 -0
  135. package/dist/forms/chip-group/chip-group.js +3 -1
  136. package/dist/forms/combobox/combobox.js +1 -1
  137. package/dist/forms/copy-field/copy-field.js +1 -1
  138. package/dist/forms/date-picker/date-picker.d.ts +3 -1
  139. package/dist/forms/date-picker/date-picker.js +4 -2
  140. package/dist/forms/date-picker/date-time-picker.d.ts +8 -2
  141. package/dist/forms/date-picker/date-time-picker.js +13 -2
  142. package/dist/forms/field/field.d.ts +9 -2
  143. package/dist/forms/field/field.js +18 -4
  144. package/dist/forms/fieldset/fieldset.d.ts +11 -0
  145. package/dist/forms/fieldset/fieldset.js +12 -0
  146. package/dist/forms/fieldset/index.d.ts +1 -0
  147. package/dist/forms/fieldset/index.js +4 -0
  148. package/dist/forms/form-footer/form-footer.d.ts +26 -0
  149. package/dist/forms/form-footer/form-footer.js +44 -0
  150. package/dist/forms/form-footer/index.d.ts +1 -0
  151. package/dist/forms/form-footer/index.js +4 -0
  152. package/dist/forms/form-grid/form-grid.d.ts +21 -4
  153. package/dist/forms/form-grid/form-grid.js +20 -3
  154. package/dist/forms/form-grid/index.d.ts +1 -1
  155. package/dist/forms/form-grid/index.js +6 -2
  156. package/dist/forms/form-section/form-section.d.ts +12 -0
  157. package/dist/forms/form-section/form-section.js +30 -0
  158. package/dist/forms/form-section/index.d.ts +1 -0
  159. package/dist/forms/form-section/index.js +4 -0
  160. package/dist/forms/index.d.ts +3 -0
  161. package/dist/forms/index.js +3 -0
  162. package/dist/forms/input/input.d.ts +6 -2
  163. package/dist/forms/input/input.js +4 -1
  164. package/dist/forms/internal/listbox-items.d.ts +1 -1
  165. package/dist/forms/internal/listbox-items.js +3 -2
  166. package/dist/forms/native-select/native-select.js +1 -1
  167. package/dist/forms/select/index.d.ts +1 -1
  168. package/dist/forms/select/select.d.ts +5 -2
  169. package/dist/forms/select/select.js +7 -2
  170. package/dist/forms/select-menu/select-menu.js +1 -1
  171. package/dist/forms/time-input/time-input.d.ts +4 -2
  172. package/dist/forms/time-input/time-input.js +3 -1
  173. package/dist/i18n/strings.d.ts +86 -0
  174. package/dist/i18n/strings.js +46 -0
  175. package/dist/motion/count-up.d.ts +20 -0
  176. package/dist/motion/count-up.js +59 -0
  177. package/dist/motion/cross-fade.d.ts +21 -0
  178. package/dist/motion/cross-fade.js +86 -0
  179. package/dist/motion/index.d.ts +5 -0
  180. package/dist/motion/index.js +14 -0
  181. package/dist/motion/model.d.ts +15 -0
  182. package/dist/motion/model.js +68 -0
  183. package/dist/motion/motion-styles.d.ts +1 -0
  184. package/dist/motion/motion-styles.js +35 -0
  185. package/dist/motion/reveal.d.ts +37 -0
  186. package/dist/motion/reveal.js +69 -0
  187. package/dist/motion/use-enter-phase.d.ts +11 -0
  188. package/dist/motion/use-enter-phase.js +40 -0
  189. package/dist/motion/use-highlight-row.d.ts +22 -0
  190. package/dist/motion/use-highlight-row.js +38 -0
  191. package/dist/navigation/tabs/tabs.js +1 -1
  192. package/dist/navigation/wizard/wizard.d.ts +4 -1
  193. package/dist/navigation/wizard/wizard.js +3 -0
  194. package/dist/overlays/alert-dialog/alert-dialog.js +8 -1
  195. package/dist/overlays/context-menu/context-menu.js +3 -1
  196. package/dist/overlays/dialog/dialog.js +10 -2
  197. package/dist/overlays/drawer/drawer.d.ts +18 -4
  198. package/dist/overlays/drawer/drawer.js +53 -4
  199. package/dist/overlays/drawer/index.d.ts +1 -1
  200. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +1 -1
  201. package/dist/overlays/dropdown-menu/dropdown-menu.js +5 -4
  202. package/dist/overlays/hover-card/hover-card.js +2 -0
  203. package/dist/overlays/popover/popover.js +2 -0
  204. package/dist/overlays/toaster/index.d.ts +1 -1
  205. package/dist/overlays/toaster/toaster.d.ts +28 -2
  206. package/dist/overlays/toaster/toaster.js +73 -29
  207. package/dist/overlays/tooltip/tooltip.js +2 -0
  208. package/dist/primitives/use-presence.js +9 -0
  209. package/dist/shell/app-shell/app-shell.d.ts +8 -1
  210. package/dist/shell/app-shell/app-shell.js +50 -3
  211. package/dist/shell/index.d.ts +1 -0
  212. package/dist/shell/index.js +1 -0
  213. package/dist/shell/sidebar/sidebar.d.ts +17 -1
  214. package/dist/shell/sidebar/sidebar.js +126 -76
  215. package/dist/shell/topbar/topbar.d.ts +4 -2
  216. package/dist/shell/topbar/topbar.js +2 -0
  217. package/dist/showcase/operations-bento.js +2 -2
  218. package/dist/states/empty-state/empty-state.d.ts +10 -3
  219. package/dist/states/empty-state/empty-state.js +46 -5
  220. package/dist/states/error-state/error-state.js +1 -1
  221. package/dist/states/skeleton/skeleton.js +1 -1
  222. package/dist/utils/class-tokens.generated.js +4 -6
  223. package/dist/utils/list-navigation.d.ts +14 -0
  224. package/dist/utils/list-navigation.js +44 -0
  225. package/dist/utils/overlay-motion.d.ts +12 -0
  226. package/dist/utils/overlay-motion.js +14 -0
  227. package/dist/utils/use-container-width.d.ts +6 -0
  228. package/dist/utils/use-container-width.js +19 -0
  229. package/package.json +2 -2
  230. package/scripts/build-theme.mjs +46 -5
  231. package/src/ai/code-block/code-block.tsx +1 -1
  232. package/src/atoms/big-date/big-date.tsx +2 -2
  233. package/src/atoms/button/button.tsx +8 -3
  234. package/src/atoms/chip/chip.tsx +8 -3
  235. package/src/atoms/icon-button/icon-button.tsx +1 -1
  236. package/src/atoms/internal/hit-area.ts +5 -4
  237. package/src/atoms/progress/index.ts +8 -1
  238. package/src/atoms/progress/progress.tsx +30 -1
  239. package/src/atoms/radio-group/radio-group.tsx +1 -1
  240. package/src/atoms/status-pill/status-pill.tsx +59 -18
  241. package/src/brand/logo-forge.tsx +1 -1
  242. package/src/charts/candlestick-chart/candlestick-chart.tsx +2 -2
  243. package/src/charts/chart-grid/chart-grid.tsx +2 -2
  244. package/src/charts/chord-chart/chord-chart.tsx +1 -1
  245. package/src/charts/core/axes.tsx +2 -2
  246. package/src/charts/core/cartesian/annotations.tsx +2 -2
  247. package/src/charts/core/cartesian/marks.tsx +1 -1
  248. package/src/charts/core/distribution/marks.tsx +1 -1
  249. package/src/charts/core/distribution/xy-points.tsx +1 -1
  250. package/src/charts/core/export-menu.tsx +1 -1
  251. package/src/charts/funnel-chart/funnel-chart.tsx +1 -1
  252. package/src/charts/gantt-chart/gantt-chart.tsx +4 -4
  253. package/src/charts/gantt-chart/gantt-marks.tsx +3 -3
  254. package/src/charts/index.ts +2 -0
  255. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  256. package/src/charts/polar-area-chart/polar-area-chart.tsx +1 -1
  257. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  258. package/src/charts/stock-chart/stock-chart.tsx +1 -1
  259. package/src/charts/stock-chart/stock-drawing-layer.tsx +3 -3
  260. package/src/charts/stock-chart/stock-plot.tsx +2 -2
  261. package/src/containers/chat-thread/chat-thread.tsx +331 -0
  262. package/src/containers/chat-thread/format.ts +67 -0
  263. package/src/containers/chat-thread/index.ts +12 -0
  264. package/src/containers/cols/cols.tsx +13 -1
  265. package/src/containers/comment/comment.tsx +1 -1
  266. package/src/containers/context-rail/context-rail.tsx +229 -0
  267. package/src/containers/context-rail/index.ts +7 -0
  268. package/src/containers/dashboard/dashboard.tsx +142 -0
  269. package/src/containers/dashboard/index.ts +12 -0
  270. package/src/containers/data-grid/data-grid.demos.tsx +4 -4
  271. package/src/containers/data-grid/data-grid.tsx +6 -6
  272. package/src/containers/data-grid/filter-builder-editor.tsx +2 -2
  273. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  274. package/src/containers/data-grid/spreadsheet.demos.tsx +1 -1
  275. package/src/containers/detail-header/detail-header.tsx +64 -0
  276. package/src/containers/detail-header/index.ts +5 -0
  277. package/src/containers/facts/facts.tsx +1 -1
  278. package/src/containers/filter-bar/filter-bar.tsx +201 -0
  279. package/src/containers/filter-bar/index.ts +7 -0
  280. package/src/containers/hbars/hbars.tsx +2 -2
  281. package/src/containers/index.ts +9 -0
  282. package/src/containers/kanban/kanban.tsx +146 -39
  283. package/src/containers/kanban/model.ts +20 -0
  284. package/src/containers/kpi/kpi.tsx +1 -1
  285. package/src/containers/kpi-group/kpi-group.tsx +17 -2
  286. package/src/containers/list-detail/index.ts +5 -0
  287. package/src/containers/list-detail/list-detail.tsx +157 -9
  288. package/src/containers/page/page.tsx +61 -7
  289. package/src/containers/page-header/back.tsx +42 -0
  290. package/src/containers/page-header/index.ts +1 -0
  291. package/src/containers/page-header/page-header.tsx +49 -3
  292. package/src/containers/pagination/cursor-pagination.tsx +79 -0
  293. package/src/containers/pagination/index.ts +7 -0
  294. package/src/containers/pagination/pagination.tsx +266 -0
  295. package/src/containers/pagination/range.ts +68 -0
  296. package/src/containers/pagination/use-pagination.ts +44 -0
  297. package/src/containers/responsive-list/responsive-list.tsx +183 -46
  298. package/src/containers/row-actions/index.ts +1 -0
  299. package/src/containers/row-actions/row-actions.tsx +114 -0
  300. package/src/containers/selectable-card/index.ts +5 -0
  301. package/src/containers/selectable-card/selectable-card.tsx +84 -0
  302. package/src/containers/settings-layout/settings-layout.tsx +104 -13
  303. package/src/containers/shortcuts/shortcuts.tsx +1 -1
  304. package/src/containers/table/cell-padding.ts +2 -0
  305. package/src/containers/table/index.ts +6 -0
  306. package/src/containers/table/sort.ts +23 -0
  307. package/src/containers/table/table-parts.tsx +81 -0
  308. package/src/containers/table/table.tsx +212 -45
  309. package/src/containers/table-columns-menu/index.ts +5 -0
  310. package/src/containers/table-columns-menu/table-columns-menu.tsx +68 -0
  311. package/src/dashboards/layout.tsx +8 -75
  312. package/src/forms/chip-group/chip-group.tsx +8 -1
  313. package/src/forms/combobox/combobox.tsx +1 -1
  314. package/src/forms/copy-field/copy-field.tsx +1 -1
  315. package/src/forms/date-picker/date-picker.tsx +7 -2
  316. package/src/forms/date-picker/date-time-picker.tsx +28 -2
  317. package/src/forms/field/field.tsx +30 -3
  318. package/src/forms/fieldset/fieldset.tsx +22 -0
  319. package/src/forms/fieldset/index.ts +1 -0
  320. package/src/forms/form-footer/form-footer.tsx +74 -0
  321. package/src/forms/form-footer/index.ts +1 -0
  322. package/src/forms/form-grid/form-grid.tsx +42 -5
  323. package/src/forms/form-grid/index.ts +8 -1
  324. package/src/forms/form-section/form-section.tsx +41 -0
  325. package/src/forms/form-section/index.ts +1 -0
  326. package/src/forms/index.ts +3 -0
  327. package/src/forms/input/input.tsx +10 -3
  328. package/src/forms/internal/listbox-items.tsx +3 -4
  329. package/src/forms/native-select/native-select.tsx +1 -1
  330. package/src/forms/select/index.ts +1 -1
  331. package/src/forms/select/select.tsx +14 -3
  332. package/src/forms/select-menu/select-menu.tsx +1 -1
  333. package/src/forms/time-input/time-input.tsx +6 -2
  334. package/src/i18n/strings.ts +86 -0
  335. package/src/motion/count-up.tsx +83 -0
  336. package/src/motion/cross-fade.tsx +139 -0
  337. package/src/motion/index.ts +5 -0
  338. package/src/motion/model.ts +86 -0
  339. package/src/motion/motion-styles.tsx +47 -0
  340. package/src/motion/reveal.tsx +115 -0
  341. package/src/motion/use-enter-phase.ts +50 -0
  342. package/src/motion/use-highlight-row.ts +63 -0
  343. package/src/navigation/tabs/tabs.tsx +1 -1
  344. package/src/navigation/wizard/wizard.tsx +6 -1
  345. package/src/overlays/alert-dialog/alert-dialog.tsx +5 -1
  346. package/src/overlays/context-menu/context-menu.tsx +3 -2
  347. package/src/overlays/dialog/dialog.tsx +7 -2
  348. package/src/overlays/drawer/drawer.tsx +68 -6
  349. package/src/overlays/drawer/index.ts +1 -0
  350. package/src/overlays/dropdown-menu/dropdown-menu.tsx +5 -4
  351. package/src/overlays/hover-card/hover-card.tsx +2 -0
  352. package/src/overlays/popover/popover.tsx +2 -0
  353. package/src/overlays/toaster/index.ts +2 -0
  354. package/src/overlays/toaster/toaster.tsx +113 -17
  355. package/src/overlays/tooltip/tooltip.tsx +2 -0
  356. package/src/primitives/use-presence.ts +13 -0
  357. package/src/shell/app-shell/app-shell.tsx +54 -2
  358. package/src/shell/index.ts +1 -0
  359. package/src/shell/sidebar/sidebar.tsx +154 -75
  360. package/src/shell/topbar/topbar.tsx +8 -0
  361. package/src/showcase/operations-bento.tsx +2 -2
  362. package/src/states/empty-state/empty-state.tsx +52 -9
  363. package/src/states/error-state/error-state.tsx +1 -1
  364. package/src/states/skeleton/skeleton.tsx +1 -1
  365. package/src/utils/class-tokens.generated.ts +4 -6
  366. package/src/utils/list-navigation.ts +63 -0
  367. package/src/utils/overlay-motion.ts +33 -0
  368. package/src/utils/use-container-width.ts +24 -0
  369. package/styles/Theme.kt +15 -18
  370. package/styles/tailwind.css +29 -28
  371. package/styles/theme.css +29 -28
  372. package/styles/tokens.css +46 -0
  373. package/tokens/default.json +51 -29
@@ -1,9 +1,10 @@
1
1
  "use client";
2
2
 
3
- import type { ReactNode } from "react";
3
+ import type { KeyboardEvent, MouseEvent, ReactNode } 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 { focusRowByKey } from "../../utils/list-navigation.js";
7
8
  import {
8
9
  Table,
9
10
  TableBody,
@@ -13,6 +14,36 @@ import {
13
14
  TableRow,
14
15
  } from "../table/table.js";
15
16
 
17
+ /** Container widths (px) from which `layout="auto"` shows the table. The set is closed so every query is a literal class. */
18
+ export type ResponsiveListBreakpoint = 480 | 640 | 672 | 768 | 960 | 1280;
19
+
20
+ const tableClasses: Record<ResponsiveListBreakpoint, { table: string; cards: string }> = {
21
+ 480: {
22
+ table: "hidden @min-[480px]/responsive-list:block",
23
+ cards: "@min-[480px]/responsive-list:hidden",
24
+ },
25
+ 640: {
26
+ table: "hidden @min-[640px]/responsive-list:block",
27
+ cards: "@min-[640px]/responsive-list:hidden",
28
+ },
29
+ 672: {
30
+ table: "hidden @min-[42rem]/responsive-list:block",
31
+ cards: "@min-[42rem]/responsive-list:hidden",
32
+ },
33
+ 768: {
34
+ table: "hidden @min-[768px]/responsive-list:block",
35
+ cards: "@min-[768px]/responsive-list:hidden",
36
+ },
37
+ 960: {
38
+ table: "hidden @min-[960px]/responsive-list:block",
39
+ cards: "@min-[960px]/responsive-list:hidden",
40
+ },
41
+ 1280: {
42
+ table: "hidden @min-[1280px]/responsive-list:block",
43
+ cards: "@min-[1280px]/responsive-list:hidden",
44
+ },
45
+ };
46
+
16
47
  export interface ResponsiveListColumn<T> {
17
48
  key: string;
18
49
  header: string;
@@ -45,12 +76,36 @@ export interface ResponsiveListProps<T> {
45
76
  /** Header of the actions column. Defaults to the localized "Actions". */
46
77
  actionsHeader?: string;
47
78
  rowClassName?: (item: T) => string | undefined;
79
+ /**
80
+ * `"auto"` (default) is a table from `breakpoint` of the list's own container width up and cards
81
+ * below it. `"cards"` always renders the cards, for a list that sits in a narrow pane (a master
82
+ * list next to its detail).
83
+ */
84
+ layout?: "auto" | "cards";
85
+ /** Container width (px) from which `layout="auto"` shows the table. Defaults to 672 (42rem). */
86
+ breakpoint?: ResponsiveListBreakpoint;
87
+ /**
88
+ * `"visible"` (default) shows each field label in the cards. `"hidden"` keeps them for screen
89
+ * readers only, for cards whose values explain themselves (a price, a status).
90
+ */
91
+ cardLabels?: "visible" | "hidden";
92
+ /** Key of the selected row, or `null`/`undefined` for none. Only used together with `onSelect`. */
93
+ selectedKey?: string | null;
94
+ /**
95
+ * Makes rows selectable (click, Enter or Space) and adds keyboard navigation (arrows, Home, End).
96
+ * Without `renderActions` the cards are a `listbox` of `option`s and the table a `grid` whose
97
+ * rows carry `aria-selected`; with it the rows keep plain list/table semantics and the selected
98
+ * one gets `aria-current="true"`, because actions cannot live inside an option.
99
+ */
100
+ onSelect?: (key: string, item: T) => void;
101
+ /** Arrow keys select the row they land on, not only move focus. Off by default. */
102
+ selectOnFocus?: boolean;
48
103
  className?: string;
49
104
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
50
105
  classNames?: ClassNames<ResponsiveListPart>;
51
106
  }
52
107
 
53
- /** A table once its own container is 42rem wide and a stack of cards below that, from one column definition. */
108
+ /** A table from `breakpoint` of its own width up and a stack of cards below it, from one column definition. */
54
109
  export function ResponsiveList<T>({
55
110
  caption,
56
111
  items,
@@ -59,65 +114,136 @@ export function ResponsiveList<T>({
59
114
  renderActions,
60
115
  actionsHeader,
61
116
  rowClassName,
117
+ layout = "auto",
118
+ breakpoint = 672,
119
+ cardLabels = "visible",
120
+ selectedKey,
121
+ onSelect,
122
+ selectOnFocus = false,
62
123
  className,
63
124
  classNames,
64
125
  }: ResponsiveListProps<T>) {
65
126
  const strings = useUiStrings();
66
127
  const primary = columns.find((column) => column.primary) ?? columns[0];
67
128
  const details = columns.filter((column) => column !== primary);
129
+ const selectable = onSelect !== undefined;
130
+ const listbox = selectable && !renderActions;
131
+ const firstKey = items[0] ? rowKey(items[0]) : undefined;
132
+ const stopKey =
133
+ selectedKey != null && items.some((item) => rowKey(item) === selectedKey)
134
+ ? selectedKey
135
+ : firstKey;
136
+
137
+ const rowProps = (item: T, kind: "grid" | "card") => {
138
+ if (!selectable) return {};
139
+ const key = rowKey(item);
140
+ const selected = key === selectedKey;
141
+ const select = () => onSelect(key, item);
142
+ return {
143
+ tabIndex: key === stopKey ? 0 : -1,
144
+ "data-selected": selected ? "true" : undefined,
145
+ ...(kind === "grid" || listbox
146
+ ? { "aria-selected": selected }
147
+ : { "aria-current": selected ? ("true" as const) : undefined }),
148
+ ...(kind === "card" && listbox ? { role: "option" as const } : {}),
149
+ onClick: (event: MouseEvent<HTMLElement>) => {
150
+ if (
151
+ (event.target as HTMLElement).closest(
152
+ "a, button, input, select, textarea, [data-row-actions]",
153
+ )
154
+ )
155
+ return;
156
+ select();
157
+ },
158
+ onKeyDown: (event: KeyboardEvent<HTMLElement>) => {
159
+ if (event.target !== event.currentTarget) return;
160
+ if (event.key === "Enter" || event.key === " ") {
161
+ event.preventDefault();
162
+ select();
163
+ return;
164
+ }
165
+ const scope = event.currentTarget.closest("[data-row-scope]");
166
+ if (!scope || event.altKey || event.ctrlKey || event.metaKey) return;
167
+ const row = focusRowByKey(scope, event.currentTarget, event.key);
168
+ if (!row) return;
169
+ event.preventDefault();
170
+ if (selectOnFocus) {
171
+ const nextKey = row.getAttribute("data-row-key");
172
+ const next = items.find((candidate) => rowKey(candidate) === nextKey);
173
+ if (next) onSelect(rowKey(next), next);
174
+ }
175
+ },
176
+ };
177
+ };
68
178
 
69
179
  return (
70
180
  <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
- >
181
+ {layout === "auto" ? (
182
+ <div
183
+ className={cn(
184
+ "rounded-card border-card shadow-card surface-card",
185
+ tableClasses[breakpoint].table,
186
+ classNames?.tableWrapper,
187
+ )}
188
+ >
189
+ <Table
190
+ {...(selectable ? { role: "grid", "aria-label": caption, "data-row-scope": "" } : {})}
191
+ >
192
+ <caption className="sr-only">{caption}</caption>
193
+ <TableHead>
194
+ <TableRow className="hover:bg-transparent">
100
195
  {columns.map((column) => (
101
- <TableCell key={column.key} alignRight={column.align === "end"}>
102
- {column.cell(item)}
103
- </TableCell>
196
+ <TableHeaderCell key={column.key} scope="col" alignRight={column.align === "end"}>
197
+ {column.header}
198
+ </TableHeaderCell>
104
199
  ))}
105
200
  {renderActions ? (
106
- <TableCell alignRight>
107
- <div className={cn("flex flex-wrap justify-end gap-2", classNames?.actions)}>
108
- {renderActions(item)}
109
- </div>
110
- </TableCell>
201
+ <TableHeaderCell scope="col" alignRight>
202
+ {actionsHeader ?? strings.actions}
203
+ </TableHeaderCell>
111
204
  ) : null}
112
205
  </TableRow>
113
- ))}
114
- </TableBody>
115
- </Table>
116
- </div>
206
+ </TableHead>
207
+ <TableBody>
208
+ {items.map((item) => (
209
+ <TableRow
210
+ key={rowKey(item)}
211
+ data-row-key={rowKey(item)}
212
+ className={cn(
213
+ rowClassName?.(item),
214
+ selectable &&
215
+ "cursor-pointer focus-visible:focus-ring data-[selected=true]:bg-accent-soft",
216
+ )}
217
+ {...rowProps(item, "grid")}
218
+ >
219
+ {columns.map((column) => (
220
+ <TableCell key={column.key} alignRight={column.align === "end"}>
221
+ {column.cell(item)}
222
+ </TableCell>
223
+ ))}
224
+ {renderActions ? (
225
+ <TableCell alignRight>
226
+ <div
227
+ data-row-actions=""
228
+ className={cn("flex flex-wrap justify-end gap-2", classNames?.actions)}
229
+ >
230
+ {renderActions(item)}
231
+ </div>
232
+ </TableCell>
233
+ ) : null}
234
+ </TableRow>
235
+ ))}
236
+ </TableBody>
237
+ </Table>
238
+ </div>
239
+ ) : null}
117
240
  <ul
118
241
  aria-label={caption}
242
+ {...(listbox ? { role: "listbox" } : {})}
243
+ {...(selectable ? { "data-row-scope": "" } : {})}
119
244
  className={cn(
120
- "m-0 flex list-none flex-col gap-density p-0 @min-[42rem]/responsive-list:hidden",
245
+ "m-0 flex list-none flex-col gap-density p-0",
246
+ layout === "auto" && tableClasses[breakpoint].cards,
121
247
  classNames?.cards,
122
248
  )}
123
249
  >
@@ -127,9 +253,12 @@ export function ResponsiveList<T>({
127
253
  data-row-key={rowKey(item)}
128
254
  className={cn(
129
255
  "flex min-w-0 flex-col gap-3 rounded-card border-card p-card shadow-card surface-card",
256
+ selectable &&
257
+ "cursor-pointer focus-visible:focus-ring data-[selected=true]:bg-accent-soft data-[selected=true]:shadow-selected",
130
258
  rowClassName?.(item),
131
259
  classNames?.card,
132
260
  )}
261
+ {...rowProps(item, "card")}
133
262
  >
134
263
  <div
135
264
  className={cn(
@@ -146,15 +275,23 @@ export function ResponsiveList<T>({
146
275
  key={column.key}
147
276
  className={cn(
148
277
  "flex items-baseline justify-between gap-4",
278
+ cardLabels === "hidden" && "justify-start",
149
279
  classNames?.cardDetail,
150
280
  )}
151
281
  >
152
- <dt className={cn("shrink-0 text-ink-3 text-meta", classNames?.cardLabel)}>
282
+ <dt
283
+ className={cn(
284
+ "shrink-0 text-ink-3 text-meta",
285
+ cardLabels === "hidden" && "sr-only",
286
+ classNames?.cardLabel,
287
+ )}
288
+ >
153
289
  {column.header}
154
290
  </dt>
155
291
  <dd
156
292
  className={cn(
157
293
  "m-0 min-w-0 text-right text-body text-ink [overflow-wrap:anywhere]",
294
+ cardLabels === "hidden" && "text-left",
158
295
  classNames?.cardValue,
159
296
  )}
160
297
  >
@@ -165,7 +302,7 @@ export function ResponsiveList<T>({
165
302
  </dl>
166
303
  ) : null}
167
304
  {renderActions ? (
168
- <div className={cn("flex flex-wrap gap-2", classNames?.actions)}>
305
+ <div data-row-actions="" className={cn("flex flex-wrap gap-2", classNames?.actions)}>
169
306
  {renderActions(item)}
170
307
  </div>
171
308
  ) : 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
  )}
@@ -31,7 +31,7 @@ export interface ShortcutsItemProps extends ComponentPropsWithoutRef<"a"> {
31
31
  }
32
32
 
33
33
  const itemClasses =
34
- "flex min-h-control-sm w-full cursor-pointer items-center gap-2 rounded-button px-2 text-start text-fs-130 text-ink-2 no-underline hover:bg-surface-2 hover:text-ink focus-visible:focus-ring in-data-[density=touch]:min-h-11";
34
+ "flex min-h-control-sm w-full cursor-pointer items-center gap-2 rounded-button px-2 text-start text-fs-130 text-ink-2 no-underline hover:bg-surface-2 hover:text-ink focus-visible:focus-ring";
35
35
 
36
36
  export function ShortcutsItem({
37
37
  icon,