@jcsoftdev/ui 0.3.0 → 0.5.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 (383) hide show
  1. package/CHANGELOG.md +200 -1
  2. package/README.md +56 -3
  3. package/bin/ui-theme.mjs +13 -2
  4. package/dist/atoms/button/button.d.ts +8 -1
  5. package/dist/atoms/button/button.js +10 -3
  6. package/dist/atoms/checkbox/checkbox.js +3 -1
  7. package/dist/atoms/chip/chip.d.ts +11 -3
  8. package/dist/atoms/chip/chip.js +8 -1
  9. package/dist/atoms/chip/index.d.ts +1 -1
  10. package/dist/atoms/chip/index.js +2 -0
  11. package/dist/atoms/divider/divider.d.ts +15 -0
  12. package/dist/atoms/divider/divider.js +27 -0
  13. package/dist/atoms/divider/index.d.ts +1 -0
  14. package/dist/atoms/divider/index.js +1 -0
  15. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  16. package/dist/atoms/due-chip/due-chip.js +41 -0
  17. package/dist/atoms/due-chip/index.d.ts +2 -0
  18. package/dist/atoms/due-chip/index.js +6 -0
  19. package/dist/atoms/due-chip/model.d.ts +25 -0
  20. package/dist/atoms/due-chip/model.js +44 -0
  21. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  22. package/dist/atoms/icon-button/icon-button.js +38 -0
  23. package/dist/atoms/icon-button/index.d.ts +1 -0
  24. package/dist/atoms/icon-button/index.js +8 -0
  25. package/dist/atoms/index.d.ts +6 -0
  26. package/dist/atoms/index.js +6 -0
  27. package/dist/atoms/internal/hit-area.d.ts +6 -0
  28. package/dist/atoms/internal/hit-area.js +4 -0
  29. package/dist/atoms/kbd/index.d.ts +1 -0
  30. package/dist/atoms/kbd/index.js +4 -0
  31. package/dist/atoms/kbd/kbd.d.ts +7 -0
  32. package/dist/atoms/kbd/kbd.js +17 -0
  33. package/dist/atoms/radio-group/radio-group.js +6 -2
  34. package/dist/atoms/seal/index.d.ts +1 -0
  35. package/dist/atoms/seal/index.js +4 -0
  36. package/dist/atoms/seal/seal.d.ts +30 -0
  37. package/dist/atoms/seal/seal.js +71 -0
  38. package/dist/atoms/spinner/index.d.ts +1 -0
  39. package/dist/atoms/spinner/index.js +5 -0
  40. package/dist/atoms/spinner/spinner.d.ts +19 -0
  41. package/dist/atoms/spinner/spinner.js +31 -0
  42. package/dist/atoms/switch/switch.js +3 -1
  43. package/dist/auth/auth-illustration/auth-illustration.d.ts +35 -0
  44. package/dist/auth/auth-illustration/auth-illustration.js +72 -0
  45. package/dist/auth/auth-illustration/index.d.ts +3 -0
  46. package/dist/auth/auth-illustration/index.js +11 -0
  47. package/dist/auth/auth-illustration/look.d.ts +30 -0
  48. package/dist/auth/auth-illustration/look.js +0 -0
  49. package/dist/auth/auth-illustration/model.d.ts +133 -0
  50. package/dist/auth/auth-illustration/model.js +202 -0
  51. package/dist/auth/auth-illustration/use-art-pointer.d.ts +9 -0
  52. package/dist/auth/auth-illustration/use-art-pointer.js +69 -0
  53. package/dist/auth/auth-layout/auth-layout.d.ts +80 -0
  54. package/dist/auth/auth-layout/auth-layout.js +190 -0
  55. package/dist/auth/auth-layout/index.d.ts +1 -0
  56. package/dist/auth/auth-layout/index.js +1 -0
  57. package/dist/auth/character/character.d.ts +12 -0
  58. package/dist/auth/character/character.js +333 -0
  59. package/dist/auth/character/index.d.ts +1 -0
  60. package/dist/auth/character/index.js +1 -0
  61. package/dist/auth/index.d.ts +4 -0
  62. package/dist/auth/index.js +4 -0
  63. package/dist/auth/internal/auth-context.d.ts +17 -0
  64. package/dist/auth/internal/auth-context.js +10 -0
  65. package/dist/auth/internal/auth-styles.d.ts +1 -0
  66. package/dist/auth/internal/auth-styles.js +29 -0
  67. package/dist/auth/internal/portal-glyphs.d.ts +6 -0
  68. package/dist/auth/internal/portal-glyphs.js +39 -0
  69. package/dist/auth/login-form/context.d.ts +51 -0
  70. package/dist/auth/login-form/context.js +12 -0
  71. package/dist/auth/login-form/index.d.ts +2 -0
  72. package/dist/auth/login-form/index.js +23 -0
  73. package/dist/auth/login-form/login-form.d.ts +66 -0
  74. package/dist/auth/login-form/login-form.js +233 -0
  75. package/dist/auth/login-form/parts.d.ts +71 -0
  76. package/dist/auth/login-form/parts.js +371 -0
  77. package/dist/auth/looks/auth-illustration-any.d.ts +16 -0
  78. package/dist/auth/looks/auth-illustration-any.js +24 -0
  79. package/dist/auth/looks/index.d.ts +1 -0
  80. package/dist/auth/looks/index.js +1 -0
  81. package/dist/auth/mosaic/index.d.ts +1 -0
  82. package/dist/auth/mosaic/index.js +1 -0
  83. package/dist/auth/mosaic/mosaic.d.ts +11 -0
  84. package/dist/auth/mosaic/mosaic.js +195 -0
  85. package/dist/auth/slabs/index.d.ts +1 -0
  86. package/dist/auth/slabs/index.js +1 -0
  87. package/dist/auth/slabs/slabs.d.ts +13 -0
  88. package/dist/auth/slabs/slabs.js +136 -0
  89. package/dist/auth/stack/index.d.ts +1 -0
  90. package/dist/auth/stack/index.js +1 -0
  91. package/dist/auth/stack/stack.d.ts +6 -0
  92. package/dist/auth/stack/stack.js +222 -0
  93. package/dist/auth/statement/index.d.ts +1 -0
  94. package/dist/auth/statement/index.js +1 -0
  95. package/dist/auth/statement/statement.d.ts +13 -0
  96. package/dist/auth/statement/statement.js +99 -0
  97. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  98. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  99. package/dist/calendar/date-calendar/index.d.ts +1 -0
  100. package/dist/calendar/date-calendar/index.js +6 -0
  101. package/dist/calendar/index.d.ts +1 -0
  102. package/dist/calendar/index.js +1 -0
  103. package/dist/calendar/internal/date-utils.d.ts +26 -0
  104. package/dist/calendar/internal/date-utils.js +95 -1
  105. package/dist/containers/aside/aside.d.ts +14 -0
  106. package/dist/containers/aside/aside.js +25 -0
  107. package/dist/containers/aside/index.d.ts +1 -0
  108. package/dist/containers/aside/index.js +5 -0
  109. package/dist/containers/banner/banner.d.ts +4 -1
  110. package/dist/containers/banner/banner.js +9 -1
  111. package/dist/containers/description-list/description-list.d.ts +29 -6
  112. package/dist/containers/description-list/description-list.js +47 -6
  113. package/dist/containers/feed/feed.d.ts +23 -0
  114. package/dist/containers/feed/feed.js +77 -0
  115. package/dist/containers/feed/index.d.ts +2 -0
  116. package/dist/containers/feed/index.js +10 -0
  117. package/dist/containers/feed/model.d.ts +19 -0
  118. package/dist/containers/feed/model.js +38 -0
  119. package/dist/containers/index.d.ts +6 -0
  120. package/dist/containers/index.js +6 -0
  121. package/dist/containers/kpi/kpi.d.ts +50 -8
  122. package/dist/containers/kpi/kpi.js +91 -39
  123. package/dist/containers/list-detail/index.d.ts +1 -0
  124. package/dist/containers/list-detail/index.js +20 -0
  125. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  126. package/dist/containers/list-detail/list-detail.js +221 -0
  127. package/dist/containers/note/index.d.ts +1 -0
  128. package/dist/containers/note/index.js +4 -0
  129. package/dist/containers/note/note.d.ts +13 -0
  130. package/dist/containers/note/note.js +27 -0
  131. package/dist/containers/section/index.d.ts +1 -0
  132. package/dist/containers/section/index.js +6 -0
  133. package/dist/containers/section/section.d.ts +68 -0
  134. package/dist/containers/section/section.js +198 -0
  135. package/dist/containers/shortcuts/index.d.ts +1 -0
  136. package/dist/containers/shortcuts/index.js +8 -0
  137. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  138. package/dist/containers/shortcuts/shortcuts.js +50 -0
  139. package/dist/containers/table/selection.d.ts +9 -0
  140. package/dist/containers/table/selection.js +20 -0
  141. package/dist/containers/table/table.d.ts +66 -4
  142. package/dist/containers/table/table.js +128 -7
  143. package/dist/containers/timeline/index.d.ts +1 -1
  144. package/dist/containers/timeline/index.js +4 -2
  145. package/dist/containers/timeline/timeline.d.ts +32 -5
  146. package/dist/containers/timeline/timeline.js +154 -90
  147. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  148. package/dist/forms/chip-group/chip-group.js +114 -0
  149. package/dist/forms/chip-group/index.d.ts +1 -0
  150. package/dist/forms/chip-group/index.js +6 -0
  151. package/dist/forms/combobox/combobox.d.ts +60 -0
  152. package/dist/forms/combobox/combobox.js +281 -0
  153. package/dist/forms/combobox/index.d.ts +1 -0
  154. package/dist/forms/combobox/index.js +6 -0
  155. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  156. package/dist/forms/date-picker/date-picker.js +183 -0
  157. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  158. package/dist/forms/date-picker/date-time-picker.js +121 -0
  159. package/dist/forms/date-picker/index.d.ts +2 -0
  160. package/dist/forms/date-picker/index.js +10 -0
  161. package/dist/forms/date-picker/model.d.ts +35 -0
  162. package/dist/forms/date-picker/model.js +83 -0
  163. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  164. package/dist/forms/dropzone/dropzone.js +153 -23
  165. package/dist/forms/field/field.d.ts +16 -10
  166. package/dist/forms/field/field.js +41 -5
  167. package/dist/forms/index.d.ts +5 -0
  168. package/dist/forms/index.js +5 -0
  169. package/dist/forms/input/index.d.ts +1 -1
  170. package/dist/forms/input/index.js +4 -1
  171. package/dist/forms/input/input.d.ts +21 -5
  172. package/dist/forms/input/input.js +75 -9
  173. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  174. package/dist/forms/internal/listbox-items.d.ts +18 -0
  175. package/dist/forms/internal/listbox-items.js +88 -0
  176. package/dist/forms/internal/listbox.d.ts +44 -0
  177. package/dist/forms/internal/listbox.js +74 -0
  178. package/dist/forms/number-stepper/model.d.ts +16 -0
  179. package/dist/forms/number-stepper/model.js +23 -0
  180. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  181. package/dist/forms/number-stepper/number-stepper.js +86 -37
  182. package/dist/forms/password-input/index.d.ts +1 -0
  183. package/dist/forms/password-input/index.js +1 -0
  184. package/dist/forms/password-input/password-input.d.ts +16 -0
  185. package/dist/forms/password-input/password-input.js +45 -0
  186. package/dist/forms/select-menu/index.d.ts +1 -0
  187. package/dist/forms/select-menu/index.js +6 -0
  188. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  189. package/dist/forms/select-menu/select-menu.js +230 -0
  190. package/dist/i18n/strings.d.ts +153 -0
  191. package/dist/i18n/strings.js +86 -2
  192. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  193. package/dist/i18n/ui-strings-provider.js +6 -2
  194. package/dist/icons/eye.d.ts +2 -0
  195. package/dist/icons/eye.js +11 -0
  196. package/dist/icons/graduation-cap.d.ts +2 -0
  197. package/dist/icons/graduation-cap.js +12 -0
  198. package/dist/icons/house.d.ts +2 -0
  199. package/dist/icons/house.js +11 -0
  200. package/dist/icons/index.d.ts +4 -0
  201. package/dist/icons/index.js +8 -0
  202. package/dist/icons/mail.d.ts +2 -0
  203. package/dist/icons/mail.js +11 -0
  204. package/dist/navigation/index.d.ts +1 -0
  205. package/dist/navigation/index.js +1 -0
  206. package/dist/navigation/stepper/index.d.ts +1 -1
  207. package/dist/navigation/stepper/index.js +3 -1
  208. package/dist/navigation/stepper/stepper.d.ts +8 -0
  209. package/dist/navigation/stepper/stepper.js +68 -45
  210. package/dist/navigation/tabs/index.d.ts +1 -0
  211. package/dist/navigation/tabs/index.js +6 -0
  212. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  213. package/dist/navigation/tabs/tabs-nav.js +57 -0
  214. package/dist/navigation/wizard/index.d.ts +1 -0
  215. package/dist/navigation/wizard/index.js +6 -0
  216. package/dist/navigation/wizard/model.d.ts +33 -0
  217. package/dist/navigation/wizard/model.js +34 -0
  218. package/dist/navigation/wizard/wizard.d.ts +45 -0
  219. package/dist/navigation/wizard/wizard.js +169 -0
  220. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  221. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  222. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  223. package/dist/overlays/alert-dialog/index.js +26 -0
  224. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +17 -1
  225. package/dist/overlays/dropdown-menu/dropdown-menu.js +12 -4
  226. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  227. package/dist/overlays/dropdown-menu/index.js +8 -2
  228. package/dist/overlays/index.d.ts +2 -0
  229. package/dist/overlays/index.js +2 -0
  230. package/dist/overlays/testing/index.d.ts +5 -0
  231. package/dist/overlays/testing/index.js +4 -0
  232. package/dist/overlays/toaster/index.d.ts +2 -1
  233. package/dist/overlays/toaster/index.js +4 -2
  234. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  235. package/dist/overlays/toaster/toast.d.ts +3 -0
  236. package/dist/overlays/toaster/toast.js +3 -0
  237. package/dist/overlays/toaster/toaster.d.ts +3 -0
  238. package/dist/overlays/toaster/toaster.js +36 -3
  239. package/dist/overlays/tooltip/index.d.ts +1 -0
  240. package/dist/overlays/tooltip/index.js +4 -0
  241. package/dist/overlays/tooltip/model.d.ts +10 -0
  242. package/dist/overlays/tooltip/model.js +13 -0
  243. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  244. package/dist/overlays/tooltip/tooltip.js +116 -0
  245. package/dist/primitives/use-dismissable-layer.js +1 -1
  246. package/dist/states/error-state/error-state.d.ts +6 -1
  247. package/dist/states/error-state/error-state.js +13 -9
  248. package/dist/states/skeleton/skeleton.d.ts +8 -2
  249. package/dist/states/skeleton/skeleton.js +44 -2
  250. package/icons/svg/eye.svg +4 -0
  251. package/icons/svg/graduation-cap.svg +5 -0
  252. package/icons/svg/house.svg +4 -0
  253. package/icons/svg/mail.svg +4 -0
  254. package/package.json +2 -2
  255. package/scripts/build-theme.mjs +12 -1
  256. package/src/atoms/button/button.tsx +25 -3
  257. package/src/atoms/checkbox/checkbox.tsx +3 -1
  258. package/src/atoms/chip/chip.tsx +18 -3
  259. package/src/atoms/chip/index.ts +2 -0
  260. package/src/atoms/divider/divider.tsx +40 -0
  261. package/src/atoms/divider/index.ts +1 -0
  262. package/src/atoms/due-chip/due-chip.tsx +75 -0
  263. package/src/atoms/due-chip/index.ts +2 -0
  264. package/src/atoms/due-chip/model.ts +67 -0
  265. package/src/atoms/icon-button/icon-button.tsx +58 -0
  266. package/src/atoms/icon-button/index.ts +6 -0
  267. package/src/atoms/index.ts +6 -0
  268. package/src/atoms/internal/hit-area.ts +7 -0
  269. package/src/atoms/kbd/index.ts +1 -0
  270. package/src/atoms/kbd/kbd.tsx +20 -0
  271. package/src/atoms/radio-group/radio-group.tsx +8 -2
  272. package/src/atoms/seal/index.ts +1 -0
  273. package/src/atoms/seal/seal.tsx +107 -0
  274. package/src/atoms/spinner/index.ts +1 -0
  275. package/src/atoms/spinner/spinner.tsx +49 -0
  276. package/src/atoms/switch/switch.tsx +3 -1
  277. package/src/auth/auth-illustration/auth-illustration.tsx +100 -0
  278. package/src/auth/auth-illustration/index.ts +8 -0
  279. package/src/auth/auth-illustration/look.ts +32 -0
  280. package/src/auth/auth-illustration/model.ts +330 -0
  281. package/src/auth/auth-illustration/use-art-pointer.ts +78 -0
  282. package/src/auth/auth-layout/auth-layout.tsx +282 -0
  283. package/src/auth/auth-layout/index.ts +1 -0
  284. package/src/auth/character/character.tsx +346 -0
  285. package/src/auth/character/index.ts +1 -0
  286. package/src/auth/index.ts +4 -0
  287. package/src/auth/internal/auth-context.ts +26 -0
  288. package/src/auth/internal/auth-styles.tsx +39 -0
  289. package/src/auth/internal/portal-glyphs.tsx +32 -0
  290. package/src/auth/login-form/context.ts +78 -0
  291. package/src/auth/login-form/index.ts +21 -0
  292. package/src/auth/login-form/login-form.tsx +330 -0
  293. package/src/auth/login-form/parts.tsx +457 -0
  294. package/src/auth/looks/auth-illustration-any.tsx +38 -0
  295. package/src/auth/looks/index.ts +1 -0
  296. package/src/auth/mosaic/index.ts +1 -0
  297. package/src/auth/mosaic/mosaic.tsx +255 -0
  298. package/src/auth/slabs/index.ts +1 -0
  299. package/src/auth/slabs/slabs.tsx +181 -0
  300. package/src/auth/stack/index.ts +1 -0
  301. package/src/auth/stack/stack.tsx +267 -0
  302. package/src/auth/statement/index.ts +1 -0
  303. package/src/auth/statement/statement.tsx +122 -0
  304. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  305. package/src/calendar/date-calendar/index.ts +5 -0
  306. package/src/calendar/index.ts +1 -0
  307. package/src/calendar/internal/date-utils.ts +115 -0
  308. package/src/containers/aside/aside.tsx +40 -0
  309. package/src/containers/aside/index.ts +1 -0
  310. package/src/containers/banner/banner.tsx +18 -1
  311. package/src/containers/description-list/description-list.tsx +85 -9
  312. package/src/containers/feed/feed.tsx +99 -0
  313. package/src/containers/feed/index.ts +8 -0
  314. package/src/containers/feed/model.ts +54 -0
  315. package/src/containers/index.ts +6 -0
  316. package/src/containers/kpi/kpi.tsx +161 -62
  317. package/src/containers/list-detail/index.ts +15 -0
  318. package/src/containers/list-detail/list-detail.tsx +293 -0
  319. package/src/containers/note/index.ts +1 -0
  320. package/src/containers/note/note.tsx +38 -0
  321. package/src/containers/section/index.ts +11 -0
  322. package/src/containers/section/section.tsx +281 -0
  323. package/src/containers/shortcuts/index.ts +6 -0
  324. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  325. package/src/containers/table/selection.ts +26 -0
  326. package/src/containers/table/table.tsx +215 -13
  327. package/src/containers/timeline/index.ts +3 -0
  328. package/src/containers/timeline/timeline.tsx +204 -93
  329. package/src/forms/chip-group/chip-group.tsx +184 -0
  330. package/src/forms/chip-group/index.ts +8 -0
  331. package/src/forms/combobox/combobox.tsx +359 -0
  332. package/src/forms/combobox/index.ts +7 -0
  333. package/src/forms/date-picker/date-picker.tsx +239 -0
  334. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  335. package/src/forms/date-picker/index.ts +10 -0
  336. package/src/forms/date-picker/model.ts +108 -0
  337. package/src/forms/dropzone/dropzone.tsx +217 -35
  338. package/src/forms/field/field.tsx +72 -7
  339. package/src/forms/index.ts +5 -0
  340. package/src/forms/input/index.ts +8 -1
  341. package/src/forms/input/input.tsx +99 -12
  342. package/src/forms/input-icon/input-icon.tsx +1 -1
  343. package/src/forms/internal/listbox-items.tsx +103 -0
  344. package/src/forms/internal/listbox.ts +124 -0
  345. package/src/forms/number-stepper/model.ts +35 -0
  346. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  347. package/src/forms/password-input/index.ts +1 -0
  348. package/src/forms/password-input/password-input.tsx +57 -0
  349. package/src/forms/select-menu/index.ts +7 -0
  350. package/src/forms/select-menu/select-menu.tsx +280 -0
  351. package/src/i18n/strings.ts +153 -0
  352. package/src/i18n/ui-strings-provider.tsx +15 -4
  353. package/src/icons/eye.tsx +12 -0
  354. package/src/icons/graduation-cap.tsx +13 -0
  355. package/src/icons/house.tsx +12 -0
  356. package/src/icons/index.ts +4 -0
  357. package/src/icons/mail.tsx +12 -0
  358. package/src/navigation/index.ts +1 -0
  359. package/src/navigation/stepper/index.ts +7 -1
  360. package/src/navigation/stepper/stepper.tsx +41 -5
  361. package/src/navigation/tabs/index.ts +7 -0
  362. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  363. package/src/navigation/wizard/index.ts +7 -0
  364. package/src/navigation/wizard/model.ts +61 -0
  365. package/src/navigation/wizard/wizard.tsx +222 -0
  366. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  367. package/src/overlays/alert-dialog/index.ts +19 -0
  368. package/src/overlays/dropdown-menu/dropdown-menu.tsx +29 -4
  369. package/src/overlays/dropdown-menu/index.ts +3 -0
  370. package/src/overlays/index.ts +2 -0
  371. package/src/overlays/testing/index.ts +5 -0
  372. package/src/overlays/toaster/index.ts +2 -0
  373. package/src/overlays/toaster/toast-store.ts +6 -2
  374. package/src/overlays/toaster/toast.ts +6 -0
  375. package/src/overlays/toaster/toaster.tsx +44 -2
  376. package/src/overlays/tooltip/index.ts +1 -0
  377. package/src/overlays/tooltip/model.ts +18 -0
  378. package/src/overlays/tooltip/tooltip.tsx +166 -0
  379. package/src/primitives/use-dismissable-layer.ts +7 -2
  380. package/src/states/error-state/error-state.tsx +19 -8
  381. package/src/states/skeleton/skeleton.tsx +68 -2
  382. package/styles/tailwind.css +33 -30
  383. package/styles/theme.css +33 -30
