@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
@@ -1,9 +1,12 @@
1
1
  import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  export type BannerTone = "info" | "success" | "warning" | "danger";
4
+ export type BannerAppearance = "soft" | "outline";
4
5
  export type BannerPart = "root" | "icon" | "body" | "title" | "action";
5
6
  export interface BannerProps extends Omit<ComponentPropsWithoutRef<"div">, "role" | "title"> {
6
7
  tone?: BannerTone;
8
+ /** `soft` (default) tints the whole banner; `outline` keeps the surface and tints only the border. */
9
+ appearance?: BannerAppearance;
7
10
  /** Bold first line above the content. */
8
11
  title?: ReactNode;
9
12
  /** Decorative icon on the left; marked `aria-hidden`. Defaults to a glyph for the tone; `null` hides it. */
@@ -13,4 +16,4 @@ export interface BannerProps extends Omit<ComponentPropsWithoutRef<"div">, "role
13
16
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
14
17
  classNames?: ClassNames<BannerPart>;
15
18
  }
16
- export declare function Banner({ tone, title, icon, action, className, classNames, children, ...props }: BannerProps): import("react").JSX.Element;
19
+ export declare function Banner({ tone, appearance, title, icon, action, className, classNames, children, ...props }: BannerProps): import("react").JSX.Element;
@@ -7,6 +7,12 @@ const toneClasses = {
7
7
  warning: "bg-warning-soft",
8
8
  danger: "bg-danger-soft"
9
9
  };
