@shipstatic/drop 0.2.0 → 0.2.1

package/dist/index.d.cts

@@ -1,169 +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;
-}
-/** 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;
-    /** Whether currently processing files (ZIP extraction, etc.) */
-    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 */
-    sourceName: string;
-    /** Flattened access to status */
-    status: {
-        title: string;
-        details: string;
-        errors?: string[];
-    } | null;
-    /** 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;
-    };
-    /** 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>;
-    /** Reset state and clear all files */
-    reset: () => void;
-    /** Get only valid files ready for upload */
-    validFiles: ProcessedFile[];
-    /** Get raw File objects ready for Ship SDK upload */
-    getFilesForUpload: () => File[];
-}
-/**
- * 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
@@ -232,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, type DropzonePropsOptions, 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,169 +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;
-}
-/** 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;
-    /** Whether currently processing files (ZIP extraction, etc.) */
-    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 */
-    sourceName: string;
-    /** Flattened access to status */
-    status: {
-        title: string;
-        details: string;
-        errors?: string[];
-    } | null;
-    /** 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;
-    };
-    /** 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>;
-    /** Reset state and clear all files */
-    reset: () => void;
-    /** Get only valid files ready for upload */
-    validFiles: ProcessedFile[];
-    /** Get raw File objects ready for Ship SDK upload */
-    getFilesForUpload: () => File[];
-}
-/**
- * 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
@@ -232,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, type DropzonePropsOptions, 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/testing.cjs

@@ -0,0 +1,149 @@
+'use strict';
+
+// src/testing.ts
+function createMockDrop(options = {}) {
+  const {
+    phase = "idle",
+    files = [],
+    sourceName = "",
+    status = null
+  } = options;
+  const validFiles = files.filter((f) => f.status === "ready");
+  return {
+    // State
+    phase,
+    isProcessing: phase === "processing",
+    isDragging: phase === "dragging",
+    isInteractive: phase === "idle" || phase === "dragging" || phase === "ready",
+    hasError: phase === "error",
+    files,
+    validFiles,
+    sourceName,
+    status,
+    // Prop getters - return minimal objects for spreading
+    getDropzoneProps: (opts) => ({
+      onDragOver: () => {
+      },
+      onDragLeave: () => {
+      },
+      onDrop: () => {
+      },
+      ...opts?.clickable !== false && { onClick: () => {
+      } }
+    }),
+    getInputProps: () => ({
+      ref: { current: null },
+      type: "file",
+      style: { display: "none" },
+      multiple: true,
+      webkitdirectory: "",
+      onChange: () => {
+      }
+    }),
+    // Actions - no-op by default, can be spied on
+    open: () => {
+    },
+    processFiles: async () => {
+    },
+    reset: () => {
+    },
+    // Helpers
+    getFilesForUpload: () => validFiles.map((f) => f.file)
+  };
+}
+function createMockDropWithSpies(options = {}) {
+  const baseDrop = createMockDrop(options);
+  let openCalls = 0;
+  let processFilesCalls = [];
+  let resetCalls = 0;
+  const trackedSpies = {
+    open: Object.assign(() => {
+      openCalls++;
+    }, {
+      calls: () => openCalls,
+      toHaveBeenCalled: () => openCalls > 0
+    }),
+    processFiles: Object.assign(async (files) => {
+      processFilesCalls.push(files);
+    }, {
+      calls: () => processFilesCalls,
+      toHaveBeenCalled: () => processFilesCalls.length > 0,
+      toHaveBeenCalledWith: (files) => processFilesCalls.some((c) => c === files)
+    }),
+    reset: Object.assign(() => {
+      resetCalls++;
+    }, {
+      calls: () => resetCalls,
+      toHaveBeenCalled: () => resetCalls > 0
+    }),
+    getFilesForUpload: baseDrop.getFilesForUpload
+  };
+  return {
+    drop: {
+      ...baseDrop,
+      open: trackedSpies.open,
+      processFiles: trackedSpies.processFiles,
+      reset: trackedSpies.reset,
+      getFilesForUpload: trackedSpies.getFilesForUpload
+    },
+    spies: trackedSpies
+  };
+}
+var mockFileIdCounter = 0;
+function createMockProcessedFile(name, options = {}) {
+  const {
+    path = name,
+    content = "test content",
+    type = "text/plain",
+    status = "ready",
+    statusMessage
+  } = options;
+  const file = new File([content], name, { type });
+  return {
+    id: `mock-file-${++mockFileIdCounter}`,
+    file,
+    path,
+    name,
+    size: file.size,
+    type,
+    lastModified: Date.now(),
+    status,
+    statusMessage
+  };
+}
+function createMockFile(name, content = "test content", type = "text/plain") {
+  return new File([content], name, { type, lastModified: Date.now() });
+}
+function createMockFileWithPath(name, webkitRelativePath, content = "test content", type = "text/plain") {
+  const file = createMockFile(name, content, type);
+  Object.defineProperty(file, "webkitRelativePath", {
+    value: webkitRelativePath,
+    writable: false,
+    enumerable: true,
+    configurable: true
+  });
+  return file;
+}
+function createMockErrorStatus(title = "Validation Failed", details = "One or more files failed validation", errors = []) {
+  return { title, details, errors };
+}
+function createMockProcessingStatus(title = "Processing...", details = "Validating and preparing files.") {
+  return { title, details };
+}
+function createMockReadyStatus(fileCount) {
+  return {
+    title: "Ready",
+    details: `${fileCount} file(s) are ready.`
+  };
+}
+
+exports.createMockDrop = createMockDrop;
+exports.createMockDropWithSpies = createMockDropWithSpies;
+exports.createMockErrorStatus = createMockErrorStatus;
+exports.createMockFile = createMockFile;
+exports.createMockFileWithPath = createMockFileWithPath;
+exports.createMockProcessedFile = createMockProcessedFile;
+exports.createMockProcessingStatus = createMockProcessingStatus;
+exports.createMockReadyStatus = createMockReadyStatus;
+//# sourceMappingURL=testing.cjs.map
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":"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","file":"testing.cjs","sourcesContent":["/**\n * Test utilities for @shipstatic/drop\n *\n * Import from '@shipstatic/drop/testing' in your test files:\n *\n * ```typescript\n * import { createMockDrop, createMockFile } from '@shipstatic/drop/testing';\n * ```\n */\n\nimport type { ProcessedFile, DropStatus, DropStateValue } from './types';\nimport type { DropReturn, DropzonePropsOptions } from './hooks/useDrop';\n\n// ============================================================================\n// Mock Drop Hook Return\n// ============================================================================\n\n/**\n * Options for creating a mock drop return value\n */\nexport interface MockDropOptions {\n  phase?: DropStateValue;\n  files?: ProcessedFile[];\n  sourceName?: string;\n  status?: DropStatus | null;\n}\n\n/**\n * Creates a mock DropReturn for testing components that receive drop as a prop\n *\n * @example\n * ```tsx\n * import { createMockDrop, createMockProcessedFile } from '@shipstatic/drop/testing';\n *\n * it('renders file count when files are ready', () => {\n *   const drop = createMockDrop({\n *     phase: 'ready',\n *     files: [createMockProcessedFile('index.html')],\n *   });\n *\n *   render(<DeployDropArea drop={drop} />);\n *   expect(screen.getByText('1 files ready')).toBeInTheDocument();\n * });\n * ```\n */\nexport function createMockDrop(options: MockDropOptions = {}): DropReturn {\n  const {\n    phase = 'idle',\n    files = [],\n    sourceName = '',\n    status = null,\n  } = options;\n\n  const validFiles = files.filter(f => f.status === 'ready');\n\n  return {\n    // State\n    phase,\n    isProcessing: phase === 'processing',\n    isDragging: phase === 'dragging',\n    isInteractive: phase === 'idle' || phase === 'dragging' || phase === 'ready',\n    hasError: phase === 'error',\n    files,\n    validFiles,\n    sourceName,\n    status,\n\n    // Prop getters - return minimal objects for spreading\n    getDropzoneProps: (opts?: DropzonePropsOptions) => ({\n      onDragOver: () => {},\n      onDragLeave: () => {},\n      onDrop: () => {},\n      ...(opts?.clickable !== false && { onClick: () => {} }),\n    }),\n    getInputProps: () => ({\n      ref: { current: null },\n      type: 'file' as const,\n      style: { display: 'none' },\n      multiple: true,\n      webkitdirectory: '',\n      onChange: () => {},\n    }),\n\n    // Actions - no-op by default, can be spied on\n    open: () => {},\n    processFiles: async () => {},\n    reset: () => {},\n\n    // Helpers\n    getFilesForUpload: () => validFiles.map(f => f.file),\n  };\n}\n\n/**\n * Creates a mock drop with spy functions for testing interactions\n *\n * @example\n * ```tsx\n * import { createMockDropWithSpies } from '@shipstatic/drop/testing';\n *\n * it('calls reset when Clear button is clicked', async () => {\n *   const { drop, spies } = createMockDropWithSpies({ phase: 'ready', files: [...] });\n *\n *   render(<DeployDropArea drop={drop} />);\n *   await userEvent.click(screen.getByText('Clear'));\n *\n *   expect(spies.reset).toHaveBeenCalled();\n * });\n * ```\n */\nexport function createMockDropWithSpies(options: MockDropOptions = {}): {\n  drop: DropReturn;\n  spies: {\n    open: () => void;\n    processFiles: (files: File[]) => Promise<void>;\n    reset: () => void;\n    getFilesForUpload: () => File[];\n  };\n} {\n  const baseDrop = createMockDrop(options);\n\n  const spies = {\n    open: createNoopSpy(),\n    processFiles: createAsyncNoopSpy(),\n    reset: createNoopSpy(),\n    getFilesForUpload: (() => baseDrop.getFilesForUpload()) as () => File[],\n  };\n\n  // Track calls manually (works without vitest in runtime)\n  let openCalls = 0;\n  let processFilesCalls: File[][] = [];\n  let resetCalls = 0;\n\n  const trackedSpies = {\n    open: Object.assign(() => { openCalls++; }, {\n      calls: () => openCalls,\n      toHaveBeenCalled: () => openCalls > 0,\n    }),\n    processFiles: Object.assign(async (files: File[]) => { processFilesCalls.push(files); }, {\n      calls: () => processFilesCalls,\n      toHaveBeenCalled: () => processFilesCalls.length > 0,\n      toHaveBeenCalledWith: (files: File[]) => processFilesCalls.some(c => c === files),\n    }),\n    reset: Object.assign(() => { resetCalls++; }, {\n      calls: () => resetCalls,\n      toHaveBeenCalled: () => resetCalls > 0,\n    }),\n    getFilesForUpload: baseDrop.getFilesForUpload,\n  };\n\n  return {\n    drop: {\n      ...baseDrop,\n      open: trackedSpies.open,\n      processFiles: trackedSpies.processFiles,\n      reset: trackedSpies.reset,\n      getFilesForUpload: trackedSpies.getFilesForUpload,\n    },\n    spies: trackedSpies,\n  };\n}\n\n// ============================================================================\n// Mock File Utilities\n// ============================================================================\n\nlet mockFileIdCounter = 0;\n\n/**\n * Creates a mock ProcessedFile for testing\n */\nexport function createMockProcessedFile(\n  name: string,\n  options: {\n    path?: string;\n    content?: string;\n    type?: string;\n    status?: 'ready' | 'validation_failed' | 'processing_error' | 'empty_file';\n    statusMessage?: string;\n  } = {}\n): ProcessedFile {\n  const {\n    path = name,\n    content = 'test content',\n    type = 'text/plain',\n    status = 'ready',\n    statusMessage,\n  } = options;\n\n  const file = new File([content], name, { type });\n\n  return {\n    id: `mock-file-${++mockFileIdCounter}`,\n    file,\n    path,\n    name,\n    size: file.size,\n    type,\n    lastModified: Date.now(),\n    status,\n    statusMessage,\n  };\n}\n\n/**\n * Creates a mock File object\n */\nexport function createMockFile(\n  name: string,\n  content: string = 'test content',\n  type: string = 'text/plain'\n): File {\n  return new File([content], name, { type, lastModified: Date.now() });\n}\n\n/**\n * Creates a mock File object with webkitRelativePath set\n */\nexport function createMockFileWithPath(\n  name: string,\n  webkitRelativePath: string,\n  content: string = 'test content',\n  type: string = 'text/plain'\n): File {\n  const file = createMockFile(name, content, type);\n  Object.defineProperty(file, 'webkitRelativePath', {\n    value: webkitRelativePath,\n    writable: false,\n    enumerable: true,\n    configurable: true,\n  });\n  return file;\n}\n\n// ============================================================================\n// Mock Status Utilities\n// ============================================================================\n\n/**\n * Creates a mock error status\n */\nexport function createMockErrorStatus(\n  title: string = 'Validation Failed',\n  details: string = 'One or more files failed validation',\n  errors: string[] = []\n): DropStatus {\n  return { title, details, errors };\n}\n\n/**\n * Creates a mock processing status\n */\nexport function createMockProcessingStatus(\n  title: string = 'Processing...',\n  details: string = 'Validating and preparing files.'\n): DropStatus {\n  return { title, details };\n}\n\n/**\n * Creates a mock ready status\n */\nexport function createMockReadyStatus(fileCount: number): DropStatus {\n  return {\n    title: 'Ready',\n    details: `${fileCount} file(s) are ready.`,\n  };\n}\n\n// ============================================================================\n// Internal Helpers\n// ============================================================================\n\nfunction createNoopSpy(): () => void {\n  return () => {};\n}\n\nfunction createAsyncNoopSpy(): () => Promise<void> {\n  return async () => {};\n}\n"]}

