@shipstatic/drop 0.1.19 → 0.2.0

package/dist/index.d.cts

@@ -93,6 +93,11 @@ interface DropOptions {
     /** Whether to strip common directory prefix from paths (default: true) */
     stripPrefix?: boolean;
 }
+/** Options for getDropzoneProps() */
+interface DropzonePropsOptions {
+    /** Whether clicking the dropzone opens the file picker (default: true) */
+    clickable?: boolean;
+}
 interface DropReturn {
     /** Current phase of the state machine */
     phase: DropStateValue;
@@ -100,6 +105,10 @@ interface DropReturn {
     isProcessing: boolean;
     /** Whether user is currently dragging over the dropzone */
     isDragging: boolean;
+    /** Whether the dropzone is interactive (idle, dragging, or ready - not processing or error) */
+    isInteractive: boolean;
+    /** Whether an error occurred during processing */
+    hasError: boolean;
     /** Flattened access to files */
     files: ProcessedFile[];
     /** Flattened access to source name */
@@ -110,12 +119,12 @@ interface DropReturn {
         details: string;
         errors?: string[];
     } | null;
-    /** Get props to spread on dropzone element (handles drag & drop) */
-    getDropzoneProps: () => {
+    /** Get props to spread on dropzone element (handles drag & drop, optionally click) */
+    getDropzoneProps: (options?: DropzonePropsOptions) => {
         onDragOver: (e: React.DragEvent) => void;
         onDragLeave: (e: React.DragEvent) => void;
         onDrop: (e: React.DragEvent) => void;
-        onClick: () => void;
+        onClick?: () => void;
     };
     /** Get props to spread on hidden file input element */
     getInputProps: () => {
@@ -132,16 +141,12 @@ interface DropReturn {
     open: () => void;
     /** Manually process files (for advanced usage) */
     processFiles: (files: File[]) => Promise<void>;
-    /** Clear all files and reset state */
-    clearAll: () => void;
+    /** Reset state and clear all files */
+    reset: () => void;
     /** Get only valid files ready for upload */
     validFiles: ProcessedFile[];
-    /** Update upload state for a specific file (status, progress, message) */
-    updateFileStatus: (fileId: string, state: {
-        status: FileStatus;
-        statusMessage?: string;
-        progress?: number;
-    }) => void;
+    /** Get raw File objects ready for Ship SDK upload */
+    getFilesForUpload: () => File[];
 }
 /**
  * Headless drop hook for file upload workflows
@@ -227,4 +232,4 @@ declare function isZipFile(file: File): boolean;
  */
 declare function getMimeType(path: string): string;
 
-export { type ClientError, type DropOptions, type DropReturn, type DropState, type DropStateValue, type DropStatus, FILE_STATUSES, type FileStatus, type FileWithPath, type ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, formatFileSize, getMimeType, isZipFile, normalizePath, stripCommonPrefix, traverseFileTree, useDrop };
+export { type ClientError, type DropOptions, type DropReturn, type DropState, type DropStateValue, type DropStatus, type DropzonePropsOptions, FILE_STATUSES, type FileStatus, type FileWithPath, type ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, formatFileSize, getMimeType, isZipFile, normalizePath, stripCommonPrefix, traverseFileTree, useDrop };

package/dist/index.d.ts

@@ -93,6 +93,11 @@ interface DropOptions {
     /** Whether to strip common directory prefix from paths (default: true) */
     stripPrefix?: boolean;
 }
+/** Options for getDropzoneProps() */
+interface DropzonePropsOptions {
+    /** Whether clicking the dropzone opens the file picker (default: true) */
+    clickable?: boolean;
+}
 interface DropReturn {
     /** Current phase of the state machine */
     phase: DropStateValue;
@@ -100,6 +105,10 @@ interface DropReturn {
     isProcessing: boolean;
     /** Whether user is currently dragging over the dropzone */
     isDragging: boolean;
+    /** Whether the dropzone is interactive (idle, dragging, or ready - not processing or error) */
+    isInteractive: boolean;
+    /** Whether an error occurred during processing */
+    hasError: boolean;
     /** Flattened access to files */
     files: ProcessedFile[];
     /** Flattened access to source name */
@@ -110,12 +119,12 @@ interface DropReturn {
         details: string;
         errors?: string[];
     } | null;
-    /** Get props to spread on dropzone element (handles drag & drop) */
-    getDropzoneProps: () => {
+    /** Get props to spread on dropzone element (handles drag & drop, optionally click) */
+    getDropzoneProps: (options?: DropzonePropsOptions) => {
         onDragOver: (e: React.DragEvent) => void;
         onDragLeave: (e: React.DragEvent) => void;
         onDrop: (e: React.DragEvent) => void;
-        onClick: () => void;
+        onClick?: () => void;
     };
     /** Get props to spread on hidden file input element */
     getInputProps: () => {
@@ -132,16 +141,12 @@ interface DropReturn {
     open: () => void;
     /** Manually process files (for advanced usage) */
     processFiles: (files: File[]) => Promise<void>;
-    /** Clear all files and reset state */
-    clearAll: () => void;
+    /** Reset state and clear all files */
+    reset: () => void;
     /** Get only valid files ready for upload */
     validFiles: ProcessedFile[];
-    /** Update upload state for a specific file (status, progress, message) */
-    updateFileStatus: (fileId: string, state: {
-        status: FileStatus;
-        statusMessage?: string;
-        progress?: number;
-    }) => void;
+    /** Get raw File objects ready for Ship SDK upload */
+    getFilesForUpload: () => File[];
 }
 /**
  * Headless drop hook for file upload workflows
@@ -227,4 +232,4 @@ declare function isZipFile(file: File): boolean;
  */
 declare function getMimeType(path: string): string;
 
-export { type ClientError, type DropOptions, type DropReturn, type DropState, type DropStateValue, type DropStatus, FILE_STATUSES, type FileStatus, type FileWithPath, type ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, formatFileSize, getMimeType, isZipFile, normalizePath, stripCommonPrefix, traverseFileTree, useDrop };
+export { type ClientError, type DropOptions, type DropReturn, type DropState, type DropStateValue, type DropStatus, type DropzonePropsOptions, FILE_STATUSES, type FileStatus, type FileWithPath, type ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, formatFileSize, getMimeType, isZipFile, normalizePath, stripCommonPrefix, traverseFileTree, useDrop };

package/dist/index.js

@@ -11700,7 +11700,7 @@ var require_mime_db = __commonJS({
   }
 });
 
-// node_modules/.pnpm/@shipstatic+types@0.4.5/node_modules/@shipstatic/types/dist/index.js
+// node_modules/.pnpm/@shipstatic+types@0.4.7/node_modules/@shipstatic/types/dist/index.js
 var ErrorType;
 (function(ErrorType2) {
   ErrorType2["Validation"] = "validation_failed";
@@ -11914,7 +11914,15 @@ function useDrop(options) {
   const inputRef = useRef(null);
   const isProcessing = useMemo(() => state.value === "processing", [state.value]);
   const isDragging = useMemo(() => state.value === "dragging", [state.value]);
+  const isInteractive = useMemo(
+    () => state.value === "idle" || state.value === "dragging" || state.value === "ready",
+    [state.value]
+  );
+  const hasError = useMemo(() => state.value === "error", [state.value]);
   const validFiles = useMemo(() => getValidFiles(state.files), [state.files]);
+  const getFilesForUpload = useCallback(() => {
+    return validFiles.map((f) => f.file);
+  }, [validFiles]);
   const processFiles = useCallback(async (newFiles) => {
     if (isProcessingRef.current) {
       console.warn("File processing already in progress. Ignoring duplicate call.");
@@ -12025,18 +12033,10 @@ function useDrop(options) {
       isProcessingRef.current = false;
     }
   }, [ship, onValidationError, onFilesReady, stripPrefix]);
-  const clearAll = useCallback(() => {
+  const reset = useCallback(() => {
     setState(initialState);
     isProcessingRef.current = false;
   }, []);
-  const updateFileStatus = useCallback((fileId, fileState) => {
-    setState((prev) => ({
-      ...prev,
-      files: prev.files.map(
-        (file) => file.id === fileId ? { ...file, ...fileState } : file
-      )
-    }));
-  }, []);
   const handleDragOver = useCallback((e) => {
     e.preventDefault();
     setState((prev) => {
@@ -12119,12 +12119,15 @@ function useDrop(options) {
   const open = useCallback(() => {
     inputRef.current?.click();
   }, []);
-  const getDropzoneProps = useCallback(() => ({
-    onDragOver: handleDragOver,
-    onDragLeave: handleDragLeave,
-    onDrop: handleDrop,
-    onClick: open
-  }), [handleDragOver, handleDragLeave, handleDrop, open]);
+  const getDropzoneProps = useCallback((options2) => {
+    const { clickable = true } = options2 ?? {};
+    return {
+      onDragOver: handleDragOver,
+      onDragLeave: handleDragLeave,
+      onDrop: handleDrop,
+      ...clickable && { onClick: open }
+    };
+  }, [handleDragOver, handleDragLeave, handleDrop, open]);
   const getInputProps = useCallback(() => ({
     ref: inputRef,
     type: "file",
@@ -12134,11 +12137,12 @@ function useDrop(options) {
     onChange: handleInputChange
   }), [handleInputChange]);
   return {
-    // State machine
     // Convenience getters (computed from state)
     phase: state.value,
     isProcessing,
     isDragging,
+    isInteractive,
+    hasError,
     files: state.files,
     sourceName: state.sourceName,
     status: state.status,
@@ -12148,10 +12152,10 @@ function useDrop(options) {
     // Actions
     open,
     processFiles,
-    clearAll,
+    reset,
     // Helpers
     validFiles,
-    updateFileStatus
+    getFilesForUpload
   };
 }
 /*! Bundled license information: