WindowPlacementStore.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <PhosphorEngine/WindowPlacement.h>
#include <phosphorengine_export.h>
 
#include <QHash>
#include <QJsonObject>
#include <QList>
#include <QString>
 
#include <functional>
#include <optional>
 
namespace PhosphorEngine {
 
class PHOSPHORENGINE_EXPORT WindowPlacementStore
{
public:
    WindowPlacementStore() = default;
 
    bool record(WindowPlacement placement);
 
    std::optional<WindowPlacement> take(const QString& windowId, const QString& appId,
                                        const std::function<bool(const WindowPlacement&)>& accept = {},
                                        const std::function<bool(const WindowPlacement&)>& preferred = {});
 
    std::optional<WindowPlacement> peek(const QString& windowId, const QString& appId,
                                        const std::function<bool(const WindowPlacement&)>& accept = {}) const;
 
    bool contains(const QString& windowId, const QString& appId = QString()) const;
 
    bool collapsePureFloatSiblings(const QString& appId, const QString& keepWindowId);
 
    bool clear(const QString& windowId);
 
    bool clearFreeGeometry(const QString& windowId);
 
    int transform(const std::function<bool(WindowPlacement&)>& fn);
 
    int removeIf(const std::function<bool(const WindowPlacement&)>& pred);
 
    QList<WindowPlacement> records() const;
 
    QJsonObject serialize(const std::function<bool(const WindowPlacement&)>& keep = {}) const;
    void deserialize(const QJsonObject& obj);
 
    int size() const;
 
private:
    QHash<QString, QList<WindowPlacement>> m_byApp;
    quint64 m_sequence = 0;
 
    static constexpr int MaxPerApp = 16;
};
 
} // namespace PhosphorEngine