ContextResolveKey.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <QHash>
#include <QString>
 
namespace PhosphorZones {
 
struct ContextResolveKey
{
    QString screenId;
    int virtualDesktop = 0;
    QString activity;
    // A free-form fourth key dimension, used by the context resolvers that
    // share the ContextResolveKey type but never the same cache container. It
    // folds in every non-rule-set input the resolved value depends on, so a
    // change in one yields a fresh entry rather than a stale hit:
    //   - gap cascade: contextCacheKeyToken(mode, activeLayout, orientation) —
    //     the SAME (screen, desktop, activity) resolves DIFFERENT gaps per
    //     placement mode, active layout, and screen orientation.
    //   - lock / default-assignment / overlay: contextCacheKeyToken with an
    //     empty mode (they are mode-agnostic) plus activeLayout (except
    //     default-assignment, which omits it to avoid recursion) and orientation.
    //   - assignment resolver: "twc:N|or:<token>" — the tiled-window-count and
    //     the screen orientation (it does not read the active layout).
    // Each resolver owns its own cache hash, so the token vocabularies never
    // collide.
    QString mode;
    bool operator==(const ContextResolveKey& other) const noexcept
    {
        return virtualDesktop == other.virtualDesktop && screenId == other.screenId && activity == other.activity
            && mode == other.mode;
    }
};
 
inline size_t qHash(const ContextResolveKey& key, size_t seed = 0) noexcept
{
    // ::qHash routes to the global Qt qHash overloads. The qualifier is
    // required because of SELF-HIDING: unqualified lookup inside this very
    // qHash overload finds the PhosphorZones::qHash being defined, stops
    // there, and never reaches the global QString/int overloads. Mirrors
    // the same pattern LayoutAssignmentKey uses.
    size_t h = seed;
    h = ::qHash(key.screenId, h);
    h = ::qHash(key.virtualDesktop, h);
    h = ::qHash(key.activity, h);
    h = ::qHash(key.mode, h);
    return h;
}
 
} // namespace PhosphorZones