@shipstatic/drop 0.1.19 → 0.2.1

package/dist/index.d.cts

@@ -1,164 +1,7 @@
-import { ValidationError } from '@shipstatic/types';
-import { Ship, formatFileSize as formatFileSize$1 } from '@shipstatic/ship';
-
-/**
- * Core types for @shipstatic/drop
- * Imports types from @shipstatic/types (single source of truth)
- * and defines drop-specific types
- */
-
-/**
- * Extended File interface with webkitRelativePath
- * This property is set by browsers for folder uploads and drag-drop
- * https://developer.mozilla.org/en-US/docs/Web/API/File/webkitRelativePath
- */
-interface FileWithPath extends File {
-    readonly webkitRelativePath: string;
-}
-declare const FILE_STATUSES: {
-    readonly PROCESSING: "processing";
-    readonly UPLOADING: "uploading";
-    readonly COMPLETE: "complete";
-    readonly ERROR: "error";
-    readonly PENDING: "pending";
-    readonly PROCESSING_ERROR: "processing_error";
-    readonly EMPTY_FILE: "empty_file";
-    readonly VALIDATION_FAILED: "validation_failed";
-    readonly READY: "ready";
-};
-type FileStatus = (typeof FILE_STATUSES)[keyof typeof FILE_STATUSES];
-/**
- * Client-side error structure
- * Matches ValidationError from @shipstatic/ship for consistency
- */
-type ClientError = ValidationError;
-/**
- * Processed file entry ready for upload
- * Contains both the File object and UI-specific metadata
- * Use `file` property to access the underlying File for SDK operations
- */
-interface ProcessedFile {
-    /** Unique identifier for React keys and tracking */
-    id: string;
-    /** The File object - pass this to ship.deployments.create() */
-    file: File;
-    /** Relative path for deployment (e.g., "images/photo.jpg") */
-    path: string;
-    /** File size in bytes */
-    size: number;
-    /** MD5 hash (optional - Ship SDK calculates during deployment if not provided) */
-    md5?: string;
-    /** Filename without path */
-    name: string;
-    /** MIME type for UI icons/previews */
-    type: string;
-    /** Last modified timestamp */
-    lastModified: number;
-    /** Current processing/upload status */
-    status: FileStatus;
-    /** Human-readable status message for UI */
-    statusMessage?: string;
-    /** Upload progress (0-100) - only set during upload */
-    progress?: number;
-}
-/**
- * State machine values for the drop hook
- */
-type DropStateValue = 'idle' | 'dragging' | 'processing' | 'ready' | 'error';
-/**
- * Status information with title and details
- */
-interface DropStatus {
-    title: string;
-    details: string;
-    errors?: string[];
-}
-/**
- * State machine state for the drop hook
- */
-interface DropState {
-    value: DropStateValue;
-    files: ProcessedFile[];
-    sourceName: string;
-    status: DropStatus | null;
-}
-
-interface DropOptions {
-    /** Ship SDK instance (required for validation) */
-    ship: Ship;
-    /** Callback when files are processed and ready */
-    onFilesReady?: (files: ProcessedFile[]) => void;
-    /** Callback when validation fails */
-    onValidationError?: (error: ClientError) => void;
-    /** Whether to strip common directory prefix from paths (default: true) */
-    stripPrefix?: boolean;
-}
-interface DropReturn {
-    /** Current phase of the state machine */
-    phase: DropStateValue;
-    /** Whether currently processing files (ZIP extraction, etc.) */
-    isProcessing: boolean;
-    /** Whether user is currently dragging over the dropzone */
-    isDragging: boolean;
-    /** Flattened access to files */
-    files: ProcessedFile[];
-    /** Flattened access to source name */
-    sourceName: string;
-    /** Flattened access to status */
-    status: {
-        title: string;
-        details: string;
-        errors?: string[];
-    } | null;
-    /** Get props to spread on dropzone element (handles drag & drop) */
-    getDropzoneProps: () => {
-        onDragOver: (e: React.DragEvent) => void;
-        onDragLeave: (e: React.DragEvent) => void;
-        onDrop: (e: React.DragEvent) => void;
-        onClick: () => void;
-    };
-    /** Get props to spread on hidden file input element */
-    getInputProps: () => {
-        ref: React.RefObject<HTMLInputElement | null>;
-        type: 'file';
-        style: {
-            display: string;
-        };
-        multiple: boolean;
-        webkitdirectory: string;
-        onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
-    };
-    /** Programmatically trigger file picker */
-    open: () => void;
-    /** Manually process files (for advanced usage) */
-    processFiles: (files: File[]) => Promise<void>;
-    /** Clear all files and reset state */
-    clearAll: () => 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;
-}
-/**
- * Headless drop hook for file upload workflows
- *
- * @example
- * ```tsx
- * const drop = useDrop({ ship });
- *
- * return (
- *   <div {...drop.getDropzoneProps()} style={{...}}>
- *     <input {...drop.getInputProps()} />
- *     {drop.isDragging ? "📂 Drop" : "📁 Click"}
- *   </div>
- * );
- * ```
- */
-declare function useDrop(options: DropOptions): DropReturn;
+import { P as ProcessedFile } from './useDrop-CRUVkVzW.cjs';
+export { C as ClientError, D as DropOptions, a as DropReturn, b as DropState, c as DropStateValue, d as DropStatus, e as DropzonePropsOptions, F as FILE_STATUSES, f as FileStatus, g as FileWithPath, u as useDrop } from './useDrop-CRUVkVzW.cjs';
+import { formatFileSize as formatFileSize$1 } from '@shipstatic/ship';
+import '@shipstatic/types';
 
 /**
  * Unified file processing utilities
@@ -227,4 +70,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 { ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, formatFileSize, getMimeType, isZipFile, normalizePath, stripCommonPrefix, traverseFileTree };

package/dist/index.d.ts

@@ -1,164 +1,7 @@
-import { ValidationError } from '@shipstatic/types';
-import { Ship, formatFileSize as formatFileSize$1 } from '@shipstatic/ship';
-
-/**
- * Core types for @shipstatic/drop
- * Imports types from @shipstatic/types (single source of truth)
- * and defines drop-specific types
- */
-
-/**
- * Extended File interface with webkitRelativePath
- * This property is set by browsers for folder uploads and drag-drop
- * https://developer.mozilla.org/en-US/docs/Web/API/File/webkitRelativePath
- */
-interface FileWithPath extends File {
-    readonly webkitRelativePath: string;
-}
-declare const FILE_STATUSES: {
-    readonly PROCESSING: "processing";
-    readonly UPLOADING: "uploading";
-    readonly COMPLETE: "complete";
-    readonly ERROR: "error";
-    readonly PENDING: "pending";
-    readonly PROCESSING_ERROR: "processing_error";
-    readonly EMPTY_FILE: "empty_file";
-    readonly VALIDATION_FAILED: "validation_failed";
-    readonly READY: "ready";
-};
-type FileStatus = (typeof FILE_STATUSES)[keyof typeof FILE_STATUSES];
-/**
- * Client-side error structure
- * Matches ValidationError from @shipstatic/ship for consistency
- */
-type ClientError = ValidationError;
-/**
- * Processed file entry ready for upload
- * Contains both the File object and UI-specific metadata
- * Use `file` property to access the underlying File for SDK operations
- */
-interface ProcessedFile {
-    /** Unique identifier for React keys and tracking */
-    id: string;
-    /** The File object - pass this to ship.deployments.create() */
-    file: File;
-    /** Relative path for deployment (e.g., "images/photo.jpg") */
-    path: string;
-    /** File size in bytes */
-    size: number;
-    /** MD5 hash (optional - Ship SDK calculates during deployment if not provided) */
-    md5?: string;
-    /** Filename without path */
-    name: string;
-    /** MIME type for UI icons/previews */
-    type: string;
-    /** Last modified timestamp */
-    lastModified: number;
-    /** Current processing/upload status */
-    status: FileStatus;
-    /** Human-readable status message for UI */
-    statusMessage?: string;
-    /** Upload progress (0-100) - only set during upload */
-    progress?: number;
-}
-/**
- * State machine values for the drop hook
- */
-type DropStateValue = 'idle' | 'dragging' | 'processing' | 'ready' | 'error';
-/**
- * Status information with title and details
- */
-interface DropStatus {
-    title: string;
-    details: string;
-    errors?: string[];
-}
-/**
- * State machine state for the drop hook
- */
-interface DropState {
-    value: DropStateValue;
-    files: ProcessedFile[];
-    sourceName: string;
-    status: DropStatus | null;
-}
-
-interface DropOptions {
-    /** Ship SDK instance (required for validation) */
-    ship: Ship;
-    /** Callback when files are processed and ready */
-    onFilesReady?: (files: ProcessedFile[]) => void;
-    /** Callback when validation fails */
-    onValidationError?: (error: ClientError) => void;
-    /** Whether to strip common directory prefix from paths (default: true) */
-    stripPrefix?: boolean;
-}
-interface DropReturn {
-    /** Current phase of the state machine */
-    phase: DropStateValue;
-    /** Whether currently processing files (ZIP extraction, etc.) */
-    isProcessing: boolean;
-    /** Whether user is currently dragging over the dropzone */
-    isDragging: boolean;
-    /** Flattened access to files */
-    files: ProcessedFile[];
-    /** Flattened access to source name */
-    sourceName: string;
-    /** Flattened access to status */
-    status: {
-        title: string;
-        details: string;
-        errors?: string[];
-    } | null;
-    /** Get props to spread on dropzone element (handles drag & drop) */
-    getDropzoneProps: () => {
-        onDragOver: (e: React.DragEvent) => void;
-        onDragLeave: (e: React.DragEvent) => void;
-        onDrop: (e: React.DragEvent) => void;
-        onClick: () => void;
-    };
-    /** Get props to spread on hidden file input element */
-    getInputProps: () => {
-        ref: React.RefObject<HTMLInputElement | null>;
-        type: 'file';
-        style: {
-            display: string;
-        };
-        multiple: boolean;
-        webkitdirectory: string;
-        onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
-    };
-    /** Programmatically trigger file picker */
-    open: () => void;
-    /** Manually process files (for advanced usage) */
-    processFiles: (files: File[]) => Promise<void>;
-    /** Clear all files and reset state */
-    clearAll: () => 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;
-}
-/**
- * Headless drop hook for file upload workflows
- *
- * @example
- * ```tsx
- * const drop = useDrop({ ship });
- *
- * return (
- *   <div {...drop.getDropzoneProps()} style={{...}}>
- *     <input {...drop.getInputProps()} />
- *     {drop.isDragging ? "📂 Drop" : "📁 Click"}
- *   </div>
- * );
- * ```
- */
-declare function useDrop(options: DropOptions): DropReturn;
+import { P as ProcessedFile } from './useDrop-CRUVkVzW.js';
+export { C as ClientError, D as DropOptions, a as DropReturn, b as DropState, c as DropStateValue, d as DropStatus, e as DropzonePropsOptions, F as FILE_STATUSES, f as FileStatus, g as FileWithPath, u as useDrop } from './useDrop-CRUVkVzW.js';
+import { formatFileSize as formatFileSize$1 } from '@shipstatic/ship';
+import '@shipstatic/types';
 
 /**
  * Unified file processing utilities
@@ -227,4 +70,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 { ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, formatFileSize, getMimeType, isZipFile, normalizePath, stripCommonPrefix, traverseFileTree };

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: