DecorationManager.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <phosphorcompositor_export.h>
 
#include <PhosphorCompositor/ICompositorBridge.h>
 
#include <QHash>
#include <QObject>
#include <QString>
#include <QVector>
 
#include <optional>
 
namespace PhosphorCompositor {
 
class PHOSPHORCOMPOSITOR_EXPORT DecorationManager : public QObject
{
    Q_OBJECT
 
public:
    enum class OwnerKind {
        Rule
    };
 
    struct Owner
    {
        OwnerKind kind;
        QString screenId;
        bool operator==(const Owner&) const = default;
    };
    static Owner rule()
    {
        return {OwnerKind::Rule, QString()};
    }
 
    enum class Placement {
        CallerWillPlace,
        AlreadyPlaced,
    };
 
    explicit DecorationManager(ICompositorBridge& bridge, QObject* parent = nullptr);
 
    // ── Ownership ──────────────────────────────────────────────────────
    void acquire(const QString& windowId, const Owner& owner, Placement placement = Placement::AlreadyPlaced);
 
    // ── Bulk operations ────────────────────────────────────────────────
    void restoreAll();
    void forgetWindow(const QString& windowId);
 
    // ── Window-rule layer (tri-state) ──────────────────────────────────
    void setRuleOverride(const QString& windowId, std::optional<bool> ruleValue);
    void clearAllRuleOverrides();
 
    // ── External-reset resync ──────────────────────────────────────────
    void resyncWindow(const QString& windowId);
 
    // ── Queries ────────────────────────────────────────────────────────
    // The state-observation surface: production code expresses everything
    // through the ownership calls above, so these exist for the behavioral
    // test spec (and future render-layer integration) to assert manager
    // state without reaching into internals.
    bool isBorderless(const QString& windowId) const;
    bool isOwned(const QString& windowId) const;
    bool isOwnedBy(const QString& windowId, const Owner& owner) const;
    bool isVetoed(const QString& windowId) const;
 
Q_SIGNALS:
    void windowDecorationRestored(const QString& windowId);
 
private:
    struct Entry
    {
        QVector<Owner> owners; // small-N linear scan
        bool vetoed = false;
        bool evaluated = false; 
        bool eligible = false; 
        bool priorNoBorder = false; 
        bool physicallyHidden = false;
    };
 
    void reconcile(const QString& windowId, Entry& entry, Placement placement);
    void finishRelease(const QString& windowId, Entry& entry);
    WindowHandle resolveExact(const QString& windowId) const;
    void hideNow(WindowHandle w, Placement placement);
    bool restoreNow(const QString& windowId, Entry& entry, bool reassertGeometry);
    void pruneIfEmpty(const QString& windowId);
 
    QHash<QString, Entry> m_windows;
    ICompositorBridge& m_bridge;
};
 
} // namespace PhosphorCompositor