Copy Operations

/**
 * Execute copy tasks with the provided options
 * @param tasks Array of copy tasks to execute
 * @param taskOptions Execution options including logger and error handling
 */
function copyAction(tasks: CopyTask[], taskOptions: TaskOptions): Promise<void>;

export default copyAction;

/**
 * Options for copy operations extending fs-extra CopyOptions
 */
interface CopyActionOptions extends FsCopyOptions {
  /** Flatten directory structure - copy all files to destination root (default: false) */
  flat?: boolean;
}

/**
 * fs-extra copy options used by CopyActionOptions
 */
type FsCopyOptions = Pick<CopyOptions, 'overwrite' | 'preserveTimestamps'>;

/**
 * Fast-glob options for copy operations (excludes absolute and cwd)
 */
type CopyGlobOptions = Omit<FgOptions, 'absolute' | 'cwd'>;

/**
 * Task execution options
 */
type TaskOptions = {
  runTasksInSeries: boolean;
  logger: Logger;
  handleError: (error: Error) => void;
};

/**
 * Internal task structure for copy operations
 */
interface CopyTask {
  source: string;
  absoluteSource: string;
  destination: string;
  absoluteDestination?: string;
  context?: string;
  toType?: 'dir' | 'file';
  options?: CopyActionOptions;
  globOptions?: CopyGlobOptions;
}

// Basic file copy
{
  copy: [
    { source: './src/config.json', destination: './dist/config.json' }
  ]
}

// Directory copy
{
  copy: [
    { source: './src/assets', destination: './dist/assets' }
  ]
}

// Glob pattern copy
{
  copy: [
    { source: './src/**/*.js', destination: './dist' },
    { source: './src/**/*.{html,css}', destination: './dist' }
  ]
}

// Copy with options
{
  copy: [
    {
      source: './src/images',
      destination: './dist/assets',
      options: {
        flat: true,
        overwrite: false,
        preserveTimestamps: true
      }
    }
  ]
}

// Copy with glob options
{
  copy: [
    {
      source: './src/**/*',
      destination: './dist',
      globOptions: {
        dot: true,        // Include hidden files
        ignore: ['**/*.tmp', '**/*.log']
      }
    }
  ]
}

// Copy file into directory (trailing slash indicates directory)
{
  copy: [
    { source: './README.md', destination: './dist/' }
  ]
}