@jcsoftdev/ui 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (268) hide show
  1. package/CHANGELOG.md +103 -1
  2. package/README.md +55 -2
  3. package/bin/ui-theme.mjs +13 -2
  4. package/dist/atoms/checkbox/checkbox.js +3 -1
  5. package/dist/atoms/chip/chip.d.ts +11 -3
  6. package/dist/atoms/chip/chip.js +8 -1
  7. package/dist/atoms/chip/index.d.ts +1 -1
  8. package/dist/atoms/chip/index.js +2 -0
  9. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  10. package/dist/atoms/due-chip/due-chip.js +41 -0
  11. package/dist/atoms/due-chip/index.d.ts +2 -0
  12. package/dist/atoms/due-chip/index.js +6 -0
  13. package/dist/atoms/due-chip/model.d.ts +25 -0
  14. package/dist/atoms/due-chip/model.js +44 -0
  15. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  16. package/dist/atoms/icon-button/icon-button.js +38 -0
  17. package/dist/atoms/icon-button/index.d.ts +1 -0
  18. package/dist/atoms/icon-button/index.js +8 -0
  19. package/dist/atoms/index.d.ts +5 -0
  20. package/dist/atoms/index.js +5 -0
  21. package/dist/atoms/internal/hit-area.d.ts +6 -0
  22. package/dist/atoms/internal/hit-area.js +4 -0
  23. package/dist/atoms/kbd/index.d.ts +1 -0
  24. package/dist/atoms/kbd/index.js +4 -0
  25. package/dist/atoms/kbd/kbd.d.ts +7 -0
  26. package/dist/atoms/kbd/kbd.js +17 -0
  27. package/dist/atoms/radio-group/radio-group.js +6 -2
  28. package/dist/atoms/seal/index.d.ts +1 -0
  29. package/dist/atoms/seal/index.js +4 -0
  30. package/dist/atoms/seal/seal.d.ts +30 -0
  31. package/dist/atoms/seal/seal.js +71 -0
  32. package/dist/atoms/spinner/index.d.ts +1 -0
  33. package/dist/atoms/spinner/index.js +5 -0
  34. package/dist/atoms/spinner/spinner.d.ts +19 -0
  35. package/dist/atoms/spinner/spinner.js +31 -0
  36. package/dist/atoms/switch/switch.js +3 -1
  37. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  38. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  39. package/dist/calendar/date-calendar/index.d.ts +1 -0
  40. package/dist/calendar/date-calendar/index.js +6 -0
  41. package/dist/calendar/index.d.ts +1 -0
  42. package/dist/calendar/index.js +1 -0
  43. package/dist/calendar/internal/date-utils.d.ts +26 -0
  44. package/dist/calendar/internal/date-utils.js +95 -1
  45. package/dist/containers/aside/aside.d.ts +14 -0
  46. package/dist/containers/aside/aside.js +25 -0
  47. package/dist/containers/aside/index.d.ts +1 -0
  48. package/dist/containers/aside/index.js +5 -0
  49. package/dist/containers/banner/banner.d.ts +4 -1
  50. package/dist/containers/banner/banner.js +9 -1
  51. package/dist/containers/description-list/description-list.d.ts +29 -6
  52. package/dist/containers/description-list/description-list.js +47 -6
  53. package/dist/containers/feed/feed.d.ts +23 -0
  54. package/dist/containers/feed/feed.js +77 -0
  55. package/dist/containers/feed/index.d.ts +2 -0
  56. package/dist/containers/feed/index.js +10 -0
  57. package/dist/containers/feed/model.d.ts +19 -0
  58. package/dist/containers/feed/model.js +38 -0
  59. package/dist/containers/index.d.ts +6 -0
  60. package/dist/containers/index.js +6 -0
  61. package/dist/containers/kpi/kpi.d.ts +50 -8
  62. package/dist/containers/kpi/kpi.js +91 -39
  63. package/dist/containers/list-detail/index.d.ts +1 -0
  64. package/dist/containers/list-detail/index.js +20 -0
  65. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  66. package/dist/containers/list-detail/list-detail.js +221 -0
  67. package/dist/containers/note/index.d.ts +1 -0
  68. package/dist/containers/note/index.js +4 -0
  69. package/dist/containers/note/note.d.ts +13 -0
  70. package/dist/containers/note/note.js +27 -0
  71. package/dist/containers/section/index.d.ts +1 -0
  72. package/dist/containers/section/index.js +6 -0
  73. package/dist/containers/section/section.d.ts +68 -0
  74. package/dist/containers/section/section.js +198 -0
  75. package/dist/containers/shortcuts/index.d.ts +1 -0
  76. package/dist/containers/shortcuts/index.js +8 -0
  77. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  78. package/dist/containers/shortcuts/shortcuts.js +50 -0
  79. package/dist/containers/table/selection.d.ts +9 -0
  80. package/dist/containers/table/selection.js +20 -0
  81. package/dist/containers/table/table.d.ts +66 -4
  82. package/dist/containers/table/table.js +128 -7
  83. package/dist/containers/timeline/index.d.ts +1 -1
  84. package/dist/containers/timeline/index.js +4 -2
  85. package/dist/containers/timeline/timeline.d.ts +32 -5
  86. package/dist/containers/timeline/timeline.js +154 -90
  87. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  88. package/dist/forms/chip-group/chip-group.js +114 -0
  89. package/dist/forms/chip-group/index.d.ts +1 -0
  90. package/dist/forms/chip-group/index.js +6 -0
  91. package/dist/forms/combobox/combobox.d.ts +60 -0
  92. package/dist/forms/combobox/combobox.js +281 -0
  93. package/dist/forms/combobox/index.d.ts +1 -0
  94. package/dist/forms/combobox/index.js +6 -0
  95. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  96. package/dist/forms/date-picker/date-picker.js +183 -0
  97. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  98. package/dist/forms/date-picker/date-time-picker.js +121 -0
  99. package/dist/forms/date-picker/index.d.ts +2 -0
  100. package/dist/forms/date-picker/index.js +10 -0
  101. package/dist/forms/date-picker/model.d.ts +35 -0
  102. package/dist/forms/date-picker/model.js +83 -0
  103. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  104. package/dist/forms/dropzone/dropzone.js +153 -23
  105. package/dist/forms/field/field.d.ts +16 -10
  106. package/dist/forms/field/field.js +41 -5
  107. package/dist/forms/index.d.ts +4 -0
  108. package/dist/forms/index.js +4 -0
  109. package/dist/forms/input/index.d.ts +1 -1
  110. package/dist/forms/input/index.js +4 -1
  111. package/dist/forms/input/input.d.ts +21 -5
  112. package/dist/forms/input/input.js +74 -9
  113. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  114. package/dist/forms/internal/listbox-items.d.ts +18 -0
  115. package/dist/forms/internal/listbox-items.js +88 -0
  116. package/dist/forms/internal/listbox.d.ts +44 -0
  117. package/dist/forms/internal/listbox.js +74 -0
  118. package/dist/forms/number-stepper/model.d.ts +16 -0
  119. package/dist/forms/number-stepper/model.js +23 -0
  120. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  121. package/dist/forms/number-stepper/number-stepper.js +86 -37
  122. package/dist/forms/select-menu/index.d.ts +1 -0
  123. package/dist/forms/select-menu/index.js +6 -0
  124. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  125. package/dist/forms/select-menu/select-menu.js +230 -0
  126. package/dist/i18n/strings.d.ts +89 -0
  127. package/dist/i18n/strings.js +54 -2
  128. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  129. package/dist/i18n/ui-strings-provider.js +6 -2
  130. package/dist/navigation/index.d.ts +1 -0
  131. package/dist/navigation/index.js +1 -0
  132. package/dist/navigation/stepper/index.d.ts +1 -1
  133. package/dist/navigation/stepper/index.js +3 -1
  134. package/dist/navigation/stepper/stepper.d.ts +8 -0
  135. package/dist/navigation/stepper/stepper.js +68 -45
  136. package/dist/navigation/tabs/index.d.ts +1 -0
  137. package/dist/navigation/tabs/index.js +6 -0
  138. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  139. package/dist/navigation/tabs/tabs-nav.js +57 -0
  140. package/dist/navigation/wizard/index.d.ts +1 -0
  141. package/dist/navigation/wizard/index.js +6 -0
  142. package/dist/navigation/wizard/model.d.ts +33 -0
  143. package/dist/navigation/wizard/model.js +34 -0
  144. package/dist/navigation/wizard/wizard.d.ts +45 -0
  145. package/dist/navigation/wizard/wizard.js +169 -0
  146. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  147. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  148. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  149. package/dist/overlays/alert-dialog/index.js +26 -0
  150. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +17 -1
  151. package/dist/overlays/dropdown-menu/dropdown-menu.js +12 -4
  152. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  153. package/dist/overlays/dropdown-menu/index.js +8 -2
  154. package/dist/overlays/index.d.ts +2 -0
  155. package/dist/overlays/index.js +2 -0
  156. package/dist/overlays/testing/index.d.ts +5 -0
  157. package/dist/overlays/testing/index.js +4 -0
  158. package/dist/overlays/toaster/index.d.ts +2 -1
  159. package/dist/overlays/toaster/index.js +4 -2
  160. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  161. package/dist/overlays/toaster/toast.d.ts +3 -0
  162. package/dist/overlays/toaster/toast.js +3 -0
  163. package/dist/overlays/toaster/toaster.d.ts +3 -0
  164. package/dist/overlays/toaster/toaster.js +36 -3
  165. package/dist/overlays/tooltip/index.d.ts +1 -0
  166. package/dist/overlays/tooltip/index.js +4 -0
  167. package/dist/overlays/tooltip/model.d.ts +10 -0
  168. package/dist/overlays/tooltip/model.js +13 -0
  169. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  170. package/dist/overlays/tooltip/tooltip.js +116 -0
  171. package/dist/primitives/use-dismissable-layer.js +1 -1
  172. package/dist/states/error-state/error-state.d.ts +6 -1
  173. package/dist/states/error-state/error-state.js +13 -9
  174. package/dist/states/skeleton/skeleton.d.ts +8 -2
  175. package/dist/states/skeleton/skeleton.js +44 -2
  176. package/package.json +2 -2
  177. package/scripts/build-theme.mjs +12 -1
  178. package/src/atoms/checkbox/checkbox.tsx +3 -1
  179. package/src/atoms/chip/chip.tsx +18 -3
  180. package/src/atoms/chip/index.ts +2 -0
  181. package/src/atoms/due-chip/due-chip.tsx +75 -0
  182. package/src/atoms/due-chip/index.ts +2 -0
  183. package/src/atoms/due-chip/model.ts +67 -0
  184. package/src/atoms/icon-button/icon-button.tsx +58 -0
  185. package/src/atoms/icon-button/index.ts +6 -0
  186. package/src/atoms/index.ts +5 -0
  187. package/src/atoms/internal/hit-area.ts +7 -0
  188. package/src/atoms/kbd/index.ts +1 -0
  189. package/src/atoms/kbd/kbd.tsx +20 -0
  190. package/src/atoms/radio-group/radio-group.tsx +8 -2
  191. package/src/atoms/seal/index.ts +1 -0
  192. package/src/atoms/seal/seal.tsx +107 -0
  193. package/src/atoms/spinner/index.ts +1 -0
  194. package/src/atoms/spinner/spinner.tsx +49 -0
  195. package/src/atoms/switch/switch.tsx +3 -1
  196. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  197. package/src/calendar/date-calendar/index.ts +5 -0
  198. package/src/calendar/index.ts +1 -0
  199. package/src/calendar/internal/date-utils.ts +115 -0
  200. package/src/containers/aside/aside.tsx +40 -0
  201. package/src/containers/aside/index.ts +1 -0
  202. package/src/containers/banner/banner.tsx +18 -1
  203. package/src/containers/description-list/description-list.tsx +85 -9
  204. package/src/containers/feed/feed.tsx +99 -0
  205. package/src/containers/feed/index.ts +8 -0
  206. package/src/containers/feed/model.ts +54 -0
  207. package/src/containers/index.ts +6 -0
  208. package/src/containers/kpi/kpi.tsx +161 -62
  209. package/src/containers/list-detail/index.ts +15 -0
  210. package/src/containers/list-detail/list-detail.tsx +293 -0
  211. package/src/containers/note/index.ts +1 -0
  212. package/src/containers/note/note.tsx +38 -0
  213. package/src/containers/section/index.ts +11 -0
  214. package/src/containers/section/section.tsx +281 -0
  215. package/src/containers/shortcuts/index.ts +6 -0
  216. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  217. package/src/containers/table/selection.ts +26 -0
  218. package/src/containers/table/table.tsx +215 -13
  219. package/src/containers/timeline/index.ts +3 -0
  220. package/src/containers/timeline/timeline.tsx +204 -93
  221. package/src/forms/chip-group/chip-group.tsx +184 -0
  222. package/src/forms/chip-group/index.ts +8 -0
  223. package/src/forms/combobox/combobox.tsx +359 -0
  224. package/src/forms/combobox/index.ts +7 -0
  225. package/src/forms/date-picker/date-picker.tsx +239 -0
  226. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  227. package/src/forms/date-picker/index.ts +10 -0
  228. package/src/forms/date-picker/model.ts +108 -0
  229. package/src/forms/dropzone/dropzone.tsx +217 -35
  230. package/src/forms/field/field.tsx +72 -7
  231. package/src/forms/index.ts +4 -0
  232. package/src/forms/input/index.ts +8 -1
  233. package/src/forms/input/input.tsx +97 -12
  234. package/src/forms/input-icon/input-icon.tsx +1 -1
  235. package/src/forms/internal/listbox-items.tsx +103 -0
  236. package/src/forms/internal/listbox.ts +124 -0
  237. package/src/forms/number-stepper/model.ts +35 -0
  238. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  239. package/src/forms/select-menu/index.ts +7 -0
  240. package/src/forms/select-menu/select-menu.tsx +280 -0
  241. package/src/i18n/strings.ts +89 -0
  242. package/src/i18n/ui-strings-provider.tsx +15 -4
  243. package/src/navigation/index.ts +1 -0
  244. package/src/navigation/stepper/index.ts +7 -1
  245. package/src/navigation/stepper/stepper.tsx +41 -5
  246. package/src/navigation/tabs/index.ts +7 -0
  247. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  248. package/src/navigation/wizard/index.ts +7 -0
  249. package/src/navigation/wizard/model.ts +61 -0
  250. package/src/navigation/wizard/wizard.tsx +222 -0
  251. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  252. package/src/overlays/alert-dialog/index.ts +19 -0
  253. package/src/overlays/dropdown-menu/dropdown-menu.tsx +29 -4
  254. package/src/overlays/dropdown-menu/index.ts +3 -0
  255. package/src/overlays/index.ts +2 -0
  256. package/src/overlays/testing/index.ts +5 -0
  257. package/src/overlays/toaster/index.ts +2 -0
  258. package/src/overlays/toaster/toast-store.ts +6 -2
  259. package/src/overlays/toaster/toast.ts +6 -0
  260. package/src/overlays/toaster/toaster.tsx +44 -2
  261. package/src/overlays/tooltip/index.ts +1 -0
  262. package/src/overlays/tooltip/model.ts +18 -0
  263. package/src/overlays/tooltip/tooltip.tsx +166 -0
  264. package/src/primitives/use-dismissable-layer.ts +7 -2
  265. package/src/states/error-state/error-state.tsx +19 -8
  266. package/src/states/skeleton/skeleton.tsx +68 -2
  267. package/styles/tailwind.css +33 -30
  268. package/styles/theme.css +33 -30
