@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,280 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
3
|
+
import {
|
|
4
|
+
type ComponentProps,
|
|
5
|
+
type KeyboardEvent,
|
|
6
|
+
useEffect,
|
|
7
|
+
useId,
|
|
8
|
+
useMemo,
|
|
9
|
+
useRef,
|
|
10
|
+
useState,
|
|
11
|
+
} from "react";
|
|
12
|
+
import { useUiStrings } from "../../i18n/index.js";
|
|
13
|
+
import { ChevronDown } from "../../icons/index.js";
|
|
14
|
+
import * as PopoverPrimitive from "../../primitives/popover/popover.js";
|
|
15
|
+
import type { ClassNames } from "../../utils/class-names.js";
|
|
16
|
+
import { cn } from "../../utils/cn.js";
|
|
17
|
+
import { useComposedRefs } from "../../utils/compose.js";
|
|
18
|
+
import { type Material, materialClass } from "../../utils/material.js";
|
|
19
|
+
import { useControllableState } from "../../utils/use-controllable-state.js";
|
|
20
|
+
import {
|
|
21
|
+
flattenItems,
|
|
22
|
+
isTypeaheadKey,
|
|
23
|
+
type ListboxGroup,
|
|
24
|
+
type ListboxMove,
|
|
25
|
+
type ListboxOption,
|
|
26
|
+
moveActive,
|
|
27
|
+
nextTypeahead,
|
|
28
|
+
typeaheadIndex,
|
|
29
|
+
} from "../internal/listbox.js";
|
|
30
|
+
import { LISTBOX_SURFACE, ListboxItems, optionDomId } from "../internal/listbox-items.js";
|
|
31
|
+
|
|
32
|
+
export type SelectMenuOption = Omit<ListboxOption, "keywords">;
|
|
33
|
+
export type SelectMenuGroup = ListboxGroup<SelectMenuOption>;
|
|
34
|
+
|
|
35
|
+
export type SelectMenuPart = "trigger" | "value" | "icon" | "content" | "option" | "group";
|
|
36
|
+
|
|
37
|
+
export interface SelectMenuProps
|
|
38
|
+
extends Omit<
|
|
39
|
+
ComponentProps<"button">,
|
|
40
|
+
"value" | "defaultValue" | "onChange" | "children" | "type" | "role" | "size"
|
|
41
|
+
> {
|
|
42
|
+
/** Options, optionally nested in labelled groups. A `value` of `""` is a real option, not "nothing". */
|
|
43
|
+
options: readonly (SelectMenuOption | SelectMenuGroup)[];
|
|
44
|
+
/** Selected value (controlled). An unknown value or `undefined` shows the placeholder. */
|
|
45
|
+
value?: string;
|
|
46
|
+
defaultValue?: string;
|
|
47
|
+
onValueChange?: (value: string) => void;
|
|
48
|
+
/** Shown while no option is selected. Defaults to the localized "Select…". */
|
|
49
|
+
placeholder?: string;
|
|
50
|
+
/** Submits the value with a surrounding `<form>` through a hidden input. */
|
|
51
|
+
name?: string;
|
|
52
|
+
required?: boolean;
|
|
53
|
+
invalid?: boolean;
|
|
54
|
+
size?: "sm" | "md";
|
|
55
|
+
/** Portal target for the popup. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
|
|
56
|
+
container?: HTMLElement | null;
|
|
57
|
+
/** Popup surface material; see `PopoverContent`. */
|
|
58
|
+
material?: Material;
|
|
59
|
+
/** Per-part classes merged with `cn`; consumer classes win. `className` still targets the trigger and is merged last. */
|
|
60
|
+
classNames?: ClassNames<SelectMenuPart>;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
const TYPEAHEAD_MS = 600;
|
|
64
|
+
const OPEN_KEYS = new Set(["ArrowDown", "ArrowUp", "Enter", " "]);
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Select with a custom listbox popup, for option lists that need descriptions, groups or a
|
|
68
|
+
* styled popup. Select-only combobox pattern (WAI-ARIA APG): focus stays on the trigger and the
|
|
69
|
+
* highlighted option is announced through `aria-activedescendant`. Use `NativeSelect` when the
|
|
70
|
+
* system picker is preferable (long lists on phones).
|
|
71
|
+
*/
|
|
72
|
+
export function SelectMenu({
|
|
73
|
+
options,
|
|
74
|
+
value: valueProp,
|
|
75
|
+
defaultValue,
|
|
76
|
+
onValueChange,
|
|
77
|
+
placeholder,
|
|
78
|
+
name,
|
|
79
|
+
required,
|
|
80
|
+
invalid,
|
|
81
|
+
size = "md",
|
|
82
|
+
container,
|
|
83
|
+
material,
|
|
84
|
+
disabled,
|
|
85
|
+
className,
|
|
86
|
+
classNames,
|
|
87
|
+
onKeyDown,
|
|
88
|
+
onKeyUp,
|
|
89
|
+
onClick,
|
|
90
|
+
ref,
|
|
91
|
+
id,
|
|
92
|
+
"aria-label": ariaLabel,
|
|
93
|
+
"aria-labelledby": ariaLabelledBy,
|
|
94
|
+
"aria-invalid": ariaInvalid,
|
|
95
|
+
...props
|
|
96
|
+
}: SelectMenuProps) {
|
|
97
|
+
const strings = useUiStrings();
|
|
98
|
+
const listId = useId();
|
|
99
|
+
const triggerRef = useRef<HTMLButtonElement | null>(null);
|
|
100
|
+
const composedRef = useComposedRefs<HTMLButtonElement>(ref, triggerRef);
|
|
101
|
+
const typeahead = useRef({ buffer: "", at: 0 });
|
|
102
|
+
const [value, setValue] = useControllableState<string | undefined>({
|
|
103
|
+
prop: valueProp,
|
|
104
|
+
defaultProp: defaultValue,
|
|
105
|
+
onChange: (next) => {
|
|
106
|
+
if (next !== undefined) onValueChange?.(next);
|
|
107
|
+
},
|
|
108
|
+
});
|
|
109
|
+
const [open, setOpenState] = useState(false);
|
|
110
|
+
const [active, setActive] = useState(-1);
|
|
111
|
+
const [listLabel, setListLabel] = useState<string | undefined>();
|
|
112
|
+
|
|
113
|
+
const flat = useMemo(() => flattenItems(options), [options]);
|
|
114
|
+
const selectedIndex = flat.findIndex((option) => option.value === value);
|
|
115
|
+
const selected = flat[selectedIndex];
|
|
116
|
+
const isDisabled = Boolean(disabled);
|
|
117
|
+
|
|
118
|
+
const setOpen = (next: boolean, move?: ListboxMove) => {
|
|
119
|
+
if (next && isDisabled) return;
|
|
120
|
+
if (next) {
|
|
121
|
+
const preferred = selected && !selected.disabled ? selectedIndex : -1;
|
|
122
|
+
setActive(
|
|
123
|
+
move
|
|
124
|
+
? moveActive(flat, move === "last" ? flat.length : -1, move)
|
|
125
|
+
: preferred >= 0
|
|
126
|
+
? preferred
|
|
127
|
+
: moveActive(flat, -1, "first"),
|
|
128
|
+
);
|
|
129
|
+
setListLabel(triggerRef.current?.labels?.[0]?.textContent?.trim() || undefined);
|
|
130
|
+
}
|
|
131
|
+
setOpenState(next);
|
|
132
|
+
};
|
|
133
|
+
|
|
134
|
+
useEffect(() => {
|
|
135
|
+
if (!open || active < 0) return;
|
|
136
|
+
document.getElementById(optionDomId(listId, active))?.scrollIntoView?.({ block: "nearest" });
|
|
137
|
+
}, [open, active, listId]);
|
|
138
|
+
|
|
139
|
+
const pick = (index: number) => {
|
|
140
|
+
const option = flat[index];
|
|
141
|
+
if (!option || option.disabled) return;
|
|
142
|
+
setValue(option.value);
|
|
143
|
+
setOpenState(false);
|
|
144
|
+
};
|
|
145
|
+
|
|
146
|
+
const handleKeyDown = (event: KeyboardEvent<HTMLButtonElement>) => {
|
|
147
|
+
onKeyDown?.(event);
|
|
148
|
+
if (event.defaultPrevented || event.altKey || event.ctrlKey || event.metaKey) return;
|
|
149
|
+
const { key } = event;
|
|
150
|
+
const buffering =
|
|
151
|
+
typeahead.current.buffer !== "" && Date.now() - typeahead.current.at <= TYPEAHEAD_MS;
|
|
152
|
+
const typing = isTypeaheadKey(event) && !(key === " " && !buffering);
|
|
153
|
+
|
|
154
|
+
if (typing) {
|
|
155
|
+
event.preventDefault();
|
|
156
|
+
typeahead.current = nextTypeahead(typeahead.current, key, Date.now());
|
|
157
|
+
const found = typeaheadIndex(flat, typeahead.current.buffer, open ? active : selectedIndex);
|
|
158
|
+
if (found < 0) return;
|
|
159
|
+
if (open) setActive(found);
|
|
160
|
+
else pick(found);
|
|
161
|
+
return;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
if (!open) {
|
|
165
|
+
if (OPEN_KEYS.has(key)) {
|
|
166
|
+
event.preventDefault();
|
|
167
|
+
setOpen(true);
|
|
168
|
+
} else if (key === "Home" || key === "End") {
|
|
169
|
+
event.preventDefault();
|
|
170
|
+
setOpen(true, key === "Home" ? "first" : "last");
|
|
171
|
+
}
|
|
172
|
+
return;
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
const moves: Record<string, ListboxMove> = {
|
|
176
|
+
ArrowDown: "next",
|
|
177
|
+
ArrowUp: "prev",
|
|
178
|
+
Home: "first",
|
|
179
|
+
End: "last",
|
|
180
|
+
};
|
|
181
|
+
const move = moves[key];
|
|
182
|
+
if (move) {
|
|
183
|
+
event.preventDefault();
|
|
184
|
+
setActive((current) => moveActive(flat, current, move));
|
|
185
|
+
} else if (key === "Enter" || key === " ") {
|
|
186
|
+
event.preventDefault();
|
|
187
|
+
pick(active);
|
|
188
|
+
} else if (key === "Tab") {
|
|
189
|
+
setOpenState(false);
|
|
190
|
+
}
|
|
191
|
+
};
|
|
192
|
+
|
|
193
|
+
const showPlaceholder = !selected;
|
|
194
|
+
|
|
195
|
+
return (
|
|
196
|
+
<PopoverPrimitive.Root open={open} onOpenChange={(next) => setOpen(next)}>
|
|
197
|
+
<PopoverPrimitive.Trigger
|
|
198
|
+
ref={composedRef}
|
|
199
|
+
id={id}
|
|
200
|
+
role="combobox"
|
|
201
|
+
data-ui-layer=""
|
|
202
|
+
aria-haspopup="listbox"
|
|
203
|
+
aria-expanded={open}
|
|
204
|
+
aria-controls={open ? listId : undefined}
|
|
205
|
+
aria-activedescendant={open && active >= 0 ? optionDomId(listId, active) : undefined}
|
|
206
|
+
aria-required={required || undefined}
|
|
207
|
+
aria-invalid={ariaInvalid ?? (invalid || undefined)}
|
|
208
|
+
aria-label={ariaLabel}
|
|
209
|
+
aria-labelledby={ariaLabelledBy}
|
|
210
|
+
disabled={disabled}
|
|
211
|
+
data-placeholder={showPlaceholder ? "" : undefined}
|
|
212
|
+
{...props}
|
|
213
|
+
onClick={(event) => {
|
|
214
|
+
onClick?.(event);
|
|
215
|
+
// Safari does not focus a button on press; the keyboard needs focus on it.
|
|
216
|
+
event.currentTarget.focus({ preventScroll: true });
|
|
217
|
+
}}
|
|
218
|
+
onKeyDown={handleKeyDown}
|
|
219
|
+
onKeyUp={(event) => {
|
|
220
|
+
onKeyUp?.(event);
|
|
221
|
+
// Space activates a button on keyup; the keydown already handled it.
|
|
222
|
+
if (event.key === " ") event.preventDefault();
|
|
223
|
+
}}
|
|
224
|
+
className={cn(
|
|
225
|
+
"flex w-full min-w-0 items-center justify-between gap-2 rounded-input border-control bg-surface-control py-0 pr-2.5 pl-3 text-left text-control text-ink focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1 disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-danger",
|
|
226
|
+
size === "sm" ? "h-control-sm" : "h-input min-h-(--touch-target)",
|
|
227
|
+
classNames?.trigger,
|
|
228
|
+
className,
|
|
229
|
+
)}
|
|
230
|
+
>
|
|
231
|
+
<span
|
|
232
|
+
className={cn(
|
|
233
|
+
"min-w-0 flex-1 truncate",
|
|
234
|
+
showPlaceholder && "text-ink-3",
|
|
235
|
+
classNames?.value,
|
|
236
|
+
)}
|
|
237
|
+
>
|
|
238
|
+
{selected?.label ?? placeholder ?? strings.selectPlaceholder}
|
|
239
|
+
</span>
|
|
240
|
+
<ChevronDown
|
|
241
|
+
aria-hidden="true"
|
|
242
|
+
className={cn("size-3.5 shrink-0 text-ink-3", classNames?.icon)}
|
|
243
|
+
/>
|
|
244
|
+
</PopoverPrimitive.Trigger>
|
|
245
|
+
{name ? <input type="hidden" name={name} value={value ?? ""} disabled={disabled} /> : null}
|
|
246
|
+
<PopoverPrimitive.Portal container={container}>
|
|
247
|
+
<PopoverPrimitive.Content
|
|
248
|
+
id={listId}
|
|
249
|
+
role="listbox"
|
|
250
|
+
data-ui-layer=""
|
|
251
|
+
aria-label={ariaLabelledBy ? undefined : (ariaLabel ?? listLabel ?? placeholder)}
|
|
252
|
+
aria-labelledby={ariaLabelledBy}
|
|
253
|
+
sideOffset={4}
|
|
254
|
+
collisionPadding={8}
|
|
255
|
+
align="start"
|
|
256
|
+
// Focus stays on the trigger, going in and out.
|
|
257
|
+
onOpenAutoFocus={(event) => event.preventDefault()}
|
|
258
|
+
onCloseAutoFocus={(event) => event.preventDefault()}
|
|
259
|
+
className={cn(
|
|
260
|
+
LISTBOX_SURFACE,
|
|
261
|
+
materialClass(material, "surface-solid"),
|
|
262
|
+
classNames?.content,
|
|
263
|
+
)}
|
|
264
|
+
>
|
|
265
|
+
<ListboxItems
|
|
266
|
+
items={options}
|
|
267
|
+
flat={flat}
|
|
268
|
+
idBase={listId}
|
|
269
|
+
isSelected={(option) => option.value === value}
|
|
270
|
+
activeIndex={active}
|
|
271
|
+
onActivate={setActive}
|
|
272
|
+
onPick={(option) => pick(flat.indexOf(option))}
|
|
273
|
+
optionClassName={classNames?.option}
|
|
274
|
+
groupClassName={classNames?.group}
|
|
275
|
+
/>
|
|
276
|
+
</PopoverPrimitive.Content>
|
|
277
|
+
</PopoverPrimitive.Portal>
|
|
278
|
+
</PopoverPrimitive.Root>
|
|
279
|
+
);
|
|
280
|
+
}
|
package/src/i18n/strings.ts
CHANGED
|
@@ -19,6 +19,43 @@ export interface UiStrings {
|
|
|
19
19
|
copied: string;
|
|
20
20
|
more: string;
|
|
21
21
|
remove: string;
|
|
22
|
+
noResults: string;
|
|
23
|
+
clear: string;
|
|
24
|
+
selectPlaceholder: string;
|
|
25
|
+
openCalendar: string;
|
|
26
|
+
calendar: string;
|
|
27
|
+
previousMonth: string;
|
|
28
|
+
nextMonth: string;
|
|
29
|
+
time: string;
|
|
30
|
+
/** BCP 47 locale used for date labels and the typed date format. */
|
|
31
|
+
locale: string;
|
|
32
|
+
dayPlaceholder: string;
|
|
33
|
+
monthPlaceholder: string;
|
|
34
|
+
yearPlaceholder: string;
|
|
35
|
+
back: string;
|
|
36
|
+
next: string;
|
|
37
|
+
finish: string;
|
|
38
|
+
/** Step announcement; `{current}`, `{total}` and `{label}` are replaced. */
|
|
39
|
+
stepOf: string;
|
|
40
|
+
steps: string;
|
|
41
|
+
/** Default accessible name of an `Aside`. */
|
|
42
|
+
aside: string;
|
|
43
|
+
/** Back action of a single-pane `ListDetail`. */
|
|
44
|
+
backToList: string;
|
|
45
|
+
/** Screen-reader state of a `DueChip` past its date. */
|
|
46
|
+
overdue: string;
|
|
47
|
+
/** Screen-reader state of a `DueChip` due within its `soonDays`. */
|
|
48
|
+
dueSoon: string;
|
|
49
|
+
/** Screen-reader state of a completed `Stepper` step. */
|
|
50
|
+
stepDone: string;
|
|
51
|
+
/** Screen-reader state of a `Stepper` step that has an error. */
|
|
52
|
+
stepError: string;
|
|
53
|
+
/** Name of a row checkbox in a `Table`; `{row}` is replaced by the row's label. */
|
|
54
|
+
selectRow: string;
|
|
55
|
+
/** Name of the select-all checkbox of a `Table`. */
|
|
56
|
+
selectAll: string;
|
|
57
|
+
/** Name of the overflow menu trigger of a `TableActionsCell`. */
|
|
58
|
+
rowActions: string;
|
|
22
59
|
}
|
|
23
60
|
|
|
24
61
|
export type UiLocale = "en" | "es";
|
|
@@ -45,6 +82,32 @@ export const uiStrings = {
|
|
|
45
82
|
copied: "Copied",
|
|
46
83
|
more: "More",
|
|
47
84
|
remove: "Remove",
|
|
85
|
+
noResults: "No results",
|
|
86
|
+
clear: "Clear",
|
|
87
|
+
selectPlaceholder: "Select…",
|
|
88
|
+
openCalendar: "Open calendar",
|
|
89
|
+
calendar: "Calendar",
|
|
90
|
+
previousMonth: "Previous month",
|
|
91
|
+
nextMonth: "Next month",
|
|
92
|
+
time: "Time",
|
|
93
|
+
locale: "en-US",
|
|
94
|
+
dayPlaceholder: "dd",
|
|
95
|
+
monthPlaceholder: "mm",
|
|
96
|
+
yearPlaceholder: "yyyy",
|
|
97
|
+
back: "Back",
|
|
98
|
+
next: "Next",
|
|
99
|
+
finish: "Finish",
|
|
100
|
+
stepOf: "Step {current} of {total}: {label}",
|
|
101
|
+
steps: "Steps",
|
|
102
|
+
aside: "Related information",
|
|
103
|
+
backToList: "Back to list",
|
|
104
|
+
overdue: "Overdue",
|
|
105
|
+
dueSoon: "Due soon",
|
|
106
|
+
stepDone: "Completed",
|
|
107
|
+
stepError: "Has an error",
|
|
108
|
+
selectRow: "Select {row}",
|
|
109
|
+
selectAll: "Select all rows",
|
|
110
|
+
rowActions: "Row actions",
|
|
48
111
|
},
|
|
49
112
|
es: {
|
|
50
113
|
retry: "Reintentar",
|
|
@@ -67,5 +130,31 @@ export const uiStrings = {
|
|
|
67
130
|
copied: "Copiado",
|
|
68
131
|
more: "Más",
|
|
69
132
|
remove: "Quitar",
|
|
133
|
+
noResults: "Sin resultados",
|
|
134
|
+
clear: "Limpiar",
|
|
135
|
+
selectPlaceholder: "Seleccionar…",
|
|
136
|
+
openCalendar: "Abrir calendario",
|
|
137
|
+
calendar: "Calendario",
|
|
138
|
+
previousMonth: "Mes anterior",
|
|
139
|
+
nextMonth: "Mes siguiente",
|
|
140
|
+
time: "Hora",
|
|
141
|
+
locale: "es-PE",
|
|
142
|
+
dayPlaceholder: "dd",
|
|
143
|
+
monthPlaceholder: "mm",
|
|
144
|
+
yearPlaceholder: "aaaa",
|
|
145
|
+
back: "Atrás",
|
|
146
|
+
next: "Siguiente",
|
|
147
|
+
finish: "Finalizar",
|
|
148
|
+
stepOf: "Paso {current} de {total}: {label}",
|
|
149
|
+
steps: "Pasos",
|
|
150
|
+
aside: "Información relacionada",
|
|
151
|
+
backToList: "Volver a la lista",
|
|
152
|
+
overdue: "Vencido",
|
|
153
|
+
dueSoon: "Vence pronto",
|
|
154
|
+
stepDone: "Completado",
|
|
155
|
+
stepError: "Tiene un error",
|
|
156
|
+
selectRow: "Seleccionar {row}",
|
|
157
|
+
selectAll: "Seleccionar todas las filas",
|
|
158
|
+
rowActions: "Acciones de la fila",
|
|
70
159
|
},
|
|
71
160
|
} as const satisfies Record<UiLocale, UiStrings>;
|
|
@@ -1,14 +1,25 @@
|
|
|
1
1
|
"use client";
|
|
2
2
|
|
|
3
|
-
import { createContext, type ReactNode, useContext, useMemo } from "react";
|
|
3
|
+
import { type Context, createContext, type ReactNode, useContext, useMemo } from "react";
|
|
4
4
|
import { type UiLocale, type UiStrings, uiStrings } from "./strings.js";
|
|
5
5
|
|
|
6
|
-
|
|
6
|
+
// One context per page even when the module is instantiated twice (a linked package, a dual
|
|
7
|
+
// bundle, a test runner that inlines one entry and externalizes another): a provider mounted through
|
|
8
|
+
// one copy must reach components imported through the other.
|
|
9
|
+
const registry = Symbol.for("@jcsoftdev/ui/i18n/strings");
|
|
10
|
+
const shared = globalThis as typeof globalThis & { [registry]?: Context<UiStrings> };
|
|
11
|
+
const UiStringsContext: Context<UiStrings> =
|
|
12
|
+
shared[registry] ?? createContext<UiStrings>(uiStrings.en);
|
|
13
|
+
shared[registry] = UiStringsContext;
|
|
14
|
+
|
|
15
|
+
/** Drops `undefined` and empty entries so a partial value never blanks a preset string. */
|
|
16
|
+
const defined = (strings?: Partial<UiStrings>): Partial<UiStrings> =>
|
|
17
|
+
Object.fromEntries(Object.entries(strings ?? {}).filter(([, value]) => value));
|
|
7
18
|
|
|
8
19
|
export interface UiStringsProviderProps {
|
|
9
20
|
/** Preset to start from. Without it the provider keeps the strings of its parent (default `en`). */
|
|
10
21
|
locale?: UiLocale;
|
|
11
|
-
/** Overrides applied on top of the preset. */
|
|
22
|
+
/** Overrides applied on top of the preset. Missing or empty entries keep the preset string. */
|
|
12
23
|
strings?: Partial<UiStrings>;
|
|
13
24
|
children: ReactNode;
|
|
14
25
|
}
|
|
@@ -16,7 +27,7 @@ export interface UiStringsProviderProps {
|
|
|
16
27
|
export function UiStringsProvider({ locale, strings, children }: UiStringsProviderProps) {
|
|
17
28
|
const parent = useContext(UiStringsContext);
|
|
18
29
|
const value = useMemo<UiStrings>(
|
|
19
|
-
() => ({ ...(locale ? uiStrings[locale] : parent), ...strings }),
|
|
30
|
+
() => ({ ...(locale ? uiStrings[locale] : parent), ...defined(strings) }),
|
|
20
31
|
[locale, strings, parent],
|
|
21
32
|
);
|
|
22
33
|
return <UiStringsContext.Provider value={value}>{children}</UiStringsContext.Provider>;
|
package/src/navigation/index.ts
CHANGED
|
@@ -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
|
|
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
|
-
|
|
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
|
-
|
|
70
|
+
markerStatusClasses[status],
|
|
46
71
|
classNames?.marker,
|
|
47
72
|
)}
|
|
48
73
|
>
|
|
49
|
-
{
|
|
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
|
-
!
|
|
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
|
|
@@ -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
|
+
}
|