@jcsoftdev/ui 0.4.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (489) hide show
  1. package/CHANGELOG.md +434 -0
  2. package/README.md +26 -4
  3. package/bin/ui-theme.mjs +40 -6
  4. package/dist/ai/code-block/code-block.js +1 -1
  5. package/dist/atoms/big-date/big-date.js +2 -2
  6. package/dist/atoms/button/button.d.ts +14 -2
  7. package/dist/atoms/button/button.js +12 -5
  8. package/dist/atoms/chip/chip.d.ts +5 -0
  9. package/dist/atoms/chip/chip.js +3 -3
  10. package/dist/atoms/divider/divider.d.ts +15 -0
  11. package/dist/atoms/divider/divider.js +27 -0
  12. package/dist/atoms/divider/index.d.ts +1 -0
  13. package/dist/atoms/divider/index.js +1 -0
  14. package/dist/atoms/icon-button/icon-button.d.ts +1 -1
  15. package/dist/atoms/icon-button/icon-button.js +1 -1
  16. package/dist/atoms/index.d.ts +1 -0
  17. package/dist/atoms/index.js +1 -0
  18. package/dist/atoms/internal/hit-area.d.ts +5 -4
  19. package/dist/atoms/internal/hit-area.js +1 -1
  20. package/dist/atoms/progress/index.d.ts +1 -1
  21. package/dist/atoms/progress/index.js +4 -1
  22. package/dist/atoms/progress/progress.d.ts +6 -1
  23. package/dist/atoms/progress/progress.js +19 -1
  24. package/dist/atoms/radio-group/radio-group.js +1 -1
  25. package/dist/atoms/status-pill/status-pill.d.ts +16 -5
  26. package/dist/atoms/status-pill/status-pill.js +43 -18
  27. package/dist/auth/auth-illustration/auth-illustration.d.ts +35 -0
  28. package/dist/auth/auth-illustration/auth-illustration.js +72 -0
  29. package/dist/auth/auth-illustration/index.d.ts +3 -0
  30. package/dist/auth/auth-illustration/index.js +11 -0
  31. package/dist/auth/auth-illustration/look.d.ts +30 -0
  32. package/dist/auth/auth-illustration/look.js +0 -0
  33. package/dist/auth/auth-illustration/model.d.ts +133 -0
  34. package/dist/auth/auth-illustration/model.js +202 -0
  35. package/dist/auth/auth-illustration/use-art-pointer.d.ts +9 -0
  36. package/dist/auth/auth-illustration/use-art-pointer.js +69 -0
  37. package/dist/auth/auth-layout/auth-layout.d.ts +80 -0
  38. package/dist/auth/auth-layout/auth-layout.js +190 -0
  39. package/dist/auth/auth-layout/index.d.ts +1 -0
  40. package/dist/auth/auth-layout/index.js +1 -0
  41. package/dist/auth/character/character.d.ts +12 -0
  42. package/dist/auth/character/character.js +333 -0
  43. package/dist/auth/character/index.d.ts +1 -0
  44. package/dist/auth/character/index.js +1 -0
  45. package/dist/auth/index.d.ts +4 -0
  46. package/dist/auth/index.js +4 -0
  47. package/dist/auth/internal/auth-context.d.ts +17 -0
  48. package/dist/auth/internal/auth-context.js +10 -0
  49. package/dist/auth/internal/auth-styles.d.ts +1 -0
  50. package/dist/auth/internal/auth-styles.js +29 -0
  51. package/dist/auth/internal/portal-glyphs.d.ts +6 -0
  52. package/dist/auth/internal/portal-glyphs.js +39 -0
  53. package/dist/auth/login-form/context.d.ts +51 -0
  54. package/dist/auth/login-form/context.js +12 -0
  55. package/dist/auth/login-form/index.d.ts +2 -0
  56. package/dist/auth/login-form/index.js +23 -0
  57. package/dist/auth/login-form/login-form.d.ts +66 -0
  58. package/dist/auth/login-form/login-form.js +233 -0
  59. package/dist/auth/login-form/parts.d.ts +71 -0
  60. package/dist/auth/login-form/parts.js +371 -0
  61. package/dist/auth/looks/auth-illustration-any.d.ts +16 -0
  62. package/dist/auth/looks/auth-illustration-any.js +24 -0
  63. package/dist/auth/looks/index.d.ts +1 -0
  64. package/dist/auth/looks/index.js +1 -0
  65. package/dist/auth/mosaic/index.d.ts +1 -0
  66. package/dist/auth/mosaic/index.js +1 -0
  67. package/dist/auth/mosaic/mosaic.d.ts +11 -0
  68. package/dist/auth/mosaic/mosaic.js +195 -0
  69. package/dist/auth/slabs/index.d.ts +1 -0
  70. package/dist/auth/slabs/index.js +1 -0
  71. package/dist/auth/slabs/slabs.d.ts +13 -0
  72. package/dist/auth/slabs/slabs.js +136 -0
  73. package/dist/auth/stack/index.d.ts +1 -0
  74. package/dist/auth/stack/index.js +1 -0
  75. package/dist/auth/stack/stack.d.ts +6 -0
  76. package/dist/auth/stack/stack.js +222 -0
  77. package/dist/auth/statement/index.d.ts +1 -0
  78. package/dist/auth/statement/index.js +1 -0
  79. package/dist/auth/statement/statement.d.ts +13 -0
  80. package/dist/auth/statement/statement.js +99 -0
  81. package/dist/brand/logo-forge.js +1 -1
  82. package/dist/charts/candlestick-chart/candlestick-chart.js +2 -2
  83. package/dist/charts/chart-grid/chart-grid.js +2 -2
  84. package/dist/charts/chord-chart/chord-chart.js +1 -1
  85. package/dist/charts/core/axes.js +2 -2
  86. package/dist/charts/core/cartesian/annotations.js +2 -2
  87. package/dist/charts/core/cartesian/marks.js +1 -1
  88. package/dist/charts/core/distribution/marks.js +1 -1
  89. package/dist/charts/core/distribution/xy-points.js +1 -1
  90. package/dist/charts/core/export-menu.js +1 -1
  91. package/dist/charts/funnel-chart/funnel-chart.js +1 -1
  92. package/dist/charts/gantt-chart/gantt-chart.js +4 -4
  93. package/dist/charts/gantt-chart/gantt-marks.js +3 -3
  94. package/dist/charts/index.d.ts +2 -0
  95. package/dist/charts/index.js +2 -0
  96. package/dist/charts/maps/geo/map-data-table.js +1 -1
  97. package/dist/charts/polar-area-chart/polar-area-chart.js +1 -1
  98. package/dist/charts/radar-chart/radar-chart.js +1 -1
  99. package/dist/charts/stock-chart/stock-chart.js +1 -1
  100. package/dist/charts/stock-chart/stock-drawing-layer.js +3 -3
  101. package/dist/charts/stock-chart/stock-plot.js +2 -2
  102. package/dist/containers/chat-thread/chat-thread.d.ts +98 -0
  103. package/dist/containers/chat-thread/chat-thread.js +219 -0
  104. package/dist/containers/chat-thread/format.d.ts +20 -0
  105. package/dist/containers/chat-thread/format.js +50 -0
  106. package/dist/containers/chat-thread/index.d.ts +1 -0
  107. package/dist/containers/chat-thread/index.js +8 -0
  108. package/dist/containers/cols/cols.d.ts +1 -1
  109. package/dist/containers/cols/cols.js +7 -0
  110. package/dist/containers/comment/comment.js +1 -1
  111. package/dist/containers/context-rail/context-rail.d.ts +62 -0
  112. package/dist/containers/context-rail/context-rail.js +175 -0
  113. package/dist/containers/context-rail/index.d.ts +1 -0
  114. package/dist/containers/context-rail/index.js +6 -0
  115. package/dist/containers/dashboard/dashboard.d.ts +40 -0
  116. package/dist/containers/dashboard/dashboard.js +84 -0
  117. package/dist/containers/dashboard/index.d.ts +1 -0
  118. package/dist/containers/dashboard/index.js +14 -0
  119. package/dist/containers/data-grid/data-grid.demos.js +4 -4
  120. package/dist/containers/data-grid/data-grid.js +6 -6
  121. package/dist/containers/data-grid/filter-builder-editor.js +2 -2
  122. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  123. package/dist/containers/data-grid/spreadsheet.demos.d.ts +1 -1
  124. package/dist/containers/data-grid/spreadsheet.demos.js +1 -1
  125. package/dist/containers/detail-header/detail-header.d.ts +24 -0
  126. package/dist/containers/detail-header/detail-header.js +32 -0
  127. package/dist/containers/detail-header/index.d.ts +1 -0
  128. package/dist/containers/detail-header/index.js +6 -0
  129. package/dist/containers/facts/facts.js +1 -1
  130. package/dist/containers/filter-bar/filter-bar.d.ts +58 -0
  131. package/dist/containers/filter-bar/filter-bar.js +123 -0
  132. package/dist/containers/filter-bar/index.d.ts +1 -0
  133. package/dist/containers/filter-bar/index.js +6 -0
  134. package/dist/containers/hbars/hbars.js +2 -2
  135. package/dist/containers/index.d.ts +9 -0
  136. package/dist/containers/index.js +9 -0
  137. package/dist/containers/kanban/kanban.d.ts +23 -2
  138. package/dist/containers/kanban/kanban.js +101 -21
  139. package/dist/containers/kanban/model.d.ts +12 -0
  140. package/dist/containers/kanban/model.js +8 -0
  141. package/dist/containers/kpi/kpi.js +1 -1
  142. package/dist/containers/kpi-group/kpi-group.d.ts +6 -1
  143. package/dist/containers/kpi-group/kpi-group.js +6 -2
  144. package/dist/containers/list-detail/index.d.ts +1 -1
  145. package/dist/containers/list-detail/index.js +4 -0
  146. package/dist/containers/list-detail/list-detail.d.ts +51 -3
  147. package/dist/containers/list-detail/list-detail.js +109 -15
  148. package/dist/containers/page/page.d.ts +17 -4
  149. package/dist/containers/page/page.js +33 -4
  150. package/dist/containers/page-header/back.d.ts +10 -0
  151. package/dist/containers/page-header/back.js +28 -0
  152. package/dist/containers/page-header/index.d.ts +1 -0
  153. package/dist/containers/page-header/index.js +1 -0
  154. package/dist/containers/page-header/page-header.d.ts +19 -2
  155. package/dist/containers/page-header/page-header.js +26 -2
  156. package/dist/containers/pagination/cursor-pagination.d.ts +28 -0
  157. package/dist/containers/pagination/cursor-pagination.js +48 -0
  158. package/dist/containers/pagination/index.d.ts +3 -0
  159. package/dist/containers/pagination/index.js +10 -0
  160. package/dist/containers/pagination/pagination.d.ts +52 -0
  161. package/dist/containers/pagination/pagination.js +216 -0
  162. package/dist/containers/pagination/range.d.ts +29 -0
  163. package/dist/containers/pagination/range.js +42 -0
  164. package/dist/containers/pagination/use-pagination.d.ts +18 -0
  165. package/dist/containers/pagination/use-pagination.js +22 -0
  166. package/dist/containers/responsive-list/responsive-list.d.ts +28 -2
  167. package/dist/containers/responsive-list/responsive-list.js +134 -25
  168. package/dist/containers/row-actions/index.d.ts +1 -0
  169. package/dist/containers/row-actions/index.js +4 -0
  170. package/dist/containers/row-actions/row-actions.d.ts +26 -0
  171. package/dist/containers/row-actions/row-actions.js +78 -0
  172. package/dist/containers/selectable-card/index.d.ts +1 -0
  173. package/dist/containers/selectable-card/index.js +6 -0
  174. package/dist/containers/selectable-card/selectable-card.d.ts +26 -0
  175. package/dist/containers/selectable-card/selectable-card.js +57 -0
  176. package/dist/containers/settings-layout/settings-layout.d.ts +24 -7
  177. package/dist/containers/settings-layout/settings-layout.js +63 -8
  178. package/dist/containers/shortcuts/shortcuts.js +1 -1
  179. package/dist/containers/table/cell-padding.d.ts +2 -0
  180. package/dist/containers/table/cell-padding.js +4 -0
  181. package/dist/containers/table/index.d.ts +1 -0
  182. package/dist/containers/table/index.js +8 -0
  183. package/dist/containers/table/sort.d.ts +14 -0
  184. package/dist/containers/table/sort.js +11 -0
  185. package/dist/containers/table/table-parts.d.ts +24 -0
  186. package/dist/containers/table/table-parts.js +52 -0
  187. package/dist/containers/table/table.d.ts +37 -3
  188. package/dist/containers/table/table.js +120 -19
  189. package/dist/containers/table-columns-menu/index.d.ts +1 -0
  190. package/dist/containers/table-columns-menu/index.js +6 -0
  191. package/dist/containers/table-columns-menu/table-columns-menu.d.ts +14 -0
  192. package/dist/containers/table-columns-menu/table-columns-menu.js +46 -0
  193. package/dist/dashboards/layout.d.ts +1 -27
  194. package/dist/dashboards/layout.js +8 -40
  195. package/dist/forms/chip-group/chip-group.d.ts +5 -0
  196. package/dist/forms/chip-group/chip-group.js +3 -1
  197. package/dist/forms/combobox/combobox.js +1 -1
  198. package/dist/forms/copy-field/copy-field.js +1 -1
  199. package/dist/forms/date-picker/date-picker.d.ts +3 -1
  200. package/dist/forms/date-picker/date-picker.js +4 -2
  201. package/dist/forms/date-picker/date-time-picker.d.ts +8 -2
  202. package/dist/forms/date-picker/date-time-picker.js +13 -2
  203. package/dist/forms/field/field.d.ts +9 -2
  204. package/dist/forms/field/field.js +18 -4
  205. package/dist/forms/fieldset/fieldset.d.ts +11 -0
  206. package/dist/forms/fieldset/fieldset.js +12 -0
  207. package/dist/forms/fieldset/index.d.ts +1 -0
  208. package/dist/forms/fieldset/index.js +4 -0
  209. package/dist/forms/form-footer/form-footer.d.ts +26 -0
  210. package/dist/forms/form-footer/form-footer.js +44 -0
  211. package/dist/forms/form-footer/index.d.ts +1 -0
  212. package/dist/forms/form-footer/index.js +4 -0
  213. package/dist/forms/form-grid/form-grid.d.ts +21 -4
  214. package/dist/forms/form-grid/form-grid.js +20 -3
  215. package/dist/forms/form-grid/index.d.ts +1 -1
  216. package/dist/forms/form-grid/index.js +6 -2
  217. package/dist/forms/form-section/form-section.d.ts +12 -0
  218. package/dist/forms/form-section/form-section.js +30 -0
  219. package/dist/forms/form-section/index.d.ts +1 -0
  220. package/dist/forms/form-section/index.js +4 -0
  221. package/dist/forms/index.d.ts +4 -0
  222. package/dist/forms/index.js +4 -0
  223. package/dist/forms/input/input.d.ts +6 -2
  224. package/dist/forms/input/input.js +6 -2
  225. package/dist/forms/internal/listbox-items.d.ts +1 -1
  226. package/dist/forms/internal/listbox-items.js +3 -2
  227. package/dist/forms/native-select/native-select.js +1 -1
  228. package/dist/forms/password-input/index.d.ts +1 -0
  229. package/dist/forms/password-input/index.js +1 -0
  230. package/dist/forms/password-input/password-input.d.ts +16 -0
  231. package/dist/forms/password-input/password-input.js +45 -0
  232. package/dist/forms/select/index.d.ts +1 -1
  233. package/dist/forms/select/select.d.ts +5 -2
  234. package/dist/forms/select/select.js +7 -2
  235. package/dist/forms/select-menu/select-menu.js +1 -1
  236. package/dist/forms/time-input/time-input.d.ts +4 -2
  237. package/dist/forms/time-input/time-input.js +3 -1
  238. package/dist/i18n/strings.d.ts +150 -0
  239. package/dist/i18n/strings.js +80 -2
  240. package/dist/icons/eye.d.ts +2 -0
  241. package/dist/icons/eye.js +11 -0
  242. package/dist/icons/graduation-cap.d.ts +2 -0
  243. package/dist/icons/graduation-cap.js +12 -0
  244. package/dist/icons/house.d.ts +2 -0
  245. package/dist/icons/house.js +11 -0
  246. package/dist/icons/index.d.ts +4 -0
  247. package/dist/icons/index.js +8 -0
  248. package/dist/icons/mail.d.ts +2 -0
  249. package/dist/icons/mail.js +11 -0
  250. package/dist/motion/count-up.d.ts +20 -0
  251. package/dist/motion/count-up.js +59 -0
  252. package/dist/motion/cross-fade.d.ts +21 -0
  253. package/dist/motion/cross-fade.js +86 -0
  254. package/dist/motion/index.d.ts +5 -0
  255. package/dist/motion/index.js +14 -0
  256. package/dist/motion/model.d.ts +15 -0
  257. package/dist/motion/model.js +68 -0
  258. package/dist/motion/motion-styles.d.ts +1 -0
  259. package/dist/motion/motion-styles.js +35 -0
  260. package/dist/motion/reveal.d.ts +37 -0
  261. package/dist/motion/reveal.js +69 -0
  262. package/dist/motion/use-enter-phase.d.ts +11 -0
  263. package/dist/motion/use-enter-phase.js +40 -0
  264. package/dist/motion/use-highlight-row.d.ts +22 -0
  265. package/dist/motion/use-highlight-row.js +38 -0
  266. package/dist/navigation/tabs/tabs.js +1 -1
  267. package/dist/navigation/wizard/wizard.d.ts +4 -1
  268. package/dist/navigation/wizard/wizard.js +3 -0
  269. package/dist/overlays/alert-dialog/alert-dialog.js +8 -1
  270. package/dist/overlays/context-menu/context-menu.js +3 -1
  271. package/dist/overlays/dialog/dialog.js +10 -2
  272. package/dist/overlays/drawer/drawer.d.ts +18 -4
  273. package/dist/overlays/drawer/drawer.js +53 -4
  274. package/dist/overlays/drawer/index.d.ts +1 -1
  275. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +1 -1
  276. package/dist/overlays/dropdown-menu/dropdown-menu.js +5 -4
  277. package/dist/overlays/hover-card/hover-card.js +2 -0
  278. package/dist/overlays/popover/popover.js +2 -0
  279. package/dist/overlays/toaster/index.d.ts +1 -1
  280. package/dist/overlays/toaster/toaster.d.ts +28 -2
  281. package/dist/overlays/toaster/toaster.js +73 -29
  282. package/dist/overlays/tooltip/tooltip.js +2 -0
  283. package/dist/primitives/use-presence.js +9 -0
  284. package/dist/shell/app-shell/app-shell.d.ts +8 -1
  285. package/dist/shell/app-shell/app-shell.js +50 -3
  286. package/dist/shell/index.d.ts +1 -0
  287. package/dist/shell/index.js +1 -0
  288. package/dist/shell/sidebar/sidebar.d.ts +17 -1
  289. package/dist/shell/sidebar/sidebar.js +126 -76
  290. package/dist/shell/topbar/topbar.d.ts +4 -2
  291. package/dist/shell/topbar/topbar.js +2 -0
  292. package/dist/showcase/operations-bento.js +2 -2
  293. package/dist/states/empty-state/empty-state.d.ts +10 -3
  294. package/dist/states/empty-state/empty-state.js +46 -5
  295. package/dist/states/error-state/error-state.js +1 -1
  296. package/dist/states/skeleton/skeleton.js +1 -1
  297. package/dist/utils/class-tokens.generated.js +4 -6
  298. package/dist/utils/list-navigation.d.ts +14 -0
  299. package/dist/utils/list-navigation.js +44 -0
  300. package/dist/utils/overlay-motion.d.ts +12 -0
  301. package/dist/utils/overlay-motion.js +14 -0
  302. package/dist/utils/use-container-width.d.ts +6 -0
  303. package/dist/utils/use-container-width.js +19 -0
  304. package/icons/svg/eye.svg +4 -0
  305. package/icons/svg/graduation-cap.svg +5 -0
  306. package/icons/svg/house.svg +4 -0
  307. package/icons/svg/mail.svg +4 -0
  308. package/package.json +2 -2
  309. package/scripts/build-theme.mjs +46 -5
  310. package/src/ai/code-block/code-block.tsx +1 -1
  311. package/src/atoms/big-date/big-date.tsx +2 -2
  312. package/src/atoms/button/button.tsx +33 -6
  313. package/src/atoms/chip/chip.tsx +8 -3
  314. package/src/atoms/divider/divider.tsx +40 -0
  315. package/src/atoms/divider/index.ts +1 -0
  316. package/src/atoms/icon-button/icon-button.tsx +2 -2
  317. package/src/atoms/index.ts +1 -0
  318. package/src/atoms/internal/hit-area.ts +5 -4
  319. package/src/atoms/progress/index.ts +8 -1
  320. package/src/atoms/progress/progress.tsx +30 -1
  321. package/src/atoms/radio-group/radio-group.tsx +1 -1
  322. package/src/atoms/status-pill/status-pill.tsx +59 -18
  323. package/src/auth/auth-illustration/auth-illustration.tsx +100 -0
  324. package/src/auth/auth-illustration/index.ts +8 -0
  325. package/src/auth/auth-illustration/look.ts +32 -0
  326. package/src/auth/auth-illustration/model.ts +330 -0
  327. package/src/auth/auth-illustration/use-art-pointer.ts +78 -0
  328. package/src/auth/auth-layout/auth-layout.tsx +282 -0
  329. package/src/auth/auth-layout/index.ts +1 -0
  330. package/src/auth/character/character.tsx +346 -0
  331. package/src/auth/character/index.ts +1 -0
  332. package/src/auth/index.ts +4 -0
  333. package/src/auth/internal/auth-context.ts +26 -0
  334. package/src/auth/internal/auth-styles.tsx +39 -0
  335. package/src/auth/internal/portal-glyphs.tsx +32 -0
  336. package/src/auth/login-form/context.ts +78 -0
  337. package/src/auth/login-form/index.ts +21 -0
  338. package/src/auth/login-form/login-form.tsx +330 -0
  339. package/src/auth/login-form/parts.tsx +457 -0
  340. package/src/auth/looks/auth-illustration-any.tsx +38 -0
  341. package/src/auth/looks/index.ts +1 -0
  342. package/src/auth/mosaic/index.ts +1 -0
  343. package/src/auth/mosaic/mosaic.tsx +255 -0
  344. package/src/auth/slabs/index.ts +1 -0
  345. package/src/auth/slabs/slabs.tsx +181 -0
  346. package/src/auth/stack/index.ts +1 -0
  347. package/src/auth/stack/stack.tsx +267 -0
  348. package/src/auth/statement/index.ts +1 -0
  349. package/src/auth/statement/statement.tsx +122 -0
  350. package/src/brand/logo-forge.tsx +1 -1
  351. package/src/charts/candlestick-chart/candlestick-chart.tsx +2 -2
  352. package/src/charts/chart-grid/chart-grid.tsx +2 -2
  353. package/src/charts/chord-chart/chord-chart.tsx +1 -1
  354. package/src/charts/core/axes.tsx +2 -2
  355. package/src/charts/core/cartesian/annotations.tsx +2 -2
  356. package/src/charts/core/cartesian/marks.tsx +1 -1
  357. package/src/charts/core/distribution/marks.tsx +1 -1
  358. package/src/charts/core/distribution/xy-points.tsx +1 -1
  359. package/src/charts/core/export-menu.tsx +1 -1
  360. package/src/charts/funnel-chart/funnel-chart.tsx +1 -1
  361. package/src/charts/gantt-chart/gantt-chart.tsx +4 -4
  362. package/src/charts/gantt-chart/gantt-marks.tsx +3 -3
  363. package/src/charts/index.ts +2 -0
  364. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  365. package/src/charts/polar-area-chart/polar-area-chart.tsx +1 -1
  366. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  367. package/src/charts/stock-chart/stock-chart.tsx +1 -1
  368. package/src/charts/stock-chart/stock-drawing-layer.tsx +3 -3
  369. package/src/charts/stock-chart/stock-plot.tsx +2 -2
  370. package/src/containers/chat-thread/chat-thread.tsx +331 -0
  371. package/src/containers/chat-thread/format.ts +67 -0
  372. package/src/containers/chat-thread/index.ts +12 -0
  373. package/src/containers/cols/cols.tsx +13 -1
  374. package/src/containers/comment/comment.tsx +1 -1
  375. package/src/containers/context-rail/context-rail.tsx +229 -0
  376. package/src/containers/context-rail/index.ts +7 -0
  377. package/src/containers/dashboard/dashboard.tsx +142 -0
  378. package/src/containers/dashboard/index.ts +12 -0
  379. package/src/containers/data-grid/data-grid.demos.tsx +4 -4
  380. package/src/containers/data-grid/data-grid.tsx +6 -6
  381. package/src/containers/data-grid/filter-builder-editor.tsx +2 -2
  382. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  383. package/src/containers/data-grid/spreadsheet.demos.tsx +1 -1
  384. package/src/containers/detail-header/detail-header.tsx +64 -0
  385. package/src/containers/detail-header/index.ts +5 -0
  386. package/src/containers/facts/facts.tsx +1 -1
  387. package/src/containers/filter-bar/filter-bar.tsx +201 -0
  388. package/src/containers/filter-bar/index.ts +7 -0
  389. package/src/containers/hbars/hbars.tsx +2 -2
  390. package/src/containers/index.ts +9 -0
  391. package/src/containers/kanban/kanban.tsx +146 -39
  392. package/src/containers/kanban/model.ts +20 -0
  393. package/src/containers/kpi/kpi.tsx +1 -1
  394. package/src/containers/kpi-group/kpi-group.tsx +17 -2
  395. package/src/containers/list-detail/index.ts +5 -0
  396. package/src/containers/list-detail/list-detail.tsx +157 -9
  397. package/src/containers/page/page.tsx +61 -7
  398. package/src/containers/page-header/back.tsx +42 -0
  399. package/src/containers/page-header/index.ts +1 -0
  400. package/src/containers/page-header/page-header.tsx +49 -3
  401. package/src/containers/pagination/cursor-pagination.tsx +79 -0
  402. package/src/containers/pagination/index.ts +7 -0
  403. package/src/containers/pagination/pagination.tsx +266 -0
  404. package/src/containers/pagination/range.ts +68 -0
  405. package/src/containers/pagination/use-pagination.ts +44 -0
  406. package/src/containers/responsive-list/responsive-list.tsx +183 -46
  407. package/src/containers/row-actions/index.ts +1 -0
  408. package/src/containers/row-actions/row-actions.tsx +114 -0
  409. package/src/containers/selectable-card/index.ts +5 -0
  410. package/src/containers/selectable-card/selectable-card.tsx +84 -0
  411. package/src/containers/settings-layout/settings-layout.tsx +104 -13
  412. package/src/containers/shortcuts/shortcuts.tsx +1 -1
  413. package/src/containers/table/cell-padding.ts +2 -0
  414. package/src/containers/table/index.ts +6 -0
  415. package/src/containers/table/sort.ts +23 -0
  416. package/src/containers/table/table-parts.tsx +81 -0
  417. package/src/containers/table/table.tsx +212 -45
  418. package/src/containers/table-columns-menu/index.ts +5 -0
  419. package/src/containers/table-columns-menu/table-columns-menu.tsx +68 -0
  420. package/src/dashboards/layout.tsx +8 -75
  421. package/src/forms/chip-group/chip-group.tsx +8 -1
  422. package/src/forms/combobox/combobox.tsx +1 -1
  423. package/src/forms/copy-field/copy-field.tsx +1 -1
  424. package/src/forms/date-picker/date-picker.tsx +7 -2
  425. package/src/forms/date-picker/date-time-picker.tsx +28 -2
  426. package/src/forms/field/field.tsx +30 -3
  427. package/src/forms/fieldset/fieldset.tsx +22 -0
  428. package/src/forms/fieldset/index.ts +1 -0
  429. package/src/forms/form-footer/form-footer.tsx +74 -0
  430. package/src/forms/form-footer/index.ts +1 -0
  431. package/src/forms/form-grid/form-grid.tsx +42 -5
  432. package/src/forms/form-grid/index.ts +8 -1
  433. package/src/forms/form-section/form-section.tsx +41 -0
  434. package/src/forms/form-section/index.ts +1 -0
  435. package/src/forms/index.ts +4 -0
  436. package/src/forms/input/input.tsx +12 -3
  437. package/src/forms/internal/listbox-items.tsx +3 -4
  438. package/src/forms/native-select/native-select.tsx +1 -1
  439. package/src/forms/password-input/index.ts +1 -0
  440. package/src/forms/password-input/password-input.tsx +57 -0
  441. package/src/forms/select/index.ts +1 -1
  442. package/src/forms/select/select.tsx +14 -3
  443. package/src/forms/select-menu/select-menu.tsx +1 -1
  444. package/src/forms/time-input/time-input.tsx +6 -2
  445. package/src/i18n/strings.ts +150 -0
  446. package/src/icons/eye.tsx +12 -0
  447. package/src/icons/graduation-cap.tsx +13 -0
  448. package/src/icons/house.tsx +12 -0
  449. package/src/icons/index.ts +4 -0
  450. package/src/icons/mail.tsx +12 -0
  451. package/src/motion/count-up.tsx +83 -0
  452. package/src/motion/cross-fade.tsx +139 -0
  453. package/src/motion/index.ts +5 -0
  454. package/src/motion/model.ts +86 -0
  455. package/src/motion/motion-styles.tsx +47 -0
  456. package/src/motion/reveal.tsx +115 -0
  457. package/src/motion/use-enter-phase.ts +50 -0
  458. package/src/motion/use-highlight-row.ts +63 -0
  459. package/src/navigation/tabs/tabs.tsx +1 -1
  460. package/src/navigation/wizard/wizard.tsx +6 -1
  461. package/src/overlays/alert-dialog/alert-dialog.tsx +5 -1
  462. package/src/overlays/context-menu/context-menu.tsx +3 -2
  463. package/src/overlays/dialog/dialog.tsx +7 -2
  464. package/src/overlays/drawer/drawer.tsx +68 -6
  465. package/src/overlays/drawer/index.ts +1 -0
  466. package/src/overlays/dropdown-menu/dropdown-menu.tsx +5 -4
  467. package/src/overlays/hover-card/hover-card.tsx +2 -0
  468. package/src/overlays/popover/popover.tsx +2 -0
  469. package/src/overlays/toaster/index.ts +2 -0
  470. package/src/overlays/toaster/toaster.tsx +113 -17
  471. package/src/overlays/tooltip/tooltip.tsx +2 -0
  472. package/src/primitives/use-presence.ts +13 -0
  473. package/src/shell/app-shell/app-shell.tsx +54 -2
  474. package/src/shell/index.ts +1 -0
  475. package/src/shell/sidebar/sidebar.tsx +154 -75
  476. package/src/shell/topbar/topbar.tsx +8 -0
  477. package/src/showcase/operations-bento.tsx +2 -2
  478. package/src/states/empty-state/empty-state.tsx +52 -9
  479. package/src/states/error-state/error-state.tsx +1 -1
  480. package/src/states/skeleton/skeleton.tsx +1 -1
  481. package/src/utils/class-tokens.generated.ts +4 -6
  482. package/src/utils/list-navigation.ts +63 -0
  483. package/src/utils/overlay-motion.ts +33 -0
  484. package/src/utils/use-container-width.ts +24 -0
  485. package/styles/Theme.kt +15 -18
  486. package/styles/tailwind.css +29 -28
  487. package/styles/theme.css +29 -28
  488. package/styles/tokens.css +46 -0
  489. package/tokens/default.json +51 -29
@@ -1,11 +1,40 @@
1
- import { jsx } from "react/jsx-runtime";
1
+ import { jsx, jsxs } from "react/jsx-runtime";
2
2
  import { cn } from "../../utils/cn.js";
3
- function Page({ className, ...props }) {
3
+ const CONTENT = "flex w-full min-w-0 flex-col gap-6";
4
+ function Page({
5
+ aside,
6
+ asideWidth,
7
+ asideSticky = false,
8
+ className,
9
+ style,
10
+ children,
11
+ ...props
12
+ }) {
13
+ if (aside === void 0) {
14
+ return /* @__PURE__ */ jsx("div", { className: cn("@container/page", CONTENT, className), style, ...props, children });
15
+ }
16
+ const width = asideWidth === void 0 ? void 0 : typeof asideWidth === "number" ? `${asideWidth}px` : asideWidth;
4
17
  return /* @__PURE__ */ jsx(
5
18
  "div",
6
19
  {
7
- className: cn("@container/page flex w-full min-w-0 flex-col gap-6", className),
8
- ...props
20
+ "data-page-aside": "",
21
+ className: "@container/page w-full min-w-0",
22
+ style: width === void 0 ? void 0 : { "--page-aside-width": width },
23
+ children: /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-[minmax(0,1fr)_var(--page-aside-width,20rem)] items-start @max-[1000px]/page:grid-cols-[minmax(0,1fr)]", children: [
24
+ /* @__PURE__ */ jsx("div", { className: cn(CONTENT, className), style, ...props, children }),
25
+ /* @__PURE__ */ jsx(
26
+ "div",
27
+ {
28
+ "data-page-rail": "",
29
+ className: cn(
30
+ "flex min-w-0 flex-col self-stretch border-l-divider bg-surface",
31
+ "@max-[1000px]/page:border-t-divider @max-[1000px]/page:border-l-0",
32
+ asideSticky && "@min-[1001px]/page:sticky @min-[1001px]/page:top-0 @min-[1001px]/page:max-h-dvh @min-[1001px]/page:self-start @min-[1001px]/page:overflow-y-auto"
33
+ ),
34
+ children: aside
35
+ }
36
+ )
37
+ ] })
9
38
  }