@@ -0,0 +1,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
+ }
@@ -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
- const UiStringsContext = createContext<UiStrings>(uiStrings.en);
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>;
@@ -3,3 +3,4 @@ export * from "./floating-toc/index.js";
3
3
  export * from "./segmented/index.js";
4
4
  export * from "./stepper/index.js";
5
5
  export * from "./tabs/index.js";
6
+ export * from "./wizard/index.js";
@@ -1 +1,7 @@
1
- export { type Step, Stepper, type StepperPart, type StepperProps } from "./stepper.js";
1
+ export {
2
+ type Step,
3
+ Stepper,
4
+ type StepperPart,
5
+ type StepperProps,
6
+ type StepStatus,
7
+ } from "./stepper.js";
@@ -1,12 +1,30 @@
1
1
  import type { ComponentPropsWithRef } from "react";
2
+ import { useUiStrings } from "../../i18n/index.js";
3
+ import { Check, X } from "../../icons/index.js";
2
4
  import type { ClassNames } from "../../utils/class-names.js";
3
5
  import { cn } from "../../utils/cn.js";
4
6
 
7
+ export type StepStatus = "done" | "current" | "error" | "pending";
8
+
5
9
  export interface Step {
6
10
  id: string;
7
11
  label: string;
12
+ /**
13
+ * Explicit state of the step. Without it the step is `current` when it is `currentStepId` and
14
+ * `pending` otherwise. A `done` step shows a check, an `error` step a cross and both announce
15
+ * their state; neither relies on colour alone. The step named by `currentStepId` keeps
16
+ * `aria-current="step"` whatever its status.
17
+ */
18
+ status?: StepStatus;
8
19
  }