package/dist/testing.d.cts

@@ -0,0 +1,100 @@
+import { c as DropStateValue, P as ProcessedFile, d as DropStatus, a as DropReturn } from './useDrop-CRUVkVzW.cjs';
+import '@shipstatic/types';
+import '@shipstatic/ship';
+
+/**
+ * Test utilities for @shipstatic/drop
+ *
+ * Import from '@shipstatic/drop/testing' in your test files:
+ *
+ * ```typescript
+ * import { createMockDrop, createMockFile } from '@shipstatic/drop/testing';
+ * ```
+ */
+
+/**
+ * Options for creating a mock drop return value
+ */
+interface MockDropOptions {
+    phase?: DropStateValue;
+    files?: ProcessedFile[];
+    sourceName?: string;
+    status?: DropStatus | null;
+}
+/**
+ * Creates a mock DropReturn for testing components that receive drop as a prop
+ *
+ * @example
+ * ```tsx
+ * import { createMockDrop, createMockProcessedFile } from '@shipstatic/drop/testing';
+ *
+ * it('renders file count when files are ready', () => {
+ *   const drop = createMockDrop({
+ *     phase: 'ready',
+ *     files: [createMockProcessedFile('index.html')],
+ *   });
+ *
+ *   render(<DeployDropArea drop={drop} />);
+ *   expect(screen.getByText('1 files ready')).toBeInTheDocument();
+ * });
+ * ```
+ */
+declare function createMockDrop(options?: MockDropOptions): DropReturn;
+/**
+ * Creates a mock drop with spy functions for testing interactions
+ *
+ * @example
+ * ```tsx
+ * import { createMockDropWithSpies } from '@shipstatic/drop/testing';
+ *
+ * it('calls reset when Clear button is clicked', async () => {
+ *   const { drop, spies } = createMockDropWithSpies({ phase: 'ready', files: [...] });
+ *
+ *   render(<DeployDropArea drop={drop} />);
+ *   await userEvent.click(screen.getByText('Clear'));
+ *
+ *   expect(spies.reset).toHaveBeenCalled();
+ * });
+ * ```
+ */
+declare function createMockDropWithSpies(options?: MockDropOptions): {
+    drop: DropReturn;
+    spies: {
+        open: () => void;
+        processFiles: (files: File[]) => Promise<void>;
+        reset: () => void;
+        getFilesForUpload: () => File[];
+    };
+};
+/**
+ * Creates a mock ProcessedFile for testing
+ */
+declare function createMockProcessedFile(name: string, options?: {
+    path?: string;
+    content?: string;
+    type?: string;
+    status?: 'ready' | 'validation_failed' | 'processing_error' | 'empty_file';
+    statusMessage?: string;
+}): ProcessedFile;
+/**
+ * Creates a mock File object
+ */
+declare function createMockFile(name: string, content?: string, type?: string): File;
+/**
+ * Creates a mock File object with webkitRelativePath set
+ */
+declare function createMockFileWithPath(name: string, webkitRelativePath: string, content?: string, type?: string): File;
+/**
+ * Creates a mock error status
+ */
+declare function createMockErrorStatus(title?: string, details?: string, errors?: string[]): DropStatus;
+/**
+ * Creates a mock processing status
+ */
+declare function createMockProcessingStatus(title?: string, details?: string): DropStatus;
+/**
+ * Creates a mock ready status
+ */
+declare function createMockReadyStatus(fileCount: number): DropStatus;
+
+export { type MockDropOptions, createMockDrop, createMockDropWithSpies, createMockErrorStatus, createMockFile, createMockFileWithPath, createMockProcessedFile, createMockProcessingStatus, createMockReadyStatus };