10
39
  );
11
40
  }
@@ -0,0 +1,10 @@
1
+ import type { ComponentPropsWithoutRef } from "react";
2
+ export interface PageHeaderBackProps extends ComponentPropsWithoutRef<"a"> {
3
+ /** Renders the single child element (a router `Link`) with the link's look. The child supplies the label. */
4
+ asChild?: boolean | undefined;
5
+ }
6
+ /**
7
+ * The way back to the parent screen, for `PageHeader`'s `back` slot. A real link: pass `href`, or
8
+ * `asChild` with your router's `Link`. The label defaults to the localized "Back".
9
+ */
10
+ export declare function PageHeaderBack({ asChild, className, children, ...props }: PageHeaderBackProps): import("react").JSX.Element;
@@ -0,0 +1,28 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { useUiStrings } from "../../i18n/index.js";
4
+ import { ChevronLeft } from "../../icons/index.js";
5
+ import { cn } from "../../utils/cn.js";
6
+ import { Slot } from "../../utils/slot.js";
7
+ function PageHeaderBack({
8
+ asChild = false,
9
+ className,
10
+ children,
11
+ ...props
12
+ }) {
13
+ const strings = useUiStrings();
14
+ const classes = cn(
15
+ "inline-flex min-h-8 items-center gap-1 text-control text-ink-2 no-underline hover:text-ink focus-visible:focus-ring",
16
+ className
17
+ );
18
+ if (asChild) {
19
+ return /* @__PURE__ */ jsx(Slot, { ...props, className: classes, children });
20
+ }
21
+ return /* @__PURE__ */ jsxs("a", { ...props, className: classes, children: [
22
+ /* @__PURE__ */ jsx(ChevronLeft, { "aria-hidden": "true", className: "size-4" }),
23
+ children ?? strings.back
24
+ ] });
25
+ }
26
+ export {
27
+ PageHeaderBack
28
+ };
@@ -1 +1,2 @@
1
+ export * from "./back.js";
1
2
  export * from "./page-header.js";
