@synopackageland/ui 0.17.11 → 0.17.12

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.17.12 (2026-10-30)
+
+- Upload callbacks can throw an error with `final: true` to fail immediately, disable manual retry and hide retry controls for permanent failures; other errors still retry twice by default.
+
 ## 0.17.11 (2026-10-30)
 
 Settings forms follow DSM's own Control Panel layout by default. Two DOM changes: `Fieldset`'s chevron points up while open and down while collapsed (it was down and right), and a `password` `Input` is now an outer `<span>` (layout attrs) around an inner one holding the field and its toggle.

package/README.md

@@ -674,6 +674,23 @@ size (arrow keys and swipes), and `UploadQueue` lists uploads with progress,
 retry and cancel. `useUploadQueue(upload, { concurrency, retries })` runs the
 uploads it shows. `FilePicker` takes pasted files with `paste`.
 
+An upload failure is retried twice by default, after 1 second and 3 seconds.
+For permanent errors such as a refused file type, an oversized file or denied
+permission, throw an `Error` with `final: true`:
+
+```ts
+throw Object.assign(new Error('This file type is not allowed'), { final: true })
+```
+
+The queue immediately marks that task `failed`, keeps the error message and
+calls `onFailed` once. Its `final` flag disables `queue.retry(key)` and hides
+the task's retry button in `UploadQueue`; "Retry all" appears only when at
+least two failed tasks can be retried. Other errors keep the usual retry
+behavior. This also applies to `RichTextEditor`'s `upload` callback. Apps
+providing their own `UploadQueueItem[]` can set `final: true` on failed items
+and should skip them in their `retryAll` handler; the queue's `retry` method
+already does so.
+
 ```vue
 <CommentItem v-for="c in comments" :key="c.id" :author="c.author.name" :time="c.when" :body="c.body" :mentions="people" :files="fileById" :edited="!!c.editedAt" :deleted="c.deleted" />
 <RichTextEditor v-model="text" variant="compact" :candidates="people" :filter="false" :maxlength="4000" :upload="sendFile" :files="fileById" @search="findPeople" @submit="post" />

package/dist/components/composite/upload-queue/UploadQueue.vue.d.ts

@@ -6,6 +6,8 @@ export type UploadQueueItem = {
     loaded: number;
     status: UploadStatus;
     error?: string;
+    /** A permanent failure; hides this task's retry button and excludes it from Retry all. */
+    final?: boolean;
 };
 type __VLS_Props = {
     tasks: UploadQueueItem[];