package/dist/testing.d.ts

@@ -0,0 +1,100 @@
+import { c as DropStateValue, P as ProcessedFile, d as DropStatus, a as DropReturn } from './useDrop-CRUVkVzW.js';
+import '@shipstatic/types';
+import '@shipstatic/ship';
+
+/**
+ * Test utilities for @shipstatic/drop
+ *
+ * Import from '@shipstatic/drop/testing' in your test files:
+ *
+ * ```typescript
+ * import { createMockDrop, createMockFile } from '@shipstatic/drop/testing';
+ * ```
+ */
+
+/**
+ * Options for creating a mock drop return value
+ */
+interface MockDropOptions {
+    phase?: DropStateValue;
+    files?: ProcessedFile[];
+    sourceName?: string;
+    status?: DropStatus | null;
+}
+/**
+ * Creates a mock DropReturn for testing components that receive drop as a prop
+ *
+ * @example
+ * ```tsx
+ * import { createMockDrop, createMockProcessedFile } from '@shipstatic/drop/testing';
+ *
+ * it('renders file count when files are ready', () => {
+ *   const drop = createMockDrop({
+ *     phase: 'ready',
+ *     files: [createMockProcessedFile('index.html')],
+ *   });
+ *
+ *   render(<DeployDropArea drop={drop} />);
+ *   expect(screen.getByText('1 files ready')).toBeInTheDocument();
+ * });
+ * ```
+ */
+declare function createMockDrop(options?: MockDropOptions): DropReturn;
+/**
+ * Creates a mock drop with spy functions for testing interactions
+ *
+ * @example
+ * ```tsx
+ * import { createMockDropWithSpies } from '@shipstatic/drop/testing';
+ *
+ * it('calls reset when Clear button is clicked', async () => {
+ *   const { drop, spies } = createMockDropWithSpies({ phase: 'ready', files: [...] });
+ *
+ *   render(<DeployDropArea drop={drop} />);
+ *   await userEvent.click(screen.getByText('Clear'));
+ *
+ *   expect(spies.reset).toHaveBeenCalled();
+ * });
+ * ```
+ */
+declare function createMockDropWithSpies(options?: MockDropOptions): {
+    drop: DropReturn;
+    spies: {
+        open: () => void;
+        processFiles: (files: File[]) => Promise<void>;
+        reset: () => void;
+        getFilesForUpload: () => File[];
+    };
+};
+/**
+ * Creates a mock ProcessedFile for testing
+ */
+declare function createMockProcessedFile(name: string, options?: {
+    path?: string;
+    content?: string;
+    type?: string;
+    status?: 'ready' | 'validation_failed' | 'processing_error' | 'empty_file';
+    statusMessage?: string;
+}): ProcessedFile;
+/**
+ * Creates a mock File object
+ */
+declare function createMockFile(name: string, content?: string, type?: string): File;
+/**
+ * Creates a mock File object with webkitRelativePath set
+ */
+declare function createMockFileWithPath(name: string, webkitRelativePath: string, content?: string, type?: string): File;
+/**
+ * Creates a mock error status
+ */
+declare function createMockErrorStatus(title?: string, details?: string, errors?: string[]): DropStatus;
+/**
+ * Creates a mock processing status
+ */
+declare function createMockProcessingStatus(title?: string, details?: string): DropStatus;
+/**
+ * Creates a mock ready status
+ */
+declare function createMockReadyStatus(fileCount: number): DropStatus;
+
+export { type MockDropOptions, createMockDrop, createMockDropWithSpies, createMockErrorStatus, createMockFile, createMockFileWithPath, createMockProcessedFile, createMockProcessingStatus, createMockReadyStatus };

