NavigationController.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <phosphortileengine_export.h>
#include <QRect>
#include <QString>
#include <QStringList>
#include <functional>
 
namespace PhosphorTiles {
class TilingState;
}
 
namespace PhosphorTileEngine {
 
class AutotileEngine;
 
class PHOSPHORTILEENGINE_EXPORT NavigationController
{
public:
    explicit NavigationController(AutotileEngine* engine);
 
    // ═══════════════════════════════════════════════════════════════════════════
    // Focus/window cycling
    // ═══════════════════════════════════════════════════════════════════════════
 
    void focusNext();
    void focusPrevious();
    void focusMaster();
 
    // ═══════════════════════════════════════════════════════════════════════════
    // Window swapping & rotation
    // ═══════════════════════════════════════════════════════════════════════════
 
    void swapFocusedWithMaster();
    void rotateWindowOrder(bool clockwise);
    void swapFocusedInDirection(const QString& direction, const QString& action,
                                const QString& explicitWindowId = QString());
    void focusInDirection(const QString& direction, const QString& action, const QString& explicitWindowId = QString());
    void moveFocusedToPosition(int position, const QString& explicitWindowId = QString());
 
    // ═══════════════════════════════════════════════════════════════════════════
    // Split ratio adjustment
    // ═══════════════════════════════════════════════════════════════════════════
 
    void increaseMasterRatio(qreal delta);
    void decreaseMasterRatio(qreal delta);
    void setGlobalSplitRatio(qreal ratio);
    void setGlobalMasterCount(int count);
 
    // ═══════════════════════════════════════════════════════════════════════════
    // Master count adjustment
    // ═══════════════════════════════════════════════════════════════════════════
 
    void adjustMasterCount(int delta);
 
    QString entryWindowOnScreen(const QString& screenId, const QString& direction) const;
 
    int windowOrderIndexOnScreen(const QString& screenId, const QString& windowId) const;
 
    QStringList tiledWindowsForFocusedScreen(QString& outScreenId, PhosphorTiles::TilingState*& outState,
                                             const QString& explicitWindowId = QString(),
                                             bool requireTiledWindows = true);
 
private:
    static bool isForwardDirection(const QString& direction);
 
    QString resolveActiveScreen() const;
 
    PhosphorTiles::TilingState* resolveActiveState(QString& outScreenId) const;
 
    void emitFocusRequestAtIndex(int indexOffset, bool useFirst = false);
 
    void activateResolvedWindowAtIndex(const QStringList& windows, PhosphorTiles::TilingState* state, int indexOffset,
                                       bool useFirst);
 
    QString directionalNeighborWindow(PhosphorTiles::TilingState* state, const QStringList& windows,
                                      const QString& focused, const QString& direction, bool& outHasGeometry) const;
 
    QString crossOutputFocusTarget(const QString& sourceScreenId, const QString& focused,
                                   const QString& direction) const;
 
    bool crossOutputMove(const QString& sourceScreenId, const QString& focused, const QString& direction,
                         const QString& action);
 
    QString crossDesktopFocusTarget(const QString& sourceScreenId, const QString& direction) const;
 
    bool crossDesktopMove(const QString& sourceScreenId, const QString& focused, const QString& direction);
 
    QRect rectForWindowInState(PhosphorTiles::TilingState* state, const QString& windowId) const;
 
    void applyToAllStates(const std::function<bool(const QString& screenId, PhosphorTiles::TilingState*)>& operation);
 
    AutotileEngine* m_engine = nullptr;
};
 
} // namespace PhosphorTileEngine