@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,67 @@
1
+ import { isIsoDate, parseDate, todayIso } from "../../calendar/internal/date-utils.js";
2
+
3
+ export type DueState = "overdue" | "soon" | "ok";
4
+
5
+ const NAIVE = /^(\d{4}-\d{2}-\d{2})(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?)?$/;
6
+
7
+ /**
8
+ * The calendar day ("YYYY-MM-DD") a due value falls on. A date or a naive date-time
9
+ * ("2026-03-04T17:00") already names its day and is read as written, so it never shifts with the
10
+ * viewer's zone. An instant with `Z` or an offset names a moment, so it lands on the viewer's
11
+ * local day. Anything else is `null`.
12
+ */
13
+ export function dueCalendarDate(value: string): string | null {
14
+ const naive = NAIVE.exec(value);
15
+ if (naive) {
16
+ const day = naive[1] as string;
17
+ return isIsoDate(day) ? day : null;
18
+ }
19
+ if (/^\d{4}-\d{2}-\d{2}T[\d:.]+(?:Z|[+-]\d{2}:?\d{2})$/.test(value)) {
20
+ const instant = new Date(value);
21
+ return Number.isNaN(instant.getTime()) ? null : todayIso(instant);
22
+ }
23
+ return null;
24
+ }
25
+
26
+ const DAY_MS = 86_400_000;
27
+
28
+ /** Whole days from `from` to `to` (both "YYYY-MM-DD"); negative when `to` is earlier. */
29
+ export function daysBetween(from: string, to: string): number {
30
+ return Math.round((parseDate(to).getTime() - parseDate(from).getTime()) / DAY_MS);
31
+ }
32
+
33
+ export interface DueStatus {
34
+ state: DueState;
35
+ /** Days until the due day; negative once overdue, 0 on the day itself. */
36
+ days: number;
37
+ }
38
+
39
+ /**
40
+ * `overdue` once the due day is before `today`, `soon` from today through `soonDays` days ahead,
41
+ * `ok` beyond. `today` is a calendar day (default: the viewer's today). `null` for an unreadable value.
42
+ */
43
+ export function dueStatus(
44
+ value: string,
45
+ {
46
+ today = todayIso(),
47
+ soonDays = 3,
48
+ }: { today?: string | undefined; soonDays?: number | undefined } = {},
49
+ ): DueStatus | null {
50
+ const day = dueCalendarDate(value);
51
+ const reference = dueCalendarDate(today);
52
+ if (!day || !reference) return null;
53
+ const days = daysBetween(reference, day);
54
+ const state: DueState = days < 0 ? "overdue" : days <= soonDays ? "soon" : "ok";
55
+ return { state, days };
56
+ }
57
+
58
+ /** "Mar 4" (with the year when it is not the reference year), formatted in UTC so the day never shifts. */
59
+ export function formatDueDay(day: string, reference: string, locale?: string): string {
60
+ const sameYear = day.slice(0, 4) === reference.slice(0, 4);
61
+ return new Intl.DateTimeFormat(locale, {
62
+ day: "numeric",
63
+ month: "short",
64
+ ...(sameYear ? {} : { year: "numeric" }),
65
+ timeZone: "UTC",
66
+ }).format(parseDate(day));
67
+ }
@@ -0,0 +1,58 @@
1
+ "use client";
2
+
3
+ import type { ComponentPropsWithRef } from "react";
4
+ import { cn } from "../../utils/cn.js";
5
+ import { Button, type ButtonSize, type ButtonVariant } from "../button/button.js";
6
+ import { Spinner } from "../spinner/spinner.js";
7
+
8
+ export type IconButtonSize = ButtonSize;
9
+
10
+ /** Width behind each `size`; the height comes from the matching `Button` size, so the button is square. */
11
+ export const iconButtonSizeClasses: Readonly<Record<IconButtonSize, string>> = {
12
+ sm: "w-control-sm",
13
+ md: "w-control [&_svg]:size-4",
14
+ lg: "w-control-lg [&_svg]:size-4",
15
+ };
16
+
17
+ export interface IconButtonProps
18
+ extends Omit<ComponentPropsWithRef<"button">, "aria-label" | "aria-labelledby" | "children"> {
19
+ /** Accessible name, announced in place of the icon. Required: an icon alone names nothing. */
20
+ label: string;
21
+ variant?: ButtonVariant;
22
+ size?: IconButtonSize;
23
+ /** Swaps the icon for a spinner and disables the button; announces the localized `loading` string. */
24
+ loading?: boolean;
25
+ /** Render the child element (via Slot) instead of a `<button>`, e.g. a link wrapping the icon. */
26
+ asChild?: boolean;
27
+ /** The icon (an `svg`, an `Icon`, or any element). It is decorative: `label` names the button. */
28
+ children: ComponentPropsWithRef<"button">["children"];
29
+ }
30
+
31
+ /**
32
+ * Square, icon-only button with the same variants, sizes, focus ring and touch density as
33
+ * `Button`. The control grows with `data-density="touch"` because its box is the Button height.
34
+ */
35
+ export function IconButton({
36
+ label,
37
+ variant = "secondary",
38
+ size = "md",
39
+ loading,
40
+ asChild,
41
+ className,
42
+ children,
43
+ ...props
44
+ }: IconButtonProps) {
45
+ return (
46
+ <Button
47
+ {...props}
48
+ aria-label={label}
49
+ variant={variant}
50
+ size={size}
51
+ loading={loading}
52
+ asChild={asChild}
53
+ className={cn("shrink-0 px-0", iconButtonSizeClasses[size], className)}
54
+ >
55
+ {loading && !asChild ? <Spinner size="sm" label={false} /> : children}
56
+ </Button>
57
+ );
58
+ }
@@ -0,0 +1,6 @@
1
+ export {
2
+ IconButton,
3
+ type IconButtonProps,
4
+ type IconButtonSize,
5
+ iconButtonSizeClasses,
6
+ } from "./icon-button.js";
@@ -4,12 +4,17 @@ export * from "./big-date/index.js";
4
4
  export * from "./button/index.js";