package/dist/testing.js

@@ -0,0 +1,140 @@
+// src/testing.ts
+function createMockDrop(options = {}) {
+  const {
+    phase = "idle",
+    files = [],
+    sourceName = "",
+    status = null
+  } = options;
+  const validFiles = files.filter((f) => f.status === "ready");
+  return {
+    // State
+    phase,
+    isProcessing: phase === "processing",
+    isDragging: phase === "dragging",
+    isInteractive: phase === "idle" || phase === "dragging" || phase === "ready",
+    hasError: phase === "error",
+    files,
+    validFiles,
+    sourceName,
+    status,
+    // Prop getters - return minimal objects for spreading
+    getDropzoneProps: (opts) => ({
+      onDragOver: () => {
+      },
+      onDragLeave: () => {
+      },
+      onDrop: () => {
+      },
+      ...opts?.clickable !== false && { onClick: () => {
+      } }
+    }),
+    getInputProps: () => ({
+      ref: { current: null },
+      type: "file",
+      style: { display: "none" },
+      multiple: true,
+      webkitdirectory: "",
+      onChange: () => {
+      }
+    }),
+    // Actions - no-op by default, can be spied on
+    open: () => {
+    },
+    processFiles: async () => {
+    },
+    reset: () => {
+    },
+    // Helpers
+    getFilesForUpload: () => validFiles.map((f) => f.file)
+  };
+}
+function createMockDropWithSpies(options = {}) {
+  const baseDrop = createMockDrop(options);
+  let openCalls = 0;
+  let processFilesCalls = [];
+  let resetCalls = 0;
+  const trackedSpies = {
+    open: Object.assign(() => {
+      openCalls++;
+    }, {
+      calls: () => openCalls,
+      toHaveBeenCalled: () => openCalls > 0
+    }),
+    processFiles: Object.assign(async (files) => {
+      processFilesCalls.push(files);
+    }, {
+      calls: () => processFilesCalls,
+      toHaveBeenCalled: () => processFilesCalls.length > 0,
+      toHaveBeenCalledWith: (files) => processFilesCalls.some((c) => c === files)
+    }),
+    reset: Object.assign(() => {
+      resetCalls++;
+    }, {
+      calls: () => resetCalls,
+      toHaveBeenCalled: () => resetCalls > 0
+    }),
+    getFilesForUpload: baseDrop.getFilesForUpload
+  };
+  return {
+    drop: {
+      ...baseDrop,
+      open: trackedSpies.open,
+      processFiles: trackedSpies.processFiles,
+      reset: trackedSpies.reset,
+      getFilesForUpload: trackedSpies.getFilesForUpload
+    },
+    spies: trackedSpies
+  };
+}
+var mockFileIdCounter = 0;
+function createMockProcessedFile(name, options = {}) {
+  const {
+    path = name,
+    content = "test content",
+    type = "text/plain",
+    status = "ready",
+    statusMessage
+  } = options;
+  const file = new File([content], name, { type });
+  return {
+    id: `mock-file-${++mockFileIdCounter}`,
+    file,
+    path,
+    name,
+    size: file.size,
+    type,
+    lastModified: Date.now(),
+    status,
+    statusMessage
+  };
+}
+function createMockFile(name, content = "test content", type = "text/plain") {
+  return new File([content], name, { type, lastModified: Date.now() });
+}
+function createMockFileWithPath(name, webkitRelativePath, content = "test content", type = "text/plain") {
+  const file = createMockFile(name, content, type);
+  Object.defineProperty(file, "webkitRelativePath", {
+    value: webkitRelativePath,
+    writable: false,
+    enumerable: true,
+    configurable: true
+  });
+  return file;
+}
+function createMockErrorStatus(title = "Validation Failed", details = "One or more files failed validation", errors = []) {
+  return { title, details, errors };
+}
+function createMockProcessingStatus(title = "Processing...", details = "Validating and preparing files.") {
+  return { title, details };
+}
+function createMockReadyStatus(fileCount) {
+  return {
+    title: "Ready",
+    details: `${fileCount} file(s) are ready.`
+  };
+}
+
+export { createMockDrop, createMockDropWithSpies, createMockErrorStatus, createMockFile, createMockFileWithPath, createMockProcessedFile, createMockProcessingStatus, createMockReadyStatus };
+//# sourceMappingURL=testing.js.map
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing.ts"],"names":[],"mappings":"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","file":"testing.js","sourcesContent":["/**\n * Test utilities for @shipstatic/drop\n *\n * Import from '@shipstatic/drop/testing' in your test files:\n *\n * ```typescript\n * import { createMockDrop, createMockFile } from '@shipstatic/drop/testing';\n * ```\n */\n\nimport type { ProcessedFile, DropStatus, DropStateValue } from './types';\nimport type { DropReturn, DropzonePropsOptions } from './hooks/useDrop';\n\n// ============================================================================\n// Mock Drop Hook Return\n// ============================================================================\n\n/**\n * Options for creating a mock drop return value\n */\nexport interface MockDropOptions {\n  phase?: DropStateValue;\n  files?: ProcessedFile[];\n  sourceName?: string;\n  status?: DropStatus | null;\n}\n\n/**\n * Creates a mock DropReturn for testing components that receive drop as a prop\n *\n * @example\n * ```tsx\n * import { createMockDrop, createMockProcessedFile } from '@shipstatic/drop/testing';\n *\n * it('renders file count when files are ready', () => {\n *   const drop = createMockDrop({\n *     phase: 'ready',\n *     files: [createMockProcessedFile('index.html')],\n *   });\n *\n *   render(<DeployDropArea drop={drop} />);\n *   expect(screen.getByText('1 files ready')).toBeInTheDocument();\n * });\n * ```\n */\nexport function createMockDrop(options: MockDropOptions = {}): DropReturn {\n  const {\n    phase = 'idle',\n    files = [],\n    sourceName = '',\n    status = null,\n  } = options;\n\n  const validFiles = files.filter(f => f.status === 'ready');\n\n  return {\n    // State\n    phase,\n    isProcessing: phase === 'processing',\n    isDragging: phase === 'dragging',\n    isInteractive: phase === 'idle' || phase === 'dragging' || phase === 'ready',\n    hasError: phase === 'error',\n    files,\n    validFiles,\n    sourceName,\n    status,\n\n    // Prop getters - return minimal objects for spreading\n    getDropzoneProps: (opts?: DropzonePropsOptions) => ({\n      onDragOver: () => {},\n      onDragLeave: () => {},\n      onDrop: () => {},\n      ...(opts?.clickable !== false && { onClick: () => {} }),\n    }),\n    getInputProps: () => ({\n      ref: { current: null },\n      type: 'file' as const,\n      style: { display: 'none' },\n      multiple: true,\n      webkitdirectory: '',\n      onChange: () => {},\n    }),\n\n    // Actions - no-op by default, can be spied on\n    open: () => {},\n    processFiles: async () => {},\n    reset: () => {},\n\n    // Helpers\n    getFilesForUpload: () => validFiles.map(f => f.file),\n  };\n}\n\n/**\n * Creates a mock drop with spy functions for testing interactions\n *\n * @example\n * ```tsx\n * import { createMockDropWithSpies } from '@shipstatic/drop/testing';\n *\n * it('calls reset when Clear button is clicked', async () => {\n *   const { drop, spies } = createMockDropWithSpies({ phase: 'ready', files: [...] });\n *\n *   render(<DeployDropArea drop={drop} />);\n *   await userEvent.click(screen.getByText('Clear'));\n *\n *   expect(spies.reset).toHaveBeenCalled();\n * });\n * ```\n */\nexport function createMockDropWithSpies(options: MockDropOptions = {}): {\n  drop: DropReturn;\n  spies: {\n    open: () => void;\n    processFiles: (files: File[]) => Promise<void>;\n    reset: () => void;\n    getFilesForUpload: () => File[];\n  };\n} {\n  const baseDrop = createMockDrop(options);\n\n  const spies = {\n    open: createNoopSpy(),\n    processFiles: createAsyncNoopSpy(),\n    reset: createNoopSpy(),\n    getFilesForUpload: (() => baseDrop.getFilesForUpload()) as () => File[],\n  };\n\n  // Track calls manually (works without vitest in runtime)\n  let openCalls = 0;\n  let processFilesCalls: File[][] = [];\n  let resetCalls = 0;\n\n  const trackedSpies = {\n    open: Object.assign(() => { openCalls++; }, {\n      calls: () => openCalls,\n      toHaveBeenCalled: () => openCalls > 0,\n    }),\n    processFiles: Object.assign(async (files: File[]) => { processFilesCalls.push(files); }, {\n      calls: () => processFilesCalls,\n      toHaveBeenCalled: () => processFilesCalls.length > 0,\n      toHaveBeenCalledWith: (files: File[]) => processFilesCalls.some(c => c === files),\n    }),\n    reset: Object.assign(() => { resetCalls++; }, {\n      calls: () => resetCalls,\n      toHaveBeenCalled: () => resetCalls > 0,\n    }),\n    getFilesForUpload: baseDrop.getFilesForUpload,\n  };\n\n  return {\n    drop: {\n      ...baseDrop,\n      open: trackedSpies.open,\n      processFiles: trackedSpies.processFiles,\n      reset: trackedSpies.reset,\n      getFilesForUpload: trackedSpies.getFilesForUpload,\n    },\n    spies: trackedSpies,\n  };\n}\n\n// ============================================================================\n// Mock File Utilities\n// ============================================================================\n\nlet mockFileIdCounter = 0;\n\n/**\n * Creates a mock ProcessedFile for testing\n */\nexport function createMockProcessedFile(\n  name: string,\n  options: {\n    path?: string;\n    content?: string;\n    type?: string;\n    status?: 'ready' | 'validation_failed' | 'processing_error' | 'empty_file';\n    statusMessage?: string;\n  } = {}\n): ProcessedFile {\n  const {\n    path = name,\n    content = 'test content',\n    type = 'text/plain',\n    status = 'ready',\n    statusMessage,\n  } = options;\n\n  const file = new File([content], name, { type });\n\n  return {\n    id: `mock-file-${++mockFileIdCounter}`,\n    file,\n    path,\n    name,\n    size: file.size,\n    type,\n    lastModified: Date.now(),\n    status,\n    statusMessage,\n  };\n}\n\n/**\n * Creates a mock File object\n */\nexport function createMockFile(\n  name: string,\n  content: string = 'test content',\n  type: string = 'text/plain'\n): File {\n  return new File([content], name, { type, lastModified: Date.now() });\n}\n\n/**\n * Creates a mock File object with webkitRelativePath set\n */\nexport function createMockFileWithPath(\n  name: string,\n  webkitRelativePath: string,\n  content: string = 'test content',\n  type: string = 'text/plain'\n): File {\n  const file = createMockFile(name, content, type);\n  Object.defineProperty(file, 'webkitRelativePath', {\n    value: webkitRelativePath,\n    writable: false,\n    enumerable: true,\n    configurable: true,\n  });\n  return file;\n}\n\n// ============================================================================\n// Mock Status Utilities\n// ============================================================================\n\n/**\n * Creates a mock error status\n */\nexport function createMockErrorStatus(\n  title: string = 'Validation Failed',\n  details: string = 'One or more files failed validation',\n  errors: string[] = []\n): DropStatus {\n  return { title, details, errors };\n}\n\n/**\n * Creates a mock processing status\n */\nexport function createMockProcessingStatus(\n  title: string = 'Processing...',\n  details: string = 'Validating and preparing files.'\n): DropStatus {\n  return { title, details };\n}\n\n/**\n * Creates a mock ready status\n */\nexport function createMockReadyStatus(fileCount: number): DropStatus {\n  return {\n    title: 'Ready',\n    details: `${fileCount} file(s) are ready.`,\n  };\n}\n\n// ============================================================================\n// Internal Helpers\n// ============================================================================\n\nfunction createNoopSpy(): () => void {\n  return () => {};\n}\n\nfunction createAsyncNoopSpy(): () => Promise<void> {\n  return async () => {};\n}\n"]}

