@lostgradient/cinder 0.23.1 → 0.24.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 (122) hide show
  1. package/CHANGELOG.md +53 -0
  2. package/components.json +1 -1
  3. package/dist/_internal/text-direction-sheet-index.d.ts +69 -0
  4. package/dist/components/access-gate/index.js +447 -354
  5. package/dist/components/approval-card/index.js +72 -1
  6. package/dist/components/autocomplete/index.js +72 -1
  7. package/dist/components/avatar-group/index.js +72 -1
  8. package/dist/components/carousel/index.js +73 -1
  9. package/dist/components/combobox/index.js +72 -1
  10. package/dist/components/command-menu/index.js +74 -1
  11. package/dist/components/context-menu/index.js +74 -1
  12. package/dist/components/date-picker/index.js +72 -1
  13. package/dist/components/date-range-field/index.js +72 -1
  14. package/dist/components/dropdown/index.js +74 -1
  15. package/dist/components/dropdown-menu/index.js +74 -1
  16. package/dist/components/file-upload/file-upload-list.svelte.d.ts +12 -0
  17. package/dist/components/file-upload/file-upload-utilities.d.ts +15 -0
  18. package/dist/components/file-upload/file-upload.css +152 -11
  19. package/dist/components/file-upload/file-upload.schema.js +39 -5
  20. package/dist/components/file-upload/file-upload.types.d.ts +33 -5
  21. package/dist/components/file-upload/index.js +1017 -264
  22. package/dist/components/hover-card/index.js +72 -1
  23. package/dist/components/invocation-rule-builder/index.js +72 -1
  24. package/dist/components/json-schema-editor/index.js +72 -1
  25. package/dist/components/mega-menu/index.js +73 -1
  26. package/dist/components/menu-bar/index.js +74 -1
  27. package/dist/components/multi-select/index.js +72 -1
  28. package/dist/components/navigation-bar/index.js +72 -1
  29. package/dist/components/popover/index.js +72 -1
  30. package/dist/components/portal/index.js +72 -1
  31. package/dist/components/selection-popover/index.js +72 -1
  32. package/dist/components/slider/index.js +73 -1
  33. package/dist/components/speed-dial/index.js +72 -1
  34. package/dist/components/speed-dial-action/index.js +72 -1
  35. package/dist/components/tooltip/index.js +72 -1
  36. package/dist/index.js +18932 -18257
  37. package/dist/server/components/access-gate/index.js +7 -4
  38. package/dist/server/components/approval-card/index.js +6 -5
  39. package/dist/server/components/autocomplete/index.js +6 -5
  40. package/dist/server/components/avatar-group/index.js +6 -5
  41. package/dist/server/components/carousel/index.js +3 -2
  42. package/dist/server/components/combobox/index.js +7 -6
  43. package/dist/server/components/command-menu/index.js +6 -5
  44. package/dist/server/components/context-menu/index.js +7 -6
  45. package/dist/server/components/date-picker/index.js +7 -6
  46. package/dist/server/components/date-range-field/index.js +7 -6
  47. package/dist/server/components/dropdown/index.js +7 -6
  48. package/dist/server/components/dropdown-menu/index.js +7 -6
  49. package/dist/server/components/file-upload/index.js +10 -2
  50. package/dist/server/components/hover-card/index.js +5 -4
  51. package/dist/server/components/icons/index.js +17 -11
  52. package/dist/server/components/invocation-rule-builder/index.js +7 -6
  53. package/dist/server/components/json-schema-editor/index.js +10 -7
  54. package/dist/server/components/mega-menu/index.js +4 -3
  55. package/dist/server/components/menu-bar/index.js +7 -6
  56. package/dist/server/components/multi-select/index.js +5 -4
  57. package/dist/server/components/navigation-bar/index.js +5 -4
  58. package/dist/server/components/popover/index.js +6 -5
  59. package/dist/server/components/portal/index.js +4 -3
  60. package/dist/server/components/selection-popover/index.js +5 -4
  61. package/dist/server/components/slider/index.js +4 -3
  62. package/dist/server/components/speed-dial/index.js +6 -5
  63. package/dist/server/components/speed-dial-action/index.js +5 -4
  64. package/dist/server/components/tooltip/index.js +6 -5
  65. package/dist/server/index.js +45 -39
  66. package/dist/server/{index.server-116jzzd0.js → index.server-0d1703dw.js} +1 -1
  67. package/dist/server/index.server-3cpak389.js +689 -0
  68. package/dist/server/{index.server-wmeaz6qk.js → index.server-5smw78xz.js} +78 -109
  69. package/dist/server/{index.server-nwgxhrzg.js → index.server-6vd98s4m.js} +1 -1
  70. package/dist/server/{index.server-4hvjet4z.js → index.server-7h3nmj3g.js} +7 -5
  71. package/dist/server/{index.server-3e8n2sry.js → index.server-7vzk6qhf.js} +2 -2
  72. package/dist/server/{index.server-h6qhx8mw.js → index.server-83fg1k4x.js} +7 -1
  73. package/dist/server/{index.server-5mz0e28m.js → index.server-8bv9bkm6.js} +1 -1
  74. package/dist/server/{index.server-59hgwg0n.js → index.server-8xr5tbrn.js} +1 -1
  75. package/dist/server/{index.server-x5zjwrnb.js → index.server-aphnpg78.js} +2 -2
  76. package/dist/server/{index.server-9scm7zf9.js → index.server-aywvs10h.js} +1 -1
  77. package/dist/server/index.server-bfkka7x4.js +2 -0
  78. package/dist/server/{index.server-2h45p8kd.js → index.server-bjj2hpx1.js} +2 -2
  79. package/dist/server/{index.server-4w0rydct.js → index.server-bw1wbzzk.js} +1 -1
  80. package/dist/server/{index.server-w5f4ex0f.js → index.server-c71m0a88.js} +1 -1
  81. package/dist/server/{index.server-kergq7c5.js → index.server-cmz3t3zw.js} +1 -1
  82. package/dist/server/{index.server-t2p901p7.js → index.server-cn3tg876.js} +1 -1
  83. package/dist/server/{index.server-6z6s8qz8.js → index.server-d05m93p4.js} +1 -1
  84. package/dist/server/{index.server-yr2ndv9a.js → index.server-d7twz1zm.js} +1 -1
  85. package/dist/server/{index.server-1cnz5ax1.js → index.server-emqv9bz6.js} +1 -1
  86. package/dist/server/index.server-fvtdyxbc.js +2 -0
  87. package/dist/server/{index.server-5wmzrvvs.js → index.server-gg4jre7c.js} +1 -1
  88. package/dist/server/{index.server-t91tbrmn.js → index.server-h76gdmj1.js} +2 -2
  89. package/dist/server/{index.server-bjw3e1wh.js → index.server-hvp84h1d.js} +1 -1
  90. package/dist/server/{index.server-7kez94sz.js → index.server-j6wms88v.js} +1 -1
  91. package/dist/server/{index.server-8t53gqe7.js → index.server-k21nfvxe.js} +2 -2
  92. package/dist/server/{index.server-6771g0q4.js → index.server-mf4dr1kp.js} +5 -1
  93. package/dist/server/{index.server-s2dseqdh.js → index.server-p69bvf14.js} +1 -1
  94. package/dist/server/{index.server-br3khchh.js → index.server-ppw26tpq.js} +1 -1
  95. package/dist/server/{index.server-q7r53g7z.js → index.server-s4pfz6pb.js} +1 -1
  96. package/dist/server/index.server-sje2hers.js +97 -0
  97. package/dist/server/{index.server-drdtprjs.js → index.server-spdds2hk.js} +1 -1
  98. package/dist/server/index.server-sz6y8xqk.js +2 -0
  99. package/dist/server/index.server-tkv7aey1.js +35 -0
  100. package/dist/server/{index.server-rf9pd5mr.js → index.server-w20xg416.js} +1 -1
  101. package/dist/server/index.server-xvg6mjdw.js +73 -0
  102. package/dist/server/{index.server-03ndc3td.js → index.server-ye5xkaq2.js} +1 -1
  103. package/dist/server/{index.server-ejdprw7f.js → index.server-ykvb4rcc.js} +1 -1
  104. package/dist/server/index.server-yq9evnp4.js +38 -0
  105. package/dist/server/index.server-yrfah2yz.js +33 -0
  106. package/dist/server/{index.server-9n2bc545.js → index.server-zbgdfzy6.js} +1 -1
  107. package/dist/server/{index.server-n6wm89xy.js → index.server-zj0x74bt.js} +1 -1
  108. package/package.json +1 -1
  109. package/src/_internal/text-direction-css.ts +6 -0
  110. package/src/_internal/text-direction-sheet-index.ts +170 -0
  111. package/src/components/file-upload/file-upload-list.svelte +198 -0
  112. package/src/components/file-upload/file-upload-utilities.ts +262 -0
  113. package/src/components/file-upload/file-upload.css +152 -11
  114. package/src/components/file-upload/file-upload.examples.json +1 -1
  115. package/src/components/file-upload/file-upload.schema.json +38 -4
  116. package/src/components/file-upload/file-upload.schema.ts +40 -4
  117. package/src/components/file-upload/file-upload.svelte +176 -146
  118. package/src/components/file-upload/file-upload.types.ts +33 -5
  119. package/src/components/portal/portal.utilities.svelte.ts +8 -0
  120. package/dist/server/index.server-1qvmrpnx.js +0 -328
  121. package/dist/server/index.server-4n1mxg74.js +0 -2
  122. package/dist/server/index.server-7trweg3f.js +0 -61
