/*
 * SPDX-FileCopyrightText: 2004 Carsten Burghardt <burghardt@kde.org>
 *
 * SPDX-License-Identifier: GPL-2.0-only
 */

#pragma once

#include "mailcommon_export.h"

#include <Akonadi/Collection>

#include <QWidget>

class QKeyEvent;

class KJob;
namespace Akonadi
{
class AccountActivitiesAbstract;
}

namespace MailCommon
{
/*!
 * \class MailCommon::FolderRequester
 * \inmodule MailCommon
 * \inheaderfile MailCommon/FolderRequester
 *
 * A widget that contains a QLineEdit which shows the current folder
 * and a button that fires a FolderSelectionDialog
 * The dialog is set to disable readonly folders by default
 * Search folders are excluded
 *
 * @todo This should be cleaned up and go into libakonadi. This includes:
 * - s/Folder/Collection/g
 * - Use Akonadi::CollectionDialog instead of MailCommon::FolderSelectionDialog
 *  - merge that into CollectionDialog
 *  - or allow to replace the built-in dialog by your own
 * - Allow to pass in an existing ETM, to remove the Kernel dependency
 */
class FolderRequesterPrivate;
class MAILCOMMON_EXPORT FolderRequester : public QWidget
{
    Q_OBJECT

public:
    /*!
     * Constructor
     * \a parent the parent widget
     */
    explicit FolderRequester(QWidget *parent = nullptr);
    ~FolderRequester() override;

    /*!
     * Returns the selected collection.
     */
    [[nodiscard]] Akonadi::Collection collection() const;

    /*!
     * Presets the folder to the collection \a collection.
     * Disable fetchcollection when not necessary \a fetchCollection
     */
    void setCollection(const Akonadi::Collection &collection, bool fetchCollection = true);

    /*!
     * Returns \\ true if there's a valid collection set on this widget.
     */
    [[nodiscard]] bool hasCollection() const;

    /*!
     * Sets if readonly folders should be disabled.
     * Be aware that if you disable this the user can also select the
     * 'Local Folders' folder which has no valid folder associated
     */
    void setMustBeReadWrite(bool readwrite);

    /*!
     */
    void setShowOutbox(bool show);

    /*!
     */
    void setNotAllowToCreateNewFolder(bool notCreateNewFolder);

    /*!
     */
    void setSelectFolderTitleDialog(const QString &title);

    /*!
     */
    void setAccountActivities(Akonadi::AccountActivitiesAbstract *accountActivities);
protected Q_SLOTS:
    /*!
     * Opens the folder dialog.
     */
    void slotOpenDialog();

    /*!
     * Updates the information we have about the current folder.
     */
    void slotCollectionsReceived(KJob *);

Q_SIGNALS:
    /*!
     * Emitted when the folder changed.
     */
    void folderChanged(const Akonadi::Collection &);
    void invalidFolder();

protected:
    /*! Capture space key to open the dialog */
    void keyPressEvent(QKeyEvent *e) override;
    void setCollectionFullPath(const Akonadi::Collection &col);

protected:
    std::unique_ptr<FolderRequesterPrivate> const d;
};
}
