@spark-ui/components 11.5.0 → 11.6.0

package/dist/docgen.json

@@ -30524,27 +30524,6 @@
     "displayName": "FileUpload.AcceptedFile",
     "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": "src/file-upload/FileUploadAcceptedFile.tsx",
-          "name": "FileUploadAcceptedFileProps"
-        },
-        "declarations": [
-          {
-            "fileName": "src/file-upload/FileUploadAcceptedFile.tsx",
-            "name": "FileUploadAcceptedFileProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "boolean"
-        }
-      },
       "ref": {
         "defaultValue": null,
         "description": "",
@@ -30728,6 +30707,13 @@
       }
     }
   },
+  "DropzoneContext": {
+    "tags": {},
+    "description": "",
+    "displayName": "DropzoneContext",
+    "methods": [],
+    "props": {}
+  },
   "FileUpload.ItemDeleteTrigger": {
     "tags": {},
     "description": "",
@@ -30994,27 +30980,6 @@
     "displayName": "FileUpload.PreviewImage",
     "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": "src/file-upload/FileUploadPreviewImage.tsx",
-          "name": "FileUploadPreviewImageProps"
-        },
-        "declarations": [
-          {
-            "fileName": "src/file-upload/FileUploadPreviewImage.tsx",
-            "name": "FileUploadPreviewImageProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "boolean"
-        }
-      },
       "ref": {
         "defaultValue": null,
         "description": "",
@@ -31101,27 +31066,6 @@
     "displayName": "FileUpload.RejectedFile",
     "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": "src/file-upload/FileUploadRejectedFile.tsx",
-          "name": "FileUploadRejectedFileProps"
-        },
-        "declarations": [
-          {
-            "fileName": "src/file-upload/FileUploadRejectedFile.tsx",
-            "name": "FileUploadRejectedFileProps"
-          }
-        ],
-        "required": false,
-        "type": {
-          "name": "boolean"
-        }
-      },
       "ref": {
         "defaultValue": null,
         "description": "",
@@ -31596,7 +31540,9 @@
         }
       },
       "size": {
-        "defaultValue": null,
+        "defaultValue": {
+          "value": "md"
+        },
         "description": "Size of the button.",
         "name": "size",
         "declarations": [],
@@ -31666,7 +31612,9 @@
         }
       },
       "shape": {
-        "defaultValue": null,
+        "defaultValue": {
+          "value": "rounded"
+        },
         "description": "Shape of the button.",
         "name": "shape",
         "declarations": [],
@@ -31756,6 +31704,55 @@
       }
     }
   },
