@mainframework/dropzone 1.0.28 → 1.1.0

package/README.md

@@ -105,7 +105,6 @@ The `FileSelector` from the hook accepts **view-only** props (styling, copy, acc
 | `ariaLabel`                 | `string` | "File upload drop zone"                                   | Accessible name for the drop zone.           |
 | `ariaDescribedBy`           | `string` | —                                                         | ID of element that describes the drop zone.  |
 | `ariaLabelButton`           | `string` | "Choose files to upload"                                  | Accessible label for the button.             |
-| `ariaLabelledBy`            | `string` | —                                                         | ID of element that labels the button.        |
 
 ## Default Accepted Types
 
@@ -172,11 +171,19 @@ export const App = () => {
 
 ## Cleanup / memory
 
-- Prefer clearing via the provided methods:
-  - `clearCache()` / `onCancel()` to clear files and revoke blob URLs
-  - `onRemoveFile(index)` to remove one file and revoke its blob URL
-  - `clearBlobs()` to revoke blob URLs without clearing arrays
-- When the hook instance unmounts, it clears internal state and revokes any blob URLs it created.
+> **Warning: memory management is the caller's responsibility.** The hook does **not** automatically revoke blob URLs on unmount. You **must** call `clearBlobs()` or `clearCache()` yourself — for example in a `useEffect` cleanup, on cancel, or after a successful upload — to prevent memory leaks.
+
+```tsx
+useEffect(() => {
+  return () => {
+    clearBlobs(); // revoke all blob URLs when the component unmounts
+  };
+}, [clearBlobs]);
+```
+
+- Use `clearCache()` / `onCancel()` to clear files **and** revoke blob URLs.
+- Use `onRemoveFile(index)` to remove one file and revoke its blob URL.
+- Use `clearBlobs()` to revoke blob URLs without clearing the file arrays.
 - Mutating the `validFiles` array directly (for example `validFiles.length = 0`) is not a supported way to clear files/blobs; use `clearCache()` instead so blob URLs are properly revoked.
 
 ## Exported types

package/dist/index.d.ts

@@ -1,66 +1,2 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ChangeEvent, DragEvent } from 'react';
-
-/** Props for styling, copy, and accessibility on the dropzone. Used by the `FileSelector` returned from `useFileSelector`. */
-interface FileSelectorViewProps {
-    inputId?: string;
-    messageParagraph?: string;
-    inputClassName?: string;
-    clickableAreaClassName?: string;
-    dropZoneWrapperClassName?: string;
-    messageParagraphClassName?: string;
-    /** Accessible name for the drop zone region (default: "File upload") */
-    ariaLabel?: string;
-    /** ID of element that describes the drop zone (e.g. help text) */
-    ariaDescribedBy?: string;
-    /** Accessible label for the file input button when messageParagraph is not sufficient */
-    ariaLabelButton?: string;
-    ariaLabelledBy?: string;
-}
-/** File input and drag-and-drop handlers; supplied internally by `useFileSelector` to the presentational component. */
-interface FileSelectorHandlerProps {
-    onChange: (e: ChangeEvent<HTMLInputElement>) => void;
-    onDragOver: (e: DragEvent<HTMLButtonElement>) => void;
-    onDrop: (e: DragEvent<HTMLButtonElement>) => void;
-    onDragEnter: (e: DragEvent<HTMLButtonElement>) => void;
-    onDragLeave: (e: DragEvent<HTMLButtonElement>) => void;
-}
-interface IFileUploaderProps {
-    acceptTypes?: string;
-    maximumUploadCount?: number;
-    maximumFileSize?: number;
-    acceptedTypes?: Record<string, string>;
-}
-interface FileData {
-    id: string;
-    file: File | Blob;
-    url: string;
-    type: string;
-}
-interface ErrorMessage {
-    status: boolean;
-    message: string;
-}
-
-declare const useFileSelector: ({ maximumUploadCount, maximumFileSize, acceptedTypes, }?: IFileUploaderProps) => {
-    validFiles: FileData[];
-    invalidFiles: File[];
-    clearCache: () => void;
-    getValidFileStreams: () => (File | Blob)[];
-    onCancel: () => void;
-    onIdChange: (index: number, id: string, files: FileData[]) => void;
-    onRemoveFile: (index: number) => void;
-    clearBlobs: () => void;
-    clearBlob: (file: File) => void;
-    maxUploadError: ErrorMessage;
-    maxFileSizeError: ErrorMessage;
-    setMaximumFileSizeExceeded: (status?: boolean) => void;
-    setMaximumUploadsExceeded: (status?: boolean, fileCount?: number, maximumUploads?: number) => void;
-    FileSelector: {
-        (props: FileSelectorViewProps): react_jsx_runtime.JSX.Element;
-        displayName: string;
-    };
-};
-
-export { useFileSelector };
-export type { ErrorMessage, FileData, FileSelectorHandlerProps, FileSelectorViewProps, IFileUploaderProps };
+export { useFileSelector } from "./shared/hooks/useFileSelector";
+export type { FileData, ErrorMessage, IFileUploaderProps, FileSelectorViewProps, FileSelectorHandlerProps, } from "./shared/types/types";