@availity/mui-file-selector 1.3.2 → 1.4.1

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [1.4.1](https://github.com/Availity/element/compare/@availity/mui-file-selector@1.4.0...@availity/mui-file-selector@1.4.1) (2025-04-04)
+
+### Dependency Updates
+
+* `mui-dialog` updated to version `1.4.0`
+* `mui-textfield` updated to version `1.4.0`
+## [1.4.0](https://github.com/Availity/element/compare/@availity/mui-file-selector@1.3.2...@availity/mui-file-selector@1.4.0) (2025-04-04)
+
+
+### Features
+
+* **mui-file-selector:** add onProgress to useUploadCore ([6bef795](https://github.com/Availity/element/commit/6bef7950f0e392fdbf7b395f45ed16562cda0295))
+
 ## [1.3.2](https://github.com/Availity/element/compare/@availity/mui-file-selector@1.3.1...@availity/mui-file-selector@1.3.2) (2025-03-31)
 
 

package/README.md

@@ -170,6 +170,10 @@ const MyFileUploadComponent = () => {
     // Handle upload error - e.g., show error message, retry upload
   };
 
+  const handleOnProgress = (error) => {
+    // Handle upload error - e.g., show error message, retry upload
+  };
+
   return (
     <FileSelector
       name="documentUpload"
@@ -183,6 +187,7 @@ const MyFileUploadComponent = () => {
       uploadOptions={{
         onSuccess: handleOnSuccess,
         onError: handleOnError,
+        onProgress: handleOnProgress,
       }}
     />
   );

package/dist/index.d.mts

@@ -87,6 +87,7 @@ declare const ErrorAlert: ({ errors, fileName, id, onClose }: ErrorAlertProps) =
 type Options = {
     onError?: (error: Error) => void;
     onSuccess?: () => void;
+    onProgress?: () => void;
 } & UploadOptions;
 type UploadQueryOptions = UseQueryOptions<Upload, Error, Upload, [string, string, Options]>;
 declare function useUploadCore(file: File, options: Options, queryOptions?: UploadQueryOptions): _tanstack_react_query.UseQueryResult<Upload, Error>;

package/dist/index.d.ts

@@ -87,6 +87,7 @@ declare const ErrorAlert: ({ errors, fileName, id, onClose }: ErrorAlertProps) =
 type Options = {
     onError?: (error: Error) => void;
     onSuccess?: () => void;
+    onProgress?: () => void;
 } & UploadOptions;
 type UploadQueryOptions = UseQueryOptions<Upload, Error, Upload, [string, string, Options]>;
 declare function useUploadCore(file: File, options: Options, queryOptions?: UploadQueryOptions): _tanstack_react_query.UseQueryResult<Upload, Error>;

package/dist/index.js

@@ -462,15 +462,21 @@ var SelectPlaceholder = (0, import_styles4.styled)("span", {
   slot: "SelectPlaceholder",
   overridesResolver: (props, styles) => styles.avFilled
 })(({ theme }) => ({ opacity: 1, color: theme.palette.grey[400] }));
-var TextFieldFormHelperText = ({
-  charCount,
-  helperText,
-  maxLength,
-  showCharacterCount
-}) => {
+var TextFieldFormHelperText = (_a) => {
+  var _b = _a, {
+    charCount,
+    helperText,
+    maxLength,
+    showCharacterCount
+  } = _b, FormHelperTextProps2 = __objRest(_b, [
+    "charCount",
+    "helperText",
+    "maxLength",
+    "showCharacterCount"
+  ]);
   if (showCharacterCount) {
     return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_mui_layout2.Grid, { container: true, justifyContent: "space-between", flexWrap: "nowrap", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_mui_form_utils2.FormHelperText, { sx: { marginRight: "12px" }, children: helperText }),
+      /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_mui_form_utils2.FormHelperText, __spreadProps(__spreadValues({}, FormHelperTextProps2), { sx: { marginRight: "12px" }, children: helperText })),
       /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(import_mui_typography2.Typography, { variant: "caption", marginTop: "4px", lineHeight: "1.25rem", children: [
         /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_mui_typography2.Typography, { component: "span", variant: "inherit", color: charCount > maxLength ? "error" : "textPrimary", children: charCount || 0 }),
         "/",
@@ -478,7 +484,7 @@ var TextFieldFormHelperText = ({
       ] })
     ] });
   }
-  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_mui_form_utils2.FormHelperText, { children: helperText });
+  return /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(import_mui_form_utils2.FormHelperText, __spreadProps(__spreadValues({}, FormHelperTextProps2), { children: helperText }));
 };
 var TextField = (0, import_react2.forwardRef)((props, ref) => {
   var _b, _c, _d, _e, _f, _g, _h;
@@ -660,11 +666,12 @@ var import_react_query = require("@tanstack/react-query");
 var import_upload_core = __toESM(require("@availity/upload-core"));
 function startUpload(file, options) {
   return __async(this, null, function* () {
-    const _a = options, { onSuccess, onError } = _a, uploadOptions = __objRest(_a, ["onSuccess", "onError"]);
+    const _a = options, { onSuccess, onError, onProgress } = _a, uploadOptions = __objRest(_a, ["onSuccess", "onError", "onProgress"]);
     const upload = new import_upload_core.default(file, uploadOptions);
     yield upload.generateId();
     if (onSuccess) upload.onSuccess.push(onSuccess);
     if (onError) upload.onError.push(onError);
+    if (onProgress) upload.onProgress.push(onProgress);
     upload.start();
     return upload;
   });

package/dist/index.mjs

@@ -426,15 +426,21 @@ var SelectPlaceholder = styled4("span", {
   slot: "SelectPlaceholder",
   overridesResolver: (props, styles) => styles.avFilled
 })(({ theme }) => ({ opacity: 1, color: theme.palette.grey[400] }));
-var TextFieldFormHelperText = ({
-  charCount,
-  helperText,
-  maxLength,
-  showCharacterCount
-}) => {
+var TextFieldFormHelperText = (_a) => {
+  var _b = _a, {
+    charCount,
+    helperText,
+    maxLength,
+    showCharacterCount
+  } = _b, FormHelperTextProps2 = __objRest(_b, [
+    "charCount",
+    "helperText",
+    "maxLength",
+    "showCharacterCount"
+  ]);
   if (showCharacterCount) {
     return /* @__PURE__ */ jsxs6(Grid, { container: true, justifyContent: "space-between", flexWrap: "nowrap", children: [
-      /* @__PURE__ */ jsx9(FormHelperText, { sx: { marginRight: "12px" }, children: helperText }),
+      /* @__PURE__ */ jsx9(FormHelperText, __spreadProps(__spreadValues({}, FormHelperTextProps2), { sx: { marginRight: "12px" }, children: helperText })),
       /* @__PURE__ */ jsxs6(Typography2, { variant: "caption", marginTop: "4px", lineHeight: "1.25rem", children: [
         /* @__PURE__ */ jsx9(Typography2, { component: "span", variant: "inherit", color: charCount > maxLength ? "error" : "textPrimary", children: charCount || 0 }),
         "/",
@@ -442,7 +448,7 @@ var TextFieldFormHelperText = ({
       ] })
     ] });
   }
-  return /* @__PURE__ */ jsx9(FormHelperText, { children: helperText });
+  return /* @__PURE__ */ jsx9(FormHelperText, __spreadProps(__spreadValues({}, FormHelperTextProps2), { children: helperText }));
 };
 var TextField = forwardRef((props, ref) => {
   var _b, _c, _d, _e, _f, _g, _h;
@@ -635,11 +641,12 @@ import { useQuery } from "@tanstack/react-query";
 import Upload from "@availity/upload-core";
 function startUpload(file, options) {
   return __async(this, null, function* () {
-    const _a = options, { onSuccess, onError } = _a, uploadOptions = __objRest(_a, ["onSuccess", "onError"]);
+    const _a = options, { onSuccess, onError, onProgress } = _a, uploadOptions = __objRest(_a, ["onSuccess", "onError", "onProgress"]);
     const upload = new Upload(file, uploadOptions);
     yield upload.generateId();
     if (onSuccess) upload.onSuccess.push(onSuccess);
     if (onError) upload.onError.push(onError);
+    if (onProgress) upload.onProgress.push(onProgress);
     upload.start();
     return upload;
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@availity/mui-file-selector",
-  "version": "1.3.2",
+  "version": "1.4.1",
   "description": "Availity MUI file-selector Component - part of the @availity/element design system",
   "keywords": [
     "react",

package/src/lib/bs4migration.mdx

@@ -0,0 +1,120 @@
+import { Meta } from '@storybook/blocks';
+
+<Meta title="BS4 Migration/Upload" />
+
+# Upload Migration
+
+The `Upload` component from `@availity/upload` and `@availity/form-upload` has been renamed to the `FileSelector` component. It still uses `@availity/upload-core` package to do the lifting, however, we have renamed, removed, and added some things.
+
+For more in depth component information, visit:
+
+- [Availity Design Documentation](https://design.availity.com/2e36e50c7/p/121639-file-selector)
+- [Component Documentation](./?path=/docs/components-file-selector-file-selector--docs)
+
+## Key Differences (not exhaustive list)
+
+### Props
+
+#### ✅ New
+
+- `onDrop`: this prop serves as an `onChange` callback. Use it to get access to the files and the change event
+- `disableRemove`: used to prevent removing the file from the list
+- `validator`: allows for custom validation
+- `customFileRow`: pass in your own component to be used in the FileList
+- `queryOptions`: options for the `useQuery` hook
+
+#### ⚠️ Changed
+
+- `max` -> `maxFiles`
+- `showFileDrop` -> `enableDropArea`
+
+#### 🚫 Removed
+
+- `onFileUpload`: this prop has been removed in favor of adding `onProgress`, `onSuccess`, and `onError`. Previously, you were required to add these functions yourself. Now they can be passed directly to the component
+- `buttonText` (use children prop instead)
+- `buttonClassName`
+- `dropZoneText`
+- `component`
+
+### Form Management
+
+- The FileSelector uses `react-hook-form` instead of `Formik`
+- Must wrap component with FormProvider from `react-hook-form`
+- The `react-hook-form` provider maintains the state of the selected files. It does not use `@availity/upload-core`.
+
+## Code Examples
+
+`availity-react` Example:
+
+```tsx
+import { Upload } from '@availity/form-upload';
+import { Form } from '@availity/form';
+
+const UploadForm = () => (
+  <Form initialValues={{ fileUpload: [] }} onSubmit={(values) => console.log(values)}>
+    <Upload
+      name="fileUpload"
+      clientId="my-client-id"
+      bucketId="my-bucket-id"
+      customerId="my-customer-id"
+      maxSize={5 * 1024 * 1024}
+      multiple={true}
+      allowedFileTypes={['.pdf', '.doc', '.docx']}
+    />
+  </Form>
+);
+```
+
+`@availity/element` Example:
+
+```tsx
+import { FileSelector } from '@availity/mui-file-selector';
+import { FormProvider, useForm } from 'react-hook-form';
+
+const UploadForm = () => {
+  const methods = useForm({
+    defaultValues: {
+      fileUpload: [],
+    },
+  });
+
+  const onSubmit = (data) => console.log(data);
+
+  return (
+    <FormProvider {...methods}>
+      <form onSubmit={methods.handleSubmit(onSubmit)}>
+        <FileSelector
+          name="fileUpload"
+          clientId="my-client-id"
+          bucketId="my-bucket-id"
+          customerId="my-customer-id"
+          maxSize={5 * 1024 * 1024}
+          maxFiles={5}
+          multiple={true}
+          allowedFileTypes={['.pdf', '.doc', '.docx']}
+        />
+      </form>
+    </FormProvider>
+  );
+};
+```
+
+## Additional Considerations
+
+### Error Handling
+
+- The new component provides more detailed error feedback
+- Errors are displayed using Element Alert components
+- Custom error handling can be implemented through the validator prop
+
+### File List Display
+
+- Files are now displayed in a MUI List component
+- Can be customized using the customFileRow prop
+- Shows upload progress and status more clearly
+
+### Accessibility
+
+- Improved keyboard navigation
+- Better screen reader support
+- Clear focus indicators

package/src/lib/useUploadCore.tsx

@@ -6,18 +6,20 @@ import type { UploadOptions } from '@availity/upload-core';
 export type Options = {
   onError?: (error: Error) => void;
   onSuccess?: () => void;
+  onProgress?: () => void;
 } & UploadOptions;
 
 export type UploadQueryOptions = UseQueryOptions<Upload, Error, Upload, [string, string, Options]>;
 
 async function startUpload(file: File, options: Options) {
-  const { onSuccess, onError, ...uploadOptions } = options;
+  const { onSuccess, onError, onProgress, ...uploadOptions } = options;
   const upload = new Upload(file, uploadOptions);
 
   await upload.generateId();
 
   if (onSuccess) upload.onSuccess.push(onSuccess);
   if (onError) upload.onError.push(onError);
+  if (onProgress) upload.onProgress.push(onProgress);
 
   upload.start();