@spark-ui/components 11.4.2 → 11.4.3

package/dist/docgen.json

@@ -30310,10 +30310,10 @@
           "name": "File[]"
         }
       },
-      "onFilesChange": {
+      "onFileAccept": {
         "defaultValue": null,
-        "description": "Callback when files are selected",
-        "name": "onFilesChange",
+        "description": "Callback when files are accepted\n@param details - Details about the accepted files",
+        "name": "onFileAccept",
         "parent": {
           "fileName": "src/file-upload/FileUpload.tsx",
           "name": "FileUploadProps"
@@ -30326,15 +30326,13 @@
         ],
         "required": false,
         "type": {
-          "name": "(files: File[]) => void"
+          "name": "(details: FileAcceptDetails) => void"
         }
       },
-      "multiple": {
-        "defaultValue": {
-          "value": "true"
-        },
-        "description": "Whether multiple files can be selected",
-        "name": "multiple",
+      "onFileReject": {
+        "defaultValue": null,
+        "description": "Callback when files are rejected\n@param details - Details about the rejected files and their errors",
+        "name": "onFileReject",
         "parent": {
           "fileName": "src/file-upload/FileUpload.tsx",
           "name": "FileUploadProps"
@@ -30347,13 +30345,13 @@
         ],
         "required": false,
         "type": {
-          "name": "boolean"
+          "name": "(details: FileRejectDetails) => void"
         }
       },
-      "accept": {
+      "onFileChange": {
         "defaultValue": null,
-        "description": "Comma-separated list of accepted file types\nSupports MIME types (e.g., \"image/*\", \"image/png\", \"application/pdf\")\nand file extensions (e.g., \".pdf\", \".doc\", \".jpg\")\n@example \"image/*\"\n@example \".pdf,.doc\"\n@example \"image/png,image/jpeg,.pdf\"",
-        "name": "accept",
+        "description": "Callback when files change (both accepted and rejected)\nFor controlled mode, use this to update the value prop by extracting details.acceptedFiles\n@param details - Details about both accepted and rejected files",
+        "name": "onFileChange",
         "parent": {
           "fileName": "src/file-upload/FileUpload.tsx",
           "name": "FileUploadProps"
@@ -30366,13 +30364,15 @@
         ],
         "required": false,
         "type": {
-          "name": "string"
+          "name": "(details: FileChangeDetails) => void"
         }
       },
-      "maxFiles": {
-        "defaultValue": null,
-        "description": "Maximum number of files that can be uploaded\nFiles beyond this limit will be rejected",
-        "name": "maxFiles",
+      "multiple": {
+        "defaultValue": {
+          "value": "true"
+        },
+        "description": "Whether multiple files can be selected",
+        "name": "multiple",
         "parent": {
           "fileName": "src/file-upload/FileUpload.tsx",
           "name": "FileUploadProps"
@@ -30385,13 +30385,13 @@
         ],
         "required": false,
         "type": {
-          "name": "number"
+          "name": "boolean"
         }
       },
-      "onMaxFilesReached": {
+      "accept": {
         "defaultValue": null,
-        "description": "Callback when the maximum number of files is reached\n@param maxFiles - The maximum number of files allowed\n@param rejectedCount - The number of files that were rejected",
-        "name": "onMaxFilesReached",
+        "description": "Comma-separated list of accepted file types\nSupports MIME types (e.g., \"image/*\", \"image/png\", \"application/pdf\")\nand file extensions (e.g., \".pdf\", \".doc\", \".jpg\")\n@example \"image/*\"\n@example \".pdf,.doc\"\n@example \"image/png,image/jpeg,.pdf\"",
+        "name": "accept",
         "parent": {
           "fileName": "src/file-upload/FileUpload.tsx",
           "name": "FileUploadProps"
@@ -30404,13 +30404,13 @@
         ],
         "required": false,
         "type": {
-          "name": "(maxFiles: number, rejectedCount: number) => void"
+          "name": "string"
         }
       },
-      "maxFileSize": {
+      "maxFiles": {
         "defaultValue": null,
-        "description": "Maximum file size in bytes\nFiles larger than this will be rejected",
-        "name": "maxFileSize",
+        "description": "Maximum number of files that can be uploaded\nFiles beyond this limit will be rejected",
+        "name": "maxFiles",
         "parent": {
           "fileName": "src/file-upload/FileUpload.tsx",
           "name": "FileUploadProps"
@@ -30426,10 +30426,10 @@
           "name": "number"
         }
       },
-      "minFileSize": {
+      "maxFileSize": {
         "defaultValue": null,
-        "description": "Minimum file size in bytes\nFiles smaller than this will be rejected",
-        "name": "minFileSize",
+        "description": "Maximum file size in bytes\nFiles larger than this will be rejected",
+        "name": "maxFileSize",
         "parent": {
           "fileName": "src/file-upload/FileUpload.tsx",
           "name": "FileUploadProps"
@@ -30445,10 +30445,10 @@
           "name": "number"
         }
       },
-      "onFileSizeError": {
+      "minFileSize": {
         "defaultValue": null,
-        "description": "Callback when a file size validation error occurs\n@param file - The file that failed validation\n@param error - The error message",
-        "name": "onFileSizeError",
+        "description": "Minimum file size in bytes\nFiles smaller than this will be rejected",
+        "name": "minFileSize",
         "parent": {
           "fileName": "src/file-upload/FileUpload.tsx",
           "name": "FileUploadProps"
@@ -30461,7 +30461,7 @@
         ],
         "required": false,
         "type": {
-          "name": "(file: File, error: string) => void"
+          "name": "number"
         }
       },
       "disabled": {
@@ -30590,25 +30590,6 @@
           "name": "File"
         }
       },
-      "fileIndex": {
-        "defaultValue": null,
-        "description": "The index of the file in the accepted files array",
-        "name": "fileIndex",
-        "parent": {
-          "fileName": "src/file-upload/FileUploadAcceptedFile.tsx",
-          "name": "FileUploadAcceptedFileProps"
-        },
-        "declarations": [
-          {
-            "fileName": "src/file-upload/FileUploadAcceptedFile.tsx",
-            "name": "FileUploadAcceptedFileProps"
-          }
-        ],
-        "required": true,
-        "type": {
-          "name": "number"
-        }
-      },
       "uploadProgress": {
         "defaultValue": null,
         "description": "Upload progress value (0-100). When provided, displays a progress bar at the bottom of the file item.",
@@ -30720,21 +30701,6 @@
     "displayName": "Dropzone",
     "methods": [],
     "props": {
-      "onFiles": {
-        "defaultValue": null,
-        "description": "",
-        "name": "onFiles",
-        "declarations": [
-          {
-            "fileName": "src/file-upload/FileUploadDropzone.tsx",
-            "name": "TypeLiteral"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "(files: FileList) => void"
-        }
-      },
       "className": {
         "defaultValue": null,
         "description": "",
@@ -30769,83 +30735,16 @@
       }
     }
   },
-  "FileUpload.Item": {
-    "tags": {},
-    "description": "",
-    "displayName": "FileUpload.Item",
-    "methods": [],
-    "props": {
-      "asChild": {
-        "defaultValue": {
-          "value": false
-        },
-        "description": "Change the default rendered element for the one passed as a child, merging their props and behavior.",
-        "name": "asChild",
-        "parent": {
-          "fileName": "components/src/file-upload/FileUploadItem.tsx",
-          "name": "FileUploadItemProps"
-        },
-        "declarations": [
-          {
-            "fileName": "components/src/file-upload/FileUploadItem.tsx",
-            "name": "FileUploadItemProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "boolean"
-        }
-      },
-      "ref": {
-        "defaultValue": null,
-        "description": "",
-        "name": "ref",
-        "parent": {
-          "fileName": "components/src/file-upload/FileUploadItem.tsx",
-          "name": "FileUploadItemProps"
-        },
-        "declarations": [
-          {
-            "fileName": "components/src/file-upload/FileUploadItem.tsx",
-            "name": "FileUploadItemProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "Ref<HTMLLIElement>"
-        }
-      },
-      "className": {
-        "defaultValue": null,
-        "description": "",
-        "name": "className",
-        "parent": {
-          "fileName": "components/src/file-upload/FileUploadItem.tsx",
-          "name": "FileUploadItemProps"
-        },
-        "declarations": [
-          {
-            "fileName": "components/src/file-upload/FileUploadItem.tsx",
-            "name": "FileUploadItemProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "string"
-        }
-      }
-    }
-  },
   "FileUpload.ItemDeleteTrigger": {
     "tags": {},
     "description": "",
     "displayName": "FileUpload.ItemDeleteTrigger",
     "methods": [],
     "props": {
-      "fileIndex": {
+      "file": {
         "defaultValue": null,
-        "description": "Index of the file to delete",
-        "name": "fileIndex",
+        "description": "The file to delete",
+        "name": "file",
         "parent": {
           "fileName": "components/src/file-upload/FileUploadItemDeleteTrigger.tsx",
           "name": "FileUploadItemDeleteTriggerProps"
@@ -30858,7 +30757,7 @@
         ],
         "required": true,
         "type": {
-          "name": "number"
+          "name": "File"
         }
       },
       "aria-label": {
@@ -31096,140 +30995,6 @@
       }
     }
   },
-  "FileUpload.ItemFileName": {
-    "tags": {},
-    "description": "",
-    "displayName": "FileUpload.ItemFileName",
-    "methods": [],
-    "props": {
-      "asChild": {
-        "defaultValue": {
-          "value": false
-        },
-        "description": "Change the default rendered element for the one passed as a child, merging their props and behavior.",
-        "name": "asChild",
-        "parent": {
-          "fileName": "components/src/file-upload/FileUploadItemFileName.tsx",
-          "name": "FileUploadItemFileNameProps"
-        },
-        "declarations": [
-          {
-            "fileName": "components/src/file-upload/FileUploadItemFileName.tsx",
-            "name": "FileUploadItemFileNameProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "boolean"
-        }
-      },
-      "ref": {
-        "defaultValue": null,
-        "description": "",
-        "name": "ref",
-        "parent": {
-          "fileName": "components/src/file-upload/FileUploadItemFileName.tsx",
-          "name": "FileUploadItemFileNameProps"
-        },
-        "declarations": [
-          {
-            "fileName": "components/src/file-upload/FileUploadItemFileName.tsx",
-            "name": "FileUploadItemFileNameProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "Ref<HTMLParagraphElement>"
-        }
-      },
-      "className": {
-        "defaultValue": null,
-        "description": "",
-        "name": "className",
-        "parent": {
-          "fileName": "components/src/file-upload/FileUploadItemFileName.tsx",
-          "name": "FileUploadItemFileNameProps"
-        },
-        "declarations": [
-          {
-            "fileName": "components/src/file-upload/FileUploadItemFileName.tsx",
-            "name": "FileUploadItemFileNameProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "string"
-        }
-      }
-    }
-  },
-  "FileUpload.ItemSizeText": {
-    "tags": {},
-    "description": "",
-    "displayName": "FileUpload.ItemSizeText",
-    "methods": [],
-    "props": {
-      "asChild": {
-        "defaultValue": {
-          "value": false
-        },
-        "description": "Change the default rendered element for the one passed as a child, merging their props and behavior.",
-        "name": "asChild",
-        "parent": {
-          "fileName": "components/src/file-upload/FileUploadItemSizeText.tsx",
-          "name": "FileUploadItemSizeTextProps"
-        },
-        "declarations": [
-          {
-            "fileName": "components/src/file-upload/FileUploadItemSizeText.tsx",
-            "name": "FileUploadItemSizeTextProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "boolean"
-        }
-      },
-      "ref": {
-        "defaultValue": null,
-        "description": "",
-        "name": "ref",
-        "parent": {
-          "fileName": "components/src/file-upload/FileUploadItemSizeText.tsx",
-          "name": "FileUploadItemSizeTextProps"
-        },
-        "declarations": [
-          {
-            "fileName": "components/src/file-upload/FileUploadItemSizeText.tsx",
-            "name": "FileUploadItemSizeTextProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "Ref<HTMLParagraphElement>"
-        }
-      },
-      "className": {
-        "defaultValue": null,
-        "description": "",
-        "name": "className",
-        "parent": {
-          "fileName": "components/src/file-upload/FileUploadItemSizeText.tsx",
-          "name": "FileUploadItemSizeTextProps"
-        },
-        "declarations": [
-          {
-            "fileName": "components/src/file-upload/FileUploadItemSizeText.tsx",
-            "name": "FileUploadItemSizeTextProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "string"
-        }
-      }
-    }
-  },
   "FileUpload.PreviewImage": {
     "tags": {},
     "description": "",
@@ -31402,25 +31167,6 @@
           "name": "RejectedFile"
         }
       },
-      "rejectedFileIndex": {
-        "defaultValue": null,
-        "description": "The index of the rejected file in the rejectedFiles array",
-        "name": "rejectedFileIndex",
-        "parent": {
-          "fileName": "src/file-upload/FileUploadRejectedFile.tsx",
-          "name": "FileUploadRejectedFileProps"
-        },
-        "declarations": [
-          {
-            "fileName": "src/file-upload/FileUploadRejectedFile.tsx",
-            "name": "FileUploadRejectedFileProps"
-          }
-        ],
-        "required": true,
-        "type": {
-          "name": "number"
-        }
-      },
       "renderError": {
         "defaultValue": null,
         "description": "Function to render the error message for each error code\n@param error - The error code\n@returns The error message to display",
@@ -31486,10 +31232,10 @@
     "displayName": "FileUpload.RejectedFileDeleteTrigger",
     "methods": [],
     "props": {
-      "rejectedFileIndex": {
+      "rejectedFile": {
         "defaultValue": null,
-        "description": "Index of the rejected file to remove",
-        "name": "rejectedFileIndex",
+        "description": "The rejected file to remove",
+        "name": "rejectedFile",
         "parent": {
           "fileName": "components/src/file-upload/FileUploadRejectedFileDeleteTrigger.tsx",
           "name": "FileUploadRejectedFileDeleteTriggerProps"
@@ -31502,7 +31248,7 @@
         ],
         "required": true,
         "type": {
-          "name": "number"
+          "name": "RejectedFile"
         }
       },
       "aria-label": {

package/dist/file-upload/index.d.mts

@@ -23,9 +23,21 @@ interface FileUploadProps {
      */
     value?: File[];
     /**
-     * Callback when files are selected
+     * Callback when files are accepted
+     * @param details - Details about the accepted files
      */
-    onFilesChange?: (files: File[]) => void;
+    onFileAccept?: (details: FileAcceptDetails) => void;
+    /**
+     * Callback when files are rejected
+     * @param details - Details about the rejected files and their errors
+     */
+    onFileReject?: (details: FileRejectDetails) => void;
+    /**
+     * Callback when files change (both accepted and rejected)
+     * For controlled mode, use this to update the value prop by extracting details.acceptedFiles
+     * @param details - Details about both accepted and rejected files
+     */
+    onFileChange?: (details: FileChangeDetails) => void;
     /**
      * Whether multiple files can be selected
      * @default true
@@ -45,12 +57,6 @@ interface FileUploadProps {
      * Files beyond this limit will be rejected
      */
     maxFiles?: number;
-    /**
-     * Callback when the maximum number of files is reached
-     * @param maxFiles - The maximum number of files allowed
-     * @param rejectedCount - The number of files that were rejected
-     */
-    onMaxFilesReached?: (maxFiles: number, rejectedCount: number) => void;
     /**
      * Maximum file size in bytes
      * Files larger than this will be rejected
@@ -61,12 +67,6 @@ interface FileUploadProps {
      * Files smaller than this will be rejected
      */
     minFileSize?: number;
-    /**
-     * Callback when a file size validation error occurs
-     * @param file - The file that failed validation
-     * @param error - The error message
-     */
-    onFileSizeError?: (file: File, error: string) => void;
     /**
      * When `true`, prevents the user from interacting with the file upload
      */
@@ -87,8 +87,18 @@ interface RejectedFile$1 {
     file: File;
     errors: FileUploadFileError[];
 }
+interface FileAcceptDetails {
+    files: File[];
+}
+interface FileRejectDetails {
+    files: RejectedFile$1[];
+}
+interface FileChangeDetails {
+    acceptedFiles: File[];
+    rejectedFiles: RejectedFile$1[];
+}
 declare const FileUpload$1: {
-    ({ asChild: _asChild, children, defaultValue, value: controlledValue, onFilesChange, multiple, accept, maxFiles, onMaxFilesReached, maxFileSize, minFileSize, onFileSizeError, disabled, readOnly, locale, }: FileUploadProps): react_jsx_runtime.JSX.Element;
+    ({ asChild: _asChild, children, defaultValue, value: controlledValue, onFileAccept, onFileReject, onFileChange, multiple, accept, maxFiles, maxFileSize, minFileSize, disabled, readOnly, locale, }: FileUploadProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
@@ -102,10 +112,6 @@ interface FileUploadAcceptedFileProps extends ComponentPropsWithoutRef<'li'> {
      * The file to display
      */
     file: File;
-    /**
-     * The index of the file in the accepted files array
-     */
-    fileIndex: number;
     /**
      * Upload progress value (0-100). When provided, displays a progress bar at the bottom of the file item.
      */
@@ -121,7 +127,7 @@ interface FileUploadAcceptedFileProps extends ComponentPropsWithoutRef<'li'> {
     className?: string;
 }
 declare const AcceptedFile: {
-    ({ asChild: _asChild, className, file, fileIndex, uploadProgress, deleteButtonAriaLabel, progressAriaLabel, ...props }: FileUploadAcceptedFileProps): react_jsx_runtime.JSX.Element;
+    ({ asChild: _asChild, className, file, uploadProgress, deleteButtonAriaLabel, progressAriaLabel, ...props }: FileUploadAcceptedFileProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
@@ -141,9 +147,8 @@ declare const Context: {
     displayName: string;
 };
 
-declare function Dropzone({ children, onFiles, className, unstyled, }: {
+declare function Dropzone({ children, className, unstyled, }: {
     children?: React.ReactNode;
-    onFiles?: (files: FileList) => void;
     className?: string;
     unstyled?: boolean;
 }): react_jsx_runtime.JSX.Element;
@@ -151,56 +156,14 @@ declare namespace Dropzone {
     var displayName: string;
 }
 
-interface FileUploadItemProps extends ComponentPropsWithoutRef<'li'> {
-    /**
-     * Change the default rendered element for the one passed as a child, merging their props and behavior.
-     */
-    asChild?: boolean;
-    ref?: Ref<HTMLLIElement>;
-    children: ReactNode;
-    className?: string;
-}
-declare const Item: {
-    ({ asChild: _asChild, className, children, ...props }: FileUploadItemProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-
 interface FileUploadItemDeleteTriggerProps extends React.ComponentProps<typeof IconButton> {
     /**
-     * Index of the file to delete
+     * The file to delete
      */
-    fileIndex: number;
+    file: File;
 }
 declare const ItemDeleteTrigger: {
-    ({ className, fileIndex, onClick, ...props }: FileUploadItemDeleteTriggerProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-
-interface FileUploadItemFileNameProps extends ComponentPropsWithoutRef<'p'> {
-    /**
-     * Change the default rendered element for the one passed as a child, merging their props and behavior.
-     */
-    asChild?: boolean;
-    ref?: Ref<HTMLParagraphElement>;
-    className?: string;
-    children?: ReactNode;
-}
-declare const ItemFileName: {
-    ({ asChild: _asChild, className, children, ...props }: FileUploadItemFileNameProps): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-
-interface FileUploadItemSizeTextProps extends ComponentPropsWithoutRef<'p'> {
-    /**
-     * Change the default rendered element for the one passed as a child, merging their props and behavior.
-     */
-    asChild?: boolean;
-    ref?: Ref<HTMLParagraphElement>;
-    className?: string;
-    children?: ReactNode;
-}
-declare const ItemSizeText: {
-    ({ asChild: _asChild, className, children, ...props }: FileUploadItemSizeTextProps): react_jsx_runtime.JSX.Element;
+    ({ className, file, onClick, ...props }: FileUploadItemDeleteTriggerProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
@@ -235,10 +198,6 @@ interface FileUploadRejectedFileProps extends ComponentPropsWithoutRef<'li'> {
      * The rejected file to display
      */
     rejectedFile: RejectedFile$1;
-    /**
-     * The index of the rejected file in the rejectedFiles array
-     */
-    rejectedFileIndex: number;
     /**
      * Function to render the error message for each error code
      * @param error - The error code
@@ -252,18 +211,18 @@ interface FileUploadRejectedFileProps extends ComponentPropsWithoutRef<'li'> {
     className?: string;
 }
 declare const RejectedFile: {
-    ({ asChild: _asChild, className, rejectedFile, rejectedFileIndex, renderError, deleteButtonAriaLabel, ...props }: FileUploadRejectedFileProps): react_jsx_runtime.JSX.Element;
+    ({ asChild: _asChild, className, rejectedFile, renderError, deleteButtonAriaLabel, ...props }: FileUploadRejectedFileProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
 interface FileUploadRejectedFileDeleteTriggerProps extends React.ComponentProps<typeof IconButton> {
     /**
-     * Index of the rejected file to remove
+     * The rejected file to remove
      */
-    rejectedFileIndex: number;
+    rejectedFile: RejectedFile$1;
 }
 declare const RejectedFileDeleteTrigger: {
-    ({ className, rejectedFileIndex, onClick, ...props }: FileUploadRejectedFileDeleteTriggerProps): react_jsx_runtime.JSX.Element;
+    ({ className, rejectedFile, onClick, ...props }: FileUploadRejectedFileDeleteTriggerProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
@@ -282,9 +241,6 @@ declare const FileUpload: typeof FileUpload$1 & {
     Trigger: typeof Trigger;
     Dropzone: typeof Dropzone;
     Context: typeof Context;
-    Item: typeof Item;
-    ItemFileName: typeof ItemFileName;
-    ItemSizeText: typeof ItemSizeText;
     ItemDeleteTrigger: typeof ItemDeleteTrigger;
     PreviewImage: typeof PreviewImage;
     AcceptedFile: typeof AcceptedFile;
@@ -292,4 +248,4 @@ declare const FileUpload: typeof FileUpload$1 & {
     RejectedFileDeleteTrigger: typeof RejectedFileDeleteTrigger;
 };
 
-export { FileUpload, type FileUploadFileError, type RejectedFile$1 as RejectedFile };
+export { type FileAcceptDetails, type FileChangeDetails, type FileRejectDetails, FileUpload, type FileUploadFileError, type RejectedFile$1 as RejectedFile };