Commands.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 <QCoreApplication>
 
#include "App/Element/GraphicElement.h"
#include "App/Scene/Scene.h"
 
class Connection;
 
namespace CommandUtils {
    // Element/Connection lookup (scene-scoped)
    GraphicElement *findElm(Scene *scene, const int id);
    Connection *findConn(Scene *scene, const int id);
    const QList<GraphicElement *> findElements(Scene *scene, const QList<int> &ids);
    const QList<QGraphicsItem *> findItems(Scene *scene, const QList<int> &ids);
 
    // Serialization helpers
    const QList<QGraphicsItem *> loadItems(Scene *scene, QByteArray &itemData, const QList<int> &ids, QList<int> &otherIds);
    const QList<QGraphicsItem *> loadList(const QList<QGraphicsItem *> &items, QList<int> &ids, QList<int> &otherIds);
    void saveItems(Scene *scene, QByteArray &itemData, const QList<QGraphicsItem *> &items, const QList<int> &otherIds);
 
    // Scene operations
    void addItems(Scene *scene, const QList<QGraphicsItem *> &items);
    void deleteItems(Scene *scene, const QList<QGraphicsItem *> &items);

    void drainPortConnections(GraphicElement *elm, int fromPort, int toPort,
                              bool isInput, QDataStream &stream, Scene *scene);
 
    // ID management
    void storeIds(const QList<QGraphicsItem *> &items, QList<int> &ids);
    void storeOtherIds(const QList<QGraphicsItem *> &connections, const QList<int> &ids, QList<int> &otherIds);
}

class ElementsCommand : public QUndoCommand
{
protected:
    explicit ElementsCommand(const QList<GraphicElement *> &elements, Scene *scene, QUndoCommand *parent = nullptr);

    QList<GraphicElement *> elements() const;
 
    Scene *m_scene;
    QList<int> m_ids;
};

class AddItemsCommand : public QUndoCommand
{
    Q_DECLARE_TR_FUNCTIONS(AddItemsCommand)
 
public:
    explicit AddItemsCommand(const QList<QGraphicsItem *> &items, Scene *scene, QUndoCommand *parent = nullptr);

    void redo() override;

    void undo() override;
 
private:
    // --- Members ---
    QByteArray m_itemData;
    QList<int> m_ids;
    QList<int> m_otherIds;
    Scene *m_scene;
};

class DeleteItemsCommand : public QUndoCommand
{
    Q_DECLARE_TR_FUNCTIONS(DeleteItemsCommand)
 
public:
    explicit DeleteItemsCommand(const QList<QGraphicsItem *> &items, Scene *scene, QUndoCommand *parent = nullptr);

    void redo() override;

    void undo() override;
 
private:
    // --- Members ---
    QByteArray m_itemData;
    QList<int> m_ids;
    QList<int> m_otherIds;
    Scene *m_scene;
};

class RotateCommand : public ElementsCommand
{
    Q_DECLARE_TR_FUNCTIONS(RotateCommand)
 
public:
    explicit RotateCommand(const QList<GraphicElement *> &items, const int angle, Scene *scene, QUndoCommand *parent = nullptr);

    void redo() override;

    void undo() override;
 
private:
    int m_angle;
 
    QList<QPointF> m_positions;
};

class MoveCommand : public ElementsCommand
{
    Q_DECLARE_TR_FUNCTIONS(MoveCommand)
 
public:
    explicit MoveCommand(const QList<GraphicElement *> &list, const QList<QPointF> &oldPositions, Scene *scene, QUndoCommand *parent = nullptr);

    void redo() override;

    void undo() override;
 
private:
    // --- Members ---
    QList<QPointF> m_newPositions;
    QList<QPointF> m_oldPositions;
};

class UpdateCommand : public ElementsCommand
{
    Q_DECLARE_TR_FUNCTIONS(UpdateCommand)
 
public:
    explicit UpdateCommand(const QList<GraphicElement *> &elements, const QByteArray &oldData, Scene *scene, QUndoCommand *parent = nullptr);

    void redo() override;

    void undo() override;
 
private:
    // --- Helpers ---
    void loadData(QByteArray &itemData);

    struct WirelessState {
        GraphicElement *element = nullptr;
        WirelessMode mode = WirelessMode::None;
        QString label;
    };
    QVector<WirelessState> snapshotWirelessState() const;
    static bool wirelessStateDiffers(const QVector<WirelessState> &before,
                                     const QVector<WirelessState> &after);

    void refreshRuntimeState();
 
    // --- Members ---
    QByteArray m_newData;
    QByteArray m_oldData;
    bool m_wirelessTopologyChange = false;
};

class SplitCommand : public QUndoCommand
{
    Q_DECLARE_TR_FUNCTIONS(SplitCommand)
 
public:
    explicit SplitCommand(Connection *conn, QPointF mousePos, Scene *scene, QUndoCommand *parent = nullptr);

    void undo() override;

    void redo() override;
 
private:
    // --- Members ---
    QPointF m_nodePos;
    Scene *m_scene;
    int m_c1Id;
    int m_c2Id;
    int m_elm1Id;
    int m_elm2Id;
    int m_nodeAngle;
    int m_nodeId;
};

