VACLibrary.h

/***************************************************************************
 *   Copyright (C) 2024-2025 by Stefan Kebekus                             *
 *   stefan.kebekus@gmail.com                                              *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 3 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/
 
#pragma once
 
#include <QFile>
#include <QProperty>
#include <QStandardPaths>
#include <QTimer>
 
#include "geomaps/VAC.h"
 
 
namespace GeoMaps
{

 
class VACLibrary : public QObject
{
    Q_OBJECT
    QML_ELEMENT
    QML_SINGLETON
 
public:
    VACLibrary(QObject *parent = nullptr);

    ~VACLibrary() override;
 
    //
    // Properties
    //

    Q_PROPERTY(bool hasManuallyImported READ hasManuallyImported BINDABLE bindableHasManuallyImported NOTIFY hasManuallyImportedChanged)
 
    
    Q_PROPERTY(bool isEmpty READ isEmpty BINDABLE bindableIsEmpty NOTIFY isEmptyChanged)

    Q_PROPERTY(QList<GeoMaps::VAC> vacs READ vacs BINDABLE bindableVacs NOTIFY vacsChanged)
 
 
    //
    // Getter Methods
    //

    [[nodiscard]] bool hasManuallyImported() const { return m_hasManuallyImported.value(); }

    [[nodiscard]] QBindable<bool> bindableHasManuallyImported() const { return &m_hasManuallyImported; }

    [[nodiscard]] bool isEmpty() const { return m_isEmpty.value(); }

    [[nodiscard]] QBindable<bool> bindableIsEmpty() const { return &m_isEmpty; }

    [[nodiscard]] QList<GeoMaps::VAC> vacs() const { return m_sortedVacs.value(); }

    [[nodiscard]] QBindable<QList<GeoMaps::VAC>> bindableVacs() const { return &m_sortedVacs; }
 
 
    //
    // Methods
    //

    Q_INVOKABLE void clear();

    [[nodiscard]] Q_INVOKABLE GeoMaps::VAC get(const QString& name);

    [[nodiscard]] Q_INVOKABLE QString importTripKit(const QString& fileName);

    [[nodiscard]] Q_INVOKABLE GeoMaps::VAC materialize(const GeoMaps::VAC& vac);

    [[nodiscard]] Q_INVOKABLE QString importVAC(GeoMaps::VAC vac);

    Q_INVOKABLE void remove(const QString& name);

    [[nodiscard]] Q_INVOKABLE QString rename(const QString& oldName, const QString& newName);

    [[nodiscard]] Q_INVOKABLE QVector<GeoMaps::VAC> vacsByDistance(const QGeoCoordinate& position, const QString& filter);

    [[nodiscard]] Q_INVOKABLE QVector<GeoMaps::VAC> vacs4Point(const QGeoCoordinate& position);
 
signals:
    void hasManuallyImportedChanged();

    void isEmptyChanged();

    void vacsChanged();

    void importTripKitStatus(double percent);
 
private:
    Q_DISABLE_COPY_MOVE(VACLibrary)
 
    // This method cleans the VAC directory. It deletes all VAC from m_vacs that
    // have no raster image files. It looks for unmanaged raster image files and
    // either imports them or deletes them.
    void janitor();
 
    // This method re-reads the chart index from all VAC collection files
    // managed by DataManagement::DataManager, rebuilds m_collectionVacs and
    // deletes stale entries from the extraction cache.
    void updateCollections();
 
    // This method saves m_vacs to m_dataFile.
    void save();
 
    // This method returns the absolute path of a given VAC. Needed for iOS
    // after App Update. See GeoMaps::VACLibrary::janitor
    QString absolutePathForVac(const GeoMaps::VAC&);
    QString absolutePathForVac(const QString& name);
 
    // Source data: manually imported charts and charts from VAC collections.
    // These are bindable so that the derived properties below update through
    // automatic dependency tracking. Mutations must follow the rules for
    // bindable properties: modify a local copy, then assign it back in a
    // single write (see "Qt Bindable Properties" in the Qt documentation).
    QProperty<QVector<GeoMaps::VAC>> m_vacs;
    QProperty<QVector<GeoMaps::VAC>> m_collectionVacs;
 
    // Derived properties, computed through bindings set up in the constructor
    Q_OBJECT_BINDABLE_PROPERTY(GeoMaps::VACLibrary, QVector<GeoMaps::VAC>, m_sortedVacs, &GeoMaps::VACLibrary::vacsChanged)
    Q_OBJECT_BINDABLE_PROPERTY(GeoMaps::VACLibrary, bool, m_isEmpty, &GeoMaps::VACLibrary::isEmptyChanged)
    Q_OBJECT_BINDABLE_PROPERTY(GeoMaps::VACLibrary, bool, m_hasManuallyImported, &GeoMaps::VACLibrary::hasManuallyImportedChanged)
 
    QString m_vacDirectory {QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) + u"/VAC"_s};
    QString m_cacheDirectory {QStandardPaths::writableLocation(QStandardPaths::CacheLocation) + u"/VAC"_s};
    QFile m_dataFile {QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) + u"/VAC.data"_s};
 
    // Compresses multiple change notifications from DataManager into a single
    // call to updateCollections()
    QTimer m_updateCollectionsTimer;
 
};
 
} // namespace GeoMaps