@@ -1 +1,2 @@
1
+ export * from "./back.js";
1
2
  export * from "./page-header.js";
@@ -4,13 +4,30 @@ export interface PageHeaderProps extends ComponentPropsWithoutRef<"header"> {
4
4
  breadcrumbs?: ReactNode;
5
5
  /** Tighter, centred header with a smaller title and a body-size lede. */
6
6
  compact?: boolean;
7
+ /** Link to the parent screen on its own row above the title: a `PageHeaderBack`. Shown before `breadcrumbs`. */
8
+ back?: ReactNode;
9
+ /** Row under the title block for status chips and short facts. Wraps; never needs a container query. */
10
+ meta?: ReactNode;
11
+ /**
12
+ * Sub-navigation under the title, full width: a `TabsNav` (route tabs) or a `Tabs` list. The
13
+ * strip carries its own bottom divider, so it closes the header.
14
+ */
15
+ tabs?: ReactNode;
16
+ /**
17
+ * Keeps the whole header, tabs included, at the top of its scroll container with an opaque page
18
+ * background. The navigation inside stays reachable while the page scrolls.
19
+ */
20
+ sticky?: boolean;
21
+ /** Distance a sticky header keeps from the top of its scroll container (number = pixels). Default `0`. */
22
+ stickyOffset?: number | string;
7
23
  }
