@shipstatic/drop 0.2.29 → 0.3.1

package/dist/testing.cjs

@@ -6,7 +6,8 @@ function createMockDrop(options = {}) {
     phase = "idle",
     files = [],
     sourceName = "",
-    status = null
+    status = null,
+    needsBuild = false
   } = options;
   const validFiles = files.filter((f) => f.status === "ready");
   return {
@@ -20,6 +21,7 @@ function createMockDrop(options = {}) {
     validFiles,
     sourceName,
     status,
+    needsBuild,
     // Prop getters - return minimal objects for spreading
     getDropzoneProps: (opts) => ({
       onDragOver: () => {

package/dist/testing.cjs.map

@@ -1 +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' | 'excluded';\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"]}
+{"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  needsBuild?: boolean;\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    needsBuild = false,\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    needsBuild,\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' | 'excluded';\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

@@ -1,4 +1,4 @@
-import { c as DropStateValue, P as ProcessedFile, d as DropStatus, a as DropReturn } from './useDrop-BI_6TM4c.cjs';
+import { c as DropStateValue, P as ProcessedFile, d as DropStatus, a as DropReturn } from './useDrop-q3T3LVH0.cjs';
 import '@shipstatic/ship';
 
 /**
@@ -19,6 +19,7 @@ interface MockDropOptions {
     files?: ProcessedFile[];
     sourceName?: string;
     status?: DropStatus | null;
+    needsBuild?: boolean;
 }
 /**
  * Creates a mock DropReturn for testing components that receive drop as a prop

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { c as DropStateValue, P as ProcessedFile, d as DropStatus, a as DropReturn } from './useDrop-BI_6TM4c.js';
+import { c as DropStateValue, P as ProcessedFile, d as DropStatus, a as DropReturn } from './useDrop-q3T3LVH0.js';
 import '@shipstatic/ship';
 
 /**
@@ -19,6 +19,7 @@ interface MockDropOptions {
     files?: ProcessedFile[];
     sourceName?: string;
     status?: DropStatus | null;
+    needsBuild?: boolean;
 }
 /**
  * Creates a mock DropReturn for testing components that receive drop as a prop

package/dist/testing.js

@@ -4,7 +4,8 @@ function createMockDrop(options = {}) {
     phase = "idle",
     files = [],
     sourceName = "",
-    status = null
+    status = null,
+    needsBuild = false
   } = options;
   const validFiles = files.filter((f) => f.status === "ready");
   return {
@@ -18,6 +19,7 @@ function createMockDrop(options = {}) {
     validFiles,
     sourceName,
     status,
+    needsBuild,
     // Prop getters - return minimal objects for spreading
     getDropzoneProps: (opts) => ({
       onDragOver: () => {

package/dist/testing.js.map

@@ -1 +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' | 'excluded';\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"]}
+{"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  needsBuild?: boolean;\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    needsBuild = false,\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    needsBuild,\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' | 'excluded';\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-BI_6TM4c.d.cts → useDrop-q3T3LVH0.d.cts}

@@ -84,6 +84,7 @@ interface DropState {
     files: ProcessedFile[];
     sourceName: string;
     status: DropStatus | null;
+    needsBuild: boolean;
 }
 
 interface DropOptions {
@@ -117,11 +118,9 @@ interface DropReturn {
     /** Flattened access to source name */
     sourceName: string;
     /** Flattened access to status */
-    status: {
-        title: string;
-        details: string;
-        errors?: string[];
-    } | null;
+    status: DropStatus | null;
+    /** Whether the dropped files need server-side building before deployment */
+    needsBuild: boolean;
     /** Get props to spread on dropzone element (handles drag & drop, optionally click) */
     getDropzoneProps: (options?: DropzonePropsOptions) => {
         onDragOver: (e: React.DragEvent) => void;
@@ -151,21 +150,6 @@ interface DropReturn {
     /** 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-BI_6TM4c.d.ts → useDrop-q3T3LVH0.d.ts}

@@ -84,6 +84,7 @@ interface DropState {
     files: ProcessedFile[];
     sourceName: string;
     status: DropStatus | null;
+    needsBuild: boolean;
 }
 
 interface DropOptions {
@@ -117,11 +118,9 @@ interface DropReturn {
     /** Flattened access to source name */
     sourceName: string;
     /** Flattened access to status */
-    status: {
-        title: string;
-        details: string;
-        errors?: string[];
-    } | null;
+    status: DropStatus | null;
+    /** Whether the dropped files need server-side building before deployment */
+    needsBuild: boolean;
     /** Get props to spread on dropzone element (handles drag & drop, optionally click) */
     getDropzoneProps: (options?: DropzonePropsOptions) => {
         onDragOver: (e: React.DragEvent) => void;
@@ -151,21 +150,6 @@ interface DropReturn {
     /** 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.29",
+  "version": "0.3.1",
   "description": "Headless React hook for file dropping, processing, ZIP extraction, and validation - purpose-built for Ship SDK",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -51,22 +51,22 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@shipstatic/ship": "^0.7.13",
-    "jszip": "^3.10.1",
+    "@shipstatic/ship": "^0.7.16",
+    "fflate": "^0.8.2",
     "mime-db": "^1.54.0"
   },
   "devDependencies": {
-    "@shipstatic/types": "^0.7.5",
+    "@shipstatic/types": "^0.7.7",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
     "@types/mime-db": "^1.43.6",
-    "@types/node": "^25.3.3",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@vitest/coverage-v8": "^3.2.4",
     "buffer": "^6.0.3",
-    "happy-dom": "^20.8.3",
+    "happy-dom": "^20.8.4",
     "husky": "^9.1.7",
     "jsdom": "^27.4.0",
     "path-browserify": "^1.0.1",