@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,37 @@
|
|
|
1
|
+
import { type AnchorHTMLAttributes, type ComponentPropsWithoutRef, type ReactNode, type Ref } from "react";
|
|
2
|
+
/** Props handed to `renderLink`: spread them on your router's link component. */
|
|
3
|
+
export interface TabsNavLinkRenderProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
|
|
4
|
+
ref?: Ref<HTMLAnchorElement>;
|
|
5
|
+
"aria-current"?: "page" | undefined;
|
|
6
|
+
"data-active"?: "" | undefined;
|
|
7
|
+
}
|
|
8
|
+
export interface TabsNavProps extends ComponentPropsWithoutRef<"nav"> {
|
|
9
|
+
/** Name of the strip (required: a page can have several navigations). */
|
|
10
|
+
"aria-label": string;
|
|
11
|
+
/** Value of the item that is the current page. */
|
|
12
|
+
value?: string | undefined;
|
|
13
|
+
/**
|
|
14
|
+
* Renders every link with your router's component instead of an `<a>`:
|
|
15
|
+
* `renderLink={(props) => <Link to={...} {...props} />}`. An item's own `asChild` wins.
|
|
16
|
+
*/
|
|
17
|
+
renderLink?: ((props: TabsNavLinkRenderProps) => ReactNode) | undefined;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Tab-looking sub-navigation made of links. Unlike `Tabs` it has no panels and no tab roles:
|
|
21
|
+
* each item is a real link, the current one carries `aria-current="page"`, and the router is
|
|
22
|
+
* yours (`href`, `renderLink` or `asChild`). The strip is flush to its container's inline edges
|
|
23
|
+
* and scrolls sideways when the items do not fit.
|
|
24
|
+
*/
|
|
25
|
+
export declare function TabsNav({ value, renderLink, className, children, ...props }: TabsNavProps): import("react").JSX.Element;
|
|
26
|
+
export interface TabsNavLinkProps extends Omit<ComponentPropsWithoutRef<"a">, "children"> {
|
|
27
|
+
/** Matches the strip's `value` to mark this item as the current page. */
|
|
28
|
+
value: string;
|
|
29
|
+
/** Overrides the match for routers that report the active state themselves. */
|
|
30
|
+
active?: boolean | undefined;
|
|
31
|
+
/** Optional record count shown after the label. */
|
|
32
|
+
count?: number | undefined;
|
|
33
|
+
/** Renders the single child element (a router `Link`) with the item's look and a11y props. */
|
|
34
|
+
asChild?: boolean | undefined;
|
|
35
|
+
children: ReactNode;
|
|
36
|
+
}
|
|
37
|
+
export declare function TabsNavLink({ value, active, count, asChild, className, children, ...props }: TabsNavLinkProps): import("react").JSX.Element;
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { Fragment, jsx, jsxs } from "react/jsx-runtime";
|
|
3
|
+
import {
|
|
4
|
+
cloneElement,
|
|
5
|
+
createContext,
|
|
6
|
+
isValidElement,
|
|
7
|
+
useContext
|
|
8
|
+
} from "react";
|
|
9
|
+
import { cn } from "../../utils/cn.js";
|
|
10
|
+
import { Slot } from "../../utils/slot.js";
|
|
11
|
+
const TabsNavContext = createContext({
|
|
12
|
+
value: void 0,
|
|
13
|
+
renderLink: void 0
|
|
14
|
+
});
|
|
15
|
+
function TabsNav({ value, renderLink, className, children, ...props }) {
|
|
16
|
+
return /* @__PURE__ */ jsx(TabsNavContext.Provider, { value: { value, renderLink }, children: /* @__PURE__ */ jsx("nav", { ...props, className: cn("@container/tabs-nav min-w-0", className), children: /* @__PURE__ */ jsx("ul", { className: "m-0 flex list-none gap-0.5 overflow-x-auto overscroll-x-contain border-b-divider p-0", children }) }) });
|
|
17
|
+
}
|
|
18
|
+
const itemClasses = "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";
|
|
19
|
+
function TabsNavLink({
|
|
20
|
+
value,
|
|
21
|
+
active,
|
|
22
|
+
count,
|
|
23
|
+
asChild = false,
|
|
24
|
+
className,
|
|
25
|
+
children,
|
|
26
|
+
...props
|
|
27
|
+
}) {
|
|
28
|
+
const context = useContext(TabsNavContext);
|
|
29
|
+
const isActive = active ?? (context.value !== void 0 && context.value === value);
|
|
30
|
+
const shared = {
|
|
31
|
+
...props,
|
|
32
|
+
"aria-current": isActive ? "page" : void 0,
|
|
33
|
+
"data-active": isActive ? "" : void 0,
|
|
34
|
+
className: cn(itemClasses, className)
|
|
35
|
+
};
|
|
36
|
+
const countNode = count !== void 0 ? /* @__PURE__ */ jsx("span", { className: "text-count text-ink-3", children: count }) : null;
|
|
37
|
+
if (asChild && isValidElement(children)) {
|
|
38
|
+
const child = children;
|
|
39
|
+
return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(Slot, { ...shared, children: cloneElement(
|
|
40
|
+
child,
|
|
41
|
+
void 0,
|
|
42
|
+
/* @__PURE__ */ jsxs(Fragment, { children: [
|
|
43
|
+
child.props.children,
|
|
44
|
+
countNode
|
|
45
|
+
] })
|
|
46
|
+
) }) });
|
|
47
|
+
}
|
|
48
|
+
const content = /* @__PURE__ */ jsxs(Fragment, { children: [
|
|
49
|
+
children,
|
|
50
|
+
countNode
|
|
51
|
+
] });
|
|
52
|
+
return /* @__PURE__ */ jsx("li", { children: context.renderLink ? context.renderLink({ ...shared, children: content }) : /* @__PURE__ */ jsx("a", { ...shared, children: content }) });
|
|
53
|
+
}
|
|
54
|
+
export {
|
|
55
|
+
TabsNav,
|
|
56
|
+
TabsNavLink
|
|
57
|
+
};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { Wizard, type WizardGate, type WizardPart, type WizardProps, type WizardStep, } from "./wizard.js";
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/** A step gate: a plain flag, or a check that may be asynchronous. */
|
|
2
|
+
export type WizardGate = boolean | (() => boolean | Promise<boolean>);
|
|
3
|
+
export interface GateResult {
|
|
4
|
+
/** True when every gate allowed the move. */
|
|
5
|
+
ok: boolean;
|
|
6
|
+
/** True when a gate threw or rejected (the move is blocked either way). */
|
|
7
|
+
failed: boolean;
|
|
8
|
+
}
|
|
9
|
+
/** Runs the gates in order and stops at the first one that blocks; a throwing gate blocks. */
|
|
10
|
+
export declare function evaluateGates(gates: ReadonlyArray<WizardGate | undefined>): Promise<GateResult>;
|
|
11
|
+
export declare function clampIndex(index: number, length: number): number;
|
|
12
|
+
/** Fills the `{current}`, `{total}` and `{label}` placeholders of the `stepOf` UI string. */
|
|
13
|
+
export declare function formatStepOf(template: string, values: {
|
|
14
|
+
current: number;
|
|
15
|
+
total: number;
|
|
16
|
+
label: string;
|
|
17
|
+
}): string;
|
|
18
|
+
/** Enter inside a single-line text-like input advances the wizard, like submitting a form. */
|
|
19
|
+
export declare function isAdvanceKey(event: {
|
|
20
|
+
key: string;
|
|
21
|
+
defaultPrevented: boolean;
|
|
22
|
+
shiftKey: boolean;
|
|
23
|
+
altKey: boolean;
|
|
24
|
+
ctrlKey: boolean;
|
|
25
|
+
metaKey: boolean;
|
|
26
|
+
nativeEvent?: {
|
|
27
|
+
isComposing?: boolean;
|
|
28
|
+
};
|
|
29
|
+
target: EventTarget | {
|
|
30
|
+
tagName?: string;
|
|
31
|
+
type?: string;
|
|
32
|
+
};
|
|
33
|
+
}): boolean;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
async function evaluateGates(gates) {
|
|
2
|
+
for (const gate of gates) {
|
|
3
|
+
if (gate === void 0) continue;
|
|
4
|
+
try {
|
|
5
|
+
const allowed = typeof gate === "function" ? await gate() : gate;
|
|
6
|
+
if (allowed === false) return { ok: false, failed: false };
|
|
7
|
+
} catch {
|
|
8
|
+
return { ok: false, failed: true };
|
|
9
|
+
}
|
|
10
|
+
}
|
|
11
|
+
return { ok: true, failed: false };
|
|
12
|
+
}
|
|
13
|
+
function clampIndex(index, length) {
|
|
14
|
+
if (length <= 0) return 0;
|
|
15
|
+
return Math.min(Math.max(Math.trunc(index) || 0, 0), length - 1);
|
|
16
|
+
}
|
|
17
|
+
function formatStepOf(template, values) {
|
|
18
|
+
return template.replace("{current}", String(values.current)).replace("{total}", String(values.total)).replace("{label}", values.label);
|
|
19
|
+
}
|
|
20
|
+
function isAdvanceKey(event) {
|
|
21
|
+
if (event.key !== "Enter" || event.defaultPrevented) return false;
|
|
22
|
+
if (event.shiftKey || event.altKey || event.ctrlKey || event.metaKey) return false;
|
|
23
|
+
if (event.nativeEvent?.isComposing) return false;
|
|
24
|
+
const target = event.target;
|
|
25
|
+
if (target.tagName !== "INPUT") return false;
|
|
26
|
+
const type = target.type ?? "text";
|
|
27
|
+
return !["checkbox", "radio", "button", "submit", "reset", "file", "image"].includes(type);
|
|
28
|
+
}
|
|
29
|
+
export {
|
|
30
|
+
clampIndex,
|
|
31
|
+
evaluateGates,
|
|
32
|
+
formatStepOf,
|
|
33
|
+
isAdvanceKey
|
|
34
|
+
};
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { type ComponentPropsWithoutRef, type ReactNode } from "react";
|
|
2
|
+
import type { ClassNames } from "../../utils/class-names.js";
|
|
3
|
+
import { type WizardGate } from "./model.js";
|
|
4
|
+
export type { WizardGate } from "./model.js";
|
|
5
|
+
export interface WizardStep {
|
|
6
|
+
id: string;
|
|
7
|
+
label: string;
|
|
8
|
+
content: ReactNode;
|
|
9
|
+
/**
|
|
10
|
+
* Blocks "Next" for this step: `false` disables the button, a function runs when Next is
|
|
11
|
+
* pressed (it may be async; `false` or a throw keeps the step).
|
|
12
|
+
*/
|
|
13
|
+
canAdvance?: WizardGate;
|
|
14
|
+
}
|
|
15
|
+
export type WizardPart = "root" | "stepper" | "heading" | "content" | "error" | "footer" | "back" | "next";
|
|
16
|
+
export interface WizardProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "defaultValue" | "onChange"> {
|
|
17
|
+
steps: readonly WizardStep[];
|
|
18
|
+
/** Controlled current step id. */
|
|
19
|
+
value?: string | undefined;
|
|
20
|
+
/** Initial step id when uncontrolled (defaults to the first step). */
|
|
21
|
+
defaultValue?: string | undefined;
|
|
22
|
+
onValueChange?: ((stepId: string) => void) | undefined;
|
|
23
|
+
/**
|
|
24
|
+
* Runs before moving forward from a step, after that step's `canAdvance`. Return `false` (or
|
|
25
|
+
* a promise of `false`) to stay. While it is pending the buttons show a busy state and a
|
|
26
|
+
* second press is ignored.
|
|
27
|
+
*/
|
|
28
|
+
onBeforeNext?: ((step: WizardStep, index: number) => boolean | Promise<boolean>) | undefined;
|
|
29
|
+
/** Called by the last step's finish button; may return a promise (pending state, no double run). */
|
|
30
|
+
onComplete?: (() => void | Promise<void>) | undefined;
|
|
31
|
+
/** Overrides the localized labels. */
|
|
32
|
+
backLabel?: string | undefined;
|
|
33
|
+
nextLabel?: string | undefined;
|
|
34
|
+
finishLabel?: string | undefined;
|
|
35
|
+
/** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root. */
|
|
36
|
+
classNames?: ClassNames<WizardPart>;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Multi-step flow on top of `Stepper`: the current step's content, then Back / Next / Finish.
|
|
40
|
+
* Moving forward runs the step's `canAdvance` and `onBeforeNext`; the step heading takes focus
|
|
41
|
+
* on every change so keyboard and screen-reader users land on the new step. Enter inside a
|
|
42
|
+
* single-line input advances. Under 420px of its own width the step title becomes visible and
|
|
43
|
+
* the buttons stack.
|
|
44
|
+
*/
|
|
45
|
+
export declare function Wizard({ steps, value: valueProp, defaultValue, onValueChange, onBeforeNext, onComplete, backLabel, nextLabel, finishLabel, className, classNames, ...props }: WizardProps): import("react").JSX.Element | null;
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx, jsxs } from "react/jsx-runtime";
|
|
3
|
+
import {
|
|
4
|
+
useEffect,
|
|
5
|
+
useRef,
|
|
6
|
+
useState
|
|
7
|
+
} from "react";
|
|
8
|
+
import { Button } from "../../atoms/button/button.js";
|
|
9
|
+
import { useUiStrings } from "../../i18n/index.js";
|
|
10
|
+
import { cn } from "../../utils/cn.js";
|
|
11
|
+
import { useControllableState } from "../../utils/use-controllable-state.js";
|
|
12
|
+
import { Stepper } from "../stepper/stepper.js";
|
|
13
|
+
import { clampIndex, evaluateGates, formatStepOf, isAdvanceKey } from "./model.js";
|
|
14
|
+
function Wizard({
|
|
15
|
+
steps,
|
|
16
|
+
value: valueProp,
|
|
17
|
+
defaultValue,
|
|
18
|
+
onValueChange,
|
|
19
|
+
onBeforeNext,
|
|
20
|
+
onComplete,
|
|
21
|
+
backLabel,
|
|
22
|
+
nextLabel,
|
|
23
|
+
finishLabel,
|
|
24
|
+
className,
|
|
25
|
+
classNames,
|
|
26
|
+
...props
|
|
27
|
+
}) {
|
|
28
|
+
const strings = useUiStrings();
|
|
29
|
+
const [stepId, setStepId] = useControllableState({
|
|
30
|
+
prop: valueProp,
|
|
31
|
+
defaultProp: defaultValue ?? steps[0]?.id ?? "",
|
|
32
|
+
onChange: onValueChange
|
|
33
|
+
});
|
|
34
|
+
const found = steps.findIndex((step) => step.id === stepId);
|
|
35
|
+
const index = clampIndex(found, steps.length);
|
|
36
|
+
const current = steps[index];
|
|
37
|
+
const isLast = index === steps.length - 1;
|
|
38
|
+
const [pending, setPending] = useState(null);
|
|
39
|
+
const [failed, setFailed] = useState(false);
|
|
40
|
+
const busy = useRef(false);
|
|
41
|
+
const headingRef = useRef(null);
|
|
42
|
+
const shownIndex = useRef(index);
|
|
43
|
+
useEffect(() => {
|
|
44
|
+
if (shownIndex.current === index) return;
|
|
45
|
+
shownIndex.current = index;
|
|
46
|
+
headingRef.current?.focus();
|
|
47
|
+
});
|
|
48
|
+
if (!current) return null;
|
|
49
|
+
const guarded = async (kind, run) => {
|
|
50
|
+
if (busy.current) return;
|
|
51
|
+
busy.current = true;
|
|
52
|
+
setPending(kind);
|
|
53
|
+
setFailed(false);
|
|
54
|
+
try {
|
|
55
|
+
await run();
|
|
56
|
+
} finally {
|
|
57
|
+
busy.current = false;
|
|
58
|
+
setPending(null);
|
|
59
|
+
}
|
|
60
|
+
};
|
|
61
|
+
const goTo = (target) => {
|
|
62
|
+
const next = steps[clampIndex(target, steps.length)];
|
|
63
|
+
if (next) setStepId(next.id);
|
|
64
|
+
};
|
|
65
|
+
const advance = () => guarded(isLast ? "finish" : "next", async () => {
|
|
66
|
+
const gates = await evaluateGates([
|
|
67
|
+
current.canAdvance,
|
|
68
|
+
onBeforeNext ? () => onBeforeNext(current, index) : void 0
|
|
69
|
+
]);
|
|
70
|
+
if (gates.failed) setFailed(true);
|
|
71
|
+
if (!gates.ok) return;
|
|
72
|
+
if (isLast) {
|
|
73
|
+
try {
|
|
74
|
+
await onComplete?.();
|
|
75
|
+
} catch {
|
|
76
|
+
setFailed(true);
|
|
77
|
+
}
|
|
78
|
+
return;
|
|
79
|
+
}
|
|
80
|
+
goTo(index + 1);
|
|
81
|
+
});
|
|
82
|
+
const blocked = current.canAdvance === false;
|
|
83
|
+
const label = formatStepOf(strings.stepOf, {
|
|
84
|
+
current: index + 1,
|
|
85
|
+
total: steps.length,
|
|
86
|
+
label: current.label
|
|
87
|
+
});
|
|
88
|
+
return /* @__PURE__ */ jsxs(
|
|
89
|
+
"div",
|
|
90
|
+
{
|
|
91
|
+
...props,
|
|
92
|
+
"data-pending": pending ?? void 0,
|
|
93
|
+
className: cn("@container/wizard flex min-w-0 flex-col gap-3", classNames?.root, className),
|
|
94
|
+
children: [
|
|
95
|
+
/* @__PURE__ */ jsx(
|
|
96
|
+
Stepper,
|
|
97
|
+
{
|
|
98
|
+
"aria-label": strings.steps,
|
|
99
|
+
steps: steps.map(({ id, label: stepLabel }) => ({ id, label: stepLabel })),
|
|
100
|
+
currentStepId: current.id,
|
|
101
|
+
className: classNames?.stepper
|
|
102
|
+
}
|
|
103
|
+
),
|
|
104
|
+
/* @__PURE__ */ jsx(
|
|
105
|
+
"h2",
|
|
106
|
+
{
|
|
107
|
+
ref: headingRef,
|
|
108
|
+
tabIndex: -1,
|
|
109
|
+
className: cn(
|
|
110
|
+
"m-0 text-body font-semibold text-ink outline-none @max-[420px]/wizard:not-sr-only sr-only",
|
|
111
|
+
classNames?.heading
|
|
112
|
+
),
|
|
113
|
+
children: label
|
|
114
|
+
}
|
|
115
|
+
),
|
|
116
|
+
/* @__PURE__ */ jsx(
|
|
117
|
+
"div",
|
|
118
|
+
{
|
|
119
|
+
className: cn("min-w-0", classNames?.content),
|
|
120
|
+
onKeyDown: (event) => {
|
|
121
|
+
if (isAdvanceKey(event)) {
|
|
122
|
+
event.preventDefault();
|
|
123
|
+
if (!blocked) void advance();
|
|
124
|
+
}
|
|
125
|
+
},
|
|
126
|
+
children: current.content
|
|
127
|
+
}
|
|
128
|
+
),
|
|
129
|
+
failed ? /* @__PURE__ */ jsx("p", { role: "alert", className: cn("m-0 text-danger text-meta", classNames?.error), children: strings.actionFailed }) : null,
|
|
130
|
+
/* @__PURE__ */ jsxs(
|
|
131
|
+
"div",
|
|
132
|
+
{
|
|
133
|
+
className: cn(
|
|
134
|
+
"flex items-center justify-between gap-2 @max-[420px]/wizard:flex-col-reverse @max-[420px]/wizard:items-stretch",
|
|
135
|
+
classNames?.footer
|
|
136
|
+
),
|
|
137
|
+
children: [
|
|
138
|
+
/* @__PURE__ */ jsx(
|
|
139
|
+
Button,
|
|
140
|
+
{
|
|
141
|
+
variant: "secondary",
|
|
142
|
+
disabled: index === 0 || pending !== null,
|
|
143
|
+
onClick: () => goTo(index - 1),
|
|
144
|
+
className: classNames?.back,
|
|
145
|
+
children: backLabel ?? strings.back
|
|
146
|
+
}
|
|
147
|
+
),
|
|
148
|
+
/* @__PURE__ */ jsx(
|
|
149
|
+
Button,
|
|
150
|
+
{
|
|
151
|
+
variant: "primary",
|
|
152
|
+
loading: pending !== null,
|
|
153
|
+
loadingLabel: strings.processing,
|
|
154
|
+
disabled: blocked,
|
|
155
|
+
onClick: () => void advance(),
|
|
156
|
+
className: classNames?.next,
|
|
157
|
+
children: isLast ? finishLabel ?? strings.finish : nextLabel ?? strings.next
|
|
158
|
+
}
|
|
159
|
+
)
|
|
160
|
+
]
|
|
161
|
+
}
|
|
162
|
+
)
|
|
163
|
+
]
|
|
164
|
+
}
|
|
165
|
+
);
|
|
166
|
+
}
|
|
167
|
+
export {
|
|
168
|
+
Wizard
|
|
169
|
+
};
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { type ComponentProps, type ReactElement, type ReactNode } from "react";
|
|
2
|
+
import { type ButtonProps } from "../../atoms/button/button.js";
|
|
3
|
+
import type { ConfirmResult } from "../../containers/confirm-action/model.js";
|
|
4
|
+
import * as DialogPrimitive from "../../primitives/dialog/dialog.js";
|
|
5
|
+
import type { ClassNames } from "../../utils/class-names.js";
|
|
6
|
+
import { type Material } from "../../utils/material.js";
|
|
7
|
+
export type AlertDialogTone = "default" | "danger";
|
|
8
|
+
export type AlertDialogPart = "overlay" | "root" | "header" | "title" | "description" | "body" | "error" | "footer" | "cancel" | "confirm";
|
|
9
|
+
export interface AlertDialogProps {
|
|
10
|
+
open?: boolean;
|
|
11
|
+
defaultOpen?: boolean;
|
|
12
|
+
onOpenChange?: (open: boolean) => void;
|
|
13
|
+
/** Element that opens the dialog. Omit it to drive the dialog with `open`. */
|
|
14
|
+
trigger?: ReactElement;
|
|
15
|
+
/** Disables the confirm button, e.g. until a reason is typed. A pending confirm disables it anyway. */
|
|
16
|
+
confirmDisabled?: boolean;
|
|
17
|
+
/** Disables the cancel button. Escape still cancels. A pending confirm disables it anyway. */
|
|
18
|
+
cancelDisabled?: boolean;
|
|
19
|
+
/** What is being asked, as a question or a verb phrase ("Delete this appointment?"). */
|
|
20
|
+
title: ReactNode;
|
|
21
|
+
/** The consequence, said plainly. Linked to the dialog with `aria-describedby`. */
|
|
22
|
+
description?: ReactNode;
|
|
23
|
+
/** Extra content between the description and the buttons. */
|
|
24
|
+
children?: ReactNode;
|
|
25
|
+
/** `danger` styles the confirm button as destructive. */
|
|
26
|
+
tone?: AlertDialogTone;
|
|
27
|
+
/** Defaults to the localized "Confirm". */
|
|
28
|
+
confirmLabel?: string;
|
|
29
|
+
/** Defaults to the localized "Cancel". */
|
|
30
|
+
cancelLabel?: string;
|
|
31
|
+
/**
|
|
32
|
+
* Runs on confirm. The dialog shows a pending state, ignores a second press and cannot be
|
|
33
|
+
* dismissed until it settles, then closes. Return `{ ok: false, error }` or throw to keep
|
|
34
|
+
* it open with a message.
|
|
35
|
+
*/
|
|
36
|
+
onConfirm: () => Promise<ConfirmResult> | Promise<void>;
|
|
37
|
+
/** Runs when the user cancels (Cancel button or Escape), not when a confirm succeeds. */
|
|
38
|
+
onCancel?: () => void;
|
|
39
|
+
/** Which button gets focus when the dialog opens. Cancel is the safe default. */
|
|
40
|
+
initialFocus?: "cancel" | "confirm";
|
|
41
|
+
/** Surface material; see `DialogContent`. */
|
|
42
|
+
material?: Material;
|
|
43
|
+
/** Portal target. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
|
|
44
|
+
container?: HTMLElement | null;
|
|
45
|
+
className?: string;
|
|
46
|
+
/** Per-part classes merged with `cn`; consumer classes win. `className` still targets the panel and is merged last. */
|
|
47
|
+
classNames?: ClassNames<AlertDialogPart>;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Modal that interrupts to ask for a decision before something consequential
|
|
51
|
+
* (WAI-ARIA `alertdialog`). Pass `title` and `onConfirm` for the props API, or compose
|
|
52
|
+
* `AlertDialog.Root` with `Trigger`, `Content`, `Title`, `Description`, `Cancel` and `Action`. There is no close button and a press outside does nothing:
|
|
53
|
+
* the user answers with Cancel, Escape or Confirm. While `onConfirm` is pending, every way
|
|
54
|
+
* out is disabled so the action runs exactly once.
|
|
55
|
+
*/
|
|
56
|
+
export declare function AlertDialog({ open: openProp, defaultOpen, onOpenChange, trigger, title, description, children, tone, confirmLabel, cancelLabel, confirmDisabled, cancelDisabled, onConfirm, onCancel, initialFocus, material, container, className, classNames, }: AlertDialogProps): import("react").JSX.Element;
|
|
57
|
+
export declare namespace AlertDialog {
|
|
58
|
+
var Root: typeof AlertDialogRoot;
|
|
59
|
+
var Trigger: typeof AlertDialogTrigger;
|
|
60
|
+
var Content: typeof AlertDialogContent;
|
|
61
|
+
var Header: typeof AlertDialogHeader;
|
|
62
|
+
var Title: typeof AlertDialogTitle;
|
|
63
|
+
var Description: typeof AlertDialogDescription;
|
|
64
|
+
var Body: typeof AlertDialogBody;
|
|
65
|
+
var Footer: typeof AlertDialogFooter;
|
|
66
|
+
var Cancel: typeof AlertDialogCancel;
|
|
67
|
+
var Action: typeof AlertDialogAction;
|
|
68
|
+
}
|
|
69
|
+
export interface AlertDialogRootProps {
|
|
70
|
+
open?: boolean;
|
|
71
|
+
defaultOpen?: boolean;
|
|
72
|
+
onOpenChange?: (open: boolean) => void;
|
|
73
|
+
/** `AlertDialog.Trigger` and `AlertDialog.Content`. */
|
|
74
|
+
children?: ReactNode;
|
|
75
|
+
}
|
|
76
|
+
/** Root of a composed alert dialog; owns the open state and the focus return. */
|
|
77
|
+
declare function AlertDialogRoot({ open: openProp, defaultOpen, onOpenChange, children, }: AlertDialogRootProps): import("react").JSX.Element;
|
|
78
|
+
/** Element that opens the dialog; `asChild` merges onto your own button. */
|
|
79
|
+
declare function AlertDialogTrigger(props: ComponentProps<typeof DialogPrimitive.Trigger>): import("react").JSX.Element;
|
|
80
|
+
export interface AlertDialogContentProps {
|
|
81
|
+
children?: ReactNode;
|
|
82
|
+
material?: Material;
|
|
83
|
+
container?: HTMLElement | null;
|
|
84
|
+
className?: string;
|
|
85
|
+
/** Per-part classes: `overlay` and `root` apply here. */
|
|
86
|
+
classNames?: ClassNames<AlertDialogPart>;
|
|
87
|
+
}
|
|
88
|
+
/** The panel: `role="alertdialog"`, no close button, outside presses ignored, focus on Cancel. */
|
|
89
|
+
declare function AlertDialogContent({ children, material, container, className, classNames, }: AlertDialogContentProps): import("react").JSX.Element;
|
|
90
|
+
declare function AlertDialogHeader({ className, ...props }: ComponentProps<"div">): import("react").JSX.Element;
|
|
91
|
+
declare function AlertDialogTitle({ className, ...props }: ComponentProps<"h2">): import("react").JSX.Element;
|
|
92
|
+
declare function AlertDialogDescription({ className, ...props }: ComponentProps<"p">): import("react").JSX.Element;
|
|
93
|
+
declare function AlertDialogBody({ className, ...props }: ComponentProps<"div">): import("react").JSX.Element;
|
|
94
|
+
declare function AlertDialogFooter({ className, ...props }: ComponentProps<"div">): import("react").JSX.Element;
|
|
95
|
+
/** Closes the dialog. Takes initial focus. Label defaults to the localized "Cancel". */
|
|
96
|
+
declare function AlertDialogCancel({ children, variant, ref, ...props }: ButtonProps): import("react").JSX.Element;
|
|
97
|
+
export interface AlertDialogActionProps extends ButtonProps {
|
|
98
|
+
/** `danger` styles the button as destructive; same as `variant="danger"`. */
|
|
99
|
+
tone?: AlertDialogTone;
|
|
100
|
+
}
|
|
101
|
+
/** The confirming button. Closes the dialog after `onClick` unless that calls `preventDefault()`. */
|
|
102
|
+
declare function AlertDialogAction({ children, tone, variant, ...props }: AlertDialogActionProps): import("react").JSX.Element;
|
|
103
|
+
export { AlertDialogAction, AlertDialogBody, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogRoot, AlertDialogTitle, AlertDialogTrigger, };
|