class MorphCommand : public ElementsCommand
{
    Q_DECLARE_TR_FUNCTIONS(MorphCommand)
 
public:
    explicit MorphCommand(const QList<GraphicElement *> &elements, ElementType type, Scene *scene, QUndoCommand *parent = nullptr);

    void redo() override;

    void undo() override;
 
private:
    // --- Helpers ---

    struct DeletedConnectionInfo {
        int connectionId;     
        int morphedElementId; 
        int portIndex;        
        bool isInput;         
        int otherElementId;   
        int otherPortIndex;   
    };

    void transferConnections(const QList<GraphicElement *> &from, const QList<GraphicElement *> &to,
                             QList<DeletedConnectionInfo> *deleted = nullptr);

    void transferPortConnections(GraphicElement *oldElm, GraphicElement *newElm,
                                 bool isInput, QList<DeletedConnectionInfo> *deleted);

    void restoreDeletedConnections(const QList<DeletedConnectionInfo> &deleted);
 
    // --- Members ---
    ElementType m_newType;
    QList<ElementType> m_types;
    QList<DeletedConnectionInfo> m_deletedConnections; 
    QList<DeletedConnectionInfo> m_deletedConnectionsOnUndo; 
};

class ChangePortSizeCommand : public ElementsCommand
{
    Q_DECLARE_TR_FUNCTIONS(ChangePortSizeCommand)
 
public:
    explicit ChangePortSizeCommand(const QList<GraphicElement *> &elements, const int newPortSize, Scene *scene, const bool isInput, QUndoCommand *parent = nullptr);

    void redo() override;

    void undo() override;
 
private:
    // --- Members ---
    QByteArray m_oldData;
    QList<int> m_order;
    int m_newPortSize;
    bool m_isInput;
};

class FlipCommand : public ElementsCommand
{
    Q_DECLARE_TR_FUNCTIONS(FlipCommand)
 
public:
    explicit FlipCommand(const QList<GraphicElement *> &items, const int axis, Scene *scene, QUndoCommand *parent = nullptr);

    void redo() override;

    void undo() override;
 
private:
    // --- Members ---
    QList<QPointF> m_positions;
    QPointF m_maxPos;
    QPointF m_minPos;
    int m_axis;
};

class ToggleTruthTableOutputCommand : public QUndoCommand
{
    Q_DECLARE_TR_FUNCTIONS(ToggleTruthTableOutputCommand)
 
public:
    explicit ToggleTruthTableOutputCommand(GraphicElement *element, int pos, Scene *scene, QUndoCommand *parent = nullptr);

    void redo() override;

    void undo() override;
 
private:
    Scene *m_scene;
    int m_id;
    int m_pos;
};

class RegisterBlobCommand : public QUndoCommand
{
    Q_DECLARE_TR_FUNCTIONS(RegisterBlobCommand)
 
public:
    RegisterBlobCommand(const QString &blobName, const QByteArray &data, Scene *scene, QUndoCommand *parent = nullptr);
 
    void redo() override;
    void undo() override;
 
private:
    QString m_blobName;
    QByteArray m_data;
    Scene *m_scene;
};

class RemoveBlobCommand : public QUndoCommand
{
    Q_DECLARE_TR_FUNCTIONS(RemoveBlobCommand)
 
public:
    RemoveBlobCommand(const QString &blobName, Scene *scene, QUndoCommand *parent = nullptr);
 
    void redo() override;
    void undo() override;
 
private:
    QString m_blobName;
    QByteArray m_data;
    Scene *m_scene;
};

class RenameBlobCommand : public QUndoCommand
{
    Q_DECLARE_TR_FUNCTIONS(RenameBlobCommand)
 
public:
    RenameBlobCommand(const QString &oldName, const QString &newName, Scene *scene, QUndoCommand *parent = nullptr);
 
    void redo() override;
    void undo() override;
 
private:
    QString m_oldName;
    QString m_newName;
    Scene *m_scene;
};

class UpdateBlobCommand : public ElementsCommand
{
    Q_DECLARE_TR_FUNCTIONS(UpdateBlobCommand)
 
public:
    struct ConnectionInfo {
        int connectionId;
        int elementId;
        int portIndex;
        bool isInput;
        int otherElementId;
        int otherPortIndex;
    };
 
    explicit UpdateBlobCommand(const QList<GraphicElement *> &elements, const QByteArray &oldData,
                               const QList<ConnectionInfo> &connections, Scene *scene, QUndoCommand *parent = nullptr);

    static QList<ConnectionInfo> captureConnections(const QList<GraphicElement *> &targets);

    void setOldBlob(const QByteArray &blob) { m_oldBlob = blob; }

    void setBlobName(const QString &name) { m_blobName = name; }
 
    void redo() override;
    void undo() override;
 
private:
    void loadData(QByteArray &itemData);
    void reconnectConnections();
 
    QByteArray m_oldData;
    QByteArray m_newData;
    QByteArray m_oldBlob;
    QByteArray m_newBlob;
    QString m_blobName;
    QList<ConnectionInfo> m_connections;
};