@enablo/swirlcn-ui 0.0.0-stage → 0.5.1

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 (103) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +30 -2
  3. package/dist/chunk-3DJWDNQL.js +77 -0
  4. package/dist/chunk-7XUCETA6.js +447 -0
  5. package/dist/chunk-KZESIYUN.js +18 -0
  6. package/dist/flip.d.ts +98 -0
  7. package/dist/flip.js +158 -0
  8. package/dist/fonts/Inter-italic.var.woff2 +0 -0
  9. package/dist/fonts/Inter.var.woff2 +0 -0
  10. package/dist/fonts/OFL.txt +96 -0
  11. package/dist/index.d.ts +2459 -0
  12. package/dist/index.js +8439 -0
  13. package/dist/server.d.ts +144 -0
  14. package/dist/server.js +88 -0
  15. package/dist/spacing-BQaEPbUv.d.ts +59 -0
  16. package/dist/theme.css +146 -0
  17. package/package.json +84 -3
  18. package/src/components/accordion.tsx +102 -0
  19. package/src/components/action-list.tsx +294 -0
  20. package/src/components/alert-dialog.tsx +155 -0
  21. package/src/components/autocomplete.tsx +313 -0
  22. package/src/components/avatar.tsx +258 -0
  23. package/src/components/badge.tsx +100 -0
  24. package/src/components/banner.tsx +112 -0
  25. package/src/components/button-group.tsx +87 -0
  26. package/src/components/button.tsx +362 -0
  27. package/src/components/card.tsx +186 -0
  28. package/src/components/carousel.tsx +245 -0
  29. package/src/components/checkbox.tsx +125 -0
  30. package/src/components/chip.tsx +153 -0
  31. package/src/components/color-input.tsx +98 -0
  32. package/src/components/data-cell.tsx +230 -0
  33. package/src/components/date-input.tsx +223 -0
  34. package/src/components/date-picker.tsx +276 -0
  35. package/src/components/description-list.tsx +97 -0
  36. package/src/components/dialog.tsx +405 -0
  37. package/src/components/empty-state.tsx +63 -0
  38. package/src/components/file-chip.tsx +206 -0
  39. package/src/components/file-uploader.tsx +148 -0
  40. package/src/components/flip-app-header.tsx +104 -0
  41. package/src/components/flip-brand.tsx +77 -0
  42. package/src/components/flip-theme.tsx +95 -0
  43. package/src/components/form-control.tsx +397 -0
  44. package/src/components/form-group.tsx +26 -0
  45. package/src/components/heading.tsx +70 -0
  46. package/src/components/icon.tsx +119 -0
  47. package/src/components/image-grid.tsx +285 -0
  48. package/src/components/inline-notification.tsx +167 -0
  49. package/src/components/inline-status.tsx +100 -0
  50. package/src/components/input.tsx +390 -0
  51. package/src/components/label.tsx +28 -0
  52. package/src/components/lightbox.tsx +314 -0
  53. package/src/components/link.tsx +46 -0
  54. package/src/components/list.tsx +40 -0
  55. package/src/components/menu.tsx +530 -0
  56. package/src/components/option-list.tsx +582 -0
  57. package/src/components/pagination.tsx +336 -0
  58. package/src/components/popover.tsx +194 -0
  59. package/src/components/progress.tsx +158 -0
  60. package/src/components/radio-group.tsx +136 -0
  61. package/src/components/resource-list.tsx +686 -0
  62. package/src/components/search.tsx +127 -0
  63. package/src/components/select.tsx +456 -0
  64. package/src/components/separator.tsx +93 -0
  65. package/src/components/skeleton-box.tsx +63 -0
  66. package/src/components/skeleton-text.tsx +66 -0
  67. package/src/components/spinner.tsx +83 -0
  68. package/src/components/stack.tsx +86 -0
  69. package/src/components/status-indicator.tsx +31 -0
  70. package/src/components/switch.tsx +90 -0
  71. package/src/components/table.tsx +242 -0
  72. package/src/components/tabs.tsx +147 -0
  73. package/src/components/tag.tsx +169 -0
  74. package/src/components/text.tsx +126 -0
  75. package/src/components/textarea.tsx +130 -0
  76. package/src/components/theme-provider.tsx +115 -0
  77. package/src/components/thumbnail.tsx +250 -0
  78. package/src/components/time-input.tsx +123 -0
  79. package/src/components/toast.tsx +217 -0
  80. package/src/components/toggle-group.tsx +124 -0
  81. package/src/components/toolbar.tsx +105 -0
  82. package/src/components/tooltip.tsx +97 -0
  83. package/src/components/tree-navigation.tsx +194 -0
  84. package/src/components/tree-view.tsx +292 -0
  85. package/src/flip.ts +12 -0
  86. package/src/index.ts +317 -0
  87. package/src/lib/date-mask.ts +176 -0
  88. package/src/lib/field-context.ts +86 -0
  89. package/src/lib/flip-app-script.ts +38 -0
  90. package/src/lib/flip-host.ts +84 -0
  91. package/src/lib/flip-theme-css.ts +90 -0
  92. package/src/lib/focus.ts +18 -0
  93. package/src/lib/glyphs.ts +137 -0
  94. package/src/lib/spacing.ts +93 -0
  95. package/src/lib/theme-context.ts +27 -0
  96. package/src/lib/theme-script.ts +49 -0
  97. package/src/lib/use-mobile.ts +17 -0
  98. package/src/lib/utils.ts +28 -0
  99. package/src/server.ts +20 -0
  100. package/src/styles/fonts/Inter-italic.var.woff2 +0 -0
  101. package/src/styles/fonts/Inter.var.woff2 +0 -0
  102. package/src/styles/fonts/OFL.txt +96 -0
  103. package/src/styles/theme.css +146 -0
