@shipstatic/drop 0.2.0 → 0.2.2

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"]}