@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
@@ -4,14 +4,19 @@ export * from "./banner/index.js";
4
4
  export * from "./card/index.js";
5
5
  export * from "./carousel/index.js";
6
6
  export * from "./cell/index.js";
7
+ export * from "./chat-thread/index.js";
7
8
  export * from "./cols/index.js";
8
9
  export * from "./comment/index.js";
9
10
  export * from "./confirm-action/index.js";
11
+ export * from "./context-rail/index.js";
12
+ export * from "./dashboard/index.js";
10
13
  export * from "./data-grid/index.js";
11
14
  export * from "./description-list/index.js";
15
+ export * from "./detail-header/index.js";
12
16
  export * from "./facts/index.js";
13
17
  export * from "./feed/index.js";
14
18
  export * from "./file-tree/index.js";
19
+ export * from "./filter-bar/index.js";
15
20
  export * from "./generic-row/index.js";
16
21
  export * from "./grid/index.js";
17
22
  export * from "./hbars/index.js";
@@ -24,14 +29,18 @@ export * from "./list-detail/index.js";
24
29
  export * from "./note/index.js";
25
30
  export * from "./page/index.js";
26
31
  export * from "./page-header/index.js";
32
+ export * from "./pagination/index.js";
27
33
  export * from "./resizable/index.js";
28
34
  export * from "./responsive-list/index.js";
35
+ export * from "./row-actions/index.js";
29
36
  export * from "./scrolly/index.js";
30
37
  export * from "./section/index.js";
38
+ export * from "./selectable-card/index.js";
31
39
  export * from "./settings-layout/index.js";
32
40
  export * from "./settings-row/index.js";
33
41
  export * from "./shortcuts/index.js";
34
42
  export * from "./stack/index.js";
35
43
  export * from "./table/index.js";
44
+ export * from "./table-columns-menu/index.js";
36
45
  export * from "./timeline/index.js";
37
46
  export * from "./toolbar/index.js";
@@ -1,17 +1,38 @@
1
1
  import { type ReactNode } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  import { type KanbanCardData, type KanbanColumnData, type KanbanMove } from "./model.js";