@@ -0,0 +1,686 @@
1
+ import * as React from "react";
2
+ import { cn } from "../lib/utils";
3
+ import { Glyph } from "../lib/glyphs";
4
+ import { gap, type SwirlSpacing } from "../lib/spacing";
5
+ import { Button } from "./button";
6
+ import { InlineError } from "./inline-status";
7
+ import { Separator } from "./separator";
8
+ import { Spinner } from "./spinner";
9
+
10
+ /* ---------------------------------------------------------------- context */
11
+
12
+ interface Drag {
13
+ value: string;
14
+ from: number;
15
+ /** Item values in their previewed order, shown with CSS `order`. */
16
+ order: string[];
17
+ }
18
+
19
+ interface ResourceListContextValue {
20
+ semantics: "grid" | "list";
21
+ allowDrag: boolean;
22
+ drag: Drag | null;
23
+ startDrag: (value: string) => void;
24
+ moveDrag: (step: -1 | 1) => void;
25
+ pointerDrag: (clientY: number) => void;
26
+ endDrag: () => void;
27
+ }
28
+
29
+ const ResourceListContext = React.createContext<ResourceListContextValue | null>(null);
30
+
31
+ /** The element in each item that takes focus: its button, link or row. */
32
+ const CONTENT = "[data-resource-list-content]";
33
+ const FOCUSABLE_IN_CONTROL =
34
+ "[data-resource-list-control] :is(button, a[href], input, select, textarea, [tabindex])";
35
+
36
+ /**
37
+ * Makes item `index` the grid's one tab stop. Controls in other rows leave
38
+ * the tab order too, as in Swirl: a row's menu is reached from its row.
39
+ */
40
+ function setTabStop(list: HTMLElement, index: number) {
41
+ const contents = Array.from(list.querySelectorAll<HTMLElement>(CONTENT));
42
+ contents.forEach((el, i) => {
43
+ el.setAttribute("tabindex", i === index ? "0" : "-1");
44
+ const row = el.closest(`[${ITEM}]`) ?? el.parentElement;
45
+ row
46
+ ?.querySelectorAll<HTMLElement>(FOCUSABLE_IN_CONTROL)
47
+ .forEach((control) => control.setAttribute("tabindex", i === index ? "0" : "-1"));
48
+ });
49
+ }
50
+ const ITEM = "data-resource-list-item";
51
+
52
+ const space = (s: SwirlSpacing | undefined) => (s === undefined ? undefined : `var(--s-space-${s})`);
53
+
54
+ /* ------------------------------------------------------------------- list */
55
+
56
+ export interface ResourceListItemDrop {
57
+ value: string;
58
+ oldIndex: number;
59
+ newIndex: number;
60
+ }
61
+
62
+ export interface ResourceListProps extends React.ComponentProps<"div"> {
63
+ /** Accessible name of the list. */
64
+ label?: string;
65
+ /**
66
+ * `grid` (default) makes the list one tab stop, with the arrow keys, Home
67
+ * and End moving between items, as Swirl's does. `list` is a plain list in
68
+ * which every item is its own tab stop.
69
+ */
70
+ semantics?: "grid" | "list";
71
+ /** Space between items. */
72
+ spacing?: SwirlSpacing;
73
+ padding?: SwirlSpacing;
74
+ paddingBlockStart?: SwirlSpacing;
75
+ paddingBlockEnd?: SwirlSpacing;
76
+ /** Defaults to 8. */
77
+ paddingInlineStart?: SwirlSpacing;
78
+ /** Defaults to 8. */
79
+ paddingInlineEnd?: SwirlSpacing;
80
+ /**
81
+ * Show a drag handle on each item, to reorder by pointer or keyboard
82
+ * (Space to grab, arrows to move, Space to drop, Escape to cancel). Items
83
+ * need a `value`. The list doesn't reorder its children: apply
84
+ * `onItemDrop` to your data.
85
+ */
86
+ allowDrag?: boolean;
87
+ onItemDrop?: (drop: ResourceListItemDrop) => void;
88
+ assistiveTextItemGrabbed?: string;
89
+ assistiveTextItemMoving?: string;
90
+ assistiveTextItemMoved?: string;
91
+ }
92
+
93
+ /**
94
+ * Swirl's resource list: rows for people, files and other things, each with
95
+ * media, a label, a description, meta text, badges and a control.
96
+ *
97
+ * <ResourceList label="Members">
98
+ * <ResourceListItem label="Ada Lovelace" description="Admin"
99
+ * media={<Avatar label="Ada Lovelace" size="l" />} />
100
+ * </ResourceList>
101
+ */
102
+ export function ResourceList({
103
+ label,
104
+ semantics = "grid",
105
+ spacing = "0",
106
+ padding,
107
+ paddingBlockStart,
108
+ paddingBlockEnd,
109
+ paddingInlineStart,
110
+ paddingInlineEnd,
111
+ allowDrag = false,
112
+ onItemDrop,
113
+ assistiveTextItemGrabbed = "Item grabbed. Use arrow keys to move item up or down. Use spacebar to save position.",
114
+ assistiveTextItemMoving = "Current position:",
115
+ assistiveTextItemMoved = "Item moved. New position:",
116
+ className,
117
+ style,
118
+ onKeyDown,
119
+ onFocus,
120
+ children,
121
+ ...props
122
+ }: ResourceListProps) {
123
+ const ref = React.useRef<HTMLDivElement>(null);
124
+ const [drag, setDrag] = React.useState<Drag | null>(null);
125
+ const [assistiveText, setAssistiveText] = React.useState("");
126
+ const focused = React.useRef(0);
127
+
128
+ const contents = () => Array.from(ref.current?.querySelectorAll<HTMLElement>(CONTENT) ?? []);
129
+ const itemValues = () =>
130
+ Array.from(ref.current?.querySelectorAll<HTMLElement>(`[${ITEM}]`) ?? []).map(
131
+ (el) => el.getAttribute(ITEM)!,
132
+ );
133
+
134
+ // In a grid only one item is a tab stop. Keep that true as items come and go.
135
+ React.useEffect(() => {
136
+ const list = ref.current;
137
+ if (!list || semantics !== "grid") return;
138
+ const sync = () => {
139
+ if (focused.current >= list.querySelectorAll(CONTENT).length) focused.current = 0;
140
+ setTabStop(list, focused.current);
141
+ };
142
+ sync();
143
+ const observer = new MutationObserver(sync);
144
+ observer.observe(list, { childList: true, subtree: true });
145
+ return () => observer.disconnect();
146
+ }, [semantics]);
147
+
148
+ const focusAt = (index: number) => {
149
+ const all = contents();
150
+ const target = all[index];
151
+ if (!target) return;
152
+ if (ref.current) setTabStop(ref.current, index);
153
+ focused.current = index;
154
+ target.focus();
155
+ };
156
+
157
+ const focusItem = (value: string) =>
158
+ requestAnimationFrame(() => {
159
+ const el = ref.current?.querySelector<HTMLElement>(`[${ITEM}="${CSS.escape(value)}"] ${CONTENT}`);
160
+ const index = el ? contents().indexOf(el) : -1;
161
+ if (index >= 0) focusAt(index);
162
+ ref.current
163
+ ?.querySelector<HTMLElement>(`[${ITEM}="${CSS.escape(value)}"] [data-drag-handle]`)
164
+ ?.focus();
165
+ });
166
+
167
+ const endDrag = () => {
168
+ if (!drag) return;
169
+ setDrag(null);
170
+ const newIndex = drag.order.indexOf(drag.value);
171
+ setAssistiveText(`${assistiveTextItemMoved} ${newIndex + 1}`);
172
+ onItemDrop?.({ value: drag.value, oldIndex: drag.from, newIndex });
173
+ focusItem(drag.value);
174
+ };
175
+
176
+ const context: ResourceListContextValue = {
177
+ semantics,
178
+ allowDrag,
179
+ drag,
180
+ startDrag: (value) => {
181
+ const order = itemValues();
182
+ setDrag({ value, from: order.indexOf(value), order });
183
+ setAssistiveText(assistiveTextItemGrabbed);
184
+ },
185
+ moveDrag: (step) => {
186
+ if (!drag) return;
187
+ const to = drag.order.indexOf(drag.value) + step;
188
+ if (to < 0 || to >= drag.order.length) return;
189
+ const order = drag.order.filter((v) => v !== drag.value);
190
+ order.splice(to, 0, drag.value);
191
+ setDrag({ ...drag, order });
192
+ setAssistiveText(`${assistiveTextItemMoving} ${to + 1}`);
193
+ },
194
+ pointerDrag: (clientY) => {
195
+ if (!drag || !ref.current) return;
196
+ const others = drag.order.filter((v) => v !== drag.value);
197
+ // Slot the item after every other item whose middle is above the pointer.
198
+ const to = others.filter((v) => {
199
+ const el = ref.current!.querySelector(`[${ITEM}="${CSS.escape(v)}"]`);
200
+ if (!el) return false;
201
+ const rect = el.getBoundingClientRect();
202
+ return rect.top + rect.height / 2 < clientY;
203
+ }).length;
204
+ if (drag.order.indexOf(drag.value) === to) return;
205
+ others.splice(to, 0, drag.value);
206
+ setDrag({ ...drag, order: others });
207
+ },
208
+ endDrag,
209
+ };
210
+
211
+ return (
212
+ <ResourceListContext.Provider value={context}>
213
+ <span className="sr-only" role="alert">
214
+ {assistiveText}
215
+ </span>
216
+ <div
217
+ style={{
218
+ paddingBlockStart: space(paddingBlockStart ?? padding),
219
+ paddingBlockEnd: space(paddingBlockEnd ?? padding),
220
+ paddingInlineStart: space(paddingInlineStart ?? padding ?? "8"),
221
+ paddingInlineEnd: space(paddingInlineEnd ?? padding ?? "8"),
222
+ ...style,
223
+ }}
224
+ className={cn("w-full", className)}
225
+ >
226
+ <div
227
+ ref={ref}
228
+ role={semantics}
229
+ aria-label={label}
230
+ className={cn("flex w-full flex-col", gap(spacing))}
231
+ onFocus={(event) => {
232
+ onFocus?.(event);
233
+ // Focus anywhere in a row, its control included, makes that row the tab stop.
234
+ const row = (event.target as HTMLElement).closest(`[${ITEM}]`);
235
+ const content = row?.querySelector<HTMLElement>(CONTENT) ?? (event.target as HTMLElement);
236
+ const index = contents().indexOf(content);
237
+ if (index >= 0 && semantics === "grid" && ref.current) {
238
+ setTabStop(ref.current, index);
239
+ focused.current = index;
240
+ }
241
+ }}
242
+ onKeyDown={(event) => {
243
+ onKeyDown?.(event);
244
+ if (event.defaultPrevented || semantics !== "grid" || drag) return;
245
+ const all = contents();
246
+ const current = all.indexOf(document.activeElement as HTMLElement);
247
+ if (current < 0) return;
248
+ const target = {
249
+ ArrowDown: (current + 1) % all.length,
250
+ ArrowUp: current === 0 ? all.length - 1 : current - 1,
251
+ Home: 0,
252
+ End: all.length - 1,
253
+ }[event.key];
254
+ if (target === undefined) return;
255
+ event.preventDefault();
256
+ focusAt(target);
257
+ }}
258
+ {...props}
259
+ >
260
+ {children}
261
+ </div>
262
+ </div>
263
+ </ResourceListContext.Provider>
264
+ );
265
+ }
266
+
267
+ function useResourceList() {
268
+ return React.useContext(ResourceListContext) ?? {
269
+ semantics: "list" as const,
270
+ allowDrag: false,
271
+ drag: null,
272
+ startDrag: () => {},
273
+ moveDrag: () => {},
274
+ pointerDrag: () => {},
275
+ endDrag: () => {},
276
+ };
277
+ }
278
+
279
+ /** A row's role: a grid row, or a list item. */
280
+ function useRowRoles() {
281
+ const { semantics } = useResourceList();
282
+ return semantics === "grid"
283
+ ? ({ host: "row", cell: "gridcell" } as const)
284
+ : ({ host: "listitem", cell: undefined } as const);
285
+ }
286
+
287
+ /* ------------------------------------------------------------------- item */
288
+
289
+ export interface ResourceListItemProps
290
+ extends Omit<React.ComponentProps<"div">, "children" | "onChange"> {
291
+ label: React.ReactNode;
292
+ description?: React.ReactNode;
293
+ /** Shown before the label, such as an avatar or a thumbnail. */
294
+ media?: React.ReactNode;
295
+ /** Short text on the right, such as a date. */
296
+ meta?: React.ReactNode;
297
+ /** Badges on the right, under `meta`. */
298
+ badges?: React.ReactNode;
299
+ /**
300
+ * A control on the right, such as a menu button. With `meta` or `badges`
301
+ * it shows on hover or focus, on devices that can hover.
302
+ */
303
+ control?: React.ReactNode;
304
+ /** Makes the row a link. */
305
+ href?: string;
306
+ target?: string;
307
+ rel?: string;
308
+ onClick?: React.MouseEventHandler<HTMLElement>;
309
+ /** Whether the row is a button or link. Defaults to true. */
310
+ interactive?: boolean;
311
+ /** Show a checkbox and make the row toggle it. */
312
+ selectable?: boolean;
313
+ checked?: boolean;
314
+ onCheckedChange?: (checked: boolean) => void;
315
+ disabled?: boolean;
316
+ /** Highlight the row, as for the current page. */
317
+ active?: boolean;
318
+ compact?: boolean;
319
+ labelWeight?: "medium" | "semibold" | "bold";
320
+ /** Let the label wrap instead of truncating; `labelWrapMaxLines` clamps it. */
321
+ labelWrap?: boolean;
322
+ labelWrapMaxLines?: number;
323
+ descriptionWrap?: boolean;
324
+ alignItems?: React.CSSProperties["alignItems"];
325
+ /** Identifies the item, for dragging. */
326
+ value?: string;
327
+ /** Accessible name, when the label alone isn't enough. */
328
+ "aria-label"?: string;
329
+ "aria-current"?: React.AriaAttributes["aria-current"];
330
+ dragHandleLabel?: string;
331
+ dragHandleDescription?: string;
332
+ }
333
+
334
+ /** A row in a `ResourceList`. */
335
+ export function ResourceListItem({
336
+ label,
337
+ description,
338
+ media,
339
+ meta,
340
+ badges,
341
+ control,
342
+ href,
343
+ target,
344
+ rel,
345
+ onClick,
346
+ interactive = true,
347
+ selectable = false,
348
+ checked = false,
349
+ onCheckedChange,
350
+ disabled = false,
351
+ active = false,
352
+ compact = false,
353
+ labelWeight = "medium",
354
+ labelWrap = false,
355
+ labelWrapMaxLines,
356
+ descriptionWrap = false,
357
+ alignItems,
358
+ value: valueProp,
359
+ "aria-label": ariaLabel,
360
+ "aria-current": ariaCurrent,
361
+ dragHandleLabel = "Move item",
362
+ dragHandleDescription = "Press spacebar to toggle grab",
363
+ className,
364
+ style,
365
+ ...props
366
+ }: ResourceListItemProps) {
367
+ const list = useResourceList();
368
+ const roles = useRowRoles();
369
+ const id = React.useId();
370
+ const value = valueProp ?? id;
371
+ const isInteractive = interactive || selectable;
372
+ const Tag = !isInteractive ? "div" : href && !selectable ? "a" : "button";
373
+ const isDisabled = disabled && !href;
374
+ const showMeta = meta !== undefined || badges !== undefined;
375
+ const hideControl = control !== undefined && showMeta;
376
+ const dragging = list.drag?.value === value;
377
+ const order = list.drag ? list.drag.order.indexOf(value) : undefined;
378
+ const descriptionId = `${id}-description`;
379
+
380
+ return (
381
+ <div
382
+ role={roles.host}
383
+ {...{ [ITEM]: value }}
384
+ className="relative block w-full"
385
+ style={{ order }}
386
+ {...props}
387
+ >
388
+ <div
389
+ role={roles.cell}
390
+ className={cn(
391
+ "group/item relative flex w-full gap-3 overflow-hidden rounded-sm px-2 py-3",
392
+ compact && "p-2",
393
+ isInteractive && !isDisabled && "cursor-pointer hover:bg-state-hovered active:bg-state-pressed",
394
+ active && "bg-state-hovered",
395
+ // Focus shows on the whole row, while the button inside takes it.
396
+ "has-[[data-resource-list-content]:focus-visible]:z-1 has-[[data-resource-list-content]:focus-visible]:bg-state-hovered",
397
+ "has-[[data-resource-list-content]:focus-visible]:outline-2 has-[[data-resource-list-content]:focus-visible]:outline-focus",
398
+ "has-[[data-resource-list-content]:focus-visible]:outline-solid",
399
+ dragging &&
400
+ "z-1 rounded-s bg-state-pressed shadow-[0_0.0625rem_0.125rem_rgba(25,26,28,0.08),0_0.25rem_2rem_rgba(25,26,28,0.16)] hover:bg-state-pressed",
401
+ className,
402
+ )}
403
+ style={style}
404
+ >
405
+ <Tag
406
+ data-resource-list-content=""
407
+ {...(Tag === "a" ? { href, target, rel: rel ?? (target === "_blank" ? "noreferrer" : undefined) } : {})}
408
+ {...(Tag === "button" ? { type: "button" as const, disabled: isDisabled } : {})}
409
+ {...(Tag === "div" ? { tabIndex: list.semantics === "grid" ? -1 : undefined } : {})}
410
+ role={selectable ? "checkbox" : undefined}
411
+ aria-checked={selectable ? checked : undefined}
412
+ aria-disabled={isDisabled || undefined}
413
+ aria-current={ariaCurrent}
414
+ aria-label={ariaLabel}
415
+ aria-labelledby={ariaLabel ? undefined : `${id}-label`}
416
+ aria-describedby={description ? descriptionId : undefined}
417
+ onClick={(event: React.MouseEvent<HTMLElement>) => {
418
+ onClick?.(event);
419
+ if (!event.defaultPrevented && selectable && !isDisabled) onCheckedChange?.(!checked);
420
+ }}
421
+ style={{ alignItems }}
422
+ className={cn(
423
+ "m-0 flex w-full min-w-0 items-start gap-3 border-0 bg-transparent p-0 text-left text-inherit text-foreground no-underline outline-none",
424
+ "leading-5 desktop:leading-6",
425
+ isInteractive ? "cursor-pointer disabled:cursor-default" : "",
426
+ selectable && "pl-10 md:pl-[3.25rem]",
427
+ list.allowDrag && "pl-12 desktop:pl-10",
428
+ )}
429
+ >
430
+ {media !== undefined && <span className="inline-flex shrink-0">{media}</span>}
431
+ <span
432
+ className={cn(
433
+ "relative flex h-full min-h-12 min-w-0 flex-col justify-center pr-4",
434
+ compact && "min-h-8",
435
+ selectable && "pr-2 md:pr-4",
436
+ )}
437
+ >
438
+ <span
439
+ id={`${id}-label`}
440
+ className={cn(
441
+ "text-base leading-6 desktop:text-sm desktop:leading-5",
442
+ labelWrap || labelWrapMaxLines ? "whitespace-normal" : "truncate",
443
+ labelWrapMaxLines && "overflow-hidden [display:-webkit-box] [-webkit-box-orient:vertical]",
444
+ labelWeight === "medium" && "font-medium",
445
+ labelWeight === "semibold" && "font-semibold",
446
+ labelWeight === "bold" && "font-bold",
447
+ )}
448
+ style={labelWrapMaxLines ? { WebkitLineClamp: labelWrapMaxLines } : undefined}
449
+ >
450
+ {label}
451
+ </span>
452
+ {description !== undefined && (
453
+ <span
454
+ id={descriptionId}
455
+ className={cn("text-sm leading-5 text-subdued", descriptionWrap ? "whitespace-normal" : "truncate")}
456
+ >
457
+ {description}
458
+ </span>
459
+ )}
460
+ </span>
461
+ </Tag>
462
+
463
+ {selectable && (
464
+ <span
465
+ aria-hidden
466
+ className={cn(
467
+ "pointer-events-none absolute top-1/2 left-3.5 flex size-[1.125rem] -translate-y-1/2 items-center justify-center rounded-s border-2",
468
+ isDisabled
469
+ ? checked
470
+ ? "border-disabled bg-disabled text-on-status"
471
+ : "border-disabled bg-transparent"
472
+ : checked
473
+ ? "border-[var(--s-icon-highlight)] bg-[var(--s-icon-highlight)] text-on-status"
474
+ : "border-icon-default",
475
+ )}
476
+ >
477
+ {checked && <Glyph name="checkStrong" className="size-[1.0625rem]" />}
478
+ </span>
479
+ )}
480
+
481
+ {showMeta && (
482
+ <span
483
+ className={cn(
484
+ "flex flex-col items-end gap-0.5 text-sm text-subdued",
485
+ meta !== undefined ? "self-start" : "self-center",
486
+ hideControl &&
487
+ "[@media(hover:hover)]:-mr-4 [@media(hover:hover)]:pr-4 [@media(hover:hover)]:transition-[margin] [@media(hover:hover)]:duration-100",
488
+ hideControl &&
489
+ "[@media(hover:hover)]:group-focus-within/item:mr-0 [@media(hover:hover)]:group-focus-within/item:pr-0 [@media(hover:hover)]:group-hover/item:mr-0 [@media(hover:hover)]:group-hover/item:pr-0",
490
+ )}
491
+ >
492
+ {meta !== undefined && (
493
+ <span className="mt-0.5 leading-6 whitespace-nowrap desktop:mt-1 desktop:leading-5">{meta}</span>
494
+ )}
495
+ {badges !== undefined && <span className="inline-flex w-max">{badges}</span>}
496
+ </span>
497
+ )}
498
+
499
+ {control !== undefined && (
500
+ <span
501
+ data-resource-list-control=""
502
+ onClick={(event) => event.stopPropagation()}
503
+ className={cn(
504
+ "self-center",
505
+ // With meta or badges, the control waits for hover or focus where hovering is possible.
506
+ hideControl &&
507
+ cn(
508
+ "[@media(hover:hover)]:pointer-events-none [@media(hover:hover)]:absolute [@media(hover:hover)]:top-1/2 [@media(hover:hover)]:right-2",
509
+ "[@media(hover:hover)]:-translate-y-1/2 [@media(hover:hover)]:opacity-0 [@media(hover:hover)]:transition-opacity [@media(hover:hover)]:duration-100",
510
+ "[@media(hover:hover)]:group-focus-within/item:pointer-events-auto [@media(hover:hover)]:group-focus-within/item:static [@media(hover:hover)]:group-focus-within/item:-my-1 [@media(hover:hover)]:group-focus-within/item:translate-y-0 [@media(hover:hover)]:group-focus-within/item:opacity-100",
511
+ "[@media(hover:hover)]:group-hover/item:pointer-events-auto [@media(hover:hover)]:group-hover/item:static [@media(hover:hover)]:group-hover/item:-my-1 [@media(hover:hover)]:group-hover/item:translate-y-0 [@media(hover:hover)]:group-hover/item:opacity-100",
512
+ ),
513
+ )}
514
+ >
515
+ {control}
516
+ </span>
517
+ )}
518
+ </div>
519
+
520
+ {list.allowDrag && (
521
+ <button
522
+ type="button"
523
+ data-drag-handle=""
524
+ aria-label={`${dragHandleLabel} "${typeof label === "string" ? label : ""}"`}
525
+ aria-description={dragHandleDescription}
526
+ className={cn(
527
+ "absolute top-1/2 left-1 z-1 m-0 inline-flex shrink-0 -translate-y-1/2 border-0 bg-transparent p-2 text-icon-default",
528
+ "cursor-grab active:cursor-grabbing outline-focus focus:not-focus-visible:outline-none focus-visible:outline-2 focus-visible:outline-solid",
529
+ "[&>svg]:size-6 desktop:[&>svg]:size-4",
530
+ )}
531
+ onKeyDown={(event) => {
532
+ if (event.key === " " || event.key === "Enter") {
533
+ event.preventDefault();
534
+ if (dragging) list.endDrag();
535
+ else list.startDrag(value);
536
+ } else if (dragging && (event.key === "ArrowDown" || event.key === "ArrowUp")) {
537
+ event.preventDefault();
538
+ list.moveDrag(event.key === "ArrowDown" ? 1 : -1);
539
+ } else if (dragging && event.key === "Escape") {
540
+ event.preventDefault();
541
+ list.endDrag();
542
+ }
543
+ }}
544
+ onPointerDown={(event) => {
545
+ if (event.button !== 0) return;
546
+ event.preventDefault();
547
+ event.currentTarget.setPointerCapture(event.pointerId);
548
+ list.startDrag(value);
549
+ }}
550
+ onPointerMove={(event) => {
551
+ if (dragging) list.pointerDrag(event.clientY);
552
+ }}
553
+ onPointerUp={() => {
554
+ if (dragging) list.endDrag();
555
+ }}
556
+ >
557
+ <Glyph name="dragHandle" />
558
+ </button>
559
+ )}
560
+ </div>
561
+ );
562
+ }
563
+
564
+ /* ---------------------------------------------------------------- section */
565
+
566
+ export interface ResourceListSectionProps extends React.ComponentProps<"div"> {
567
+ label: React.ReactNode;
568
+ /** Draw a rule above the section. */
569
+ hasSeparator?: boolean;
570
+ separatorSpacing?: React.ComponentProps<typeof Separator>["spacing"];
571
+ /** Space between the section's items. */
572
+ spacing?: SwirlSpacing;
573
+ }
574
+
575
+ /** A labelled group of items in a `ResourceList`. */
576
+ export function ResourceListSection({
577
+ label,
578
+ hasSeparator = false,
579
+ separatorSpacing = "4",
580
+ spacing = "0",
581
+ className,
582
+ children,
583
+ ...props
584
+ }: ResourceListSectionProps) {
585
+ const { semantics } = useResourceList();
586
+ const id = React.useId();
587
+ const grid = semantics === "grid";
588
+ return (
589
+ <div className={cn("block w-full", className)} {...props}>
590
+ {hasSeparator && <Separator spacing={separatorSpacing} />}
591
+ <div role={grid ? "rowgroup" : "listitem"} aria-labelledby={`${id}-label`}>
592
+ <span
593
+ id={`${id}-label`}
594
+ className="flex p-2 text-base leading-6 font-medium text-subdued desktop:text-sm desktop:leading-5"
595
+ >
596
+ {label}
597
+ </span>
598
+ <div role={grid ? undefined : "list"} className={cn("flex flex-col", gap(spacing))}>
599
+ {children}
600
+ </div>
601
+ </div>
602
+ </div>
603
+ );
604
+ }
605
+
606
+ /* -------------------------------------------------------------- file item */
607
+
608
+ export interface ResourceListFileItemProps extends React.ComponentProps<"div"> {
609
+ label: React.ReactNode;
610
+ /** Such as the file's size. Hidden while there's an error. */
611
+ description?: React.ReactNode;
612
+ errorMessage?: React.ReactNode;
613
+ /** Defaults to a file icon. */
614
+ icon?: React.ReactNode;
615
+ /** Show a spinner, as while uploading. */
616
+ loading?: boolean;
617
+ /** Show a button that removes the file; it calls `onRemove`. */
618
+ removable?: boolean;
619
+ onRemove?: () => void;
620
+ removeButtonLabel?: string;
621
+ }
622
+
623
+ /** A file in a `ResourceList`, such as an upload, with an error, a spinner or a remove button. */
624
+ export function ResourceListFileItem({
625
+ label,
626
+ description,
627
+ errorMessage,
628
+ icon,
629
+ loading = false,
630
+ removable = false,
631
+ onRemove,
632
+ removeButtonLabel = "Remove file",
633
+ className,
634
+ ...props
635
+ }: ResourceListFileItemProps) {
636
+ const roles = useRowRoles();
637
+ const showError = Boolean(errorMessage);
638
+ const showSpinner = !showError && loading;
639
+ const showRemove = removable && !showSpinner;
640
+ return (
641
+ <div role={roles.host} className="block w-full" {...props}>
642
+ <div
643
+ role={roles.cell}
644
+ data-resource-list-content=""
645
+ tabIndex={roles.cell ? -1 : undefined}
646
+ className={cn(
647
+ "relative flex w-full items-center gap-3 bg-background px-4 py-3 leading-6",
648
+ "outline-none focus-visible:bg-background-hovered",
649
+ "desktop:p-3 desktop:text-sm desktop:leading-5",
650
+ className,
651
+ )}
652
+ >
653
+ <span className="inline-flex size-6 shrink-0 text-[var(--s-icon-highlight)] desktop:size-5 [&>svg]:size-full">
654
+ {icon ?? <Glyph name="file" />}
655
+ </span>
656
+ <span
657
+ className={cn(
658
+ "relative flex min-h-[2.875rem] min-w-0 grow flex-col justify-center",
659
+ "after:absolute after:inset-x-0 after:-bottom-3 after:h-px after:bg-border after:content-['']",
660
+ (showSpinner || showRemove) && "pr-[calc(0.75rem+2.5rem)]",
661
+ )}
662
+ >
663
+ <span className="truncate font-medium">{label}</span>
664
+ {!showError && description !== undefined && (
665
+ <span className="mt-0.5 truncate text-sm leading-5 text-subdued">{description}</span>
666
+ )}
667
+ {showError && (
668
+ <span aria-live="polite" className="mt-0.5">
669
+ <InlineError size="s" message={errorMessage} />
670
+ </span>
671
+ )}
672
+ </span>
673
+ {showSpinner && (
674
+ <span className="absolute top-1/2 right-6 inline-flex -translate-y-1/2">
675
+ <Spinner size="s" label="Loading" />
676
+ </span>
677
+ )}
678
+ {showRemove && (
679
+ <span className="absolute top-1/2 right-4 inline-flex -translate-y-1/2">
680
+ <Button hideLabel label={removeButtonLabel} icon={<Glyph name="close" />} onClick={onRemove} />
681
+ </span>
682
+ )}
683
+ </div>
684
+ </div>
685
+ );
686
+ }