@@ -0,0 +1,280 @@
1
+ "use client";
2
+
3
+ import {
4
+ type ComponentProps,
5
+ type KeyboardEvent,
6
+ useEffect,
7
+ useId,
8
+ useMemo,
9
+ useRef,
10
+ useState,
11
+ } from "react";
12
+ import { useUiStrings } from "../../i18n/index.js";
13
+ import { ChevronDown } from "../../icons/index.js";
14
+ import * as PopoverPrimitive from "../../primitives/popover/popover.js";
15
+ import type { ClassNames } from "../../utils/class-names.js";
16
+ import { cn } from "../../utils/cn.js";
17
+ import { useComposedRefs } from "../../utils/compose.js";
18
+ import { type Material, materialClass } from "../../utils/material.js";
19
+ import { useControllableState } from "../../utils/use-controllable-state.js";
20
+ import {
21
+ flattenItems,
22
+ isTypeaheadKey,
23
+ type ListboxGroup,
24
+ type ListboxMove,
25
+ type ListboxOption,
26
+ moveActive,
27
+ nextTypeahead,
28
+ typeaheadIndex,
29
+ } from "../internal/listbox.js";
30
+ import { LISTBOX_SURFACE, ListboxItems, optionDomId } from "../internal/listbox-items.js";
31
+
32
+ export type SelectMenuOption = Omit<ListboxOption, "keywords">;
33
+ export type SelectMenuGroup = ListboxGroup<SelectMenuOption>;
34
+
35
+ export type SelectMenuPart = "trigger" | "value" | "icon" | "content" | "option" | "group";
36
+
37
+ export interface SelectMenuProps
38
+ extends Omit<
39
+ ComponentProps<"button">,
40
+ "value" | "defaultValue" | "onChange" | "children" | "type" | "role" | "size"
41
+ > {
42
+ /** Options, optionally nested in labelled groups. A `value` of `""` is a real option, not "nothing". */
43
+ options: readonly (SelectMenuOption | SelectMenuGroup)[];
44
+ /** Selected value (controlled). An unknown value or `undefined` shows the placeholder. */
45
+ value?: string;
46
+ defaultValue?: string;
47
+ onValueChange?: (value: string) => void;
48
+ /** Shown while no option is selected. Defaults to the localized "Select…". */
49
+ placeholder?: string;
50
+ /** Submits the value with a surrounding `<form>` through a hidden input. */
51
+ name?: string;
52
+ required?: boolean;
53
+ invalid?: boolean;
54
+ size?: "sm" | "md";
55
+ /** Portal target for the popup. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
56
+ container?: HTMLElement | null;
57
+ /** Popup surface material; see `PopoverContent`. */
58
+ material?: Material;
59
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the trigger and is merged last. */
60
+ classNames?: ClassNames<SelectMenuPart>;
61
+ }
62
+
63
+ const TYPEAHEAD_MS = 600;
64
+ const OPEN_KEYS = new Set(["ArrowDown", "ArrowUp", "Enter", " "]);
65
+
66
+ /**
67
+ * Select with a custom listbox popup, for option lists that need descriptions, groups or a
68
+ * styled popup. Select-only combobox pattern (WAI-ARIA APG): focus stays on the trigger and the
69
+ * highlighted option is announced through `aria-activedescendant`. Use `NativeSelect` when the
70
+ * system picker is preferable (long lists on phones).
71
+ */
72
+ export function SelectMenu({
73
+ options,
74
+ value: valueProp,
75
+ defaultValue,
76
+ onValueChange,
77
+ placeholder,
78
+ name,
79
+ required,
80
+ invalid,
81
+ size = "md",
82
+ container,
83
+ material,
84
+ disabled,
85
+ className,
86
+ classNames,
87
+ onKeyDown,
88
+ onKeyUp,
89
+ onClick,
90
+ ref,
91
+ id,
92
+ "aria-label": ariaLabel,
93
+ "aria-labelledby": ariaLabelledBy,
94
+ "aria-invalid": ariaInvalid,
95
+ ...props
96
+ }: SelectMenuProps) {
97
+ const strings = useUiStrings();
98
+ const listId = useId();
99
+ const triggerRef = useRef<HTMLButtonElement | null>(null);
100
+ const composedRef = useComposedRefs<HTMLButtonElement>(ref, triggerRef);
101
+ const typeahead = useRef({ buffer: "", at: 0 });
102
+ const [value, setValue] = useControllableState<string | undefined>({
103
+ prop: valueProp,
104
+ defaultProp: defaultValue,
105
+ onChange: (next) => {
106
+ if (next !== undefined) onValueChange?.(next);
107
+ },
108
+ });
109
+ const [open, setOpenState] = useState(false);
110
+ const [active, setActive] = useState(-1);
111
+ const [listLabel, setListLabel] = useState<string | undefined>();
112
+
113
+ const flat = useMemo(() => flattenItems(options), [options]);
114
+ const selectedIndex = flat.findIndex((option) => option.value === value);
115
+ const selected = flat[selectedIndex];
116
+ const isDisabled = Boolean(disabled);
117
+
118
+ const setOpen = (next: boolean, move?: ListboxMove) => {
119
+ if (next && isDisabled) return;
120
+ if (next) {
121
+ const preferred = selected && !selected.disabled ? selectedIndex : -1;
122
+ setActive(
123
+ move
124
+ ? moveActive(flat, move === "last" ? flat.length : -1, move)
125
+ : preferred >= 0
126
+ ? preferred
127
+ : moveActive(flat, -1, "first"),
128
+ );
129
+ setListLabel(triggerRef.current?.labels?.[0]?.textContent?.trim() || undefined);
130
+ }
131
+ setOpenState(next);
132
+ };
133
+
134
+ useEffect(() => {
135
+ if (!open || active < 0) return;
136
+ document.getElementById(optionDomId(listId, active))?.scrollIntoView?.({ block: "nearest" });
137
+ }, [open, active, listId]);
138
+
139
+ const pick = (index: number) => {
140
+ const option = flat[index];
141
+ if (!option || option.disabled) return;
142
+ setValue(option.value);
143
+ setOpenState(false);
144
+ };
145
+
146
+ const handleKeyDown = (event: KeyboardEvent<HTMLButtonElement>) => {
147
+ onKeyDown?.(event);
148
+ if (event.defaultPrevented || event.altKey || event.ctrlKey || event.metaKey) return;
149
+ const { key } = event;
150
+ const buffering =
151
+ typeahead.current.buffer !== "" && Date.now() - typeahead.current.at <= TYPEAHEAD_MS;
152
+ const typing = isTypeaheadKey(event) && !(key === " " && !buffering);
153
+
154
+ if (typing) {
155
+ event.preventDefault();
156
+ typeahead.current = nextTypeahead(typeahead.current, key, Date.now());
157
+ const found = typeaheadIndex(flat, typeahead.current.buffer, open ? active : selectedIndex);
158
+ if (found < 0) return;
159
+ if (open) setActive(found);
160
+ else pick(found);
161
+ return;
162
+ }
163
+
164
+ if (!open) {
165
+ if (OPEN_KEYS.has(key)) {
166
+ event.preventDefault();
167
+ setOpen(true);
168
+ } else if (key === "Home" || key === "End") {
169
+ event.preventDefault();
170
+ setOpen(true, key === "Home" ? "first" : "last");
171
+ }
172
+ return;
173
+ }
174
+
175
+ const moves: Record<string, ListboxMove> = {
176
+ ArrowDown: "next",
177
+ ArrowUp: "prev",
178
+ Home: "first",
179
+ End: "last",
180
+ };
181
+ const move = moves[key];
182
+ if (move) {
183
+ event.preventDefault();
184
+ setActive((current) => moveActive(flat, current, move));
185
+ } else if (key === "Enter" || key === " ") {
186
+ event.preventDefault();
187
+ pick(active);
188
+ } else if (key === "Tab") {
189
+ setOpenState(false);
190
+ }
191
+ };
192
+
193
+ const showPlaceholder = !selected;
194
+
195
+ return (
196
+ <PopoverPrimitive.Root open={open} onOpenChange={(next) => setOpen(next)}>
197
+ <PopoverPrimitive.Trigger
198
+ ref={composedRef}
199
+ id={id}
200
+ role="combobox"
201
+ data-ui-layer=""
202
+ aria-haspopup="listbox"
203
+ aria-expanded={open}
204
+ aria-controls={open ? listId : undefined}
205
+ aria-activedescendant={open && active >= 0 ? optionDomId(listId, active) : undefined}
206
+ aria-required={required || undefined}
207
+ aria-invalid={ariaInvalid ?? (invalid || undefined)}
208
+ aria-label={ariaLabel}
209
+ aria-labelledby={ariaLabelledBy}
210
+ disabled={disabled}
211
+ data-placeholder={showPlaceholder ? "" : undefined}
212
+ {...props}
213
+ onClick={(event) => {
214
+ onClick?.(event);
215
+ // Safari does not focus a button on press; the keyboard needs focus on it.
216
+ event.currentTarget.focus({ preventScroll: true });
217
+ }}
218
+ onKeyDown={handleKeyDown}
219
+ onKeyUp={(event) => {
220
+ onKeyUp?.(event);
221
+ // Space activates a button on keyup; the keydown already handled it.
222
+ if (event.key === " ") event.preventDefault();
223
+ }}
224
+ className={cn(
225
+ "flex w-full min-w-0 items-center justify-between gap-2 rounded-input border-control bg-surface-control py-0 pr-2.5 pl-3 text-left text-control text-ink focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1 disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-danger",
226
+ size === "sm" ? "h-control-sm" : "h-input min-h-(--touch-target)",
227
+ classNames?.trigger,
228
+ className,
229
+ )}
230
+ >
231
+ <span
232
+ className={cn(
233
+ "min-w-0 flex-1 truncate",
234
+ showPlaceholder && "text-ink-3",
235
+ classNames?.value,
236
+ )}
237
+ >
238
+ {selected?.label ?? placeholder ?? strings.selectPlaceholder}
239
+ </span>
240
+ <ChevronDown
241
+ aria-hidden="true"
242
+ className={cn("size-3.5 shrink-0 text-ink-3", classNames?.icon)}
243
+ />
244
+ </PopoverPrimitive.Trigger>
245
+ {name ? <input type="hidden" name={name} value={value ?? ""} disabled={disabled} /> : null}
246
+ <PopoverPrimitive.Portal container={container}>
247
+ <PopoverPrimitive.Content
248
+ id={listId}
249
+ role="listbox"
250
+ data-ui-layer=""
251
+ aria-label={ariaLabelledBy ? undefined : (ariaLabel ?? listLabel ?? placeholder)}
252
+ aria-labelledby={ariaLabelledBy}
253
+ sideOffset={4}
254
+ collisionPadding={8}
255
+ align="start"
256
+ // Focus stays on the trigger, going in and out.
257
+ onOpenAutoFocus={(event) => event.preventDefault()}
258
+ onCloseAutoFocus={(event) => event.preventDefault()}
259
+ className={cn(
260
+ LISTBOX_SURFACE,
261
+ materialClass(material, "surface-solid"),
262
+ classNames?.content,
263
+ )}
264
+ >
265
+ <ListboxItems
266
+ items={options}
267
+ flat={flat}
268
+ idBase={listId}
269
+ isSelected={(option) => option.value === value}
270
+ activeIndex={active}
271
+ onActivate={setActive}
272
+ onPick={(option) => pick(flat.indexOf(option))}
273
+ optionClassName={classNames?.option}
274
+ groupClassName={classNames?.group}
275
+ />
276
+ </PopoverPrimitive.Content>
277
+ </PopoverPrimitive.Portal>
278
+ </PopoverPrimitive.Root>
279
+ );
280
+ }
@@ -19,6 +19,75 @@ export interface UiStrings {
19
19
  copied: string;
20
20
  more: string;
21
21
  remove: string;
22
+ noResults: string;
23
+ clear: string;
24
+ selectPlaceholder: string;
25
+ openCalendar: string;
26
+ calendar: string;
27
+ previousMonth: string;
28
+ nextMonth: string;
29
+ time: string;
30
+ /** BCP 47 locale used for date labels and the typed date format. */
31
+ locale: string;
32
+ dayPlaceholder: string;
33
+ monthPlaceholder: string;
34
+ yearPlaceholder: string;
35
+ back: string;
36
+ next: string;
37
+ finish: string;
38
+ /** Step announcement; `{current}`, `{total}` and `{label}` are replaced. */
39
+ stepOf: string;
40
+ steps: string;
41
+ /** Default accessible name of an `Aside`. */
42
+ aside: string;
43
+ /** Back action of a single-pane `ListDetail`. */
44
+ backToList: string;
45
+ /** Screen-reader state of a `DueChip` past its date. */
46
+ overdue: string;
47
+ /** Screen-reader state of a `DueChip` due within its `soonDays`. */
48
+ dueSoon: string;
49
+ /** Screen-reader state of a completed `Stepper` step. */
50
+ stepDone: string;
51
+ /** Screen-reader state of a `Stepper` step that has an error. */
52
+ stepError: string;
53
+ /** Name of a row checkbox in a `Table`; `{row}` is replaced by the row's label. */
54
+ selectRow: string;
55
+ /** Name of the select-all checkbox of a `Table`. */
56
+ selectAll: string;
57
+ /** Name of the overflow menu trigger of a `TableActionsCell`. */
58
+ rowActions: string;
59
+ /** Name of the `PasswordInput` toggle; its pressed state says whether the password is visible. */
60
+ showPassword: string;
61
+ /** Default title of a `LoginForm`. */
62
+ signIn: string;
63
+ /** Label of the portal picker of a `LoginForm`. */
64
+ signInAs: string;
65
+ /** Divider between the portal picker and the credential fields. */
66
+ withYourAccount: string;
67
+ /** Default label and placeholder of the `LoginForm` identifier field. */
68
+ identifier: string;
69
+ /** Default label and placeholder of the `LoginForm` password field. */
70
+ password: string;
71
+ /** Default `LoginForm` link to recover a password. */
72
+ forgotPassword: string;
73
+ /** Submit button label of a `LoginForm`. */
74
+ signInAction: string;
75
+ /** Inline error of a `LoginForm` submitted without an identifier. */
76
+ enterIdentifier: string;
77
+ /** Inline error of a `LoginForm` submitted without a password. */
78
+ enterPassword: string;
79
+ /** Label of the remember-me checkbox of `LoginForm.Options`. */
80
+ rememberMe: string;
81
+ /** Default help link of `LoginForm.Options`. */
82
+ needHelp: string;
83
+ /** Default label of `LoginForm.Providers`. */
84
+ orLogInWith: string;
85
+ /** Message shown by a `LoginForm` when sign-in fails and the app gives none. */
86
+ signInFailed: string;
87
+ /** Default headline of the `statement` look of `AuthIllustration`. */
88
+ welcomeBack: string;
89
+ /** Line the `statement` look of `AuthIllustration` shows once sign-in succeeds. */
90
+ signedIn: string;
22
91
  }