package/dist/useDrop-CRUVkVzW.d.cts

@@ -0,0 +1,168 @@
+import { ValidationError } from '@shipstatic/types';
+import { Ship } 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;
+}
+/** 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;
+    /** Whether currently processing files (ZIP extraction, etc.) */
+    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 */
+    sourceName: string;
+    /** Flattened access to status */
+    status: {
+        title: string;
+        details: string;
+        errors?: string[];
+    } | null;
+    /** 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;
+    };
+    /** 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>;
+    /** Reset state and clear all files */
+    reset: () => void;
+    /** Get only valid files ready for upload */
+    validFiles: ProcessedFile[];
+    /** Get raw File objects ready for Ship SDK upload */
+    getFilesForUpload: () => File[];
+}
+/**
+ * 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;
+
+export { type ClientError as C, type DropOptions as D, FILE_STATUSES as F, type ProcessedFile as P, type DropReturn as a, type DropState as b, type DropStateValue as c, type DropStatus as d, type DropzonePropsOptions as e, type FileStatus as f, type FileWithPath as g, useDrop as u };

package/dist/useDrop-CRUVkVzW.d.ts

@@ -0,0 +1,168 @@
+import { ValidationError } from '@shipstatic/types';
+import { Ship } 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;
+}
+/** 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;
+    /** Whether currently processing files (ZIP extraction, etc.) */
+    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 */
+    sourceName: string;
+    /** Flattened access to status */
+    status: {
+        title: string;
+        details: string;
+        errors?: string[];
+    } | null;
+    /** 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;
+    };
+    /** 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>;
+    /** Reset state and clear all files */
+    reset: () => void;
+    /** Get only valid files ready for upload */
+    validFiles: ProcessedFile[];
+    /** Get raw File objects ready for Ship SDK upload */
+    getFilesForUpload: () => File[];
+}
+/**
+ * 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;
+
+export { type ClientError as C, type DropOptions as D, FILE_STATUSES as F, type ProcessedFile as P, type DropReturn as a, type DropState as b, type DropStateValue as c, type DropStatus as d, type DropzonePropsOptions as e, type FileStatus as f, type FileWithPath as g, useDrop as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipstatic/drop",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Headless React hook for file dropping, processing, ZIP extraction, and validation - purpose-built for Ship SDK",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -16,6 +16,16 @@
         "types": "./dist/index.d.cts",
         "default": "./dist/index.cjs"
       }
+    },
+    "./testing": {
+      "import": {
+        "types": "./dist/testing.d.ts",
+        "default": "./dist/testing.js"
+      },
+      "require": {
+        "types": "./dist/testing.d.cts",
+        "default": "./dist/testing.cjs"
+      }
     }
   },
   "files": [