ICRegistry.h

Go to the documentation of this file.

// Copyright 2015 - 2026, GIBIS-UNIFESP and the wiRedPanda contributors
// SPDX-License-Identifier: GPL-3.0-or-later

 
#pragma once
 
#include <functional>
 
#include <QFileSystemWatcher>
#include <QMap>
#include <QObject>
#include <QSet>
 
class GraphicElement;
class IC;
class Scene;

class ICRegistry : public QObject
{
    Q_OBJECT
 
public:
    explicit ICRegistry(Scene *scene);

    const QByteArray &cachedFileBytes(const QString &filePath);

    void invalidate(const QString &filePath);

    void watchFile(const QString &filePath);

    QList<GraphicElement *> findICsByFile(const QString &fileName) const;
 
    // --- Embedded IC blob storage ---

    bool hasBlob(const QString &name) const;
    QByteArray blob(const QString &name) const;
    void setBlob(const QString &name, const QByteArray &data);
    void registerBlob(const QString &name, const QByteArray &data);
    void removeBlob(const QString &name);
    void renameBlob(const QString &oldName, const QString &newName);
    const QMap<QString, QByteArray> &blobMap() const { return m_blobs; }
    QMap<QString, QByteArray> &blobMapRef() { return m_blobs; }
    void clearBlobs();

    QList<GraphicElement *> findICsByBlobName(const QString &blobName) const;

    bool initEmbeddedIC(IC *ic, const QString &blobName);

    QString uniqueBlobName(const QString &baseName) const;
 
    // --- Batch operations (undo-aware) ---

    IC *createEmbeddedIC(const QString &blobName, const QByteArray &fileBytes, const QString &contextDir);

    int embedICsByFile(const QString &fileName, const QByteArray &fileBytes,
                       const QString &blobName);

    int extractToFile(const QString &blobName, const QString &filePath);
 
    // --- Serialization helpers ---

    static QByteArray captureSnapshot(const QList<GraphicElement *> &targets);

    static void rollbackElements(const QList<GraphicElement *> &elements, const QByteArray &snapshot,
                                 Scene *scene);
 
signals:
    void definitionChanged(const QString &filePath);

    void blobRenamed(const QString &oldName, const QString &newName);
 
private slots:
    void onFileChanged(const QString &filePath);
 
private:
    static constexpr int kMaxBlobNestingDepth = 16;

    void makeBlobSelfContained(const QString &name, QSet<QString> &visited,
                               QMap<QString, QByteArray> &blobs, int depth = 0);

    static void renameBlobReference(QByteArray &blobData, const QString &oldName, const QString &newName);

    void reloadTargetsAtomically(const QList<GraphicElement *> &targets, const QByteArray &oldData,
                                 const std::function<void(IC *)> &mutate);
 
    Scene *m_scene;                          
    QMap<QString, QByteArray> m_fileCache;   
    QMap<QString, QByteArray> m_blobs;       
    QFileSystemWatcher m_fileWatcher;        
};