4
- export type KanbanPart = "root" | "board" | "column" | "columnHeader" | "columnTitle" | "count" | "cards" | "card" | "grip" | "empty" | "indicator" | "ghost";
4
+ export type KanbanPart = "root" | "board" | "column" | "columnHeader" | "columnTitle" | "count" | "cards" | "card" | "grip" | "actions" | "empty" | "indicator" | "ghost";
5
5
  export interface KanbanProps {
6
6
  /** Controlled board. Pair with `onColumnsChange`. */
7
7
  columns?: KanbanColumnData[];
8
8
  defaultColumns?: KanbanColumnData[];
9
9
  /** Called after a drop (pointer release or keyboard drop) with the new board and the move. */
10
10
  onColumnsChange?: (columns: KanbanColumnData[], move: KanbanMove) => void;
11
+ /**
12
+ * Set to `false` for a board that only displays: no drag handle, no pointer or keyboard
13
+ * pick-up, and cards are plain content (with `cardActions` still rendered). Defaults to `true`.
14
+ */
15
+ draggable?: boolean;
11
16
  /** Refuse drops into another column that already reached its WIP limit. */
12
17
  enforceLimit?: boolean;
13
18
  /** Replaces the default card body. */
14
19
  renderCard?: (card: KanbanCardData) => ReactNode;
20
+ /**
21
+ * Buttons shown under each card. When set, the card is no longer one `role="button"`: its body
22
+ * is plain content, the actions are real, separately focusable controls, and keyboard
23
+ * pick-up moves to a grip button. Without it the card keeps the single-button behaviour.
24
+ */
25
+ cardActions?: (card: KanbanCardData) => ReactNode;
26
+ /** Accessible name of the grip button when `cardActions` is set; defaults to "Mover tarjeta: <title>". */
27
+ gripLabel?: (card: KanbanCardData) => string;
28
+ /**
29
+ * Lays the cards of a lane out as a responsive grid once the lane is 30rem (480 px) wide,
30
+ * with columns of at least `cardGridMinWidth`; a narrower lane stays a single column. Dropping with the pointer
31
+ * follows reading order; arrow keys still move a held card one place up or down the lane.
32
+ */
33
+ cardGrid?: boolean;
34
+ /** Minimum card width (px) of the grid lane. Defaults to 224. */
35
+ cardGridMinWidth?: number;
15
36
  emptyLabel?: string;
16
37
  "aria-label"?: string;
17
38
  className?: string;
@@ -23,4 +44,4 @@ export interface KanbanProps {
23
44
  * grip). Keyboard: Space or Enter picks a card up, arrows move it, Space or Enter drops it,
24
45
  * Escape cancels. Moves are announced in a live region.
25
46
  */
26
- export declare function Kanban({ columns: controlled, defaultColumns, onColumnsChange, enforceLimit, renderCard, emptyLabel, className, classNames, "aria-label": ariaLabel, }: KanbanProps): import("react").JSX.Element;
47
+ export declare function Kanban({ columns: controlled, defaultColumns, onColumnsChange, draggable, enforceLimit, renderCard, cardActions, gripLabel, cardGrid, cardGridMinWidth, emptyLabel, className, classNames, "aria-label": ariaLabel, }: KanbanProps): import("react").JSX.Element;
@@ -11,8 +11,10 @@ import { Avatar } from "../../atoms/avatar/avatar.js";
11
11
  import { Chip } from "../../atoms/chip/chip.js";
12
12
  import { GripVertical } from "../../icons/index.js";
13
13
  import { cn } from "../../utils/cn.js";
14
+ import { useFocusRescue } from "../../utils/focus-rescue.js";
14
15
  import {
15
16
  dropIndex,
17
+ dropIndexGrid,
16
18
  keyboardTarget,
17
19
  locateCard,
18
20
  moveCard,
@@ -35,8 +37,13 @@ function Kanban({
35
37
  columns: controlled,
36
38
  defaultColumns = [],
37
39
  onColumnsChange,
40
+ draggable = true,
38
41
  enforceLimit = false,
39
42
  renderCard,
43
+ cardActions,
44
+ gripLabel = (card) => `Mover tarjeta: ${card.title}`,
45
+ cardGrid = false,
46
+ cardGridMinWidth = 224,
40
47
  emptyLabel = "Sin tarjetas",
41
48
  className,
42
49
  classNames,
@@ -49,6 +56,7 @@ function Kanban({
49
56
  const [drag, setDrag] = useState(null);
50
57
  const [status, setStatus] = useState("");
51
58
  const rootRef = useRef(null);
59
+ useFocusRescue(rootRef, { item: "[data-card-id]", group: "ul" });
52
60
  const focusId = useRef(null);
53
61
  const columnsRef = useRef(columns);
54
62
  columnsRef.current = columns;
@@ -64,7 +72,8 @@ function Kanban({
64
72
  useLayoutEffect(() => {
65
73
  const id = focusId.current;
66
74
  if (!id) return;
67
- const el = rootRef.current?.querySelector(`[data-card-id="${CSS.escape(id)}"]`);
75
+ const card = rootRef.current?.querySelector(`[data-card-id="${CSS.escape(id)}"]`);
76
+ const el = card?.querySelector("[data-card-grip]") ?? card;
68
77
  if (el && document.activeElement !== el) el.focus();
69
78
  if (!grabbedId) focusId.current = null;
70
79
  });
@@ -120,6 +129,7 @@ function Kanban({
120
129
  };
121
130
  const startPointerDrag = (event, card) => {
122
131
  if (event.button !== 0 || grabbedId) return;
132
+ if (event.target.closest("[data-card-actions]")) return;
123
133
  if (event.pointerType === "touch" && !event.target.closest("[data-grip]")) {
124
134
  return;
125
135
  }
@@ -133,7 +143,14 @@ function Kanban({
133
143
  const column = document.elementFromPoint(x, y)?.closest("[data-column-id]");
134
144
  const columnId = column?.dataset.columnId;
135
145
  if (!column || !columnId) return null;
136
- const mids = Array.from(column.querySelectorAll("[data-card-id]")).filter((el) => el.dataset.cardId !== card.id).map((el) => {
146
+ const others = Array.from(column.querySelectorAll("[data-card-id]")).filter(
147
+ (el) => el.dataset.cardId !== card.id
148
+ );
149
+ if (column.hasAttribute("data-card-grid")) {
150
+ const rects = others.map((el) => el.getBoundingClientRect());
151
+ return { columnId, index: dropIndexGrid(rects, x, y) };
152
+ }
153
+ const mids = others.map((el) => {
137
154
  const r = el.getBoundingClientRect();
138
155
  return r.top + r.height / 2;
139
156
  });
@@ -202,7 +219,7 @@ function Kanban({
202
219
  }
203
220
  },
204
221
  children: [
205
- /* @__PURE__ */ jsx("p", { id: instructionsId, className: "sr-only", children: "Presiona Espacio para tomar una tarjeta, las flechas para moverla y Espacio para soltarla. Escape cancela." }),
222
+ draggable ? /* @__PURE__ */ jsx("p", { id: instructionsId, className: "sr-only", children: "Presiona Espacio para tomar una tarjeta, las flechas para moverla y Espacio para soltarla. Escape cancela." }) : null,
206
223
  /* @__PURE__ */ jsx("div", { role: "status", "aria-live": "assertive", className: "sr-only", children: status }),
207
224
  /* @__PURE__ */ jsx(
208
225
  "div",
@@ -235,39 +252,101 @@ function Kanban({
235
252
  }
236
253
  const grabbed = grabbedId === card.id;
237
254
  items.push(
238
- /* @__PURE__ */ jsx("li", { className: "min-w-0", children: /* @__PURE__ */ jsxs(
255
+ /* @__PURE__ */ jsx("li", { className: "min-w-0", children: cardActions ? /* @__PURE__ */ jsxs(
239
256
  "div",
240
257
  {
241
- role: "button",
242
- tabIndex: 0,
243
258
  "data-card-id": card.id,
244
- "aria-pressed": grabbed,
245
- "aria-roledescription": "tarjeta arrastrable",
246
- "aria-describedby": instructionsId,
247
- onKeyDown: (e) => onCardKeyDown(e, card),
248
- onPointerDown: (e) => startPointerDrag(e, card),
259
+ onPointerDown: (e) => {
260
+ if (draggable) startPointerDrag(e, card);
261
+ },
249
262
  className: cn(
250
- "pressable relative flex cursor-grab select-none gap-1 rounded-input border-card surface-card p-density shadow-card focus-visible:focus-ring",
263
+ "relative flex flex-col gap-density-sm rounded-input border-card surface-card p-density shadow-card",
264
+ draggable && "cursor-grab select-none",
251
265
  isDragged && "opacity-40",
252
266
  grabbed && "shadow-selected",
253
267
  classNames?.card
254
268
  ),
255
269
  children: [
270
+ /* @__PURE__ */ jsxs("div", { className: "flex gap-1", children: [
271
+ draggable ? /* @__PURE__ */ jsx(
272
+ "button",
273
+ {
274
+ type: "button",
275
+ "data-card-grip": "",
276
+ "data-grip": "",
277
+ "aria-label": gripLabel(card),
278
+ "aria-pressed": grabbed,
279
+ "aria-roledescription": "tarjeta arrastrable",
280
+ "aria-describedby": instructionsId,
281
+ onKeyDown: (e) => onCardKeyDown(e, card),
282
+ className: cn(
283
+ "-ml-1 flex min-h-8 w-6 shrink-0 touch-none items-start justify-center rounded-control pt-0.5 text-ink-3 focus-visible:focus-ring",
284
+ classNames?.grip
285
+ ),
286
+ children: /* @__PURE__ */ jsx(GripVertical, { "aria-hidden": "true", className: "size-4" })
287
+ }
288
+ ) : null,
289
+ /* @__PURE__ */ jsx("div", { className: "min-w-0 flex-1", children: renderCard ? renderCard(card) : /* @__PURE__ */ jsx(DefaultCard, { card }) })
290
+ ] }),
256
291
  /* @__PURE__ */ jsx(
257
- "span",
292
+ "div",
258
293
  {
259
- "data-grip": "",
260
- "aria-hidden": "true",
294
+ "data-card-actions": "",
261
295
  className: cn(
262
- "-ml-1 flex w-4 shrink-0 touch-none items-start pt-0.5 text-ink-3",
263
- classNames?.grip
296
+ "flex cursor-auto flex-wrap items-center gap-density-sm",
297
+ classNames?.actions
264
298
  ),
265
- children: /* @__PURE__ */ jsx(GripVertical, { className: "size-4" })
299
+ children: cardActions(card)
266
300
  }
267
- ),
268
- /* @__PURE__ */ jsx("div", { className: "min-w-0 flex-1", children: renderCard ? renderCard(card) : /* @__PURE__ */ jsx(DefaultCard, { card }) })
301
+ )
269
302
  ]
270
303
  }
304
+ ) : draggable ? (
305
+ // biome-ignore lint/a11y/useSemanticElements: draggable card is a custom widget
306
+ /* @__PURE__ */ jsxs(
307
+ "div",
308
+ {
309
+ role: "button",
310
+ tabIndex: 0,
311
+ "data-card-id": card.id,
312
+ "aria-pressed": grabbed,
313
+ "aria-roledescription": "tarjeta arrastrable",
314
+ "aria-describedby": instructionsId,
315
+ onKeyDown: (e) => onCardKeyDown(e, card),
316
+ onPointerDown: (e) => startPointerDrag(e, card),
317
+ className: cn(
318
+ "pressable relative flex cursor-grab select-none gap-1 rounded-input border-card surface-card p-density shadow-card focus-visible:focus-ring",
319
+ isDragged && "opacity-40",
320
+ grabbed && "shadow-selected",
321
+ classNames?.card
322
+ ),
323
+ children: [
324
+ /* @__PURE__ */ jsx(
325
+ "span",
326
+ {
327
+ "data-grip": "",
328
+ "aria-hidden": "true",
329
+ className: cn(
330
+ "-ml-1 flex w-4 shrink-0 touch-none items-start pt-0.5 text-ink-3",
331
+ classNames?.grip
332
+ ),
333
+ children: /* @__PURE__ */ jsx(GripVertical, { className: "size-4" })
334
+ }
335
+ ),
336
+ /* @__PURE__ */ jsx("div", { className: "min-w-0 flex-1", children: renderCard ? renderCard(card) : /* @__PURE__ */ jsx(DefaultCard, { card }) })
337
+ ]
338
+ }
339
+ )
340
+ ) : /* @__PURE__ */ jsx(
341
+ "div",
342
+ {
343
+ "data-card-id": card.id,
344
+ className: cn(
345
+ "relative flex gap-1 rounded-input border-card surface-card p-density shadow-card",
346
+ classNames?.card
347
+ ),
348
+ children: /* @__PURE__ */ jsx("div", { className: "min-w-0 flex-1", children: renderCard ? renderCard(card) : /* @__PURE__ */ jsx(DefaultCard, { card }) })
349
+ }
271
350
  ) }, card.id)
272
351
  );
273
352
  }
@@ -276,9 +355,10 @@ function Kanban({
276
355
  "section",
277
356
  {
278
357
  "data-column-id": column.id,
358
+ "data-card-grid": cardGrid ? "" : void 0,
279
359
  "aria-label": column.title,
280
360
  className: cn(
281
- "flex w-[min(18rem,85cqw)] shrink-0 snap-start flex-col gap-density-sm rounded-card bg-surface-sunken p-density-sm @4xl/kanban:w-auto @4xl/kanban:min-w-56 @4xl/kanban:flex-1",
361
+ "@container/lane flex w-[min(18rem,85cqw)] shrink-0 snap-start flex-col gap-density-sm rounded-card bg-surface-sunken p-density-sm @4xl/kanban:w-auto @4xl/kanban:min-w-56 @4xl/kanban:flex-1",
282
362
  classNames?.column
283
363
  ),
284
364
  children: [
@@ -315,8 +395,10 @@ function Kanban({
315
395
  /* @__PURE__ */ jsxs(
316
396
  "ul",
317
397
  {
398
+ style: cardGrid ? { "--lane-card-min": `${cardGridMinWidth}px` } : void 0,
318
399
  className: cn(
319
400
  "m-0 flex min-h-16 list-none flex-col gap-density-sm p-0",
401
+ cardGrid && "@min-[30rem]/lane:grid @min-[30rem]/lane:grid-cols-[repeat(auto-fill,minmax(var(--lane-card-min),1fr))] @min-[30rem]/lane:items-start",
320
402
  classNames?.cards
321
403
  ),
322
404
  children: [
@@ -47,3 +47,15 @@ export declare function keyboardTarget(columns: KanbanColumnData[], cardId: stri
47
47
  } | null;
48
48
  /** Insert index for a pointer at `y`, from the vertical midpoints of the cards left in a column. */
49
49
  export declare function dropIndex(midpoints: number[], y: number): number;
50
+ export interface CardRect {
51
+ left: number;
52
+ right: number;
53
+ top: number;
54
+ bottom: number;
55
+ }
56
+ /**
57
+ * Insert index for a pointer at (`x`, `y`) over a lane that lays its cards out as a grid, from the
58
+ * rectangles of the cards left in the lane in reading order: a card is passed when the pointer is
59
+ * below its row, or inside its row and past its horizontal midpoint.
60
+ */
61
+ export declare function dropIndexGrid(rects: CardRect[], x: number, y: number): number;
@@ -68,8 +68,16 @@ function dropIndex(midpoints, y) {
68
68
  }
69
69
  return index;
70
70
  }
71
+ function dropIndexGrid(rects, x, y) {
72
+ let index = 0;
73
+ for (const rect of rects) {
74
+ if (y > rect.bottom || y >= rect.top && x > (rect.left + rect.right) / 2) index += 1;
75
+ }
76
+ return index;
77
+ }
71
78
  export {
72
79
  dropIndex,
80
+ dropIndexGrid,
73
81
  keyboardTarget,
74
82
  locateCard,
75
83
  moveCard,
@@ -81,7 +81,7 @@ function KpiValue({ suffix, trend, mono, className, children, ...props }) {
81
81
  {
82
82
  ...props,
83
83
  className: cn(
84
- "break-words text-kpi-number tabular-nums @max-[9rem]/kpi:text-fs-220",
84
+ "break-words text-kpi-number tabular-nums @max-[9rem]/kpi:text-fs-200",
85
85
  mono && "font-mono tracking-normal",
86
86
  valueTone,
87
87
  classNames?.value,
@@ -25,6 +25,11 @@ export interface KpiGroupProps extends Omit<ComponentPropsWithoutRef<"dl">, "chi
25
25
  layout?: KpiGroupLayout;
26
26
  /** Minimum tile width in px for `layout="auto-fit"`. */
27
27
  minItemWidth?: number;
28
+ /**
29
+ * Columns on the narrowest containers. `1` (default) stacks the tiles; `2` keeps two across
30
+ * (and `auto-fit` never goes below two) for short tiles on a phone.
31
+ */
32
+ minColumns?: 1 | 2;
28
33
  /** Animate numeric values counting up. */
29
34
  animate?: boolean;
30
35
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root wrapper and is merged last. */
@@ -34,4 +39,4 @@ export interface KpiGroupProps extends Omit<ComponentPropsWithoutRef<"dl">, "chi
34
39
  * Metrics that belong together in one card, divided by hairlines. Columns follow the
35
40
  * container width: 1, 2 or 4 across.
36
41
  */
37
- export declare function KpiGroup({ items, layout, minItemWidth, animate, className, classNames, style, ...props }: KpiGroupProps): import("react").JSX.Element;
42
+ export declare function KpiGroup({ items, layout, minItemWidth, minColumns, animate, className, classNames, style, ...props }: KpiGroupProps): import("react").JSX.Element;
@@ -6,6 +6,7 @@ function KpiGroup({
6
6
  items,
7
7
  layout = "divided",
8
8
  minItemWidth = 150,
9
+ minColumns = 1,
9
10
  animate = true,
10
11
  className,
11
12
  classNames,
@@ -18,12 +19,15 @@ function KpiGroup({
18
19
  {
19
20
  ...props,
20
21
  style: autoFit ? {
21
- gridTemplateColumns: `repeat(auto-fit, minmax(min(100%, ${minItemWidth}px), 1fr))`,
22
+ gridTemplateColumns: `repeat(auto-fit, minmax(min(${minColumns === 2 ? `${minItemWidth}px, calc((100% - var(--gap-density)) / 2)` : `100%, ${minItemWidth}px`}), 1fr))`,
22
23
  ...style
23
24
  } : style,
24
25
  className: cn(
25
26
  "m-0 grid",
26
- autoFit ? "gap-density" : "grid-cols-1 gap-px overflow-hidden rounded-card border-card bg-divider shadow-card @sm/kpi-group:grid-cols-2 @3xl/kpi-group:grid-cols-4",
27
+ autoFit ? "gap-density" : cn(
28
+ "gap-px overflow-hidden rounded-card border-card bg-divider shadow-card @sm/kpi-group:grid-cols-2 @3xl/kpi-group:grid-cols-4",
29
+ minColumns === 2 ? "grid-cols-2 @max-sm/kpi-group:[&>:last-child:nth-child(odd)]:col-span-2" : "grid-cols-1"
30
+ ),
27
31
  classNames?.list
28
32
  ),
29
33
  children: items.map((item) => /* @__PURE__ */ jsxs(
@@ -1 +1 @@
1
- export { ListDetail, ListDetailDetail, ListDetailDetailHeader, type ListDetailDetailHeaderProps, type ListDetailDetailProps, ListDetailItem, type ListDetailItemProps, ListDetailList, type ListDetailListProps, ListDetailMeta, type ListDetailProps, ListDetailTitle, useListDetail, } from "./list-detail.js";
1
+ export { ListDetail, ListDetailDetail, ListDetailDetailHeader, type ListDetailDetailHeaderProps, type ListDetailDetailProps, ListDetailEmpty, type ListDetailEmptyProps, ListDetailHeader, type ListDetailHeaderProps, ListDetailItem, type ListDetailItemProps, ListDetailList, type ListDetailListProps, ListDetailMeta, type ListDetailProps, type ListDetailRatio, ListDetailTitle, useListDetail, } from "./list-detail.js";
@@ -2,6 +2,8 @@ import {
2
2
  ListDetail,
3
3
  ListDetailDetail,
4
4
  ListDetailDetailHeader,
5
+ ListDetailEmpty,
6
+ ListDetailHeader,
5
7
  ListDetailItem,
6
8
  ListDetailList,
7
9
  ListDetailMeta,
@@ -12,6 +14,8 @@ export {
12
14
  ListDetail,
13
15
  ListDetailDetail,
14
16
  ListDetailDetailHeader,
17
+ ListDetailEmpty,
18
+ ListDetailHeader,
15
19
  ListDetailItem,
16
20
  ListDetailList,
17
21
  ListDetailMeta,
@@ -5,6 +5,8 @@ export declare function useListDetail(): {
5
5
  select: (value: string | null) => void;
6
6
  isSelected: (candidate: string) => boolean;
7
7
  };
8
+ /** List-to-detail width ratio when `listWidth` is not set: `1:1` (default), `1:2` or `1:3`. */
9
+ export type ListDetailRatio = "1:1" | "1:2" | "1:3";
8
10
  export interface ListDetailProps extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue" | "onChange"> {
9
11
  /** Controlled selected item id; `null` means none (the single-pane view then shows the list). */
10
12
  value?: string | null | undefined;
@@ -21,6 +23,26 @@ export interface ListDetailProps extends Omit<ComponentPropsWithoutRef<"div">, "
21
23
  onBack?: (() => void) | undefined;
22
24
  /** Names the list of items. */
23
25
  "aria-label": string;
26
+ /**
27
+ * Fixed width of the list column beside the detail, from 641px of the component's own width: a
28
+ * number is pixels, a string any CSS length (`"20rem"`). A rail of 280-360px reads better than
29
+ * an even split for most catalogues. Wins over `ratio`.
30
+ */
31
+ listWidth?: number | string | undefined;
32
+ /** Proportional split when `listWidth` is not set. Defaults to `"1:1"` (the original even split). */
33
+ ratio?: ListDetailRatio | undefined;
34
+ /**
35
+ * `"flat"` (default) keeps the panes flush with a divider between them. `"card"` draws each pane
36
+ * as a raised card with a gap between them.
37
+ */
38
+ surface?: "flat" | "card" | undefined;
39
+ /**
40
+ * Keeps the list column in view while the page scrolls and gives it its own scroll, from 641px
41
+ * of the component's own width. The list header stays at the top of the column.
42
+ */
43
+ stickyList?: boolean | undefined;
44
+ /** Distance the sticky list keeps from the top of its scroll container (number = pixels). Default `0`. */
45
+ stickyOffset?: number | string | undefined;
24
46
  children: ReactNode;
25
47
  }
26
48
  /**
@@ -28,9 +50,22 @@ export interface ListDetailProps extends Omit<ComponentPropsWithoutRef<"div">, "
28
50
  * width it collapses to a single pane: the list until an item is chosen, then the detail with a
29
51
  * back action (focus follows the change). Panes render flush to the container's inline edges.
30
52
  */
31
- export declare function ListDetail({ value: valueProp, defaultValue, onValueChange, onBack, "aria-label": label, className, children, ...props }: ListDetailProps): import("react").JSX.Element;
32
- export type ListDetailListProps = Omit<ComponentPropsWithoutRef<"ul">, "aria-label">;
33
- export declare function ListDetailList({ className, ...props }: ListDetailListProps): import("react").JSX.Element;
53
+ export declare function ListDetail({ value: valueProp, defaultValue, onValueChange, onBack, "aria-label": label, listWidth, ratio, surface, stickyList, stickyOffset, className, style, children, ...props }: ListDetailProps): import("react").JSX.Element;
54
+ export interface ListDetailListProps extends Omit<ComponentPropsWithoutRef<"ul">, "aria-label"> {
55
+ /** Sits above the items and stays put while they scroll: a `ListDetailHeader` with search, filters and a count. */
56
+ header?: ReactNode;
57
+ }
58
+ /**
59
+ * The list column: an optional `header` above the item list. The `ul` is named by the
60
+ * `ListDetail`'s `aria-label`; `className` and the other props go to it.
61
+ */
62
+ export declare function ListDetailList({ header, className, ...props }: ListDetailListProps): import("react").JSX.Element;
63
+ export interface ListDetailHeaderProps extends ComponentPropsWithoutRef<"div"> {
64
+ /** End slot showing how many items match, e.g. `12`. Announced politely when it changes. */
65
+ count?: ReactNode;
66
+ }
67
+ /** Controls row of the list column: a search field, filter chips and a result count. */
68
+ export declare function ListDetailHeader({ count, className, children, ...props }: ListDetailHeaderProps): import("react").JSX.Element;
34
69
  export interface ListDetailItemProps extends Omit<ComponentPropsWithoutRef<"button">, "value"> {
35
70
  value: string;
36
71
  /** End slot: a count, a status chip, a time. */
@@ -53,3 +88,16 @@ export interface ListDetailDetailHeaderProps extends Omit<ComponentPropsWithoutR
53
88
  actions?: ReactNode;
54
89
  }
55
90
  export declare function ListDetailDetailHeader({ title, description, actions, className, ...props }: ListDetailDetailHeaderProps): import("react").JSX.Element;
91
+ export interface ListDetailEmptyProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
92
+ /** Decorative icon; hidden from screen readers. */
93
+ icon?: ReactNode;
94
+ title: ReactNode;
95
+ description?: ReactNode;
96
+ /** Call to action under the text. */
97
+ action?: ReactNode;
98
+ }
99
+ /**
100
+ * Placeholder for the detail pane while nothing is selected ("Choose an item"). Render it inside
101
+ * `ListDetailDetail`; it renders nothing once an item is selected, so it needs no condition.
102
+ */
103
+ export declare function ListDetailEmpty({ icon, title, description, action, className, ...props }: ListDetailEmptyProps): import("react").JSX.Element | null;