8
24
  /**
9
25
  * Page header. No required parts: compose an eyebrow / title / lede block in
10
26
  * a plain `<div>` and, when the view has buttons, `PageHeaderActions` as the
11
- * second child. Actions wrap under the title when the container is too narrow.
27
+ * second child. Actions wrap under the title when the container is too narrow. `back`,
28
+ * `breadcrumbs`, `meta` and `tabs` each take a full-width row around the children.
12
29
  */
13
- export declare function PageHeader({ breadcrumbs, className, compact, children, ...props }: PageHeaderProps): import("react").JSX.Element;
30
+ export declare function PageHeader({ breadcrumbs, back, meta, tabs, sticky, stickyOffset, className, compact, style, children, ...props }: PageHeaderProps): import("react").JSX.Element;
14
31
  export type PageHeaderEyebrowProps = ComponentPropsWithoutRef<"div">;
15
32
  export declare function PageHeaderEyebrow({ className, ...props }: PageHeaderEyebrowProps): import("react").JSX.Element;
16
33
  export type PageHeaderTitleProps = ComponentPropsWithoutRef<"h1">;
@@ -2,8 +2,14 @@ import { jsx, jsxs } from "react/jsx-runtime";
2
2
  import { cn } from "../../utils/cn.js";
3
3
  function PageHeader({
4
4
  breadcrumbs,
5
+ back,
6
+ meta,
7
+ tabs,
8
+ sticky,
9
+ stickyOffset,
5
10
  className,
6
11
  compact,
12
+ style,
7
13
  children,
8
14
  ...props
9
15
  }) {
@@ -11,15 +17,33 @@ function PageHeader({
11
17
  "header",
12
18
  {
13
19
  "data-compact": compact ? "" : void 0,
20
+ "data-sticky": sticky ? "" : void 0,
14
21
  className: cn(
15
22
  "flex flex-wrap items-end justify-between gap-x-6 gap-y-3.5",
16
23
  compact && "flex-col items-center justify-center gap-y-2 text-center",
24
+ sticky && "sticky top-(--page-header-top,0px) z-10 bg-surface",
17
25
  className
18
26
  ),
27
+ style: stickyOffset === void 0 ? style : {
28
+ ...style,
29
+ "--page-header-top": typeof stickyOffset === "number" ? `${stickyOffset}px` : stickyOffset
30
+ },
19
31
  ...props,
20
32
  children: [
33
+ back ? /* @__PURE__ */ jsx("div", { className: "basis-full", children: back }) : null,
21
34
  breadcrumbs ? /* @__PURE__ */ jsx("div", { className: "basis-full", children: breadcrumbs }) : null,
22
- children
35
+ children,
36
+ meta ? /* @__PURE__ */ jsx(
37
+ "div",
38
+ {
39
+ className: cn(
40
+ "flex basis-full flex-wrap items-center gap-x-3 gap-y-1.5 text-ink-2 text-meta",
41
+ compact && "justify-center"
42
+ ),
43
+ children: meta
44
+ }
45
+ ) : null,
46
+ tabs ? /* @__PURE__ */ jsx("div", { className: "basis-full", children: tabs }) : null
23
47
  ]
24
48
  }
25
49
  );
@@ -38,7 +62,7 @@ function PageHeaderTitle({ className, ...props }) {
38
62
  "h1",
39
63
  {
40
64
  className: cn(
41
- "m-0 break-words text-page-title [text-wrap:balance] in-data-compact:text-fs-220",
65
+ "m-0 break-words text-page-title [text-wrap:balance] in-data-compact:text-fs-200",
42
66
  className
43
67
  ),
44
68
  ...props
@@ -0,0 +1,28 @@
1
+ import { type ComponentPropsWithoutRef } from "react";
2
+ export interface CursorPaginationLabels {
3
+ nav: string;
4
+ /** `{first}` and `{last}` are replaced. */
5
+ range: string;
6
+ previous: string;
7
+ next: string;
8
+ }
9
+ export interface CursorPaginationProps extends Omit<ComponentPropsWithoutRef<"nav">, "children" | "onChange"> {
10
+ /** 1-based page the cursor trail is on. */
11
+ page: number;
12
+ /** Rows on this page. */
13
+ count: number;
14
+ /** Rows per page, to number the range. Default 25. */
15
+ pageSize?: number;
16
+ /** Whether the server reported a next cursor. */
17
+ hasNext: boolean;
18
+ onPrevious: () => void;
19
+ onNext: () => void;
20
+ /** Texts (localized by default through `UiStrings`). */
21
+ labels?: Partial<CursorPaginationLabels>;
22
+ }
23
+ /**
24
+ * Footer for server-side cursor paging, where the total is unknown: the range on screen ("Showing
25
+ * 26–50") and Previous / Next. Keep the cursor trail yourself; this only reports the clicks. It
26
+ * renders nothing while the whole list fits on the first page.
27
+ */
28
+ export declare function CursorPagination({ page, count, pageSize, hasNext, onPrevious, onNext, labels, className, ...props }: CursorPaginationProps): import("react").JSX.Element | null;
@@ -0,0 +1,48 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { useMemo } from "react";
4
+ import { Button } from "../../atoms/button/button.js";
5
+ import { useUiStrings } from "../../i18n/index.js";
6
+ import { cn } from "../../utils/cn.js";
7
+ import { formatRange } from "./range.js";
8
+ function CursorPagination({
9
+ page,
10
+ count,
11
+ pageSize = 25,
12
+ hasNext,
13
+ onPrevious,
14
+ onNext,
15
+ labels,
16
+ className,
17
+ ...props
18
+ }) {
19
+ const strings = useUiStrings();
20
+ const format = useMemo(() => new Intl.NumberFormat(strings.locale), [strings.locale]);
21
+ if (page <= 1 && !hasNext) return null;
22
+ const first = (Math.max(1, page) - 1) * pageSize + 1;
23
+ const last = first + Math.max(count, 1) - 1;
24
+ return /* @__PURE__ */ jsxs(
25
+ "nav",
26
+ {
27
+ "aria-label": labels?.nav ?? strings.pagination,
28
+ className: cn(
29
+ "flex min-w-0 flex-wrap items-center justify-between gap-x-4 gap-y-2 py-2 text-fs-120 text-ink-2",
30
+ className
31
+ ),
32
+ ...props,
33
+ children: [
34
+ /* @__PURE__ */ jsx("span", { "aria-live": "polite", className: "tabular-nums", children: formatRange(labels?.range ?? strings.showingRangeOpen, {
35
+ first: format.format(first),
36
+ last: format.format(last)
37
+ }) }),
38
+ /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-1", children: [
39
+ /* @__PURE__ */ jsx(Button, { size: "sm", disabled: page <= 1, onClick: onPrevious, children: labels?.previous ?? strings.previous }),
40
+ /* @__PURE__ */ jsx(Button, { size: "sm", disabled: !hasNext, onClick: onNext, children: labels?.next ?? strings.next })
41
+ ] })
42
+ ]
43
+ }
44
+ );
45
+ }
46
+ export {
47
+ CursorPagination
48
+ };
@@ -0,0 +1,3 @@
1
+ export { CursorPagination, type CursorPaginationLabels, type CursorPaginationProps, } from "./cursor-pagination.js";
2
+ export { Pagination, type PaginationLabels, type PaginationProps } from "./pagination.js";
3
+ export { type PaginationState, usePagination } from "./use-pagination.js";
@@ -0,0 +1,10 @@
1
+ import {
2
+ CursorPagination
3
+ } from "./cursor-pagination.js";
4
+ import { Pagination } from "./pagination.js";
5
+ import { usePagination } from "./use-pagination.js";
6
+ export {
7
+ CursorPagination,
8
+ Pagination,
9
+ usePagination
10
+ };
@@ -0,0 +1,52 @@
1
+ import { type ComponentPropsWithoutRef } from "react";
2
+ export { clampPage, formatPageRange, formatRange, type PageItem, pageCount, pageItems, pageRange, } from "./range.js";
3
+ export interface PaginationLabels {
4
+ nav: string;
5
+ rowsPerPage: string;
6
+ /** `{first}`, `{last}` and `{total}` are replaced. */
7
+ range: string;
8
+ first: string;
9
+ previous: string;
10
+ next: string;
11
+ last: string;
12
+ /** Range text of the `pages` variant; `{first}`, `{last}` and `{total}` are replaced. */
13
+ showing: string;
14
+ /** Visible label of the previous button of the `pages` variant. */
15
+ previousLabel: string;
16
+ /** Visible label of the next button of the `pages` variant. */
17
+ nextLabel: string;
18
+ /** Name of a page number button; `{page}` is replaced. */
19
+ pageNumber: string;
20
+ }
21
+ export interface PaginationProps extends Omit<ComponentPropsWithoutRef<"nav">, "onChange"> {
22
+ /** Total rows across every page. */
23
+ total: number;
24
+ /** Controlled 1-based page. Pair it with `onPageChange`. */
25
+ page?: number;
26
+ /** Initial page when uncontrolled. Default 1. */
27
+ defaultPage?: number;
28
+ onPageChange?: (page: number) => void;
29
+ /** Controlled rows per page. Pair it with `onPageSizeChange`. */
30
+ pageSize?: number;
31
+ /** Initial rows per page when uncontrolled. Default: the first of `pageSizeOptions`. */
32
+ defaultPageSize?: number;
33
+ onPageSizeChange?: (pageSize: number) => void;
34
+ /** Choices of the page size picker. Default `[10, 25, 50, 100]`; a single option hides the picker. */
35
+ pageSizeOptions?: readonly number[];
36
+ /** Texts (localized by default through `UiStrings`). */
37
+ labels?: Partial<PaginationLabels>;
38
+ /**
39
+ * `default`: rows per page, the range and first/previous/next/last icon buttons. `pages`: the
40
+ * range ("Showing 1–25 of 134") and Previous, page number and Next buttons; it shows the page size
41
+ * picker only when `pageSizeOptions` is passed with more than one option.
42
+ */
43
+ variant?: "default" | "pages";
44
+ /** Renders nothing while every row fits on one page. Default `true` for `pages`, `false` otherwise. */
45
+ hideOnSinglePage?: boolean;
46
+ }
47
+ /**
48
+ * Footer of a list or table: rows per page, the range shown ("11–20 of 134") and first, previous,
49
+ * next and last buttons. Pages are 1-based. It does not slice your rows: use `page` and `pageSize`
50
+ * to do that, or to request the page from your API. Changing the page size returns to page 1.
51
+ */
52
+ export declare function Pagination({ total, page, defaultPage, onPageChange, pageSize, defaultPageSize, onPageSizeChange, pageSizeOptions: pageSizeOptionsProp, labels, variant, hideOnSinglePage, className, ...props }: PaginationProps): import("react").JSX.Element | null;
@@ -0,0 +1,216 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { 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
+ import {
18
+ clampPage as clampPage2,
19
+ formatPageRange as formatPageRange2,
20
+ formatRange as formatRange2,
21
+ pageCount as pageCount2,
22
+ pageItems as pageItems2,
23
+ pageRange as pageRange2
24
+ } from "./range.js";
25
+ const DEFAULT_OPTIONS = [10, 25, 50, 100];
26
+ const stepButton = "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";
27
+ function Pagination({
28
+ total,
29
+ page,
30
+ defaultPage = 1,
31
+ onPageChange,
32
+ pageSize,
33
+ defaultPageSize,
34
+ onPageSizeChange,
35
+ pageSizeOptions: pageSizeOptionsProp,
36
+ labels,
37
+ variant = "default",
38
+ hideOnSinglePage = variant === "pages",
39
+ className,
40
+ ...props
41
+ }) {
42
+ const pageSizeOptions = pageSizeOptionsProp ?? DEFAULT_OPTIONS;
43
+ const strings = useUiStrings();
44
+ const selectId = useId();
45
+ const [size, setSize] = useControllableState({
46
+ prop: pageSize,
47
+ defaultProp: defaultPageSize ?? pageSizeOptions[0] ?? DEFAULT_OPTIONS[0],
48
+ onChange: onPageSizeChange
49
+ });
50
+ const [current, setPage] = useControllableState({
51
+ prop: page,
52
+ defaultProp: defaultPage,
53
+ onChange: onPageChange
54
+ });
55
+ const text = {
56
+ nav: labels?.nav ?? strings.pagination,
57
+ rowsPerPage: labels?.rowsPerPage ?? strings.rowsPerPage,
58
+ range: labels?.range ?? strings.pageRange,
59
+ first: labels?.first ?? strings.firstPage,
60
+ previous: labels?.previous ?? strings.previousPage,
61
+ next: labels?.next ?? strings.nextPage,
62
+ last: labels?.last ?? strings.lastPage,
63
+ showing: labels?.showing ?? strings.showingRange,
64
+ previousLabel: labels?.previousLabel ?? strings.previous,
65
+ nextLabel: labels?.nextLabel ?? strings.next,
66
+ pageNumber: labels?.pageNumber ?? strings.pageNumber
67
+ };
68
+ const pages = pageCount(total, size);
69
+ const at = clampPage(current, pages);
70
+ const { first, last } = pageRange(at, size, total);
71
+ const format = useMemo(() => new Intl.NumberFormat(strings.locale), [strings.locale]);
72
+ const sizes = [.../* @__PURE__ */ new Set([...pageSizeOptions, size])].sort((a, b) => a - b);
73
+ const atStart = at <= 1;
74
+ const atEnd = at >= pages;
75
+ if (hideOnSinglePage && pages <= 1) return null;
76
+ const picker = sizes.length > 1 && (variant === "default" || pageSizeOptionsProp !== void 0) ? /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-2", children: [
77
+ /* @__PURE__ */ jsx("label", { htmlFor: selectId, children: text.rowsPerPage }),
78
+ /* @__PURE__ */ jsx(
79
+ "select",
80
+ {
81
+ id: selectId,
82
+ value: size,
83
+ onChange: (event) => {
84
+ setSize(Number(event.target.value));
85
+ setPage(1);
86
+ },
87
+ className: "h-control-sm rounded-input border-control bg-surface-control px-1.5 text-fs-120 text-ink",
88
+ children: sizes.map((option) => /* @__PURE__ */ jsx("option", { value: option, children: option }, option))
89
+ }
90
+ )
91
+ ] }) : null;
92
+ if (variant === "pages") {
93
+ return /* @__PURE__ */ jsxs(
94
+ "nav",
95
+ {
96
+ "aria-label": text.nav,
97
+ className: cn(
98
+ "flex min-w-0 flex-wrap items-center justify-between gap-x-4 gap-y-2 py-2 text-fs-120 text-ink-2",
99
+ className
100
+ ),
101
+ ...props,
102
+ children: [
103
+ /* @__PURE__ */ jsx("span", { "aria-live": "polite", className: "tabular-nums", children: formatRange(text.showing, {
104
+ first: format.format(first),
105
+ last: format.format(last),
106
+ total: format.format(Math.max(0, total))
107
+ }) }),
108
+ /* @__PURE__ */ jsxs("span", { className: "flex flex-wrap items-center gap-x-4 gap-y-2", children: [
109
+ picker,
110
+ /* @__PURE__ */ jsxs("span", { className: "flex items-center gap-1", children: [
111
+ /* @__PURE__ */ jsx(Button, { size: "sm", disabled: atStart, onClick: () => setPage(at - 1), children: text.previousLabel }),
112
+ pageItems(at, pages).map(
113
+ (item, index) => item === "gap" ? /* @__PURE__ */ jsx(
114
+ "span",
115
+ {
116
+ "aria-hidden": "true",
117
+ className: "w-6 text-center text-ink-3",
118
+ children: "\u2026"
119
+ },
120
+ `gap-${index}`
121
+ ) : /* @__PURE__ */ jsx(
122
+ Button,
123
+ {
124
+ size: "sm",
125
+ variant: item === at ? "secondary" : "ghost",
126
+ "aria-current": item === at ? "page" : void 0,
127
+ "aria-label": text.pageNumber.replace("{page}", String(item)),
128
+ onClick: () => setPage(item),
129
+ className: "min-w-control-sm px-2 tabular-nums",
130
+ children: format.format(item)
131
+ },
132
+ item
133
+ )
134
+ ),
135
+ /* @__PURE__ */ jsx(Button, { size: "sm", disabled: atEnd, onClick: () => setPage(at + 1), children: text.nextLabel })
136
+ ] })
137
+ ] })
138
+ ]
139
+ }
140
+ );
141
+ }
142
+ return /* @__PURE__ */ jsxs(
143
+ "nav",
144
+ {
145
+ "aria-label": text.nav,
146
+ className: cn(
147
+ "@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",
148
+ className
149
+ ),
150
+ ...props,
151
+ children: [
152
+ picker,
153
+ /* @__PURE__ */ jsx("span", { "aria-live": "polite", className: "tabular-nums", children: formatPageRange(text.range, {
154
+ first: format.format(first),
155
+ last: format.format(last),
156
+ total: format.format(Math.max(0, total))
157
+ }) }),
158
+ /* @__PURE__ */ jsxs("span", { className: "flex items-center", children: [
159
+ /* @__PURE__ */ jsx(
160
+ "button",
161
+ {
162
+ type: "button",
163
+ className: stepButton,
164
+ "aria-label": text.first,
165
+ disabled: atStart,
166
+ onClick: () => setPage(1),
167
+ children: /* @__PURE__ */ jsx(ChevronsLeft, { "aria-hidden": "true" })
168
+ }
169
+ ),
170
+ /* @__PURE__ */ jsx(
171
+ "button",
172
+ {
173
+ type: "button",
174
+ className: stepButton,
175
+ "aria-label": text.previous,
176
+ disabled: atStart,
177
+ onClick: () => setPage(at - 1),
178
+ children: /* @__PURE__ */ jsx(ChevronLeft, { "aria-hidden": "true" })
179
+ }
180
+ ),
181
+ /* @__PURE__ */ jsx(
182
+ "button",
183
+ {
184
+ type: "button",
185
+ className: stepButton,
186
+ "aria-label": text.next,
187
+ disabled: atEnd,
188
+ onClick: () => setPage(at + 1),
189
+ children: /* @__PURE__ */ jsx(ChevronRight, { "aria-hidden": "true" })
190
+ }
191
+ ),
192
+ /* @__PURE__ */ jsx(
193
+ "button",
194
+ {
195
+ type: "button",
196
+ className: stepButton,
197
+ "aria-label": text.last,
198
+ disabled: atEnd,
199
+ onClick: () => setPage(pages),
200
+ children: /* @__PURE__ */ jsx(ChevronsRight, { "aria-hidden": "true" })
201
+ }
202
+ )
203
+ ] })
204
+ ]
205
+ }
206
+ );
207
+ }
208
+ export {
209
+ Pagination,
210
+ clampPage2 as clampPage,
211
+ formatPageRange2 as formatPageRange,
212
+ formatRange2 as formatRange,
213
+ pageCount2 as pageCount,
214
+ pageItems2 as pageItems,
215
+ pageRange2 as pageRange
216
+ };
@@ -0,0 +1,29 @@
1
+ /** Number of pages for `total` rows; at least 1 so an empty list still has a first page. */
2
+ export declare function pageCount(total: number, pageSize: number): number;
3
+ /** Keeps a 1-based page inside `1..pages`. */
4
+ export declare function clampPage(page: number, pages: number): number;
5
+ /** 1-based first and last row shown on `page`; `{ first: 0, last: 0 }` when there are no rows. */
6
+ export declare function pageRange(page: number, pageSize: number, total: number): {
7
+ first: number;
8
+ last: number;
9
+ };
10
+ /** Fills the `{first}`, `{last}` and `{total}` placeholders of the `pageRange` UI string. */
11
+ export declare function formatPageRange(template: string, values: {
12
+ first: string;
13
+ last: string;
14
+ total: string;
15
+ }): string;
16
+ /** A page number button, or a gap between two runs of them. */
17
+ export type PageItem = number | "gap";
18
+ /**
19
+ * The page buttons to show: the first and last page, the current one with `siblings` on each side,
20
+ * and a `"gap"` where pages are left out. A gap never hides a single page (that page shows instead),
21
+ * so the list keeps the same length while the current page moves through the middle.
22
+ */
23
+ export declare function pageItems(page: number, pages: number, siblings?: number): PageItem[];
24
+ /** Fills `{first}` and `{last}` (and `{total}` when given) in a range template. */
25
+ export declare function formatRange(template: string, values: {
26
+ first: string;
27
+ last: string;
28
+ total?: string;
29
+ }): string;
@@ -0,0 +1,42 @@
1
+ function pageCount(total, pageSize) {
2
+ if (pageSize <= 0) return 1;
3
+ return Math.max(1, Math.ceil(Math.max(0, total) / pageSize));
4
+ }
5
+ function clampPage(page, pages) {
6
+ return Math.min(Math.max(1, Math.trunc(page) || 1), pages);
7
+ }
8
+ function pageRange(page, pageSize, total) {
9
+ if (total <= 0 || pageSize <= 0) return { first: 0, last: 0 };
10
+ const current = clampPage(page, pageCount(total, pageSize));
11
+ return { first: (current - 1) * pageSize + 1, last: Math.min(total, current * pageSize) };
12
+ }
13
+ function formatPageRange(template, values) {
14
+ return template.replace("{first}", values.first).replace("{last}", values.last).replace("{total}", values.total);
15
+ }
16
+ function pageItems(page, pages, siblings = 1) {
17
+ const total = Math.max(1, Math.trunc(pages));
18
+ const current = clampPage(page, total);
19
+ const slots = siblings * 2 + 5;
20
+ if (total <= slots) return Array.from({ length: total }, (_, i) => i + 1);
21
+ const start = Math.max(Math.min(current - siblings, total - siblings * 2 - 2), 3);
22
+ const end = Math.min(Math.max(current + siblings, siblings * 2 + 3), total - 2);
23
+ const middle = Array.from({ length: end - start + 1 }, (_, i) => start + i);
24
+ return [
25
+ 1,
26
+ start > 3 ? "gap" : 2,
27
+ ...middle,
28
+ end < total - 2 ? "gap" : total - 1,
29
+ total
30
+ ];
31
+ }
32
+ function formatRange(template, values) {
33
+ return template.replace("{first}", values.first).replace("{last}", values.last).replace("{total}", values.total ?? "");
34
+ }
35
+ export {
36
+ clampPage,
37
+ formatPageRange,
38
+ formatRange,
39
+ pageCount,
40
+ pageItems,
41
+ pageRange
42
+ };
@@ -0,0 +1,18 @@
1
+ export interface PaginationState<T> {
2
+ /** Current 1-based page, always inside `1..pageCount`. */
3
+ page: number;
4
+ pageCount: number;
5
+ /** Rows across every page. */
6
+ total: number;
7
+ pageSize: number;
8
+ /** The rows of the current page. */
9
+ items: readonly T[];
10
+ setPage: (page: number) => void;
11
+ }
12
+ /**
13
+ * Client-side paging over an already filtered and sorted list. The page is clamped, so a search
14
+ * that shrinks the list lands on the last page that still exists instead of an empty one, and it
15
+ * returns to the first page whenever `resetKey` changes (the search text, a filter, the sort).
16
+ * Pair it with `<Pagination variant="pages">`.
17
+ */
18
+ export declare function usePagination<T>(rows: readonly T[], resetKey?: unknown, pageSize?: number): PaginationState<T>;
@@ -0,0 +1,22 @@
1
+ "use client";
2
+ import { useMemo, useState } from "react";
3
+ import { clampPage, pageCount } from "./range.js";
4
+ function usePagination(rows, resetKey = "", pageSize = 25) {
5
+ const [requested, setPage] = useState(1);
6
+ const [key, setKey] = useState(resetKey);
7
+ if (!Object.is(key, resetKey)) {
8
+ setKey(resetKey);
9
+ setPage(1);
10
+ }
11
+ const total = rows.length;
12
+ const pages = pageCount(total, pageSize);
13
+ const page = Object.is(key, resetKey) ? clampPage(requested, pages) : 1;
14
+ const items = useMemo(
15
+ () => rows.slice((page - 1) * pageSize, page * pageSize),
16
+ [rows, page, pageSize]
17
+ );
18
+ return { page, pageCount: pages, total, pageSize, items, setPage };
19
+ }
20
+ export {
21
+ usePagination
22
+ };