@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
@@ -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,76 @@ 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;
99
+ /** Name of the `PasswordInput` toggle; its pressed state says whether the password is visible. */
100
+ showPassword: string;
101
+ /** Default title of a `LoginForm`. */
102
+ signIn: string;
103
+ /** Label of the portal picker of a `LoginForm`. */
104
+ signInAs: string;
105
+ /** Divider between the portal picker and the credential fields. */
106
+ withYourAccount: string;
107
+ /** Default label and placeholder of the `LoginForm` identifier field. */
108
+ identifier: string;
109
+ /** Default label and placeholder of the `LoginForm` password field. */
110
+ password: string;
111
+ /** Default `LoginForm` link to recover a password. */
112
+ forgotPassword: string;
113
+ /** Submit button label of a `LoginForm`. */
114
+ signInAction: string;
115
+ /** Inline error of a `LoginForm` submitted without an identifier. */
116
+ enterIdentifier: string;
117
+ /** Inline error of a `LoginForm` submitted without a password. */
118
+ enterPassword: string;
119
+ /** Label of the remember-me checkbox of `LoginForm.Options`. */
120
+ rememberMe: string;
121
+ /** Default help link of `LoginForm.Options`. */
122
+ needHelp: string;
123
+ /** Default label of `LoginForm.Providers`. */
124
+ orLogInWith: string;
125
+ /** Message shown by a `LoginForm` when sign-in fails and the app gives none. */
126
+ signInFailed: string;
127
+ /** Default headline of the `statement` look of `AuthIllustration`. */
128
+ welcomeBack: string;
129
+ /** Line the `statement` look of `AuthIllustration` shows once sign-in succeeds. */
130
+ signedIn: string;
59
131
  }
60
132
 
61
133
  export type UiLocale = "en" | "es";
