@spark-ui/components 11.4.1 → 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,10 +30590,10 @@
           "name": "File"
         }
       },
-      "fileIndex": {
+      "uploadProgress": {
         "defaultValue": null,
-        "description": "The index of the file in the accepted files array",
-        "name": "fileIndex",
+        "description": "Upload progress value (0-100). When provided, displays a progress bar at the bottom of the file item.",
+        "name": "uploadProgress",
         "parent": {
           "fileName": "src/file-upload/FileUploadAcceptedFile.tsx",
           "name": "FileUploadAcceptedFileProps"
@@ -30604,15 +30604,34 @@
             "name": "FileUploadAcceptedFileProps"
           }
         ],
-        "required": true,
+        "required": false,
         "type": {
           "name": "number"
         }
       },
-      "uploadProgress": {
+      "deleteButtonAriaLabel": {
         "defaultValue": null,
-        "description": "Upload progress value (0-100). When provided, displays a progress bar at the bottom of the file item.",
-        "name": "uploadProgress",
+        "description": "Accessible label for the delete button",
+        "name": "deleteButtonAriaLabel",
+        "parent": {
+          "fileName": "src/file-upload/FileUploadAcceptedFile.tsx",
+          "name": "FileUploadAcceptedFileProps"
+        },
+        "declarations": [
+          {
+            "fileName": "src/file-upload/FileUploadAcceptedFile.tsx",
+            "name": "FileUploadAcceptedFileProps"
+          }
+        ],
+        "required": true,
+        "type": {
+          "name": "string"
+        }
+      },
+      "progressAriaLabel": {
+        "defaultValue": null,
+        "description": "Accessible label for the progress bar. Required when uploadProgress is provided.",
+        "name": "progressAriaLabel",
         "parent": {
           "fileName": "src/file-upload/FileUploadAcceptedFile.tsx",
           "name": "FileUploadAcceptedFileProps"
@@ -30625,7 +30644,7 @@
         ],
         "required": false,
         "type": {
-          "name": "number"
+          "name": "string"
         }
       },
       "className": {
@@ -30682,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": "",
@@ -30731,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"
@@ -30820,7 +30757,7 @@
         ],
         "required": true,
         "type": {
-          "name": "number"
+          "name": "File"
         }
       },
       "aria-label": {
@@ -31058,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": "",
@@ -31364,10 +31167,10 @@
           "name": "RejectedFile"
         }
       },
-      "rejectedFileIndex": {
+      "renderError": {
         "defaultValue": null,
-        "description": "The index of the rejected file in the rejectedFiles array",
-        "name": "rejectedFileIndex",
+        "description": "Function to render the error message for each error code\n@param error - The error code\n@returns The error message to display",
+        "name": "renderError",
         "parent": {
           "fileName": "src/file-upload/FileUploadRejectedFile.tsx",
           "name": "FileUploadRejectedFileProps"
@@ -31380,13 +31183,13 @@
         ],
         "required": true,
         "type": {
-          "name": "number"
+          "name": "(error: FileUploadFileError) => string"
         }
       },
-      "renderError": {
+      "deleteButtonAriaLabel": {
         "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",
-        "name": "renderError",
+        "description": "Accessible label for the delete button",
+        "name": "deleteButtonAriaLabel",
         "parent": {
           "fileName": "src/file-upload/FileUploadRejectedFile.tsx",
           "name": "FileUploadRejectedFileProps"
@@ -31399,7 +31202,7 @@
         ],
         "required": true,
         "type": {
-          "name": "(error: FileUploadFileError) => string"
+          "name": "string"
         }
       },
       "className": {
@@ -31429,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"
@@ -31445,7 +31248,7 @@
         ],
         "required": true,
         "type": {
-          "name": "number"
+          "name": "RejectedFile"
         }
       },
       "aria-label": {