5
5
  export * from "./checkbox/index.js";
6
6
  export * from "./chip/index.js";
7
+ export * from "./due-chip/index.js";
7
8
  export * from "./icon/index.js";
9
+ export * from "./icon-button/index.js";
10
+ export * from "./kbd/index.js";
8
11
  export * from "./led/index.js";
9
12
  export * from "./number-value/index.js";
10
13
  export * from "./pressable-feedback/index.js";
11
14
  export * from "./progress/index.js";
12
15
  export * from "./radio-group/index.js";
16
+ export * from "./seal/index.js";
17
+ export * from "./spinner/index.js";
13
18
  export * from "./status-dot/index.js";
14
19
  export * from "./status-pill/index.js";
15
20
  export * from "./switch/index.js";
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Invisible 44px hit target for a small control under `data-density="touch"`. It is a pseudo
3
+ * element centred on the control, so the visual box and the layout never change; the control must
4
+ * be `relative`. Default density adds nothing.
5
+ */
6
+ export const touchHitArea =
7
+ "relative in-data-[density=touch]:after:absolute in-data-[density=touch]:after:top-1/2 in-data-[density=touch]:after:left-1/2 in-data-[density=touch]:after:size-11 in-data-[density=touch]:after:-translate-1/2 in-data-[density=touch]:after:content-['']";
@@ -0,0 +1 @@
1
+ export { Kbd, type KbdProps } from "./kbd.js";
@@ -0,0 +1,20 @@
1
+ import type { ComponentPropsWithRef } from "react";
2
+ import { cn } from "../../utils/cn.js";
3
+
4
+ export type KbdProps = ComponentPropsWithRef<"kbd">;
5
+
6
+ /**
7
+ * A keyboard key or shortcut hint (`⌘K`, `Esc`). Purely presentational: put it next to the
8
+ * action's label, never as the only way to tell what a control does.
9
+ */
10
+ export function Kbd({ className, ...props }: KbdProps) {
11
+ return (
12
+ <kbd
13
+ {...props}
14
+ className={cn(
15
+ "inline-flex min-w-5 items-center justify-center rounded-xs border-divider bg-surface-2 px-1.25 py-0.5 font-mono text-count text-ink-2",
16
+ className,
17
+ )}
18
+ />
19
+ );
20
+ }
@@ -46,6 +46,8 @@ export function RadioGroup({ options, className, classNames, ...props }: RadioGr
46
46
  >
47
47
  {options.map((option) => {
48
48
  const id = `${baseId}-${option.value}`;
49
+ const labelId = `${id}-label`;
50
+ const descriptionId = `${id}-description`;
49
51
  return (
50
52
  <label
51
53
  key={option.value}
@@ -59,6 +61,8 @@ export function RadioGroup({ options, className, classNames, ...props }: RadioGr
59
61
  id={id}
60
62
  value={option.value}
61
63
  disabled={option.disabled}
64
+ aria-labelledby={labelId}
65
+ aria-describedby={option.description ? descriptionId : undefined}
62
66
  className={cn(
63
67
  "mt-0.5 grid size-4 shrink-0 place-items-center rounded-pill border-[1.5px] border-line-strong data-[state=checked]:border-accent",
64
68
  classNames?.radio,
@@ -71,9 +75,11 @@ export function RadioGroup({ options, className, classNames, ...props }: RadioGr
71
75
  <span
72
76
  className={cn("flex min-w-0 flex-col [overflow-wrap:anywhere]", classNames?.text)}
73
77
  >
74
- <b className={cn("font-semibold text-fs-130", classNames?.label)}>{option.label}</b>
78
+ <b id={labelId} className={cn("font-semibold text-fs-130", classNames?.label)}>
79
+ {option.label}
80
+ </b>
75
81
  {option.description ? (
76
- <span className={cn("text-ink-3", classNames?.description)}>
82
+ <span id={descriptionId} className={cn("text-ink-3", classNames?.description)}>
77
83
  {option.description}
78
84
  </span>
79
85
  ) : null}
@@ -0,0 +1 @@
1
+ export { Seal, type SealPart, type SealProps, type SealTone } from "./seal.js";
@@ -0,0 +1,107 @@
1
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
+ import type { ClassNames } from "../../utils/class-names.js";
3
+ import { cn } from "../../utils/cn.js";
4
+ import { customToneStyle, isCustomTone } from "../../utils/tone.js";
5
+
6
+ export type SealBuiltinTone =
7
+ | "accent"
8
+ | "success"
9
+ | "warning"
10
+ | "danger"
11
+ | "neutral"
12
+ | "institutional";
13
+
14
+ /** A built-in tone, or the name of a tone declared in `tonePalettes`. */
15
+ export type SealTone = SealBuiltinTone | (string & {});
16
+
17
+ const toneClasses: Record<SealBuiltinTone, { frame: string; title: string }> = {
18
+ accent: { frame: "border-accent-ink", title: "text-accent-ink" },
19
+ success: { frame: "border-success", title: "text-success" },
20
+ warning: { frame: "border-warning", title: "text-warning" },
21
+ danger: { frame: "border-danger", title: "text-danger" },
22
+ neutral: { frame: "border-line-strong", title: "text-ink-2" },
23
+ institutional: { frame: "border-ink", title: "text-ink" },
24
+ };
25
+
26
+ const builtinTones = new Set<string>(Object.keys(toneClasses));
27
+
28
+ export type SealPart = "root" | "icon" | "title" | "body";
29
+
30
+ export interface SealProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
31
+ /** Heading of the stamp, set in small caps-style capitals. */
32
+ title?: ReactNode;
33
+ /** Decorative glyph before the title (`aria-hidden`). */
34
+ icon?: ReactNode;
35
+ /**
36
+ * Frame and title colour. `institutional` is the strong neutral (ink frame) for official
37
+ * seals that must not read as a status; any other name resolves through `tonePalettes`.
38
+ */
39
+ tone?: SealTone;
40
+ /**
41
+ * Accessible name. Set it and the seal becomes a labelled `group`; without it the seal is
42
+ * plain text content the reader encounters in order.
43
+ */
44
+ label?: string;
45
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root. */
46
+ classNames?: ClassNames<SealPart>;
47
+ }
48
+
49
+ /**
50
+ * An official-looking stamp: a heavy tone-colored frame with a title and the lines that vouch
51
+ * for a document (issuer, code, date). Children are the lines, usually `<p>`. Purely
52
+ * typographic, so it prints and scales with the text.
53
+ */
54
+ export function Seal({
55
+ title,
56
+ icon,
57
+ tone = "accent",
58
+ label,
59
+ className,
60
+ classNames,
61
+ children,
62
+ ...props
63
+ }: SealProps) {
64
+ const custom = isCustomTone(tone, builtinTones);
65
+ const classes = custom
66
+ ? { frame: "border-(--tone-c)", title: "text-(--tone-c-ink)" }
67
+ : (toneClasses[tone as SealBuiltinTone] ?? toneClasses.accent);
68
+ return (
69
+ // biome-ignore lint/a11y/useAriaPropsSupportedByRole: the role is `group` exactly when `label` is set
70
+ <div
71
+ role={label ? "group" : undefined}
72
+ aria-label={label}
73
+ data-tone={tone}
74
+ {...props}
75
+ style={customToneStyle(tone, builtinTones, props.style)}
76
+ className={cn(
77
+ "flex min-w-0 flex-col gap-0.5 rounded-card border-2 p-4 text-ink text-meta",
78
+ classes.frame,
79
+ classNames?.root,
80
+ className,
81
+ )}
82
+ >
83
+ {title !== undefined || icon !== undefined ? (
84
+ <div
85
+ className={cn(
86
+ "flex items-center gap-1.5 font-semibold uppercase tracking-wide",
87
+ classes.title,
88
+ classNames?.title,
89
+ )}
90
+ >
91
+ {icon !== undefined ? (
92
+ <span
93
+ aria-hidden="true"
94
+ className={cn("inline-flex shrink-0 [&_svg]:size-4", classNames?.icon)}
95
+ >
96
+ {icon}
97
+ </span>
98
+ ) : null}
99
+ {title}
100
+ </div>
101
+ ) : null}
102
+ <div className={cn("min-w-0 [&_p]:m-0 [overflow-wrap:anywhere]", classNames?.body)}>
103
+ {children}
104
+ </div>
105
+ </div>
106
+ );
107
+ }
@@ -0,0 +1 @@
1
+ export { Spinner, type SpinnerProps, type SpinnerSize, spinnerSizeClasses } from "./spinner.js";
@@ -0,0 +1,49 @@
1
+ import type { ComponentPropsWithRef } from "react";
2
+ import { useUiStrings } from "../../i18n/index.js";
3
+ import { cn } from "../../utils/cn.js";
4
+
5
+ export type SpinnerSize = "xs" | "sm" | "md" | "lg";
6
+
7
+ /** Class map behind each named `size`; exported like `buttonSizeClasses`. */
8
+ export const spinnerSizeClasses: Readonly<Record<SpinnerSize, string>> = {
9
+ xs: "size-3",
10
+ sm: "size-4",
11
+ md: "size-5",
12
+ lg: "size-7",
13
+ };
14
+
15
+ export interface SpinnerProps extends Omit<ComponentPropsWithRef<"span">, "children"> {
16
+ /** Named size, or a pixel size for one-offs. Defaults to `sm`. */
17
+ size?: SpinnerSize | number;
18
+ /**
19
+ * Accessible name announced through `role="status"`. Defaults to the localized `loading` UI
20
+ * string. `false` marks the spinner decorative (`aria-hidden`), for use next to its own text.
21
+ */
22
+ label?: string | false;
23
+ }
24
+
25
+ /**
26
+ * Indeterminate activity indicator drawn with the current text color. It spins only when the user
27
+ * has not asked for reduced motion; otherwise it stays a static ring and the label still says
28
+ * that work is in progress.
29
+ */
30
+ export function Spinner({ size = "sm", label, className, style, ...props }: SpinnerProps) {
31
+ const strings = useUiStrings();
32
+ const named = typeof size === "string";
33
+ const a11y =
34
+ label === false
35
+ ? ({ "aria-hidden": true } as const)
36
+ : ({ role: "status", "aria-label": label ?? strings.loading } as const);
37
+ return (
38
+ <span
39
+ {...a11y}
40
+ {...props}
41
+ style={named ? style : { width: size, height: size, ...style }}
42
+ className={cn(
43
+ "inline-block shrink-0 rounded-full border-2 border-current border-t-transparent motion-safe:animate-spin",
44
+ named && spinnerSizeClasses[size],
45
+ className,
46
+ )}
47
+ />
48
+ );
49
+ }
@@ -6,6 +6,7 @@ import { cn } from "../../utils/cn.js";
6
6
  import { composeHandlers, useComposedRefs } from "../../utils/compose.js";
7
7
  import { BubbleInput, useFormBubble, useFormReset } from "../../utils/form-bubble.js";
8
8
  import { useControllableState } from "../../utils/use-controllable-state.js";
9
+ import { touchHitArea } from "../internal/hit-area.js";
9
10
 
10
11
  export type SwitchPart = "root" | "track" | "thumb";
11
12
 
@@ -68,7 +69,8 @@ export function Switch({
68
69
  {...props}
69
70
  ref={composedRef}
70
71
  className={cn(
71
- "group inline-flex size-10 shrink-0 items-center justify-center in-data-[density=touch]:size-11",
72
+ touchHitArea,
73
+ "group inline-flex size-10 shrink-0 items-center justify-center",
72
74
  classNames?.root,
73
75
  className,
74
76
  )}
@@ -0,0 +1,230 @@
1
+ "use client";
2
+
3
+ import { type KeyboardEvent, useEffect, useId, useMemo, useRef, useState } from "react";
4
+ import { useUiStrings } from "../../i18n/index.js";
5
+ import { ChevronLeft, ChevronRight } from "../../icons/index.js";
6
+ import type { ClassNames } from "../../utils/class-names.js";
7
+ import { cn } from "../../utils/cn.js";
8
+ import {
9
+ addDays,
10
+ addMonths,
11
+ clampDate,
12
+ formatFullDate,
13
+ formatMonthTitle,
14
+ isIsoDate,
15
+ monthWeeks,
16
+ startOfWeek,
17
+ todayIso,
18
+ type WeekStart,
19
+ weekdayNames,
20
+ weekStartFor,
21
+ } from "../internal/date-utils.js";
22
+
23
+ export type DateCalendarPart = "root" | "header" | "title" | "nav" | "grid" | "weekday" | "day";
24
+
25
+ export interface DateCalendarProps {
26
+ /** Selected date, "YYYY-MM-DD". */
27
+ value?: string;
28
+ /** Called with the "YYYY-MM-DD" date the person picks. */
29
+ onSelect: (date: string) => void;
30
+ /** Earliest selectable date, "YYYY-MM-DD". */
31
+ min?: string;
32
+ /** Latest selectable date, "YYYY-MM-DD". */
33
+ max?: string;
34
+ /** Extra dates that cannot be picked (holidays, taken days). */
35
+ isDateDisabled?: (date: string) => boolean;
36
+ /** BCP 47 locale for labels. Defaults to the `locale` UI string. */
37
+ locale?: string;
38
+ /** First day of the week, 0 (Sunday) to 6. Defaults from the locale: Monday for es-PE. */
39
+ weekStartsOn?: WeekStart;
40
+ /** "YYYY-MM-DD" treated as today. Defaults to the viewer's local date. */
41
+ today?: string;
42
+ /** Moves focus into the grid on mount (when it opens inside a popover). */
43
+ autoFocus?: boolean;
44
+ className?: string;
45
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
46
+ classNames?: ClassNames<DateCalendarPart>;
47
+ }
48
+
49
+ const KEY_STEPS: Record<string, number> = {
50
+ ArrowLeft: -1,
51
+ ArrowRight: 1,
52
+ ArrowUp: -7,
53
+ ArrowDown: 7,
54
+ };
55
+
56
+ const NAV =
57
+ "inline-flex size-8 min-h-(--touch-target) min-w-(--touch-target) items-center justify-center rounded-event text-ink-2 outline-none hover:bg-surface-2 focus-visible:focus-ring disabled:pointer-events-none disabled:opacity-40";
58
+
59
+ /**
60
+ * Month grid for picking one date (WAI-ARIA date picker grid). Dates are "YYYY-MM-DD" strings
61
+ * handled in UTC, so a day never shifts with the time zone. Arrows move by day and week,
62
+ * Home/End to the week edges, PageUp/PageDown by month (Shift: year); Enter or Space picks.
63
+ */
64
+ export function DateCalendar({
65
+ value,
66
+ onSelect,
67
+ min,
68
+ max,
69
+ isDateDisabled,
70
+ locale: localeProp,
71
+ weekStartsOn: weekStartProp,
72
+ today: todayProp,
73
+ autoFocus = false,
74
+ className,
75
+ classNames,
76
+ }: DateCalendarProps) {
77
+ const strings = useUiStrings();
78
+ const locale = localeProp || strings.locale;
79
+ const weekStartsOn = weekStartProp ?? weekStartFor(locale);
80
+ const titleId = useId();
81
+ const gridRef = useRef<HTMLTableElement | null>(null);
82
+ const moveFocus = useRef(autoFocus);
83
+ const [today] = useState(() => todayProp ?? todayIso());
84
+ const [focused, setFocused] = useState(() =>
85
+ clampDate(value && isIsoDate(value) ? value : today, min, max),
86
+ );
87
+
88
+ const weeks = useMemo(() => monthWeeks(focused, weekStartsOn), [focused, weekStartsOn]);
89
+ const names = useMemo(() => weekdayNames(locale, weekStartsOn), [locale, weekStartsOn]);
90
+ const month = focused.slice(0, 7);
91
+ const disabled = (date: string) =>
92
+ Boolean((min && date < min) || (max && date > max) || isDateDisabled?.(date));
93
+
94
+ useEffect(() => {
95
+ if (!moveFocus.current) return;
96
+ gridRef.current?.querySelector<HTMLElement>(`[data-date="${focused}"]`)?.focus();
97
+ }, [focused]);
98
+
99
+ const goTo = (date: string, focusDay: boolean) => {
100
+ moveFocus.current = focusDay;
101
+ setFocused(clampDate(date, min, max));
102
+ };
103
+
104
+ const onKeyDown = (event: KeyboardEvent<HTMLTableElement>) => {
105
+ if (event.altKey || event.ctrlKey || event.metaKey) return;
106
+ const step = KEY_STEPS[event.key];
107
+ let next: string | undefined;
108
+ if (step !== undefined) next = addDays(focused, step);
109
+ else if (event.key === "Home") next = startOfWeek(focused, weekStartsOn);
110
+ else if (event.key === "End") next = addDays(startOfWeek(focused, weekStartsOn), 6);
111
+ else if (event.key === "PageUp" || event.key === "PageDown") {
112
+ next = addMonths(focused, (event.key === "PageUp" ? -1 : 1) * (event.shiftKey ? 12 : 1));
113
+ }
114
+ if (next === undefined) return;
115
+ event.preventDefault();
116
+ goTo(next, true);
117
+ };
118
+
119
+ const monthStart = `${month}-01`;
120
+ const prevDisabled = Boolean(min && addDays(monthStart, -1) < min);
121
+ const nextDisabled = Boolean(max && addMonths(monthStart, 1) > max);
122
+
123
+ return (
124
+ <div className={cn("flex w-fit flex-col gap-2", classNames?.root, className)}>
125
+ <div className={cn("flex items-center justify-between gap-2", classNames?.header)}>
126
+ <button
127
+ type="button"
128
+ aria-label={strings.previousMonth}
129
+ disabled={prevDisabled}
130
+ onClick={() => goTo(addMonths(focused, -1), false)}
131
+ className={cn(NAV, classNames?.nav)}
132
+ >
133
+ <ChevronLeft aria-hidden="true" className="size-4" />
134
+ </button>
135
+ <div
136
+ id={titleId}
137
+ aria-live="polite"
138
+ className={cn("font-semibold text-body text-ink", classNames?.title)}
139
+ >
140
+ {formatMonthTitle(focused, locale)}
141
+ </div>
142
+ <button
143
+ type="button"
144
+ aria-label={strings.nextMonth}
145
+ disabled={nextDisabled}
146
+ onClick={() => goTo(addMonths(focused, 1), false)}
147
+ className={cn(NAV, classNames?.nav)}
148
+ >
149
+ <ChevronRight aria-hidden="true" className="size-4" />
150
+ </button>
151
+ </div>
152
+ <table
153
+ ref={gridRef}
154
+ // biome-ignore lint/a11y/noNoninteractiveElementToInteractiveRole: APG date picker grid on a table.
155
+ role="grid"
156
+ aria-labelledby={titleId}
157
+ onKeyDown={onKeyDown}
158
+ className={cn("border-collapse", classNames?.grid)}
159
+ >
160
+ <thead>
161
+ <tr>
162
+ {names.map((name) => (
163
+ <th
164
+ key={name.long}
165
+ scope="col"
166
+ aria-label={name.long}
167
+ className={cn(
168
+ "size-9 p-0 text-center font-semibold text-ink-3 text-meta uppercase",
169
+ classNames?.weekday,
170
+ )}
171
+ >
172
+ {name.narrow}
173
+ </th>
174
+ ))}
175
+ </tr>
176
+ </thead>
177
+ <tbody>
178
+ {weeks.map((week) => (
179
+ <tr key={week[0]}>
180
+ {week.map((date) => {
181
+ const selected = date === value;
182
+ const isDisabled = disabled(date);
183
+ const outside = !date.startsWith(month);
184
+ return (
185
+ // biome-ignore lint/a11y/useFocusableInteractive: the button inside the cell takes focus.
186
+ <td
187
+ key={date}
188
+ // biome-ignore lint/a11y/noNoninteractiveElementToInteractiveRole: APG date picker gridcell.
189
+ role="gridcell"
190
+ aria-selected={selected}
191
+ className="p-0"
192
+ >
193
+ <button
194
+ type="button"
195
+ data-date={date}
196
+ tabIndex={date === focused ? 0 : -1}
197
+ aria-label={formatFullDate(date, locale)}
198
+ aria-current={date === today ? "date" : undefined}
199
+ aria-disabled={isDisabled || undefined}
200
+ data-selected={selected ? "" : undefined}
201
+ data-outside={outside ? "" : undefined}
202
+ onFocus={() => {
203
+ moveFocus.current = true;
204
+ setFocused(date);
205
+ }}
206
+ onClick={() => {
207
+ if (!isDisabled) onSelect(date);
208
+ }}
209
+ className={cn(
210
+ "flex size-9 min-h-(--touch-target) min-w-(--touch-target) items-center justify-center rounded-event text-body tabular-nums outline-none focus-visible:focus-ring",
211
+ outside ? "text-ink-3" : "text-ink",
212
+ date === today && !selected && "font-bold text-accent-ink",
213
+ !isDisabled && !selected && "hover:bg-surface-2",
214
+ selected && "bg-accent font-bold text-on-accent",
215
+ isDisabled && "cursor-not-allowed text-ink-3 line-through opacity-50",
216
+ classNames?.day,
217
+ )}
218
+ >
219
+ {Number(date.slice(8))}
220
+ </button>
221
+ </td>
222
+ );
223
+ })}
224
+ </tr>
225
+ ))}
226
+ </tbody>
227
+ </table>
228
+ </div>
229
+ );
230
+ }
@@ -0,0 +1,5 @@
1
+ export {
2
+ DateCalendar,
3
+ type DateCalendarPart,
4
+ type DateCalendarProps,
5
+ } from "./date-calendar.js";
@@ -1,3 +1,4 @@
1
+ export * from "./date-calendar/index.js";
1
2
  export * from "./day-chip/index.js";
2
3
  export * from "./event-block/index.js";
3
4
  export * from "./month-view/index.js";