TilingAlgorithm.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <phosphortiles_export.h>
#include "AutotileConstants.h"
// TilingParams, TilingScreenInfo, WindowInfo, buildWindowInfos and EdgeGaps used
// to be declared inline in this header. They now live in TilingParams.h
// (per-call parameter bundles + WindowInfo builder), included here so existing
// callers that only include <PhosphorTiles/TilingAlgorithm.h> compile unchanged.
#include "TilingParams.h"
 
#include <QObject>
#include <QRect>
#include <QString>
#include <QSize>
#include <QVariant>
#include <QVariantMap>
#include <QVector>
#include <functional>
 
namespace PhosphorTiles {
 
class TilingState;
 
class PHOSPHORTILES_EXPORT TilingAlgorithm : public QObject
{
    Q_OBJECT
 
    Q_PROPERTY(QString name READ name CONSTANT)
    Q_PROPERTY(QString description READ description CONSTANT)
    Q_PROPERTY(bool supportsMasterCount READ supportsMasterCount CONSTANT)
    Q_PROPERTY(bool supportsSplitRatio READ supportsSplitRatio CONSTANT)
 
public:
    explicit TilingAlgorithm(QObject* parent = nullptr);
    ~TilingAlgorithm() override = default;
 
    // Prevent copying (QObject rule)
    TilingAlgorithm(const TilingAlgorithm&) = delete;
    TilingAlgorithm& operator=(const TilingAlgorithm&) = delete;
 
    void setAppIdResolver(std::function<QString(const QString&)> resolver)
    {
        m_appIdResolver = std::move(resolver);
    }
 
    std::function<QString(const QString&)> appIdResolver() const
    {
        if (m_appIdResolver) {
            return m_appIdResolver;
        }
        return [](const QString&) {
            return QString();
        };
    }
 
    QString registryId() const
    {
        return m_registryId;
    }
    void setRegistryId(const QString& id)
    {
        m_registryId = id;
    }
 
    virtual QString name() const = 0;
 
    virtual QString description() const = 0;
 
    virtual QVector<QRect> calculateZones(const TilingParams& params) const = 0;
 
    virtual int masterZoneIndex() const;
 
    virtual bool supportsMasterCount() const;
 
    virtual bool supportsSplitRatio() const;
 
    virtual qreal defaultSplitRatio() const;
 
    virtual int minimumWindows() const;
 
    virtual int defaultMaxWindows() const;
 
    virtual bool producesOverlappingZones() const;
 
    // ── noexcept convention for virtual methods ──────────────────────────
    // Methods below are noexcept because they only read cached POD fields.
    // Methods above (supportsMasterCount, supportsSplitRatio, etc.) are NOT
    // noexcept because LuauTileAlgorithm overrides may allocate QStrings or
    // marshal cached script values. When adding new virtuals, use noexcept only
    // if the implementation is guaranteed to never allocate or throw.
 
    virtual QString zoneNumberDisplay() const noexcept;
 
    virtual bool centerLayout() const;
 
    virtual bool supportsSingleWindow() const noexcept;
 
    virtual bool retilesOnFocusChange() const noexcept;
 
    virtual bool isScripted() const noexcept;
 
    virtual bool supportsMinSizes() const noexcept;
 
    virtual QString overlapStacking() const noexcept;
 
    virtual bool supportsMemory() const noexcept;
 
    virtual void prepareTilingState(TilingState* state) const;
 
    virtual bool isUserScript() const noexcept;
 
    // ── Lifecycle Hooks (optional, v2) ──────────────────────────────────
 
    virtual bool supportsLifecycleHooks() const noexcept;
 
    virtual void onWindowAdded(TilingState* state, int windowIndex);
 
    virtual void onWindowRemoved(TilingState* state, int windowIndex);
 
    virtual bool supportsResizeHook() const noexcept;
 
    virtual void onWindowResized(TilingState* state, const ResizeEvent& resize);
 
    virtual bool supportsScriptState() const noexcept;
 
    // ── Custom Parameters (optional, v2) ──────────────────────────────────
 
    virtual bool supportsCustomParams() const noexcept;
 
    virtual QVariantList customParamDefList() const;
 
    virtual bool hasCustomParam(const QString& name) const;
 
protected:
    // Resolver from instance id → live app class. Set by AutotileEngine via
    // setAppIdResolver after constructing/looking up the algorithm. Default
    // is an empty std::function; appIdResolver() returns a no-op lambda in
    // that case so call sites can invoke it unconditionally.
    std::function<QString(const QString&)> m_appIdResolver;
 
    // Registry id — populated by AlgorithmRegistry at registration time so
    // preview / serialisation code holding only a TilingAlgorithm* can
    // recover the id without walking the registry.
    QString m_registryId;
 
    static QRect innerRect(const QRect& screenGeometry, int outerGap);
 
    static QRect innerRect(const QRect& screenGeometry, const EdgeGaps& gaps);
 
Q_SIGNALS:
    void configurationChanged();
};
 
} // namespace PhosphorTiles