@lostgradient/cinder 0.23.0 → 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 (130) hide show
  1. package/CHANGELOG.md +85 -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/statistic/index.js +6 -2
  36. package/dist/components/statistic-group/index.js +6 -2
  37. package/dist/components/tooltip/index.js +72 -1
  38. package/dist/index.js +18936 -18257
  39. package/dist/server/components/access-gate/index.js +7 -4
  40. package/dist/server/components/approval-card/index.js +6 -5
  41. package/dist/server/components/autocomplete/index.js +6 -5
  42. package/dist/server/components/avatar-group/index.js +6 -5
  43. package/dist/server/components/carousel/index.js +3 -2
  44. package/dist/server/components/combobox/index.js +7 -6
  45. package/dist/server/components/command-menu/index.js +6 -5
  46. package/dist/server/components/context-menu/index.js +7 -6
  47. package/dist/server/components/date-picker/index.js +7 -6
  48. package/dist/server/components/date-range-field/index.js +7 -6
  49. package/dist/server/components/dropdown/index.js +7 -6
  50. package/dist/server/components/dropdown-menu/index.js +7 -6
  51. package/dist/server/components/file-upload/index.js +10 -2
  52. package/dist/server/components/hover-card/index.js +5 -4
  53. package/dist/server/components/icons/index.js +17 -11
  54. package/dist/server/components/invocation-rule-builder/index.js +7 -6
  55. package/dist/server/components/json-schema-editor/index.js +10 -7
  56. package/dist/server/components/mega-menu/index.js +4 -3
  57. package/dist/server/components/menu-bar/index.js +7 -6
  58. package/dist/server/components/multi-select/index.js +5 -4
  59. package/dist/server/components/navigation-bar/index.js +5 -4
  60. package/dist/server/components/popover/index.js +6 -5
  61. package/dist/server/components/portal/index.js +4 -3
  62. package/dist/server/components/selection-popover/index.js +5 -4
  63. package/dist/server/components/slider/index.js +4 -3
  64. package/dist/server/components/speed-dial/index.js +6 -5
  65. package/dist/server/components/speed-dial-action/index.js +5 -4
  66. package/dist/server/components/statistic/index.js +2 -2
  67. package/dist/server/components/statistic-group/index.js +2 -2
  68. package/dist/server/components/tooltip/index.js +6 -5
  69. package/dist/server/index.js +48 -42
  70. package/dist/server/{index.server-116jzzd0.js → index.server-0d1703dw.js} +1 -1
  71. package/dist/server/index.server-3cpak389.js +689 -0
  72. package/dist/server/{index.server-wmeaz6qk.js → index.server-5smw78xz.js} +78 -109
  73. package/dist/server/{index.server-nwgxhrzg.js → index.server-6vd98s4m.js} +1 -1
  74. package/dist/server/{index.server-4hvjet4z.js → index.server-7h3nmj3g.js} +7 -5
  75. package/dist/server/{index.server-3e8n2sry.js → index.server-7vzk6qhf.js} +2 -2
  76. package/dist/server/{index.server-h6qhx8mw.js → index.server-83fg1k4x.js} +7 -1
  77. package/dist/server/{index.server-5mz0e28m.js → index.server-8bv9bkm6.js} +1 -1
  78. package/dist/server/{index.server-59hgwg0n.js → index.server-8xr5tbrn.js} +1 -1
  79. package/dist/server/{index.server-x5zjwrnb.js → index.server-aphnpg78.js} +2 -2
  80. package/dist/server/{index.server-9scm7zf9.js → index.server-aywvs10h.js} +1 -1
  81. package/dist/server/index.server-bfkka7x4.js +2 -0
  82. package/dist/server/{index.server-2h45p8kd.js → index.server-bjj2hpx1.js} +2 -2
  83. package/dist/server/{index.server-veqke4sq.js → index.server-bp0vzxby.js} +6 -2
  84. package/dist/server/{index.server-4w0rydct.js → index.server-bw1wbzzk.js} +1 -1
  85. package/dist/server/{index.server-w5f4ex0f.js → index.server-c71m0a88.js} +1 -1
  86. package/dist/server/{index.server-kergq7c5.js → index.server-cmz3t3zw.js} +1 -1
  87. package/dist/server/{index.server-t2p901p7.js → index.server-cn3tg876.js} +1 -1
  88. package/dist/server/{index.server-6z6s8qz8.js → index.server-d05m93p4.js} +1 -1
  89. package/dist/server/{index.server-yr2ndv9a.js → index.server-d7twz1zm.js} +1 -1
  90. package/dist/server/{index.server-1cnz5ax1.js → index.server-emqv9bz6.js} +1 -1
  91. package/dist/server/index.server-fvtdyxbc.js +2 -0
  92. package/dist/server/{index.server-5wmzrvvs.js → index.server-gg4jre7c.js} +1 -1
  93. package/dist/server/{index.server-t91tbrmn.js → index.server-h76gdmj1.js} +2 -2
  94. package/dist/server/{index.server-bjw3e1wh.js → index.server-hvp84h1d.js} +1 -1
  95. package/dist/server/{index.server-7kez94sz.js → index.server-j6wms88v.js} +1 -1
  96. package/dist/server/{index.server-8t53gqe7.js → index.server-k21nfvxe.js} +2 -2
  97. package/dist/server/{index.server-6771g0q4.js → index.server-mf4dr1kp.js} +5 -1
  98. package/dist/server/{index.server-s2dseqdh.js → index.server-p69bvf14.js} +1 -1
  99. package/dist/server/{index.server-br3khchh.js → index.server-ppw26tpq.js} +1 -1
  100. package/dist/server/{index.server-151dt1tx.js → index.server-rx9aszk6.js} +1 -1
  101. package/dist/server/{index.server-q7r53g7z.js → index.server-s4pfz6pb.js} +1 -1
  102. package/dist/server/index.server-sje2hers.js +97 -0
  103. package/dist/server/{index.server-drdtprjs.js → index.server-spdds2hk.js} +1 -1
  104. package/dist/server/index.server-sz6y8xqk.js +2 -0
  105. package/dist/server/index.server-tkv7aey1.js +35 -0
  106. package/dist/server/{index.server-8dh2rtnc.js → index.server-vnr1h5g5.js} +1 -1
  107. package/dist/server/{index.server-rf9pd5mr.js → index.server-w20xg416.js} +1 -1
  108. package/dist/server/index.server-xvg6mjdw.js +73 -0
  109. package/dist/server/{index.server-03ndc3td.js → index.server-ye5xkaq2.js} +1 -1
  110. package/dist/server/{index.server-ejdprw7f.js → index.server-ykvb4rcc.js} +1 -1
  111. package/dist/server/index.server-yq9evnp4.js +38 -0
  112. package/dist/server/index.server-yrfah2yz.js +33 -0
  113. package/dist/server/{index.server-9n2bc545.js → index.server-zbgdfzy6.js} +1 -1
  114. package/dist/server/{index.server-n6wm89xy.js → index.server-zj0x74bt.js} +1 -1
  115. package/package.json +1 -1
  116. package/src/_internal/text-direction-css.ts +6 -0
  117. package/src/_internal/text-direction-sheet-index.ts +170 -0
  118. package/src/components/file-upload/file-upload-list.svelte +198 -0
  119. package/src/components/file-upload/file-upload-utilities.ts +262 -0
  120. package/src/components/file-upload/file-upload.css +152 -11
  121. package/src/components/file-upload/file-upload.examples.json +1 -1
  122. package/src/components/file-upload/file-upload.schema.json +38 -4
  123. package/src/components/file-upload/file-upload.schema.ts +40 -4
  124. package/src/components/file-upload/file-upload.svelte +176 -146
  125. package/src/components/file-upload/file-upload.types.ts +33 -5
  126. package/src/components/portal/portal.utilities.svelte.ts +8 -0
  127. package/src/components/statistic/statistic.svelte +37 -1
  128. package/dist/server/index.server-1qvmrpnx.js +0 -328
  129. package/dist/server/index.server-4n1mxg74.js +0 -2
  130. package/dist/server/index.server-7trweg3f.js +0 -61
