import { type UsePasteFilesOptions } from "./file_intake";
/**
 * Ctrl/Cmd+V adds files — the paste half of file intake, alongside the drop
 * (`FileDropTarget` / `FileDropzone`) and the pick (`pickFiles`). Reads whatever
 * the clipboard carries (a copied file, or a screenshot, which some engines
 * surface only through `clipboardData.items`), filters it by `accept`, and hands
 * it to `onFiles`.
 *
 * Scope it with `enabled` so only the open surface listens. Pass `region` (the
 * ref of the surface's DOM region) to route by FOCUS: when the paste fires while
 * focus is inside this region, this sink wins over a later-mounted one — so two
 * peer file sections each take the paste when the user is in them. Without a
 * region it routes by stack order (the modal-stacking default). A paste carrying
 * NO acceptable file is left entirely alone — typing Ctrl+V in a text field
 * still pastes text.
 */
export declare function usePasteFiles(options: UsePasteFilesOptions): void;