import type { Logger } from 'pino';
import type { AppConfig } from '../models/config.js';
import type { ArchiveMode, FileOperation } from '../models/fileOperation.js';
import type { LetterCache } from './destinationResolver.js';
/**
 * Scans a source directory and returns the list of FileOperations to execute.
 *
 * - Regular files are matched against configured media types.
 * - Directories are recursed into only if `recurse` is true.
 * - Unknown extensions and unmatched files are silently skipped
 *   (except `date` mode where a warning is emitted for missing destinations).
 *
 * A shared `LetterCache` ensures all files of the same media type and capture
 * date processed in a single run land in the same letter subdirectory.
 */
export declare function scanDirectory(srcDir: string, config: AppConfig, targetDir: string, mode: ArchiveMode, recurse: boolean, logger: Logger, letterCache?: LetterCache): FileOperation[];