@jcsoftdev/ui 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (373) hide show
  1. package/CHANGELOG.md +337 -0
  2. package/README.md +25 -3
  3. package/bin/ui-theme.mjs +40 -6
  4. package/dist/ai/code-block/code-block.js +1 -1
  5. package/dist/atoms/big-date/big-date.js +2 -2
  6. package/dist/atoms/button/button.d.ts +6 -1
  7. package/dist/atoms/button/button.js +2 -2
  8. package/dist/atoms/chip/chip.d.ts +5 -0
  9. package/dist/atoms/chip/chip.js +3 -3
  10. package/dist/atoms/icon-button/icon-button.js +1 -1
  11. package/dist/atoms/internal/hit-area.d.ts +5 -4
  12. package/dist/atoms/internal/hit-area.js +1 -1
  13. package/dist/atoms/progress/index.d.ts +1 -1
  14. package/dist/atoms/progress/index.js +4 -1
  15. package/dist/atoms/progress/progress.d.ts +6 -1
  16. package/dist/atoms/progress/progress.js +19 -1
  17. package/dist/atoms/radio-group/radio-group.js +1 -1
  18. package/dist/atoms/status-pill/status-pill.d.ts +16 -5
  19. package/dist/atoms/status-pill/status-pill.js +43 -18
  20. package/dist/brand/logo-forge.js +1 -1
  21. package/dist/charts/candlestick-chart/candlestick-chart.js +2 -2
  22. package/dist/charts/chart-grid/chart-grid.js +2 -2
  23. package/dist/charts/chord-chart/chord-chart.js +1 -1
  24. package/dist/charts/core/axes.js +2 -2
  25. package/dist/charts/core/cartesian/annotations.js +2 -2
  26. package/dist/charts/core/cartesian/marks.js +1 -1
  27. package/dist/charts/core/distribution/marks.js +1 -1
  28. package/dist/charts/core/distribution/xy-points.js +1 -1
  29. package/dist/charts/core/export-menu.js +1 -1
  30. package/dist/charts/funnel-chart/funnel-chart.js +1 -1
  31. package/dist/charts/gantt-chart/gantt-chart.js +4 -4
  32. package/dist/charts/gantt-chart/gantt-marks.js +3 -3
  33. package/dist/charts/index.d.ts +2 -0
  34. package/dist/charts/index.js +2 -0
  35. package/dist/charts/maps/geo/map-data-table.js +1 -1
  36. package/dist/charts/polar-area-chart/polar-area-chart.js +1 -1
  37. package/dist/charts/radar-chart/radar-chart.js +1 -1
  38. package/dist/charts/stock-chart/stock-chart.js +1 -1
  39. package/dist/charts/stock-chart/stock-drawing-layer.js +3 -3
  40. package/dist/charts/stock-chart/stock-plot.js +2 -2
  41. package/dist/containers/chat-thread/chat-thread.d.ts +98 -0
  42. package/dist/containers/chat-thread/chat-thread.js +219 -0
  43. package/dist/containers/chat-thread/format.d.ts +20 -0
  44. package/dist/containers/chat-thread/format.js +50 -0
  45. package/dist/containers/chat-thread/index.d.ts +1 -0
  46. package/dist/containers/chat-thread/index.js +8 -0
  47. package/dist/containers/cols/cols.d.ts +1 -1
  48. package/dist/containers/cols/cols.js +7 -0
  49. package/dist/containers/comment/comment.js +1 -1
  50. package/dist/containers/context-rail/context-rail.d.ts +62 -0
  51. package/dist/containers/context-rail/context-rail.js +175 -0
  52. package/dist/containers/context-rail/index.d.ts +1 -0
  53. package/dist/containers/context-rail/index.js +6 -0
  54. package/dist/containers/dashboard/dashboard.d.ts +40 -0
  55. package/dist/containers/dashboard/dashboard.js +84 -0
  56. package/dist/containers/dashboard/index.d.ts +1 -0
  57. package/dist/containers/dashboard/index.js +14 -0
  58. package/dist/containers/data-grid/data-grid.demos.js +4 -4
  59. package/dist/containers/data-grid/data-grid.js +6 -6
  60. package/dist/containers/data-grid/filter-builder-editor.js +2 -2
  61. package/dist/containers/data-grid/grid-toolbar.js +1 -1
  62. package/dist/containers/data-grid/spreadsheet.demos.d.ts +1 -1
  63. package/dist/containers/data-grid/spreadsheet.demos.js +1 -1
  64. package/dist/containers/detail-header/detail-header.d.ts +24 -0
  65. package/dist/containers/detail-header/detail-header.js +32 -0
  66. package/dist/containers/detail-header/index.d.ts +1 -0
  67. package/dist/containers/detail-header/index.js +6 -0
  68. package/dist/containers/facts/facts.js +1 -1
  69. package/dist/containers/filter-bar/filter-bar.d.ts +58 -0
  70. package/dist/containers/filter-bar/filter-bar.js +123 -0
  71. package/dist/containers/filter-bar/index.d.ts +1 -0
  72. package/dist/containers/filter-bar/index.js +6 -0
  73. package/dist/containers/hbars/hbars.js +2 -2
  74. package/dist/containers/index.d.ts +9 -0
  75. package/dist/containers/index.js +9 -0
  76. package/dist/containers/kanban/kanban.d.ts +23 -2
  77. package/dist/containers/kanban/kanban.js +101 -21
  78. package/dist/containers/kanban/model.d.ts +12 -0
  79. package/dist/containers/kanban/model.js +8 -0
  80. package/dist/containers/kpi/kpi.js +1 -1
  81. package/dist/containers/kpi-group/kpi-group.d.ts +6 -1
  82. package/dist/containers/kpi-group/kpi-group.js +6 -2
  83. package/dist/containers/list-detail/index.d.ts +1 -1
  84. package/dist/containers/list-detail/index.js +4 -0
  85. package/dist/containers/list-detail/list-detail.d.ts +51 -3
  86. package/dist/containers/list-detail/list-detail.js +109 -15
  87. package/dist/containers/page/page.d.ts +17 -4
  88. package/dist/containers/page/page.js +33 -4
  89. package/dist/containers/page-header/back.d.ts +10 -0
  90. package/dist/containers/page-header/back.js +28 -0
  91. package/dist/containers/page-header/index.d.ts +1 -0
  92. package/dist/containers/page-header/index.js +1 -0
  93. package/dist/containers/page-header/page-header.d.ts +19 -2
  94. package/dist/containers/page-header/page-header.js +26 -2
  95. package/dist/containers/pagination/cursor-pagination.d.ts +28 -0
  96. package/dist/containers/pagination/cursor-pagination.js +48 -0
  97. package/dist/containers/pagination/index.d.ts +3 -0
  98. package/dist/containers/pagination/index.js +10 -0
  99. package/dist/containers/pagination/pagination.d.ts +52 -0
  100. package/dist/containers/pagination/pagination.js +216 -0
  101. package/dist/containers/pagination/range.d.ts +29 -0
  102. package/dist/containers/pagination/range.js +42 -0
  103. package/dist/containers/pagination/use-pagination.d.ts +18 -0
  104. package/dist/containers/pagination/use-pagination.js +22 -0
  105. package/dist/containers/responsive-list/responsive-list.d.ts +28 -2
  106. package/dist/containers/responsive-list/responsive-list.js +134 -25
  107. package/dist/containers/row-actions/index.d.ts +1 -0
  108. package/dist/containers/row-actions/index.js +4 -0
  109. package/dist/containers/row-actions/row-actions.d.ts +26 -0
  110. package/dist/containers/row-actions/row-actions.js +78 -0
  111. package/dist/containers/selectable-card/index.d.ts +1 -0
  112. package/dist/containers/selectable-card/index.js +6 -0
  113. package/dist/containers/selectable-card/selectable-card.d.ts +26 -0
  114. package/dist/containers/selectable-card/selectable-card.js +57 -0
  115. package/dist/containers/settings-layout/settings-layout.d.ts +24 -7
  116. package/dist/containers/settings-layout/settings-layout.js +63 -8
  117. package/dist/containers/shortcuts/shortcuts.js +1 -1
  118. package/dist/containers/table/cell-padding.d.ts +2 -0
  119. package/dist/containers/table/cell-padding.js +4 -0
  120. package/dist/containers/table/index.d.ts +1 -0
  121. package/dist/containers/table/index.js +8 -0
  122. package/dist/containers/table/sort.d.ts +14 -0
  123. package/dist/containers/table/sort.js +11 -0
  124. package/dist/containers/table/table-parts.d.ts +24 -0
  125. package/dist/containers/table/table-parts.js +52 -0
  126. package/dist/containers/table/table.d.ts +37 -3
  127. package/dist/containers/table/table.js +120 -19
  128. package/dist/containers/table-columns-menu/index.d.ts +1 -0
  129. package/dist/containers/table-columns-menu/index.js +6 -0
  130. package/dist/containers/table-columns-menu/table-columns-menu.d.ts +14 -0
  131. package/dist/containers/table-columns-menu/table-columns-menu.js +46 -0
  132. package/dist/dashboards/layout.d.ts +1 -27
  133. package/dist/dashboards/layout.js +8 -40
  134. package/dist/forms/chip-group/chip-group.d.ts +5 -0
  135. package/dist/forms/chip-group/chip-group.js +3 -1
  136. package/dist/forms/combobox/combobox.js +1 -1
  137. package/dist/forms/copy-field/copy-field.js +1 -1
  138. package/dist/forms/date-picker/date-picker.d.ts +3 -1
  139. package/dist/forms/date-picker/date-picker.js +4 -2
  140. package/dist/forms/date-picker/date-time-picker.d.ts +8 -2
  141. package/dist/forms/date-picker/date-time-picker.js +13 -2
  142. package/dist/forms/field/field.d.ts +9 -2
  143. package/dist/forms/field/field.js +18 -4
  144. package/dist/forms/fieldset/fieldset.d.ts +11 -0
  145. package/dist/forms/fieldset/fieldset.js +12 -0
  146. package/dist/forms/fieldset/index.d.ts +1 -0
  147. package/dist/forms/fieldset/index.js +4 -0
  148. package/dist/forms/form-footer/form-footer.d.ts +26 -0
  149. package/dist/forms/form-footer/form-footer.js +44 -0
  150. package/dist/forms/form-footer/index.d.ts +1 -0
  151. package/dist/forms/form-footer/index.js +4 -0
  152. package/dist/forms/form-grid/form-grid.d.ts +21 -4
  153. package/dist/forms/form-grid/form-grid.js +20 -3
  154. package/dist/forms/form-grid/index.d.ts +1 -1
  155. package/dist/forms/form-grid/index.js +6 -2
  156. package/dist/forms/form-section/form-section.d.ts +12 -0
  157. package/dist/forms/form-section/form-section.js +30 -0
  158. package/dist/forms/form-section/index.d.ts +1 -0
  159. package/dist/forms/form-section/index.js +4 -0
  160. package/dist/forms/index.d.ts +3 -0
  161. package/dist/forms/index.js +3 -0
  162. package/dist/forms/input/input.d.ts +6 -2
  163. package/dist/forms/input/input.js +4 -1
  164. package/dist/forms/internal/listbox-items.d.ts +1 -1
  165. package/dist/forms/internal/listbox-items.js +3 -2
  166. package/dist/forms/native-select/native-select.js +1 -1
  167. package/dist/forms/select/index.d.ts +1 -1
  168. package/dist/forms/select/select.d.ts +5 -2
  169. package/dist/forms/select/select.js +7 -2
  170. package/dist/forms/select-menu/select-menu.js +1 -1
  171. package/dist/forms/time-input/time-input.d.ts +4 -2
  172. package/dist/forms/time-input/time-input.js +3 -1
  173. package/dist/i18n/strings.d.ts +86 -0
  174. package/dist/i18n/strings.js +46 -0
  175. package/dist/motion/count-up.d.ts +20 -0
  176. package/dist/motion/count-up.js +59 -0
  177. package/dist/motion/cross-fade.d.ts +21 -0
  178. package/dist/motion/cross-fade.js +86 -0
  179. package/dist/motion/index.d.ts +5 -0
  180. package/dist/motion/index.js +14 -0
  181. package/dist/motion/model.d.ts +15 -0
  182. package/dist/motion/model.js +68 -0
  183. package/dist/motion/motion-styles.d.ts +1 -0
  184. package/dist/motion/motion-styles.js +35 -0
  185. package/dist/motion/reveal.d.ts +37 -0
  186. package/dist/motion/reveal.js +69 -0
  187. package/dist/motion/use-enter-phase.d.ts +11 -0
  188. package/dist/motion/use-enter-phase.js +40 -0
  189. package/dist/motion/use-highlight-row.d.ts +22 -0
  190. package/dist/motion/use-highlight-row.js +38 -0
  191. package/dist/navigation/tabs/tabs.js +1 -1
  192. package/dist/navigation/wizard/wizard.d.ts +4 -1
  193. package/dist/navigation/wizard/wizard.js +3 -0
  194. package/dist/overlays/alert-dialog/alert-dialog.js +8 -1
  195. package/dist/overlays/context-menu/context-menu.js +3 -1
  196. package/dist/overlays/dialog/dialog.js +10 -2
  197. package/dist/overlays/drawer/drawer.d.ts +18 -4
  198. package/dist/overlays/drawer/drawer.js +53 -4
  199. package/dist/overlays/drawer/index.d.ts +1 -1
  200. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +1 -1
  201. package/dist/overlays/dropdown-menu/dropdown-menu.js +5 -4
  202. package/dist/overlays/hover-card/hover-card.js +2 -0
  203. package/dist/overlays/popover/popover.js +2 -0
  204. package/dist/overlays/toaster/index.d.ts +1 -1
  205. package/dist/overlays/toaster/toaster.d.ts +28 -2
  206. package/dist/overlays/toaster/toaster.js +73 -29
  207. package/dist/overlays/tooltip/tooltip.js +2 -0
  208. package/dist/primitives/use-presence.js +9 -0
  209. package/dist/shell/app-shell/app-shell.d.ts +8 -1
  210. package/dist/shell/app-shell/app-shell.js +50 -3
  211. package/dist/shell/index.d.ts +1 -0
  212. package/dist/shell/index.js +1 -0
  213. package/dist/shell/sidebar/sidebar.d.ts +17 -1
  214. package/dist/shell/sidebar/sidebar.js +126 -76
  215. package/dist/shell/topbar/topbar.d.ts +4 -2
  216. package/dist/shell/topbar/topbar.js +2 -0
  217. package/dist/showcase/operations-bento.js +2 -2
  218. package/dist/states/empty-state/empty-state.d.ts +10 -3
  219. package/dist/states/empty-state/empty-state.js +46 -5
  220. package/dist/states/error-state/error-state.js +1 -1
  221. package/dist/states/skeleton/skeleton.js +1 -1
  222. package/dist/utils/class-tokens.generated.js +4 -6
  223. package/dist/utils/list-navigation.d.ts +14 -0
  224. package/dist/utils/list-navigation.js +44 -0
  225. package/dist/utils/overlay-motion.d.ts +12 -0
  226. package/dist/utils/overlay-motion.js +14 -0
  227. package/dist/utils/use-container-width.d.ts +6 -0
  228. package/dist/utils/use-container-width.js +19 -0
  229. package/package.json +2 -2
  230. package/scripts/build-theme.mjs +46 -5
  231. package/src/ai/code-block/code-block.tsx +1 -1
  232. package/src/atoms/big-date/big-date.tsx +2 -2
  233. package/src/atoms/button/button.tsx +8 -3
  234. package/src/atoms/chip/chip.tsx +8 -3
  235. package/src/atoms/icon-button/icon-button.tsx +1 -1
  236. package/src/atoms/internal/hit-area.ts +5 -4
  237. package/src/atoms/progress/index.ts +8 -1
  238. package/src/atoms/progress/progress.tsx +30 -1
  239. package/src/atoms/radio-group/radio-group.tsx +1 -1
  240. package/src/atoms/status-pill/status-pill.tsx +59 -18
  241. package/src/brand/logo-forge.tsx +1 -1
  242. package/src/charts/candlestick-chart/candlestick-chart.tsx +2 -2
  243. package/src/charts/chart-grid/chart-grid.tsx +2 -2
  244. package/src/charts/chord-chart/chord-chart.tsx +1 -1
  245. package/src/charts/core/axes.tsx +2 -2
  246. package/src/charts/core/cartesian/annotations.tsx +2 -2
  247. package/src/charts/core/cartesian/marks.tsx +1 -1
  248. package/src/charts/core/distribution/marks.tsx +1 -1
  249. package/src/charts/core/distribution/xy-points.tsx +1 -1
  250. package/src/charts/core/export-menu.tsx +1 -1
  251. package/src/charts/funnel-chart/funnel-chart.tsx +1 -1
  252. package/src/charts/gantt-chart/gantt-chart.tsx +4 -4
  253. package/src/charts/gantt-chart/gantt-marks.tsx +3 -3
  254. package/src/charts/index.ts +2 -0
  255. package/src/charts/maps/geo/map-data-table.tsx +1 -1
  256. package/src/charts/polar-area-chart/polar-area-chart.tsx +1 -1
  257. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  258. package/src/charts/stock-chart/stock-chart.tsx +1 -1
  259. package/src/charts/stock-chart/stock-drawing-layer.tsx +3 -3
  260. package/src/charts/stock-chart/stock-plot.tsx +2 -2
  261. package/src/containers/chat-thread/chat-thread.tsx +331 -0
  262. package/src/containers/chat-thread/format.ts +67 -0
  263. package/src/containers/chat-thread/index.ts +12 -0
  264. package/src/containers/cols/cols.tsx +13 -1
  265. package/src/containers/comment/comment.tsx +1 -1
  266. package/src/containers/context-rail/context-rail.tsx +229 -0
  267. package/src/containers/context-rail/index.ts +7 -0
  268. package/src/containers/dashboard/dashboard.tsx +142 -0
  269. package/src/containers/dashboard/index.ts +12 -0
  270. package/src/containers/data-grid/data-grid.demos.tsx +4 -4
  271. package/src/containers/data-grid/data-grid.tsx +6 -6
  272. package/src/containers/data-grid/filter-builder-editor.tsx +2 -2
  273. package/src/containers/data-grid/grid-toolbar.tsx +1 -1
  274. package/src/containers/data-grid/spreadsheet.demos.tsx +1 -1
  275. package/src/containers/detail-header/detail-header.tsx +64 -0
  276. package/src/containers/detail-header/index.ts +5 -0
  277. package/src/containers/facts/facts.tsx +1 -1
  278. package/src/containers/filter-bar/filter-bar.tsx +201 -0
  279. package/src/containers/filter-bar/index.ts +7 -0
  280. package/src/containers/hbars/hbars.tsx +2 -2
  281. package/src/containers/index.ts +9 -0
  282. package/src/containers/kanban/kanban.tsx +146 -39
  283. package/src/containers/kanban/model.ts +20 -0
  284. package/src/containers/kpi/kpi.tsx +1 -1
  285. package/src/containers/kpi-group/kpi-group.tsx +17 -2
  286. package/src/containers/list-detail/index.ts +5 -0
  287. package/src/containers/list-detail/list-detail.tsx +157 -9
  288. package/src/containers/page/page.tsx +61 -7
  289. package/src/containers/page-header/back.tsx +42 -0
  290. package/src/containers/page-header/index.ts +1 -0
  291. package/src/containers/page-header/page-header.tsx +49 -3
  292. package/src/containers/pagination/cursor-pagination.tsx +79 -0
  293. package/src/containers/pagination/index.ts +7 -0
  294. package/src/containers/pagination/pagination.tsx +266 -0
  295. package/src/containers/pagination/range.ts +68 -0
  296. package/src/containers/pagination/use-pagination.ts +44 -0
  297. package/src/containers/responsive-list/responsive-list.tsx +183 -46
  298. package/src/containers/row-actions/index.ts +1 -0
  299. package/src/containers/row-actions/row-actions.tsx +114 -0
  300. package/src/containers/selectable-card/index.ts +5 -0
  301. package/src/containers/selectable-card/selectable-card.tsx +84 -0
  302. package/src/containers/settings-layout/settings-layout.tsx +104 -13
  303. package/src/containers/shortcuts/shortcuts.tsx +1 -1
  304. package/src/containers/table/cell-padding.ts +2 -0
  305. package/src/containers/table/index.ts +6 -0
  306. package/src/containers/table/sort.ts +23 -0
  307. package/src/containers/table/table-parts.tsx +81 -0
  308. package/src/containers/table/table.tsx +212 -45
  309. package/src/containers/table-columns-menu/index.ts +5 -0
  310. package/src/containers/table-columns-menu/table-columns-menu.tsx +68 -0
  311. package/src/dashboards/layout.tsx +8 -75
  312. package/src/forms/chip-group/chip-group.tsx +8 -1
  313. package/src/forms/combobox/combobox.tsx +1 -1
  314. package/src/forms/copy-field/copy-field.tsx +1 -1
  315. package/src/forms/date-picker/date-picker.tsx +7 -2
  316. package/src/forms/date-picker/date-time-picker.tsx +28 -2
  317. package/src/forms/field/field.tsx +30 -3
  318. package/src/forms/fieldset/fieldset.tsx +22 -0
  319. package/src/forms/fieldset/index.ts +1 -0
  320. package/src/forms/form-footer/form-footer.tsx +74 -0
  321. package/src/forms/form-footer/index.ts +1 -0
  322. package/src/forms/form-grid/form-grid.tsx +42 -5
  323. package/src/forms/form-grid/index.ts +8 -1
  324. package/src/forms/form-section/form-section.tsx +41 -0
  325. package/src/forms/form-section/index.ts +1 -0
  326. package/src/forms/index.ts +3 -0
  327. package/src/forms/input/input.tsx +10 -3
  328. package/src/forms/internal/listbox-items.tsx +3 -4
  329. package/src/forms/native-select/native-select.tsx +1 -1
  330. package/src/forms/select/index.ts +1 -1
  331. package/src/forms/select/select.tsx +14 -3
  332. package/src/forms/select-menu/select-menu.tsx +1 -1
  333. package/src/forms/time-input/time-input.tsx +6 -2
  334. package/src/i18n/strings.ts +86 -0
  335. package/src/motion/count-up.tsx +83 -0
  336. package/src/motion/cross-fade.tsx +139 -0
  337. package/src/motion/index.ts +5 -0
  338. package/src/motion/model.ts +86 -0
  339. package/src/motion/motion-styles.tsx +47 -0
  340. package/src/motion/reveal.tsx +115 -0
  341. package/src/motion/use-enter-phase.ts +50 -0
  342. package/src/motion/use-highlight-row.ts +63 -0
  343. package/src/navigation/tabs/tabs.tsx +1 -1
  344. package/src/navigation/wizard/wizard.tsx +6 -1
  345. package/src/overlays/alert-dialog/alert-dialog.tsx +5 -1
  346. package/src/overlays/context-menu/context-menu.tsx +3 -2
  347. package/src/overlays/dialog/dialog.tsx +7 -2
  348. package/src/overlays/drawer/drawer.tsx +68 -6
  349. package/src/overlays/drawer/index.ts +1 -0
  350. package/src/overlays/dropdown-menu/dropdown-menu.tsx +5 -4
  351. package/src/overlays/hover-card/hover-card.tsx +2 -0
  352. package/src/overlays/popover/popover.tsx +2 -0
  353. package/src/overlays/toaster/index.ts +2 -0
  354. package/src/overlays/toaster/toaster.tsx +113 -17
  355. package/src/overlays/tooltip/tooltip.tsx +2 -0
  356. package/src/primitives/use-presence.ts +13 -0
  357. package/src/shell/app-shell/app-shell.tsx +54 -2
  358. package/src/shell/index.ts +1 -0
  359. package/src/shell/sidebar/sidebar.tsx +154 -75
  360. package/src/shell/topbar/topbar.tsx +8 -0
  361. package/src/showcase/operations-bento.tsx +2 -2
  362. package/src/states/empty-state/empty-state.tsx +52 -9
  363. package/src/states/error-state/error-state.tsx +1 -1
  364. package/src/states/skeleton/skeleton.tsx +1 -1
  365. package/src/utils/class-tokens.generated.ts +4 -6
  366. package/src/utils/list-navigation.ts +63 -0
  367. package/src/utils/overlay-motion.ts +33 -0
  368. package/src/utils/use-container-width.ts +24 -0
  369. package/styles/Theme.kt +15 -18
  370. package/styles/tailwind.css +29 -28
  371. package/styles/theme.css +29 -28
  372. package/styles/tokens.css +46 -0
  373. package/tokens/default.json +51 -29
