/*
    SPDX-FileCopyrightText: 2007 Bruno Virlet <bruno.virlet@gmail.com>

    SPDX-License-Identifier: LGPL-2.0-or-later
*/

#pragma once

#include "akonadicore_export.h"
#include <QSortFilterProxyModel>

#include <memory>

namespace Akonadi
{
class CollectionModel;
class CollectionFilterProxyModelPrivate;

/*!
 * \brief A proxy model that filters collections by mime type.
 *
 * This class can be used on top of a CollectionModel to filter out
 * all collections that doesn't match a given mime type.
 *
 * For instance, a mail application will use addMimeType( "message/rfc822" ) to only show
 * collections containing mail.
 *
 * \de
 *
 *   Akonadi::CollectionModel *model = new Akonadi::CollectionModel( this );
 *
 *   Akonadi::CollectionFilterProxyModel *proxy = new Akonadi::CollectionFilterProxyModel();
 *   proxy->addMimeTypeFilter( "message/rfc822" );
 *   proxy->setSourceModel( model );
 *
 *   QTreeView *view = new QTreeView( this );
 *   view->setModel( proxy );
 *
 * \endcode
 *
 * @author Bruno Virlet <bruno.virlet@gmail.com>
 *
 * \class Akonadi::CollectionFilterProxyModel
 * \inheaderfile Akonadi/CollectionFilterProxyModel
 * \inmodule AkonadiCore
 */
class AKONADICORE_EXPORT CollectionFilterProxyModel : public QSortFilterProxyModel
{
    Q_OBJECT

public:
    /*!
     * Creates a new collection proxy filter model.
     *
     * \ parent The parent object.
     */
    explicit CollectionFilterProxyModel(QObject *parent = nullptr);

    /*!
     * Destroys the collection proxy filter model.
     */
    ~CollectionFilterProxyModel() override;

    /*!
     * Adds a list of mime types to be shown by the filter.
     *
     * \ mimeTypes A list of mime types to be shown.
     */
    void addMimeTypeFilters(const QStringList &mimeTypes);

    /*!
     * Adds a mime type to be shown by the filter.
     *
     * \ mimeType A mime type to be shown.
     */
    void addMimeTypeFilter(const QString &mimeType);

    /*!
     * Returns the list of mime type filters.
     */
    [[nodiscard]] QStringList mimeTypeFilters() const;

    /*!
     * Sets whether we want virtual collections to be filtered or not.
     * By default, virtual collections are accepted.
     *
     * \ exclude If true, virtual collections aren't accepted.
     *
     * \since 4.7
     */
    void setExcludeVirtualCollections(bool exclude);
    /*
     * \since 4.12
     */
    [[nodiscard]] bool excludeVirtualCollections() const;

    /*!
     * Clears all mime type filters.
     */
    void clearFilters();

    [[nodiscard]] Qt::ItemFlags flags(const QModelIndex &index) const override;

protected:
    bool filterAcceptsRow(int sourceRow, const QModelIndex &sourceParent) const override;

private:
    friend class CollectionFilterProxyModelPrivate;
    std::unique_ptr<CollectionFilterProxyModelPrivate> const d;
};

}