+  "FILE_UPLOAD_ERRORS": {
+    "tags": {},
+    "description": "File upload error codes",
+    "displayName": "FILE_UPLOAD_ERRORS",
+    "methods": [],
+    "props": {}
+  },
+  "TOO_MANY_FILES": {
+    "tags": {},
+    "description": "Exceeds the maxFiles limit",
+    "displayName": "TOO_MANY_FILES",
+    "methods": [],
+    "props": {}
+  },
+  "FILE_INVALID_TYPE": {
+    "tags": {},
+    "description": "File type not in the accept list",
+    "displayName": "FILE_INVALID_TYPE",
+    "methods": [],
+    "props": {}
+  },
+  "FILE_TOO_LARGE": {
+    "tags": {},
+    "description": "File size exceeds maxFileSize",
+    "displayName": "FILE_TOO_LARGE",
+    "methods": [],
+    "props": {}
+  },
+  "FILE_TOO_SMALL": {
+    "tags": {},
+    "description": "File size below minFileSize",
+    "displayName": "FILE_TOO_SMALL",
+    "methods": [],
+    "props": {}
+  },
+  "FILE_INVALID": {
+    "tags": {},
+    "description": "Generic validation failure",
+    "displayName": "FILE_INVALID",
+    "methods": [],
+    "props": {}
+  },
+  "FILE_EXISTS": {
+    "tags": {},
+    "description": "Duplicate file detected",
+    "displayName": "FILE_EXISTS",
+    "methods": [],
+    "props": {}
+  },
   "uploadFiles": {
     "tags": {
       "param": "input - The file input element\nfiles - Single file or array of files to upload"
@@ -31765,6 +31762,269 @@
     "methods": [],
     "props": {}
   },
+  "useFileUploadState": {
+    "tags": {},
+    "description": "Hook that manages file upload state, validation, and file operations",
+    "displayName": "useFileUploadState",
+    "methods": [],
+    "props": {
+      "defaultValue": {
+        "defaultValue": {
+          "value": "[]"
+        },
+        "description": "Initial files to display when the component mounts (uncontrolled mode)",
+        "name": "defaultValue",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "File[]"
+        }
+      },
+      "value": {
+        "defaultValue": null,
+        "description": "Controlled files value (controlled mode)\nWhen provided, the component becomes controlled",
+        "name": "value",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "File[]"
+        }
+      },
+      "onFileAccept": {
+        "defaultValue": null,
+        "description": "Callback when files are accepted",
+        "name": "onFileAccept",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "(details: FileAcceptDetails) => void"
+        }
+      },
+      "onFileReject": {
+        "defaultValue": null,
+        "description": "Callback when files are rejected",
+        "name": "onFileReject",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "(details: FileRejectDetails) => void"
+        }
+      },
+      "onFileChange": {
+        "defaultValue": null,
+        "description": "Callback when files change (both accepted and rejected)\nFor controlled mode, use this to update the value prop by extracting details.acceptedFiles",
+        "name": "onFileChange",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "(details: FileChangeDetails) => void"
+        }
+      },
+      "multiple": {
+        "defaultValue": {
+          "value": true
+        },
+        "description": "Whether multiple files can be selected",
+        "name": "multiple",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "boolean"
+        }
+      },
+      "accept": {
+        "defaultValue": null,
+        "description": "Comma-separated list of accepted file types",
+        "name": "accept",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "string"
+        }
+      },
+      "maxFiles": {
+        "defaultValue": null,
+        "description": "Maximum number of files that can be uploaded",
+        "name": "maxFiles",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "number"
+        }
+      },
+      "maxFileSize": {
+        "defaultValue": null,
+        "description": "Maximum file size in bytes",
+        "name": "maxFileSize",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "number"
+        }
+      },
+      "minFileSize": {
+        "defaultValue": null,
+        "description": "Minimum file size in bytes",
+        "name": "minFileSize",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "number"
+        }
+      },
+      "disabled": {
+        "defaultValue": {
+          "value": false
+        },
+        "description": "When `true`, prevents the user from interacting with the file upload",
+        "name": "disabled",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "boolean"
+        }
+      },
+      "readOnly": {
+        "defaultValue": {
+          "value": false
+        },
+        "description": "When `true`, sets the file upload to read-only mode",
+        "name": "readOnly",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "boolean"
+        }
+      },
+      "locale": {
+        "defaultValue": null,
+        "description": "The [BCP47](https://www.ietf.org/rfc/bcp/bcp47.txt) language code for the locale.\nUsed for formatting file sizes and error messages.",
+        "name": "locale",
+        "parent": {
+          "fileName": "components/src/file-upload/useFileUploadState.tsx",
+          "name": "UseFileUploadStateProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/file-upload/useFileUploadState.tsx",
+            "name": "UseFileUploadStateProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "string"
+        }
+      }
+    }
+  },
   "validateFileAccept": {
     "tags": {},
     "description": "Validates if a file matches the accept patterns\nSupports MIME types (e.g., \"image/*\", \"image/png\", \"application/pdf\")\nand file extensions (e.g., \".pdf\", \".doc\", \".jpg\")",
@@ -35744,6 +36004,25 @@
           "name": "boolean"
         }
       },
+      "onComplete": {
+        "defaultValue": null,
+        "description": "Callback called when the progress reaches its maximum value and the transition animation completes.",
+        "name": "onComplete",
+        "parent": {
+          "fileName": "components/src/progress/Progress.tsx",
+          "name": "ProgressProps"
+        },
+        "declarations": [
+          {
+            "fileName": "components/src/progress/Progress.tsx",
+            "name": "ProgressProps"
+          }
+        ],
+        "required": false,
+        "type": {
+          "name": "() => void"
+        }
+      },
       "ref": {
         "defaultValue": null,
         "description": "",

package/dist/drawer/index.mjs

@@ -1,10 +1,10 @@
 import {
   IconButton
-} from "../chunk-XYK6V3JF.mjs";
+} from "../chunk-DCXWGQVZ.mjs";
 import {
   Icon
 } from "../chunk-UMUMFMFB.mjs";
-import "../chunk-HEKSVWYW.mjs";
+import "../chunk-2YM6GKWW.mjs";
 import "../chunk-GAK4SC2F.mjs";
 import "../chunk-KEGAAGJW.mjs";
 import "../chunk-6QCEPQ3U.mjs";

package/dist/dropdown/index.mjs

@@ -1,11 +1,11 @@
 import {
   Popover
-} from "../chunk-D7YBYT5H.mjs";
-import "../chunk-XYK6V3JF.mjs";
+} from "../chunk-GPJMLIHC.mjs";
+import "../chunk-DCXWGQVZ.mjs";
 import {
   Icon
 } from "../chunk-UMUMFMFB.mjs";