10
+ const outlineToneClasses = {
11
+ info: "border border-info/40 bg-surface",
12
+ success: "border border-success/40 bg-surface",
13
+ warning: "border border-warning/40 bg-surface",
14
+ danger: "border border-danger/40 bg-surface"
15
+ };
10
16
  const toneIconClasses = {
11
17
  info: "text-info",
12
18
  success: "text-success",
@@ -21,6 +27,7 @@ const toneRole = {
21
27
  };
22
28
  function Banner({
23
29
  tone = "info",
30
+ appearance = "soft",
24
31
  title,
25
32
  icon,
26
33
  action,
@@ -34,9 +41,10 @@ function Banner({
34
41
  "div",
35
42
  {
36
43
  role: toneRole[tone],
44
+ "data-appearance": appearance,
37
45
  className: cn(
38
46
  "flex flex-wrap items-start gap-x-3 gap-y-2 rounded-banner px-3.5 py-3 text-fs-130 text-ink",
39
- toneClasses[tone],
47
+ appearance === "outline" ? outlineToneClasses[tone] : toneClasses[tone],
40
48
  classNames?.root,
41
49
  className
42
50
  ),
@@ -1,8 +1,31 @@
1
- import type { ComponentPropsWithoutRef } from "react";
2
- export type DescriptionListProps = ComponentPropsWithoutRef<"dl">;
1
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
+ export type DescriptionListLayout = "auto" | "inline" | "stacked";
3
+ export interface DescriptionListProps extends ComponentPropsWithoutRef<"dl"> {
4
+ /**
5
+ * `auto` (default) puts the term beside the value and stacks them when the list's own container
6
+ * is narrower than 24rem; `inline` never stacks; `stacked` always puts the term over the value.
7
+ */
8
+ layout?: DescriptionListLayout;
9
+ /** Side the values align to. Defaults to `end` (right in LTR); `start` reads like a form summary. */
10
+ valueAlign?: "end" | "start";
11
+ /** Pairs per row once the container is at least 28rem wide; one column below. Defaults to 1. */
12
+ columns?: 1 | 2 | 3;
13
+ }
3
14
  /**
4
- * Two-column definition list (auto term / flexible value aligned right); stacks term over
5
- * value when its own container is narrower than 24rem.
6
- * Compose flat `<dt>`/`<dd>` pairs as children.
15
+ * Key-value list: terms and values in a grid, no page padding. Compose flat `<dt>`/`<dd>` pairs
16
+ * or `DescriptionListItem`s (which fill an empty value with a placeholder) as children. Layout
17
+ * (`auto`/`inline`/`stacked`), value alignment and multi-column rows are container-query driven.
7
18
  */
8
- export declare function DescriptionList({ className, ...props }: DescriptionListProps): import("react").JSX.Element;
19
+ export declare function DescriptionList({ className, layout, valueAlign, columns, ...props }: DescriptionListProps): import("react").JSX.Element;
20
+ export interface DescriptionListItemProps {
21
+ term: ReactNode;
22
+ /** The value. `null`, `undefined`, `false` and `""` render the placeholder instead. */
23
+ children?: ReactNode;
24
+ /** Shown for an empty value. Defaults to an em dash. */
25
+ placeholder?: ReactNode;
26
+ /** Screen-reader text for an empty value (the placeholder itself is decorative). */
27
+ emptyLabel?: string;
28
+ className?: string;
29
+ }
30
+ /** A `dt`/`dd` pair placed straight in the grid, with a placeholder for a missing value. */
31
+ export declare function DescriptionListItem({ term, children, placeholder, emptyLabel, className, }: DescriptionListItemProps): import("react").JSX.Element;
@@ -1,19 +1,60 @@
1
- import { jsx } from "react/jsx-runtime";
1
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
2
2
  import { cn } from "../../utils/cn.js";
3
- function DescriptionList({ className, ...props }) {
3
+ const layoutClasses = {
4
+ 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",
5
+ inline: "grid-cols-[auto_minmax(0,1fr)]",
6
+ stacked: "grid-cols-1 gap-y-0.5 [&_dd]:mb-2 [&_dd]:text-start"
7
+ };
8
+ const columnClasses = {
9
+ auto: {
10
+ 2: "@md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
11
+ 3: "@md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)]"
12
+ },
13
+ inline: {
14
+ 2: "grid-cols-[auto_minmax(0,1fr)] @md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)]",
15
+ 3: "grid-cols-[auto_minmax(0,1fr)] @md/dl:grid-cols-[auto_minmax(0,1fr)_auto_minmax(0,1fr)_auto_minmax(0,1fr)]"
16
+ },
17
+ stacked: { 2: "@md/dl:grid-cols-2", 3: "@md/dl:grid-cols-3" }
18
+ };
19
+ function DescriptionList({
20
+ className,
21
+ layout = "auto",
22
+ valueAlign = "end",
23
+ columns = 1,
24
+ ...props
25
+ }) {
4
26
  return /* @__PURE__ */ jsx("div", { className: "@container/dl min-w-0", children: /* @__PURE__ */ jsx(
5
27
  "dl",
6
28
  {
7
29
  className: cn(
8
- "grid grid-cols-[auto_minmax(0,1fr)] gap-x-4 gap-y-2.25 text-fs-130",
9
- "[&_dt]:text-ink-3 [&_dd]:m-0 [&_dd]:min-w-0 [&_dd]:break-words [&_dd]:text-right [&_dd]:font-semibold",
10
- "@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",
30
+ "grid gap-x-4 gap-y-2.25 text-fs-130",
31
+ "[&_dt]:text-ink-3 [&_dd]:m-0 [&_dd]:min-w-0 [&_dd]:break-words [&_dd]:font-semibold",
32
+ valueAlign === "end" ? "[&_dd]:text-end" : "[&_dd]:text-start",
33
+ layoutClasses[layout],
34
+ columns !== 1 && columnClasses[layout][columns],
11
35
  className
12
36
  ),
13
37
  ...props
14
38
  }
15
39
  ) });
16
40
  }
41
+ function DescriptionListItem({
42
+ term,
43
+ children,
44
+ placeholder = "\u2014",
45
+ emptyLabel,
46
+ className
47
+ }) {
48
+ const empty = children === null || children === void 0 || children === false || children === "";
49
+ return /* @__PURE__ */ jsxs(Fragment, { children: [
50
+ /* @__PURE__ */ jsx("dt", { children: term }),
51
+ /* @__PURE__ */ jsx("dd", { "data-empty": empty ? "" : void 0, className, children: empty ? /* @__PURE__ */ jsxs(Fragment, { children: [
52
+ /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: placeholder }),
53
+ emptyLabel ? /* @__PURE__ */ jsx("span", { className: "sr-only", children: emptyLabel }) : null
54
+ ] }) : children })
55
+ ] });
56
+ }
17
57
  export {
18
- DescriptionList
58
+ DescriptionList,
59
+ DescriptionListItem
19
60
  };
@@ -0,0 +1,23 @@
1
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
+ import type { ClassNames } from "../../utils/class-names.js";
3
+ import { type FeedTimeOptions } from "./model.js";
4
+ export type FeedProps = ComponentPropsWithoutRef<"ol">;
5
+ /** Compact activity list: an outlined mark per event, a rail between them, a timestamp under each. Flush. */
6
+ export declare function Feed({ className, ...props }: FeedProps): import("react").JSX.Element;
7
+ export type FeedEventPart = "mark" | "rail" | "body" | "text" | "meta" | "time";
8
+ export interface FeedEventProps extends ComponentPropsWithoutRef<"li">, FeedTimeOptions {
9
+ /** Decorative glyph inside the mark (`aria-hidden`). Without it the mark is a dot. */
10
+ icon?: ReactNode;
11
+ /**
12
+ * When it happened: an ISO instant (`2026-03-04T15:30:00Z`), a calendar date (`2026-03-04`) or
13
+ * a `Date`. Rendered as `<time datetime>` and formatted with the locale of the UI strings.
14
+ */
15
+ time?: string | Date;
16
+ /** Replaces the formatted `time` text (the machine value stays on `datetime`). */
17
+ timeLabel?: ReactNode;
18
+ /** Extra line under the text, after the time (an actor, a place). */
19
+ meta?: ReactNode;
20
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the item. */
21
+ classNames?: ClassNames<FeedEventPart>;
22
+ }
23
+ export declare function FeedEvent({ icon, time, timeLabel, meta, locale, timeZone, relative, now, className, classNames, children, ...props }: FeedEventProps): import("react").JSX.Element;
@@ -0,0 +1,77 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import { useUiStrings } from "../../i18n/index.js";
4
+ import { cn } from "../../utils/cn.js";
5
+ import { formatFeedTime, toDateTimeAttribute } from "./model.js";
6
+ function Feed({ className, ...props }) {
7
+ return /* @__PURE__ */ jsx("ol", { className: cn("m-0 flex list-none flex-col p-0", className), ...props });
8
+ }
9
+ function FeedEvent({
10
+ icon,
11
+ time,
12
+ timeLabel,
13
+ meta,
14
+ locale,
15
+ timeZone,
16
+ relative,
17
+ now,
18
+ className,
19
+ classNames,
20
+ children,
21
+ ...props
22
+ }) {
23
+ const strings = useUiStrings();
24
+ const text = timeLabel ?? (time === void 0 ? null : formatFeedTime(time, { locale: locale ?? strings.locale, timeZone, relative, now }));
25
+ return /* @__PURE__ */ jsxs(
26
+ "li",
27
+ {
28
+ className: cn(
29
+ "group/ev relative grid grid-cols-[1.25rem_minmax(0,1fr)] gap-2.5 py-2",
30
+ className
31
+ ),
32
+ ...props,
33
+ children: [
34
+ /* @__PURE__ */ jsx(
35
+ "span",
36
+ {
37
+ "aria-hidden": "true",
38
+ className: cn(
39
+ "absolute top-6.5 -bottom-2 left-2.25 w-px bg-divider group-last/ev:hidden",
40
+ classNames?.rail
41
+ )
42
+ }
43
+ ),
44
+ /* @__PURE__ */ jsx(
45
+ "span",
46
+ {
47
+ "aria-hidden": "true",
48
+ className: cn(
49
+ "relative grid size-5 place-items-center rounded-pill border-divider bg-surface text-ink-3 [&_svg]:size-3",
50
+ classNames?.mark
51
+ ),
52
+ children: icon ?? /* @__PURE__ */ jsx("span", { className: "size-1.5 rounded-pill bg-current" })
53
+ }
54
+ ),
55
+ /* @__PURE__ */ jsxs("div", { className: cn("min-w-0", classNames?.body), children: [
56
+ /* @__PURE__ */ jsx("p", { className: cn("m-0 text-fs-130 leading-snug [&_b]:font-medium", classNames?.text), children }),
57
+ text !== null || meta !== void 0 ? /* @__PURE__ */ jsxs("p", { className: cn("m-0 text-meta text-ink-3 tabular-nums", classNames?.meta), children: [
58
+ text !== null ? /* @__PURE__ */ jsx(
59
+ "time",
60
+ {
61
+ dateTime: time === void 0 ? void 0 : toDateTimeAttribute(time),
62
+ className: classNames?.time,
63
+ children: text
64
+ }
65
+ ) : null,
66
+ text !== null && meta !== void 0 ? " \xB7 " : null,
67
+ meta
68
+ ] }) : null
69
+ ] })
70
+ ]
71
+ }
72
+ );
73
+ }
74
+ export {
75
+ Feed,
76
+ FeedEvent
77
+ };
@@ -0,0 +1,2 @@
1
+ export { Feed, FeedEvent, type FeedEventPart, type FeedEventProps, type FeedProps, } from "./feed.js";
2
+ export { type FeedTimeOptions, formatFeedTime } from "./model.js";
@@ -0,0 +1,10 @@
1
+ import {
2
+ Feed,
3
+ FeedEvent
4
+ } from "./feed.js";
5
+ import { formatFeedTime } from "./model.js";
6
+ export {
7
+ Feed,
8
+ FeedEvent,
9
+ formatFeedTime
10
+ };
@@ -0,0 +1,19 @@
1
+ export interface FeedTimeOptions {
2
+ locale?: string | undefined;
3
+ /** IANA zone used to show an instant (default: the viewer's). Calendar dates never use a zone. */
4
+ timeZone?: string | undefined;
5
+ /** Show "5 minutes ago" for instants within a week of `now` instead of the absolute time. */
6
+ relative?: boolean | undefined;
7
+ /** Reference instant for `relative` (default: the current time). */
8
+ now?: Date | string | number | undefined;
9
+ }
10
+ /** True when `value` is a calendar date ("YYYY-MM-DD") rather than an instant. */
11
+ export declare function isCalendarDate(value: string): boolean;
12
+ /** The value for a `<time datetime>` attribute: strings pass through, dates become ISO instants. */
13
+ export declare function toDateTimeAttribute(value: string | Date): string;
14
+ /**
15
+ * Display text for a feed timestamp. A calendar date ("2026-03-04") is formatted in UTC so it
16
+ * never shifts a day; an instant is shown as date and time in `timeZone`; with `relative`, an
17
+ * instant within a week of `now` reads "5 minutes ago". Invalid input comes back unchanged.
18
+ */
19
+ export declare function formatFeedTime(value: string | Date, options?: FeedTimeOptions): string;
@@ -0,0 +1,38 @@
1
+ import { isIsoDate, parseDate } from "../../calendar/internal/date-utils.js";
2
+ const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
3
+ function isCalendarDate(value) {
4
+ return DATE_ONLY.test(value) && isIsoDate(value);
5
+ }
6
+ function toDateTimeAttribute(value) {
7
+ return typeof value === "string" ? value : value.toISOString();
8
+ }
9
+ function formatFeedTime(value, options = {}) {
10
+ const { locale, timeZone, relative = false, now } = options;
11
+ if (typeof value === "string" && isCalendarDate(value)) {
12
+ return new Intl.DateTimeFormat(locale, { dateStyle: "medium", timeZone: "UTC" }).format(
13
+ parseDate(value)
14
+ );
15
+ }
16
+ const instant = typeof value === "string" ? new Date(value) : value;
17
+ if (Number.isNaN(instant.getTime())) return String(value);
18
+ if (relative) {
19
+ const reference = now === void 0 ? /* @__PURE__ */ new Date() : new Date(now);
20
+ const seconds = Math.round((instant.getTime() - reference.getTime()) / 1e3);
21
+ const abs = Math.abs(seconds);
22
+ const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
23
+ if (abs < 60) return rtf.format(seconds === 0 ? 0 : Math.sign(seconds) * abs, "second");
24
+ if (abs < 3600) return rtf.format(Math.round(seconds / 60), "minute");
25
+ if (abs < 86400) return rtf.format(Math.round(seconds / 3600), "hour");
26
+ if (abs < 7 * 86400) return rtf.format(Math.round(seconds / 86400), "day");
27
+ }
28
+ return new Intl.DateTimeFormat(locale, {
29
+ dateStyle: "medium",
30
+ timeStyle: "short",
31
+ ...timeZone ? { timeZone } : {}
32
+ }).format(instant);
33
+ }
34
+ export {
35
+ formatFeedTime,
36
+ isCalendarDate,
37
+ toDateTimeAttribute
38
+ };
@@ -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";
@@ -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";
@@ -1,15 +1,15 @@
1
- import type { ComponentPropsWithoutRef, ReactNode } from "react";
1
+ import { type ComponentPropsWithoutRef, type ReactNode } from "react";
2
2
  import type { ClassNames } from "../../utils/class-names.js";
3
3
  export type KpiVariant = "default" | "danger";
4
4
  export type KpiBuiltinTone = "neutral" | "accent" | "success" | "warning" | "danger" | "info";
5
5
  /** A built-in tone, or the name of a tone declared in `tonePalettes`. */
6
6
  export type KpiTone = KpiBuiltinTone | (string & {});
7
- export type KpiPart = "root" | "header" | "label" | "dot" | "icon" | "value" | "suffix" | "trend" | "description";
7
+ export type KpiPart = "root" | "header" | "label" | "dot" | "icon" | "trailing" | "value" | "suffix" | "trend" | "description";
8
8
  export interface KpiProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
9
- /** Short label describing the metric. */
10
- label: ReactNode;
11
- /** Highlighted number, already formatted by the consumer. */
12
- value: ReactNode;
9
+ /** Short label describing the metric. Optional when you compose `Kpi.Label` as children. */
10
+ label?: ReactNode;
11
+ /** Highlighted number, already formatted by the consumer. Optional when you compose `Kpi.Value`. */
12
+ value?: ReactNode;
13
13
  /** Small suffix next to the number, e.g. "/12". */
14
14
  suffix?: ReactNode;
15
15
  /** Optional subtext. */
@@ -19,11 +19,53 @@ export interface KpiProps extends Omit<ComponentPropsWithoutRef<"div">, "childre
19
19
  tone?: KpiTone;
20
20
  /** Leading dot on the label, in the tone's colour. */
21
21
  dot?: boolean;
22
- /** Icon at the end of the label row. */
22
+ /** Decorative icon at the end of the label row (`aria-hidden`). */
23
23
  icon?: ReactNode;
24
+ /** Interactive or labelled content at the end of the label row (a menu, a link); not hidden from assistive tech. */
25
+ trailing?: ReactNode;
24
26
  /** Change indicator next to the value, e.g. a `TrendChip`. */
25
27
  trend?: ReactNode;
28
+ /** Draws the tile as a card: border and radius. Off by default, so tiles in a `KpiGroup` stay flush. */
29
+ card?: boolean;
30
+ /**
31
+ * Compose the tile from `Kpi.Label`, `Kpi.Value` and `Kpi.Description` instead of (or after)
32
+ * the props. They are laid out in the tile's column in the order written.
33
+ */
34
+ children?: ReactNode;
26
35
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
27
36
  classNames?: ClassNames<KpiPart>;
28
37
  }
29
- export declare function Kpi({ label, value, suffix, description, variant, tone: toneProp, dot, icon, trend, className, classNames, style, ...props }: KpiProps): import("react").JSX.Element;
38
+ export interface KpiLabelProps extends ComponentPropsWithoutRef<"span"> {
39
+ /** Decorative icon at the end of the row (`aria-hidden`). */
40
+ icon?: ReactNode;
41
+ /** Interactive or labelled content at the end of the row. */
42
+ trailing?: ReactNode;
43
+ /** Overrides the tile's `dot`. */
44
+ dot?: boolean;
45
+ }
46
+ /** Label row of a composed `Kpi`: the label, then an optional icon and trailing slot at the end. */
47
+ export declare function KpiLabel({ icon, trailing, dot: dotProp, className, children, ...props }: KpiLabelProps): import("react").JSX.Element;
48
+ export interface KpiValueProps extends ComponentPropsWithoutRef<"span"> {
49
+ /** Small suffix next to the number. */
50
+ suffix?: ReactNode;
51
+ /** Change indicator next to the value. */
52
+ trend?: ReactNode;
53
+ /** Monospaced digits at a steady weight, for amounts and codes. */
54
+ mono?: boolean;
55
+ }
56
+ /** The highlighted number of a composed `Kpi`, coloured by the tile's tone. */
57
+ export declare function KpiValue({ suffix, trend, mono, className, children, ...props }: KpiValueProps): import("react").JSX.Element;
58
+ export interface KpiDescriptionProps extends ComponentPropsWithoutRef<"span"> {
59
+ }
60
+ export declare function KpiDescription({ className, ...props }: KpiDescriptionProps): import("react").JSX.Element;
61
+ /**
62
+ * One metric: a label, a big number and an optional description. Fill it with props, or compose
63
+ * `Kpi.Label`, `Kpi.Value` and `Kpi.Description` as children when the parts need their own
64
+ * slots (a menu beside the label, a monospaced amount). `card` adds a border and radius.
65
+ */
66
+ export declare function Kpi({ label, value, suffix, description, variant, tone: toneProp, dot, icon, trailing, trend, card, children, className, classNames, style, ...props }: KpiProps): import("react").JSX.Element;
67
+ export declare namespace Kpi {
68
+ var Label: typeof KpiLabel;
69
+ var Value: typeof KpiValue;
70
+ var Description: typeof KpiDescription;
71
+ }