23
92
 
24
93
  export type UiLocale = "en" | "es";
@@ -45,6 +114,48 @@ export const uiStrings = {
45
114
  copied: "Copied",
46
115
  more: "More",
47
116
  remove: "Remove",
117
+ noResults: "No results",
118
+ clear: "Clear",
119
+ selectPlaceholder: "Select…",
120
+ openCalendar: "Open calendar",
121
+ calendar: "Calendar",
122
+ previousMonth: "Previous month",
123
+ nextMonth: "Next month",
124
+ time: "Time",
125
+ locale: "en-US",
126
+ dayPlaceholder: "dd",
127
+ monthPlaceholder: "mm",
128
+ yearPlaceholder: "yyyy",
129
+ back: "Back",
130
+ next: "Next",
131
+ finish: "Finish",
132
+ stepOf: "Step {current} of {total}: {label}",
133
+ steps: "Steps",
134
+ aside: "Related information",
135
+ backToList: "Back to list",
136
+ overdue: "Overdue",
137
+ dueSoon: "Due soon",
138
+ stepDone: "Completed",
139
+ stepError: "Has an error",
140
+ selectRow: "Select {row}",
141
+ selectAll: "Select all rows",
142
+ rowActions: "Row actions",
143
+ showPassword: "Show password",
144
+ signIn: "Sign in",
145
+ signInAs: "Sign in as",
146
+ withYourAccount: "with your account",
147
+ identifier: "Email or ID",
148
+ password: "Password",
149
+ forgotPassword: "Forgot your password?",
150
+ signInAction: "Sign in",
151
+ enterIdentifier: "Enter your email or ID.",
152
+ enterPassword: "Enter your password.",
153
+ rememberMe: "Remember me",
154
+ needHelp: "Need help?",
155
+ orLogInWith: "Or log in with",
156
+ signInFailed: "We could not sign you in. Check your details and try again.",
157
+ welcomeBack: "Good to see you again.",
158
+ signedIn: "You're in.",
48
159
  },