@@ -3,6 +3,8 @@ export interface UiStrings {
3
3
  close: string;
4
4
  loading: string;
5
5
  optional: string;
6
+ save: string;
7
+ unsavedChanges: string;
6
8
  cancel: string;
7
9
  confirm: string;
8
10
  processing: string;
@@ -56,6 +58,44 @@ export interface UiStrings {
56
58
  selectAll: string;
57
59
  /** Name of the overflow menu trigger of a `TableActionsCell`. */
58
60
  rowActions: string;
61
+ /** Default body of a `TableEmpty` row. */
62
+ tableEmpty: string;
63
+ /** Label of the `TableColumnsMenu` trigger and its group. */
64
+ columns: string;
65
+ /** Name of the `Pagination` landmark. */
66
+ pagination: string;
67
+ /** Label of the page size picker of a `Pagination`. */
68
+ rowsPerPage: string;
69
+ /** Range text of a `Pagination`; `{first}`, `{last}` and `{total}` are replaced. */
70
+ pageRange: string;
71
+ firstPage: string;
72
+ previousPage: string;
73
+ nextPage: string;
74
+ lastPage: string;
75
+ /** Range text of a `Pagination variant="pages"`; `{first}`, `{last}` and `{total}` are replaced. */
76
+ showingRange: string;
77
+ /** Range text of a `CursorPagination` (no known total); `{first}` and `{last}` are replaced. */
78
+ showingRangeOpen: string;
79
+ /** Visible label of the previous-page button of `Pagination variant="pages"` and `CursorPagination`. */
80
+ previous: string;
81
+ /** Name of a page number button; `{page}` is replaced. */
82
+ pageNumber: string;
83
+ /** Name of the search field of a `FilterBar`. */
84
+ search: string;
85
+ /** Label of the `FilterBar` button that opens every filter under a narrow container. */
86
+ filters: string;
87
+ /** Label of the `FilterBar` button that opens the extra filters. */
88
+ moreFilters: string;
89
+ /** Clears every active filter of a `FilterBar`. */
90
+ clearAllFilters: string;
91
+ /** Name of the remove button of an active filter chip; `{filter}` is replaced by its label. */
92
+ removeFilter: string;
93
+ /** Name of the list of active filter chips of a `FilterBar`. */
94
+ activeFilters: string;
95
+ /** Result count of a `FilterBar` for exactly one result. */
96
+ resultOne: string;
97
+ /** Result count of a `FilterBar`; `{count}` is replaced. */
98
+ resultMany: string;
59
99
  /** Name of the `PasswordInput` toggle; its pressed state says whether the password is visible. */
60
100
  showPassword: string;
61
101
  /** Default title of a `LoginForm`. */
@@ -98,6 +138,8 @@ export const uiStrings = {
98
138
  close: "Close",
99
139
  loading: "Loading",
100
140
  optional: "optional",
141
+ save: "Save",
142
+ unsavedChanges: "Unsaved changes",
101
143
  cancel: "Cancel",
102
144
  confirm: "Confirm",
103
145
  processing: "Processing…",
@@ -140,6 +182,27 @@ export const uiStrings = {
140
182
  selectRow: "Select {row}",
141
183
  selectAll: "Select all rows",
142
184
  rowActions: "Row actions",
185
+ tableEmpty: "No rows to show",
186
+ columns: "Columns",
187
+ pagination: "Pagination",
188
+ rowsPerPage: "Rows per page",
189
+ pageRange: "{first}–{last} of {total}",
190
+ firstPage: "First page",
191
+ previousPage: "Previous page",
192
+ nextPage: "Next page",
193
+ lastPage: "Last page",
194
+ showingRange: "Showing {first}–{last} of {total}",
195
+ showingRangeOpen: "Showing {first}–{last}",
196
+ previous: "Previous",
197
+ pageNumber: "Page {page}",
198
+ search: "Search",
199
+ filters: "Filters",
200
+ moreFilters: "More filters",
201
+ clearAllFilters: "Clear all filters",
202
+ removeFilter: "Remove filter {filter}",
203
+ activeFilters: "Active filters",
204
+ resultOne: "1 result",
205
+ resultMany: "{count} results",
143
206
  showPassword: "Show password",
144
207
  signIn: "Sign in",
145
208
  signInAs: "Sign in as",
@@ -162,6 +225,8 @@ export const uiStrings = {
162
225
  close: "Cerrar",
163
226
  loading: "Cargando",
164
227
  optional: "opcional",
228
+ save: "Guardar",
229
+ unsavedChanges: "Cambios sin guardar",
165
230
  cancel: "Cancelar",
166
231
  confirm: "Confirmar",
167
232
  processing: "Procesando…",
@@ -204,6 +269,27 @@ export const uiStrings = {
204
269
  selectRow: "Seleccionar {row}",
205
270
  selectAll: "Seleccionar todas las filas",
206
271
  rowActions: "Acciones de la fila",
272
+ tableEmpty: "No hay filas para mostrar",
273
+ columns: "Columnas",
274
+ pagination: "Paginación",
275
+ rowsPerPage: "Filas por página",
276
+ pageRange: "{first}–{last} de {total}",
277
+ firstPage: "Primera página",
278
+ previousPage: "Página anterior",
279
+ nextPage: "Página siguiente",
280
+ lastPage: "Última página",
281
+ showingRange: "Mostrando {first}–{last} de {total}",
282
+ showingRangeOpen: "Mostrando {first}–{last}",
283
+ previous: "Anterior",
284
+ pageNumber: "Página {page}",
285
+ search: "Buscar",
286
+ filters: "Filtros",
287
+ moreFilters: "Más filtros",
288
+ clearAllFilters: "Limpiar todos los filtros",
289
+ removeFilter: "Quitar filtro {filter}",
290
+ activeFilters: "Filtros activos",
291
+ resultOne: "1 resultado",
292
+ resultMany: "{count} resultados",
207
293
  showPassword: "Mostrar contraseña",
208
294
  signIn: "Inicia sesión",
209
295
  signInAs: "Ingresar como",
@@ -0,0 +1,83 @@
1
+ "use client";
2
+
3
+ import { type HTMLAttributes, type Ref, useEffect, useMemo, useRef, useState } from "react";
4
+ import { useUiStrings } from "../i18n/index.js";
5
+ import { usePrefersReducedMotion } from "../utils/reduced-motion.js";
6
+ import { composeRefs } from "../utils/slot.js";
7
+ import { COUNT_UP_SCALE, countAt, parseDuration, parseEasing } from "./model.js";
8
+ import { MotionStyles } from "./motion-styles.js";
9
+ import { useStartedOnServer } from "./use-enter-phase.js";
10
+
11
+ /** Anything with an `Intl.NumberFormat`-style `format`, such as `new Intl.NumberFormat(...)`. */
12
+ export interface NumberFormatter {
13
+ format(value: number): string;
14
+ }
15
+
16
+ export interface CountUpProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"> {
17
+ value: number;
18
+ /** Formats every shown value. Defaults to `Intl.NumberFormat` in the UI strings locale. */
19
+ formatter?: NumberFormatter;
20
+ /** Where a client-side mount starts counting from. Default 0. */
21
+ from?: number;
22
+ ref?: Ref<HTMLSpanElement>;
23
+ }
24
+
25
+ /**
26
+ * A number that counts to `value` over 1.5 `--motion-duration`s with `--motion-ease`, on a client
27
+ * mount and on every change. Server HTML, hydration and reduced motion show the final value at
28
+ * once. While it counts, assistive tech reads only the final value and the final text reserves
29
+ * its width, so the line does not grow digit by digit. Works as the `value` of a `Kpi`.
30
+ */
31
+ export function CountUp({ value, formatter, from = 0, className, ref, ...props }: CountUpProps) {
32
+ const { locale } = useUiStrings();
33
+ const format = useMemo(() => formatter ?? new Intl.NumberFormat(locale), [formatter, locale]);
34
+ const startedOnServer = useStartedOnServer();
35
+ const reduced = usePrefersReducedMotion();
36
+ const [shown, setShown] = useState(() => (startedOnServer || reduced ? value : from));
37
+ const node = useRef<HTMLSpanElement>(null);
38
+ const latest = useRef(shown);
39
+ latest.current = shown;
40
+
41
+ useEffect(() => {
42
+ const start = latest.current;
43
+ const el = node.current;
44
+ if (reduced || start === value || !el || typeof requestAnimationFrame === "undefined") {
45
+ setShown(value);
46
+ return;
47
+ }
48
+ const styles = getComputedStyle(el);
49
+ const duration = parseDuration(styles.getPropertyValue("--motion-duration")) * COUNT_UP_SCALE;
50
+ const ease = parseEasing(styles.getPropertyValue("--motion-ease"));
51
+ const t0 = performance.now();
52
+ let frame = requestAnimationFrame(function tick(now) {
53
+ const next = countAt(start, value, now - t0, duration, ease);
54
+ setShown(next);
55
+ if (next !== value) frame = requestAnimationFrame(tick);
56
+ });
57
+ return () => cancelAnimationFrame(frame);
58
+ }, [value, reduced]);
59
+
60
+ const final = format.format(value);
61
+ return (
62
+ <>
63
+ <MotionStyles />
64
+ <span
65
+ ref={composeRefs(ref, node)}
66
+ className={className ? `ui-count ${className}` : "ui-count"}
67
+ {...props}
68
+ >
69
+ {shown === value ? (
70
+ final
71
+ ) : (
72
+ <>
73
+ <span className="ui-count-run" aria-hidden="true">
74
+ <span>{final}</span>
75
+ <span>{format.format(shown)}</span>
76
+ </span>
77
+ <span className="ui-motion-sr">{final}</span>
78
+ </>
79
+ )}
80
+ </span>
81
+ </>
82
+ );
83
+ }
@@ -0,0 +1,139 @@
1
+ "use client";
2
+
3
+ import {
4
+ type AnimationEvent,
5
+ type HTMLAttributes,
6
+ type Key,
7
+ type ReactNode,
8
+ type Ref,
9
+ useEffect,
10
+ useLayoutEffect,
11
+ useRef,
12
+ useState,
13
+ } from "react";
14
+ import { usePrefersReducedMotion } from "../utils/reduced-motion.js";
15
+ import { MotionStyles } from "./motion-styles.js";
16
+
17
+ interface Leaving {
18
+ key: Key;
19
+ node: ReactNode;
20
+ }
21
+
22
+ interface SwapState {
23
+ key: Key;
24
+ entering: Key | null;
25
+ leaving: Leaving[];
26
+ /** Bumped each time focus was inside the content that left, so it moves to the new content. */
27
+ refocus: number;
28
+ }
29
+
30
+ /** Leaving layers are dropped on `animationend`; this bounds them when no animation runs. */
31
+ const LEAVE_TIMEOUT_MS = 1000;
32
+
33
+ export interface CrossFadeProps extends HTMLAttributes<HTMLDivElement> {
34
+ /** Identity of the content. A new key fades the old content out and the new one in. */
35
+ contentKey: Key;
36
+ children?: ReactNode;
37
+ ref?: Ref<HTMLDivElement>;
38
+ }
39
+
40
+ /**
41
+ * Swaps keyed content (a list-detail pane, a tab panel) with a cross-fade and a 4px rise. The old
42
+ * content stays mounted on top of the new one until it has faded, out of the layout (so nothing
43
+ * jumps), hidden from assistive tech and inert. If focus was inside the old content it moves to
44
+ * the new content. The first render (also server HTML) never animates; reduced motion swaps
45
+ * without any fade.
46
+ */
47
+ export function CrossFade({ contentKey, children, ref, ...props }: CrossFadeProps) {
48
+ const reduced = usePrefersReducedMotion();
49
+ const current = useRef<HTMLDivElement>(null);
50
+ const committed = useRef<ReactNode>(children);
51
+ const [state, setState] = useState<SwapState>({
52
+ key: contentKey,
53
+ entering: null,
54
+ leaving: [],
55
+ refocus: 0,
56
+ });
57
+
58
+ if (state.key !== contentKey) {
59
+ const animate = !reduced;
60
+ const focused = typeof document !== "undefined" && document.activeElement;
61
+ setState({
62
+ key: contentKey,
63
+ entering: animate ? contentKey : null,
64
+ leaving: animate
65
+ ? [
66
+ ...state.leaving.filter((layer) => layer.key !== contentKey),
67
+ { key: state.key, node: committed.current },
68
+ ]
69
+ : [],
70
+ refocus: focused && current.current?.contains(focused) ? state.refocus + 1 : state.refocus,
71
+ });
72
+ }
73
+
74
+ useLayoutEffect(() => {
75
+ committed.current = children;
76
+ });
77
+
78
+ useLayoutEffect(() => {
79
+ if (state.refocus === 0 || !current.current) return;
80
+ current.current.tabIndex = -1;
81
+ current.current.focus({ preventScroll: true });
82
+ }, [state.refocus]);
83
+
84
+ const leavingCount = state.leaving.length;
85
+ useEffect(() => {
86
+ if (leavingCount === 0) return;
87
+ const timer = setTimeout(() => setState((s) => ({ ...s, leaving: [] })), LEAVE_TIMEOUT_MS);
88
+ return () => clearTimeout(timer);
89
+ }, [leavingCount]);
90
+
91
+ const drop = (key: Key) => (event: AnimationEvent<HTMLDivElement>) => {
92
+ if (event.target !== event.currentTarget) return;
93
+ setState((s) => ({ ...s, leaving: s.leaving.filter((layer) => layer.key !== key) }));
94
+ };
95
+
96
+ const layers = [
97
+ ...state.leaving.map((layer) => (
98
+ <div
99
+ key={`k:${String(layer.key)}`}
100
+ data-motion-leave=""
101
+ aria-hidden="true"
102
+ inert
103
+ onAnimationEnd={drop(layer.key)}
104
+ >
105
+ {layer.node}
106
+ </div>
107
+ )),
108
+ <div
109
+ key={`k:${String(contentKey)}`}
110
+ ref={current}
111
+ data-motion={state.entering === contentKey ? "enter" : undefined}
112
+ >
113
+ {children}
114
+ </div>,
115
+ ];
116
+
117
+ return (
118
+ <>
119
+ <MotionStyles />
120
+ <div ref={ref} data-motion-swap="" {...props}>
121
+ {layers}
122
+ </div>
123
+ </>
124
+ );
125
+ }
126
+
127
+ export interface PresenceProps extends Omit<CrossFadeProps, "contentKey"> {
128
+ /** Shows the children when true; changes fade them in and out. */
129
+ present: boolean;
130
+ }
131
+
132
+ /** `CrossFade` between the children and nothing: shows or hides content with a fade. */
133
+ export function Presence({ present, children, ...props }: PresenceProps) {
134
+ return (
135
+ <CrossFade contentKey={present ? "present" : "absent"} {...props}>
136
+ {present ? children : null}
137
+ </CrossFade>
138
+ );
139
+ }
@@ -0,0 +1,5 @@
1
+ export { CountUp, type CountUpProps, type NumberFormatter } from "./count-up.js";
2
+ export { CrossFade, type CrossFadeProps, Presence, type PresenceProps } from "./cross-fade.js";
3
+ export { MotionStyles } from "./motion-styles.js";
4
+ export { Reveal, type RevealProps, Stagger, type StaggerProps } from "./reveal.js";
5
+ export { type HighlightRow, type HighlightRowProps, useHighlightRow } from "./use-highlight-row.js";
@@ -0,0 +1,86 @@
1
+ // Pure motion math shared by the motion components: token parsing, easing and the count-up tween.
2
+
3
+ /** Fallbacks when the theme does not define `--motion-duration` / `--motion-ease`. */
4
+ export const DEFAULT_DURATION_MS = 180;
5
+ export const DEFAULT_EASE = "cubic-bezier(.2,.8,.2,1)";
6
+
7
+ /** A count-up runs this many token durations: long enough to read, still under 300ms by default. */
8
+ export const COUNT_UP_SCALE = 1.5;
9
+
10
+ export type Easing = (t: number) => number;
11
+
12
+ /** Milliseconds from a CSS time (`180ms`, `.18s`); `fallback` when it does not parse. */
13
+ export function parseDuration(value: string | null | undefined, fallback = DEFAULT_DURATION_MS) {
14
+ const match = /^\s*(-?\d*\.?\d+)\s*(ms|s)\s*$/i.exec(value ?? "");
15
+ if (!match) return fallback;
16
+ const amount = Number(match[1]) * (match[2]?.toLowerCase() === "s" ? 1000 : 1);
17
+ return Number.isFinite(amount) && amount >= 0 ? amount : fallback;
18
+ }
19
+
20
+ function cubicBezier(x1: number, y1: number, x2: number, y2: number): Easing {
21
+ const sample = (a: number, b: number, t: number) =>
22
+ 3 * a * t * (1 - t) ** 2 + 3 * b * t ** 2 * (1 - t) + t ** 3;
23
+ const slope = (a: number, b: number, t: number) =>
24
+ 3 * a * (1 - t) ** 2 + 6 * (b - a) * t * (1 - t) + 3 * (1 - b) * t ** 2;
25
+ return (x) => {
26
+ if (x <= 0) return 0;
27
+ if (x >= 1) return 1;
28
+ let t = x;
29
+ for (let i = 0; i < 8; i += 1) {
30
+ const error = sample(x1, x2, t) - x;
31
+ if (Math.abs(error) < 1e-6) return sample(y1, y2, t);
32
+ const d = slope(x1, x2, t);
33
+ if (Math.abs(d) < 1e-6) break;
34
+ t -= error / d;
35
+ }
36
+ let lo = 0;
37
+ let hi = 1;
38
+ t = x;
39
+ for (let i = 0; i < 30; i += 1) {
40
+ const value = sample(x1, x2, t);
41
+ if (Math.abs(value - x) < 1e-6) break;
42
+ if (value < x) lo = t;
43
+ else hi = t;
44
+ t = (lo + hi) / 2;
45
+ }
46
+ return sample(y1, y2, t);
47
+ };
48
+ }
49
+
50
+ const KEYWORDS: Record<string, [number, number, number, number]> = {
51
+ ease: [0.25, 0.1, 0.25, 1],
52
+ "ease-in": [0.42, 0, 1, 1],
53
+ "ease-out": [0, 0, 0.58, 1],
54
+ "ease-in-out": [0.42, 0, 0.58, 1],
55
+ };
56
+
57
+ /** Easing function for a CSS `<easing-function>`: `linear`, the `ease*` keywords or `cubic-bezier()`. */
58
+ export function parseEasing(value: string | null | undefined): Easing {
59
+ const text = (value ?? "").trim().toLowerCase();
60
+ if (text === "linear") return (t) => Math.min(1, Math.max(0, t));
61
+ const keyword = KEYWORDS[text];
62
+ if (keyword) return cubicBezier(...keyword);
63
+ const match = /^cubic-bezier\(([^)]*)\)$/.exec(text);
64
+ const points = match?.[1]?.split(",").map(Number);
65
+ if (points?.length === 4 && points.every(Number.isFinite)) {
66
+ const [x1, y1, x2, y2] = points as [number, number, number, number];
67
+ if (x1 >= 0 && x1 <= 1 && x2 >= 0 && x2 <= 1) return cubicBezier(x1, y1, x2, y2);
68
+ }
69
+ return cubicBezier(0.2, 0.8, 0.2, 1);
70
+ }
71
+
72
+ /**
73
+ * Value a count-up shows `elapsed` ms into a run of `duration` ms. It lands exactly on `to` at the
74
+ * end, and integer runs stay integers so a formatter never flashes decimals.
75
+ */
76
+ export function countAt(
77
+ from: number,
78
+ to: number,
79
+ elapsed: number,
80
+ duration: number,
81
+ ease: Easing,
82
+ ): number {
83
+ if (!(duration > 0) || elapsed >= duration) return to;
84
+ const value = from + (to - from) * ease(Math.max(0, elapsed) / duration);
85
+ return Number.isInteger(from) && Number.isInteger(to) ? Math.round(value) : value;
86
+ }
@@ -0,0 +1,47 @@
1
+ /**
2
+ * Rules of the motion entry. Every duration and easing comes from `--motion-duration` and
3
+ * `--motion-ease`, so a theme that shortens them (or makes them linear) restyles all motion.
4
+ * Enter and leave animate only `opacity` and `transform`; the row pulse animates a background
5
+ * colour, which repaints but never lays out. Hidden states use `opacity`, never `visibility` or
6
+ * `display`, so assistive tech reads the content while it animates.
7
+ *
8
+ * React 19 hoists and dedupes `<style href precedence>`, so every component can render this and
9
+ * the rules are injected once, also in server HTML.
10
+ */
11
+ const D = "var(--motion-duration,180ms)";
12
+ const E = "var(--motion-ease,cubic-bezier(.2,.8,.2,1))";
13
+
14
+ const CSS = `
15
+ @keyframes ui-motion-enter{from{opacity:0;transform:translate3d(0,var(--ui-motion-rise,6px),0)}}
16
+ @keyframes ui-motion-leave{to{opacity:0}}
17
+ @keyframes ui-motion-pulse-a{from{background-color:var(--ui-motion-highlight)}}
18
+ @keyframes ui-motion-pulse-b{from{background-color:var(--ui-motion-highlight)}}
19
+ [data-motion-stagger]{--ui-motion-step:min(calc(${D} / 4),calc(var(--ui-motion-span,calc(${D} * 1.5)) / var(--ui-motion-n,1)))}
20
+ [data-motion=wait]{opacity:0}
21
+ [data-motion=wait]:focus-within{opacity:1}
22
+ [data-motion=enter]{animation:ui-motion-enter ${D} ${E} backwards;animation-delay:calc(var(--ui-motion-delay,0ms) + var(--ui-motion-i,0) * var(--ui-motion-step,0ms))}
23
+ [data-motion-swap]{position:relative}
24
+ [data-motion-swap]>[data-motion=enter]{--ui-motion-rise:4px}
25
+ [data-motion-swap]>[data-motion-leave]{position:absolute;inset:0 0 auto;pointer-events:none;animation:ui-motion-leave ${D} ${E} forwards}
26
+ [data-motion-pulse]{--ui-motion-highlight:color-mix(in srgb,var(--accent,currentColor) 24%,transparent)}
27
+ [data-motion-pulse=a]:not(tr),tr[data-motion-pulse=a]>*{animation:ui-motion-pulse-a calc(${D} * 1.6) ${E}}
28
+ [data-motion-pulse=b]:not(tr),tr[data-motion-pulse=b]>*{animation:ui-motion-pulse-b calc(${D} * 1.6) ${E}}
29
+ .ui-count{font-variant-numeric:tabular-nums}
30
+ .ui-count-run{display:inline-grid;justify-items:end}
31
+ .ui-count-run>*{grid-area:1/1}
32
+ .ui-count-run>:first-child{visibility:hidden}
33
+ .ui-motion-sr{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip-path:inset(50%);white-space:nowrap;border:0}
34
+ @media (prefers-reduced-motion:reduce){
35
+ [data-motion]{animation:none!important;opacity:1!important}
36
+ [data-motion-swap]>[data-motion-leave]{display:none}
37
+ [data-motion-pulse]:not(tr),tr[data-motion-pulse]>*{animation:none!important}
38
+ }
39
+ `;
40
+
41
+ export function MotionStyles() {
42
+ return (
43
+ <style href="jcsoftdev-ui-motion" precedence="default">
44
+ {CSS}
45
+ </style>
46
+ );
47
+ }
@@ -0,0 +1,115 @@
1
+ "use client";
2
+
3
+ import {
4
+ Children,
5
+ type CSSProperties,
6
+ type HTMLAttributes,
7
+ isValidElement,
8
+ type ReactNode,
9
+ type Ref,
10
+ } from "react";
11
+ import { composeRefs, Slot } from "../utils/slot.js";
12
+ import { MotionStyles } from "./motion-styles.js";
13
+ import { type EnterPhase, useEnterPhase } from "./use-enter-phase.js";
14
+
15
+ type MotionVars = CSSProperties & Record<`--ui-motion-${string}`, string | number>;
16
+
17
+ function phaseProps(phase: EnterPhase, vars: MotionVars, style?: CSSProperties) {
18
+ if (phase === "static") return { style };
19
+ return { "data-motion": phase, style: { ...vars, ...style } };
20
+ }
21
+
22
+ export interface RevealProps extends HTMLAttributes<HTMLElement> {
23
+ /** Extra wait before entering, in ms. */
24
+ delay?: number;
25
+ /** Enter when the element first scrolls into view instead of on mount. */
26
+ inView?: boolean;
27
+ /** Animate the single child element instead of rendering a `div`. */
28
+ asChild?: boolean;
29
+ ref?: Ref<HTMLElement>;
30
+ }
31
+
32
+ /**
33
+ * Fades its content in with a small rise when it mounts on the client, or first scrolls into view
34
+ * with `inView`. Server-rendered content and reduced motion show the end state at once. The
35
+ * content stays in the accessibility tree the whole time: hiding uses `opacity` only.
36
+ */
37
+ export function Reveal({ delay, inView = false, asChild, style, ref, ...props }: RevealProps) {
38
+ const [phaseRef, phase] = useEnterPhase(inView);
39
+ const Comp = asChild ? Slot : "div";
40
+ const vars: MotionVars = { "--ui-motion-i": 0 };
41
+ if (delay) vars["--ui-motion-delay"] = `${delay}ms`;
42
+ return (
43
+ <>
44
+ <MotionStyles />
45
+ <Comp
46
+ ref={composeRefs<HTMLElement>(ref, phaseRef) as Ref<HTMLDivElement>}
47
+ {...phaseProps(phase, vars, style)}
48
+ {...props}
49
+ />
50
+ </>
51
+ );
52
+ }
53
+
54
+ export interface StaggerProps extends HTMLAttributes<HTMLElement> {
55
+ /** Extra wait before the first child enters, in ms. */
56
+ delay?: number;
57
+ /** Start when the group first scrolls into view instead of on mount. */
58
+ inView?: boolean;
59
+ /**
60
+ * Longest gap between the first and the last child's start, in ms. Each step is a quarter of
61
+ * `--motion-duration`, shortened so long lists still fit in this span (default 1.5 durations).
62
+ */
63
+ maxStagger?: number;
64
+ /** Element that wraps the children, e.g. `ul` for a list of `li`. */
65
+ as?: "div" | "ul" | "ol" | "section";
66
+ ref?: Ref<HTMLElement>;
67
+ children?: ReactNode;
68
+ }
69
+
70
+ /**
71
+ * Its children enter one after another, like `Reveal`, with the whole sequence capped by
72
+ * `maxStagger`. Each child element receives `data-motion` and a `style` variable, so it must
73
+ * pass `style` and `data-*` props to its DOM element (every element and most components do).
74
+ */
75
+ export function Stagger({
76
+ delay,
77
+ inView = false,
78
+ maxStagger,
79
+ as: Tag = "div",
80
+ style,
81
+ ref,
82
+ children,
83
+ ...props
84
+ }: StaggerProps) {
85
+ const [phaseRef, phase] = useEnterPhase(inView);
86
+ const items = Children.toArray(children);
87
+ const vars: MotionVars = { "--ui-motion-n": Math.max(1, items.length - 1) };
88
+ if (maxStagger !== undefined) vars["--ui-motion-span"] = `${Math.max(0, maxStagger)}ms`;
89
+ const itemVars = (i: number): MotionVars => {
90
+ const next: MotionVars = { "--ui-motion-i": i };
91
+ if (delay) next["--ui-motion-delay"] = `${delay}ms`;
92
+ return next;
93
+ };
94
+ return (
95
+ <>
96
+ <MotionStyles />
97
+ <Tag
98
+ ref={composeRefs<HTMLElement>(ref, phaseRef) as Ref<never>}
99
+ data-motion-stagger={phase === "static" ? undefined : ""}
100
+ style={phase === "static" ? style : { ...vars, ...style }}
101
+ {...props}
102
+ >
103
+ {items.map((child, i) =>
104
+ isValidElement(child) ? (
105
+ <Slot key={child.key} {...phaseProps(phase, itemVars(i))}>
106
+ {child}
107
+ </Slot>
108
+ ) : (
109
+ child
110
+ ),
111
+ )}
112
+ </Tag>
113
+ </>
114
+ );
115
+ }
@@ -0,0 +1,50 @@
1
+ "use client";
2
+
3
+ import { type RefCallback, useEffect, useState, useSyncExternalStore } from "react";
4
+ import { usePrefersReducedMotion } from "../utils/reduced-motion.js";
5
+
6
+ const subscribeNever = () => () => {};
7
+
8
+ /**
9
+ * True when this component's first render came from server HTML (on the server and while
10
+ * hydrating), false when it mounted on the client. Fixed for the component's lifetime, so server
11
+ * markup is never animated after hydration and hydration always matches it.
12
+ */
13
+ export function useStartedOnServer(): boolean {
14
+ const hydrating = useSyncExternalStore(
15
+ subscribeNever,
16
+ () => false,
17
+ () => true,
18
+ );
19
+ const [started] = useState(hydrating);
20
+ return started;
21
+ }
22
+
23
+ /** `static`: no motion (server HTML or reduced motion). `wait`: hidden until in view. `enter`: animating in. */
24
+ export type EnterPhase = "static" | "wait" | "enter";
25
+
26
+ /** Phase of an enter animation, on mount or (with `inView`) when the element first scrolls into view. */
27
+ export function useEnterPhase(inView: boolean): [RefCallback<HTMLElement>, EnterPhase] {
28
+ const startedOnServer = useStartedOnServer();
29
+ const reduced = usePrefersReducedMotion();
30
+ const [seen, setSeen] = useState(!inView);
31
+ const [node, setNode] = useState<HTMLElement | null>(null);
32
+ const animate = !startedOnServer && !reduced;
33
+
34
+ useEffect(() => {
35
+ if (!animate || seen || !node) return;
36
+ if (typeof IntersectionObserver === "undefined") {
37
+ setSeen(true);
38
+ return;
39
+ }
40
+ const observer = new IntersectionObserver((entries) => {
41
+ if (!entries.some((entry) => entry.isIntersecting)) return;
42
+ observer.disconnect();
43
+ setSeen(true);
44
+ });
45
+ observer.observe(node);
46
+ return () => observer.disconnect();
47
+ }, [animate, seen, node]);
48
+
49
+ return [setNode, !animate ? "static" : seen ? "enter" : "wait"];
50
+ }