@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
@@ -0,0 +1,266 @@
1
+ "use client";
2
+
3
+ import { type ComponentPropsWithoutRef, useId, useMemo } from "react";
4
+ import { Button } from "../../atoms/button/button.js";
5
+ import { useUiStrings } from "../../i18n/index.js";
6
+ import { ChevronLeft, ChevronRight, ChevronsLeft, ChevronsRight } from "../../icons/index.js";
7
+ import { cn } from "../../utils/cn.js";
8
+ import { useControllableState } from "../../utils/use-controllable-state.js";
9
+ import {
10
+ clampPage,
11
+ formatPageRange,
12
+ formatRange,
13
+ pageCount,
14
+ pageItems,
15
+ pageRange,
16
+ } from "./range.js";
17
+
18
+ export {
19
+ clampPage,
20
+ formatPageRange,
21
+ formatRange,
22
+ type PageItem,
23
+ pageCount,
24
+ pageItems,
25
+ pageRange,
26
+ } from "./range.js";
27
+
28
+ export interface PaginationLabels {
29
+ nav: string;
30
+ rowsPerPage: string;
31
+ /** `{first}`, `{last}` and `{total}` are replaced. */
32
+ range: string;
33
+ first: string;
34
+ previous: string;
35
+ next: string;
36
+ last: string;
37
+ /** Range text of the `pages` variant; `{first}`, `{last}` and `{total}` are replaced. */
38
+ showing: string;
39
+ /** Visible label of the previous button of the `pages` variant. */
40
+ previousLabel: string;
41
+ /** Visible label of the next button of the `pages` variant. */
42
+ nextLabel: string;
43
+ /** Name of a page number button; `{page}` is replaced. */
44
+ pageNumber: string;
45
+ }
46
+
47
+ export interface PaginationProps extends Omit<ComponentPropsWithoutRef<"nav">, "onChange"> {
48
+ /** Total rows across every page. */
49
+ total: number;
50
+ /** Controlled 1-based page. Pair it with `onPageChange`. */
51
+ page?: number;
52
+ /** Initial page when uncontrolled. Default 1. */
53
+ defaultPage?: number;
54
+ onPageChange?: (page: number) => void;
55
+ /** Controlled rows per page. Pair it with `onPageSizeChange`. */
56
+ pageSize?: number;
57
+ /** Initial rows per page when uncontrolled. Default: the first of `pageSizeOptions`. */
58
+ defaultPageSize?: number;
59
+ onPageSizeChange?: (pageSize: number) => void;
60
+ /** Choices of the page size picker. Default `[10, 25, 50, 100]`; a single option hides the picker. */
61
+ pageSizeOptions?: readonly number[];
62
+ /** Texts (localized by default through `UiStrings`). */
63
+ labels?: Partial<PaginationLabels>;
64
+ /**
65
+ * `default`: rows per page, the range and first/previous/next/last icon buttons. `pages`: the
66
+ * range ("Showing 1–25 of 134") and Previous, page number and Next buttons; it shows the page size
67
+ * picker only when `pageSizeOptions` is passed with more than one option.
68
+ */
69
+ variant?: "default" | "pages";
70
+ /** Renders nothing while every row fits on one page. Default `true` for `pages`, `false` otherwise. */
71
+ hideOnSinglePage?: boolean;
72
+ }
73
+
74
+ const DEFAULT_OPTIONS = [10, 25, 50, 100] as const;
75
+
76
+ const stepButton =
77
+ "grid size-8 place-items-center rounded-control text-ink-2 hover:bg-surface-2 hover:text-ink focus-visible:focus-ring disabled:pointer-events-none disabled:opacity-35 [&_svg]:size-4";
78
+
79
+ /**
80
+ * Footer of a list or table: rows per page, the range shown ("11–20 of 134") and first, previous,
81
+ * next and last buttons. Pages are 1-based. It does not slice your rows: use `page` and `pageSize`
82
+ * to do that, or to request the page from your API. Changing the page size returns to page 1.
83
+ */
84
+ export function Pagination({
85
+ total,
86
+ page,
87
+ defaultPage = 1,
88
+ onPageChange,
89
+ pageSize,
90
+ defaultPageSize,
91
+ onPageSizeChange,
92
+ pageSizeOptions: pageSizeOptionsProp,
93
+ labels,
94
+ variant = "default",
95
+ hideOnSinglePage = variant === "pages",
96
+ className,
97
+ ...props
98
+ }: PaginationProps) {
99
+ const pageSizeOptions = pageSizeOptionsProp ?? DEFAULT_OPTIONS;
100
+ const strings = useUiStrings();
101
+ const selectId = useId();
102
+ const [size, setSize] = useControllableState<number>({
103
+ prop: pageSize,
104
+ defaultProp: defaultPageSize ?? pageSizeOptions[0] ?? DEFAULT_OPTIONS[0],
105
+ onChange: onPageSizeChange,
106
+ });
107
+ const [current, setPage] = useControllableState<number>({
108
+ prop: page,
109
+ defaultProp: defaultPage,
110
+ onChange: onPageChange,
111
+ });
112
+ const text: PaginationLabels = {
113
+ nav: labels?.nav ?? strings.pagination,
114
+ rowsPerPage: labels?.rowsPerPage ?? strings.rowsPerPage,
115
+ range: labels?.range ?? strings.pageRange,
116
+ first: labels?.first ?? strings.firstPage,
117
+ previous: labels?.previous ?? strings.previousPage,
118
+ next: labels?.next ?? strings.nextPage,
119
+ last: labels?.last ?? strings.lastPage,
120
+ showing: labels?.showing ?? strings.showingRange,
121
+ previousLabel: labels?.previousLabel ?? strings.previous,
122
+ nextLabel: labels?.nextLabel ?? strings.next,
123
+ pageNumber: labels?.pageNumber ?? strings.pageNumber,
124
+ };
125
+ const pages = pageCount(total, size);
126
+ const at = clampPage(current, pages);
127
+ const { first, last } = pageRange(at, size, total);
128
+ const format = useMemo(() => new Intl.NumberFormat(strings.locale), [strings.locale]);
129
+ const sizes = [...new Set([...pageSizeOptions, size])].sort((a, b) => a - b);
130
+ const atStart = at <= 1;
131
+ const atEnd = at >= pages;
132
+ if (hideOnSinglePage && pages <= 1) return null;
133
+ const picker =
134
+ sizes.length > 1 && (variant === "default" || pageSizeOptionsProp !== undefined) ? (
135
+ <span className="flex items-center gap-2">
136
+ <label htmlFor={selectId}>{text.rowsPerPage}</label>
137
+ <select
138
+ id={selectId}
139
+ value={size}
140
+ onChange={(event) => {
141
+ setSize(Number(event.target.value));
142
+ setPage(1);
143
+ }}
144
+ className="h-control-sm rounded-input border-control bg-surface-control px-1.5 text-fs-120 text-ink"
145
+ >
146
+ {sizes.map((option) => (
147
+ <option key={option} value={option}>
148
+ {option}
149
+ </option>
150
+ ))}
151
+ </select>
152
+ </span>
153
+ ) : null;
154
+ if (variant === "pages") {
155
+ return (
156
+ <nav
157
+ aria-label={text.nav}
158
+ className={cn(
159
+ "flex min-w-0 flex-wrap items-center justify-between gap-x-4 gap-y-2 py-2 text-fs-120 text-ink-2",
160
+ className,
161
+ )}
162
+ {...props}
163
+ >
164
+ <span aria-live="polite" className="tabular-nums">
165
+ {formatRange(text.showing, {
166
+ first: format.format(first),
167
+ last: format.format(last),
168
+ total: format.format(Math.max(0, total)),
169
+ })}
170
+ </span>
171
+ <span className="flex flex-wrap items-center gap-x-4 gap-y-2">
172
+ {picker}
173
+ <span className="flex items-center gap-1">
174
+ <Button size="sm" disabled={atStart} onClick={() => setPage(at - 1)}>
175
+ {text.previousLabel}
176
+ </Button>
177
+ {pageItems(at, pages).map((item, index) =>
178
+ item === "gap" ? (
179
+ <span
180
+ // biome-ignore lint/suspicious/noArrayIndexKey: a gap has no identity besides its slot
181
+ key={`gap-${index}`}
182
+ aria-hidden="true"
183
+ className="w-6 text-center text-ink-3"
184
+ >
185
+ …
186
+ </span>
187
+ ) : (
188
+ <Button
189
+ key={item}
190
+ size="sm"
191
+ variant={item === at ? "secondary" : "ghost"}
192
+ aria-current={item === at ? "page" : undefined}
193
+ aria-label={text.pageNumber.replace("{page}", String(item))}
194
+ onClick={() => setPage(item)}
195
+ className="min-w-control-sm px-2 tabular-nums"
196
+ >
197
+ {format.format(item)}
198
+ </Button>
199
+ ),
200
+ )}
201
+ <Button size="sm" disabled={atEnd} onClick={() => setPage(at + 1)}>
202
+ {text.nextLabel}
203
+ </Button>
204
+ </span>
205
+ </span>
206
+ </nav>
207
+ );
208
+ }
209
+ return (
210
+ <nav
211
+ aria-label={text.nav}
212
+ className={cn(
213
+ "@container/pagination flex min-w-0 flex-wrap items-center justify-end gap-x-4 gap-y-1 px-2 py-1.5 text-fs-120 text-ink-2",
214
+ className,
215
+ )}
216
+ {...props}
217
+ >
218
+ {picker}
219
+ <span aria-live="polite" className="tabular-nums">
220
+ {formatPageRange(text.range, {
221
+ first: format.format(first),
222
+ last: format.format(last),
223
+ total: format.format(Math.max(0, total)),
224
+ })}
225
+ </span>
226
+ <span className="flex items-center">
227
+ <button
228
+ type="button"
229
+ className={stepButton}
230
+ aria-label={text.first}
231
+ disabled={atStart}
232
+ onClick={() => setPage(1)}
233
+ >
234
+ <ChevronsLeft aria-hidden="true" />
235
+ </button>
236
+ <button
237
+ type="button"
238
+ className={stepButton}
239
+ aria-label={text.previous}
240
+ disabled={atStart}
241
+ onClick={() => setPage(at - 1)}
242
+ >
243
+ <ChevronLeft aria-hidden="true" />
244
+ </button>
245
+ <button
246
+ type="button"
247
+ className={stepButton}
248
+ aria-label={text.next}
249
+ disabled={atEnd}
250
+ onClick={() => setPage(at + 1)}
251
+ >
252
+ <ChevronRight aria-hidden="true" />
253
+ </button>
254
+ <button
255
+ type="button"
256
+ className={stepButton}
257
+ aria-label={text.last}
258
+ disabled={atEnd}
259
+ onClick={() => setPage(pages)}
260
+ >
261
+ <ChevronsRight aria-hidden="true" />
262
+ </button>
263
+ </span>
264
+ </nav>
265
+ );
266
+ }
@@ -0,0 +1,68 @@
1
+ /** Number of pages for `total` rows; at least 1 so an empty list still has a first page. */
2
+ export function pageCount(total: number, pageSize: number): number {
3
+ if (pageSize <= 0) return 1;
4
+ return Math.max(1, Math.ceil(Math.max(0, total) / pageSize));
5
+ }
6
+
7
+ /** Keeps a 1-based page inside `1..pages`. */
8
+ export function clampPage(page: number, pages: number): number {
9
+ return Math.min(Math.max(1, Math.trunc(page) || 1), pages);
10
+ }
11
+
12
+ /** 1-based first and last row shown on `page`; `{ first: 0, last: 0 }` when there are no rows. */
13
+ export function pageRange(
14
+ page: number,
15
+ pageSize: number,
16
+ total: number,
17
+ ): { first: number; last: number } {
18
+ if (total <= 0 || pageSize <= 0) return { first: 0, last: 0 };
19
+ const current = clampPage(page, pageCount(total, pageSize));
20
+ return { first: (current - 1) * pageSize + 1, last: Math.min(total, current * pageSize) };
21
+ }
22
+
23
+ /** Fills the `{first}`, `{last}` and `{total}` placeholders of the `pageRange` UI string. */
24
+ export function formatPageRange(
25
+ template: string,
26
+ values: { first: string; last: string; total: string },
27
+ ): string {
28
+ return template
29
+ .replace("{first}", values.first)
30
+ .replace("{last}", values.last)
31
+ .replace("{total}", values.total);
32
+ }
33
+
34
+ /** A page number button, or a gap between two runs of them. */
35
+ export type PageItem = number | "gap";
36
+
37
+ /**
38
+ * The page buttons to show: the first and last page, the current one with `siblings` on each side,
39
+ * and a `"gap"` where pages are left out. A gap never hides a single page (that page shows instead),
40
+ * so the list keeps the same length while the current page moves through the middle.
41
+ */
42
+ export function pageItems(page: number, pages: number, siblings = 1): PageItem[] {
43
+ const total = Math.max(1, Math.trunc(pages));
44
+ const current = clampPage(page, total);
45
+ const slots = siblings * 2 + 5;
46
+ if (total <= slots) return Array.from({ length: total }, (_, i) => i + 1);
47
+ const start = Math.max(Math.min(current - siblings, total - siblings * 2 - 2), 3);
48
+ const end = Math.min(Math.max(current + siblings, siblings * 2 + 3), total - 2);
49
+ const middle = Array.from({ length: end - start + 1 }, (_, i) => start + i);
50
+ return [
51
+ 1,
52
+ start > 3 ? ("gap" as const) : 2,
53
+ ...middle,
54
+ end < total - 2 ? ("gap" as const) : total - 1,
55
+ total,
56
+ ];
57
+ }
58
+
59
+ /** Fills `{first}` and `{last}` (and `{total}` when given) in a range template. */
60
+ export function formatRange(
61
+ template: string,
62
+ values: { first: string; last: string; total?: string },
63
+ ): string {
64
+ return template
65
+ .replace("{first}", values.first)
66
+ .replace("{last}", values.last)
67
+ .replace("{total}", values.total ?? "");
68
+ }
@@ -0,0 +1,44 @@
1
+ "use client";
2
+
3
+ import { useMemo, useState } from "react";
4
+ import { clampPage, pageCount } from "./range.js";
5
+
6
+ export interface PaginationState<T> {
7
+ /** Current 1-based page, always inside `1..pageCount`. */
8
+ page: number;
9
+ pageCount: number;
10
+ /** Rows across every page. */
11
+ total: number;
12
+ pageSize: number;
13
+ /** The rows of the current page. */
14
+ items: readonly T[];
15
+ setPage: (page: number) => void;
16
+ }
17
+
18
+ /**
19
+ * Client-side paging over an already filtered and sorted list. The page is clamped, so a search
20
+ * that shrinks the list lands on the last page that still exists instead of an empty one, and it
21
+ * returns to the first page whenever `resetKey` changes (the search text, a filter, the sort).
22
+ * Pair it with `<Pagination variant="pages">`.
23
+ */
24
+ export function usePagination<T>(
25
+ rows: readonly T[],
26
+ resetKey: unknown = "",
27
+ pageSize = 25,
28
+ ): PaginationState<T> {
29
+ const [requested, setPage] = useState(1);
30
+ const [key, setKey] = useState(resetKey);
31
+ // Reset during render rather than in an effect, so the first page shows without a stale frame.
32
+ if (!Object.is(key, resetKey)) {
33
+ setKey(resetKey);
34
+ setPage(1);
35
+ }
36
+ const total = rows.length;
37
+ const pages = pageCount(total, pageSize);
38
+ const page = Object.is(key, resetKey) ? clampPage(requested, pages) : 1;
39
+ const items = useMemo(
40
+ () => rows.slice((page - 1) * pageSize, page * pageSize),
41
+ [rows, page, pageSize],
42
+ );
43
+ return { page, pageCount: pages, total, pageSize, items, setPage };
44
+ }