49
160
  es: {
50
161
  retry: "Reintentar",
@@ -67,5 +178,47 @@ export const uiStrings = {
67
178
  copied: "Copiado",
68
179
  more: "Más",
69
180
  remove: "Quitar",
181
+ noResults: "Sin resultados",
182
+ clear: "Limpiar",
183
+ selectPlaceholder: "Seleccionar…",
184
+ openCalendar: "Abrir calendario",
185
+ calendar: "Calendario",
186
+ previousMonth: "Mes anterior",
187
+ nextMonth: "Mes siguiente",
188
+ time: "Hora",
189
+ locale: "es-PE",
190
+ dayPlaceholder: "dd",
191
+ monthPlaceholder: "mm",
192
+ yearPlaceholder: "aaaa",
193
+ back: "Atrás",
194
+ next: "Siguiente",
195
+ finish: "Finalizar",
196
+ stepOf: "Paso {current} de {total}: {label}",
197
+ steps: "Pasos",
198
+ aside: "Información relacionada",
199
+ backToList: "Volver a la lista",
200
+ overdue: "Vencido",
201
+ dueSoon: "Vence pronto",
202
+ stepDone: "Completado",
203
+ stepError: "Tiene un error",
204
+ selectRow: "Seleccionar {row}",
205
+ selectAll: "Seleccionar todas las filas",
206
+ rowActions: "Acciones de la fila",
207
+ showPassword: "Mostrar contraseña",
208
+ signIn: "Inicia sesión",
209
+ signInAs: "Ingresar como",
210
+ withYourAccount: "con tu cuenta",
211
+ identifier: "Correo o documento",
212
+ password: "Contraseña",
213
+ forgotPassword: "¿Olvidaste tu contraseña?",
214
+ signInAction: "Ingresar",
215
+ enterIdentifier: "Escribe tu correo o documento.",
216
+ enterPassword: "Escribe tu contraseña.",
217
+ rememberMe: "Recordarme",
218
+ needHelp: "¿Necesitas ayuda?",
219
+ orLogInWith: "O ingresa con",
220
+ signInFailed: "No pudimos iniciar tu sesión. Revisa tus datos e inténtalo de nuevo.",
221
+ welcomeBack: "Qué bueno verte otra vez.",
222
+ signedIn: "Ya estás dentro.",
70
223
  },
71
224
  } as const satisfies Record<UiLocale, UiStrings>;