@@ -3,13 +3,17 @@ export {};
3
3
  </script>
4
4
 
5
5
  <script lang="ts">
6
+ import { onDestroy, tick } from 'svelte';
7
+ import { on } from 'svelte/events';
6
8
  import { resolveFieldControl } from '../../_internal/field-control.ts';
7
9
  import { getFormFieldContext } from '../../_internal/form-field-context.ts';
8
10
  import { classNames } from '../../utilities/class-names.ts';
9
11
  import { devWarn } from '../../utilities/dev-warn.ts';
10
12
  import { formatBytes } from '../../utilities/format-bytes.ts';
11
13
  import { useAnnouncer } from '../../utilities/use-announcer.svelte.ts';
12
- let { id, accept, multiple = false, maxSize, disabled, required, name, class: className, triggerLabel = 'Choose files', files, idle, dragActive, fileList, onFilesChange, onReject, 'aria-describedby': consumerDescribedBy, 'aria-invalid': consumerInvalid, ...rest } = $props();
14
+ import FileUploadList from './file-upload-list.svelte';
15
+ import { acceptsFile, constrainFileUploadEntries, dataTransferHasFiles, fileUploadLimit, formatAcceptDescription, installFilePickerReturnFallback, installFileUploadSurfaceActivation, synchronizeNativeFileInput, } from './file-upload-utilities.ts';
16
+ let { id, accept, multiple = false, maxSize, maxFiles, disabled, required, name, class: className, title = 'Click to upload or drop files', description, draggingLabel = 'Drop to add', browseLabel = 'Browse files', borderBeamVisible = true, files, idle, dragActive, fileList, onFilesAccepted, onFilesChange, onReject, onFileRetry, oncancel, 'aria-describedby': consumerDescribedBy, 'aria-invalid': consumerInvalid, ...rest } = $props();
13
17
  const context = getFormFieldContext();
