@jcsoftdev/ui 0.2.3 → 0.4.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 (601) hide show
  1. package/CHANGELOG.md +390 -7
  2. package/README.md +57 -3
  3. package/bin/ui-theme.mjs +1162 -25
  4. package/dist/ai/attachment/attachment.js +1 -1
  5. package/dist/ai/chat-list/group.js +3 -1
  6. package/dist/ai/conversation/conversation.js +1 -1
  7. package/dist/ai/internal/use-copy.d.ts +1 -5
  8. package/dist/ai/internal/use-copy.js +1 -32
  9. package/dist/ai/markdown/parse.js +59 -17
  10. package/dist/ai/source/source.js +1 -1
  11. package/dist/atoms/avatar/avatar.d.ts +13 -3
  12. package/dist/atoms/avatar/avatar.js +40 -2
  13. package/dist/atoms/avatar/index.d.ts +1 -1
  14. package/dist/atoms/avatar/index.js +3 -1
  15. package/dist/atoms/button/button.d.ts +4 -1
  16. package/dist/atoms/button/button.js +4 -2
  17. package/dist/atoms/checkbox/checkbox.d.ts +8 -3
  18. package/dist/atoms/checkbox/checkbox.js +26 -3
  19. package/dist/atoms/chip/chip.d.ts +19 -5
  20. package/dist/atoms/chip/chip.js +34 -5
  21. package/dist/atoms/chip/index.d.ts +1 -1
  22. package/dist/atoms/chip/index.js +6 -1
  23. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  24. package/dist/atoms/due-chip/due-chip.js +41 -0
  25. package/dist/atoms/due-chip/index.d.ts +2 -0
  26. package/dist/atoms/due-chip/index.js +6 -0
  27. package/dist/atoms/due-chip/model.d.ts +25 -0
  28. package/dist/atoms/due-chip/model.js +44 -0
  29. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  30. package/dist/atoms/icon-button/icon-button.js +38 -0
  31. package/dist/atoms/icon-button/index.d.ts +1 -0
  32. package/dist/atoms/icon-button/index.js +8 -0
  33. package/dist/atoms/index.d.ts +5 -0
  34. package/dist/atoms/index.js +5 -0
  35. package/dist/atoms/internal/hit-area.d.ts +6 -0
  36. package/dist/atoms/internal/hit-area.js +4 -0
  37. package/dist/atoms/kbd/index.d.ts +1 -0
  38. package/dist/atoms/kbd/index.js +4 -0
  39. package/dist/atoms/kbd/kbd.d.ts +7 -0
  40. package/dist/atoms/kbd/kbd.js +17 -0
  41. package/dist/atoms/radio-group/radio-group.js +6 -2
  42. package/dist/atoms/seal/index.d.ts +1 -0
  43. package/dist/atoms/seal/index.js +4 -0
  44. package/dist/atoms/seal/seal.d.ts +30 -0
  45. package/dist/atoms/seal/seal.js +71 -0
  46. package/dist/atoms/spinner/index.d.ts +1 -0
  47. package/dist/atoms/spinner/index.js +5 -0
  48. package/dist/atoms/spinner/spinner.d.ts +19 -0
  49. package/dist/atoms/spinner/spinner.js +31 -0
  50. package/dist/atoms/status-dot/index.d.ts +1 -1
  51. package/dist/atoms/status-dot/status-dot.d.ts +4 -2
  52. package/dist/atoms/status-dot/status-dot.js +5 -1
  53. package/dist/atoms/switch/switch.js +3 -1
  54. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  55. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  56. package/dist/calendar/date-calendar/index.d.ts +1 -0
  57. package/dist/calendar/date-calendar/index.js +6 -0
  58. package/dist/calendar/index.d.ts +1 -0
  59. package/dist/calendar/index.js +1 -0
  60. package/dist/calendar/internal/date-utils.d.ts +26 -0
  61. package/dist/calendar/internal/date-utils.js +95 -1
  62. package/dist/charts/bar-chart/bar-race-chart.js +1 -0
  63. package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
  64. package/dist/charts/chord-chart/chord-chart.js +13 -5
  65. package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
  66. package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
  67. package/dist/charts/core/cartesian/layout.d.ts +6 -1
  68. package/dist/charts/core/cartesian/layout.js +14 -5
  69. package/dist/charts/core/cartesian/marks.d.ts +2 -2
  70. package/dist/charts/core/cartesian/marks.js +1 -1
  71. package/dist/charts/core/cartesian/types.d.ts +28 -2
  72. package/dist/charts/core/category-explorer.d.ts +2 -2
  73. package/dist/charts/core/category-explorer.js +8 -4
  74. package/dist/charts/core/chart-dock.d.ts +26 -0
  75. package/dist/charts/core/chart-dock.js +45 -0
  76. package/dist/charts/core/chart-frame.d.ts +9 -2
  77. package/dist/charts/core/chart-frame.js +105 -25
  78. package/dist/charts/core/distribution/explorer.d.ts +5 -2
  79. package/dist/charts/core/distribution/explorer.js +12 -5
  80. package/dist/charts/core/distribution/xy-points.js +1 -1
  81. package/dist/charts/core/index.d.ts +3 -0
  82. package/dist/charts/core/index.js +3 -0
  83. package/dist/charts/core/leave-grace.d.ts +11 -0
  84. package/dist/charts/core/leave-grace.js +26 -0
  85. package/dist/charts/core/nearest.d.ts +14 -0
  86. package/dist/charts/core/nearest.js +22 -0
  87. package/dist/charts/core/plot-overlay.js +9 -3
  88. package/dist/charts/core/pointer.test-utils.d.ts +38 -0
  89. package/dist/charts/core/pointer.test-utils.js +123 -0
  90. package/dist/charts/core/tooltip.d.ts +25 -2
  91. package/dist/charts/core/tooltip.js +115 -40
  92. package/dist/charts/core/touch-select.d.ts +20 -0
  93. package/dist/charts/core/touch-select.js +184 -0
  94. package/dist/charts/core/types.d.ts +8 -4
  95. package/dist/charts/core/types.js +5 -0
  96. package/dist/charts/core/use-index-navigation.d.ts +17 -6
  97. package/dist/charts/core/use-index-navigation.js +47 -10
  98. package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
  99. package/dist/charts/donut-chart/donut-chart.js +40 -1
  100. package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
  101. package/dist/charts/donut-chart/slice-labels.js +20 -0
  102. package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
  103. package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
  104. package/dist/charts/funnel-chart/funnel-chart.js +2 -1
  105. package/dist/charts/gauge-chart/gauge-chart.js +2 -1
  106. package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
  107. package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
  108. package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
  109. package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
  110. package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
  111. package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
  112. package/dist/charts/icicle-chart/icicle-chart.js +7 -9
  113. package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
  114. package/dist/charts/maps/geo/map-viewport.js +1 -1
  115. package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
  116. package/dist/charts/progress-units/progress-units.js +1 -0
  117. package/dist/charts/radar-chart/radar-chart.js +1 -1
  118. package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
  119. package/dist/charts/range-area-chart/range-area-chart.js +3 -2
  120. package/dist/charts/sankey-chart/sankey-chart.js +12 -4
  121. package/dist/charts/tree-chart/tree-chart.js +1 -0
  122. package/dist/charts/treemap-chart/treemap-chart.js +2 -7
  123. package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
  124. package/dist/containers/action-bar/action-bar.d.ts +11 -2
  125. package/dist/containers/action-bar/action-bar.js +4 -1
  126. package/dist/containers/aside/aside.d.ts +14 -0
  127. package/dist/containers/aside/aside.js +25 -0
  128. package/dist/containers/aside/index.d.ts +1 -0
  129. package/dist/containers/aside/index.js +5 -0
  130. package/dist/containers/banner/banner.d.ts +4 -1
  131. package/dist/containers/banner/banner.js +9 -1
  132. package/dist/containers/card/card.d.ts +21 -3
  133. package/dist/containers/card/card.js +20 -5
  134. package/dist/containers/description-list/description-list.d.ts +29 -6
  135. package/dist/containers/description-list/description-list.js +47 -6
  136. package/dist/containers/feed/feed.d.ts +23 -0
  137. package/dist/containers/feed/feed.js +77 -0
  138. package/dist/containers/feed/index.d.ts +2 -0
  139. package/dist/containers/feed/index.js +10 -0
  140. package/dist/containers/feed/model.d.ts +19 -0
  141. package/dist/containers/feed/model.js +38 -0
  142. package/dist/containers/grid/grid.d.ts +15 -0
  143. package/dist/containers/grid/grid.js +24 -0
  144. package/dist/containers/grid/index.d.ts +1 -0
  145. package/dist/containers/grid/index.js +4 -0
  146. package/dist/containers/index.d.ts +9 -0
  147. package/dist/containers/index.js +9 -0
  148. package/dist/containers/kpi/kpi.d.ts +60 -7
  149. package/dist/containers/kpi/kpi.js +142 -28
  150. package/dist/containers/kpi-group/index.d.ts +1 -1
  151. package/dist/containers/kpi-group/index.js +3 -1
  152. package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
  153. package/dist/containers/kpi-group/kpi-group.js +11 -1
  154. package/dist/containers/list-detail/index.d.ts +1 -0
  155. package/dist/containers/list-detail/index.js +20 -0
  156. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  157. package/dist/containers/list-detail/list-detail.js +221 -0
  158. package/dist/containers/note/index.d.ts +1 -0
  159. package/dist/containers/note/index.js +4 -0
  160. package/dist/containers/note/note.d.ts +13 -0
  161. package/dist/containers/note/note.js +27 -0
  162. package/dist/containers/page/index.d.ts +1 -0
  163. package/dist/containers/page/index.js +4 -0
  164. package/dist/containers/page/page.d.ts +7 -0
  165. package/dist/containers/page/page.js +14 -0
  166. package/dist/containers/page-header/page-header.d.ts +8 -3
  167. package/dist/containers/page-header/page-header.js +35 -8
  168. package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
  169. package/dist/containers/responsive-list/responsive-list.js +6 -3
  170. package/dist/containers/section/index.d.ts +1 -0
  171. package/dist/containers/section/index.js +6 -0
  172. package/dist/containers/section/section.d.ts +68 -0
  173. package/dist/containers/section/section.js +198 -0
  174. package/dist/containers/shortcuts/index.d.ts +1 -0
  175. package/dist/containers/shortcuts/index.js +8 -0
  176. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  177. package/dist/containers/shortcuts/shortcuts.js +50 -0
  178. package/dist/containers/stack/index.d.ts +1 -0
  179. package/dist/containers/stack/index.js +6 -0
  180. package/dist/containers/stack/stack.d.ts +15 -0
  181. package/dist/containers/stack/stack.js +43 -0
  182. package/dist/containers/table/selection.d.ts +9 -0
  183. package/dist/containers/table/selection.js +20 -0
  184. package/dist/containers/table/table.d.ts +66 -4
  185. package/dist/containers/table/table.js +128 -7
  186. package/dist/containers/timeline/index.d.ts +1 -1
  187. package/dist/containers/timeline/index.js +4 -2
  188. package/dist/containers/timeline/timeline.d.ts +32 -5
  189. package/dist/containers/timeline/timeline.js +154 -90
  190. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  191. package/dist/forms/chip-group/chip-group.js +114 -0
  192. package/dist/forms/chip-group/index.d.ts +1 -0
  193. package/dist/forms/chip-group/index.js +6 -0
  194. package/dist/forms/combobox/combobox.d.ts +60 -0
  195. package/dist/forms/combobox/combobox.js +281 -0
  196. package/dist/forms/combobox/index.d.ts +1 -0
  197. package/dist/forms/combobox/index.js +6 -0
  198. package/dist/forms/copy-field/copy-field.d.ts +17 -0
  199. package/dist/forms/copy-field/copy-field.js +72 -0
  200. package/dist/forms/copy-field/index.d.ts +1 -0
  201. package/dist/forms/copy-field/index.js +4 -0
  202. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  203. package/dist/forms/date-picker/date-picker.js +183 -0
  204. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  205. package/dist/forms/date-picker/date-time-picker.js +121 -0
  206. package/dist/forms/date-picker/index.d.ts +2 -0
  207. package/dist/forms/date-picker/index.js +10 -0
  208. package/dist/forms/date-picker/model.d.ts +35 -0
  209. package/dist/forms/date-picker/model.js +83 -0
  210. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  211. package/dist/forms/dropzone/dropzone.js +153 -23
  212. package/dist/forms/emoji-picker/emoji-picker.js +1 -1
  213. package/dist/forms/field/field.d.ts +16 -10
  214. package/dist/forms/field/field.js +41 -5
  215. package/dist/forms/form/form.d.ts +15 -0
  216. package/dist/forms/form/form.js +29 -0
  217. package/dist/forms/form/index.d.ts +1 -0
  218. package/dist/forms/form/index.js +10 -0
  219. package/dist/forms/index.d.ts +6 -0
  220. package/dist/forms/index.js +6 -0
  221. package/dist/forms/input/index.d.ts +1 -1
  222. package/dist/forms/input/index.js +6 -2
  223. package/dist/forms/input/input.d.ts +23 -3
  224. package/dist/forms/input/input.js +78 -7
  225. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  226. package/dist/forms/internal/listbox-items.d.ts +18 -0
  227. package/dist/forms/internal/listbox-items.js +88 -0
  228. package/dist/forms/internal/listbox.d.ts +44 -0
  229. package/dist/forms/internal/listbox.js +74 -0
  230. package/dist/forms/number-stepper/model.d.ts +16 -0
  231. package/dist/forms/number-stepper/model.js +23 -0
  232. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  233. package/dist/forms/number-stepper/number-stepper.js +86 -37
  234. package/dist/forms/select-menu/index.d.ts +1 -0
  235. package/dist/forms/select-menu/index.js +6 -0
  236. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  237. package/dist/forms/select-menu/select-menu.js +230 -0
  238. package/dist/glass/crystal-map.d.ts +70 -0
  239. package/dist/glass/crystal-map.js +88 -0
  240. package/dist/glass/displacement-map.d.ts +117 -0
  241. package/dist/glass/displacement-map.js +201 -0
  242. package/dist/glass/index.d.ts +8 -0
  243. package/dist/glass/index.js +63 -0
  244. package/dist/glass/lens-crystal.d.ts +29 -0
  245. package/dist/glass/lens-crystal.js +161 -0
  246. package/dist/glass/lens-dispersion.d.ts +11 -0
  247. package/dist/glass/lens-dispersion.js +19 -0
  248. package/dist/glass/liquid-glass.d.ts +41 -0
  249. package/dist/glass/liquid-glass.js +256 -0
  250. package/dist/glass/liquid-motion.d.ts +53 -0
  251. package/dist/glass/liquid-motion.js +302 -0
  252. package/dist/glass/liquid-options.d.ts +162 -0
  253. package/dist/glass/liquid-options.js +179 -0
  254. package/dist/glass/refraction.d.ts +100 -0
  255. package/dist/glass/refraction.js +714 -0
  256. package/dist/glass/specular-map.d.ts +26 -0
  257. package/dist/glass/specular-map.js +75 -0
  258. package/dist/glass/spring.d.ts +79 -0
  259. package/dist/glass/spring.js +58 -0
  260. package/dist/glass/support.d.ts +13 -0
  261. package/dist/glass/support.js +14 -0
  262. package/dist/glass/use-glass-refraction.d.ts +8 -0
  263. package/dist/glass/use-glass-refraction.js +16 -0
  264. package/dist/i18n/strings.d.ts +113 -0
  265. package/dist/i18n/strings.js +70 -2
  266. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  267. package/dist/i18n/ui-strings-provider.js +6 -2
  268. package/dist/icons/index.d.ts +2 -0
  269. package/dist/icons/index.js +4 -0
  270. package/dist/icons/key.d.ts +2 -0
  271. package/dist/icons/key.js +12 -0
  272. package/dist/icons/webhook.d.ts +2 -0
  273. package/dist/icons/webhook.js +12 -0
  274. package/dist/liquid/index.d.ts +3 -0
  275. package/dist/liquid/index.js +29 -0
  276. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
  277. package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
  278. package/dist/navigation/breadcrumbs/index.d.ts +1 -0
  279. package/dist/navigation/breadcrumbs/index.js +6 -0
  280. package/dist/navigation/index.d.ts +2 -0
  281. package/dist/navigation/index.js +2 -0
  282. package/dist/navigation/segmented/index.d.ts +1 -1
  283. package/dist/navigation/segmented/model.d.ts +5 -0
  284. package/dist/navigation/segmented/model.js +6 -0
  285. package/dist/navigation/segmented/segmented.d.ts +17 -3
  286. package/dist/navigation/segmented/segmented.js +20 -4
  287. package/dist/navigation/stepper/index.d.ts +1 -1
  288. package/dist/navigation/stepper/index.js +3 -1
  289. package/dist/navigation/stepper/stepper.d.ts +8 -0
  290. package/dist/navigation/stepper/stepper.js +68 -45
  291. package/dist/navigation/tabs/index.d.ts +1 -0
  292. package/dist/navigation/tabs/index.js +6 -0
  293. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  294. package/dist/navigation/tabs/tabs-nav.js +57 -0
  295. package/dist/navigation/wizard/index.d.ts +1 -0
  296. package/dist/navigation/wizard/index.js +6 -0
  297. package/dist/navigation/wizard/model.d.ts +33 -0
  298. package/dist/navigation/wizard/model.js +34 -0
  299. package/dist/navigation/wizard/wizard.d.ts +45 -0
  300. package/dist/navigation/wizard/wizard.js +169 -0
  301. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  302. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  303. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  304. package/dist/overlays/alert-dialog/index.js +26 -0
  305. package/dist/overlays/context-menu/context-menu.d.ts +9 -1
  306. package/dist/overlays/context-menu/context-menu.js +4 -1
  307. package/dist/overlays/dialog/dialog.d.ts +9 -1
  308. package/dist/overlays/dialog/dialog.js +3 -0
  309. package/dist/overlays/drawer/drawer.d.ts +9 -1
  310. package/dist/overlays/drawer/drawer.js +3 -0
  311. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +25 -1
  312. package/dist/overlays/dropdown-menu/dropdown-menu.js +14 -4
  313. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  314. package/dist/overlays/dropdown-menu/index.js +8 -2
  315. package/dist/overlays/hover-card/hover-card.d.ts +10 -1
  316. package/dist/overlays/hover-card/hover-card.js +4 -1
  317. package/dist/overlays/index.d.ts +2 -0
  318. package/dist/overlays/index.js +2 -0
  319. package/dist/overlays/popover/popover.d.ts +9 -1
  320. package/dist/overlays/popover/popover.js +3 -0
  321. package/dist/overlays/testing/index.d.ts +5 -0
  322. package/dist/overlays/testing/index.js +4 -0
  323. package/dist/overlays/toaster/index.d.ts +2 -1
  324. package/dist/overlays/toaster/index.js +4 -2
  325. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  326. package/dist/overlays/toaster/toast.d.ts +3 -0
  327. package/dist/overlays/toaster/toast.js +3 -0
  328. package/dist/overlays/toaster/toaster.d.ts +3 -0
  329. package/dist/overlays/toaster/toaster.js +36 -3
  330. package/dist/overlays/tooltip/index.d.ts +1 -0
  331. package/dist/overlays/tooltip/index.js +4 -0
  332. package/dist/overlays/tooltip/model.d.ts +10 -0
  333. package/dist/overlays/tooltip/model.js +13 -0
  334. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  335. package/dist/overlays/tooltip/tooltip.js +116 -0
  336. package/dist/palette/command-palette/command-palette.d.ts +12 -2
  337. package/dist/palette/command-palette/command-palette.js +5 -0
  338. package/dist/primitives/command/command.d.ts +3 -2
  339. package/dist/primitives/command/command.js +2 -0
  340. package/dist/primitives/menu/menu.js +1 -1
  341. package/dist/primitives/popper/popper.js +5 -0
  342. package/dist/primitives/use-dismissable-layer.js +1 -1
  343. package/dist/rich-text/rich-text-editor.js +94 -8
  344. package/dist/rich-text/sanitize.js +70 -20
  345. package/dist/shell/app-shell/app-shell.d.ts +17 -0
  346. package/dist/shell/app-shell/app-shell.js +44 -4
  347. package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
  348. package/dist/shell/bottom-nav/bottom-nav.js +124 -0
  349. package/dist/shell/bottom-nav/index.d.ts +2 -0
  350. package/dist/shell/bottom-nav/index.js +9 -0
  351. package/dist/shell/bottom-nav/split.d.ts +11 -0
  352. package/dist/shell/bottom-nav/split.js +10 -0
  353. package/dist/shell/sidebar/sidebar.d.ts +16 -2
  354. package/dist/shell/sidebar/sidebar.js +46 -4
  355. package/dist/shell/topbar/topbar.d.ts +20 -9
  356. package/dist/shell/topbar/topbar.js +16 -9
  357. package/dist/states/empty-state/empty-state.d.ts +3 -1
  358. package/dist/states/empty-state/empty-state.js +9 -1
  359. package/dist/states/error-state/error-state.d.ts +8 -1
  360. package/dist/states/error-state/error-state.js +15 -9
  361. package/dist/states/index.d.ts +1 -0
  362. package/dist/states/index.js +1 -0
  363. package/dist/states/live-status-bar/index.d.ts +1 -0
  364. package/dist/states/live-status-bar/index.js +6 -0
  365. package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
  366. package/dist/states/live-status-bar/live-status-bar.js +49 -0
  367. package/dist/states/offline-banner/offline-banner.d.ts +3 -1
  368. package/dist/states/offline-banner/offline-banner.js +8 -4
  369. package/dist/states/skeleton/skeleton.d.ts +8 -2
  370. package/dist/states/skeleton/skeleton.js +44 -2
  371. package/dist/utils/class-groups.js +17 -0
  372. package/dist/utils/index.d.ts +1 -0
  373. package/dist/utils/index.js +2 -0
  374. package/dist/utils/material.d.ts +13 -0
  375. package/dist/utils/material.js +6 -0
  376. package/dist/utils/tone.d.ts +8 -0
  377. package/dist/utils/tone.js +17 -0
  378. package/dist/utils/use-copy.d.ts +5 -0
  379. package/dist/utils/use-copy.js +35 -0
  380. package/icons/svg/key.svg +5 -0
  381. package/icons/svg/webhook.svg +5 -0
  382. package/package.json +31 -21
  383. package/scripts/build-theme.d.mts +22 -0
  384. package/scripts/build-theme.mjs +248 -5
  385. package/src/ai/attachment/attachment.tsx +1 -1
  386. package/src/ai/chat-list/group.ts +3 -1
  387. package/src/ai/conversation/conversation.tsx +1 -1
  388. package/src/ai/internal/use-copy.ts +1 -38
  389. package/src/ai/markdown/parse.ts +74 -17
  390. package/src/ai/source/source.tsx +1 -1
  391. package/src/atoms/avatar/avatar.tsx +57 -4
  392. package/src/atoms/avatar/index.ts +8 -1
  393. package/src/atoms/button/button.tsx +8 -3
  394. package/src/atoms/checkbox/checkbox.tsx +33 -4
  395. package/src/atoms/chip/chip.tsx +55 -8
  396. package/src/atoms/chip/index.ts +9 -1
  397. package/src/atoms/due-chip/due-chip.tsx +75 -0
  398. package/src/atoms/due-chip/index.ts +2 -0
  399. package/src/atoms/due-chip/model.ts +67 -0
  400. package/src/atoms/icon-button/icon-button.tsx +58 -0
  401. package/src/atoms/icon-button/index.ts +6 -0
  402. package/src/atoms/index.ts +5 -0
  403. package/src/atoms/internal/hit-area.ts +7 -0
  404. package/src/atoms/kbd/index.ts +1 -0
  405. package/src/atoms/kbd/kbd.tsx +20 -0
  406. package/src/atoms/radio-group/radio-group.tsx +8 -2
  407. package/src/atoms/seal/index.ts +1 -0
  408. package/src/atoms/seal/seal.tsx +107 -0
  409. package/src/atoms/spinner/index.ts +1 -0
  410. package/src/atoms/spinner/spinner.tsx +49 -0
  411. package/src/atoms/status-dot/index.ts +1 -0
  412. package/src/atoms/status-dot/status-dot.tsx +15 -3
  413. package/src/atoms/switch/switch.tsx +3 -1
  414. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  415. package/src/calendar/date-calendar/index.ts +5 -0
  416. package/src/calendar/index.ts +1 -0
  417. package/src/calendar/internal/date-utils.ts +115 -0
  418. package/src/charts/README.md +21 -0
  419. package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
  420. package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
  421. package/src/charts/chord-chart/chord-chart.tsx +13 -5
  422. package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
  423. package/src/charts/core/cartesian/layout.ts +29 -10
  424. package/src/charts/core/cartesian/marks.tsx +3 -3
  425. package/src/charts/core/cartesian/types.ts +30 -2
  426. package/src/charts/core/category-explorer.tsx +12 -6
  427. package/src/charts/core/chart-dock.tsx +68 -0
  428. package/src/charts/core/chart-frame.tsx +116 -27
  429. package/src/charts/core/distribution/explorer.tsx +17 -7
  430. package/src/charts/core/distribution/xy-points.tsx +1 -1
  431. package/src/charts/core/index.ts +3 -0
  432. package/src/charts/core/leave-grace.ts +35 -0
  433. package/src/charts/core/nearest.ts +38 -0
  434. package/src/charts/core/plot-overlay.tsx +9 -3
  435. package/src/charts/core/pointer.test-utils.ts +146 -0
  436. package/src/charts/core/tooltip.tsx +129 -15
  437. package/src/charts/core/touch-select.ts +250 -0
  438. package/src/charts/core/types.ts +13 -4
  439. package/src/charts/core/use-index-navigation.ts +70 -11
  440. package/src/charts/donut-chart/donut-chart.tsx +53 -3
  441. package/src/charts/donut-chart/slice-labels.ts +39 -0
  442. package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
  443. package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
  444. package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
  445. package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
  446. package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
  447. package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
  448. package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
  449. package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
  450. package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
  451. package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
  452. package/src/charts/maps/geo/map-viewport.tsx +1 -1
  453. package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
  454. package/src/charts/progress-units/progress-units.tsx +1 -0
  455. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  456. package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
  457. package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
  458. package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
  459. package/src/charts/tree-chart/tree-chart.tsx +1 -0
  460. package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
  461. package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
  462. package/src/containers/action-bar/action-bar.tsx +13 -2
  463. package/src/containers/aside/aside.tsx +40 -0
  464. package/src/containers/aside/index.ts +1 -0
  465. package/src/containers/banner/banner.tsx +18 -1
  466. package/src/containers/card/card.tsx +43 -4
  467. package/src/containers/description-list/description-list.tsx +85 -9
  468. package/src/containers/feed/feed.tsx +99 -0
  469. package/src/containers/feed/index.ts +8 -0
  470. package/src/containers/feed/model.ts +54 -0
  471. package/src/containers/grid/grid.tsx +37 -0
  472. package/src/containers/grid/index.ts +1 -0
  473. package/src/containers/index.ts +9 -0
  474. package/src/containers/kpi/kpi.tsx +231 -38
  475. package/src/containers/kpi-group/index.ts +7 -1
  476. package/src/containers/kpi-group/kpi-group.tsx +26 -1
  477. package/src/containers/list-detail/index.ts +15 -0
  478. package/src/containers/list-detail/list-detail.tsx +293 -0
  479. package/src/containers/note/index.ts +1 -0
  480. package/src/containers/note/note.tsx +38 -0
  481. package/src/containers/page/index.ts +1 -0
  482. package/src/containers/page/page.tsx +17 -0
  483. package/src/containers/page-header/page-header.tsx +38 -8
  484. package/src/containers/responsive-list/responsive-list.tsx +7 -4
  485. package/src/containers/section/index.ts +11 -0
  486. package/src/containers/section/section.tsx +281 -0
  487. package/src/containers/shortcuts/index.ts +6 -0
  488. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  489. package/src/containers/stack/index.ts +7 -0
  490. package/src/containers/stack/stack.tsx +55 -0
  491. package/src/containers/table/selection.ts +26 -0
  492. package/src/containers/table/table.tsx +215 -13
  493. package/src/containers/timeline/index.ts +3 -0
  494. package/src/containers/timeline/timeline.tsx +204 -93
  495. package/src/forms/chip-group/chip-group.tsx +184 -0
  496. package/src/forms/chip-group/index.ts +8 -0
  497. package/src/forms/combobox/combobox.tsx +359 -0
  498. package/src/forms/combobox/index.ts +7 -0
  499. package/src/forms/copy-field/copy-field.tsx +88 -0
  500. package/src/forms/copy-field/index.ts +1 -0
  501. package/src/forms/date-picker/date-picker.tsx +239 -0
  502. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  503. package/src/forms/date-picker/index.ts +10 -0
  504. package/src/forms/date-picker/model.ts +108 -0
  505. package/src/forms/dropzone/dropzone.tsx +217 -35
  506. package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
  507. package/src/forms/field/field.tsx +72 -7
  508. package/src/forms/form/form.tsx +46 -0
  509. package/src/forms/form/index.ts +8 -0
  510. package/src/forms/index.ts +6 -0
  511. package/src/forms/input/index.ts +8 -1
  512. package/src/forms/input/input.tsx +103 -7
  513. package/src/forms/input-icon/input-icon.tsx +1 -1
  514. package/src/forms/internal/listbox-items.tsx +103 -0
  515. package/src/forms/internal/listbox.ts +124 -0
  516. package/src/forms/number-stepper/model.ts +35 -0
  517. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  518. package/src/forms/select-menu/index.ts +7 -0
  519. package/src/forms/select-menu/select-menu.tsx +280 -0
  520. package/src/glass/crystal-map.ts +150 -0
  521. package/src/glass/displacement-map.ts +317 -0
  522. package/src/glass/index.ts +43 -0
  523. package/src/glass/lens-crystal.ts +226 -0
  524. package/src/glass/lens-dispersion.ts +34 -0
  525. package/src/glass/liquid-glass.tsx +371 -0
  526. package/src/glass/liquid-motion.ts +395 -0
  527. package/src/glass/liquid-options.ts +306 -0
  528. package/src/glass/refraction.ts +1010 -0
  529. package/src/glass/specular-map.ts +95 -0
  530. package/src/glass/spring.ts +98 -0
  531. package/src/glass/support.ts +27 -0
  532. package/src/glass/use-glass-refraction.ts +21 -0
  533. package/src/i18n/strings.ts +113 -0
  534. package/src/i18n/ui-strings-provider.tsx +15 -4
  535. package/src/icons/index.ts +2 -0
  536. package/src/icons/key.tsx +13 -0
  537. package/src/icons/webhook.tsx +13 -0
  538. package/src/liquid/index.ts +24 -0
  539. package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
  540. package/src/navigation/breadcrumbs/index.ts +8 -0
  541. package/src/navigation/index.ts +2 -0
  542. package/src/navigation/segmented/index.ts +1 -0
  543. package/src/navigation/segmented/model.ts +11 -0
  544. package/src/navigation/segmented/segmented.tsx +45 -6
  545. package/src/navigation/stepper/index.ts +7 -1
  546. package/src/navigation/stepper/stepper.tsx +41 -5
  547. package/src/navigation/tabs/index.ts +7 -0
  548. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  549. package/src/navigation/wizard/index.ts +7 -0
  550. package/src/navigation/wizard/model.ts +61 -0
  551. package/src/navigation/wizard/wizard.tsx +222 -0
  552. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  553. package/src/overlays/alert-dialog/index.ts +19 -0
  554. package/src/overlays/context-menu/context-menu.tsx +11 -1
  555. package/src/overlays/dialog/dialog.tsx +10 -0
  556. package/src/overlays/drawer/drawer.tsx +10 -0
  557. package/src/overlays/dropdown-menu/dropdown-menu.tsx +38 -4
  558. package/src/overlays/dropdown-menu/index.ts +3 -0
  559. package/src/overlays/hover-card/hover-card.tsx +12 -1
  560. package/src/overlays/index.ts +2 -0
  561. package/src/overlays/popover/popover.tsx +10 -0
  562. package/src/overlays/testing/index.ts +5 -0
  563. package/src/overlays/toaster/index.ts +2 -0
  564. package/src/overlays/toaster/toast-store.ts +6 -2
  565. package/src/overlays/toaster/toast.ts +6 -0
  566. package/src/overlays/toaster/toaster.tsx +44 -2
  567. package/src/overlays/tooltip/index.ts +1 -0
  568. package/src/overlays/tooltip/model.ts +18 -0
  569. package/src/overlays/tooltip/tooltip.tsx +166 -0
  570. package/src/palette/command-palette/command-palette.tsx +15 -1
  571. package/src/primitives/command/command.tsx +4 -0
  572. package/src/primitives/menu/menu.tsx +1 -1
  573. package/src/primitives/popper/popper.tsx +10 -0
  574. package/src/primitives/use-dismissable-layer.ts +7 -2
  575. package/src/rich-text/rich-text-editor.tsx +116 -13
  576. package/src/rich-text/sanitize.ts +94 -23
  577. package/src/shell/app-shell/app-shell.tsx +60 -4
  578. package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
  579. package/src/shell/bottom-nav/index.ts +8 -0
  580. package/src/shell/bottom-nav/split.ts +20 -0
  581. package/src/shell/sidebar/sidebar.tsx +51 -5
  582. package/src/shell/topbar/topbar.tsx +81 -58
  583. package/src/states/empty-state/empty-state.tsx +11 -1
  584. package/src/states/error-state/error-state.tsx +23 -8
  585. package/src/states/index.ts +1 -0
  586. package/src/states/live-status-bar/index.ts +6 -0
  587. package/src/states/live-status-bar/live-status-bar.tsx +62 -0
  588. package/src/states/offline-banner/offline-banner.tsx +13 -5
  589. package/src/states/skeleton/skeleton.tsx +68 -2
  590. package/src/utils/class-groups.ts +17 -0
  591. package/src/utils/index.ts +1 -0
  592. package/src/utils/material.ts +16 -0
  593. package/src/utils/tone.ts +29 -0
  594. package/src/utils/use-copy.ts +38 -0
  595. package/styles/Theme.kt +64 -3
  596. package/styles/base.css +51 -0
  597. package/styles/tailwind.css +836 -0
  598. package/styles/theme.css +579 -34
  599. package/styles/tokens.css +788 -15
  600. package/tokens/default.json +918 -29
  601. package/scripts/build-theme.d.ts +0 -18
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
 
