@jcsoftdev/ui 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (268) hide show
  1. package/CHANGELOG.md +103 -1
  2. package/README.md +55 -2
  3. package/bin/ui-theme.mjs +13 -2
  4. package/dist/atoms/checkbox/checkbox.js +3 -1
  5. package/dist/atoms/chip/chip.d.ts +11 -3
  6. package/dist/atoms/chip/chip.js +8 -1
  7. package/dist/atoms/chip/index.d.ts +1 -1
  8. package/dist/atoms/chip/index.js +2 -0
  9. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  10. package/dist/atoms/due-chip/due-chip.js +41 -0
  11. package/dist/atoms/due-chip/index.d.ts +2 -0
  12. package/dist/atoms/due-chip/index.js +6 -0
  13. package/dist/atoms/due-chip/model.d.ts +25 -0
  14. package/dist/atoms/due-chip/model.js +44 -0
  15. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  16. package/dist/atoms/icon-button/icon-button.js +38 -0
  17. package/dist/atoms/icon-button/index.d.ts +1 -0
  18. package/dist/atoms/icon-button/index.js +8 -0
  19. package/dist/atoms/index.d.ts +5 -0
  20. package/dist/atoms/index.js +5 -0
  21. package/dist/atoms/internal/hit-area.d.ts +6 -0
  22. package/dist/atoms/internal/hit-area.js +4 -0
  23. package/dist/atoms/kbd/index.d.ts +1 -0
  24. package/dist/atoms/kbd/index.js +4 -0
  25. package/dist/atoms/kbd/kbd.d.ts +7 -0
  26. package/dist/atoms/kbd/kbd.js +17 -0
  27. package/dist/atoms/radio-group/radio-group.js +6 -2
  28. package/dist/atoms/seal/index.d.ts +1 -0
  29. package/dist/atoms/seal/index.js +4 -0
  30. package/dist/atoms/seal/seal.d.ts +30 -0
  31. package/dist/atoms/seal/seal.js +71 -0
  32. package/dist/atoms/spinner/index.d.ts +1 -0
  33. package/dist/atoms/spinner/index.js +5 -0
  34. package/dist/atoms/spinner/spinner.d.ts +19 -0
  35. package/dist/atoms/spinner/spinner.js +31 -0
  36. package/dist/atoms/switch/switch.js +3 -1
  37. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  38. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  39. package/dist/calendar/date-calendar/index.d.ts +1 -0
  40. package/dist/calendar/date-calendar/index.js +6 -0
  41. package/dist/calendar/index.d.ts +1 -0
  42. package/dist/calendar/index.js +1 -0
  43. package/dist/calendar/internal/date-utils.d.ts +26 -0
  44. package/dist/calendar/internal/date-utils.js +95 -1
  45. package/dist/containers/aside/aside.d.ts +14 -0
  46. package/dist/containers/aside/aside.js +25 -0
  47. package/dist/containers/aside/index.d.ts +1 -0
  48. package/dist/containers/aside/index.js +5 -0
  49. package/dist/containers/banner/banner.d.ts +4 -1
  50. package/dist/containers/banner/banner.js +9 -1
  51. package/dist/containers/description-list/description-list.d.ts +29 -6
  52. package/dist/containers/description-list/description-list.js +47 -6
  53. package/dist/containers/feed/feed.d.ts +23 -0
  54. package/dist/containers/feed/feed.js +77 -0
  55. package/dist/containers/feed/index.d.ts +2 -0
  56. package/dist/containers/feed/index.js +10 -0
  57. package/dist/containers/feed/model.d.ts +19 -0
  58. package/dist/containers/feed/model.js +38 -0
  59. package/dist/containers/index.d.ts +6 -0
  60. package/dist/containers/index.js +6 -0
  61. package/dist/containers/kpi/kpi.d.ts +50 -8
  62. package/dist/containers/kpi/kpi.js +91 -39
  63. package/dist/containers/list-detail/index.d.ts +1 -0
  64. package/dist/containers/list-detail/index.js +20 -0
  65. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  66. package/dist/containers/list-detail/list-detail.js +221 -0
  67. package/dist/containers/note/index.d.ts +1 -0
  68. package/dist/containers/note/index.js +4 -0
  69. package/dist/containers/note/note.d.ts +13 -0
  70. package/dist/containers/note/note.js +27 -0
  71. package/dist/containers/section/index.d.ts +1 -0
  72. package/dist/containers/section/index.js +6 -0
  73. package/dist/containers/section/section.d.ts +68 -0
  74. package/dist/containers/section/section.js +198 -0
  75. package/dist/containers/shortcuts/index.d.ts +1 -0
  76. package/dist/containers/shortcuts/index.js +8 -0
  77. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  78. package/dist/containers/shortcuts/shortcuts.js +50 -0
  79. package/dist/containers/table/selection.d.ts +9 -0
  80. package/dist/containers/table/selection.js +20 -0
  81. package/dist/containers/table/table.d.ts +66 -4
  82. package/dist/containers/table/table.js +128 -7
  83. package/dist/containers/timeline/index.d.ts +1 -1
  84. package/dist/containers/timeline/index.js +4 -2
  85. package/dist/containers/timeline/timeline.d.ts +32 -5
  86. package/dist/containers/timeline/timeline.js +154 -90
  87. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  88. package/dist/forms/chip-group/chip-group.js +114 -0
  89. package/dist/forms/chip-group/index.d.ts +1 -0
  90. package/dist/forms/chip-group/index.js +6 -0
  91. package/dist/forms/combobox/combobox.d.ts +60 -0
  92. package/dist/forms/combobox/combobox.js +281 -0
  93. package/dist/forms/combobox/index.d.ts +1 -0
  94. package/dist/forms/combobox/index.js +6 -0
  95. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  96. package/dist/forms/date-picker/date-picker.js +183 -0
  97. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  98. package/dist/forms/date-picker/date-time-picker.js +121 -0
  99. package/dist/forms/date-picker/index.d.ts +2 -0
  100. package/dist/forms/date-picker/index.js +10 -0
  101. package/dist/forms/date-picker/model.d.ts +35 -0
  102. package/dist/forms/date-picker/model.js +83 -0
  103. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  104. package/dist/forms/dropzone/dropzone.js +153 -23
  105. package/dist/forms/field/field.d.ts +16 -10
  106. package/dist/forms/field/field.js +41 -5
  107. package/dist/forms/index.d.ts +4 -0
  108. package/dist/forms/index.js +4 -0
  109. package/dist/forms/input/index.d.ts +1 -1
  110. package/dist/forms/input/index.js +4 -1
  111. package/dist/forms/input/input.d.ts +21 -5
  112. package/dist/forms/input/input.js +74 -9
  113. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  114. package/dist/forms/internal/listbox-items.d.ts +18 -0
  115. package/dist/forms/internal/listbox-items.js +88 -0
  116. package/dist/forms/internal/listbox.d.ts +44 -0
  117. package/dist/forms/internal/listbox.js +74 -0
  118. package/dist/forms/number-stepper/model.d.ts +16 -0
  119. package/dist/forms/number-stepper/model.js +23 -0
  120. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  121. package/dist/forms/number-stepper/number-stepper.js +86 -37
  122. package/dist/forms/select-menu/index.d.ts +1 -0
  123. package/dist/forms/select-menu/index.js +6 -0
  124. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  125. package/dist/forms/select-menu/select-menu.js +230 -0
  126. package/dist/i18n/strings.d.ts +89 -0
  127. package/dist/i18n/strings.js +54 -2
  128. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  129. package/dist/i18n/ui-strings-provider.js +6 -2
  130. package/dist/navigation/index.d.ts +1 -0
  131. package/dist/navigation/index.js +1 -0
  132. package/dist/navigation/stepper/index.d.ts +1 -1
  133. package/dist/navigation/stepper/index.js +3 -1
  134. package/dist/navigation/stepper/stepper.d.ts +8 -0
  135. package/dist/navigation/stepper/stepper.js +68 -45
  136. package/dist/navigation/tabs/index.d.ts +1 -0
  137. package/dist/navigation/tabs/index.js +6 -0
  138. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  139. package/dist/navigation/tabs/tabs-nav.js +57 -0
  140. package/dist/navigation/wizard/index.d.ts +1 -0
  141. package/dist/navigation/wizard/index.js +6 -0
  142. package/dist/navigation/wizard/model.d.ts +33 -0
  143. package/dist/navigation/wizard/model.js +34 -0
  144. package/dist/navigation/wizard/wizard.d.ts +45 -0
  145. package/dist/navigation/wizard/wizard.js +169 -0
  146. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  147. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  148. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  149. package/dist/overlays/alert-dialog/index.js +26 -0
  150. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +17 -1
  151. package/dist/overlays/dropdown-menu/dropdown-menu.js +12 -4
  152. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  153. package/dist/overlays/dropdown-menu/index.js +8 -2
  154. package/dist/overlays/index.d.ts +2 -0
  155. package/dist/overlays/index.js +2 -0
  156. package/dist/overlays/testing/index.d.ts +5 -0
  157. package/dist/overlays/testing/index.js +4 -0
  158. package/dist/overlays/toaster/index.d.ts +2 -1
  159. package/dist/overlays/toaster/index.js +4 -2
  160. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  161. package/dist/overlays/toaster/toast.d.ts +3 -0
  162. package/dist/overlays/toaster/toast.js +3 -0
  163. package/dist/overlays/toaster/toaster.d.ts +3 -0
  164. package/dist/overlays/toaster/toaster.js +36 -3
  165. package/dist/overlays/tooltip/index.d.ts +1 -0
  166. package/dist/overlays/tooltip/index.js +4 -0
  167. package/dist/overlays/tooltip/model.d.ts +10 -0
  168. package/dist/overlays/tooltip/model.js +13 -0
  169. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  170. package/dist/overlays/tooltip/tooltip.js +116 -0
  171. package/dist/primitives/use-dismissable-layer.js +1 -1
  172. package/dist/states/error-state/error-state.d.ts +6 -1
  173. package/dist/states/error-state/error-state.js +13 -9
  174. package/dist/states/skeleton/skeleton.d.ts +8 -2
  175. package/dist/states/skeleton/skeleton.js +44 -2
  176. package/package.json +2 -2
  177. package/scripts/build-theme.mjs +12 -1
  178. package/src/atoms/checkbox/checkbox.tsx +3 -1
  179. package/src/atoms/chip/chip.tsx +18 -3
  180. package/src/atoms/chip/index.ts +2 -0
  181. package/src/atoms/due-chip/due-chip.tsx +75 -0
  182. package/src/atoms/due-chip/index.ts +2 -0
  183. package/src/atoms/due-chip/model.ts +67 -0
  184. package/src/atoms/icon-button/icon-button.tsx +58 -0
  185. package/src/atoms/icon-button/index.ts +6 -0
  186. package/src/atoms/index.ts +5 -0
  187. package/src/atoms/internal/hit-area.ts +7 -0
  188. package/src/atoms/kbd/index.ts +1 -0
  189. package/src/atoms/kbd/kbd.tsx +20 -0
  190. package/src/atoms/radio-group/radio-group.tsx +8 -2
  191. package/src/atoms/seal/index.ts +1 -0
  192. package/src/atoms/seal/seal.tsx +107 -0
  193. package/src/atoms/spinner/index.ts +1 -0
  194. package/src/atoms/spinner/spinner.tsx +49 -0
  195. package/src/atoms/switch/switch.tsx +3 -1
  196. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  197. package/src/calendar/date-calendar/index.ts +5 -0
  198. package/src/calendar/index.ts +1 -0
  199. package/src/calendar/internal/date-utils.ts +115 -0
  200. package/src/containers/aside/aside.tsx +40 -0
  201. package/src/containers/aside/index.ts +1 -0
  202. package/src/containers/banner/banner.tsx +18 -1
  203. package/src/containers/description-list/description-list.tsx +85 -9
  204. package/src/containers/feed/feed.tsx +99 -0
  205. package/src/containers/feed/index.ts +8 -0
  206. package/src/containers/feed/model.ts +54 -0
  207. package/src/containers/index.ts +6 -0
  208. package/src/containers/kpi/kpi.tsx +161 -62
  209. package/src/containers/list-detail/index.ts +15 -0
  210. package/src/containers/list-detail/list-detail.tsx +293 -0
  211. package/src/containers/note/index.ts +1 -0
  212. package/src/containers/note/note.tsx +38 -0
  213. package/src/containers/section/index.ts +11 -0
  214. package/src/containers/section/section.tsx +281 -0
  215. package/src/containers/shortcuts/index.ts +6 -0
  216. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  217. package/src/containers/table/selection.ts +26 -0
  218. package/src/containers/table/table.tsx +215 -13
  219. package/src/containers/timeline/index.ts +3 -0
  220. package/src/containers/timeline/timeline.tsx +204 -93
  221. package/src/forms/chip-group/chip-group.tsx +184 -0
  222. package/src/forms/chip-group/index.ts +8 -0
  223. package/src/forms/combobox/combobox.tsx +359 -0
  224. package/src/forms/combobox/index.ts +7 -0
  225. package/src/forms/date-picker/date-picker.tsx +239 -0
  226. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  227. package/src/forms/date-picker/index.ts +10 -0
  228. package/src/forms/date-picker/model.ts +108 -0
  229. package/src/forms/dropzone/dropzone.tsx +217 -35
  230. package/src/forms/field/field.tsx +72 -7
  231. package/src/forms/index.ts +4 -0
  232. package/src/forms/input/index.ts +8 -1
  233. package/src/forms/input/input.tsx +97 -12
  234. package/src/forms/input-icon/input-icon.tsx +1 -1
  235. package/src/forms/internal/listbox-items.tsx +103 -0
  236. package/src/forms/internal/listbox.ts +124 -0
  237. package/src/forms/number-stepper/model.ts +35 -0
  238. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  239. package/src/forms/select-menu/index.ts +7 -0
  240. package/src/forms/select-menu/select-menu.tsx +280 -0
  241. package/src/i18n/strings.ts +89 -0
  242. package/src/i18n/ui-strings-provider.tsx +15 -4
  243. package/src/navigation/index.ts +1 -0
  244. package/src/navigation/stepper/index.ts +7 -1
  245. package/src/navigation/stepper/stepper.tsx +41 -5
  246. package/src/navigation/tabs/index.ts +7 -0
  247. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  248. package/src/navigation/wizard/index.ts +7 -0
  249. package/src/navigation/wizard/model.ts +61 -0
  250. package/src/navigation/wizard/wizard.tsx +222 -0
  251. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  252. package/src/overlays/alert-dialog/index.ts +19 -0
  253. package/src/overlays/dropdown-menu/dropdown-menu.tsx +29 -4
  254. package/src/overlays/dropdown-menu/index.ts +3 -0
  255. package/src/overlays/index.ts +2 -0
  256. package/src/overlays/testing/index.ts +5 -0
  257. package/src/overlays/toaster/index.ts +2 -0
  258. package/src/overlays/toaster/toast-store.ts +6 -2
  259. package/src/overlays/toaster/toast.ts +6 -0
  260. package/src/overlays/toaster/toaster.tsx +44 -2
  261. package/src/overlays/tooltip/index.ts +1 -0
  262. package/src/overlays/tooltip/model.ts +18 -0
  263. package/src/overlays/tooltip/tooltip.tsx +166 -0
  264. package/src/primitives/use-dismissable-layer.ts +7 -2
  265. package/src/states/error-state/error-state.tsx +19 -8
  266. package/src/states/skeleton/skeleton.tsx +68 -2
  267. package/styles/tailwind.css +33 -30
  268. package/styles/theme.css +33 -30
