@scaleflex/uploader 0.2.6 → 0.2.8

package/.claude/skills/integrate-uploader/SKILL.md

@@ -196,10 +196,11 @@ uploader.config = {
 
   // Display
   mode: 'modal',                        // 'modal' (default) or 'inline'
-  headerButton: 'close',                // 'none' | 'close' | 'back'
+  header: 'close',                       // boolean | 'close' | 'back'
                                         //   modal default: 'close'
-                                        //   inline default: 'none'
+                                        //   inline default: true (no button)
                                         //   'back': for wizard/step flows
+                                        //   false: hide header entirely
   sourcesLayout: 'pills',               // 'pills' (default) or 'cards'
 
   // Upload behavior
@@ -421,7 +422,7 @@ config = {
 config = {
   auth: { /* ... */ },
   mode: 'modal',
-  headerButton: 'back',
+  header: 'back',
   clearOnClose: false,  // preserve files across open/close
 };
 ```

package/CHANGELOG.md

@@ -7,13 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Bulk metadata editing modal — click "Fill Metadata" to open a full-screen overlay for editing metadata across multiple files at once
+  - Sidebar field navigator with schema groups, active highlight, and filled/required indicators
+  - Operation bar with SET, ADD, DELETE operations (ADD/DELETE available for array fields: multi-select, tags)
+  - Per-file table with inline click-to-edit and sortable name column
+  - Staged changes with diff-only save (only modified fields are persisted)
+  - Select-all / deselect-all with three-state checkbox
+- `sfx-metadata-field-edit` dispatcher component for rendering the correct field editor by type
+- `sfx-metadata-field-view` read-only value display component
+
+### Fixed
+
+- Dropdown fields (select, multi-select, boolean) closing immediately when clicking options inside Shadow DOM — fixed outside-click detection to use `composedPath()` instead of `e.target`
+
 ## [0.2.0] - 2026-03-22
 
 ### Added
 
 - Cards layout for import-from sources (`sourcesLayout: 'cards'`) — responsive grid of square cards with large icons
 - Video thumbnail generation from first frame
-- Configurable `headerButton` option (`close`, `back`, `none`)
+- Configurable `header` option (`'close'`, `'back'`, `true`, `false`)
 - Screen capture source
 - Prev/next navigation arrows on preview image
 - Custom dropdown selects replacing native selects with preview panel scroll

package/README.md

@@ -22,7 +22,7 @@
   <a href="https://scaleflex.github.io/uploader/">Live Demo</a> |
   <a href="https://scaleflex.github.io/uploader/#/docs/getting-started">Documentation</a> |
   <a href="https://scaleflex.github.io/uploader/#/examples/basic">Examples</a> |
-  <a href="https://cdn.scaleflex.com/uploader/0.2.6/sfx-uploader.min.js">CDN</a> |
+  <a href="https://cdn.scaleflex.com/uploader/0.2.7/sfx-uploader.min.js">CDN</a> |
   <a href="https://www.npmjs.com/package/@scaleflex/uploader">npm</a> |
   <a href="https://www.scaleflex.com">Scaleflex</a>
 </p>
@@ -51,11 +51,11 @@ npm install @scaleflex/uploader
 Or use the CDN for a no-bundler setup:
 
 ```
-https://cdn.scaleflex.com/uploader/0.2.6/sfx-uploader.min.js
+https://cdn.scaleflex.com/uploader/0.2.7/sfx-uploader.min.js
 ```
 
 ```html
-<script src="https://cdn.scaleflex.com/uploader/0.2.6/sfx-uploader.min.js"></script>
+<script src="https://cdn.scaleflex.com/uploader/0.2.7/sfx-uploader.min.js"></script>
 ```
 
 ## Quick start

package/dist/components/actions-bar.d.ts

@@ -7,6 +7,8 @@ export declare class SfxActionsBar extends LitElement {
     totalSize: number;
     failedCount: number;
     showFillMetadata: boolean;
+    uploadDisabled: boolean;
+    uploadDisabledReason: string;
     completedCount: number;
     uploadProgress: number;
     private _clear;

package/dist/components/actions-bar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions-bar.d.ts","sourceRoot":"","sources":["../../src/components/actions-bar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,KAAK,CAAC;AAIrD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9D,qBAAa,aAAc,SAAQ,UAAU;IAC3C,MAAM,CAAC,MAAM,4BAoJV;IAEyB,WAAW,EAAE,iBAAiB,CAAU;IACxC,SAAS,SAAK;IACd,SAAS,SAAK;IACd,WAAW,SAAK;IACf,gBAAgB,UAAS;IAC1B,cAAc,SAAK;IACnB,cAAc,SAAK;IAE/C,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,SAAS;IAIjB,MAAM;IAkEN,OAAO,CAAC,mBAAmB;CAgC5B"}
+{"version":3,"file":"actions-bar.d.ts","sourceRoot":"","sources":["../../src/components/actions-bar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,KAAK,CAAC;AAIrD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9D,qBAAa,aAAc,SAAQ,UAAU;IAC3C,MAAM,CAAC,MAAM,4BAoJV;IAEyB,WAAW,EAAE,iBAAiB,CAAU;IACxC,SAAS,SAAK;IACd,SAAS,SAAK;IACd,WAAW,SAAK;IACf,gBAAgB,UAAS;IACzB,cAAc,UAAS;IACxB,oBAAoB,SAAM;IAC1B,cAAc,SAAK;IACnB,cAAc,SAAK;IAE/C,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,SAAS;IAIjB,MAAM;IAkEN,OAAO,CAAC,mBAAmB;CAiC5B"}

package/dist/components/drop-zone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drop-zone.d.ts","sourceRoot":"","sources":["../../src/components/drop-zone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2C,MAAM,KAAK,CAAC;AAK1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD,qBAAa,WAAY,SAAQ,UAAU;IACzC,MAAM,CAAC,MAAM,0BA8wBX;IAE0C,OAAO,UAAS;IACE,gBAAgB,UAAS;IAC3D,MAAM,SAAM;IACb,OAAO,EAAE,SAAS,EAAE,CAAM;IACI,aAAa,EAAE,OAAO,GAAG,OAAO,CAAW;IAE3F,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAiB;IAE7B,OAAO,CAAC,SAAS,CAAe;IACrB,SAAS,EAAG,gBAAgB,CAAC;IAE1D,OAAO,CAAC,YAAY,CAAK;IAEzB,0CAA0C;IAC1C,MAAM;IAMN,OAAO,CAAC,YAAY,CAMlB;IAEF,OAAO,CAAC,WAAW,CAEjB;IAEF,OAAO,CAAC,YAAY,CAOlB;IAEF,OAAO,CAAC,OAAO,CAUb;IAIF,OAAO,CAAC,QAAQ,CAad;IAEF,OAAO,CAAC,UAAU,CAKhB;IAEF,OAAO,CAAC,aAAa,CAQnB;IAIF,OAAO,CAAC,QAAQ,CAkBd;IAEF,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,gBAAgB,CAA+B;IAEvD,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,qBAAqB;IAoC7B,OAAO,CAAC,qBAAqB;IAmB7B,qFAAqF;IACrF,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,WAAW,CAMjB;IAEF,OAAO,CAAC,aAAa,CAKnB;IAEF,OAAO,CAAC,YAAY,CAA8C;IAElE,OAAO,CAAC,iBAAiB,CAMvB;IAEF,OAAO,CAAC,mBAAmB;IAqB3B,iBAAiB;IAUjB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAMrC,oBAAoB;IAepB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,mBAAmB;IAW3B,MAAM;CAuGP"}
+{"version":3,"file":"drop-zone.d.ts","sourceRoot":"","sources":["../../src/components/drop-zone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2C,MAAM,KAAK,CAAC;AAK1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAqBhD,qBAAa,WAAY,SAAQ,UAAU;IACzC,MAAM,CAAC,MAAM,0BA8wBX;IAE0C,OAAO,UAAS;IACE,gBAAgB,UAAS;IAC3D,MAAM,SAAM;IACb,OAAO,EAAE,SAAS,EAAE,CAAM;IACI,aAAa,EAAE,OAAO,GAAG,OAAO,CAAW;IAE3F,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAiB;IAE7B,OAAO,CAAC,SAAS,CAAe;IACrB,SAAS,EAAG,gBAAgB,CAAC;IAE1D,OAAO,CAAC,YAAY,CAAK;IAEzB,0CAA0C;IAC1C,MAAM;IAMN,OAAO,CAAC,YAAY,CAMlB;IAEF,OAAO,CAAC,WAAW,CAEjB;IAEF,OAAO,CAAC,YAAY,CAOlB;IAEF,OAAO,CAAC,OAAO,CAUb;IAIF,OAAO,CAAC,QAAQ,CAad;IAEF,OAAO,CAAC,UAAU,CAKhB;IAEF,OAAO,CAAC,aAAa,CAQnB;IAIF,OAAO,CAAC,QAAQ,CAkBd;IAEF,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,gBAAgB,CAA+B;IAEvD,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,qBAAqB;IAoC7B,OAAO,CAAC,qBAAqB;IAO7B,qFAAqF;IACrF,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,WAAW,CAMjB;IAEF,OAAO,CAAC,aAAa,CAKnB;IAEF,OAAO,CAAC,YAAY,CAA8C;IAElE,OAAO,CAAC,iBAAiB,CAMvB;IAEF,OAAO,CAAC,mBAAmB;IAqB3B,iBAAiB;IAUjB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAMrC,oBAAoB;IAepB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,mBAAmB;IAW3B,MAAM;CAuGP"}

package/dist/components/file-item.d.ts

@@ -3,8 +3,14 @@ import { UploadFile } from '../store/store.types';
 export declare class SfxFileItem extends LitElement {
     static styles: import('lit').CSSResult;
     file: UploadFile;
+    private _dims;
+    updated(changed: Map<string, unknown>): void;
+    private _emit;
     private _remove;
     private _retry;
+    private _pause;
+    private _resume;
+    private _rename;
     private _preview;
     render(): typeof nothing | import('lit-html').TemplateResult<1>;
     private _formatDuration;

package/dist/components/file-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-item.d.ts","sourceRoot":"","sources":["../../src/components/file-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,OAAO,EAAE,MAAM,KAAK,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,qBAAa,WAAY,SAAQ,UAAU;IACzC,MAAM,CAAC,MAAM,0BA6XX;IAE8B,IAAI,EAAG,UAAU,CAAC;IAElD,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,QAAQ;IAWhB,MAAM;IAiHN,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,eAAe;CAcxB"}
+{"version":3,"file":"file-item.d.ts","sourceRoot":"","sources":["../../src/components/file-item.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,OAAO,EAAE,MAAM,KAAK,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,qBAAa,WAAY,SAAQ,UAAU;IACzC,MAAM,CAAC,MAAM,0BA0aX;IAE8B,IAAI,EAAG,UAAU,CAAC;IACzC,OAAO,CAAC,KAAK,CAAM;IAE5B,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;IAYrC,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IAEf,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,QAAQ;IAKhB,MAAM;IA8IN,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,eAAe;CAcxB"}

package/dist/components/file-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-list.d.ts","sourceRoot":"","sources":["../../src/components/file-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0D,MAAM,KAAK,CAAC;AAIzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,qBAAa,WAAY,SAAQ,UAAU;IACzC,MAAM,CAAC,MAAM,0BA6SX;IAE8B,KAAK,EAAE,UAAU,EAAE,CAAM;IAC5B,YAAY,UAAS;IAClB,OAAO,EAAE,SAAS,EAAE,CAAM;IAC9B,MAAM,SAAM;IAE/B,OAAO,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAA+B;IAEvD,OAAO,CAAC,oBAAoB,CAQ1B;IAEF,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,iBAAiB,CAEvB;IAEF,OAAO,CAAC,UAAU,CAMhB;IAEF,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,yBAAyB;IAoBjC,oBAAoB;IAOpB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;IA4CvB,MAAM;CAUP"}
+{"version":3,"file":"file-list.d.ts","sourceRoot":"","sources":["../../src/components/file-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0D,MAAM,KAAK,CAAC;AAIzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAmBvD,qBAAa,WAAY,SAAQ,UAAU;IACzC,MAAM,CAAC,MAAM,0BA6SX;IAE8B,KAAK,EAAE,UAAU,EAAE,CAAM;IAC5B,YAAY,UAAS;IAClB,OAAO,EAAE,SAAS,EAAE,CAAM;IAC9B,MAAM,SAAM;IAE/B,OAAO,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAA+B;IAEvD,OAAO,CAAC,oBAAoB,CAQ1B;IAEF,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,iBAAiB,CAEvB;IAEF,OAAO,CAAC,UAAU,CAMhB;IAEF,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,yBAAyB;IAOjC,oBAAoB;IAOpB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;IA4CvB,MAAM;CAUP"}

package/dist/components/toast.d.ts

@@ -0,0 +1,18 @@
+import { LitElement } from 'lit';
+export type ToastType = 'error' | 'warning' | 'info';
+/**
+ * Lightweight toast notification container.
+ * Renders stacked toasts in the bottom-right corner.
+ * Auto-dismisses after a configurable duration.
+ */
+export declare class SfxToast extends LitElement {
+    static styles: import('lit').CSSResult;
+    duration: number;
+    private _toasts;
+    private _nextId;
+    show(message: string, type?: ToastType): void;
+    private _dismiss;
+    private _iconForType;
+    render(): import('lit-html').TemplateResult<1>;
+}
+//# sourceMappingURL=toast.d.ts.map

package/dist/components/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../src/components/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,KAAK,CAAC;AAG5C,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AASrD;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,MAAM,CAAC,MAAM,0BAwFX;IAE0B,QAAQ,SAAQ;IAEnC,OAAO,CAAC,OAAO,CAAmB;IAE3C,OAAO,CAAC,OAAO,CAAK;IAEpB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAmB;IAO/C,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,YAAY;IAgBpB,MAAM;CAqBP"}

package/dist/define.cjs

@@ -1 +1 @@
-"use strict";const e=require("./sfx-uploader-C_E3gvgv.cjs"),s=(f,i)=>{typeof customElements<"u"&&!customElements.get(f)&&customElements.define(f,i)};s("sfx-uploader",e.SfxUploader);s("sfx-drop-zone",e.SfxDropZone);s("sfx-import-divider",e.SfxImportDivider);s("sfx-source-pills",e.SfxSourcePills);s("sfx-file-list",e.SfxFileList);s("sfx-file-item",e.SfxFileItem);s("sfx-success-card",e.SfxSuccessCard);s("sfx-actions-bar",e.SfxActionsBar);s("sfx-url-dialog",e.SfxUrlDialog);s("sfx-camera-dialog",e.SfxCameraDialog);s("sfx-screen-cast-dialog",e.SfxScreenCastDialog);
+"use strict";const e=require("./sfx-uploader-BqMTQWrE.cjs"),s=(f,i)=>{typeof customElements<"u"&&!customElements.get(f)&&customElements.define(f,i)};s("sfx-uploader",e.SfxUploader);s("sfx-drop-zone",e.SfxDropZone);s("sfx-import-divider",e.SfxImportDivider);s("sfx-source-pills",e.SfxSourcePills);s("sfx-file-list",e.SfxFileList);s("sfx-file-item",e.SfxFileItem);s("sfx-success-card",e.SfxSuccessCard);s("sfx-actions-bar",e.SfxActionsBar);s("sfx-url-dialog",e.SfxUrlDialog);s("sfx-camera-dialog",e.SfxCameraDialog);s("sfx-screen-cast-dialog",e.SfxScreenCastDialog);

package/dist/define.js

@@ -1,4 +1,4 @@
-import { g as f, a as i, d as o, e as r, c as l, b as x, f as t, S as c, n as d, o as S, p as m } from "./sfx-uploader-C3Z9k-Q8.js";
+import { g as f, a as i, d as o, e as r, c as l, b as x, f as t, S as c, n as d, o as S, p as m } from "./sfx-uploader-D9z-E7SI.js";
 const s = (e, a) => {
   typeof customElements < "u" && !customElements.get(e) && customElements.define(e, a);
 };

package/dist/engine/index.d.ts

@@ -1,2 +1,3 @@
 export { UploadEngine, type UploadEngineConfig } from './upload-engine';
+export { type TusConfig } from './tus-upload';
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/engine/tus-upload.d.ts

@@ -0,0 +1,52 @@
+import { UploadFile, UploadResponse } from '../store/store.types';
+import { AuthHeaders } from '../auth/auth.types';
+export interface TusConfig {
+    /** Files larger than this (bytes) use tus. Default: 10 MB. Set to 0 to always use tus. */
+    sizeThreshold?: number;
+    /** Chunk size in bytes. Default: 5 MB. */
+    chunkSize?: number;
+    /**
+     * Override the tus endpoint.
+     * Default: Scaleflex Companion (`https://eu-on-24001.connector.filerobot.com/files`).
+     */
+    endpoint?: string;
+    /** Persist upload fingerprints for cross-session resume. Default: true. */
+    resumable?: boolean;
+    /** Number of parallel chunk uploads. Default: 1. */
+    parallelChunks?: number;
+    /** tus retry delays in ms. Default: [0, 1000, 3000, 5000]. */
+    retryDelays?: number[];
+}
+export interface TusUploadOptions {
+    apiBase: string;
+    authHeaders: AuthHeaders;
+    /** Returns the latest auth headers — called before each chunk request so renewed SASS keys are picked up. */
+    getAuthHeaders?: () => AuthHeaders;
+    folder: string;
+    tusConfig: TusConfig;
+    onProgress: (bytesUploaded: number, bytesTotal: number) => void;
+    onComplete: (response: UploadResponse) => void;
+    onError: (error: Error) => void;
+    /** Called when the tus upload is paused externally (e.g. network offline). */
+    onPause?: () => void;
+    /** Called when the tus upload is resumed externally (e.g. network back online). */
+    onResume?: () => void;
+    /** Called when the tus upload URL is assigned — allows storing it for cross-session resume. */
+    onUploadUrlAvailable?: (url: string) => void;
+}
+export interface TusUploadHandle {
+    abort: () => void;
+    pause: () => void;
+    resume: () => void;
+    isPaused: () => boolean;
+}
+/**
+ * Should this file use tus instead of regular XHR?
+ */
+export declare function shouldUseTus(file: UploadFile, tusConfig: TusConfig | undefined): boolean;
+/**
+ * Upload a local File via the tus resumable upload protocol.
+ * Returns a handle with abort/pause/resume.
+ */
+export declare function tusUploadFile(uploadFile: UploadFile, opts: TusUploadOptions): TusUploadHandle;
+//# sourceMappingURL=tus-upload.d.ts.map

package/dist/engine/tus-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tus-upload.d.ts","sourceRoot":"","sources":["../../src/engine/tus-upload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAOD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,6GAA6G;IAC7G,cAAc,CAAC,EAAE,MAAM,WAAW,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,UAAU,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,UAAU,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,+FAA+F;IAC/F,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAIxF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,gBAAgB,GACrB,eAAe,CA6NjB"}

package/dist/engine/upload-engine.d.ts

@@ -1,14 +1,17 @@
 import { Store } from '../store/store';
 import { UploaderState } from '../store/store.types';
 import { AuthHeaders } from '../auth/auth.types';
+import { TusConfig } from './tus-upload';
 export interface UploadEngineConfig {
     apiBase: string;
     authHeaders: AuthHeaders;
+    tusConfig?: TusConfig;
 }
 export declare class UploadEngine {
     private store;
     private config;
     private activeUploads;
+    private pausedUploads;
     private retryTimers;
     private unsubscribe;
     constructor(store: Store<UploaderState>, config: UploadEngineConfig);
@@ -29,6 +32,16 @@ export declare class UploadEngine {
      * Retry all failed/errored files.
      */
     retryAll(): void;
+    /**
+     * Pause a single tus upload.
+     * Removes from active slots so another queued file can start (v5 pattern).
+     */
+    pauseFile(fileId: string): void;
+    /**
+     * Resume a single paused tus upload.
+     * Re-queues through processQueue so it respects concurrency limits (v5 pattern).
+     */
+    resumeFile(fileId: string): void;
     /**
      * Cancel a single file upload.
      */
@@ -49,6 +62,7 @@ export declare class UploadEngine {
     private startUpload;
     private handleComplete;
     private handleError;
+    private abortPausedUpload;
     private abortUpload;
     private updateTotalProgress;
     private checkAllComplete;

package/dist/engine/upload-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload-engine.d.ts","sourceRoot":"","sources":["../../src/engine/upload-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,WAAW,CAAoD;IACvE,OAAO,CAAC,WAAW,CAA6B;gBAEpC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,kBAAkB;IAKnE;;;OAGG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,SAAS,IAAI,IAAI;IAiBjB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAc/B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAgBhB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOhC;;OAEG;IACH,SAAS,IAAI,IAAI;IAWjB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAItD;;OAEG;IACH,OAAO,IAAI,IAAI;IAcf,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,WAAW;IAgDnB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,WAAW;IAuCnB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,gBAAgB;CAYzB"}
+{"version":3,"file":"upload-engine.d.ts","sourceRoot":"","sources":["../../src/engine/upload-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAA0B,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,EAA+B,KAAK,SAAS,EAAwB,MAAM,cAAc,CAAC;AAEjG,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,aAAa,CAAwD;IAC7E,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,WAAW,CAAoD;IACvE,OAAO,CAAC,WAAW,CAA6B;gBAEpC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,kBAAkB;IAKnE;;;OAGG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,SAAS,IAAI,IAAI;IAiBjB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAc/B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAgBhB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa/B;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAkBhC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUhC;;OAEG;IACH,SAAS,IAAI,IAAI;IAYjB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAItD;;OAEG;IACH,OAAO,IAAI,IAAI;IAiBf,OAAO,CAAC,YAAY;IAmCpB,OAAO,CAAC,WAAW;IA2EnB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,WAAW;IAuCnB,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,mBAAmB;IAgC3B,OAAO,CAAC,gBAAgB;CAazB"}

package/dist/engine/xhr-upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xhr-upload.d.ts","sourceRoot":"","sources":["../../src/engine/xhr-upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,UAAU,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,gBAAgB,GACrB,eAAe,CAgFjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAClE,eAAe,CA8DjB"}
+{"version":3,"file":"xhr-upload.d.ts","sourceRoot":"","sources":["../../src/engine/xhr-upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,UAAU,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,gBAAgB,GACrB,eAAe,CAkFjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG;IAAE,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAClE,eAAe,CA8DjB"}

package/dist/events/public-events.d.ts

@@ -7,6 +7,8 @@ export declare const PublicEvents: {
     readonly UPLOAD_COMPLETE: "sfx-upload-complete";
     readonly UPLOAD_ERROR: "sfx-upload-error";
     readonly UPLOAD_RETRY: "sfx-upload-retry";
+    readonly UPLOAD_PAUSED: "sfx-upload-paused";
+    readonly UPLOAD_RESUMED: "sfx-upload-resumed";
     readonly ALL_COMPLETE: "sfx-all-complete";
     readonly TOTAL_PROGRESS: "sfx-total-progress";
     readonly BEFORE_UPLOAD: "sfx-before-upload";

package/dist/events/public-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-events.d.ts","sourceRoot":"","sources":["../../src/events/public-events.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;CAkBf,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"public-events.d.ts","sourceRoot":"","sources":["../../src/events/public-events.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;CAoBf,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}