@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,4 +1,5 @@
1
1
  import { jsx, jsxs } from "react/jsx-runtime";
2
+ import { createContext, useContext } from "react";
2
3
  import { cn } from "../../utils/cn.js";
3
4
  import { customToneStyle, isCustomTone } from "../../utils/tone.js";
4
5
  const valueToneClasses = {
@@ -18,32 +19,31 @@ const dotToneClasses = {
18
19
  info: "bg-info"
19
20
  };
20
21
  const builtinTones = new Set(Object.keys(valueToneClasses));
21
- function Kpi({
22
- label,
23
- value,
24
- suffix,
25
- description,
26
- variant = "default",
27
- tone: toneProp,
28
- dot,
22
+ const KpiContext = createContext({
23
+ tone: "neutral",
24
+ dot: false,
25
+ classNames: void 0
26
+ });
27
+ function KpiLabel({
29
28
  icon,
30
- trend,
29
+ trailing,
30
+ dot: dotProp,
31
31
  className,
32
- classNames,
33
- style,
32
+ children,
34
33
  ...props
35
34
  }) {
36
- const tone = toneProp ?? (variant === "danger" ? "danger" : "neutral");
37
- const custom = isCustomTone(tone, builtinTones);
38
- const valueTone = custom ? "text-(--tone-c-ink)" : valueToneClasses[tone] ?? valueToneClasses.neutral;
39
- const dotTone = custom ? "bg-(--tone-c)" : dotToneClasses[tone] ?? dotToneClasses.neutral;
35
+ const { tone, dot: tileDot, classNames } = useContext(KpiContext);
36
+ const dot = dotProp ?? tileDot;
37
+ const dotTone = isCustomTone(tone, builtinTones) ? "bg-(--tone-c)" : dotToneClasses[tone] ?? dotToneClasses.neutral;
40
38
  const labelNode = /* @__PURE__ */ jsxs(
41
39
  "span",
42
40
  {
41
+ ...props,
43
42
  className: cn(
44
- "break-words font-semibold text-fs-120 text-ink-2",
43
+ "min-w-0 break-words font-semibold text-fs-120 text-ink-2",
45
44
  dot && "inline-flex items-center gap-1.5",
46
- classNames?.label
45
+ classNames?.label,
46
+ className
47
47
  ),
48
48
  children: [
49
49
  dot ? /* @__PURE__ */ jsx(
@@ -53,20 +53,42 @@ function Kpi({
53
53
  className: cn("size-1.5 shrink-0 rounded-pill", dotTone, classNames?.dot)
54
54
  }
55
55
  ) : null,
56
- label
56
+ children
57
57
  ]
58
58
  }
59
59
  );
60
+ if (!icon && !trailing) return labelNode;
61
+ return /* @__PURE__ */ jsxs("div", { className: cn("flex items-center justify-between gap-2", classNames?.header), children: [
62
+ labelNode,
63
+ /* @__PURE__ */ jsxs("span", { className: "flex shrink-0 items-center gap-1.5", children: [
64
+ icon ? /* @__PURE__ */ jsx(
65
+ "span",
66
+ {
67
+ "aria-hidden": "true",
68
+ className: cn("shrink-0 text-ink-3 [&_svg]:size-4", classNames?.icon),
69
+ children: icon
70
+ }
71
+ ) : null,
72
+ trailing ? /* @__PURE__ */ jsx("span", { className: cn("shrink-0", classNames?.trailing), children: trailing }) : null
73
+ ] })
74
+ ] });
75
+ }
76
+ function KpiValue({ suffix, trend, mono, className, children, ...props }) {
77
+ const { tone, classNames } = useContext(KpiContext);
78
+ const valueTone = isCustomTone(tone, builtinTones) ? "text-(--tone-c-ink)" : valueToneClasses[tone] ?? valueToneClasses.neutral;
60
79
  const valueNode = /* @__PURE__ */ jsxs(
61
80
  "span",
62
81
  {
82
+ ...props,
63
83
  className: cn(
64
84
  "break-words text-kpi-number tabular-nums @max-[9rem]/kpi:text-fs-220",
85
+ mono && "font-mono tracking-normal",
65
86
  valueTone,
66
- classNames?.value
87
+ classNames?.value,
88
+ className
67
89
  ),
68
90
  children: [
69
- value,
91
+ children,
70
92
  suffix ? /* @__PURE__ */ jsx(
71
93
  "small",
72
94
  {
@@ -80,37 +102,67 @@ function Kpi({
80
102
  ]
81
103
  }
82
104
  );
83
- return /* @__PURE__ */ jsxs(
105
+ if (!trend) return valueNode;
106
+ return /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-baseline gap-x-2 gap-y-1", children: [
107
+ valueNode,
108
+ /* @__PURE__ */ jsx("span", { className: cn("shrink-0", classNames?.trend), children: trend })
109
+ ] });
110
+ }
111
+ function KpiDescription({ className, ...props }) {
112
+ const { classNames } = useContext(KpiContext);
113
+ return /* @__PURE__ */ jsx(
114
+ "span",
115
+ {
116
+ ...props,
117
+ className: cn("break-words text-fs-120 text-ink-3", classNames?.description, className)
118
+ }
119
+ );
120
+ }
121
+ function Kpi({
122
+ label,
123
+ value,
124
+ suffix,
125
+ description,
126
+ variant = "default",
127
+ tone: toneProp,
128
+ dot = false,
129
+ icon,
130
+ trailing,
131
+ trend,
132
+ card = false,
133
+ children,
134
+ className,
135
+ classNames,
136
+ style,
137
+ ...props
138
+ }) {
139
+ const tone = toneProp ?? (variant === "danger" ? "danger" : "neutral");
140
+ return /* @__PURE__ */ jsx(KpiContext.Provider, { value: { tone, dot, classNames }, children: /* @__PURE__ */ jsxs(
84
141
  "div",
85
142
  {
86
143
  ...props,
87
144
  style: customToneStyle(tone, builtinTones, style),
88
145
  className: cn(
89
146
  "@container/kpi flex min-w-0 flex-col gap-0.5 bg-surface px-4.5 py-3.5",
147
+ card && "rounded-card border border-line",
90
148
  classNames?.root,
91
149
  className
92
150
  ),
93
151
  children: [
94
- icon ? /* @__PURE__ */ jsxs("div", { className: cn("flex items-center justify-between gap-2", classNames?.header), children: [
95
- labelNode,
96
- /* @__PURE__ */ jsx(
97
- "span",
98
- {
99
- "aria-hidden": "true",
100
- className: cn("shrink-0 text-ink-3 [&_svg]:size-4", classNames?.icon),
101
- children: icon
102
- }
103
- )
104
- ] }) : labelNode,
105
- trend ? /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-baseline gap-x-2 gap-y-1", children: [
106
- valueNode,
107
- /* @__PURE__ */ jsx("span", { className: cn("shrink-0", classNames?.trend), children: trend })
108
- ] }) : valueNode,
109
- description ? /* @__PURE__ */ jsx("span", { className: cn("break-words text-fs-120 text-ink-3", classNames?.description), children: description }) : null
152
+ label !== void 0 ? /* @__PURE__ */ jsx(KpiLabel, { icon, trailing, children: label }) : null,
153
+ value !== void 0 ? /* @__PURE__ */ jsx(KpiValue, { suffix, trend, children: value }) : null,
154
+ description ? /* @__PURE__ */ jsx(KpiDescription, { children: description }) : null,
155
+ children
110
156
  ]
111
157
  }
112
- );
158
+ ) });
113
159
  }
160
+ Kpi.Label = KpiLabel;
161
+ Kpi.Value = KpiValue;
162
+ Kpi.Description = KpiDescription;
114
163
  export {
115
- Kpi
164
+ Kpi,
165
+ KpiDescription,
166
+ KpiLabel,
167
+ KpiValue
116
168
  };
@@ -0,0 +1 @@
1
+ export { ListDetail, ListDetailDetail, ListDetailDetailHeader, type ListDetailDetailHeaderProps, type ListDetailDetailProps, ListDetailItem, type ListDetailItemProps, ListDetailList, type ListDetailListProps, ListDetailMeta, type ListDetailProps, ListDetailTitle, useListDetail, } from "./list-detail.js";
@@ -0,0 +1,20 @@
1
+ import {
2
+ ListDetail,
3
+ ListDetailDetail,
4
+ ListDetailDetailHeader,
5
+ ListDetailItem,
6
+ ListDetailList,
7
+ ListDetailMeta,
8
+ ListDetailTitle,
9
+ useListDetail
10
+ } from "./list-detail.js";
11
+ export {
12
+ ListDetail,
13
+ ListDetailDetail,
14
+ ListDetailDetailHeader,
15
+ ListDetailItem,
16
+ ListDetailList,
17
+ ListDetailMeta,
18
+ ListDetailTitle,
19
+ useListDetail
20
+ };
@@ -0,0 +1,55 @@
1
+ import { type ComponentPropsWithoutRef, type ReactNode } from "react";
2
+ /** The selected item id (`null` while none) and a way to change it, for content inside the detail pane. */
3
+ export declare function useListDetail(): {
4
+ value: string | null;
5
+ select: (value: string | null) => void;
6
+ isSelected: (candidate: string) => boolean;
7
+ };
8
+ export interface ListDetailProps extends Omit<ComponentPropsWithoutRef<"div">, "defaultValue" | "onChange"> {
9
+ /** Controlled selected item id; `null` means none (the single-pane view then shows the list). */
10
+ value?: string | null | undefined;
11
+ defaultValue?: string | null | undefined;
12
+ /**
13
+ * Called with the id the user chose. It is never called with `null`: going back to the list
14
+ * calls `onBack` instead, so a handler that loads the selected record never sees "no record".
15
+ */
16
+ onValueChange?: ((value: string) => void) | undefined;
17
+ /**
18
+ * Called when the back action (or `select(null)` from `useListDetail`) clears the selection.
19
+ * Uncontrolled, the list shows again on its own; controlled, set `value` to `null` here.
20
+ */
21
+ onBack?: (() => void) | undefined;
22
+ /** Names the list of items. */
23
+ "aria-label": string;
24
+ children: ReactNode;
25
+ }
26
+ /**
27
+ * Master-detail: a list of items beside the detail of the selected one. Under 641px of its own
28
+ * width it collapses to a single pane: the list until an item is chosen, then the detail with a
29
+ * back action (focus follows the change). Panes render flush to the container's inline edges.
30
+ */
31
+ export declare function ListDetail({ value: valueProp, defaultValue, onValueChange, onBack, "aria-label": label, className, children, ...props }: ListDetailProps): import("react").JSX.Element;
32
+ export type ListDetailListProps = Omit<ComponentPropsWithoutRef<"ul">, "aria-label">;
33
+ export declare function ListDetailList({ className, ...props }: ListDetailListProps): import("react").JSX.Element;
34
+ export interface ListDetailItemProps extends Omit<ComponentPropsWithoutRef<"button">, "value"> {
35
+ value: string;
36
+ /** End slot: a count, a status chip, a time. */
37
+ trailing?: ReactNode;
38
+ }
39
+ export declare function ListDetailItem({ value, trailing, className, children, onClick, ...props }: ListDetailItemProps): import("react").JSX.Element;
40
+ export declare function ListDetailTitle({ className, ...props }: ComponentPropsWithoutRef<"span">): import("react").JSX.Element;
41
+ export declare function ListDetailMeta({ className, ...props }: ComponentPropsWithoutRef<"span">): import("react").JSX.Element;
42
+ export interface ListDetailDetailProps extends ComponentPropsWithoutRef<"section"> {
43
+ /** Label of the back action shown in the single-pane view. Defaults to the localized "Back to list". */
44
+ backLabel?: string;
45
+ /** Hides the back action (the consumer then provides its own way back). */
46
+ hideBack?: boolean;
47
+ }
48
+ /** The detail pane. A labelled region named by its `ListDetailDetailHeader` title or an `aria-label`. */
49
+ export declare function ListDetailDetail({ backLabel, hideBack, className, children, ...props }: ListDetailDetailProps): import("react").JSX.Element;
50
+ export interface ListDetailDetailHeaderProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
51
+ title: ReactNode;
52
+ description?: ReactNode;
53
+ actions?: ReactNode;
54
+ }
55
+ export declare function ListDetailDetailHeader({ title, description, actions, className, ...props }: ListDetailDetailHeaderProps): import("react").JSX.Element;
@@ -0,0 +1,221 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import {
4
+ createContext,
5
+ useCallback,
6
+ useContext,
7
+ useEffect,
8
+ useId,
9
+ useLayoutEffect,
10
+ useMemo,
11
+ useRef,
12
+ useState
13
+ } from "react";
14
+ import { useUiStrings } from "../../i18n/index.js";
15
+ import { ChevronLeft } from "../../icons/index.js";
16
+ import { cn } from "../../utils/cn.js";
17
+ import { composeHandlers } from "../../utils/compose.js";
18
+ import { useControllableState } from "../../utils/use-controllable-state.js";
19
+ const ListDetailContext = createContext(null);
20
+ function useListDetailContext(part) {
21
+ const context = useContext(ListDetailContext);
22
+ if (!context) throw new Error(`\`${part}\` must be used within \`ListDetail\``);
23
+ return context;
24
+ }
25
+ function useListDetail() {
26
+ const { value, select } = useListDetailContext("useListDetail");
27
+ return { value, select, isSelected: (candidate) => candidate === value };
28
+ }
29
+ function ListDetail({
30
+ value: valueProp,
31
+ defaultValue = null,
32
+ onValueChange,
33
+ onBack,
34
+ "aria-label": label,
35
+ className,
36
+ children,
37
+ ...props
38
+ }) {
39
+ const [value, setValue] = useControllableState({
40
+ prop: valueProp,
41
+ defaultProp: defaultValue,
42
+ onChange: (next) => {
43
+ if (next !== null) onValueChange?.(next);
44
+ }
45
+ });
46
+ const onBackRef = useRef(onBack);
47
+ onBackRef.current = onBack;
48
+ const select = useCallback(
49
+ (next) => {
50
+ setValue(next);
51
+ if (next === null) onBackRef.current?.();
52
+ },
53
+ [setValue]
54
+ );
55
+ const rootRef = useRef(null);
56
+ const previous = useRef(value);
57
+ useEffect(() => {
58
+ const before = previous.current;
59
+ previous.current = value;
60
+ const root = rootRef.current;
61
+ if (before === value || !root) return;
62
+ if (value === null && before !== null) {
63
+ root.querySelector(`[data-list-detail-item="${CSS.escape(before)}"]`)?.focus();
64
+ return;
65
+ }
66
+ const detail = root.querySelector('[data-list-detail-pane="detail"]');
67
+ const back = detail?.querySelector("[data-list-detail-back]");
68
+ if (detail && back && back.getClientRects().length > 0) detail.focus();
69
+ }, [value]);
70
+ const context = useMemo(() => ({ value, select, label }), [value, select, label]);
71
+ return /* @__PURE__ */ jsx(ListDetailContext.Provider, { value: context, children: /* @__PURE__ */ jsx("div", { ...props, ref: rootRef, className: cn("@container/list-detail min-w-0", className), children: /* @__PURE__ */ jsx(
72
+ "div",
73
+ {
74
+ "data-view": value === null ? "list" : "detail",
75
+ className: cn(
76
+ "group/ld grid grid-cols-1 border-t-divider",
77
+ "@min-[641px]/list-detail:grid-cols-2",
78
+ "[&>*]:min-w-0"
79
+ ),
80
+ children
81
+ }
82
+ ) }) });
83
+ }
84
+ function ListDetailList({ className, ...props }) {
85
+ const { label } = useListDetailContext("ListDetailList");
86
+ return /* @__PURE__ */ jsx(
87
+ "ul",
88
+ {
89
+ "data-list-detail-pane": "list",
90
+ "aria-label": label,
91
+ className: cn(
92
+ "m-0 flex list-none flex-col p-0",
93
+ "@min-[641px]/list-detail:border-r-divider",
94
+ "group-data-[view=detail]/ld:@max-[640px]/list-detail:hidden",
95
+ className
96
+ ),
97
+ ...props
98
+ }
99
+ );
100
+ }
101
+ function ListDetailItem({
102
+ value,
103
+ trailing,
104
+ className,
105
+ children,
106
+ onClick,
107
+ ...props
108
+ }) {
109
+ const { value: selected, select } = useListDetailContext("ListDetailItem");
110
+ const isSelected = selected === value;
111
+ return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs(
112
+ "button",
113
+ {
114
+ type: "button",
115
+ "data-list-detail-item": value,
116
+ "aria-current": isSelected ? "true" : void 0,
117
+ onClick: composeHandlers(onClick, () => select(value)),
118
+ className: cn(
119
+ "grid min-h-11 w-full cursor-pointer grid-cols-[minmax(0,1fr)_auto] items-center gap-3 border-b-divider py-2.5 text-start hover:bg-surface-2 focus-visible:-outline-offset-2 focus-visible:focus-ring aria-[current=true]:bg-accent-soft",
120
+ className
121
+ ),
122
+ ...props,
123
+ children: [
124
+ /* @__PURE__ */ jsx("span", { className: "min-w-0", children }),
125
+ trailing !== void 0 ? /* @__PURE__ */ jsx("span", { className: "min-w-0 justify-self-end", children: trailing }) : null
126
+ ]
127
+ }
128
+ ) });
129
+ }
130
+ function ListDetailTitle({ className, ...props }) {
131
+ return /* @__PURE__ */ jsx("span", { className: cn("block font-medium text-ink", className), ...props });
132
+ }
133
+ function ListDetailMeta({ className, ...props }) {
134
+ return /* @__PURE__ */ jsx("span", { className: cn("block text-meta text-ink-3", className), ...props });
135
+ }
136
+ const DetailTitleContext = createContext(null);
137
+ function ListDetailDetail({
138
+ backLabel,
139
+ hideBack = false,
140
+ className,
141
+ children,
142
+ ...props
143
+ }) {
144
+ const strings = useUiStrings();
145
+ const { select } = useListDetailContext("ListDetailDetail");
146
+ const titleId = useId();
147
+ const [titled, setTitled] = useState(0);
148
+ const register = useCallback(() => {
149
+ setTitled((count) => count + 1);
150
+ return () => setTitled((count) => count - 1);
151
+ }, []);
152
+ const context = useMemo(() => ({ titleId, register }), [titleId, register]);
153
+ return /* @__PURE__ */ jsx(DetailTitleContext.Provider, { value: context, children: /* @__PURE__ */ jsxs(
154
+ "section",
155
+ {
156
+ "data-list-detail-pane": "detail",
157
+ tabIndex: -1,
158
+ "aria-labelledby": titled > 0 && props["aria-label"] === void 0 ? titleId : void 0,
159
+ ...props,
160
+ className: cn(
161
+ "flex min-w-0 flex-col outline-none",
162
+ "group-data-[view=list]/ld:@max-[640px]/list-detail:hidden",
163
+ className
164
+ ),
165
+ children: [
166
+ hideBack ? null : /* @__PURE__ */ jsxs(
167
+ "button",
168
+ {
169
+ type: "button",
170
+ "data-list-detail-back": "",
171
+ onClick: () => select(null),
172
+ className: cn(
173
+ "inline-flex min-h-11 cursor-pointer items-center gap-1 self-start text-control text-ink-2 hover:text-ink focus-visible:focus-ring",
174
+ "@min-[641px]/list-detail:hidden"
175
+ ),
176
+ children: [
177
+ /* @__PURE__ */ jsx(ChevronLeft, { "aria-hidden": "true", className: "size-4" }),
178
+ backLabel ?? strings.backToList
179
+ ]
180
+ }
181
+ ),
182
+ children
183
+ ]
184
+ }
185
+ ) });
186
+ }
187
+ function ListDetailDetailHeader({
188
+ title,
189
+ description,
190
+ actions,
191
+ className,
192
+ ...props
193
+ }) {
194
+ const detail = useContext(DetailTitleContext);
195
+ const register = detail?.register;
196
+ useLayoutEffect(() => register?.(), [register]);
197
+ return /* @__PURE__ */ jsxs(
198
+ "div",
199
+ {
200
+ className: cn("flex flex-wrap items-start justify-between gap-3 pt-4 pb-3", className),
201
+ ...props,
202
+ children: [
203
+ /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
204
+ /* @__PURE__ */ jsx("h3", { id: detail?.titleId, className: "m-0 font-semibold text-body text-ink", children: title }),
205
+ description !== void 0 ? /* @__PURE__ */ jsx("p", { className: "m-0 mt-0.5 text-meta text-ink-3", children: description }) : null
206
+ ] }),
207
+ actions !== void 0 ? /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-2", children: actions }) : null
208
+ ]
209
+ }
210
+ );
211
+ }
212
+ export {
213
+ ListDetail,
214
+ ListDetailDetail,
215
+ ListDetailDetailHeader,
216
+ ListDetailItem,
217
+ ListDetailList,
218
+ ListDetailMeta,
219
+ ListDetailTitle,
220
+ useListDetail
221
+ };
@@ -0,0 +1 @@
1
+ export { Note, type NoteProps, type NoteTone } from "./note.js";
@@ -0,0 +1,4 @@
1
+ import { Note } from "./note.js";
2
+ export {
3
+ Note
4
+ };
@@ -0,0 +1,13 @@
1
+ import type { ComponentPropsWithoutRef } from "react";
2
+ export type NoteTone = "neutral" | "info" | "success" | "warning" | "danger";
3
+ export interface NoteProps extends ComponentPropsWithoutRef<"p"> {
4
+ /** Colors the text. Defaults to `neutral`. */
5
+ tone?: NoteTone;
6
+ /** Hairline above the note, to hang it under a block it explains. */
7
+ divider?: boolean;
8
+ }
9
+ /**
10
+ * Small annotated text under a block: explains a rule, a caveat or an empty state. Flush to its
11
+ * container's inline edges; tone only changes the text color, so it never carries meaning alone.
12
+ */
13
+ export declare function Note({ tone, divider, className, ...props }: NoteProps): import("react").JSX.Element;
@@ -0,0 +1,27 @@
1
+ import { jsx } from "react/jsx-runtime";
2
+ import { cn } from "../../utils/cn.js";
3
+ const toneClasses = {
4
+ neutral: "text-ink-3",
5
+ info: "text-info",
6
+ success: "text-success",
7
+ warning: "text-warning",
8
+ danger: "text-danger"
9
+ };
10
+ function Note({ tone = "neutral", divider = false, className, ...props }) {
11
+ return /* @__PURE__ */ jsx(
12
+ "p",
13
+ {
14
+ "data-tone": tone,
15
+ className: cn(
16
+ "m-0 text-meta",
17
+ divider && "border-t-divider pt-2.5",
18
+ toneClasses[tone],
19
+ className
20
+ ),
21
+ ...props
22
+ }
23
+ );
24
+ }
25
+ export {
26
+ Note
27
+ };
@@ -0,0 +1 @@
1
+ export { Section, type SectionActionsProps, type SectionBodyProps, type SectionCountProps, type SectionDescriptionProps, type SectionHeaderProps, type SectionPart, type SectionProps, type SectionTitleProps, } from "./section.js";
@@ -0,0 +1,6 @@
1
+ import {
2
+ Section
3
+ } from "./section.js";
4
+ export {
5
+ Section
6
+ };
@@ -0,0 +1,68 @@
1
+ import { type ComponentPropsWithoutRef, type ReactNode } from "react";
2
+ import type { ClassNames } from "../../utils/class-names.js";
3
+ type SectionHeadingTag = "h2" | "h3" | "h4" | "h5" | "h6";
4
+ export type SectionPart = "root" | "header" | "heading" | "title" | "count" | "description" | "actions" | "body";
5
+ export interface SectionProps extends Omit<ComponentPropsWithoutRef<"section">, "title"> {
6
+ as?: "section" | "div" | "article";
7
+ title?: ReactNode;
8
+ /** Outlined count next to the title (a record total, say). */
9
+ count?: ReactNode;
10
+ description?: ReactNode;
11
+ /** Slot at the end of the header row; takes the full row under 560px of the section's own width. */
12
+ actions?: ReactNode;
13
+ /** Heading element of the title. Defaults to `h2`, one level deeper per nested section. */
14
+ titleAs?: SectionHeadingTag;
15
+ /** Hairline above the section. */
16
+ divider?: boolean;
17
+ /** Vertical padding around the body. Defaults to `true`; `false` leaves the body edge to edge. */
18
+ padded?: boolean;
19
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
20
+ classNames?: ClassNames<SectionPart>;
21
+ }
22
+ /**
23
+ * A titled block of a page: a header row (title, count, description, actions) and a body.
24
+ * It never pads the inline edges (the page layout owns the gutter), and sections nest without
25
+ * stacking: each titled level steps its heading down and its vertical spacing tighter, while a
26
+ * titleless wrapper takes no level at all. Named by its title when it has one.
27
+ *
28
+ * Two ways to fill it, which mix: the props (`title`, `count`, `description`, `actions`, with the
29
+ * children as the body) or the parts `Section.Header`, `Section.Title`, `Section.Count`,
30
+ * `Section.Description`, `Section.Actions` and `Section.Body`. As soon as a part is a direct
31
+ * child, the children are rendered as written and the body is wherever you place `Section.Body`.
32
+ */
33
+ export declare function Section({ as, title, count, description, actions, titleAs, divider, padded, className, classNames, children, ...props }: SectionProps): import("react").JSX.Element;
34
+ export declare namespace Section {
35
+ var Header: typeof SectionHeader;
36
+ var Title: typeof SectionTitle;
37
+ var Count: typeof SectionCount;
38
+ var Description: typeof SectionDescription;
39
+ var Actions: typeof SectionActions;
40
+ var Body: typeof SectionBody;
41
+ }
42
+ export interface SectionHeaderProps extends ComponentPropsWithoutRef<"div"> {
43
+ }
44
+ /** Header row of a composed `Section`: title, count and description wrap, actions go to the end. */
45
+ export declare function SectionHeader({ className, ...props }: SectionHeaderProps): import("react").JSX.Element;
46
+ export interface SectionTitleProps extends ComponentPropsWithoutRef<"h2"> {
47
+ /** Heading element. Defaults to `h2`, one level deeper per enclosing titled section. */
48
+ as?: SectionHeadingTag | undefined;
49
+ }
50
+ /** Heading of a composed `Section`; it names the section and takes the level its depth implies. */
51
+ export declare function SectionTitle({ as, className, ...props }: SectionTitleProps): import("react").JSX.Element;
52
+ export interface SectionCountProps extends ComponentPropsWithoutRef<"span"> {
53
+ }
54
+ /** Outlined count next to the title. */
55
+ export declare function SectionCount({ className, ...props }: SectionCountProps): import("react").JSX.Element;
56
+ export interface SectionDescriptionProps extends ComponentPropsWithoutRef<"p"> {
57
+ }
58
+ export declare function SectionDescription({ className, ...props }: SectionDescriptionProps): import("react").JSX.Element;
59
+ export interface SectionActionsProps extends ComponentPropsWithoutRef<"div"> {
60
+ }
61
+ /** Slot at the end of the header; takes the full row under 560px of the section's own width. */
62
+ export declare function SectionActions({ className, ...props }: SectionActionsProps): import("react").JSX.Element;
63
+ export interface SectionBodyProps extends ComponentPropsWithoutRef<"div"> {
64
+ /** Vertical padding. Defaults to the section's `padded`. */
65
+ padded?: boolean | undefined;
66
+ }
67
+ export declare function SectionBody({ padded, className, ...props }: SectionBodyProps): import("react").JSX.Element;
68
+ export {};