@@ -1,14 +1,25 @@
1
1
  "use client";
2
2
 
3
- import { createContext, type ReactNode, useContext, useMemo } from "react";
3
+ import { type Context, createContext, type ReactNode, useContext, useMemo } from "react";
4
4
  import { type UiLocale, type UiStrings, uiStrings } from "./strings.js";
5
5
 
6
- const UiStringsContext = createContext<UiStrings>(uiStrings.en);
6
+ // One context per page even when the module is instantiated twice (a linked package, a dual
7
+ // bundle, a test runner that inlines one entry and externalizes another): a provider mounted through
8
+ // one copy must reach components imported through the other.
9
+ const registry = Symbol.for("@jcsoftdev/ui/i18n/strings");
10
+ const shared = globalThis as typeof globalThis & { [registry]?: Context<UiStrings> };
11
+ const UiStringsContext: Context<UiStrings> =
12
+ shared[registry] ?? createContext<UiStrings>(uiStrings.en);
13
+ shared[registry] = UiStringsContext;
14
+
15
+ /** Drops `undefined` and empty entries so a partial value never blanks a preset string. */
16
+ const defined = (strings?: Partial<UiStrings>): Partial<UiStrings> =>
17
+ Object.fromEntries(Object.entries(strings ?? {}).filter(([, value]) => value));
7
18
 