@@ -11,16 +11,22 @@
11
11
  }
12
12
 
13
13
  .cinder-file-upload__dropzone {
14
+ position: relative;
14
15
  display: grid;
15
16
  gap: var(--cinder-space-3);
17
+ justify-items: center;
16
18
  border: 2px dashed var(--cinder-file-upload-border-color);
17
19
  border-radius: var(--cinder-radius-lg);
18
20
  background: var(--cinder-file-upload-background);
19
- padding: var(--cinder-space-4);
21
+ min-block-size: 12rem;
22
+ inline-size: 100%;
23
+ padding: var(--cinder-space-6);
24
+ text-align: center;
20
25
  transition:
21
26
  border-color var(--cinder-duration-fast) var(--cinder-ease-standard),
22
27
  background-color var(--cinder-duration-fast) var(--cinder-ease-standard),
23
28
  box-shadow var(--cinder-duration-fast) var(--cinder-ease-standard);
29
+ cursor: pointer;
24
30
  }
25
31
 
26
32
  .cinder-file-upload__dropzone[data-drag-active] {
@@ -34,9 +40,21 @@
34
40
  opacity: 0.7;
35
41
  }
36
42
 
37
- .cinder-file-upload__dropzone:focus-within {
38
- outline: var(--cinder-ring-width) solid transparent;
39
- box-shadow: var(--_cinder-focus-ring-shadow);
43
+ @supports not selector(:has(*)) {
44
+ .cinder-file-upload__dropzone:focus-within {
45
+ outline: var(--cinder-ring-width) solid transparent;
46
+ box-shadow: var(--_cinder-focus-ring-shadow);
47
+ }
48
+ }
49
+
50
+ @supports selector(:has(*)) {
51
+ .cinder-file-upload__dropzone:has(.cinder-file-upload__input:focus-visible),
52
+ .cinder-file-upload__dropzone--border-beam[data-drag-active],
53
+ .cinder-file-upload__dropzone--border-beam:has(.cinder-file-upload__input:focus-visible),
54
+ .cinder-file-upload__dropzone--border-beam:has(.cinder-file-upload__button:focus-visible) {
55
+ outline: var(--cinder-ring-width) solid transparent;
56
+ box-shadow: var(--_cinder-focus-ring-shadow);
57
+ }
40
58
  }
41
59
 
42
60
  .cinder-file-upload__input {
@@ -55,22 +73,41 @@
55
73
  .cinder-file-upload__body {
56
74
  display: grid;
57
75
  gap: var(--cinder-space-2);
58
- justify-items: start;
76
+ justify-items: center;
59
77
  }
60
78
 
61
- .cinder-file-upload__eyebrow {
79
+ .cinder-file-upload__upload-icon {
62
80
  display: inline-flex;
63
81
  align-items: center;
64
- gap: var(--cinder-space-2);
82
+ justify-content: center;
83
+ border: 1px solid var(--cinder-border-muted);
84
+ border-radius: var(--cinder-radius-md);
85
+ background: var(--cinder-surface);
86
+ color: var(--cinder-accent-text);
87
+ inline-size: 2.5rem;
88
+ block-size: 2.5rem;
89
+ }
90
+
91
+ .cinder-file-upload__upload-icon-svg {
92
+ inline-size: 1rem;
93
+ block-size: 1rem;
94
+ }
95
+
96
+ .cinder-file-upload__title,
97
+ .cinder-file-upload__description {
98
+ margin: 0;
99
+ }
100
+
101
+ .cinder-file-upload__title {
65
102
  color: var(--cinder-text);
66
103
  font-size: var(--cinder-text-sm);
67
104
  font-weight: var(--cinder-font-medium);
68
105
  }
69
106
 
70
- .cinder-file-upload__eyebrow-icon {
71
- inline-size: 1rem;
72
- block-size: 1rem;
73
- color: var(--cinder-accent-text);
107
+ .cinder-file-upload__description {
108
+ color: var(--cinder-text-muted);
109
+ font-size: var(--cinder-text-xs);
110
+ line-height: var(--cinder-leading-relaxed);
74
111
  }
75
112
 
76
113
  .cinder-file-upload__button {
@@ -86,6 +123,11 @@
86
123
  font-weight: var(--cinder-font-semibold);
87
124
  }
88
125
 
126
+ .cinder-file-upload__button:focus-visible {
127
+ outline: var(--cinder-ring-width) solid transparent;
128
+ box-shadow: var(--_cinder-focus-ring-shadow);
129
+ }
130
+
89
131
  .cinder-file-upload__hint {
90
132
  color: var(--cinder-text-muted);
91
133
  font-size: var(--cinder-text-sm);
@@ -123,6 +165,20 @@
123
165
  min-inline-size: 0;
124
166
  }
125
167
 
168
+ .cinder-file-upload__file-details {
169
+ display: flex;
170
+ align-items: center;
171
+ gap: var(--cinder-space-3);
172
+ min-inline-size: 0;
173
+ }
174
+
175
+ .cinder-file-upload__file-icon {
176
+ flex: none;
177
+ color: var(--cinder-text-muted);
178
+ inline-size: 1.25rem;
179
+ block-size: 1.25rem;
180
+ }
181
+
126
182
  .cinder-file-upload__file-name {
127
183
  overflow-wrap: anywhere;
128
184
  color: var(--cinder-text);
@@ -158,6 +214,28 @@
158
214
  flex: none;
159
215
  }
160
216
 
217
+ .cinder-file-upload__row-actions {
218
+ display: flex;
219
+ align-items: center;
220
+ gap: var(--cinder-space-2);
221
+ }
222
+
223
+ .cinder-file-upload__remove {
224
+ display: inline-flex;
225
+ align-items: center;
226
+ justify-content: center;
227
+ border: 0;
228
+ border-radius: var(--cinder-radius-sm);
229
+ background: transparent;
230
+ color: var(--cinder-text-muted);
231
+ padding: var(--cinder-space-1);
232
+ }
233
+
234
+ .cinder-file-upload__remove svg {
235
+ inline-size: 1rem;
236
+ block-size: 1rem;
237
+ }
238
+
161
239
  .cinder-file-upload__progress {
162
240
  overflow: hidden;
163
241
  border-radius: 999px;
@@ -173,10 +251,73 @@
173
251
  }
174
252
 
175
253
  .cinder-file-upload__error {
254
+ margin: 0;
176
255
  color: var(--cinder-color-danger-fg);
177
256
  font-size: var(--cinder-text-xs);
178
257
  }
179
258
 
259
+ .cinder-file-upload__error-row {
260
+ display: flex;
261
+ align-items: center;
262
+ justify-content: space-between;
263
+ gap: var(--cinder-space-2);
264
+ flex-wrap: wrap;
265
+ }
266
+
267
+ .cinder-file-upload__retry {
268
+ display: inline-flex;
269
+ align-items: center;
270
+ gap: var(--cinder-space-1);
271
+ border: 1px solid var(--cinder-border);
272
+ border-radius: var(--cinder-radius-sm);
273
+ background: var(--cinder-surface-raised);
274
+ color: var(--cinder-text);
275
+ padding: var(--cinder-space-1) var(--cinder-space-2);
276
+ font-size: var(--cinder-text-xs);
277
+ font-weight: var(--cinder-font-medium);
278
+ }
279
+
280
+ @media (hover: hover) {
281
+ .cinder-file-upload__retry:hover:not(:disabled),
282
+ .cinder-file-upload__remove:hover:not(:disabled) {
283
+ background: var(--cinder-surface-hover);
284
+ }
285
+ }
286
+
287
+ .cinder-file-upload__retry:focus-visible,
288
+ .cinder-file-upload__remove:focus-visible {
289
+ outline: var(--cinder-ring-width) solid transparent;
290
+ box-shadow: var(--_cinder-focus-ring-shadow);
291
+ }
292
+
293
+ .cinder-file-upload__retry-icon {
294
+ inline-size: 0.875rem;
295
+ block-size: 0.875rem;
296
+ }
297
+
298
+ @media (forced-colors: active) {
299
+ .cinder-file-upload__dropzone--border-beam[data-drag-active],
300
+ .cinder-file-upload__button:focus-visible,
301
+ .cinder-file-upload__retry:focus-visible,
302
+ .cinder-file-upload__remove:focus-visible {
303
+ outline-color: Highlight;
304
+ }
305
+
306
+ @supports not selector(:has(*)) {
307
+ .cinder-file-upload__dropzone:focus-within {
308
+ outline-color: Highlight;
309
+ }
310
+ }
311
+
312
+ @supports selector(:has(*)) {
313
+ .cinder-file-upload__dropzone:has(.cinder-file-upload__input:focus-visible),
314
+ .cinder-file-upload__dropzone--border-beam:has(.cinder-file-upload__input:focus-visible),
315
+ .cinder-file-upload__dropzone--border-beam:has(.cinder-file-upload__button:focus-visible) {
316
+ outline-color: Highlight;
317
+ }
318
+ }
319
+ }
320
+
180
321
  @media (prefers-reduced-motion: reduce) {
181
322
  .cinder-file-upload__dropzone,
182
323
  .cinder-file-upload__progress-fill {
@@ -7,7 +7,7 @@
7
7
  "id": "basic",
8
8
  "title": "Basic file upload",
9
9
  "description": "Drag-and-drop file picker with acceptance and rejection feedback.",
10
- "code": "<script lang=\"ts\">\n import { FileUpload } from '@lostgradient/cinder/file-upload';\n import type { RejectedFile } from '@lostgradient/cinder/file-upload';\n import { FormField } from '@lostgradient/cinder/form-field';\n\n let acceptedNames = $state<string[]>([]);\n let rejectedMessages = $state<string[]>([]);\n\n // A single drop/pick can include both valid and invalid files — FileUpload\n // fires `onFilesChange` (accepted) AND `onReject` (rejected) for the same batch.\n // Each handler updates only its own list so a mixed batch shows both results.\n function handleChange(files: File[]) {\n acceptedNames = files.map((file) => file.name);\n }\n\n function handleReject(rejected: RejectedFile[]) {\n rejectedMessages = rejected.map((entry) => entry.message);\n }\n</script>\n\n<!-- Compose with FormField so the file input has an associated <label>. -->\n<FormField id=\"attachment\" label=\"Attachment\" description=\"Images or PDF, up to 5 MB.\">\n <FileUpload\n id=\"attachment\"\n accept=\"image/*,.pdf\"\n multiple\n maxSize={5 * 1024 * 1024}\n onFilesChange={handleChange}\n onReject={handleReject}\n />\n</FormField>\n\n{#if acceptedNames.length > 0}\n <p style=\"margin-top: 0.5rem; color: var(--cinder-color-success-fg);\">\n Accepted: {acceptedNames.join(', ')}\n </p>\n{/if}\n\n{#if rejectedMessages.length > 0}\n <p style=\"margin-top: 0.5rem; color: var(--cinder-color-danger-fg);\">\n {rejectedMessages.join('; ')}\n </p>\n{/if}\n"
10
+ "code": "<script lang=\"ts\">\n import { FileUpload } from '@lostgradient/cinder/file-upload';\n import type { FileUploadEntry } from '@lostgradient/cinder/file-upload';\n import { FormField } from '@lostgradient/cinder/form-field';\n\n let acceptedNames = $state<string[]>([]);\n let rejectedMessages = $state<string[]>([]);\n\n function handleFilesChange(entries: FileUploadEntry[]) {\n acceptedNames = entries\n .filter((entry) => entry.rejectionReason === undefined)\n .map((entry) => entry.file.name);\n rejectedMessages = entries.flatMap((entry) =>\n entry.rejectionReason !== undefined && entry.error ? [entry.error] : [],\n );\n }\n</script>\n\n<!-- Compose with FormField so the file input has an associated <label>. -->\n<FormField id=\"attachment\" label=\"Attachment\" description=\"Images or PDF, up to 5 MB.\">\n <FileUpload\n id=\"attachment\"\n accept=\"image/*,.pdf\"\n multiple\n maxSize={5 * 1024 * 1024}\n onFilesChange={handleFilesChange}\n />\n</FormField>\n\n{#if acceptedNames.length > 0}\n <p style=\"margin-top: 0.5rem; color: var(--cinder-color-success-fg);\">\n Accepted: {acceptedNames.join(', ')}\n </p>\n{/if}\n\n{#if rejectedMessages.length > 0}\n <p style=\"margin-top: 0.5rem; color: var(--cinder-color-danger-fg);\">\n {rejectedMessages.join('; ')}\n </p>\n{/if}\n"
11
11
  }
12
12
  ]
13
13
  }
@@ -22,17 +22,41 @@
22
22
  "type": "string",
23
23
  "description": "Stable id for the native file input. Required when composing with `FormField`."
24
24
  },
25
+ "title": {
26
+ "type": "string",
27
+ "description": "Visible title for the dropzone.",
28
+ "default": "Click to upload or drop files"
29
+ },
25
30
  "maxSize": {
26
31
  "type": "number",
27
32
  "description": "Maximum allowed file size in bytes."
28
33
  },
34
+ "maxFiles": {
35
+ "type": "number",
36
+ "description": "Maximum number of files allowed. Files beyond this limit are rejected."
37
+ },
29
38
  "class": {
30
39
  "type": "string",
31
40
  "description": "Additional classes merged with `.cinder-file-upload`."
32
41
  },
33
- "triggerLabel": {
42
+ "description": {
34
43
  "type": "string",
35
- "description": "Visible text for the picker trigger button. Default `Choose files`."
44
+ "description": "Visible description below the title. Defaults to a summary derived from `accept`."
45
+ },
46
+ "draggingLabel": {
47
+ "type": "string",
48
+ "description": "Visible label shown while files are dragged over the dropzone.",
49
+ "default": "Drop to add"
50
+ },
51
+ "browseLabel": {
52
+ "type": "string",
53
+ "description": "Visible text for the browse button.",
54
+ "default": "Browse files"
55
+ },
56
+ "borderBeamVisible": {
57
+ "type": "boolean",
58
+ "description": "Adds focus and drag-active border emphasis to the dropzone.",
59
+ "default": true
36
60
  }
37
61
  },
38
62
  "additionalProperties": false,
@@ -46,7 +70,7 @@
46
70
  {
47
71
  "name": "fileList",
48
72
  "reason": "function-or-snippet",
49
- "description": "Replaces the default file-list renderer. Receives the resolved rows."
73
+ "description": "Replaces the default file-list renderer. Receives the live resolved rows, including an empty array, and a removal callback when the queue is mutable."
50
74
  },
51
75
  {
52
76
  "name": "files",
@@ -59,10 +83,20 @@
59
83
  "description": "Replaces the default resting-state dropzone body."
60
84
  },
61
85
  {
62
- "name": "onFilesChange",
86
+ "name": "onFileRetry",
87
+ "reason": "function-or-snippet",
88
+ "description": "Called when the retry button is activated for a failed file."
89
+ },
90
+ {
91
+ "name": "onFilesAccepted",
63
92
  "reason": "function-or-snippet",
64
93
  "description": "Fires with accepted files after local validation passes."
65
94
  },
95
+ {
96
+ "name": "onFilesChange",
97
+ "reason": "function-or-snippet",
98
+ "description": "Fires with the full resolved entry list after local validation changes it."
99
+ },
66
100
  {
67
101
  "name": "onReject",
68
102
  "reason": "function-or-snippet",
@@ -24,17 +24,42 @@ const schema = {
24
24
  type: 'string',
25
25
  description: 'Stable id for the native file input. Required when composing with `FormField`.',
26
26
  },
27
+ title: {
28
+ type: 'string',
29
+ description: 'Visible title for the dropzone.',
30
+ default: 'Click to upload or drop files',
31
+ },
27
32
  maxSize: {
28
33
  type: 'number',
29
34
  description: 'Maximum allowed file size in bytes.',
30
35
  },
36
+ maxFiles: {
37
+ type: 'number',
38
+ description: 'Maximum number of files allowed. Files beyond this limit are rejected.',
39
+ },
31
40
  class: {
32
41
  type: 'string',
33
42
  description: 'Additional classes merged with `.cinder-file-upload`.',
34
43
  },
35
- triggerLabel: {
44
+ description: {
36
45
  type: 'string',
37
- description: 'Visible text for the picker trigger button. Default `Choose files`.',
46
+ description:
47
+ 'Visible description below the title. Defaults to a summary derived from `accept`.',
48
+ },
49
+ draggingLabel: {
50
+ type: 'string',
51
+ description: 'Visible label shown while files are dragged over the dropzone.',
52
+ default: 'Drop to add',
53
+ },
54
+ browseLabel: {
55
+ type: 'string',
56
+ description: 'Visible text for the browse button.',
57
+ default: 'Browse files',
58
+ },
59
+ borderBeamVisible: {
60
+ type: 'boolean',
61
+ description: 'Adds focus and drag-active border emphasis to the dropzone.',
62
+ default: true,
38
63
  },
39
64
  },
40
65
  additionalProperties: false,
@@ -48,7 +73,8 @@ const schema = {
48
73
  {
49
74
  name: 'fileList',
50
75
  reason: 'function-or-snippet',
51
- description: 'Replaces the default file-list renderer. Receives the resolved rows.',
76
+ description:
77
+ 'Replaces the default file-list renderer. Receives the live resolved rows, including an empty array, and a removal callback when the queue is mutable.',
52
78
  },
53
79
  {
54
80
  name: 'files',
@@ -61,10 +87,20 @@ const schema = {
61
87
  description: 'Replaces the default resting-state dropzone body.',
62
88
  },
63
89
  {
64
- name: 'onFilesChange',
90
+ name: 'onFileRetry',
91
+ reason: 'function-or-snippet',
92
+ description: 'Called when the retry button is activated for a failed file.',
93
+ },
94
+ {
95
+ name: 'onFilesAccepted',
65
96
  reason: 'function-or-snippet',
66
97
  description: 'Fires with accepted files after local validation passes.',
67
98
  },
99
+ {
100
+ name: 'onFilesChange',
101
+ reason: 'function-or-snippet',
102
+ description: 'Fires with the full resolved entry list after local validation changes it.',
103
+ },
68
104
  {
69
105
  name: 'onReject',
70
106
  reason: 'function-or-snippet',