@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.
- package/CHANGELOG.md +103 -1
- package/README.md +55 -2
- package/bin/ui-theme.mjs +13 -2
- package/dist/atoms/checkbox/checkbox.js +3 -1
- package/dist/atoms/chip/chip.d.ts +11 -3
- package/dist/atoms/chip/chip.js +8 -1
- package/dist/atoms/chip/index.d.ts +1 -1
- package/dist/atoms/chip/index.js +2 -0
- package/dist/atoms/due-chip/due-chip.d.ts +31 -0
- package/dist/atoms/due-chip/due-chip.js +41 -0
- package/dist/atoms/due-chip/index.d.ts +2 -0
- package/dist/atoms/due-chip/index.js +6 -0
- package/dist/atoms/due-chip/model.d.ts +25 -0
- package/dist/atoms/due-chip/model.js +44 -0
- package/dist/atoms/icon-button/icon-button.d.ts +22 -0
- package/dist/atoms/icon-button/icon-button.js +38 -0
- package/dist/atoms/icon-button/index.d.ts +1 -0
- package/dist/atoms/icon-button/index.js +8 -0
- package/dist/atoms/index.d.ts +5 -0
- package/dist/atoms/index.js +5 -0
- package/dist/atoms/internal/hit-area.d.ts +6 -0
- package/dist/atoms/internal/hit-area.js +4 -0
- package/dist/atoms/kbd/index.d.ts +1 -0
- package/dist/atoms/kbd/index.js +4 -0
- package/dist/atoms/kbd/kbd.d.ts +7 -0
- package/dist/atoms/kbd/kbd.js +17 -0
- package/dist/atoms/radio-group/radio-group.js +6 -2
- package/dist/atoms/seal/index.d.ts +1 -0
- package/dist/atoms/seal/index.js +4 -0
- package/dist/atoms/seal/seal.d.ts +30 -0
- package/dist/atoms/seal/seal.js +71 -0
- package/dist/atoms/spinner/index.d.ts +1 -0
- package/dist/atoms/spinner/index.js +5 -0
- package/dist/atoms/spinner/spinner.d.ts +19 -0
- package/dist/atoms/spinner/spinner.js +31 -0
- package/dist/atoms/switch/switch.js +3 -1
- package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
- package/dist/calendar/date-calendar/date-calendar.js +189 -0
- package/dist/calendar/date-calendar/index.d.ts +1 -0
- package/dist/calendar/date-calendar/index.js +6 -0
- package/dist/calendar/index.d.ts +1 -0
- package/dist/calendar/index.js +1 -0
- package/dist/calendar/internal/date-utils.d.ts +26 -0
- package/dist/calendar/internal/date-utils.js +95 -1
- package/dist/containers/aside/aside.d.ts +14 -0
- package/dist/containers/aside/aside.js +25 -0
- package/dist/containers/aside/index.d.ts +1 -0
- package/dist/containers/aside/index.js +5 -0
- package/dist/containers/banner/banner.d.ts +4 -1
- package/dist/containers/banner/banner.js +9 -1
- package/dist/containers/description-list/description-list.d.ts +29 -6
- package/dist/containers/description-list/description-list.js +47 -6
- package/dist/containers/feed/feed.d.ts +23 -0
- package/dist/containers/feed/feed.js +77 -0
- package/dist/containers/feed/index.d.ts +2 -0
- package/dist/containers/feed/index.js +10 -0
- package/dist/containers/feed/model.d.ts +19 -0
- package/dist/containers/feed/model.js +38 -0
- package/dist/containers/index.d.ts +6 -0
- package/dist/containers/index.js +6 -0
- package/dist/containers/kpi/kpi.d.ts +50 -8
- package/dist/containers/kpi/kpi.js +91 -39
- package/dist/containers/list-detail/index.d.ts +1 -0
- package/dist/containers/list-detail/index.js +20 -0
- package/dist/containers/list-detail/list-detail.d.ts +55 -0
- package/dist/containers/list-detail/list-detail.js +221 -0
- package/dist/containers/note/index.d.ts +1 -0
- package/dist/containers/note/index.js +4 -0
- package/dist/containers/note/note.d.ts +13 -0
- package/dist/containers/note/note.js +27 -0
- package/dist/containers/section/index.d.ts +1 -0
- package/dist/containers/section/index.js +6 -0
- package/dist/containers/section/section.d.ts +68 -0
- package/dist/containers/section/section.js +198 -0
- package/dist/containers/shortcuts/index.d.ts +1 -0
- package/dist/containers/shortcuts/index.js +8 -0
- package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
- package/dist/containers/shortcuts/shortcuts.js +50 -0
- package/dist/containers/table/selection.d.ts +9 -0
- package/dist/containers/table/selection.js +20 -0
- package/dist/containers/table/table.d.ts +66 -4
- package/dist/containers/table/table.js +128 -7
- package/dist/containers/timeline/index.d.ts +1 -1
- package/dist/containers/timeline/index.js +4 -2
- package/dist/containers/timeline/timeline.d.ts +32 -5
- package/dist/containers/timeline/timeline.js +154 -90
- package/dist/forms/chip-group/chip-group.d.ts +54 -0
- package/dist/forms/chip-group/chip-group.js +114 -0
- package/dist/forms/chip-group/index.d.ts +1 -0
- package/dist/forms/chip-group/index.js +6 -0
- package/dist/forms/combobox/combobox.d.ts +60 -0
- package/dist/forms/combobox/combobox.js +281 -0
- package/dist/forms/combobox/index.d.ts +1 -0
- package/dist/forms/combobox/index.js +6 -0
- package/dist/forms/date-picker/date-picker.d.ts +40 -0
- package/dist/forms/date-picker/date-picker.js +183 -0
- package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
- package/dist/forms/date-picker/date-time-picker.js +121 -0
- package/dist/forms/date-picker/index.d.ts +2 -0
- package/dist/forms/date-picker/index.js +10 -0
- package/dist/forms/date-picker/model.d.ts +35 -0
- package/dist/forms/date-picker/model.js +83 -0
- package/dist/forms/dropzone/dropzone.d.ts +30 -2
- package/dist/forms/dropzone/dropzone.js +153 -23
- package/dist/forms/field/field.d.ts +16 -10
- package/dist/forms/field/field.js +41 -5
- package/dist/forms/index.d.ts +4 -0
- package/dist/forms/index.js +4 -0
- package/dist/forms/input/index.d.ts +1 -1
- package/dist/forms/input/index.js +4 -1
- package/dist/forms/input/input.d.ts +21 -5
- package/dist/forms/input/input.js +74 -9
- package/dist/forms/input-icon/input-icon.d.ts +1 -1
- package/dist/forms/internal/listbox-items.d.ts +18 -0
- package/dist/forms/internal/listbox-items.js +88 -0
- package/dist/forms/internal/listbox.d.ts +44 -0
- package/dist/forms/internal/listbox.js +74 -0
- package/dist/forms/number-stepper/model.d.ts +16 -0
- package/dist/forms/number-stepper/model.js +23 -0
- package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
- package/dist/forms/number-stepper/number-stepper.js +86 -37
- package/dist/forms/select-menu/index.d.ts +1 -0
- package/dist/forms/select-menu/index.js +6 -0
- package/dist/forms/select-menu/select-menu.d.ts +35 -0
- package/dist/forms/select-menu/select-menu.js +230 -0
- package/dist/i18n/strings.d.ts +89 -0
- package/dist/i18n/strings.js +54 -2
- package/dist/i18n/ui-strings-provider.d.ts +1 -1
- package/dist/i18n/ui-strings-provider.js +6 -2
- package/dist/navigation/index.d.ts +1 -0
- package/dist/navigation/index.js +1 -0
- package/dist/navigation/stepper/index.d.ts +1 -1
- package/dist/navigation/stepper/index.js +3 -1
- package/dist/navigation/stepper/stepper.d.ts +8 -0
- package/dist/navigation/stepper/stepper.js +68 -45
- package/dist/navigation/tabs/index.d.ts +1 -0
- package/dist/navigation/tabs/index.js +6 -0
- package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
- package/dist/navigation/tabs/tabs-nav.js +57 -0
- package/dist/navigation/wizard/index.d.ts +1 -0
- package/dist/navigation/wizard/index.js +6 -0
- package/dist/navigation/wizard/model.d.ts +33 -0
- package/dist/navigation/wizard/model.js +34 -0
- package/dist/navigation/wizard/wizard.d.ts +45 -0
- package/dist/navigation/wizard/wizard.js +169 -0
- package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
- package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
- package/dist/overlays/alert-dialog/index.d.ts +1 -0
- package/dist/overlays/alert-dialog/index.js +26 -0
- package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +17 -1
- package/dist/overlays/dropdown-menu/dropdown-menu.js +12 -4
- package/dist/overlays/dropdown-menu/index.d.ts +1 -1
- package/dist/overlays/dropdown-menu/index.js +8 -2
- package/dist/overlays/index.d.ts +2 -0
- package/dist/overlays/index.js +2 -0
- package/dist/overlays/testing/index.d.ts +5 -0
- package/dist/overlays/testing/index.js +4 -0
- package/dist/overlays/toaster/index.d.ts +2 -1
- package/dist/overlays/toaster/index.js +4 -2
- package/dist/overlays/toaster/toast-store.d.ts +6 -2
- package/dist/overlays/toaster/toast.d.ts +3 -0
- package/dist/overlays/toaster/toast.js +3 -0
- package/dist/overlays/toaster/toaster.d.ts +3 -0
- package/dist/overlays/toaster/toaster.js +36 -3
- package/dist/overlays/tooltip/index.d.ts +1 -0
- package/dist/overlays/tooltip/index.js +4 -0
- package/dist/overlays/tooltip/model.d.ts +10 -0
- package/dist/overlays/tooltip/model.js +13 -0
- package/dist/overlays/tooltip/tooltip.d.ts +41 -0
- package/dist/overlays/tooltip/tooltip.js +116 -0
- package/dist/primitives/use-dismissable-layer.js +1 -1
- package/dist/states/error-state/error-state.d.ts +6 -1
- package/dist/states/error-state/error-state.js +13 -9
- package/dist/states/skeleton/skeleton.d.ts +8 -2
- package/dist/states/skeleton/skeleton.js +44 -2
- package/package.json +2 -2
- package/scripts/build-theme.mjs +12 -1
- package/src/atoms/checkbox/checkbox.tsx +3 -1
- package/src/atoms/chip/chip.tsx +18 -3
- package/src/atoms/chip/index.ts +2 -0
- package/src/atoms/due-chip/due-chip.tsx +75 -0
- package/src/atoms/due-chip/index.ts +2 -0
- package/src/atoms/due-chip/model.ts +67 -0
- package/src/atoms/icon-button/icon-button.tsx +58 -0
- package/src/atoms/icon-button/index.ts +6 -0
- package/src/atoms/index.ts +5 -0
- package/src/atoms/internal/hit-area.ts +7 -0
- package/src/atoms/kbd/index.ts +1 -0
- package/src/atoms/kbd/kbd.tsx +20 -0
- package/src/atoms/radio-group/radio-group.tsx +8 -2
- package/src/atoms/seal/index.ts +1 -0
- package/src/atoms/seal/seal.tsx +107 -0
- package/src/atoms/spinner/index.ts +1 -0
- package/src/atoms/spinner/spinner.tsx +49 -0
- package/src/atoms/switch/switch.tsx +3 -1
- package/src/calendar/date-calendar/date-calendar.tsx +230 -0
- package/src/calendar/date-calendar/index.ts +5 -0
- package/src/calendar/index.ts +1 -0
- package/src/calendar/internal/date-utils.ts +115 -0
- package/src/containers/aside/aside.tsx +40 -0
- package/src/containers/aside/index.ts +1 -0
- package/src/containers/banner/banner.tsx +18 -1
- package/src/containers/description-list/description-list.tsx +85 -9
- package/src/containers/feed/feed.tsx +99 -0
- package/src/containers/feed/index.ts +8 -0
- package/src/containers/feed/model.ts +54 -0
- package/src/containers/index.ts +6 -0
- package/src/containers/kpi/kpi.tsx +161 -62
- package/src/containers/list-detail/index.ts +15 -0
- package/src/containers/list-detail/list-detail.tsx +293 -0
- package/src/containers/note/index.ts +1 -0
- package/src/containers/note/note.tsx +38 -0
- package/src/containers/section/index.ts +11 -0
- package/src/containers/section/section.tsx +281 -0
- package/src/containers/shortcuts/index.ts +6 -0
- package/src/containers/shortcuts/shortcuts.tsx +92 -0
- package/src/containers/table/selection.ts +26 -0
- package/src/containers/table/table.tsx +215 -13
- package/src/containers/timeline/index.ts +3 -0
- package/src/containers/timeline/timeline.tsx +204 -93
- package/src/forms/chip-group/chip-group.tsx +184 -0
- package/src/forms/chip-group/index.ts +8 -0
- package/src/forms/combobox/combobox.tsx +359 -0
- package/src/forms/combobox/index.ts +7 -0
- package/src/forms/date-picker/date-picker.tsx +239 -0
- package/src/forms/date-picker/date-time-picker.tsx +178 -0
- package/src/forms/date-picker/index.ts +10 -0
- package/src/forms/date-picker/model.ts +108 -0
- package/src/forms/dropzone/dropzone.tsx +217 -35
- package/src/forms/field/field.tsx +72 -7
- package/src/forms/index.ts +4 -0
- package/src/forms/input/index.ts +8 -1
- package/src/forms/input/input.tsx +97 -12
- package/src/forms/input-icon/input-icon.tsx +1 -1
- package/src/forms/internal/listbox-items.tsx +103 -0
- package/src/forms/internal/listbox.ts +124 -0
- package/src/forms/number-stepper/model.ts +35 -0
- package/src/forms/number-stepper/number-stepper.tsx +132 -42
- package/src/forms/select-menu/index.ts +7 -0
- package/src/forms/select-menu/select-menu.tsx +280 -0
- package/src/i18n/strings.ts +89 -0
- package/src/i18n/ui-strings-provider.tsx +15 -4
- package/src/navigation/index.ts +1 -0
- package/src/navigation/stepper/index.ts +7 -1
- package/src/navigation/stepper/stepper.tsx +41 -5
- package/src/navigation/tabs/index.ts +7 -0
- package/src/navigation/tabs/tabs-nav.tsx +131 -0
- package/src/navigation/wizard/index.ts +7 -0
- package/src/navigation/wizard/model.ts +61 -0
- package/src/navigation/wizard/wizard.tsx +222 -0
- package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
- package/src/overlays/alert-dialog/index.ts +19 -0
- package/src/overlays/dropdown-menu/dropdown-menu.tsx +29 -4
- package/src/overlays/dropdown-menu/index.ts +3 -0
- package/src/overlays/index.ts +2 -0
- package/src/overlays/testing/index.ts +5 -0
- package/src/overlays/toaster/index.ts +2 -0
- package/src/overlays/toaster/toast-store.ts +6 -2
- package/src/overlays/toaster/toast.ts +6 -0
- package/src/overlays/toaster/toaster.tsx +44 -2
- package/src/overlays/tooltip/index.ts +1 -0
- package/src/overlays/tooltip/model.ts +18 -0
- package/src/overlays/tooltip/tooltip.tsx +166 -0
- package/src/primitives/use-dismissable-layer.ts +7 -2
- package/src/states/error-state/error-state.tsx +19 -8
- package/src/states/skeleton/skeleton.tsx +68 -2
- package/styles/tailwind.css +33 -30
- 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
|
+
}
|