@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
@@ -91,6 +91,10 @@ const decls = (list) => list.map(([k, v]) => ` --${k}: ${v};`).join("\n");
91
91
  // that references another one is resolved where it is declared: a nested [data-style] must
92
92
  // re-declare the whole set instead of relying on :root's already-computed values.
93
93
  //
94
+ // data-density="auto" follows the pointer: the `fine` level, or the `coarse` one under
95
+ // @media (pointer: coarse). An explicit level on a nested element wins because it declares the
96
+ // same properties on that element itself.
97
+ //
94
98
  // Precedence on one element follows source order at equal specificity (:root[x] on the root,
95
99
  // [x] on a nested element): themes < accents < presets < density < radius. A preset's dark
96
100
  // values use :root[data-theme] in front of the attribute, so they outrank the theme block.
@@ -140,7 +144,7 @@ export function stylesOf(tokens) {
140
144
 
141
145
  const density = styles.density ?? { levels: [] };
142
146
  const densityGoverned = new Set(
143
- density.levels.length ? ["density", ...(density.scaled ?? [])] : [],
147
+ density.levels.length ? ["density", ...(density.scaled ?? []), ...(density.fixed ?? [])] : [],
144
148
  );
145
149
  for (const name of densityGoverned) {
146
150
  known(name, "density");
@@ -148,6 +152,16 @@ export function stylesOf(tokens) {
148
152
  throw new Error(`styles: density token "${name}" is themed`);
149
153
  }
150
154
 
155
+ const levelIds = new Set(density.levels.map((l) => l.id));
156
+ if (density.auto) {
157
+ if (levelIds.has("auto"))
158
+ throw new Error('styles: "auto" is reserved and cannot be a density level');
159
+ for (const side of ["fine", "coarse"]) {
160
+ if (!levelIds.has(density.auto[side]))
161
+ throw new Error(`styles: density auto.${side} names unknown level "${density.auto[side]}"`);
162
+ }
163
+ }
164
+
151
165
  for (const level of density.levels) {
152
166
  for (const name of Object.keys(level.values ?? {})) {
153
167
  if (!densityGoverned.has(name) || name === "density")
@@ -208,12 +222,28 @@ function buildStyleBlocks(tokens) {
208
222
  blocks.push(...variantBlocks("data-style", p.id, entries, themes));
209
223
  }
210
224
 
211
- for (const level of s.density.levels) {
212
- const entries = s.densityGoverned.map((name) => {
225
+ const fixed = new Set(s.density.fixed ?? []);
226
+ const densityEntries = (level) =>
227
+ s.densityGoverned.map((name) => {
213
228
  if (name === "density") return [name, String(level.density)];
214
- return [name, level.values?.[name] ?? `calc(${s.byName.get(name).value} * var(--density))`];
229
+ const base = s.byName.get(name).value;
230
+ return [
231
+ name,
232
+ level.values?.[name] ?? (fixed.has(name) ? base : `calc(${base} * var(--density))`),
233
+ ];
215
234
  });
216
- blocks.push(...variantBlocks("data-density", level.id, entries, themes));
235
+ for (const level of s.density.levels) {
236
+ blocks.push(...variantBlocks("data-density", level.id, densityEntries(level), themes));
237
+ }
238
+
239
+ // data-density="auto": one side per pointer type. Both sides redeclare the whole set, so a
240
+ // nested [data-density="auto"] resets whatever an explicit level above it declared.
241
+ const auto = s.density.auto;
242
+ if (auto) {
243
+ const side = (id) => densityEntries(s.density.levels.find((l) => l.id === id));
244
+ blocks.push(...variantBlocks("data-density", "auto", side(auto.fine), themes));
245
+ const coarse = variantBlocks("data-density", "auto", side(auto.coarse), themes)[0];
246
+ blocks.push(`@media (pointer: coarse) {\n${indent(coarse)}\n}`);
217
247
  }
218
248
 
219
249
  for (const level of s.radiusLevels) {
@@ -327,6 +357,17 @@ export function buildThemeCss(tokens) {
327
357
  for (const s of tokens.type?.sizeScale ?? []) {
328
358
  lines.push(` --text-${s.name}: ${s.fontSize};`);
329
359
  }
360
+ for (const [name, width] of Object.entries(tokens.containers ?? {})) {
361
+ if (!TONE_NAME.test(name)) {
362
+ throw new Error(
363
+ `containers: "${name}" must be kebab-case (lowercase letters, digits, hyphens)`,
364
+ );
365
+ }
366
+ if (!/^\d+(\.\d+)?(px|rem)$/.test(width)) {
367
+ throw new Error(`containers.${name}: "${width}" must be a literal px or rem width`);
368
+ }
369
+ lines.push(` --container-${name}: ${width};`);
370
+ }
330
371
  const styles = stylesOf(tokens);
331
372
  for (const [themeVar, name] of Object.entries(tokens.styles?.tailwind ?? {})) {
332
373
  if (!styles.byName.has(name)) throw new Error(`styles.tailwind: unknown token "${name}"`);
@@ -90,7 +90,7 @@ export function CodeBlock({
90
90
  // biome-ignore lint/a11y/noNoninteractiveTabindex: scrollable region must be keyboard reachable
91
91
  tabIndex={0}
92
92
  className={cn(
93
- "m-0 p-3 font-mono text-fs-125 leading-relaxed focus-visible:focus-ring",
93
+ "m-0 p-3 font-mono text-fs-120 leading-relaxed focus-visible:focus-ring",
94
94
  wrap ? "whitespace-pre-wrap break-words" : "overflow-x-auto",
95
95
  classNames?.pre,
96
96
  )}
@@ -4,8 +4,8 @@ import { cn } from "../../utils/cn.js";
4
4
  export type BigDateSize = "normal" | "compact";
5
5
 
6
6
  const sizeClasses: Record<BigDateSize, string> = {
7
- normal: "text-fs-300",
8
- compact: "text-fs-220",
7
+ normal: "text-fs-240",
8
+ compact: "text-fs-200",
9
9
  };
10
10
 
11
11
  export interface BigDateProps extends ComponentPropsWithoutRef<"div"> {
@@ -5,6 +5,7 @@ import {
5
5
  type ComponentPropsWithRef,
6
6
  Fragment,
7
7
  isValidElement,
8
+ type MouseEvent,
8
9
  type ReactNode,
9
10
  } from "react";
10
11
  import { useUiStrings } from "../../i18n/index.js";
@@ -19,21 +20,25 @@ export type ButtonSize = "sm" | "md" | "lg";
19
20
  * `cn(buttonVariantClasses.primary, "bg-brand")` on a link, or `{ ...buttonVariantClasses, brand: "..." }`.
20
21
  */
21
22
  export const buttonVariantClasses: Readonly<Record<ButtonVariant, string>> = {
22
- primary: "bg-accent text-on-accent font-bold hover:bg-accent-ink",
23
+ primary: "bg-accent text-on-accent font-bold hover:bg-accent-ink hover:text-surface",
23
24
  secondary: "bg-surface-control text-ink shadow-control hover:bg-surface-2",
24
25
  ghost: "bg-transparent text-ink-2 hover:bg-surface-2 hover:text-ink",
25
26
  danger: "bg-danger-soft text-danger hover:bg-danger-soft/70",
26
27
  };
27
28
 
28
- /** Class map behind each `size`; exported like {@link buttonVariantClasses}. */
29
+ /**
30
+ * Class map behind each `size`; exported like {@link buttonVariantClasses}. `sm` and `md` take the
31
+ * shared control heights (`--control-height-sm`, `--control-height-md`), so a button lines up with an
32
+ * `Input`, `Select`, `Combobox`, `DatePicker` or `TimeInput` of the same size.
33
+ */
29
34
  export const buttonSizeClasses: Readonly<Record<ButtonSize, string>> = {
30
- sm: "h-control-sm px-3 text-fs-125 [&_svg]:size-3.5",
31
- md: "h-control px-control-x text-fs-130",
35
+ sm: "h-control-sm px-3 text-fs-120 [&_svg]:size-3.5",
36
+ md: "h-control-md px-control-x text-fs-130",
32
37
  lg: "h-control-lg px-control-x text-fs-140",
33
38
  };
34
39
 
35
40
  const baseClasses =
36
- "inline-flex min-w-0 max-w-full cursor-pointer items-center justify-center gap-1.5 whitespace-nowrap rounded-button pressable focus-visible:focus-ring font-[650] no-underline disabled:cursor-not-allowed disabled:opacity-45 [&_svg]:shrink-0";
41
+ "inline-flex min-w-0 max-w-full cursor-pointer items-center justify-center gap-1.5 whitespace-nowrap rounded-button pressable focus-visible:focus-ring font-[650] no-underline disabled:cursor-not-allowed disabled:opacity-45 aria-busy:cursor-progress aria-busy:scale-none! [&_svg]:shrink-0";
37
42
 
38
43
  export interface ButtonClassOptions {
39
44
  variant?: ButtonVariant;
@@ -63,7 +68,15 @@ export function buttonClasses({
63
68
 
64
69
  export interface ButtonProps extends ComponentPropsWithRef<"button"> {
65
70
  variant?: ButtonVariant;
71
+ /** `sm` is 30px and `md` (default) 38px, the heights every form control shares; `lg` is 52px. */
66
72
  size?: ButtonSize;
73
+ /**
74
+ * Busy state: the button keeps its focus and its full colour, ignores clicks (a submit button no
75
+ * longer submits, including the implicit submit from Enter in a field of its form) and is exposed
76
+ * as `aria-disabled` and `aria-busy`. It is not natively `disabled`, so keyboard focus stays on it
77
+ * while the work runs; pass `disabled` for a button that must leave the tab order. The visible
78
+ * cue is `loadingLabel` or a spinner among the children: without either only the cursor changes.
79
+ */
67
80
  loading?: boolean;
68
81
  /**
69
82
  * Replaces the children while `loading` and is announced to screen readers. Without it the
@@ -86,9 +99,12 @@ export function Button({
86
99
  asChild,
87
100
  className,
88
101
  children,
102
+ onClick,
89
103
  ...props
90
104
  }: ButtonProps) {
91
105
  const strings = useUiStrings();
106
+ // Natively disabled wins; a busy button stays focusable and swallows its activation instead.
107
+ const busy = Boolean(loading) && !disabled;
92
108
  const Comp = asChild ? Slot : "button";
93
109
  // Text runs get their own truncating span so a long label ends in "…" inside a narrow
94
110
  // container instead of overflowing; icons keep their size. Slot needs its single child as is.
@@ -102,9 +118,11 @@ export function Button({
102
118
  <Comp
103
119
  {...(asChild ? {} : { type: "button" })}
104
120
  aria-busy={loading ? "true" : undefined}
105
- disabled={disabled || loading}
121
+ aria-disabled={busy || undefined}
122
+ disabled={disabled}
106
123
  className={buttonClasses({ variant, size, block, className })}
107
124
  {...props}
125
+ onClick={busy ? ignoreClick : onClick}
108
126
  >
109
127
  {content}
110
128
  </Comp>
@@ -120,6 +138,15 @@ export function Button({
120
138
  );
121
139
  }
122
140
 
141
+ /**
142
+ * Cancels the activation of a busy button: no handler runs, a submit button does not submit (an
143
+ * implicit submit from Enter in a field is a click on this button too) and a slotted link does not
144
+ * navigate.
145
+ */
146
+ function ignoreClick(event: MouseEvent<HTMLElement>): void {
147
+ event.preventDefault();
148
+ }
149
+
123
150
  function labelRun(child: ReactNode): ReactNode {
124
151
  if (typeof child === "string" || typeof child === "number") {
125
152
  return <span className="min-w-0 truncate">{child}</span>;
@@ -37,7 +37,7 @@ export type ChipSize = "sm" | "md";
37
37
  /** Class map behind each `size`; exported like `chipToneClasses`. */
38
38
  export const chipSizeClasses: Readonly<Record<ChipSize, string>> = {
39
39
  md: "h-6 px-2.5 font-[650] text-fs-120",
40
- sm: "h-auto min-h-5 px-1.5 py-px font-medium text-fs-115 tabular-nums",
40
+ sm: "h-auto min-h-5 px-1.5 py-px font-medium text-fs-120 tabular-nums",
41
41
  };
42
42
 
43
43
  export interface ChipProps extends ComponentPropsWithRef<"span"> {
@@ -53,6 +53,11 @@ export interface ChipProps extends ComponentPropsWithRef<"span"> {
53
53
  icon?: ReactNode;
54
54
  /** Prefix `info`, `success`, `warning` and `danger` chips with their status glyph. */
55
55
  statusIcon?: boolean;
56
+ /**
57
+ * A chip with `onClick` (or `role="button"`) is interactive and never shorter than 30px
58
+ * (`--control-height-sm`), the smallest hit area of the kit, whatever its `size`.
59
+ */
60
+ onClick?: ComponentPropsWithRef<"span">["onClick"];
56
61
  /** Appends a remove button that calls this. */
57
62
  onRemove?: () => void;
58
63
  /** Accessible name of the remove button. Defaults to the localized "Remove". */
@@ -90,7 +95,7 @@ export function Chip({
90
95
  custom
91
96
  ? "bg-(--tone-c-soft) text-(--tone-c-ink)"
92
97
  : (chipToneClasses[tone as ChipBuiltinTone] ?? chipToneClasses.neutral),
93
- (interactive || onRemove) && "in-data-[density=touch]:min-h-11",
98
+ interactive ? "min-h-control-sm" : onRemove && "min-h-(--touch-target)",
94
99
  onRemove && "pr-1",
95
100
  className,
96
101
  )}
@@ -104,7 +109,7 @@ export function Chip({
104
109
  type="button"
105
110
  aria-label={removeLabel ?? strings.remove}
106
111
  onClick={onRemove}
107
- className="grid size-4 shrink-0 cursor-pointer place-items-center self-center rounded-full text-current opacity-70 hover:opacity-100 focus-visible:focus-ring in-data-[density=touch]:size-11 in-data-[density=touch]:-mr-2"
112
+ className="-mr-[calc(0.5rem*var(--touch))] grid size-[calc(1rem+1.75rem*var(--touch))] shrink-0 cursor-pointer place-items-center self-center rounded-full text-current opacity-70 hover:opacity-100 focus-visible:focus-ring"
108
113
  >
109
114
  <X aria-hidden="true" />
110
115
  </button>
@@ -0,0 +1,40 @@
1
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
+ import type { ClassNames } from "../../utils/class-names.js";
3
+ import { cn } from "../../utils/cn.js";
4
+
5
+ export type DividerPart = "root" | "line" | "label";
6
+
7
+ export interface DividerProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
8
+ /** Text centered on the rule. Without it the divider is a plain hairline. */
9
+ children?: ReactNode;
10
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
11
+ classNames?: ClassNames<DividerPart>;
12
+ }
13
+
14
+ /**
15
+ * Horizontal rule, optionally carrying a short label ("or", "with your account"). It is a
16
+ * separator for assistive technology, so the label is read as part of the separator's name
17
+ * rather than as page content.
18
+ */
19
+ export function Divider({ children, className, classNames, ...props }: DividerProps) {
20
+ const labelled = children !== undefined && children !== null && children !== false;
21
+ const line = cn("h-px min-w-0 flex-1 bg-line", classNames?.line);
22
+ return (
23
+ // biome-ignore lint/a11y/useSemanticElements: an <hr> cannot carry the label between the two rules
24
+ <div
25
+ role="separator"
26
+ aria-orientation="horizontal"
27
+ aria-label={labelled && typeof children === "string" ? children : undefined}
28
+ {...props}
29
+ className={cn("flex items-center gap-3 text-ink-3 text-meta", classNames?.root, className)}
30
+ >
31
+ <span aria-hidden="true" className={line} />
32
+ {labelled ? (
33
+ <span aria-hidden="true" className={cn("shrink-0", classNames?.label)}>
34
+ {children}
35
+ </span>
36
+ ) : null}
37
+ {labelled ? <span aria-hidden="true" className={line} /> : null}
38
+ </div>
39
+ );
40
+ }
@@ -0,0 +1 @@
1
+ export * from "./divider.js";
@@ -10,7 +10,7 @@ export type IconButtonSize = ButtonSize;
10
10
  /** Width behind each `size`; the height comes from the matching `Button` size, so the button is square. */
11
11
  export const iconButtonSizeClasses: Readonly<Record<IconButtonSize, string>> = {
12
12
  sm: "w-control-sm",
13
- md: "w-control [&_svg]:size-4",
13
+ md: "w-control-md [&_svg]:size-4",
14
14
  lg: "w-control-lg [&_svg]:size-4",
15
15
  };
16
16
 
@@ -20,7 +20,7 @@ export interface IconButtonProps
20
20
  label: string;
21
21
  variant?: ButtonVariant;
22
22
  size?: IconButtonSize;
23
- /** Swaps the icon for a spinner and disables the button; announces the localized `loading` string. */
23
+ /** Swaps the icon for a spinner and makes the button busy like `Button` `loading`: it keeps focus, ignores clicks and announces the localized `loading` string. */
24
24
  loading?: boolean;
25
25
  /** Render the child element (via Slot) instead of a `<button>`, e.g. a link wrapping the icon. */
26
26
  asChild?: boolean;
@@ -4,6 +4,7 @@ export * from "./big-date/index.js";
4
4
  export * from "./button/index.js";
5
5
  export * from "./checkbox/index.js";
6
6
  export * from "./chip/index.js";
7
+ export * from "./divider/index.js";
7
8
  export * from "./due-chip/index.js";
8
9
  export * from "./icon/index.js";
9
10
  export * from "./icon-button/index.js";
@@ -1,7 +1,8 @@
1
1
  /**
2
- * Invisible 44px hit target for a small control under `data-density="touch"`. It is a pseudo
3
- * element centred on the control, so the visual box and the layout never change; the control must
4
- * be `relative`. Default density adds nothing.
2
+ * Invisible 44px hit target for a small control under `data-density="touch"` (and `"auto"` on a
3
+ * coarse pointer). It is a pseudo element of `--touch-target` size centred on the control, so the
4
+ * visual box and the layout never change; the control must be `relative`. Other densities size it
5
+ * to 0.
5
6
  */
6
7
  export const touchHitArea =
7
- "relative in-data-[density=touch]:after:absolute in-data-[density=touch]:after:top-1/2 in-data-[density=touch]:after:left-1/2 in-data-[density=touch]:after:size-11 in-data-[density=touch]:after:-translate-1/2 in-data-[density=touch]:after:content-['']";
8
+ "relative after:absolute after:top-1/2 after:left-1/2 after:size-(--touch-target) after:-translate-1/2 after:content-['']";
@@ -1 +1,8 @@
1
- export { Meter, Progress, type ProgressPart, type ProgressProps } from "./progress.js";
1
+ export {
2
+ Meter,
3
+ Progress,
4
+ type ProgressBuiltinTone,
5
+ type ProgressPart,
6
+ type ProgressProps,
7
+ type ProgressTone,
8
+ } from "./progress.js";
@@ -3,6 +3,23 @@
3
3
  import type { ComponentPropsWithoutRef } from "react";
4
4
  import type { ClassNames } from "../../utils/class-names.js";
5
5
  import { cn } from "../../utils/cn.js";
6
+ import { customToneStyle, isCustomTone } from "../../utils/tone.js";
7
+
8
+ export type ProgressBuiltinTone = "accent" | "neutral" | "success" | "warning" | "danger" | "info";
9
+
10
+ /** A built-in tone, or the name of a tone declared in `tonePalettes`. */
11
+ export type ProgressTone = ProgressBuiltinTone | (string & {});
12
+
13
+ const toneClasses: Record<ProgressBuiltinTone, string> = {
14
+ accent: "bg-accent",
15
+ neutral: "bg-ink-3",
16
+ success: "bg-success",
17
+ warning: "bg-warning",
18
+ danger: "bg-danger",
19
+ info: "bg-info",
20
+ };
21
+
22
+ const builtinTones = new Set<string>(Object.keys(toneClasses));
6
23
 
7
24
  const DEFAULT_MAX = 100;
8
25
 
@@ -13,6 +30,8 @@ export interface ProgressProps extends Omit<ComponentPropsWithoutRef<"div">, "ch
13
30
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
14
31
  classNames?: ClassNames<ProgressPart>;
15
32
  max?: number;
33
+ /** Colour of the indicator. Defaults to `"accent"`. The value is always exposed through the progressbar semantics, never by colour alone. */
34
+ tone?: ProgressTone;
16
35
  /** Text announced as `aria-valuetext`; defaults to the rounded percentage. */
17
36
  getValueLabel?: (value: number, max: number) => string;
18
37
  }
@@ -33,8 +52,10 @@ export function Progress({
33
52
  value,
34
53
  max: maxProp = DEFAULT_MAX,
35
54
  getValueLabel = defaultGetValueLabel,
55
+ tone = "accent",
36
56
  className,
37
57
  classNames,
58
+ style,
38
59
  ...props
39
60
  }: ProgressProps) {
40
61
  const max = isValidMax(maxProp) ? maxProp : DEFAULT_MAX;
@@ -51,6 +72,8 @@ export function Progress({
51
72
  data-state={state}
52
73
  data-value={current ?? undefined}
53
74
  data-max={max}
75
+ data-tone={tone === "accent" ? undefined : tone}
76
+ style={customToneStyle(tone, builtinTones, style)}
54
77
  className={cn("h-1.5 overflow-hidden rounded-pill bg-track", classNames?.root, className)}
55
78
  {...props}
56
79
  >
@@ -58,7 +81,13 @@ export function Progress({
58
81
  data-state={state}
59
82
  data-value={current ?? undefined}
60
83
  data-max={max}
61
- className={cn("block h-full bg-accent transition-transform", classNames?.indicator)}
84
+ className={cn(
85
+ "block h-full transition-transform",
86
+ isCustomTone(tone, builtinTones)
87
+ ? "bg-(--tone-c)"
88
+ : (toneClasses[tone as ProgressBuiltinTone] ?? toneClasses.accent),
89
+ classNames?.indicator,
90
+ )}
62
91
  style={{ transform: `translateX(-${100 - ((current ?? 0) / max) * 100}%)` }}
63
92
  />
64
93
  </div>
@@ -53,7 +53,7 @@ export function RadioGroup({ options, className, classNames, ...props }: RadioGr
53
53
  key={option.value}
54
54
  htmlFor={id}
55
55
  className={cn(
56
- "flex cursor-pointer items-start gap-2 rounded-control border-divider p-2.5 text-body in-data-[density=touch]:min-h-11 has-[[data-state=checked]]:border-accent has-[[data-state=checked]]:shadow-[inset_0_0_0_1px_var(--accent)]",
56
+ "flex cursor-pointer items-start gap-2 rounded-control border-divider p-2.5 text-body min-h-(--touch-target) has-[[data-state=checked]]:border-accent has-[[data-state=checked]]:shadow-[inset_0_0_0_1px_var(--accent)]",
57
57
  classNames?.option,
58
58
  )}
59
59
  >
@@ -1,47 +1,88 @@
1
1
  "use client";
2
2
 
3
- import type { ComponentPropsWithRef } from "react";
3
+ import type { ComponentPropsWithRef, ReactNode } from "react";
4
4
  import type { ClassNames } from "../../utils/class-names.js";
5
5
  import { cn } from "../../utils/cn.js";
6
6
  import { Led, type LedStatus } from "../led/index.js";
7
7
 
8
- export type StatusPillPart = "root" | "dot" | "label";
8
+ export type StatusPillPart = "root" | "icon" | "dot" | "label";
9
9
 
10
10
  export interface StatusPillProps
11
11
  extends Omit<ComponentPropsWithRef<"button">, "children" | "onSelect"> {
12
12
  status: LedStatus;
13
13
  label: string;
14
- /** Without this the pill is decorative (disabled). */
14
+ /** Decorative leading icon, hidden from screen readers; the label still names the status. */
15
+ icon?: ReactNode;
16
+ /** Shows the status dot. Defaults to `true` without an `icon` and `false` with one, where the icon carries the look; the label still names the status either way. */
17
+ dot?: boolean;
18
+ /** Hides the visible label when the surrounding container is narrower than 700 px (the status stays announced). Defaults to `false`: the label is always visible. */
19
+ collapseLabel?: boolean;
20
+ /** Makes the pill a button. Without it, and without `onClick`, the pill is a plain `span`. */
15
21
  onSelect?: () => void;
22
+ /**
23
+ * Forces the element: `true` renders a button even without a handler, `false` a `span` even
24
+ * with one. Omitted, the pill is a button only when `onSelect` or `onClick` is given.
25
+ */
26
+ interactive?: boolean;
16
27
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
17
28
  classNames?: ClassNames<StatusPillPart>;
18
29
  }
19
30
 
20
- /** Pill showing a status LED and its label; the label is hidden when the surrounding container (e.g. the topbar) is narrow. */
31
+ /** Pill showing a status LED and its label; `collapseLabel` hides the label when the surrounding container is narrow. */
21
32
  export function StatusPill({
22
33
  status,
23
34
  label,
35
+ icon,
36
+ dot,
37
+ collapseLabel = false,
24
38
  onSelect,
39
+ interactive,
25
40
  className,
26
41
  classNames,
27
42
  ...props
28
43
  }: StatusPillProps) {
29
- return (
30
- <button
31
- type="button"
32
- onClick={onSelect}
33
- disabled={!onSelect}
34
- {...props}
35
- className={cn(
36
- "flex h-control-sm shrink-0 items-center gap-1.5 whitespace-nowrap rounded-badge border-divider bg-surface-control px-2.5 font-semibold text-fs-120 text-ink-2 hover:enabled:border-line-strong disabled:cursor-default",
37
- classNames?.root,
38
- className,
39
- )}
40
- >
41
- <Led status={status} label={label} classNames={{ dot: classNames?.dot }} />
42
- <span aria-hidden="true" className={cn("@max-[700px]:hidden", classNames?.label)}>
44
+ const isButton = interactive ?? (onSelect !== undefined || props.onClick !== undefined);
45
+ const showDot = dot ?? icon == null;
46
+ const rootClass = cn(
47
+ "flex h-control-sm shrink-0 items-center gap-1.5 whitespace-nowrap rounded-badge border-divider bg-surface-control px-2.5 font-semibold text-fs-120 text-ink-2",
48
+ isButton && "hover:enabled:border-line-strong disabled:cursor-default",
49
+ classNames?.root,
50
+ className,
51
+ );
52
+ const content = (
53
+ <>
54
+ {icon ? (
55
+ <span
56
+ aria-hidden="true"
57
+ className={cn("inline-flex shrink-0 [&_svg]:size-3.5", classNames?.icon)}
58
+ >
59
+ {icon}
60
+ </span>
61
+ ) : null}
62
+ <Led
63
+ status={status}
64
+ label={label}
65
+ classNames={{ dot: cn(!showDot && "hidden", classNames?.dot) }}
66
+ />
67
+ <span
68
+ aria-hidden="true"
69
+ className={cn(collapseLabel && "@max-[700px]:hidden", classNames?.label)}
70
+ >
43
71
  {label}
44
72
  </span>
73
+ </>
74
+ );
75
+ if (!isButton) {
76
+ const { ref, type: _type, disabled: _disabled, onClick: _onClick, ...rest } = props;
77
+ return (
78
+ <span {...(rest as ComponentPropsWithRef<"span">)} ref={ref as never} className={rootClass}>
79
+ {content}
80
+ </span>
81
+ );
82
+ }
83
+ return (
84
+ <button type="button" onClick={onSelect} {...props} className={rootClass}>
85
+ {content}
45
86
  </button>
46
87
  );
47
88
  }
@@ -0,0 +1,100 @@
1
+ "use client";
2
+
3
+ import {
4
+ type ComponentPropsWithoutRef,
5
+ type ReactNode,
6
+ useEffect,
7
+ useId,
8
+ useRef,
9
+ useState,
10
+ } from "react";
11
+ import { cn } from "../../utils/cn.js";
12
+ import { useOptionalAuth } from "../internal/auth-context.js";
13
+ import { AuthStyles } from "../internal/auth-styles.js";
14
+ import { Slabs } from "../slabs/slabs.js";
15
+ import type { AuthLook } from "./look.js";
16
+ import { type AuthState, clamp01, ERROR_HOLD_MS, shownState } from "./model.js";
17
+ import { useArtPointer } from "./use-art-pointer.js";
18
+
19
+ export interface AuthIllustrationProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
20
+ /**
21
+ * The look, a component from its own entry (`Stack` from `@jcsoftdev/ui/auth/stack`, and so on).
22
+ * Defaults to `Slabs`; looks you do not pass stay out of your bundle. For a string `variant`
23
+ * use `AuthIllustrationAny` from `@jcsoftdev/ui/auth/looks`.
24
+ */
25
+ look?: AuthLook;
26
+ /** What the screen is doing. Inside an `AuthLayout` it follows the layout's state. */
27
+ state?: AuthState;
28
+ /** Fill of the whole form, 0 to 1. Inside an `AuthLayout` it follows the layout's progress. */
29
+ progress?: number;
30
+ /** Index of the portal being used (0 to 2); that slab rises above the others. */
31
+ activeIndex?: number;
32
+ /**
33
+ * Accessible name of the image. Without it the illustration is decorative and hidden from
34
+ * assistive technology. Ignored by text looks (`Statement`): their text is the content, so they
35
+ * are never an `img` and never hidden.
36
+ */
37
+ label?: string;
38
+ /** Text looks (`Statement`) only: the headline (a string animates word by word). Defaults to the UI string `welcomeBack`. */
39
+ headline?: ReactNode;
40
+ /** Text looks only: a supporting line under the headline. */
41
+ caption?: ReactNode;
42
+ /** Text looks only: content beside the arrow pill, such as a link. */
43
+ action?: ReactNode;
44
+ }
45
+
46
+ /**
47
+ * Isometric illustration of the three portals that reacts to the sign-in state with CSS
48
+ * transitions only. Colours come from the theme tokens (`--accent`, `--surface`, `--ink`), so dark
49
+ * mode and every accent apply on their own. With reduced motion it rests assembled and still.
50
+ */
51
+ export function AuthIllustration({
52
+ look: Look = Slabs,
53
+ state: stateProp,
54
+ progress: progressProp,
55
+ activeIndex: activeIndexProp,
56
+ label,
57
+ headline,
58
+ caption,
59
+ action,
60
+ className,
61
+ ...props
62
+ }: AuthIllustrationProps) {
63
+ const auth = useOptionalAuth();
64
+ const uid = useId().replace(/[^a-zA-Z0-9_-]/g, "");
65
+ const state = stateProp ?? auth?.state ?? "idle";
66
+ const progress = clamp01(progressProp ?? auth?.progress ?? 0);
67
+ const activeIndex = activeIndexProp ?? auth?.activeIndex ?? 0;
68
+ const ref = useRef<HTMLDivElement>(null);
69
+ useArtPointer(ref);
70
+ const [errorHeld, setErrorHeld] = useState(false);
71
+ useEffect(() => {
72
+ setErrorHeld(false);
73
+ if (state !== "error") return;
74
+ const timer = setTimeout(() => setErrorHeld(true), ERROR_HOLD_MS);
75
+ return () => clearTimeout(timer);
76
+ }, [state]);
77
+ const shown = shownState(state, errorHeld);
78
+ return (
79
+ <div
80
+ {...props}
81
+ ref={ref}
82
+ {...(Look.text ? {} : label ? { role: "img", "aria-label": label } : { "aria-hidden": true })}
83
+ data-state={shown}
84
+ data-panel={auth?.panel}
85
+ data-variant={Look.variant}
86
+ className={cn("ui-auth-art @container/art w-full min-w-0", className)}
87
+ >
88
+ <AuthStyles />
89
+ <Look
90
+ state={shown}
91
+ progress={progress}
92
+ activeIndex={activeIndex}
93
+ uid={uid}
94
+ headline={headline}
95
+ caption={caption}
96
+ action={action}
97
+ />
98
+ </div>
99
+ );
100
+ }
@@ -0,0 +1,8 @@
1
+ export * from "./auth-illustration.js";
2
+ export type { AuthLook, AuthVariantProps } from "./look.js";
3
+ export {
4
+ AUTH_STATES,
5
+ type AuthState,
6
+ slabPlacement,
7
+ slabSpread,
8
+ } from "./model.js";