@@ -66,6 +138,8 @@ export const uiStrings = {
66
138
  close: "Close",
67
139
  loading: "Loading",
68
140
  optional: "optional",
141
+ save: "Save",
142
+ unsavedChanges: "Unsaved changes",
69
143
  cancel: "Cancel",
70
144
  confirm: "Confirm",
71
145
  processing: "Processing…",
@@ -108,12 +182,51 @@ export const uiStrings = {
108
182
  selectRow: "Select {row}",
109
183
  selectAll: "Select all rows",
110
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",
206
+ showPassword: "Show password",
207
+ signIn: "Sign in",
208
+ signInAs: "Sign in as",
209
+ withYourAccount: "with your account",
210
+ identifier: "Email or ID",
211
+ password: "Password",
212
+ forgotPassword: "Forgot your password?",
213
+ signInAction: "Sign in",
214
+ enterIdentifier: "Enter your email or ID.",
215
+ enterPassword: "Enter your password.",
216
+ rememberMe: "Remember me",
217
+ needHelp: "Need help?",
218
+ orLogInWith: "Or log in with",
219
+ signInFailed: "We could not sign you in. Check your details and try again.",
220
+ welcomeBack: "Good to see you again.",
221
+ signedIn: "You're in.",
111
222
  },
112
223
  es: {
113
224
  retry: "Reintentar",
114
225
  close: "Cerrar",
115
226
  loading: "Cargando",
116
227
  optional: "opcional",
228
+ save: "Guardar",
229
+ unsavedChanges: "Cambios sin guardar",
117
230
  cancel: "Cancelar",
118
231
  confirm: "Confirmar",
119
232
  processing: "Procesando…",
@@ -156,5 +269,42 @@ export const uiStrings = {
156
269
  selectRow: "Seleccionar {row}",
157
270
  selectAll: "Seleccionar todas las filas",
158
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",
293
+ showPassword: "Mostrar contraseña",
294
+ signIn: "Inicia sesión",
295
+ signInAs: "Ingresar como",
296
+ withYourAccount: "con tu cuenta",
297
+ identifier: "Correo o documento",
298
+ password: "Contraseña",
299
+ forgotPassword: "¿Olvidaste tu contraseña?",
300
+ signInAction: "Ingresar",
301
+ enterIdentifier: "Escribe tu correo o documento.",
302
+ enterPassword: "Escribe tu contraseña.",
303
+ rememberMe: "Recordarme",
304
+ needHelp: "¿Necesitas ayuda?",
305
+ orLogInWith: "O ingresa con",
306
+ signInFailed: "No pudimos iniciar tu sesión. Revisa tus datos e inténtalo de nuevo.",
307
+ welcomeBack: "Qué bueno verte otra vez.",
308
+ signedIn: "Ya estás dentro.",
159
309
  },
160
310
  } as const satisfies Record<UiLocale, UiStrings>;
@@ -0,0 +1,12 @@
1
+ // Generated by scripts/build-icons.mjs. Do not edit.
2
+ // Source: icons/svg/eye.svg
3
+ import { IconBase, type IconProps } from "./icon-base.js";
4
+
5
+ export function Eye(props: IconProps) {
6
+ return (
7
+ <IconBase {...props}>
8
+ <path d="M2.062 12.348a1 1 0 0 1 0-.696 10.75 10.75 0 0 1 19.876 0 1 1 0 0 1 0 .696 10.75 10.75 0 0 1-19.876 0" />
9
+ <circle cx="12" cy="12" r="3" />
10
+ </IconBase>
11
+ );
12
+ }
@@ -0,0 +1,13 @@
1
+ // Generated by scripts/build-icons.mjs. Do not edit.
2
+ // Source: icons/svg/graduation-cap.svg
3
+ import { IconBase, type IconProps } from "./icon-base.js";
4
+
5
+ export function GraduationCap(props: IconProps) {
6
+ return (
7
+ <IconBase {...props}>
8
+ <path d="M21.42 10.922a1 1 0 0 0-.019-1.838L12.83 5.18a2 2 0 0 0-1.66 0L2.6 9.08a1 1 0 0 0 0 1.832l8.57 3.908a2 2 0 0 0 1.66 0z" />
9
+ <path d="M22 10v6" />
10
+ <path d="M6 12.5V16a6 3 0 0 0 12 0v-3.5" />
11
+ </IconBase>
12
+ );
13
+ }
@@ -0,0 +1,12 @@
1
+ // Generated by scripts/build-icons.mjs. Do not edit.
2
+ // Source: icons/svg/house.svg
3
+ import { IconBase, type IconProps } from "./icon-base.js";
4
+
5
+ export function House(props: IconProps) {
6
+ return (
7
+ <IconBase {...props}>
8
+ <path d="M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8" />
9
+ <path d="M3 10a2 2 0 0 1 .709-1.528l7-5.999a2 2 0 0 1 2.582 0l7 5.999A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z" />
10
+ </IconBase>
11
+ );
12
+ }
@@ -54,6 +54,7 @@ export { CreditCard } from "./credit-card.js";
54
54
  export { Download } from "./download.js";
55
55
  export { EllipsisVertical } from "./ellipsis-vertical.js";
56
56
  export { ExternalLink } from "./external-link.js";
57
+ export { Eye } from "./eye.js";
57
58
  export { EyeOff } from "./eye-off.js";
58
59
  export { FaceSlightlySmiling } from "./face-slightly-smiling.js";
59
60
  export { FaceSlightlySmilingPlus } from "./face-slightly-smiling-plus.js";
@@ -66,8 +67,10 @@ export { Filter } from "./filter.js";
66
67
  export { Folder } from "./folder.js";
67
68
  export { FolderOpen } from "./folder-open.js";
68
69
  export { Funnel } from "./funnel.js";
70
+ export { GraduationCap } from "./graduation-cap.js";
69
71
  export { GripVertical } from "./grip-vertical.js";
70
72
  export { Heading2 } from "./heading-2.js";
73
+ export { House } from "./house.js";
71
74
  export { Inbox } from "./inbox.js";
72
75
  export { Info } from "./info.js";
73
76
  export { Italic } from "./italic.js";
@@ -84,6 +87,7 @@ export { ListOrdered } from "./list-ordered.js";
84
87
  export { LoaderCircle } from "./loader-circle.js";
85
88
  export { Lock } from "./lock.js";
86
89
  export { LogOut } from "./log-out.js";
90
+ export { Mail } from "./mail.js";
87
91
  export { MapPin } from "./map-pin.js";
88
92
  export { Menu } from "./menu.js";
89
93
  export { MessageCircle } from "./message-circle.js";
@@ -0,0 +1,12 @@
1
+ // Generated by scripts/build-icons.mjs. Do not edit.
2
+ // Source: icons/svg/mail.svg
3
+ import { IconBase, type IconProps } from "./icon-base.js";
4
+
5
+ export function Mail(props: IconProps) {
6
+ return (
7
+ <IconBase {...props}>
8
+ <path d="m22 7-8.991 5.727a2 2 0 0 1-2.009 0L2 7" />
9
+ <rect x="2" y="4" width="20" height="16" rx="2" />
10
+ </IconBase>
11
+ );
12
+ }
@@ -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
+ }