@jcsoftdev/ui 0.3.0 → 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 (268) hide show
  1. package/CHANGELOG.md +103 -1
  2. package/README.md +55 -2
  3. package/bin/ui-theme.mjs +13 -2
  4. package/dist/atoms/checkbox/checkbox.js +3 -1
  5. package/dist/atoms/chip/chip.d.ts +11 -3
  6. package/dist/atoms/chip/chip.js +8 -1
  7. package/dist/atoms/chip/index.d.ts +1 -1
  8. package/dist/atoms/chip/index.js +2 -0
  9. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  10. package/dist/atoms/due-chip/due-chip.js +41 -0
  11. package/dist/atoms/due-chip/index.d.ts +2 -0
  12. package/dist/atoms/due-chip/index.js +6 -0
  13. package/dist/atoms/due-chip/model.d.ts +25 -0
  14. package/dist/atoms/due-chip/model.js +44 -0
  15. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  16. package/dist/atoms/icon-button/icon-button.js +38 -0
  17. package/dist/atoms/icon-button/index.d.ts +1 -0
  18. package/dist/atoms/icon-button/index.js +8 -0
  19. package/dist/atoms/index.d.ts +5 -0
  20. package/dist/atoms/index.js +5 -0
  21. package/dist/atoms/internal/hit-area.d.ts +6 -0
  22. package/dist/atoms/internal/hit-area.js +4 -0
  23. package/dist/atoms/kbd/index.d.ts +1 -0
  24. package/dist/atoms/kbd/index.js +4 -0
  25. package/dist/atoms/kbd/kbd.d.ts +7 -0
  26. package/dist/atoms/kbd/kbd.js +17 -0
  27. package/dist/atoms/radio-group/radio-group.js +6 -2
  28. package/dist/atoms/seal/index.d.ts +1 -0
  29. package/dist/atoms/seal/index.js +4 -0
  30. package/dist/atoms/seal/seal.d.ts +30 -0
  31. package/dist/atoms/seal/seal.js +71 -0
  32. package/dist/atoms/spinner/index.d.ts +1 -0
  33. package/dist/atoms/spinner/index.js +5 -0
  34. package/dist/atoms/spinner/spinner.d.ts +19 -0
  35. package/dist/atoms/spinner/spinner.js +31 -0
  36. package/dist/atoms/switch/switch.js +3 -1
  37. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  38. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  39. package/dist/calendar/date-calendar/index.d.ts +1 -0
  40. package/dist/calendar/date-calendar/index.js +6 -0
  41. package/dist/calendar/index.d.ts +1 -0
  42. package/dist/calendar/index.js +1 -0
  43. package/dist/calendar/internal/date-utils.d.ts +26 -0
  44. package/dist/calendar/internal/date-utils.js +95 -1
  45. package/dist/containers/aside/aside.d.ts +14 -0
  46. package/dist/containers/aside/aside.js +25 -0
  47. package/dist/containers/aside/index.d.ts +1 -0
  48. package/dist/containers/aside/index.js +5 -0
  49. package/dist/containers/banner/banner.d.ts +4 -1
  50. package/dist/containers/banner/banner.js +9 -1
  51. package/dist/containers/description-list/description-list.d.ts +29 -6
  52. package/dist/containers/description-list/description-list.js +47 -6
  53. package/dist/containers/feed/feed.d.ts +23 -0
  54. package/dist/containers/feed/feed.js +77 -0
  55. package/dist/containers/feed/index.d.ts +2 -0
  56. package/dist/containers/feed/index.js +10 -0
  57. package/dist/containers/feed/model.d.ts +19 -0
  58. package/dist/containers/feed/model.js +38 -0
  59. package/dist/containers/index.d.ts +6 -0
  60. package/dist/containers/index.js +6 -0
  61. package/dist/containers/kpi/kpi.d.ts +50 -8
  62. package/dist/containers/kpi/kpi.js +91 -39
  63. package/dist/containers/list-detail/index.d.ts +1 -0
  64. package/dist/containers/list-detail/index.js +20 -0
  65. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  66. package/dist/containers/list-detail/list-detail.js +221 -0
  67. package/dist/containers/note/index.d.ts +1 -0
  68. package/dist/containers/note/index.js +4 -0
  69. package/dist/containers/note/note.d.ts +13 -0
  70. package/dist/containers/note/note.js +27 -0
  71. package/dist/containers/section/index.d.ts +1 -0
  72. package/dist/containers/section/index.js +6 -0
  73. package/dist/containers/section/section.d.ts +68 -0
  74. package/dist/containers/section/section.js +198 -0
  75. package/dist/containers/shortcuts/index.d.ts +1 -0
  76. package/dist/containers/shortcuts/index.js +8 -0
  77. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  78. package/dist/containers/shortcuts/shortcuts.js +50 -0
  79. package/dist/containers/table/selection.d.ts +9 -0
  80. package/dist/containers/table/selection.js +20 -0
  81. package/dist/containers/table/table.d.ts +66 -4
  82. package/dist/containers/table/table.js +128 -7
  83. package/dist/containers/timeline/index.d.ts +1 -1
  84. package/dist/containers/timeline/index.js +4 -2
  85. package/dist/containers/timeline/timeline.d.ts +32 -5
  86. package/dist/containers/timeline/timeline.js +154 -90
  87. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  88. package/dist/forms/chip-group/chip-group.js +114 -0
  89. package/dist/forms/chip-group/index.d.ts +1 -0
  90. package/dist/forms/chip-group/index.js +6 -0
  91. package/dist/forms/combobox/combobox.d.ts +60 -0
  92. package/dist/forms/combobox/combobox.js +281 -0
  93. package/dist/forms/combobox/index.d.ts +1 -0
  94. package/dist/forms/combobox/index.js +6 -0
  95. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  96. package/dist/forms/date-picker/date-picker.js +183 -0
  97. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  98. package/dist/forms/date-picker/date-time-picker.js +121 -0
  99. package/dist/forms/date-picker/index.d.ts +2 -0
  100. package/dist/forms/date-picker/index.js +10 -0
  101. package/dist/forms/date-picker/model.d.ts +35 -0
  102. package/dist/forms/date-picker/model.js +83 -0
  103. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  104. package/dist/forms/dropzone/dropzone.js +153 -23
  105. package/dist/forms/field/field.d.ts +16 -10
  106. package/dist/forms/field/field.js +41 -5
  107. package/dist/forms/index.d.ts +4 -0
  108. package/dist/forms/index.js +4 -0
  109. package/dist/forms/input/index.d.ts +1 -1
  110. package/dist/forms/input/index.js +4 -1
  111. package/dist/forms/input/input.d.ts +21 -5
  112. package/dist/forms/input/input.js +74 -9
  113. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  114. package/dist/forms/internal/listbox-items.d.ts +18 -0
  115. package/dist/forms/internal/listbox-items.js +88 -0
  116. package/dist/forms/internal/listbox.d.ts +44 -0
  117. package/dist/forms/internal/listbox.js +74 -0
  118. package/dist/forms/number-stepper/model.d.ts +16 -0
  119. package/dist/forms/number-stepper/model.js +23 -0
  120. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  121. package/dist/forms/number-stepper/number-stepper.js +86 -37
  122. package/dist/forms/select-menu/index.d.ts +1 -0
  123. package/dist/forms/select-menu/index.js +6 -0
  124. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  125. package/dist/forms/select-menu/select-menu.js +230 -0
  126. package/dist/i18n/strings.d.ts +89 -0
  127. package/dist/i18n/strings.js +54 -2
  128. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  129. package/dist/i18n/ui-strings-provider.js +6 -2
  130. package/dist/navigation/index.d.ts +1 -0
  131. package/dist/navigation/index.js +1 -0
  132. package/dist/navigation/stepper/index.d.ts +1 -1
  133. package/dist/navigation/stepper/index.js +3 -1
  134. package/dist/navigation/stepper/stepper.d.ts +8 -0
  135. package/dist/navigation/stepper/stepper.js +68 -45
  136. package/dist/navigation/tabs/index.d.ts +1 -0
  137. package/dist/navigation/tabs/index.js +6 -0
  138. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  139. package/dist/navigation/tabs/tabs-nav.js +57 -0
  140. package/dist/navigation/wizard/index.d.ts +1 -0
  141. package/dist/navigation/wizard/index.js +6 -0
  142. package/dist/navigation/wizard/model.d.ts +33 -0
  143. package/dist/navigation/wizard/model.js +34 -0
  144. package/dist/navigation/wizard/wizard.d.ts +45 -0
  145. package/dist/navigation/wizard/wizard.js +169 -0
  146. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  147. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  148. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  149. package/dist/overlays/alert-dialog/index.js +26 -0
  150. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +17 -1
  151. package/dist/overlays/dropdown-menu/dropdown-menu.js +12 -4
  152. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  153. package/dist/overlays/dropdown-menu/index.js +8 -2
  154. package/dist/overlays/index.d.ts +2 -0
  155. package/dist/overlays/index.js +2 -0
  156. package/dist/overlays/testing/index.d.ts +5 -0
  157. package/dist/overlays/testing/index.js +4 -0
  158. package/dist/overlays/toaster/index.d.ts +2 -1
  159. package/dist/overlays/toaster/index.js +4 -2
  160. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  161. package/dist/overlays/toaster/toast.d.ts +3 -0
  162. package/dist/overlays/toaster/toast.js +3 -0
  163. package/dist/overlays/toaster/toaster.d.ts +3 -0
  164. package/dist/overlays/toaster/toaster.js +36 -3
  165. package/dist/overlays/tooltip/index.d.ts +1 -0
  166. package/dist/overlays/tooltip/index.js +4 -0
  167. package/dist/overlays/tooltip/model.d.ts +10 -0
  168. package/dist/overlays/tooltip/model.js +13 -0
  169. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  170. package/dist/overlays/tooltip/tooltip.js +116 -0
  171. package/dist/primitives/use-dismissable-layer.js +1 -1
  172. package/dist/states/error-state/error-state.d.ts +6 -1
  173. package/dist/states/error-state/error-state.js +13 -9
  174. package/dist/states/skeleton/skeleton.d.ts +8 -2
  175. package/dist/states/skeleton/skeleton.js +44 -2
  176. package/package.json +2 -2
  177. package/scripts/build-theme.mjs +12 -1
  178. package/src/atoms/checkbox/checkbox.tsx +3 -1
  179. package/src/atoms/chip/chip.tsx +18 -3
  180. package/src/atoms/chip/index.ts +2 -0
  181. package/src/atoms/due-chip/due-chip.tsx +75 -0
  182. package/src/atoms/due-chip/index.ts +2 -0
  183. package/src/atoms/due-chip/model.ts +67 -0
  184. package/src/atoms/icon-button/icon-button.tsx +58 -0
  185. package/src/atoms/icon-button/index.ts +6 -0
  186. package/src/atoms/index.ts +5 -0
  187. package/src/atoms/internal/hit-area.ts +7 -0
  188. package/src/atoms/kbd/index.ts +1 -0
  189. package/src/atoms/kbd/kbd.tsx +20 -0
  190. package/src/atoms/radio-group/radio-group.tsx +8 -2
  191. package/src/atoms/seal/index.ts +1 -0
  192. package/src/atoms/seal/seal.tsx +107 -0
  193. package/src/atoms/spinner/index.ts +1 -0
  194. package/src/atoms/spinner/spinner.tsx +49 -0
  195. package/src/atoms/switch/switch.tsx +3 -1
  196. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  197. package/src/calendar/date-calendar/index.ts +5 -0
  198. package/src/calendar/index.ts +1 -0
  199. package/src/calendar/internal/date-utils.ts +115 -0
  200. package/src/containers/aside/aside.tsx +40 -0
  201. package/src/containers/aside/index.ts +1 -0
  202. package/src/containers/banner/banner.tsx +18 -1
  203. package/src/containers/description-list/description-list.tsx +85 -9
  204. package/src/containers/feed/feed.tsx +99 -0
  205. package/src/containers/feed/index.ts +8 -0
  206. package/src/containers/feed/model.ts +54 -0
  207. package/src/containers/index.ts +6 -0
  208. package/src/containers/kpi/kpi.tsx +161 -62
  209. package/src/containers/list-detail/index.ts +15 -0
  210. package/src/containers/list-detail/list-detail.tsx +293 -0
  211. package/src/containers/note/index.ts +1 -0
  212. package/src/containers/note/note.tsx +38 -0
  213. package/src/containers/section/index.ts +11 -0
  214. package/src/containers/section/section.tsx +281 -0
  215. package/src/containers/shortcuts/index.ts +6 -0
  216. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  217. package/src/containers/table/selection.ts +26 -0
  218. package/src/containers/table/table.tsx +215 -13
  219. package/src/containers/timeline/index.ts +3 -0
  220. package/src/containers/timeline/timeline.tsx +204 -93
  221. package/src/forms/chip-group/chip-group.tsx +184 -0
  222. package/src/forms/chip-group/index.ts +8 -0
  223. package/src/forms/combobox/combobox.tsx +359 -0
  224. package/src/forms/combobox/index.ts +7 -0
  225. package/src/forms/date-picker/date-picker.tsx +239 -0
  226. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  227. package/src/forms/date-picker/index.ts +10 -0
  228. package/src/forms/date-picker/model.ts +108 -0
  229. package/src/forms/dropzone/dropzone.tsx +217 -35
  230. package/src/forms/field/field.tsx +72 -7
  231. package/src/forms/index.ts +4 -0
  232. package/src/forms/input/index.ts +8 -1
  233. package/src/forms/input/input.tsx +97 -12
  234. package/src/forms/input-icon/input-icon.tsx +1 -1
  235. package/src/forms/internal/listbox-items.tsx +103 -0
  236. package/src/forms/internal/listbox.ts +124 -0
  237. package/src/forms/number-stepper/model.ts +35 -0
  238. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  239. package/src/forms/select-menu/index.ts +7 -0
  240. package/src/forms/select-menu/select-menu.tsx +280 -0
  241. package/src/i18n/strings.ts +89 -0
  242. package/src/i18n/ui-strings-provider.tsx +15 -4
  243. package/src/navigation/index.ts +1 -0
  244. package/src/navigation/stepper/index.ts +7 -1
  245. package/src/navigation/stepper/stepper.tsx +41 -5
  246. package/src/navigation/tabs/index.ts +7 -0
  247. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  248. package/src/navigation/wizard/index.ts +7 -0
  249. package/src/navigation/wizard/model.ts +61 -0
  250. package/src/navigation/wizard/wizard.tsx +222 -0
  251. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  252. package/src/overlays/alert-dialog/index.ts +19 -0
  253. package/src/overlays/dropdown-menu/dropdown-menu.tsx +29 -4
  254. package/src/overlays/dropdown-menu/index.ts +3 -0
  255. package/src/overlays/index.ts +2 -0
  256. package/src/overlays/testing/index.ts +5 -0
  257. package/src/overlays/toaster/index.ts +2 -0
  258. package/src/overlays/toaster/toast-store.ts +6 -2
  259. package/src/overlays/toaster/toast.ts +6 -0
  260. package/src/overlays/toaster/toaster.tsx +44 -2
  261. package/src/overlays/tooltip/index.ts +1 -0
  262. package/src/overlays/tooltip/model.ts +18 -0
  263. package/src/overlays/tooltip/tooltip.tsx +166 -0
  264. package/src/primitives/use-dismissable-layer.ts +7 -2
  265. package/src/states/error-state/error-state.tsx +19 -8
  266. package/src/states/skeleton/skeleton.tsx +68 -2
  267. package/styles/tailwind.css +33 -30
  268. package/styles/theme.css +33 -30
@@ -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
+ }