@xlabs-store/core 0.0.1 → 0.0.2

package/dist/types/components/x-upload/x-upload.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from '../../stencil-public-runtime';
-import type { UploadFile, UploadListType, UploadMethod, UploadChangeEventDetail, UploadRemoveEventDetail, UploadPreviewEventDetail, UploadDownloadEventDetail, UploadDropEventDetail, ShowUploadListOptions, UploadClassNames, UploadStyles, UploadProgressOptions } from './types';
+import type { UploadFile, UploadListType, UploadMethod, UploadChangeEventDetail, UploadRemoveEventDetail, UploadPreviewEventDetail, UploadDownloadEventDetail, UploadDropEventDetail, ShowUploadListOptions, UploadClassNames, UploadStyles, UploadProgressOptions, UploadErrorEventDetail } from './types';
 /**
  * @component x-upload
  * @description Upload component for selecting and uploading files following Ant Design specification.
@@ -61,7 +61,7 @@ export declare class XUpload {
      * @example
      * <x-upload fileList={[{ uid: '1', name: 'a.png', status: 'done' }]}></x-upload>
      */
-    fileList?: UploadFile[];
+    fileList?: any;
     /**
      * Default list of files that have been uploaded
      * @example
@@ -134,6 +134,19 @@ export declare class XUpload {
      * <x-upload progress={{ strokeWidth: 2 }}></x-upload>
      */
     progress?: UploadProgressOptions;
+    /**
+     * Maximum file size in bytes
+     * @example
+     * <x-upload maxFileSize={1024 * 1024 * 10}></x-upload>
+     */
+    maxFileSize?: number;
+    /**
+     * Hook function which will be executed before uploading.
+     * Returning false or a Promise which then is rejected will stop uploading.
+     * @example
+     * <x-upload beforeUpload={(file) => file.size < 1024 * 1024}></x-upload>
+     */
+    beforeUpload?: (file: File, fileList: File[]) => boolean | Promise<any>;
     /**
      * Custom class names for semantic DOM
      * @example
@@ -176,6 +189,12 @@ export declare class XUpload {
      * <x-upload onXDrop={(ev) => console.log(ev.detail)}></x-upload>
      */
     xDrop: EventEmitter<UploadDropEventDetail>;
+    /**
+     * Callback when validation fails (maxCount, maxFileSize, beforeUpload)
+     * @example
+     * <x-upload onXError={(ev) => message.error(ev.detail.message)}></x-upload>
+     */
+    xError: EventEmitter<UploadErrorEventDetail>;
     /**
      * Internal file list for uncontrolled mode.
      */
@@ -200,6 +219,8 @@ export declare class XUpload {
      * 2. If not, check if `defaultFileList` is provided.
      * 3. Initialize `internalFileList` with the found list or an empty array.
      */
+    private normalizeFileList;
+    private createFileFromUrl;
     componentWillLoad(): void;
     /**
      * Abort pending uploads on disconnect.
@@ -214,7 +235,7 @@ export declare class XUpload {
      * Sync internal file list when controlled list changes.
      * @param newValue - New file list.
      */
-    handleFileListChange(newValue: UploadFile[]): void;
+    handleFileListChange(newValue: any): void;
     /**
      * Manually trigger file upload for a specific file.
      * @param file - File entry to upload.
@@ -246,10 +267,10 @@ export declare class XUpload {
      *
      * Flow:
      * 1. Filter files based on `maxCount`.
-     * 2. Map `File` objects to `UploadFile` structure with initial 'uploading' status.
-     * 3. Update `internalFileList` (replace if maxCount is 1, otherwise append).
-     * 4. Emit `xChange` event for each new file.
-     * 5. Initiate upload if `action` is provided, otherwise mark as 'done'.
+     * 2. Validate files with `maxFileSize` and `beforeUpload` hook.
+     * 3. Map `File` objects to `UploadFile` structure.
+     * 4. Update `internalFileList` (replace if maxCount is 1, otherwise append).
+     * 5. Emit `xChange` event for each new file.
      * @param files - Array of File objects to process.
      */
     private processFiles;
@@ -312,6 +333,12 @@ export declare class XUpload {
      * @returns ShowUploadListOptions.
      */
     private getShowUploadListOptions;
+    /**
+     * Check if a file is accepted based on the 'accept' prop.
+     * @param file - File object.
+     * @returns boolean.
+     */
+    private isAcceptedFile;
     /**
      * Check if a file is an image based on type or extension.
      * @param file - File entry.