@@ -0,0 +1,198 @@
1
+ "use client";
2
+ import { jsx, jsxs } from "react/jsx-runtime";
3
+ import {
4
+ Children,
5
+ createContext,
6
+ isValidElement,
7
+ useContext,
8
+ useEffect,
9
+ useId,
10
+ useState
11
+ } from "react";
12
+ import { cn } from "../../utils/cn.js";
13
+ const SectionDepth = createContext(0);
14
+ const SectionPartsContext = createContext(null);
15
+ function useSectionParts(part) {
16
+ const parts = useContext(SectionPartsContext);
17
+ if (!parts) throw new Error(`Section.${part} must be rendered inside a Section`);
18
+ return parts;
19
+ }
20
+ const headingForDepth = ["h2", "h3", "h4", "h5", "h6"];
21
+ function isPart(node) {
22
+ return isValidElement(node) && [
23
+ SectionHeader,
24
+ SectionTitle,
25
+ SectionCount,
26
+ SectionDescription,
27
+ SectionActions,
28
+ SectionBody
29
+ ].includes(node.type);
30
+ }
31
+ const ignoreTitle = () => {
32
+ };
33
+ function hasTitlePart(nodes) {
34
+ return Children.toArray(nodes).some((node) => {
35
+ if (!isValidElement(node)) return false;
36
+ if (node.type === SectionTitle) return true;
37
+ return node.type === SectionHeader && hasTitlePart(node.props.children);
38
+ });
39
+ }
40
+ function Section({
41
+ as = "section",
42
+ title,
43
+ count,
44
+ description,
45
+ actions,
46
+ titleAs,
47
+ divider = false,
48
+ padded = true,
49
+ className,
50
+ classNames,
51
+ children,
52
+ ...props
53
+ }) {
54
+ const outerDepth = useContext(SectionDepth);
55
+ const titleId = useId();
56
+ const [registered, setRegistered] = useState(false);
57
+ const Tag = as;
58
+ const composed = Children.toArray(children).some(isPart);
59
+ const hasTitle = title !== void 0 || composed && (registered || hasTitlePart(children));
60
+ const hasHeader = title !== void 0 || count !== void 0 || description !== void 0 || actions !== void 0;
61
+ const named = hasTitle && as !== "div";
62
+ return /* @__PURE__ */ jsx(SectionDepth.Provider, { value: outerDepth + (hasTitle ? 1 : 0), children: /* @__PURE__ */ jsx(
63
+ SectionPartsContext.Provider,
64
+ {
65
+ value: {
66
+ depth: outerDepth,
67
+ titleId,
68
+ classNames,
69
+ padded,
70
+ registerTitle: composed ? setRegistered : ignoreTitle
71
+ },
72
+ children: /* @__PURE__ */ jsxs(
73
+ Tag,
74
+ {
75
+ ...props,
76
+ "data-depth": outerDepth,
77
+ "aria-labelledby": named && props["aria-label"] === void 0 ? titleId : void 0,
78
+ className: cn(
79
+ "@container/section min-w-0",
80
+ divider && "border-t-divider",
81
+ classNames?.root,
82
+ className
83
+ ),
84
+ children: [
85
+ hasHeader ? /* @__PURE__ */ jsxs(SectionHeader, { children: [
86
+ title !== void 0 ? /* @__PURE__ */ jsx(SectionTitle, { as: titleAs, children: title }) : null,
87
+ count !== void 0 ? /* @__PURE__ */ jsx(SectionCount, { children: count }) : null,
88
+ description !== void 0 ? /* @__PURE__ */ jsx(SectionDescription, { children: description }) : null,
89
+ actions !== void 0 ? /* @__PURE__ */ jsx(SectionActions, { children: actions }) : null
90
+ ] }) : null,
91
+ composed ? children : /* @__PURE__ */ jsx(SectionBody, { children })
92
+ ]
93
+ }
94
+ )
95
+ }
96
+ ) });
97
+ }
98
+ function SectionHeader({ className, ...props }) {
99
+ const { depth, classNames } = useSectionParts("Header");
100
+ return /* @__PURE__ */ jsx(
101
+ "div",
102
+ {
103
+ ...props,
104
+ className: cn(
105
+ "flex flex-wrap items-center gap-x-2.5 gap-y-1.5",
106
+ depth > 0 ? "pt-2 pb-1.5" : "pt-3.5 pb-2.5",
107
+ classNames?.header,
108
+ className
109
+ )
110
+ }
111
+ );
112
+ }
113
+ function SectionTitle({ as, className, ...props }) {
114
+ const { depth, titleId, classNames, registerTitle } = useSectionParts("Title");
115
+ useEffect(() => {
116
+ registerTitle(true);
117
+ return () => registerTitle(false);
118
+ }, [registerTitle]);
119
+ const Heading = as ?? headingForDepth[Math.min(depth, headingForDepth.length - 1)] ?? "h2";
120
+ return /* @__PURE__ */ jsx(
121
+ Heading,
122
+ {
123
+ id: titleId,
124
+ ...props,
125
+ className: cn(
126
+ "m-0 min-w-0 font-semibold text-ink",
127
+ depth > 0 ? "text-control" : "text-body",
128
+ classNames?.title,
129
+ classNames?.heading,
130
+ className
131
+ )
132
+ }
133
+ );
134
+ }
135
+ function SectionCount({ className, ...props }) {
136
+ const { classNames } = useSectionParts("Count");
137
+ return /* @__PURE__ */ jsx(
138
+ "span",
139
+ {
140
+ ...props,
141
+ className: cn(
142
+ "rounded-pill border-divider px-1.75 text-count text-ink-3 tabular-nums",
143
+ classNames?.count,
144
+ className
145
+ )
146
+ }
147
+ );
148
+ }
149
+ function SectionDescription({ className, ...props }) {
150
+ const { classNames } = useSectionParts("Description");
151
+ return /* @__PURE__ */ jsx(
152
+ "p",
153
+ {
154
+ ...props,
155
+ className: cn("m-0 min-w-0 text-meta text-ink-3", classNames?.description, className)
156
+ }
157
+ );
158
+ }
159
+ function SectionActions({ className, ...props }) {
160
+ const { classNames } = useSectionParts("Actions");
161
+ return /* @__PURE__ */ jsx(
162
+ "div",
163
+ {
164
+ ...props,
165
+ className: cn(
166
+ "ml-auto flex flex-wrap items-center gap-2 @max-[560px]/section:ml-0 @max-[560px]/section:w-full",
167
+ classNames?.actions,
168
+ className
169
+ )
170
+ }
171
+ );
172
+ }
173
+ function SectionBody({ padded, className, ...props }) {
174
+ const { depth, classNames, padded: rootPadded } = useSectionParts("Body");
175
+ const pad = padded ?? rootPadded;
176
+ return /* @__PURE__ */ jsx(
177
+ "div",
178
+ {
179
+ ...props,
180
+ className: cn("min-w-0", pad && (depth > 0 ? "py-2" : "py-4"), classNames?.body, className)
181
+ }
182
+ );
183
+ }
184
+ Section.Header = SectionHeader;
185
+ Section.Title = SectionTitle;
186
+ Section.Count = SectionCount;
187
+ Section.Description = SectionDescription;
188
+ Section.Actions = SectionActions;
189
+ Section.Body = SectionBody;
190
+ export {
191
+ Section,
192
+ SectionActions,
193
+ SectionBody,
194
+ SectionCount,
195
+ SectionDescription,
196
+ SectionHeader,
197
+ SectionTitle
198
+ };
@@ -0,0 +1 @@
1
+ export { Shortcuts, ShortcutsItem, type ShortcutsItemProps, type ShortcutsProps, } from "./shortcuts.js";
@@ -0,0 +1,8 @@
1
+ import {
2
+ Shortcuts,
3
+ ShortcutsItem
4
+ } from "./shortcuts.js";
5
+ export {
6
+ Shortcuts,
7
+ ShortcutsItem
8
+ };
@@ -0,0 +1,18 @@
1
+ import { type ComponentPropsWithoutRef, type ReactNode } from "react";
2
+ export type ShortcutsProps = ComponentPropsWithoutRef<"ul">;
3
+ /** A short list of quick links or actions, flush to its container. Items go in `ShortcutsItem`. */
4
+ export declare function Shortcuts({ className, ...props }: ShortcutsProps): import("react").JSX.Element;
5
+ export interface ShortcutsItemProps extends ComponentPropsWithoutRef<"a"> {
6
+ /** Decorative glyph before the label. */
7
+ icon?: ReactNode;
8
+ /** Keyboard hint at the end (`G P`, `⌘K`). */
9
+ kbd?: string;
10
+ /** Count or badge at the end. */
11
+ count?: ReactNode;
12
+ /**
13
+ * Renders the single child element (a router `Link`, say) with the item's look instead of an
14
+ * anchor. Without `href` and without `asChild` the item is a `<button>`.
15
+ */
16
+ asChild?: boolean;
17
+ }
18
+ export declare function ShortcutsItem({ icon, kbd, count, asChild, href, className, children, ...props }: ShortcutsItemProps): import("react").JSX.Element;
@@ -0,0 +1,50 @@
1
+ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
2
+ import {
3
+ cloneElement,
4
+ isValidElement
5
+ } from "react";
6
+ import { Kbd } from "../../atoms/kbd/kbd.js";
7
+ import { cn } from "../../utils/cn.js";
8
+ import { Slot } from "../../utils/slot.js";
9
+ function Shortcuts({ className, ...props }) {
10
+ return /* @__PURE__ */ jsx("ul", { className: cn("m-0 flex list-none flex-col gap-0.5 p-0", className), ...props });
11
+ }
12
+ const itemClasses = "flex min-h-control-sm w-full cursor-pointer items-center gap-2 rounded-button px-2 text-start text-fs-130 text-ink-2 no-underline hover:bg-surface-2 hover:text-ink focus-visible:focus-ring in-data-[density=touch]:min-h-11";
13
+ function ShortcutsItem({
14
+ icon,
15
+ kbd,
16
+ count,
17
+ asChild = false,
18
+ href,
19
+ className,
20
+ children,
21
+ ...props
22
+ }) {
23
+ const content = (label) => /* @__PURE__ */ jsxs(Fragment, { children: [
24
+ icon !== void 0 ? /* @__PURE__ */ jsx("span", { "aria-hidden": "true", className: "inline-flex shrink-0 text-ink-3 [&_svg]:size-4", children: icon }) : null,
25
+ /* @__PURE__ */ jsx("span", { className: "min-w-0 flex-1 truncate", children: label }),
26
+ count !== void 0 ? /* @__PURE__ */ jsx("span", { className: "text-count text-ink-3 tabular-nums", children: count }) : null,
27
+ kbd !== void 0 ? /* @__PURE__ */ jsx(Kbd, { children: kbd }) : null
28
+ ] });
29
+ const classes = cn(itemClasses, className);
30
+ if (asChild && isValidElement(children)) {
31
+ const child = children;
32
+ return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(Slot, { className: classes, ...props, children: cloneElement(child, void 0, content(child.props.children)) }) });
33
+ }
34
+ if (href === void 0 && !asChild) {
35
+ return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(
36
+ "button",
37
+ {
38
+ type: "button",
39
+ className: classes,
40
+ ...props,
41
+ children: content(children)
42
+ }
43
+ ) });
44
+ }
45
+ return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("a", { href, className: classes, ...props, children: content(children) }) });
46
+ }
47
+ export {
48
+ Shortcuts,
49
+ ShortcutsItem
50
+ };
@@ -0,0 +1,9 @@
1
+ export type SelectAllState = boolean | "indeterminate";
2
+ /** Adds the key when absent, removes it when present. Order of the other keys is kept. */
3
+ export declare function toggleKey(keys: readonly string[], key: string): string[];
4
+ /** Adds (`on`) or removes (`!on`) many keys at once, without duplicates. */
5
+ export declare function setKeys(keys: readonly string[], many: readonly string[], on: boolean): string[];
6
+ /** `true` when every visible key is selected, `"indeterminate"` when only some are, else `false`. */
7
+ export declare function selectAllState(keys: readonly string[], visible: readonly string[]): SelectAllState;
8
+ /** Fills `{row}` in a "Select {row}" template. */
9
+ export declare function formatSelectRow(template: string, row: string): string;
@@ -0,0 +1,20 @@
1
+ function toggleKey(keys, key) {
2
+ return keys.includes(key) ? keys.filter((current) => current !== key) : [...keys, key];
3
+ }
4
+ function setKeys(keys, many, on) {
5
+ return on ? [.../* @__PURE__ */ new Set([...keys, ...many])] : keys.filter((current) => !many.includes(current));
6
+ }
7
+ function selectAllState(keys, visible) {
8
+ const count = visible.filter((key) => keys.includes(key)).length;
9
+ if (visible.length > 0 && count === visible.length) return true;
10
+ return count > 0 ? "indeterminate" : false;
11
+ }
12
+ function formatSelectRow(template, row) {
13
+ return template.replace("{row}", row).trim();
14
+ }
15
+ export {
16
+ formatSelectRow,
17
+ selectAllState,
18
+ setKeys,
19
+ toggleKey
20
+ };
@@ -1,10 +1,16 @@
1
- import { type ComponentPropsWithoutRef, type ReactNode } from "react";
1
+ import { type ComponentPropsWithoutRef, type CSSProperties, type ReactNode } from "react";
2
2
  import { type PinnedColumns } from "./pin.js";
