@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
@@ -76,3 +76,118 @@ export function formatHour(hour: number, locale?: string): string {
76
76
  timeZone: "UTC",
77
77
  }).format(new Date(Date.UTC(1970, 0, 1, hour)));
78
78
  }
79
+
80
+ const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
81
+
82
+ /** True for a real calendar date written "YYYY-MM-DD" (rejects "2026-02-30"). */
83
+ export function isIsoDate(value: string): boolean {
84
+ const match = ISO_DATE.exec(value);
85
+ if (!match) return false;
86
+ const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];
87
+ const date = new Date(Date.UTC(year, month - 1, day));
88
+ return (
89
+ date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day
90
+ );
91
+ }
92
+
93
+ /** Builds "YYYY-MM-DD" from numeric parts; no time zone is involved. */
94
+ export function toIsoDate(year: number, month: number, day: number): string {
95
+ return `${String(year).padStart(4, "0")}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`;
96
+ }
97
+
98
+ /** Same day of the month `amount` months away, or the last day when the month is shorter. */
99
+ export function addMonths(value: string, amount: number): string {
100
+ const date = parseDate(value);
101
+ const target = new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + amount, 1));
102
+ const last = new Date(
103
+ Date.UTC(target.getUTCFullYear(), target.getUTCMonth() + 1, 0),
104
+ ).getUTCDate();
105
+ return toIsoDate(
106
+ target.getUTCFullYear(),
107
+ target.getUTCMonth() + 1,
108
+ Math.min(date.getUTCDate(), last),
109
+ );
110
+ }
111
+
112
+ /** The viewer's calendar date today, read from local fields (never from the UTC date). */
113
+ export function todayIso(now: Date = new Date()): string {
114
+ return toIsoDate(now.getFullYear(), now.getMonth() + 1, now.getDate());
115
+ }
116
+
117
+ /** `value` pulled inside `[min, max]`. ISO dates compare correctly as strings. */
118
+ export function clampDate(value: string, min?: string, max?: string): string {
119
+ if (min && value < min) return min;
120
+ if (max && value > max) return max;
121
+ return value;
122
+ }
123
+
124
+ /** Regions whose calendars conventionally start the week on Sunday. */
125
+ const SUNDAY_REGIONS = new Set([
126
+ "US",
127
+ "CA",
128
+ "MX",
129
+ "BR",
130
+ "JP",
131
+ "KR",
132
+ "IL",
133
+ "IN",
134
+ "PH",
135
+ "TW",
136
+ "HK",
137
+ "ZA",
138
+ "CO",
139
+ "VE",
140
+ "SA",
141
+ ]);
142
+
143
+ /**
144
+ * First day of the week for a BCP 47 locale: Sunday (0) where that is the convention of the
145
+ * region (en-US, es-MX, pt-BR, ...), Monday (1) everywhere else, including es-PE and en-GB.
146
+ */
147
+ export function weekStartFor(locale: string): WeekStart {
148
+ const region = /[-_]([A-Za-z]{2})(?:[-_]|$)/.exec(locale)?.[1]?.toUpperCase();
149
+ if (region) return SUNDAY_REGIONS.has(region) ? 0 : 1;
150
+ return locale.toLowerCase().startsWith("en") || locale.toLowerCase().startsWith("ja") ? 0 : 1;
151
+ }
152
+
153
+ /** "September 2026" with only the first letter capitalised ("Setiembre de 2026"). */
154
+ export function formatMonthTitle(value: string, locale?: string): string {
155
+ const raw = format(value, locale, { month: "long", year: "numeric" });
156
+ return raw.charAt(0).toLocaleUpperCase(locale) + raw.slice(1);
157
+ }
158
+
159
+ /** Full date for a screen reader, e.g. "Monday, September 7, 2026". */
160
+ export function formatFullDate(value: string, locale?: string): string {
161
+ return format(value, locale, { dateStyle: "full" });
162
+ }
163
+
164
+ /** Weekday names in column order starting at `weekStartsOn`. */
165
+ export function weekdayNames(
166
+ locale: string | undefined,
167
+ weekStartsOn: WeekStart,
168
+ ): { narrow: string; long: string }[] {
169
+ // 2024-01-07 was a Sunday.
170
+ return Array.from({ length: 7 }, (_, index) => {
171
+ const day = addDays("2024-01-07", weekStartsOn + index);
172
+ return {
173
+ narrow: format(day, locale, { weekday: "narrow" }),
174
+ long: format(day, locale, { weekday: "long" }),
175
+ };
176
+ });
177
+ }
178
+
179
+ /** Six full weeks of "YYYY-MM-DD" covering the month of `value`, so the grid keeps its height. */
180
+ export function monthWeeks(value: string, weekStartsOn: WeekStart): string[][] {
181
+ const date = parseDate(value);
182
+ let cursor = startOfWeek(
183
+ formatDate(new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1))),
184
+ weekStartsOn,
185
+ );
186
+ return Array.from({ length: 6 }, () =>
187
+ Array.from({ length: 7 }, () => {
188
+ const day = cursor;
189
+ cursor = addDays(cursor, 1);
190
+ return day;
191
+ }),
192
+ );
193
+ }
@@ -0,0 +1,40 @@
1
+ "use client";
2
+
3
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
4
+ import { useUiStrings } from "../../i18n/index.js";
5
+ import { cn } from "../../utils/cn.js";
6
+
7
+ export type AsideProps = ComponentPropsWithoutRef<"aside">;
8
+
9
+ /**
10
+ * Complementary column content (`<aside>`), named "Related information" unless given an
11
+ * `aria-label`. The column's width, surface and gutter belong to the page layout; the aside and
12
+ * its parts render flush to it.
13
+ */
14
+ export function Aside({ className, "aria-label": ariaLabel, ...props }: AsideProps) {
15
+ const strings = useUiStrings();
16
+ return (
17
+ <aside
18
+ aria-label={ariaLabel ?? strings.aside}
19
+ className={cn("flex min-w-0 flex-col", className)}
20
+ {...props}
21
+ />
22
+ );
23
+ }
24
+
25
+ export interface AsideHeaderProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
26
+ title: ReactNode;
27
+ /** End slot, usually a link. */
28
+ action?: ReactNode;
29
+ }
30
+
31
+ export function AsideHeader({ title, action, className, ...props }: AsideHeaderProps) {
32
+ return (
33
+ <div className={cn("flex items-center justify-between gap-2 pt-4 pb-2", className)} {...props}>
34
+ <h2 className="m-0 min-w-0 font-semibold text-fs-120 text-ink-3 tracking-wide">{title}</h2>
35
+ {action !== undefined ? (
36
+ <div className="shrink-0 text-fs-120 text-ink-3 [&_a]:hover:text-ink">{action}</div>
37
+ ) : null}
38
+ </div>
39
+ );
40
+ }
@@ -0,0 +1 @@
1
+ export { Aside, AsideHeader, type AsideHeaderProps, type AsideProps } from "./aside.js";
@@ -12,6 +12,19 @@ const toneClasses: Record<BannerTone, string> = {
12
12
  danger: "bg-danger-soft",
13
13
  };