8
19
  export interface UiStringsProviderProps {
9
20
  /** Preset to start from. Without it the provider keeps the strings of its parent (default `en`). */
10
21
  locale?: UiLocale;
11
- /** Overrides applied on top of the preset. */
22
+ /** Overrides applied on top of the preset. Missing or empty entries keep the preset string. */
12
23
  strings?: Partial<UiStrings>;
13
24
  children: ReactNode;
14
25
  }
@@ -16,7 +27,7 @@ export interface UiStringsProviderProps {
16
27
  export function UiStringsProvider({ locale, strings, children }: UiStringsProviderProps) {
17
28
  const parent = useContext(UiStringsContext);
18
29
  const value = useMemo<UiStrings>(
19
- () => ({ ...(locale ? uiStrings[locale] : parent), ...strings }),
30
+ () => ({ ...(locale ? uiStrings[locale] : parent), ...defined(strings) }),
20
31
  [locale, strings, parent],
21
32
  );
22
33
  return <UiStringsContext.Provider value={value}>{children}</UiStringsContext.Provider>;
@@ -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
+ }
@@ -3,3 +3,4 @@ export * from "./floating-toc/index.js";
3
3
  export * from "./segmented/index.js";
4
4
  export * from "./stepper/index.js";
5
5
  export * from "./tabs/index.js";
6
+ export * from "./wizard/index.js";
@@ -1 +1,7 @@
1
- export { type Step, Stepper, type StepperPart, type StepperProps } from "./stepper.js";
1
+ export {
2
+ type Step,
3
+ Stepper,
4
+ type StepperPart,
5
+ type StepperProps,
6
+ type StepStatus,
7
+ } from "./stepper.js";
@@ -1,12 +1,30 @@
1
1
  import type { ComponentPropsWithRef } from "react";
2
+ import { useUiStrings } from "../../i18n/index.js";
3
+ import { Check, X } from "../../icons/index.js";
2
4
  import type { ClassNames } from "../../utils/class-names.js";
3
5
  import { cn } from "../../utils/cn.js";
4
6
 
7
+ export type StepStatus = "done" | "current" | "error" | "pending";
8
+
5
9
  export interface Step {
6
10
  id: string;
7
11
  label: string;
12
+ /**
13
+ * Explicit state of the step. Without it the step is `current` when it is `currentStepId` and
14
+ * `pending` otherwise. A `done` step shows a check, an `error` step a cross and both announce
15
+ * their state; neither relies on colour alone. The step named by `currentStepId` keeps
16
+ * `aria-current="step"` whatever its status.
17
+ */
18
+ status?: StepStatus;
8
19
  }
9
20
 
21
+ const markerStatusClasses: Record<StepStatus, string> = {
22
+ pending: "border-line-strong",
23
+ current: "border-accent-ink text-accent-ink",
24
+ done: "border-success bg-success-soft text-success",
25
+ error: "border-danger bg-danger-soft text-danger",
26
+ };
27
+
10
28
  export type StepperPart = "root" | "step" | "current" | "marker" | "label" | "connector";
11
29
 
12
30
  export interface StepperProps extends Omit<ComponentPropsWithRef<"ol">, "children"> {
@@ -18,6 +36,7 @@ export interface StepperProps extends Omit<ComponentPropsWithRef<"ol">, "childre
18
36
 
19
37
  /** Step 1-N indicator for multi-stage flows. */
20
38
  export function Stepper({ steps, currentStepId, className, classNames, ...props }: StepperProps) {
39
+ const strings = useUiStrings();
21
40
  return (
22
41
  <ol
23
42
  {...props}
@@ -29,35 +48,52 @@ export function Stepper({ steps, currentStepId, className, classNames, ...props
29
48
  >
30
49
  {steps.map((step, index) => {
31
50
  const isCurrent = step.id === currentStepId;
51
+ const status: StepStatus = step.status ?? (isCurrent ? "current" : "pending");
52
+ const emphasised = isCurrent || status === "current" || status === "error";
32
53
  return (
33
- <li key={step.id} className={cn("flex min-w-0 items-center gap-1.5", classNames?.step)}>
54
+ <li
55
+ key={step.id}
56
+ data-status={status}
57
+ className={cn("flex min-w-0 items-center gap-1.5", classNames?.step)}
58
+ >
34
59
  <span
35
60
  aria-current={isCurrent ? "step" : undefined}
36
61
  className={cn(
37
62
  "flex items-center gap-1.5",
38
- isCurrent && "text-ink",
63
+ emphasised && "text-ink",
39
64
  isCurrent && classNames?.current,
40
65
  )}
41
66
  >
42
67
  <span
43
68
  className={cn(
44
69
  "grid size-4.5 place-items-center rounded-pill border text-count",
45
- isCurrent ? "border-accent-ink text-accent-ink" : "border-line-strong",
70
+ markerStatusClasses[status],
46
71
  classNames?.marker,
47
72
  )}
48
73
  >
49
- {index + 1}
74
+ {status === "done" ? (
75
+ <Check aria-hidden="true" className="size-3" />
76
+ ) : status === "error" ? (
77
+ <X aria-hidden="true" className="size-3" />
78
+ ) : (
79
+ index + 1
80
+ )}
50
81
  </span>
51
82
  <span
52
83
  className={cn(
53
84
  "min-w-0 truncate",
54
- !isCurrent && "@max-[420px]/stepper:sr-only",
85
+ !emphasised && "@max-[420px]/stepper:sr-only",
55
86
  isCurrent && "@max-[420px]/stepper:max-w-[40cqw]",
56
87
  classNames?.label,
57
88
  )}
58
89
  >
59
90
  {step.label}
60
91
  </span>
92
+ {status === "done" || status === "error" ? (
93
+ <span className="sr-only">
94
+ , {status === "done" ? strings.stepDone : strings.stepError}
95
+ </span>
96
+ ) : null}
61
97
  </span>
62
98
  {index < steps.length - 1 && (
63
99
  <span