3
- import { type ComponentPropsWithRef, createContext, useContext } from "react";
3
+ import { type ComponentPropsWithRef, createContext, type ReactNode, useContext } from "react";
4
4
  import { cn } from "../../utils/cn.js";
5
5
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
6
6
  import {
@@ -9,6 +9,7 @@ import {
9
9
  useRovingFocus,
10
10
  } from "../../utils/roving-focus.js";
11
11
  import { useControllableState } from "../../utils/use-controllable-state.js";
12
+ import { nextSegmentedValue } from "./model.js";
12
13
 
13
14
  type GetItemProps = ReturnType<typeof useRovingFocus>["getItemProps"];
14
15
 
@@ -16,11 +17,19 @@ interface SegmentedContextValue {
16
17
  value: string;
17
18
  setValue: (value: string) => void;
18
19
  disabled: boolean;
20
+ block: boolean;
21
+ allowDeselect: boolean;
19
22
  getItemProps: GetItemProps | null;
20
23
  }
21
24
 
22
25
  const SegmentedContext = createContext<SegmentedContextValue | null>(null);
23
26
 
27
+ export interface SegmentedOption {
28
+ value: string;
29
+ label: ReactNode;
30
+ disabled?: boolean | undefined;
31
+ }
32
+
24
33
  export interface SegmentedProps
25
34
  extends Omit<ComponentPropsWithRef<"div">, "dir" | "defaultValue" | "onChange"> {
26
35
  /** Controlled selected value; an empty string means nothing selected. */
@@ -31,12 +40,21 @@ export interface SegmentedProps
31
40
  disabled?: boolean | undefined;
32
41
  /** Set to `false` to put every item in the tab order instead of roving. Defaults to `true`. */
33
42
  rovingFocus?: boolean | undefined;
43
+ /** Items from data, rendered when no children are given. */
44
+ options?: SegmentedOption[] | undefined;
45
+ /** Full-width selector with equal-width, control-height items. */
46
+ block?: boolean | undefined;
47
+ /** Lets a second press on the selected item clear the selection. Defaults to `false`: the selected item stays selected. */
48
+ allowDeselect?: boolean | undefined;
34
49
  orientation?: RovingOrientation | undefined;
35
50
  dir?: RovingDirection | undefined;
36
51
  loop?: boolean | undefined;
37
52
  }
38
53
 
39
- /** Exclusive selector for 2-4 options. Like Radix `type="single"`, it uses the `radiogroup` role. */
54
+ /**
55
+ * Exclusive selector for 2-4 options. Like Radix `type="single"`, it uses the `radiogroup` role.
56
+ * Pressing the selected item keeps it selected; pass `allowDeselect` to let it clear instead.
57
+ */
40
58
  export function Segmented({
41
59
  className,
42
60
  value: valueProp,
@@ -44,6 +62,10 @@ export function Segmented({
44
62
  onValueChange,
45
63
  disabled = false,
46
64
  rovingFocus = true,
65
+ options,
66
+ block = false,
67
+ allowDeselect = false,
68
+ children,
47
69
  orientation,
48
70
  dir = "ltr",
49
71
  loop = true,
@@ -62,7 +84,14 @@ export function Segmented({
62
84
 
63
85
  return (
64
86
  <SegmentedContext.Provider
65
- value={{ value, setValue, disabled, getItemProps: rovingFocus ? roving.getItemProps : null }}
87
+ value={{
88
+ value,
89
+ setValue,
90
+ disabled,
91
+ block,
92
+ allowDeselect,
93
+ getItemProps: rovingFocus ? roving.getItemProps : null,
94
+ }}
66
95
  >
67
96
  <div
68
97
  role="radiogroup"
@@ -72,10 +101,18 @@ export function Segmented({
72
101
  ref={composedRef}
73
102
  onFocus={rovingFocus ? composeHandlers(onFocus, rovingOnFocus) : onFocus}
74
103
  className={cn(
75
- "inline-flex max-w-full overflow-x-auto rounded-button bg-seg-track p-0.75",
104
+ "max-w-full overflow-x-auto rounded-button bg-seg-track p-0.75",
105
+ block ? "flex w-full" : "inline-flex",
76
106
  className,
77
107
  )}
78
- />
108
+ >
109
+ {children ??
110
+ options?.map((option) => (
111
+ <SegmentedItem key={option.value} value={option.value} disabled={option.disabled}>
112
+ {option.label}
113
+ </SegmentedItem>
114
+ ))}
115
+ </div>
79
116
  </SegmentedContext.Provider>
80
117
  );
81
118
  }
@@ -113,10 +150,12 @@ export function SegmentedItem({
113
150
  {...props}
114
151
  {...item}
115
152
  onClick={composeHandlers(onClick, () => {
116
- if (!disabled) context.setValue(pressed ? "" : value);
153
+ if (!disabled)
154
+ context.setValue(nextSegmentedValue(context.value, value, context.allowDeselect));
117
155
  })}
118
156
  className={cn(
119
157
  "inline-flex h-control-sm shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap rounded-button px-3.5 @max-[420px]:px-2.5 text-control text-ink-2 hover:text-ink data-[state=on]:bg-seg-on data-[state=on]:text-ink data-[state=on]:shadow-sel",
158
+ context.block && "h-control flex-1 shrink justify-center",
120
159
  className,
121
160
  )}
122
161
  />
@@ -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
@@ -8,3 +8,10 @@ export {
8
8
  TabsTrigger,
9
9
  type TabsTriggerProps,
10
10
  } from "./tabs.js";
11
+ export {
12
+ TabsNav,
13
+ TabsNavLink,
14
+ type TabsNavLinkProps,
15
+ type TabsNavLinkRenderProps,
16
+ type TabsNavProps,
17
+ } from "./tabs-nav.js";
@@ -0,0 +1,131 @@
1
+ "use client";
2
+
3
+ import {
4
+ type AnchorHTMLAttributes,
5
+ type ComponentPropsWithoutRef,
6
+ cloneElement,
7
+ createContext,
8
+ isValidElement,
9
+ type ReactElement,
10
+ type ReactNode,
11
+ type Ref,
12
+ useContext,
13
+ } from "react";
14
+ import { cn } from "../../utils/cn.js";
15
+ import { Slot } from "../../utils/slot.js";
16
+
17
+ /** Props handed to `renderLink`: spread them on your router's link component. */
18
+ export interface TabsNavLinkRenderProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
19
+ ref?: Ref<HTMLAnchorElement>;
20
+ "aria-current"?: "page" | undefined;
21
+ "data-active"?: "" | undefined;
22
+ }
23
+
24
+ interface TabsNavContextValue {
25
+ value: string | undefined;
26
+ renderLink: ((props: TabsNavLinkRenderProps) => ReactNode) | undefined;
27
+ }
28
+
29
+ const TabsNavContext = createContext<TabsNavContextValue>({
30
+ value: undefined,
31
+ renderLink: undefined,
32
+ });
33
+
34
+ export interface TabsNavProps extends ComponentPropsWithoutRef<"nav"> {
35
+ /** Name of the strip (required: a page can have several navigations). */
36
+ "aria-label": string;
37
+ /** Value of the item that is the current page. */
38
+ value?: string | undefined;
39
+ /**
40
+ * Renders every link with your router's component instead of an `<a>`:
41
+ * `renderLink={(props) => <Link to={...} {...props} />}`. An item's own `asChild` wins.
42
+ */
43
+ renderLink?: ((props: TabsNavLinkRenderProps) => ReactNode) | undefined;
44
+ }
45
+
46
+ /**
47
+ * Tab-looking sub-navigation made of links. Unlike `Tabs` it has no panels and no tab roles:
48
+ * each item is a real link, the current one carries `aria-current="page"`, and the router is
49
+ * yours (`href`, `renderLink` or `asChild`). The strip is flush to its container's inline edges
50
+ * and scrolls sideways when the items do not fit.
51
+ */
52
+ export function TabsNav({ value, renderLink, className, children, ...props }: TabsNavProps) {
53
+ return (
54
+ <TabsNavContext.Provider value={{ value, renderLink }}>
55
+ <nav {...props} className={cn("@container/tabs-nav min-w-0", className)}>
56
+ <ul className="m-0 flex list-none gap-0.5 overflow-x-auto overscroll-x-contain border-b-divider p-0">
57
+ {children}
58
+ </ul>
59
+ </nav>
60
+ </TabsNavContext.Provider>
61
+ );
62
+ }
63
+
64
+ export interface TabsNavLinkProps extends Omit<ComponentPropsWithoutRef<"a">, "children"> {
65
+ /** Matches the strip's `value` to mark this item as the current page. */
66
+ value: string;
67
+ /** Overrides the match for routers that report the active state themselves. */
68
+ active?: boolean | undefined;
69
+ /** Optional record count shown after the label. */
70
+ count?: number | undefined;
71
+ /** Renders the single child element (a router `Link`) with the item's look and a11y props. */
72
+ asChild?: boolean | undefined;
73
+ children: ReactNode;
74
+ }
75
+
76
+ const itemClasses =
77
+ "inline-flex shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap border-b-2 border-transparent px-2.5 @max-[420px]/tabs-nav:px-2 pt-2.75 pb-2.5 text-control text-ink-3 no-underline hover:text-ink focus-visible:-outline-offset-2 aria-[current=page]:border-accent-word aria-[current=page]:text-ink";
78
+
79
+ export function TabsNavLink({
80
+ value,
81
+ active,
82
+ count,
83
+ asChild = false,
84
+ className,
85
+ children,
86
+ ...props
87
+ }: TabsNavLinkProps) {
88
+ const context = useContext(TabsNavContext);
89
+ const isActive = active ?? (context.value !== undefined && context.value === value);
90
+ const shared = {
91
+ ...props,
92
+ "aria-current": isActive ? ("page" as const) : undefined,
93
+ "data-active": isActive ? ("" as const) : undefined,
94
+ className: cn(itemClasses, className),
95
+ };
96
+ const countNode =
97
+ count !== undefined ? <span className="text-count text-ink-3">{count}</span> : null;
98
+
99
+ if (asChild && isValidElement(children)) {
100
+ const child = children as ReactElement<{ children?: ReactNode }>;
101
+ return (
102
+ <li>
103
+ <Slot {...shared}>
104
+ {cloneElement(
105
+ child,
106
+ undefined,
107
+ <>
108
+ {child.props.children}
109
+ {countNode}
110
+ </>,
111
+ )}
112
+ </Slot>
113
+ </li>
114
+ );
115
+ }
116
+ const content = (
117
+ <>
118
+ {children}
119
+ {countNode}
120
+ </>
121
+ );
122
+ return (
123
+ <li>
124
+ {context.renderLink ? (
125
+ context.renderLink({ ...shared, children: content })
126
+ ) : (
127
+ <a {...shared}>{content}</a>
128
+ )}
129
+ </li>
130
+ );
131
+ }
@@ -0,0 +1,7 @@
1
+ export {
2
+ Wizard,
3
+ type WizardGate,
4
+ type WizardPart,
5
+ type WizardProps,
6
+ type WizardStep,
7
+ } from "./wizard.js";
@@ -0,0 +1,61 @@
1
+ /** A step gate: a plain flag, or a check that may be asynchronous. */
2
+ export type WizardGate = boolean | (() => boolean | Promise<boolean>);
3
+
4
+ export interface GateResult {
5
+ /** True when every gate allowed the move. */
6
+ ok: boolean;
7
+ /** True when a gate threw or rejected (the move is blocked either way). */
8
+ failed: boolean;
9
+ }
10
+
11
+ /** Runs the gates in order and stops at the first one that blocks; a throwing gate blocks. */
12
+ export async function evaluateGates(
13
+ gates: ReadonlyArray<WizardGate | undefined>,
14
+ ): Promise<GateResult> {
15
+ for (const gate of gates) {
16
+ if (gate === undefined) continue;
17
+ try {
18
+ const allowed = typeof gate === "function" ? await gate() : gate;
19
+ if (allowed === false) return { ok: false, failed: false };
20
+ } catch {
21
+ return { ok: false, failed: true };
22
+ }
23
+ }
24
+ return { ok: true, failed: false };
25
+ }
26
+
27
+ export function clampIndex(index: number, length: number): number {
28
+ if (length <= 0) return 0;
29
+ return Math.min(Math.max(Math.trunc(index) || 0, 0), length - 1);
30
+ }
31
+
32
+ /** Fills the `{current}`, `{total}` and `{label}` placeholders of the `stepOf` UI string. */
33
+ export function formatStepOf(
34
+ template: string,
35
+ values: { current: number; total: number; label: string },
36
+ ): string {
37
+ return template
38
+ .replace("{current}", String(values.current))
39
+ .replace("{total}", String(values.total))
40
+ .replace("{label}", values.label);
41
+ }
42
+
43
+ /** Enter inside a single-line text-like input advances the wizard, like submitting a form. */
44
+ export function isAdvanceKey(event: {
45
+ key: string;
46
+ defaultPrevented: boolean;
47
+ shiftKey: boolean;
48
+ altKey: boolean;
49
+ ctrlKey: boolean;
50
+ metaKey: boolean;
51
+ nativeEvent?: { isComposing?: boolean };
52
+ target: EventTarget | { tagName?: string; type?: string };
53
+ }): boolean {
54
+ if (event.key !== "Enter" || event.defaultPrevented) return false;
55
+ if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return false;
56
+ if (event.nativeEvent?.isComposing) return false;
57
+ const target = event.target as { tagName?: string; type?: string };
58
+ if (target.tagName !== "INPUT") return false;
59
+ const type = target.type ?? "text";
60
+ return !["checkbox", "radio", "button", "submit", "reset", "file", "image"].includes(type);
61
+ }
@@ -0,0 +1,222 @@
1
+ "use client";
2
+
3
+ import {
4
+ type ComponentPropsWithoutRef,
5
+ type KeyboardEvent,
6
+ type ReactNode,
7
+ useEffect,
8
+ useRef,
9
+ useState,
10
+ } from "react";
11
+ import { Button } from "../../atoms/button/button.js";
12
+ import { useUiStrings } from "../../i18n/index.js";
13
+ import type { ClassNames } from "../../utils/class-names.js";
14
+ import { cn } from "../../utils/cn.js";
15
+ import { useControllableState } from "../../utils/use-controllable-state.js";
16
+ import { Stepper } from "../stepper/stepper.js";
17
+ import { clampIndex, evaluateGates, formatStepOf, isAdvanceKey, type WizardGate } from "./model.js";
18
+
19
+ export type { WizardGate } from "./model.js";
20
+
21
+ export interface WizardStep {
22
+ id: string;
23
+ label: string;
24
+ content: ReactNode;
25
+ /**
26
+ * Blocks "Next" for this step: `false` disables the button, a function runs when Next is
27
+ * pressed (it may be async; `false` or a throw keeps the step).
28
+ */
29
+ canAdvance?: WizardGate;
30
+ }
31
+
32
+ export type WizardPart =
33
+ | "root"
34
+ | "stepper"
35
+ | "heading"
36
+ | "content"
37
+ | "error"
38
+ | "footer"
39
+ | "back"
40
+ | "next";
41
+
42
+ export interface WizardProps
43
+ extends Omit<ComponentPropsWithoutRef<"div">, "children" | "defaultValue" | "onChange"> {
44
+ steps: readonly WizardStep[];
45
+ /** Controlled current step id. */
46
+ value?: string | undefined;
47
+ /** Initial step id when uncontrolled (defaults to the first step). */
48
+ defaultValue?: string | undefined;
49
+ onValueChange?: ((stepId: string) => void) | undefined;
50
+ /**
51
+ * Runs before moving forward from a step, after that step's `canAdvance`. Return `false` (or
52
+ * a promise of `false`) to stay. While it is pending the buttons show a busy state and a
53
+ * second press is ignored.
54
+ */
55
+ onBeforeNext?: ((step: WizardStep, index: number) => boolean | Promise<boolean>) | undefined;
56
+ /** Called by the last step's finish button; may return a promise (pending state, no double run). */
57
+ onComplete?: (() => void | Promise<void>) | undefined;
58
+ /** Overrides the localized labels. */
59
+ backLabel?: string | undefined;
60
+ nextLabel?: string | undefined;
61
+ finishLabel?: string | undefined;
62
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root. */
63
+ classNames?: ClassNames<WizardPart>;
64
+ }
65
+
66
+ /**
67
+ * Multi-step flow on top of `Stepper`: the current step's content, then Back / Next / Finish.
68
+ * Moving forward runs the step's `canAdvance` and `onBeforeNext`; the step heading takes focus
69
+ * on every change so keyboard and screen-reader users land on the new step. Enter inside a
70
+ * single-line input advances. Under 420px of its own width the step title becomes visible and
71
+ * the buttons stack.
72
+ */
73
+ export function Wizard({
74
+ steps,
75
+ value: valueProp,
76
+ defaultValue,
77
+ onValueChange,
78
+ onBeforeNext,
79
+ onComplete,
80
+ backLabel,
81
+ nextLabel,
82
+ finishLabel,
83
+ className,
84
+ classNames,
85
+ ...props
86
+ }: WizardProps) {
87
+ const strings = useUiStrings();
88
+ const [stepId, setStepId] = useControllableState<string>({
89
+ prop: valueProp,
90
+ defaultProp: defaultValue ?? steps[0]?.id ?? "",
91
+ onChange: onValueChange,
92
+ });
93
+ const found = steps.findIndex((step) => step.id === stepId);
94
+ const index = clampIndex(found, steps.length);
95
+ const current = steps[index];
96
+ const isLast = index === steps.length - 1;
97
+
98
+ const [pending, setPending] = useState<"next" | "finish" | null>(null);
99
+ const [failed, setFailed] = useState(false);
100
+ const busy = useRef(false);
101
+ const headingRef = useRef<HTMLHeadingElement>(null);
102
+ const shownIndex = useRef(index);
103
+
104
+ useEffect(() => {
105
+ if (shownIndex.current === index) return;
106
+ shownIndex.current = index;
107
+ headingRef.current?.focus();
108
+ });
109
+
110
+ if (!current) return null;
111
+
112
+ const guarded = async (kind: "next" | "finish", run: () => Promise<void> | void) => {
113
+ if (busy.current) return;
114
+ busy.current = true;
115
+ setPending(kind);
116
+ setFailed(false);
117
+ try {
118
+ await run();
119
+ } finally {
120
+ busy.current = false;
121
+ setPending(null);
122
+ }
123
+ };
124
+
125
+ const goTo = (target: number) => {
126
+ const next = steps[clampIndex(target, steps.length)];
127
+ if (next) setStepId(next.id);
128
+ };
129
+
130
+ const advance = () =>
131
+ guarded(isLast ? "finish" : "next", async () => {
132
+ const gates = await evaluateGates([
133
+ current.canAdvance,
134
+ onBeforeNext ? () => onBeforeNext(current, index) : undefined,
135
+ ]);
136
+ if (gates.failed) setFailed(true);
137
+ if (!gates.ok) return;
138
+ if (isLast) {
139
+ try {
140
+ await onComplete?.();
141
+ } catch {
142
+ setFailed(true);
143
+ }
144
+ return;
145
+ }
146
+ goTo(index + 1);
147
+ });
148
+
149
+ const blocked = current.canAdvance === false;
150
+ const label = formatStepOf(strings.stepOf, {
151
+ current: index + 1,
152
+ total: steps.length,
153
+ label: current.label,
154
+ });
155
+
156
+ return (
157
+ <div
158
+ {...props}
159
+ data-pending={pending ?? undefined}
160
+ className={cn("@container/wizard flex min-w-0 flex-col gap-3", classNames?.root, className)}
161
+ >
162
+ <Stepper
163
+ aria-label={strings.steps}
164
+ steps={steps.map(({ id, label: stepLabel }) => ({ id, label: stepLabel }))}
165
+ currentStepId={current.id}
166
+ className={classNames?.stepper}
167
+ />
168
+ <h2
169
+ ref={headingRef}
170
+ tabIndex={-1}
171
+ className={cn(
172
+ "m-0 text-body font-semibold text-ink outline-none @max-[420px]/wizard:not-sr-only sr-only",
173
+ classNames?.heading,
174
+ )}
175
+ >
176
+ {label}
177
+ </h2>
178
+ {/* biome-ignore lint/a11y/noStaticElementInteractions: Enter in a text input advances, like a form; the buttons stay the accessible path */}
179
+ <div
180
+ className={cn("min-w-0", classNames?.content)}
181
+ onKeyDown={(event: KeyboardEvent<HTMLDivElement>) => {
182
+ if (isAdvanceKey(event)) {
183
+ event.preventDefault();
184
+ if (!blocked) void advance();
185
+ }
186
+ }}
187
+ >
188
+ {current.content}
189
+ </div>
190
+ {failed ? (
191
+ <p role="alert" className={cn("m-0 text-danger text-meta", classNames?.error)}>
192
+ {strings.actionFailed}
193
+ </p>
194
+ ) : null}
195
+ <div
196
+ className={cn(
197
+ "flex items-center justify-between gap-2 @max-[420px]/wizard:flex-col-reverse @max-[420px]/wizard:items-stretch",
198
+ classNames?.footer,
199
+ )}
200
+ >
201
+ <Button
202
+ variant="secondary"
203
+ disabled={index === 0 || pending !== null}
204
+ onClick={() => goTo(index - 1)}
205
+ className={classNames?.back}
206
+ >
207
+ {backLabel ?? strings.back}
208
+ </Button>
209
+ <Button
210
+ variant="primary"
211
+ loading={pending !== null}
212
+ loadingLabel={strings.processing}
213
+ disabled={blocked}
214
+ onClick={() => void advance()}
215
+ className={classNames?.next}
216
+ >
217
+ {isLast ? (finishLabel ?? strings.finish) : (nextLabel ?? strings.next)}
218
+ </Button>
219
+ </div>
220
+ </div>
221
+ );
222
+ }