feat(uploader): add headless API for programmatic control

packages/uploader-server/CHANGELOG.md

@@ -1,4 +1,4 @@
-## 0.3.17 (December 22, 2025)
+## 0.3.18 (December 22, 2025)
 
 - feat(uploader): add headless API for programmatic control
 

packages/uploader-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocklet/uploader-server",
-  "version": "0.3.17",
+  "version": "0.3.18",
   "description": "blocklet upload server",
   "publishConfig": {
     "access": "public"

packages/uploader-server/version

@@ -1 +1 @@
-0.3.17
+0.3.18

packages/uploader/CHANGELOG.md

@@ -1,4 +1,5 @@
-## 0.3.17 (December 22, 2025)
+## 0.3.18 (December 22, 2025)
+
 
 - feat(uploader): add headless API for programmatic control
 

packages/uploader/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocklet/uploader",
-  "version": "0.3.17",
+  "version": "0.3.18",
   "description": "blocklet upload component",
   "publishConfig": {
     "access": "public"

packages/uploader/src/react/uploader.tsx

@@ -923,6 +923,7 @@ export function Uploader({
         source,
       });
     });
+
     if (autoUpload) {
       state.uppy.upload();
     }
@@ -996,17 +997,11 @@ export function Uploader({
         getUploader: () => state.uppy,
         open,
         close,
+
         // Headless API
         triggerFileInput,
         getDropzoneProps,
-        addFiles: (files: File[], options?: { autoUpload?: boolean }) => {
-          addFilesToUppy(files, 'local', options?.autoUpload !== false);
-        },
-        upload: () => state.uppy.upload(),
-        getProgress: () => state.uppy.getState().totalProgress,
-        getFiles: () => state.uppy.getFiles(),
-        removeFile: (fileId: string) => state.uppy.removeFile(fileId),
-        cancelAll: () => state.uppy.cancelAll(),
+        addFilesToUppy,
       } as UploaderRef)
   );
 

packages/uploader/src/types.ts

@@ -16,28 +16,12 @@ export interface DropzoneProps {
 }
 
 export type UploaderRef = {
-  /** 获取底层 Uppy 实例 */
   getUploader: () => Uppy;
-  /** 打开上传器 (Dashboard) */
   open: (pluginName?: string) => void;
-  /** 关闭上传器 */
   close: () => void;
-  /** 触发系统文件选择器 */
   triggerFileInput: (options?: { accept?: string; multiple?: boolean; autoUpload?: boolean }) => void;
-  /** 获取拖拽区域 props，绑定到元素即可支持拖拽+点击上传 */
   getDropzoneProps: (options?: { autoUpload?: boolean; noClick?: boolean }) => DropzoneProps;
-  /** 批量添加文件 */
-  addFiles: (files: File[], options?: { autoUpload?: boolean }) => void;
-  /** 开始上传 */
-  upload: () => Promise<any>;
-  /** 获取当前总进度 0-100 */
-  getProgress: () => number;
-  /** 获取当前文件列表 */
-  getFiles: () => UppyFile[];
-  /** 移除指定文件 */
-  removeFile: (fileId: string) => void;
-  /** 取消所有上传 */
-  cancelAll: () => void;
+  addFilesToUppy: (files: File[], source: string, autoUpload: boolean) => void;
 };
 
 export type UploaderProps = {

packages/uploader/version

@@ -1 +1 @@
-0.3.17
+0.3.18