-import "../chunk-HEKSVWYW.mjs";
+import "../chunk-2YM6GKWW.mjs";
 import "../chunk-GAK4SC2F.mjs";
 import {
   VisuallyHidden

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

@@ -5,6 +5,52 @@ import { ButtonProps } from '../button/index.mjs';
 import 'class-variance-authority/types';
 import 'class-variance-authority';
 
+/**
+ * File upload error codes
+ */
+declare const FILE_UPLOAD_ERRORS: {
+    /**
+     * Exceeds the maxFiles limit
+     */
+    readonly TOO_MANY_FILES: "TOO_MANY_FILES";
+    /**
+     * File type not in the accept list
+     */
+    readonly FILE_INVALID_TYPE: "FILE_INVALID_TYPE";
+    /**
+     * File size exceeds maxFileSize
+     */
+    readonly FILE_TOO_LARGE: "FILE_TOO_LARGE";
+    /**
+     * File size below minFileSize
+     */
+    readonly FILE_TOO_SMALL: "FILE_TOO_SMALL";
+    /**
+     * Generic validation failure
+     */
+    readonly FILE_INVALID: "FILE_INVALID";
+    /**
+     * Duplicate file detected
+     */
+    readonly FILE_EXISTS: "FILE_EXISTS";
+};
+
+type FileUploadFileError = typeof FILE_UPLOAD_ERRORS.TOO_MANY_FILES | typeof FILE_UPLOAD_ERRORS.FILE_INVALID_TYPE | typeof FILE_UPLOAD_ERRORS.FILE_TOO_LARGE | typeof FILE_UPLOAD_ERRORS.FILE_TOO_SMALL | typeof FILE_UPLOAD_ERRORS.FILE_INVALID | typeof FILE_UPLOAD_ERRORS.FILE_EXISTS;
+interface RejectedFile$1 {
+    file: File;
+    errors: FileUploadFileError[];
+}
+interface FileAcceptDetails {
+    files: File[];
+}
+interface FileRejectDetails {
+    files: RejectedFile$1[];
+}
+interface FileChangeDetails {
+    acceptedFiles: File[];
+    rejectedFiles: RejectedFile$1[];
+}
+
 interface FileUploadProps {
     /**
      * Change the default rendered element for the one passed as a child, merging their props and behavior.
@@ -82,31 +128,12 @@ interface FileUploadProps {
      */
     locale?: string;
 }
-type FileUploadFileError = 'TOO_MANY_FILES' | 'FILE_INVALID_TYPE' | 'FILE_TOO_LARGE' | 'FILE_TOO_SMALL' | 'FILE_INVALID' | 'FILE_EXISTS';
-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, onFileAccept, onFileReject, onFileChange, multiple, accept, maxFiles, maxFileSize, minFileSize, disabled: disabledProp, readOnly: readOnlyProp, locale, }: FileUploadProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
 interface FileUploadAcceptedFileProps 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>;
     /**
      * The file to display
@@ -127,7 +154,7 @@ interface FileUploadAcceptedFileProps extends ComponentPropsWithoutRef<'li'> {
     className?: string;
 }
 declare const AcceptedFile: {
-    ({ asChild: _asChild, className, file, uploadProgress, deleteButtonAriaLabel, progressAriaLabel, ...props }: FileUploadAcceptedFileProps): react_jsx_runtime.JSX.Element;
+    ({ className, file, uploadProgress, deleteButtonAriaLabel, progressAriaLabel, ...props }: FileUploadAcceptedFileProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
@@ -168,10 +195,6 @@ declare const ItemDeleteTrigger: {
 };
 
 interface FileUploadPreviewImageProps extends ComponentPropsWithoutRef<'div'> {
-    /**
-     * Change the default rendered element for the one passed as a child, merging their props and behavior.
-     */
-    asChild?: boolean;
     ref?: Ref<HTMLDivElement>;
     className?: string;
     /**
@@ -184,15 +207,11 @@ interface FileUploadPreviewImageProps extends ComponentPropsWithoutRef<'div'> {
     fallback?: React.ReactNode;
 }
 declare const PreviewImage: {
-    ({ asChild: _asChild, className, file, fallback, ...props }: FileUploadPreviewImageProps): react_jsx_runtime.JSX.Element;
+    ({ className, file, fallback, ...props }: FileUploadPreviewImageProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
 interface FileUploadRejectedFileProps 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>;
     /**
      * The rejected file to display
@@ -211,7 +230,7 @@ interface FileUploadRejectedFileProps extends ComponentPropsWithoutRef<'li'> {
     className?: string;
 }
 declare const RejectedFile: {
-    ({ asChild: _asChild, className, rejectedFile, renderError, deleteButtonAriaLabel, ...props }: FileUploadRejectedFileProps): react_jsx_runtime.JSX.Element;
+    ({ className, rejectedFile, renderError, deleteButtonAriaLabel, ...props }: FileUploadRejectedFileProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
@@ -233,7 +252,7 @@ interface FileUploadTriggerProps extends Omit<ButtonProps, 'children' | 'disable
     unstyled?: boolean;
 }
 declare const Trigger: {
-    ({ className, children, asChild, unstyled, design, intent, ref, ...props }: FileUploadTriggerProps): react_jsx_runtime.JSX.Element;
+    ({ className, children, asChild, unstyled, design, intent, size, shape, ref, ...props }: FileUploadTriggerProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
@@ -248,4 +267,4 @@ declare const FileUpload: typeof FileUpload$1 & {
     RejectedFileDeleteTrigger: typeof RejectedFileDeleteTrigger;
 };
 
-export { type FileAcceptDetails, type FileChangeDetails, type FileRejectDetails, FileUpload, type FileUploadFileError, type RejectedFile$1 as RejectedFile };
+export { FILE_UPLOAD_ERRORS, type FileAcceptDetails, type FileChangeDetails, type FileRejectDetails, FileUpload, type FileUploadFileError, type RejectedFile$1 as RejectedFile };