14
14
 
15
+ export type BannerAppearance = "soft" | "outline";
16
+
17
+ /**
18
+ * `outline` keeps the page surface and lets only the border carry the tone: a quieter notice
19
+ * for content that sits inside a form or a card, where a tinted block would shout.
20
+ */
21
+ const outlineToneClasses: Record<BannerTone, string> = {
22
+ info: "border border-info/40 bg-surface",
23
+ success: "border border-success/40 bg-surface",
24
+ warning: "border border-warning/40 bg-surface",
25
+ danger: "border border-danger/40 bg-surface",
26
+ };
27
+
15
28
  const toneIconClasses: Record<BannerTone, string> = {
16
29
  info: "text-info",
17
30
  success: "text-success",
@@ -34,6 +47,8 @@ export type BannerPart = "root" | "icon" | "body" | "title" | "action";
34
47
 
35
48
  export interface BannerProps extends Omit<ComponentPropsWithoutRef<"div">, "role" | "title"> {
36
49
  tone?: BannerTone;
50
+ /** `soft` (default) tints the whole banner; `outline` keeps the surface and tints only the border. */
51
+ appearance?: BannerAppearance;
37
52
  /** Bold first line above the content. */
38
53
  title?: ReactNode;
39
54
  /** Decorative icon on the left; marked `aria-hidden`. Defaults to a glyph for the tone; `null` hides it. */
@@ -46,6 +61,7 @@ export interface BannerProps extends Omit<ComponentPropsWithoutRef<"div">, "role
46
61
 
47
62
  export function Banner({
48
63
  tone = "info",
64
+ appearance = "soft",
49
65
  title,
50
66
  icon,
51
67
  action,
@@ -58,9 +74,10 @@ export function Banner({
58
74
  return (
59
75
  <div
60
76
  role={toneRole[tone]}
77
+ data-appearance={appearance}
61
78
  className={cn(
62
79
  "flex flex-wrap items-start gap-x-3 gap-y-2 rounded-banner px-3.5 py-3 text-fs-130 text-ink",
63
- toneClasses[tone],
80
+ appearance === "outline" ? outlineToneClasses[tone] : toneClasses[tone],
64
81
  classNames?.root,
65
82
  className,
66
83
  )}
@@ -1,21 +1,59 @@
1
- import type { ComponentPropsWithoutRef } from "react";
1
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
2
  import { cn } from "../../utils/cn.js";
3
3
 
4
- export type DescriptionListProps = ComponentPropsWithoutRef<"dl">;
4
+ export type DescriptionListLayout = "auto" | "inline" | "stacked";
5
+
6
+ export interface DescriptionListProps extends ComponentPropsWithoutRef<"dl"> {
7
+ /**
8
+ * `auto` (default) puts the term beside the value and stacks them when the list's own container
9
+ * is narrower than 24rem; `inline` never stacks; `stacked` always puts the term over the value.
10
+ */
11
+ layout?: DescriptionListLayout;
12
+ /** Side the values align to. Defaults to `end` (right in LTR); `start` reads like a form summary. */
13
+ valueAlign?: "end" | "start";
14
+ /** Pairs per row once the container is at least 28rem wide; one column below. Defaults to 1. */
15
+ columns?: 1 | 2 | 3;
16
+ }
17
+
18
+ const layoutClasses: Record<DescriptionListLayout, string> = {
19
+ auto: "grid-cols-[auto_minmax(0,1fr)] @max-sm/dl:grid-cols-1 @max-sm/dl:gap-y-0.5 @max-sm/dl:[&_dd]:mb-2 @max-sm/dl:[&_dd]:text-start",
20
+ inline: "grid-cols-[auto_minmax(0,1fr)]",
21
+ stacked: "grid-cols-1 gap-y-0.5 [&_dd]:mb-2 [&_dd]:text-start",
22
+ };
23
+
24
+ const columnClasses: Record<DescriptionListLayout, Record<2 | 3, string>> = {
25
+ auto: {
26
+ 2: "@md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
27
+ 3: "@md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
28
+ },
29
+ inline: {
30
+ 2: "grid-cols-[auto_minmax(0,1fr)] @md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
31
+ 3: "grid-cols-[auto_minmax(0,1fr)] @md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
32
+ },
33
+ stacked: { 2: "@md/dl:grid-cols-2", 3: "@md/dl:grid-cols-3" },
34
+ };
5
35
 
6
36
  /**
7
- * Two-column definition list (auto term / flexible value aligned right); stacks term over
8
- * value when its own container is narrower than 24rem.
9
- * Compose flat `<dt>`/`<dd>` pairs as children.
37
+ * Key-value list: terms and values in a grid, no page padding. Compose flat `<dt>`/`<dd>` pairs
38
+ * or `DescriptionListItem`s (which fill an empty value with a placeholder) as children. Layout
39
+ * (`auto`/`inline`/`stacked`), value alignment and multi-column rows are container-query driven.
10
40
  */
11
- export function DescriptionList({ className, ...props }: DescriptionListProps) {
41
+ export function DescriptionList({
42
+ className,
43
+ layout = "auto",
44
+ valueAlign = "end",
45
+ columns = 1,
46
+ ...props
47
+ }: DescriptionListProps) {
12
48
  return (
13
49
  <div className="@container/dl min-w-0">
14
50
  <dl
15
51
  className={cn(
16
- "grid grid-cols-[auto_minmax(0,1fr)] gap-x-4 gap-y-2.25 text-fs-130",
17
- "[&_dt]:text-ink-3 [&_dd]:m-0 [&_dd]:min-w-0 [&_dd]:break-words [&_dd]:text-right [&_dd]:font-semibold",
18
- "@max-sm/dl:grid-cols-1 @max-sm/dl:gap-y-0.5 @max-sm/dl:[&_dd]:mb-2 @max-sm/dl:[&_dd]:text-left",
52
+ "grid gap-x-4 gap-y-2.25 text-fs-130",
53
+ "[&_dt]:text-ink-3 [&_dd]:m-0 [&_dd]:min-w-0 [&_dd]:break-words [&_dd]:font-semibold",
54
+ valueAlign === "end" ? "[&_dd]:text-end" : "[&_dd]:text-start",
55
+ layoutClasses[layout],
56
+ columns !== 1 && columnClasses[layout][columns],
19
57
  className,
20
58
  )}
21
59
  {...props}
@@ -23,3 +61,41 @@ export function DescriptionList({ className, ...props }: DescriptionListProps) {
23
61
  </div>
24
62
  );
25
63
  }
64
+
65
+ export interface DescriptionListItemProps {
66
+ term: ReactNode;
67
+ /** The value. `null`, `undefined`, `false` and `""` render the placeholder instead. */
68
+ children?: ReactNode;
69
+ /** Shown for an empty value. Defaults to an em dash. */
70
+ placeholder?: ReactNode;
71
+ /** Screen-reader text for an empty value (the placeholder itself is decorative). */
72
+ emptyLabel?: string;
73
+ className?: string;
74
+ }
75
+
76
+ /** A `dt`/`dd` pair placed straight in the grid, with a placeholder for a missing value. */
77
+ export function DescriptionListItem({
78
+ term,
79
+ children,
80
+ placeholder = "—",
81
+ emptyLabel,
82
+ className,
83
+ }: DescriptionListItemProps) {
84
+ const empty =
85
+ children === null || children === undefined || children === false || children === "";
86
+ return (
87
+ <>
88
+ <dt>{term}</dt>
89
+ <dd data-empty={empty ? "" : undefined} className={className}>
90
+ {empty ? (
91
+ <>
92
+ <span aria-hidden="true">{placeholder}</span>
93
+ {emptyLabel ? <span className="sr-only">{emptyLabel}</span> : null}
94
+ </>
95
+ ) : (
96
+ children
97
+ )}
98
+ </dd>
99
+ </>
100
+ );
101
+ }
@@ -0,0 +1,99 @@
1
+ "use client";
2
+
3
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
4
+ import { useUiStrings } from "../../i18n/index.js";
5
+ import type { ClassNames } from "../../utils/class-names.js";
6
+ import { cn } from "../../utils/cn.js";
7
+ import { type FeedTimeOptions, formatFeedTime, toDateTimeAttribute } from "./model.js";
8
+
9
+ export type FeedProps = ComponentPropsWithoutRef<"ol">;
10
+
11
+ /** Compact activity list: an outlined mark per event, a rail between them, a timestamp under each. Flush. */
12
+ export function Feed({ className, ...props }: FeedProps) {
13
+ return <ol className={cn("m-0 flex list-none flex-col p-0", className)} {...props} />;
14
+ }
15
+
16
+ export type FeedEventPart = "mark" | "rail" | "body" | "text" | "meta" | "time";
17
+
18
+ export interface FeedEventProps extends ComponentPropsWithoutRef<"li">, FeedTimeOptions {
19
+ /** Decorative glyph inside the mark (`aria-hidden`). Without it the mark is a dot. */
20
+ icon?: ReactNode;
21
+ /**
22
+ * When it happened: an ISO instant (`2026-03-04T15:30:00Z`), a calendar date (`2026-03-04`) or
23
+ * a `Date`. Rendered as `<time datetime>` and formatted with the locale of the UI strings.
24
+ */
25
+ time?: string | Date;
26
+ /** Replaces the formatted `time` text (the machine value stays on `datetime`). */
27
+ timeLabel?: ReactNode;
28
+ /** Extra line under the text, after the time (an actor, a place). */
29
+ meta?: ReactNode;
30
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the item. */
31
+ classNames?: ClassNames<FeedEventPart>;
32
+ }
33
+
34
+ export function FeedEvent({
35
+ icon,
36
+ time,
37
+ timeLabel,
38
+ meta,
39
+ locale,
40
+ timeZone,
41
+ relative,
42
+ now,
43
+ className,
44
+ classNames,
45
+ children,
46
+ ...props
47
+ }: FeedEventProps) {
48
+ const strings = useUiStrings();
49
+ const text =
50
+ timeLabel ??
51
+ (time === undefined
52
+ ? null
53
+ : formatFeedTime(time, { locale: locale ?? strings.locale, timeZone, relative, now }));
54
+ return (
55
+ <li
56
+ className={cn(
57
+ "group/ev relative grid grid-cols-[1.25rem_minmax(0,1fr)] gap-2.5 py-2",
58
+ className,
59
+ )}
60
+ {...props}
61
+ >
62
+ <span
63
+ aria-hidden="true"
64
+ className={cn(
65
+ "absolute top-6.5 -bottom-2 left-2.25 w-px bg-divider group-last/ev:hidden",
66
+ classNames?.rail,
67
+ )}
68
+ />
69
+ <span
70
+ aria-hidden="true"
71
+ className={cn(
72
+ "relative grid size-5 place-items-center rounded-pill border-divider bg-surface text-ink-3 [&_svg]:size-3",
73
+ classNames?.mark,
74
+ )}
75
+ >
76
+ {icon ?? <span className="size-1.5 rounded-pill bg-current" />}
77
+ </span>
78
+ <div className={cn("min-w-0", classNames?.body)}>
79
+ <p className={cn("m-0 text-fs-130 leading-snug [&_b]:font-medium", classNames?.text)}>
80
+ {children}
81
+ </p>
82
+ {text !== null || meta !== undefined ? (
83
+ <p className={cn("m-0 text-meta text-ink-3 tabular-nums", classNames?.meta)}>
84
+ {text !== null ? (
85
+ <time
86
+ dateTime={time === undefined ? undefined : toDateTimeAttribute(time)}
87
+ className={classNames?.time}
88
+ >
89
+ {text}
90
+ </time>
91
+ ) : null}
92
+ {text !== null && meta !== undefined ? " · " : null}
93
+ {meta}
94
+ </p>
95
+ ) : null}
96
+ </div>
97
+ </li>
98
+ );
99
+ }
@@ -0,0 +1,8 @@
1
+ export {
2
+ Feed,
3
+ FeedEvent,
4
+ type FeedEventPart,
5
+ type FeedEventProps,
6
+ type FeedProps,
7
+ } from "./feed.js";
8
+ export { type FeedTimeOptions, formatFeedTime } from "./model.js";
@@ -0,0 +1,54 @@
1
+ import { isIsoDate, parseDate } from "../../calendar/internal/date-utils.js";
2
+
3
+ export interface FeedTimeOptions {
4
+ locale?: string | undefined;
5
+ /** IANA zone used to show an instant (default: the viewer's). Calendar dates never use a zone. */
6
+ timeZone?: string | undefined;
7
+ /** Show "5 minutes ago" for instants within a week of `now` instead of the absolute time. */
8
+ relative?: boolean | undefined;
9
+ /** Reference instant for `relative` (default: the current time). */
10
+ now?: Date | string | number | undefined;
11
+ }
12
+
13
+ const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
14
+
15
+ /** True when `value` is a calendar date ("YYYY-MM-DD") rather than an instant. */
16
+ export function isCalendarDate(value: string): boolean {
17
+ return DATE_ONLY.test(value) && isIsoDate(value);
18
+ }
19
+
20
+ /** The value for a `<time datetime>` attribute: strings pass through, dates become ISO instants. */
21
+ export function toDateTimeAttribute(value: string | Date): string {
22
+ return typeof value === "string" ? value : value.toISOString();
23
+ }
24
+
25
+ /**
26
+ * Display text for a feed timestamp. A calendar date ("2026-03-04") is formatted in UTC so it
27
+ * never shifts a day; an instant is shown as date and time in `timeZone`; with `relative`, an
28
+ * instant within a week of `now` reads "5 minutes ago". Invalid input comes back unchanged.
29
+ */
30
+ export function formatFeedTime(value: string | Date, options: FeedTimeOptions = {}): string {
31
+ const { locale, timeZone, relative = false, now } = options;
32
+ if (typeof value === "string" && isCalendarDate(value)) {
33
+ return new Intl.DateTimeFormat(locale, { dateStyle: "medium", timeZone: "UTC" }).format(
34
+ parseDate(value),
35
+ );
36
+ }
37
+ const instant = typeof value === "string" ? new Date(value) : value;
38
+ if (Number.isNaN(instant.getTime())) return String(value);
39
+ if (relative) {
40
+ const reference = now === undefined ? new Date() : new Date(now);
41
+ const seconds = Math.round((instant.getTime() - reference.getTime()) / 1000);
42
+ const abs = Math.abs(seconds);
43
+ const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
44
+ if (abs < 60) return rtf.format(seconds === 0 ? 0 : Math.sign(seconds) * abs, "second");
45
+ if (abs < 3600) return rtf.format(Math.round(seconds / 60), "minute");
46
+ if (abs < 86400) return rtf.format(Math.round(seconds / 3600), "hour");
47
+ if (abs < 7 * 86400) return rtf.format(Math.round(seconds / 86400), "day");
48
+ }
49
+ return new Intl.DateTimeFormat(locale, {
50
+ dateStyle: "medium",
51
+ timeStyle: "short",
52
+ ...(timeZone ? { timeZone } : {}),
53
+ }).format(instant);
54
+ }
@@ -1,4 +1,5 @@
1
1
  export * from "./action-bar/index.js";
2
+ export * from "./aside/index.js";
2
3
  export * from "./banner/index.js";
3
4
  export * from "./card/index.js";
4
5
  export * from "./carousel/index.js";
@@ -9,6 +10,7 @@ export * from "./confirm-action/index.js";
9
10
  export * from "./data-grid/index.js";
10
11
  export * from "./description-list/index.js";
11
12
  export * from "./facts/index.js";
13
+ export * from "./feed/index.js";
12
14
  export * from "./file-tree/index.js";
13
15
  export * from "./generic-row/index.js";
14
16
  export * from "./grid/index.js";
@@ -18,13 +20,17 @@ export * from "./item-card-group/index.js";
18
20
  export * from "./kanban/index.js";
19
21
  export * from "./kpi/index.js";
20
22
  export * from "./kpi-group/index.js";
23
+ export * from "./list-detail/index.js";
24
+ export * from "./note/index.js";
21
25
  export * from "./page/index.js";
22
26
  export * from "./page-header/index.js";
23
27
  export * from "./resizable/index.js";
24
28
  export * from "./responsive-list/index.js";
25
29
  export * from "./scrolly/index.js";
30
+ export * from "./section/index.js";
26
31
  export * from "./settings-layout/index.js";
27
32
  export * from "./settings-row/index.js";
33
+ export * from "./shortcuts/index.js";
28
34
  export * from "./stack/index.js";
29
35
  export * from "./table/index.js";
30
36
  export * from "./timeline/index.js";