import Foundation

extension BackendFeatures {
    /// Backend methods for file open dialogs.
    ///
    /// These are used by ``EnvironmentValues/chooseFile``.
    @MainActor
    public protocol FileOpenDialogs: Core {
        /// Presents an 'Open file' dialog to the user for selecting files or
        /// folders.
        ///
        /// - Parameters:
        ///   - fileDialogOptions: The general file dialog options to use.
        ///   - openDialogOptions: The open dialog-specific options to use.
        ///   - window: The window to attach the dialog to. If `nil`, the backend
        ///     can either make the dialog a whole app modal, a standalone window,
        ///     or a modal for a window of its choosing.
        ///   - handleResult: The action to perform when the user chooses an item
        ///     (or multiple items) or cancels the dialog. Receives a
        ///     `DialogResult<[URL]>`.
        func showOpenDialog(
            fileDialogOptions: FileDialogOptions,
            openDialogOptions: OpenDialogOptions,
            window: Window?,
            resultHandler handleResult: @escaping (DialogResult<[URL]>) -> Void
        )
    }
}