14
18
  const announcer = useAnnouncer({ clearDelay: 5000 });
15
19
  const generatedId = $props.id();
@@ -17,7 +21,8 @@ const field = $derived(resolveFieldControl({
17
21
  ...(id !== undefined ? { id } : {}),
18
22
  generatedId,
19
23
  context,
20
- hasDescription: false,
24
+ localIdNamespace: 'file-upload',
25
+ hasDescription: idle === undefined,
21
26
  hasError: false,
22
27
  consumerDescribedBy,
23
28
  consumerInvalid,
@@ -28,11 +33,87 @@ const resolvedId = $derived(field.id);
28
33
  const dropzoneLabelledBy = $derived(context?.labelId);
29
34
  const dropzoneLabel = $derived(dropzoneLabelledBy === undefined ? 'File upload' : undefined);
30
35
  let inputElement = $state(null);
36
+ let browseButtonElement = $state(null);
31
37
  let dragDepth = $state(0);
32
38
  let internalEntries = $state([]);
33
39
  let internalEntryCounter = $state(0);
40
+ let cancelPickerReturnFallback = () => { };
41
+ let pendingRemovalAnnouncement = $state();
42
+ onDestroy(() => cancelPickerReturnFallback());
34
43
  const isDragActive = $derived(dragDepth > 0);
35
44
  const renderedEntries = $derived(files ?? internalEntries);
45
+ const resolvedDescription = $derived(description ?? formatAcceptDescription(accept));
46
+ $effect(() => {
47
+ const pending = pendingRemovalAnnouncement;
48
+ if (!pending)
49
+ return;
50
+ if (files === undefined) {
51
+ pendingRemovalAnnouncement = undefined;
52
+ }
53
+ else if (!files.some((entry) => entry.id === pending.id)) {
54
+ announcer.announce(`${pending.name} removed`);
55
+ pendingRemovalAnnouncement = undefined;
56
+ }
57
+ });
58
+ function synchronizeNativeInputFiles(entries = renderedEntries) {
59
+ synchronizeNativeFileInput(inputElement, entries, multiple, maxFiles);
60
+ }
61
+ $effect(() => {
62
+ synchronizeNativeInputFiles();
63
+ });
64
+ $effect(() => {
65
+ if (files !== undefined)
66
+ return;
67
+ const nextEntries = constrainFileUploadEntries(internalEntries, fileUploadLimit(multiple, maxFiles));
68
+ if (nextEntries.length === internalEntries.length)
69
+ return;
70
+ if (files === undefined)
71
+ internalEntries = nextEntries;
72
+ synchronizeNativeInputFiles(nextEntries);
73
+ onFilesChange?.(nextEntries);
74
+ });
75
+ $effect(() => {
76
+ const ownerDocument = inputElement?.ownerDocument;
77
+ if (!ownerDocument)
78
+ return;
79
+ let associatedForm = null;
80
+ let removeResetListener = () => { };
81
+ function handleFormReset(event) {
82
+ queueMicrotask(async () => {
83
+ if (event.defaultPrevented)
84
+ return;
85
+ await tick();
86
+ const currentFiles = files;
87
+ if (currentFiles !== undefined) {
88
+ synchronizeNativeInputFiles(currentFiles);
89
+ return;
90
+ }
91
+ internalEntries = [];
92
+ synchronizeNativeInputFiles([]);
93
+ onFilesChange?.([]);
94
+ });
95
+ }
96
+ function bindAssociatedForm() {
97
+ const nextForm = inputElement?.form ?? null;
98
+ if (nextForm === associatedForm)
99
+ return;
100
+ removeResetListener();
101
+ associatedForm = nextForm;
102
+ removeResetListener = nextForm ? on(nextForm, 'reset', handleFormReset) : () => { };
103
+ }
104
+ bindAssociatedForm();
105
+ const observer = new MutationObserver(bindAssociatedForm);
106
+ observer.observe(ownerDocument.documentElement, {
107
+ attributes: true,
108
+ attributeFilter: ['form', 'id'],
109
+ childList: true,
110
+ subtree: true,
111
+ });
112
+ return () => {
113
+ observer.disconnect();
114
+ removeResetListener();
115
+ };
116
+ });
36
117
  $effect(() => {
37
118
  if (context && id && context.controlId !== id) {
38
119
  devWarn(`[cinder/FileUpload] id mismatch: FileUpload id="${id}" but wrapping FormField expects controlId="${context.controlId}". Set the same id on both.`);
@@ -42,37 +123,6 @@ function nextEntryId(status) {
42
123
  internalEntryCounter += 1;
43
124
  return `${resolvedId}-entry-${internalEntryCounter}-${status}`;
44
125
  }
45
- function hasFilesPayload(dataTransfer) {
46
- const fileTypes = dataTransfer?.types;
47
- if (!fileTypes)
48
- return false;
49
- return Array.from(fileTypes).includes('Files');
50
- }
51
- function matchesAcceptToken(file, token) {
52
- const normalizedToken = token.trim().toLowerCase();
53
- if (!normalizedToken)
54
- return true;
55
- if (normalizedToken.startsWith('.')) {
56
- return file.name.toLowerCase().endsWith(normalizedToken);
57
- }
58
- const fileType = file.type.toLowerCase();
59
- if (normalizedToken.endsWith('/*')) {
60
- const prefix = normalizedToken.slice(0, -1);
61
- return fileType.startsWith(prefix);
62
- }
63
- return fileType === normalizedToken;
64
- }
65
- function acceptsFile(file) {
66
- if (!accept?.trim())
67
- return true;
68
- const tokens = accept
69
- .split(',')
70
- .map((token) => token.trim())
71
- .filter(Boolean);
72
- if (tokens.length === 0)
73
- return true;
74
- return tokens.some((token) => matchesAcceptToken(file, token));
75
- }
76
126
  function validateFiles(sourceFiles) {
77
127
  const accepted = [];
78
128
  const rejected = [];
@@ -85,7 +135,7 @@ function validateFiles(sourceFiles) {
85
135
  });
86
136
  continue;
87
137
  }
88
- if (!acceptsFile(file)) {
138
+ if (!acceptsFile(file, accept)) {
89
139
  rejected.push({
90
140
  file,
91
141
  reason: 'wrong-type',
@@ -95,30 +145,38 @@ function validateFiles(sourceFiles) {
95
145
  }
96
146
  accepted.push(file);
97
147
  }
98
- if (!multiple && accepted.length > 1) {
99
- const extras = accepted.splice(1);
148
+ const acceptedFileLimit = fileUploadLimit(multiple, maxFiles);
149
+ const existingAcceptedCount = multiple && acceptedFileLimit !== undefined
150
+ ? renderedEntries.filter((entry) => entry.rejectionReason === undefined).length
151
+ : 0;
152
+ const remainingFileLimit = acceptedFileLimit === undefined
153
+ ? undefined
154
+ : Math.max(0, acceptedFileLimit - existingAcceptedCount);
155
+ if (remainingFileLimit !== undefined && accepted.length > remainingFileLimit) {
156
+ const extras = accepted.splice(remainingFileLimit);
100
157
  for (const file of extras) {
101
158
  rejected.push({
102
159
  file,
103
160
  reason: 'too-many',
104
- message: `Only one file is allowed; ${file.name} was ignored`,
161
+ message: `${acceptedFileLimit === 1 ? 'Only one file is' : `Only ${acceptedFileLimit} files are`} allowed; ${file.name} was ignored`,
105
162
  });
106
163
  }
107
164
  }
108
165
  return { accepted, rejected };
109
166
  }
110
- function updateInternalEntries(accepted, rejected) {
111
- internalEntries = [
167
+ function createEntries(accepted, rejected) {
168
+ return [
112
169
  ...accepted.map((file) => ({
113
- id: nextEntryId('success'),
170
+ id: nextEntryId('pending'),
114
171
  file,
115
- status: 'success',
172
+ status: 'pending',
116
173
  })),
117
174
  ...rejected.map((entry) => ({
118
175
  id: nextEntryId('error'),
119
176
  file: entry.file,
120
177
  status: 'error',
121
178
  error: entry.message,
179
+ rejectionReason: entry.reason,
122
180
  })),
123
181
  ];
124
182
  }
@@ -137,20 +195,28 @@ function announceResult(accepted, rejected) {
137
195
  }
138
196
  function processFiles(sourceFiles) {
139
197
  const { accepted, rejected } = validateFiles(sourceFiles);
140
- updateInternalEntries(accepted, rejected);
198
+ const entries = createEntries(accepted, rejected);
199
+ const nextEntries = multiple ? [...renderedEntries, ...entries] : entries;
200
+ if (files === undefined)
201
+ internalEntries = nextEntries;
202
+ synchronizeNativeInputFiles(files !== undefined && accepted.length === 0 ? files : nextEntries);
141
203
  if (accepted.length > 0)
142
- onFilesChange?.(accepted);
204
+ onFilesAccepted?.(accepted);
205
+ onFilesChange?.(nextEntries);
143
206
  if (rejected.length > 0)
144
207
  onReject?.(rejected);
145
208
  announceResult(accepted, rejected);
209
+ if (files !== undefined)
210
+ queueMicrotask(() => synchronizeNativeInputFiles());
146
211
  }
147
212
  function handleInputChange() {
213
+ cancelPickerReturnFallback();
148
214
  if (field.disabled || !inputElement?.files)
149
215
  return;
150
216
  processFiles(Array.from(inputElement.files));
151
217
  }
152
218
  function handleDragEnter(event) {
153
- if (field.disabled || !hasFilesPayload(event.dataTransfer))
219
+ if (field.disabled || !dataTransferHasFiles(event.dataTransfer))
154
220
  return;
155
221
  dragDepth += 1;
156
222
  }
@@ -163,12 +229,12 @@ function handleDragLeave(event) {
163
229
  // overlay stuck open — see the "clear drag state after cancelled upload"
164
230
  // fix and its dedicated regression test. Only a present-but-non-Files
165
231
  // dataTransfer (e.g. a text drag) is ignored here.
166
- if (event.dataTransfer && !hasFilesPayload(event.dataTransfer))
232
+ if (event.dataTransfer && !dataTransferHasFiles(event.dataTransfer))
167
233
  return;
168
234
  dragDepth = Math.max(0, dragDepth - 1);
169
235
  }
170
236
  function handleDragOver(event) {
171
- if (!hasFilesPayload(event.dataTransfer))
237
+ if (!dataTransferHasFiles(event.dataTransfer))
172
238
  return;
173
239
  event.preventDefault();
174
240
  if (field.disabled)
@@ -178,7 +244,7 @@ function handleDragOver(event) {
178
244
  }
179
245
  }
180
246
  function handleDrop(event) {
181
- if (!hasFilesPayload(event.dataTransfer))
247
+ if (!dataTransferHasFiles(event.dataTransfer))
182
248
  return;
183
249
  event.preventDefault();
184
250
  dragDepth = 0;
@@ -195,29 +261,52 @@ function openPicker() {
195
261
  clearInputValue();
196
262
  inputElement?.click();
197
263
  }
264
+ function surfaceActivation(node) {
265
+ return installFileUploadSurfaceActivation(node, () => field.disabled, openPicker);
266
+ }
198
267
  function clearInputValue() {
199
- if (inputElement) {
268
+ if (inputElement)
200
269
  inputElement.value = '';
201
- }
202
270
  }
203
271
  function handleInputClick() {
204
272
  if (field.disabled)
205
273
  return;
274
+ cancelPickerReturnFallback();
275
+ if (inputElement) {
276
+ cancelPickerReturnFallback = installFilePickerReturnFallback(inputElement, () => synchronizeNativeInputFiles());
277
+ }
206
278
  clearInputValue();
207
279
  }
208
- function progressValue(progress) {
209
- if (progress === undefined)
210
- return 0;
211
- return Math.max(0, Math.min(100, progress));
280
+ function handleInputCancel(event) {
281
+ cancelPickerReturnFallback();
282
+ synchronizeNativeInputFiles();
283
+ oncancel?.(event);
284
+ }
285
+ function removeEntry(entry) {
286
+ if (field.disabled)
287
+ return;
288
+ const nextEntries = renderedEntries.filter((candidate) => candidate.id !== entry.id);
289
+ if (files === undefined)
290
+ internalEntries = nextEntries;
291
+ synchronizeNativeInputFiles(nextEntries);
292
+ onFilesChange?.(nextEntries);
293
+ if (files === undefined) {
294
+ announcer.announce(`${entry.file.name} removed`);
295
+ return;
296
+ }
297
+ pendingRemovalAnnouncement = { id: entry.id, name: entry.file.name };
298
+ queueMicrotask(async () => {
299
+ await tick();
300
+ synchronizeNativeInputFiles();
301
+ });
212
302
  }
213
303
  </script>
214
304
 
215
305
  {#snippet defaultIdle()}
216
306
  <div class="cinder-file-upload__body">
217
- <span class="cinder-file-upload__eyebrow">
307
+ <span class="cinder-file-upload__upload-icon" aria-hidden="true">
218
308
  <svg
219
- class="cinder-file-upload__eyebrow-icon"
220
- aria-hidden="true"
309
+ class="cinder-file-upload__upload-icon-svg"
221
310
  viewBox="0 0 16 16"
222
311
  fill="none"
223
312
  xmlns="http://www.w3.org/2000/svg"
@@ -230,22 +319,29 @@ function progressValue(progress) {
230
319
  stroke-linejoin="round"
231
320
  />
232
321
  </svg>
233
- Drag files here, or use the {triggerLabel} button.
234
322
  </span>
235
- <p class="cinder-file-upload__hint">Drop files on this area or use the native file picker.</p>
323
+ <p class="cinder-file-upload__title">{title}</p>
324
+ <p id={field.ownDescriptionId} class="cinder-file-upload__description">
325
+ {resolvedDescription}
326
+ </p>
236
327
  </div>
237
328
  {/snippet}
238
329
 
239
330
  {#snippet defaultDragActive()}
240
331
  <div class="cinder-file-upload__body">
241
- <span class="cinder-file-upload__eyebrow">Drop files to add them</span>
242
- <p class="cinder-file-upload__hint">Release now to validate and queue the selected files.</p>
332
+ <p class="cinder-file-upload__title">{draggingLabel}</p>
333
+ <p id={field.ownDescriptionId} class="cinder-file-upload__hint">
334
+ Release now to validate and queue the selected files.
335
+ </p>
243
336
  </div>
244
337
  {/snippet}
245
338
 
246
339
  <div class={classNames('cinder-file-upload', className)}>
247
340
  <div
248
- class="cinder-file-upload__dropzone"
341
+ class={classNames(
342
+ 'cinder-file-upload__dropzone',
343
+ borderBeamVisible && 'cinder-file-upload__dropzone--border-beam',
344
+ )}
249
345
  role="group"
250
346
  aria-label={dropzoneLabel}
251
347
  aria-labelledby={dropzoneLabelledBy}
@@ -255,6 +351,7 @@ function progressValue(progress) {
255
351
  ondragleave={handleDragLeave}
256
352
  ondragover={handleDragOver}
257
353
  ondrop={handleDrop}
354
+ use:surfaceActivation
258
355
  >
259
356
  <input
260
357
  bind:this={inputElement}
@@ -270,6 +367,7 @@ function progressValue(progress) {
270
367
  aria-describedby={field.describedBy}
271
368
  aria-invalid={field.ariaInvalid}
272
369
  onclick={handleInputClick}
370
+ oncancel={handleInputCancel}
273
371
  onchange={handleInputChange}
274
372
  />
275
373
 
@@ -286,99 +384,31 @@ function progressValue(progress) {
286
384
  {/if}
287
385
 
288
386
  <button
387
+ bind:this={browseButtonElement}
289
388
  type="button"
290
389
  class="cinder-file-upload__button"
291
390
  disabled={field.disabled}
391
+ aria-describedby={field.describedBy}
292
392
  onclick={openPicker}
293
393
  >
294
- {triggerLabel}
394
+ {browseLabel}
295
395
  </button>
296
396
  </div>
297
397
 
298
- {#if renderedEntries.length > 0}
299
- {#if fileList}
300
- {@render fileList(renderedEntries)}
301
- {:else}
302
- <ul class="cinder-file-upload__list">
303
- {#each renderedEntries as entry (entry.id)}
304
- {@const errorId = entry.error ? `${resolvedId}-${entry.id}-error` : undefined}
305
- <li class="cinder-file-upload__row" aria-describedby={errorId}>
306
- <div class="cinder-file-upload__row-main">
307
- <div class="cinder-file-upload__file-meta">
308
- <span class="cinder-file-upload__file-name cinder-_truncate">{entry.file.name}</span
309
- >
310
- <span class="cinder-file-upload__file-size">{formatBytes(entry.file.size)}</span>
311
- </div>
312
-
313
- {#if entry.status === 'uploading'}
314
- <span class="cinder-file-upload__status" data-status="uploading">Uploading</span>
315
- {:else if entry.status === 'success'}
316
- <span class="cinder-file-upload__status" data-status="success">
317
- <svg
318
- class="cinder-file-upload__status-icon"
319
- aria-hidden="true"
320
- viewBox="0 0 16 16"
321
- fill="none"
322
- xmlns="http://www.w3.org/2000/svg"
323
- >
324
- <path
325
- d="M3.5 8.5L6.25 11.25L12.5 5"
326
- stroke="currentColor"
327
- stroke-width="1.5"
328
- stroke-linecap="round"
329
- stroke-linejoin="round"
330
- />
331
- </svg>
332
- Complete
333
- </span>
334
- {:else if entry.status === 'error'}
335
- <span class="cinder-file-upload__status" data-status="error">
336
- <svg
337
- class="cinder-file-upload__status-icon"
338
- aria-hidden="true"
339
- viewBox="0 0 16 16"
340
- fill="none"
341
- xmlns="http://www.w3.org/2000/svg"
342
- >
343
- <path
344
- d="M8 4.5V8.25M8 11H8.00667M14 8C14 11.3137 11.3137 14 8 14C4.68629 14 2 11.3137 2 8C2 4.68629 4.68629 2 8 2C11.3137 2 14 4.68629 14 8Z"
345
- stroke="currentColor"
346
- stroke-width="1.5"
347
- stroke-linecap="round"
348
- stroke-linejoin="round"
349
- />
350
- </svg>
351
- Failed
352
- </span>
353
- {:else}
354
- <span class="cinder-file-upload__status" data-status="pending">Pending</span>
355
- {/if}
356
- </div>
357
-
358
- {#if entry.status === 'uploading'}
359
- {@const value = progressValue(entry.progress)}
360
- <div
361
- class="cinder-file-upload__progress"
362
- role="progressbar"
363
- aria-label={`Uploading ${entry.file.name}`}
364
- aria-valuemin="0"
365
- aria-valuemax="100"
366
- aria-valuenow={value}
367
- >
368
- <div
369
- class="cinder-file-upload__progress-fill"
370
- style={`--cinder-file-upload-progress: ${value}`}
371
- ></div>
372
- </div>
373
- {/if}
374
-
375
- {#if entry.error}
376
- <p id={errorId} class="cinder-file-upload__error">{entry.error}</p>
377
- {/if}
378
- </li>
379
- {/each}
380
- </ul>
381
- {/if}
398
+ {#if fileList}
399
+ {@render fileList(
400
+ renderedEntries,
401
+ files === undefined || onFilesChange !== undefined ? removeEntry : undefined,
402
+ )}
403
+ {:else}
404
+ <FileUploadList
405
+ entries={renderedEntries}
406
+ disabled={field.disabled}
407
+ removable={files === undefined || onFilesChange !== undefined}
408
+ {onFileRetry}
409
+ onRemove={removeEntry}
410
+ onQueueEmptyFocus={() => browseButtonElement?.focus()}
411
+ />
382
412
  {/if}
383
413
 
384
414
  <div class="cinder-sr-only" aria-live="polite" aria-atomic="true">{announcer.message}</div>
@@ -25,6 +25,8 @@ export type FileUploadEntry = {
25
25
  progress?: number;
26
26
  /** Optional error message rendered and linked via aria-describedby. */
27
27
  error?: string;
28
+ /** Local validation reason. Omitted for errors produced after an accepted upload starts. */
29
+ rejectionReason?: FileUploadRejectionReason;
28
30
  };
29
31
 
30
32
  export type FileUploadProps = Omit<
@@ -39,24 +41,50 @@ export type FileUploadProps = Omit<
39
41
  multiple?: boolean;
40
42
  /** Maximum allowed file size in bytes. */
41
43
  maxSize?: number;
44
+ /** Maximum number of files allowed. Files beyond this limit are rejected. */
45
+ maxFiles?: number;
42
46
  /** Disables the file picker and drag-and-drop surface. */
43
47
  disabled?: boolean;
44
48
  /** Native input name used for form submission. */
45
49
  name?: string;
46
50
  /** Additional classes merged with `.cinder-file-upload`. */
47
51
  class?: string;
48
- /** Visible text for the picker trigger button. Default `Choose files`. */
49
- triggerLabel?: string;
52
+ /**
53
+ * Visible title for the dropzone.
54
+ * @default Click to upload or drop files
55
+ */
56
+ title?: string;
57
+ /** Visible description below the title. Defaults to a summary derived from `accept`. */
58
+ description?: string;
59
+ /**
60
+ * Visible label shown while files are dragged over the dropzone.
61
+ * @default Drop to add
62
+ */
63
+ draggingLabel?: string;
64
+ /**
65
+ * Visible text for the browse button.
66
+ * @default Browse files
67
+ */
68
+ browseLabel?: string;
69
+ /**
70
+ * Adds focus and drag-active border emphasis to the dropzone.
71
+ * @default true
72
+ */
73
+ borderBeamVisible?: boolean;
50
74
  /** Consumer-driven file rows, including upload progress and error states. */
51
75
  files?: FileUploadEntry[];
52
76
  /** Replaces the default resting-state dropzone body. */
53
77
  idle?: Snippet;
54
78
  /** Replaces the default drag-active dropzone body. */
55
79
  dragActive?: Snippet;
56
- /** Replaces the default file-list renderer. Receives the resolved rows. */
57
- fileList?: Snippet<[FileUploadEntry[]]>;
80
+ /** Replaces the default file-list renderer. Receives the live resolved rows, including an empty array, and a removal callback when the queue is mutable. */
81
+ fileList?: Snippet<[FileUploadEntry[], ((entry: FileUploadEntry) => void) | undefined]>;
58
82
  /** Fires with accepted files after local validation passes. */
59
- onFilesChange?: (files: File[]) => void;
83
+ onFilesAccepted?: (files: File[]) => void;
84
+ /** Fires with the full resolved entry list after local validation changes it. */
85
+ onFilesChange?: (entries: FileUploadEntry[]) => void;
60
86
  /** Fires with rejected files and reasons after local validation runs. */
61
87
  onReject?: (files: RejectedFile[]) => void;
88
+ /** Called when the retry button is activated for a failed file. */
89
+ onFileRetry?: (entry: FileUploadEntry) => void;
62
90
  };
@@ -1,4 +1,5 @@
1
1
  import { untrack } from 'svelte';
2
+ import { resetDirectionStyleSheetIndex } from '../../_internal/text-direction-sheet-index.ts';
2
3
  import { devWarn } from '../../utilities/dev-warn.ts';
3
4
  import { readOption } from '../../utilities/read-option.ts';
4
5
  import { useReducedMotion } from '../../utilities/use-reduced-motion.svelte.ts';
@@ -550,6 +551,13 @@ function invalidateComputedDirections() {
550
551
  * `replace`, `replaceSync`, or assigning `adoptedStyleSheets` on a document or shadow root.
551
552
  */
552
553
  export function invalidatePortalDirection() {
554
+ // Cleared unconditionally, and before the early return below: the direction
555
+ // sheet index is global rather than portal-scoped, and its negative entries
556
+ // are keyed on a sheet's top-level rule count — which `replace`, `replaceSync`,
557
+ // and a `deleteRule`/`insertRule` pair can all leave unchanged. This hook is
558
+ // the documented signal for exactly those edits, so it has to invalidate the
559
+ // index even when nothing is currently observing direction.
560
+ resetDirectionStyleSheetIndex();
553
561
  if (computedDirectionObservations.size === 0)
554
562
  return;
555
563
  refreshMediaQueryObservers();