3
3
  export type { PinnedColumns, PinSide } from "./pin.js";
4
4
  export interface TableLabels {
5
5
  pinLeft: string;
6
6
  pinRight: string;
7
7
  unpin: string;
8
+ /** Name of a row checkbox; `{row}` is replaced by the cell's `label`. Defaults to the UI string. */
9
+ selectRow?: string;
10
+ /** Name of the select-all checkbox. Defaults to the UI string. */
11
+ selectAll?: string;
12
+ /** Name of the overflow menu trigger of a `TableActionsCell`. Defaults to the UI string. */
13
+ rowActions?: string;
8
14
  }
9
15
  export interface TableProps extends ComponentPropsWithoutRef<"table"> {
10
16
  /** Controlled pinned columns (ids of `columnId`). Pair it with `onPinnedColumnsChange`. */
@@ -21,13 +27,32 @@ export interface TableProps extends ComponentPropsWithoutRef<"table"> {
21
27
  labels?: Partial<TableLabels>;
22
28
  /** Classes of the scroll wrapper. */
23
29
  wrapperClassName?: string;
30
+ /**
31
+ * Drops the outer cell padding of the first (`"start"`), last (`"end"`) or both (`true`) columns,
32
+ * so their content sits on the container edge and the page layout owns the gutter. The padding
33
+ * between columns stays.
34
+ */
35
+ flush?: boolean | "start" | "end";
36
+ /**
37
+ * Keeps the header row in view while the body scrolls. It sticks inside the scroll wrapper, so
38
+ * give the table a `maxHeight` (or a bounded `wrapperClassName`) for it to have anything to scroll.
39
+ */
40
+ stickyHeader?: boolean;
41
+ /** Caps the wrapper height; the body scrolls vertically past it. Any CSS length. */
42
+ maxHeight?: CSSProperties["maxHeight"];
43
+ /** Controlled selected row keys (the `rowKey` of each `TableRow`). Setting it turns selection on. */
44
+ selectedKeys?: readonly string[];
45
+ /** Initial selected keys when uncontrolled. Setting it turns selection on. */
46
+ defaultSelectedKeys?: readonly string[];
47
+ /** Called with the next keys. Setting it turns selection on. */
48
+ onSelectedKeysChange?: (keys: string[]) => void;
24
49
  }
25
50
  /**
26
51
  * Table inside its own horizontal scroll wrapper. Give columns a `columnId` (header and cells)
27
52
  * and mark header cells `pinnable` to let the user pin them to the left or right edge: pinned
28
53
  * columns stay sticky while the rest scrolls.
29
54
  */
30
- export declare function Table({ className, wrapperClassName, pinnedColumns, defaultPinnedColumns, onPinnedColumnsChange, pinStorageKey, labels, ...props }: TableProps): import("react").JSX.Element;
55
+ export declare function Table({ className, wrapperClassName, pinnedColumns, defaultPinnedColumns, onPinnedColumnsChange, pinStorageKey, labels, flush, stickyHeader, maxHeight, selectedKeys, defaultSelectedKeys, onSelectedKeysChange, ...props }: TableProps): import("react").JSX.Element;
31
56
  export declare function TableHead(props: ComponentPropsWithoutRef<"thead">): import("react").JSX.Element;
32
57
  export declare function TableBody(props: ComponentPropsWithoutRef<"tbody">): import("react").JSX.Element;
33
58
  interface ColumnProps {
@@ -40,7 +65,42 @@ interface AlignProps extends ColumnProps {
40
65
  export declare function TableHeaderCell({ className, alignRight, columnId, pinnable, children, style, ...props }: ComponentPropsWithoutRef<"th"> & AlignProps & {
41
66
  pinnable?: boolean;
42
67
  }): ReactNode;
43
- export declare function TableRow({ className, ...props }: ComponentPropsWithoutRef<"tr">): import("react").JSX.Element;
68
+ export interface TableRowProps extends ComponentPropsWithoutRef<"tr"> {
69
+ /**
70
+ * Identifies the row for selection. In a table with selection the row reports `aria-selected`
71
+ * and highlights when its key is selected.
72
+ */
73
+ rowKey?: string;
74
+ }
75
+ export declare function TableRow({ className, rowKey, ...props }: TableRowProps): import("react").JSX.Element;
76
+ export interface TableSelectCellProps extends ComponentPropsWithoutRef<"td"> {
77
+ /** Key of the row, the same as the row's `rowKey`. */
78
+ rowKey: string;
79
+ /** Names the checkbox: "Select {label}". Defaults to the key. */
80
+ label?: string;
81
+ }
82
+ /** Cell with the checkbox that selects its row. Needs a `Table` with selection props. */
83
+ export declare function TableSelectCell({ rowKey, label, className, ...props }: TableSelectCellProps): import("react").JSX.Element;
84
+ export interface TableSelectAllCellProps extends ComponentPropsWithoutRef<"th"> {
85
+ /** Keys of the rows on screen. The box is checked when all are selected, mixed when some are. */
86
+ rowKeys: readonly string[];
87
+ }
88
+ /** Header cell with the select-all checkbox for the rows on screen. */
89
+ export declare function TableSelectAllCell({ rowKeys, className, ...props }: TableSelectAllCellProps): import("react").JSX.Element;
90
+ export interface TableActionsCellProps extends ComponentPropsWithoutRef<"td"> {
91
+ /**
92
+ * An overflow menu (a `DropdownMenu` with a trigger, say). When set, it replaces the inline
93
+ * actions under a narrow table container (under 48rem of the wrapper's own width), so the
94
+ * actions never clip or wrap. Without it the inline actions wrap and stay right-aligned.
95
+ */
96
+ menu?: ReactNode;
97
+ }
98
+ /**
99
+ * Right-aligned cell for row actions (buttons, links). Inline actions wrap onto more lines under
100
+ * a narrow table container instead of clipping; pass `menu` to collapse them into an overflow
101
+ * menu there. The container query is on the table wrapper, never the viewport.
102
+ */
103
+ export declare function TableActionsCell({ menu, className, children, ...props }: TableActionsCellProps): import("react").JSX.Element;
44
104
  export declare function TableCell({ className, alignRight, columnId, style, ...props }: ComponentPropsWithoutRef<"td"> & AlignProps): import("react").JSX.Element;
45
105
  export interface TableLinkRowProps extends Omit<ComponentPropsWithoutRef<"tr">, "children"> {
46
106
  /** Row destination: rendered as a real `<a href>` in the first cell. */
@@ -49,6 +109,8 @@ export interface TableLinkRowProps extends Omit<ComponentPropsWithoutRef<"tr">,
49
109
  primary: ReactNode;
50
110
  /** `columnId` of the first cell, so that column can be pinned. */
51
111
  primaryColumnId?: string;
112
+ /** Selection key of the row; see `TableRow`. */
113
+ rowKey?: string;
52
114
  /** Additional `<td>` cells of the row. */
53
115
  children?: ReactNode;
54
116
  }
@@ -57,4 +119,4 @@ export interface TableLinkRowProps extends Omit<ComponentPropsWithoutRef<"tr">,
57
119
  * stretched link (positioned `<tr>` + anchor `::before` at `inset-0`), its
58
120
  * click area covers the whole row without duplicating the link per cell.
59
121
  */
60
- export declare function TableLinkRow({ href, primary, primaryColumnId, children, className, ...props }: TableLinkRowProps): import("react").JSX.Element;
122
+ export declare function TableLinkRow({ href, primary, primaryColumnId, rowKey, children, className, ...props }: TableLinkRowProps): import("react").JSX.Element;
@@ -9,20 +9,28 @@ import {
9
9
  useRef,
10
10
  useState
11
11
  } from "react";
12
+ import { Checkbox } from "../../atoms/checkbox/checkbox.js";
13
+ import { useUiStrings } from "../../i18n/index.js";
12
14
  import { ArrowLeftToLine, ArrowRightToLine, PinOff } from "../../icons/index.js";
13
15
  import { cn } from "../../utils/cn.js";
16
+ import { useControllableState } from "../../utils/use-controllable-state.js";
14
17
  import {
15
18
  computePinOffsets,
16
19
  parseStoredPins,
17
20
  sanitizePinned,
18
21
  setColumnPin
19
22
  } from "./pin.js";
23
+ import { formatSelectRow, selectAllState, setKeys, toggleKey } from "./selection.js";
20
24
  const DEFAULT_LABELS = {
21
25
  pinLeft: "Fijar a la izquierda",
22
26
  pinRight: "Fijar a la derecha",
23
27
  unpin: "Desfijar"
24
28
  };
25
29
  const PinContext = createContext(null);
30
+ const SelectionContext = createContext(null);
31
+ const FLUSH_START = "[&_:is(th,td):first-child]:pl-0 [&_td:first-child>a]:pl-0";
32
+ const FLUSH_END = "[&_:is(th,td):last-child]:pr-0 [&_td:last-child>a]:pr-0";
33
+ const STICKY_HEADER = "[&_thead_th]:sticky [&_thead_th]:top-0 [&_thead_th]:z-2 [&_thead_th]:bg-surface [&_thead_th]:shadow-[inset_0_-1px_0_var(--border-color-divider)]";
26
34
  function readStorage(key) {
27
35
  try {
28
36
  return window.localStorage.getItem(key);
@@ -47,8 +55,21 @@ function Table({
47
55
  onPinnedColumnsChange,
48
56
  pinStorageKey,
49
57
  labels,
58
+ flush,
59
+ stickyHeader,
60
+ maxHeight,
61
+ selectedKeys,
62
+ defaultSelectedKeys,
63
+ onSelectedKeysChange,
50
64
  ...props
51
65
  }) {
66
+ const strings = useUiStrings();
67
+ const selectionOn = selectedKeys !== void 0 || defaultSelectedKeys !== void 0 || onSelectedKeysChange !== void 0;
68
+ const [selected, setSelected] = useControllableState({
69
+ prop: selectedKeys,
70
+ defaultProp: defaultSelectedKeys ?? [],
71
+ onChange: onSelectedKeysChange ? (keys) => onSelectedKeysChange([...keys]) : void 0
72
+ });
52
73
  const wrapperRef = useRef(null);
53
74
  const tableRef = useRef(null);
54
75
  const controlled = pinnedColumns !== void 0;
@@ -129,22 +150,45 @@ function Table({
129
150
  labels: { ...DEFAULT_LABELS, ...labels },
130
151
  pin
131
152
  };
132
- return /* @__PURE__ */ jsx(PinContext.Provider, { value: context, children: /* @__PURE__ */ jsx(
153
+ const selection = selectionOn ? {
154
+ selected,
155
+ toggle: (key) => setSelected(toggleKey(selected, key)),
156
+ setMany: (keys, on) => setSelected(setKeys(selected, keys, on)),
157
+ labels: {
158
+ ...context.labels,
159
+ selectRow: labels?.selectRow ?? strings.selectRow,
160
+ selectAll: labels?.selectAll ?? strings.selectAll,
161
+ rowActions: labels?.rowActions ?? strings.rowActions
162
+ }
163
+ } : null;
164
+ return /* @__PURE__ */ jsx(PinContext.Provider, { value: context, children: /* @__PURE__ */ jsx(SelectionContext.Provider, { value: selection, children: /* @__PURE__ */ jsx(
133
165
  "div",
134
166
  {
135
167
  ref: wrapperRef,
136
168
  onScroll: measure,
137
- className: cn("@container/table max-w-full overflow-x-auto", wrapperClassName),
169
+ style: maxHeight !== void 0 ? { maxHeight } : void 0,
170
+ tabIndex: maxHeight !== void 0 ? 0 : void 0,
171
+ className: cn(
172
+ "@container/table max-w-full overflow-x-auto",
173
+ maxHeight !== void 0 && "overflow-y-auto focus-visible:focus-ring",
174
+ wrapperClassName
175
+ ),
138
176
  children: /* @__PURE__ */ jsx(
139
177
  "table",
140
178
  {
141
179
  ref: tableRef,
142
- className: cn("w-full border-collapse text-fs-130", className),
180
+ className: cn(
181
+ "w-full border-collapse text-fs-130",
182
+ (flush === true || flush === "start") && FLUSH_START,
183
+ (flush === true || flush === "end") && FLUSH_END,
184
+ stickyHeader && STICKY_HEADER,
185
+ className
186
+ ),
143
187
  ...props
144
188
  }
145
189
  )
146
190
  }
147
- ) });
191
+ ) }) });
148
192
  }
149
193
  function TableHead(props) {
150
194
  return /* @__PURE__ */ jsx("thead", { ...props });
@@ -243,15 +287,83 @@ function TableHeaderCell({
243
287
  }
244
288
  );
245
289
  }
246
- function TableRow({ className, ...props }) {
290
+ function TableRow({ className, rowKey, ...props }) {
291
+ const selection = useContext(SelectionContext);
292
+ const isSelected = selection && rowKey !== void 0 ? selection.selected.includes(rowKey) : void 0;
247
293
  return /* @__PURE__ */ jsx(
248
294
  "tr",
249
295
  {
250
- className: cn("group/row border-b-divider last:border-b-0 hover:bg-surface-2", className),
296
+ "aria-selected": isSelected,
297
+ "data-selected": isSelected || void 0,
298
+ className: cn(
299
+ "group/row border-b-divider last:border-b-0 hover:bg-surface-2",
300
+ isSelected && "bg-accent-soft hover:bg-accent-soft",
301
+ className
302
+ ),
251
303
  ...props
252
304
  }
253
305
  );
254
306
  }
307
+ function TableSelectCell({ rowKey, label, className, ...props }) {
308
+ const selection = useContext(SelectionContext);
309
+ if (!selection)
310
+ throw new Error("TableSelectCell needs a Table with selectedKeys or onSelectedKeysChange");
311
+ return /* @__PURE__ */ jsx("td", { className: cn("w-px px-4 py-2.75 align-middle @max-sm/table:px-2.5", className), ...props, children: /* @__PURE__ */ jsx(
312
+ Checkbox,
313
+ {
314
+ checked: selection.selected.includes(rowKey),
315
+ onCheckedChange: () => selection.toggle(rowKey),
316
+ "aria-label": formatSelectRow(selection.labels.selectRow ?? "", label ?? rowKey)
317
+ }
318
+ ) });
319
+ }
320
+ function TableSelectAllCell({ rowKeys, className, ...props }) {
321
+ const selection = useContext(SelectionContext);
322
+ if (!selection)
323
+ throw new Error("TableSelectAllCell needs a Table with selectedKeys or onSelectedKeysChange");
324
+ const state = selectAllState(selection.selected, rowKeys);
325
+ return /* @__PURE__ */ jsx(
326
+ "th",
327
+ {
328
+ scope: "col",
329
+ className: cn(
330
+ "w-px border-b-divider px-4 py-2.5 text-left align-middle @max-sm/table:px-2.5",
331
+ className
332
+ ),
333
+ ...props,
334
+ children: /* @__PURE__ */ jsx(
335
+ Checkbox,
336
+ {
337
+ checked: state,
338
+ onCheckedChange: () => selection.setMany(rowKeys, state !== true),
339
+ "aria-label": selection.labels.selectAll
340
+ }
341
+ )
342
+ }
343
+ );
344
+ }
345
+ function TableActionsCell({ menu, className, children, ...props }) {
346
+ return /* @__PURE__ */ jsxs(
347
+ "td",
348
+ {
349
+ className: cn("w-px px-4 py-2.75 text-right align-middle @max-sm/table:px-2.5", className),
350
+ ...props,
351
+ children: [
352
+ /* @__PURE__ */ jsx(
353
+ "div",
354
+ {
355
+ className: cn(
356
+ "inline-flex items-center justify-end gap-1.5",
357
+ menu !== void 0 ? "@max-3xl/table:hidden" : "@max-3xl/table:flex-wrap"
358
+ ),
359
+ children
360
+ }
361
+ ),
362
+ menu !== void 0 ? /* @__PURE__ */ jsx("div", { className: "hidden justify-end @max-3xl/table:inline-flex", children: menu }) : null
363
+ ]
364
+ }
365
+ );
366
+ }
255
367
  function TableCell({
256
368
  className,
257
369
  alignRight,
@@ -279,16 +391,22 @@ function TableLinkRow({
279
391
  href,
280
392
  primary,
281
393
  primaryColumnId,
394
+ rowKey,
282
395
  children,
283
396
  className,
284
397
  ...props
285
398
  }) {
286
399
  const pinned = usePinnedCell(primaryColumnId, false);
400
+ const selection = useContext(SelectionContext);
401
+ const isSelected = selection && rowKey !== void 0 ? selection.selected.includes(rowKey) : void 0;
287
402
  return /* @__PURE__ */ jsxs(
288
403
  "tr",
289
404
  {
405
+ "aria-selected": isSelected,
406
+ "data-selected": isSelected || void 0,
290
407
  className: cn(
291
408
  "group/row relative border-b-divider last:border-b-0 hover:bg-surface-2",
409
+ isSelected && "bg-accent-soft hover:bg-accent-soft",
292
410
  className
293
411
  ),
294
412
  ...props,
@@ -316,10 +434,13 @@ function TableLinkRow({
316
434
  }
317
435
  export {
318
436
  Table,
437
+ TableActionsCell,
319
438
  TableBody,
320
439
  TableCell,
321
440
  TableHead,
322
441
  TableHeaderCell,
323
442
  TableLinkRow,
324
- TableRow
443
+ TableRow,
444
+ TableSelectAllCell,
445
+ TableSelectCell
325
446
  };
@@ -1 +1 @@
1
- export { Timeline, type TimelineFeedItem, type TimelineFeedTone, type TimelinePart, type TimelineProps, } from "./timeline.js";
1
+ export { Timeline, type TimelineFeedItem, type TimelineFeedTone, TimelineItem, type TimelineItemProps, type TimelinePart, type TimelineProps, type TimelineStatus, } from "./timeline.js";
@@ -1,6 +1,8 @@
1
1
  import {
2
- Timeline
2
+ Timeline,
3
+ TimelineItem
3
4
  } from "./timeline.js";
4
5
  export {
5
- Timeline
6
+ Timeline,
7
+ TimelineItem
6
8
  };