LayoutId.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <QLatin1String>
#include <QString>
#include <QtGlobal>
 
namespace PhosphorLayout {
 
namespace LayoutId {
 
inline constexpr QLatin1String AutotilePrefix{"autotile:"};
 
inline bool isAutotile(const QString& id)
{
    return id.startsWith(AutotilePrefix);
}
 
inline QString extractAlgorithmId(const QString& id)
{
    if (!isAutotile(id)) {
        qWarning("PhosphorLayout::LayoutId::extractAlgorithmId called with non-autotile id: %s", qUtf8Printable(id));
        return QString();
    }
    if (id.size() <= AutotilePrefix.size()) {
        return {};
    }
    return id.mid(AutotilePrefix.size());
}
 
inline QString makeAutotileId(const QString& algorithmId)
{
    // Empty algorithmId is a legitimate caller intent: "autotile mode, let
    // the engine pick the default algorithm". The KCM writes exactly this
    // shape via LayoutAdaptor::setAssignmentEntry (mode=Autotile,
    // tilingAlgorithm="") — see AssignmentEntry::activeLayoutId() and
    // LayoutRegistry::setAssignmentEntryDirect's comment. Returning the
    // bare prefix round-trips cleanly: isAutotile("autotile:") is true,
    // extractAlgorithmId("autotile:") returns empty (LayoutId.h above
    // handles id.size() <= prefix.size()), and the assignment cascade
    // treats the entry as non-empty so modeForScreen correctly reports
    // Autotile.
    return AutotilePrefix + algorithmId;
}
 
inline QString normalizeAlgorithmId(const QString& id)
{
    if (id.isEmpty()) {
        return id;
    }
    return isAutotile(id) ? id : makeAutotileId(id);
}
 
} // namespace LayoutId
} // namespace PhosphorLayout