9
20
 
21
+ const markerStatusClasses: Record<StepStatus, string> = {
22
+ pending: "border-line-strong",
23
+ current: "border-accent-ink text-accent-ink",
24
+ done: "border-success bg-success-soft text-success",
25
+ error: "border-danger bg-danger-soft text-danger",
26
+ };
27
+
10
28
  export type StepperPart = "root" | "step" | "current" | "marker" | "label" | "connector";
11
29
 
12
30
  export interface StepperProps extends Omit<ComponentPropsWithRef<"ol">, "children"> {
@@ -18,6 +36,7 @@ export interface StepperProps extends Omit<ComponentPropsWithRef<"ol">, "childre
18
36
 
19
37
  /** Step 1-N indicator for multi-stage flows. */
20
38
  export function Stepper({ steps, currentStepId, className, classNames, ...props }: StepperProps) {
39
+ const strings = useUiStrings();
21
40
  return (
22
41
  <ol
23
42
  {...props}
@@ -29,35 +48,52 @@ export function Stepper({ steps, currentStepId, className, classNames, ...props
29
48
  >
30
49
  {steps.map((step, index) => {
31
50
  const isCurrent = step.id === currentStepId;
51
+ const status: StepStatus = step.status ?? (isCurrent ? "current" : "pending");
52
+ const emphasised = isCurrent || status === "current" || status === "error";
32
53
  return (
33
- <li key={step.id} className={cn("flex min-w-0 items-center gap-1.5", classNames?.step)}>
54
+ <li
55
+ key={step.id}
56
+ data-status={status}
57
+ className={cn("flex min-w-0 items-center gap-1.5", classNames?.step)}
58
+ >
34
59
  <span
35
60
  aria-current={isCurrent ? "step" : undefined}
36
61
  className={cn(
37
62
  "flex items-center gap-1.5",
38
- isCurrent && "text-ink",
63
+ emphasised && "text-ink",
39
64
  isCurrent && classNames?.current,
40
65
  )}
41
66
  >
42
67
  <span
43
68
  className={cn(
44
69
  "grid size-4.5 place-items-center rounded-pill border text-count",
45
- isCurrent ? "border-accent-ink text-accent-ink" : "border-line-strong",
70
+ markerStatusClasses[status],
46
71
  classNames?.marker,
47
72
  )}
48
73
  >
49
- {index + 1}
74
+ {status === "done" ? (
75
+ <Check aria-hidden="true" className="size-3" />
76
+ ) : status === "error" ? (
77
+ <X aria-hidden="true" className="size-3" />
78
+ ) : (
79
+ index + 1
80
+ )}
50
81
  </span>
51
82
  <span
52
83
  className={cn(
53
84
  "min-w-0 truncate",
54
- !isCurrent && "@max-[420px]/stepper:sr-only",
85
+ !emphasised && "@max-[420px]/stepper:sr-only",
55
86
  isCurrent && "@max-[420px]/stepper:max-w-[40cqw]",
56
87
  classNames?.label,
57
88
  )}
58
89
  >
59
90
  {step.label}
60
91
  </span>
92
+ {status === "done" || status === "error" ? (
93
+ <span className="sr-only">
94
+ , {status === "done" ? strings.stepDone : strings.stepError}
95
+ </span>
96
+ ) : null}
61
97
  </span>
62
98
  {index < steps.length - 1 && (
63
99
  <span
@@ -8,3 +8,10 @@ export {
8
8
  TabsTrigger,
9
9
  type TabsTriggerProps,
10
10
  } from "./tabs.js";
11
+ export {
12
+ TabsNav,
13
+ TabsNavLink,
14
+ type TabsNavLinkProps,
15
+ type TabsNavLinkRenderProps,
16
+ type TabsNavProps,
17
+ } from "./tabs-nav.js";
@@ -0,0 +1,131 @@
1
+ "use client";
2
+
3
+ import {
4
+ type AnchorHTMLAttributes,
5
+ type ComponentPropsWithoutRef,
6
+ cloneElement,
7
+ createContext,
8
+ isValidElement,
9
+ type ReactElement,
10
+ type ReactNode,
11
+ type Ref,
12
+ useContext,
13
+ } from "react";
14
+ import { cn } from "../../utils/cn.js";
15
+ import { Slot } from "../../utils/slot.js";
16
+
17
+ /** Props handed to `renderLink`: spread them on your router's link component. */
18
+ export interface TabsNavLinkRenderProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
19
+ ref?: Ref<HTMLAnchorElement>;
20
+ "aria-current"?: "page" | undefined;
21
+ "data-active"?: "" | undefined;
22
+ }
23
+
24
+ interface TabsNavContextValue {
25
+ value: string | undefined;
26
+ renderLink: ((props: TabsNavLinkRenderProps) => ReactNode) | undefined;
27
+ }
28
+
29
+ const TabsNavContext = createContext<TabsNavContextValue>({
30
+ value: undefined,
31
+ renderLink: undefined,
32
+ });
33
+
34
+ export interface TabsNavProps extends ComponentPropsWithoutRef<"nav"> {
35
+ /** Name of the strip (required: a page can have several navigations). */
36
+ "aria-label": string;
37
+ /** Value of the item that is the current page. */
38
+ value?: string | undefined;
39
+ /**
40
+ * Renders every link with your router's component instead of an `<a>`:
41
+ * `renderLink={(props) => <Link to={...} {...props} />}`. An item's own `asChild` wins.
42
+ */
43
+ renderLink?: ((props: TabsNavLinkRenderProps) => ReactNode) | undefined;
44
+ }
45
+
46
+ /**
47
+ * Tab-looking sub-navigation made of links. Unlike `Tabs` it has no panels and no tab roles:
48
+ * each item is a real link, the current one carries `aria-current="page"`, and the router is
49
+ * yours (`href`, `renderLink` or `asChild`). The strip is flush to its container's inline edges
50
+ * and scrolls sideways when the items do not fit.
51
+ */
52
+ export function TabsNav({ value, renderLink, className, children, ...props }: TabsNavProps) {
53
+ return (
54
+ <TabsNavContext.Provider value={{ value, renderLink }}>
55
+ <nav {...props} className={cn("@container/tabs-nav min-w-0", className)}>
56
+ <ul className="m-0 flex list-none gap-0.5 overflow-x-auto overscroll-x-contain border-b-divider p-0">
57
+ {children}
58
+ </ul>
59
+ </nav>
60
+ </TabsNavContext.Provider>
61
+ );
62
+ }
63
+
64
+ export interface TabsNavLinkProps extends Omit<ComponentPropsWithoutRef<"a">, "children"> {
65
+ /** Matches the strip's `value` to mark this item as the current page. */
66
+ value: string;
67
+ /** Overrides the match for routers that report the active state themselves. */
68
+ active?: boolean | undefined;
69
+ /** Optional record count shown after the label. */
70
+ count?: number | undefined;
71
+ /** Renders the single child element (a router `Link`) with the item's look and a11y props. */
72
+ asChild?: boolean | undefined;
73
+ children: ReactNode;
74
+ }
75
+
76
+ const itemClasses =
77
+ "inline-flex shrink-0 cursor-pointer items-center gap-1.5 whitespace-nowrap border-b-2 border-transparent px-2.5 @max-[420px]/tabs-nav:px-2 pt-2.75 pb-2.5 text-control text-ink-3 no-underline hover:text-ink focus-visible:-outline-offset-2 aria-[current=page]:border-accent-word aria-[current=page]:text-ink";
78
+
79
+ export function TabsNavLink({
80
+ value,
81
+ active,
82
+ count,
83
+ asChild = false,
84
+ className,
85
+ children,
86
+ ...props
87
+ }: TabsNavLinkProps) {
88
+ const context = useContext(TabsNavContext);
89
+ const isActive = active ?? (context.value !== undefined && context.value === value);
90
+ const shared = {
91
+ ...props,
92
+ "aria-current": isActive ? ("page" as const) : undefined,
93
+ "data-active": isActive ? ("" as const) : undefined,
94
+ className: cn(itemClasses, className),
95
+ };
96
+ const countNode =
97
+ count !== undefined ? <span className="text-count text-ink-3">{count}</span> : null;
98
+
99
+ if (asChild && isValidElement(children)) {
100
+ const child = children as ReactElement<{ children?: ReactNode }>;
101
+ return (
102
+ <li>
103
+ <Slot {...shared}>
104
+ {cloneElement(
105
+ child,
106
+ undefined,
107
+ <>
108
+ {child.props.children}
109
+ {countNode}
110
+ </>,
111
+ )}
112
+ </Slot>
113
+ </li>
114
+ );
115
+ }
116
+ const content = (
117
+ <>
118
+ {children}
119
+ {countNode}
120
+ </>
121
+ );
122
+ return (
123
+ <li>
124
+ {context.renderLink ? (
125
+ context.renderLink({ ...shared, children: content })
126
+ ) : (
127
+ <a {...shared}>{content}</a>
128
+ )}
129
+ </li>
130
+ );
131
+ }
@@ -0,0 +1,7 @@
1
+ export {
2
+ Wizard,
3
+ type WizardGate,
4
+ type WizardPart,
5
+ type WizardProps,
6
+ type WizardStep,
7
+ } from "./wizard.js";