List.h

Go to the documentation of this file.

//
// List.h
//
 
#ifndef MALENA_LIST_H
#define MALENA_LIST_H
 
#pragma once
 
#include <Malena/Core/malena_export.h>
#include <Malena/Core/Component.h>
#include <Malena/Core/Core.h>
#include <Malena/Manifests/Manifest.h>
#include <Malena/Resources/FontManager.h>
#include <Malena/Graphics/Controls/ListItem.h>
#include <Malena/Traits/Settings/ListSettings.h>
#include <Malena/Traits/Theme/ListTheme.h>
#include <Malena/Traits/Theme/Themeable.h>
#include <SFML/Graphics/RectangleShape.hpp>
#include <SFML/Graphics/RenderTarget.hpp>
#include <functional>
#include <memory>
#include <string>
#include <vector>
#include <type_traits>
 
namespace ml
{
    // ── ListManifest ──────────────────────────────────────────────────────────
 
    class MALENA_API ListManifest : public ml::Manifest
    {
    public:
        enum class Flag  {};
        enum class State {};
    };
 
    // ── List ──────────────────────────────────────────────────────────────────

    class MALENA_API List : public ComponentWith<ListManifest>,
                 public ListSettings,
                 public ListTheme,
                 public Themeable
    {
    public:
        using Flag  = ListManifest::Flag;
        using State = ListManifest::State;
 
    private:
        // ── Row storage ───────────────────────────────────────────────────────
        struct Row
        {
            ml::Core*                  component = nullptr; 
            std::unique_ptr<ListItem>  owned;               
        };
 
        std::vector<Row>              _rows;
        std::vector<sf::RectangleShape> _dividers;
        Row  _pinnedBottom;
        bool _hasPinnedBottom = false;
 
        // ── Layout ────────────────────────────────────────────────────────────
        sf::RectangleShape _background;
        sf::Vector2f       _position = {0.f, 0.f};
        float              _width    = 300.f;
        float              _indent   = 0.f;  
 
        // ── Internal helpers ──────────────────────────────────────────────────
        void layout();
        void rebuildDividers();
        void applyThemeToOwnedItems();
        void applySettingsToOwnedItems();
 
    protected:
        void draw(sf::RenderTarget& target, sf::RenderStates states) const override;
        void onThemeApplied(const Theme& theme) override;
 
    public:
        explicit List(const sf::Font& font = FontManager<>::getDefault());
 
        List(const List&)            = delete;
        List& operator=(const List&) = delete;
 
        // ── Apply ─────────────────────────────────────────────────────────────
 
        template<typename S>
        void applySettings(const S& s)
        {
            static_assert(std::is_base_of_v<ListSettings, S>,
                "applySettings() requires a type derived from ListSettings");
            static_cast<ListSettings&>(*this) = s;
            applySettingsToOwnedItems();
            layout();
        }
 
        template<typename T>
        void applyTheme(const T& t)
        {
            static_assert(std::is_base_of_v<ListTheme, T>,
                "applyTheme() requires a type derived from ListTheme");
            static_cast<ListTheme&>(*this) = t;
            applyThemeToOwnedItems();
            layout();
        }
 
        template<typename St>
        void applyStyle(const St& s)
        {
            static_assert(std::is_base_of_v<ListSettings, St> &&
                          std::is_base_of_v<ListTheme, St>,
                "applyStyle() requires ListSettings and ListTheme");
            static_cast<ListSettings&>(*this) = s;
            static_cast<ListTheme&>(*this)    = s;
            applyThemeToOwnedItems();
            applySettingsToOwnedItems();
            layout();
        }
 
        // ── Adding rows ───────────────────────────────────────────────────────

        ListItem& addItem(const std::string& label,
                          const std::string& description = "",
                          std::function<void()> onClick  = nullptr);

        void add(ml::Core& component);

        ListItem& addPinnedBottom(const std::string& label,
                                  std::function<void()> onClick = nullptr);

        bool removeAt(std::size_t index);

        bool remove(const ml::Core* component);

        void clear();

        [[nodiscard]] std::size_t rowCount() const { return _rows.size(); }

        [[nodiscard]] ListItem* back()
        {
            if (_rows.empty()) return nullptr;
            return dynamic_cast<ListItem*>(_rows.back().component);
        }
 
        // ── Sizing ────────────────────────────────────────────────────────────

        void setWidth(float width);
        void setSize(const sf::Vector2f& size) { setWidth(size.x); }
        [[nodiscard]] float getWidth()       const { return _width; }
        [[nodiscard]] float getTotalHeight() const;
 
        // ── Indent (for nested lists) ─────────────────────────────────────────

        void setIndentOffset(float offset) { _indent = offset; layout(); }
 
        // ── Positionable ──────────────────────────────────────────────────────
 
        void          setPosition(const sf::Vector2f& position) override;
        sf::Vector2f  getPosition()     const override;
        sf::FloatRect getGlobalBounds() const override;
    };
 
    // ── ListWith ──────────────────────────────────────────────────────────────
 
    template<typename MANIFEST>
    class ListWith : public List, public Customizable<MANIFEST>
    { public: using List::List; };
 
} // namespace ml
 
#endif // MALENA_LIST_H