preferences_panel.hpp

Go to the documentation of this file.

#pragma once

 
#include <algorithm>
#include <functional>
#include <memory>
#include <optional>
#include <string>
#include <vector>
 
#include <pulp/state/properties_file.hpp>
#include <pulp/view/view.hpp>
 
namespace pulp::view {
 
class PreferencesPanel : public View {
public:
    struct Page {
        std::string title;
        std::string icon;    
        View* content = nullptr;  
    };
 
    PreferencesPanel() = default;
 
    // ── Page registry ────────────────────────────────────────────────

    void add_page(std::string title,
                  std::string icon,
                  std::unique_ptr<View> content) {
        auto* content_raw = content.get();
        // First page must establish active_=0; later pages stay hidden.
        if (!pages_.empty()) {
            content_raw->set_visible(false);
        }
        add_child(std::move(content));
        pages_.push_back({std::move(title), std::move(icon), content_raw});
        if (pages_.size() == 1) {
            active_ = 0;
            notify_change();
        }
    }
 
    size_t page_count() const { return pages_.size(); }

    View* page_content(size_t index) const {
        return index < pages_.size() ? pages_[index].content : nullptr;
    }
    const std::string& page_title(size_t index) const {
        return index < pages_.size() ? pages_[index].title : empty_string();
    }
    const std::string& page_icon(size_t index) const {
        return index < pages_.size() ? pages_[index].icon : empty_string();
    }
 
    // ── Active page ──────────────────────────────────────────────────
 
    int active_page() const { return active_; }
    std::string active_page_title() const {
        return (active_ >= 0 && static_cast<size_t>(active_) < pages_.size())
                   ? pages_[static_cast<size_t>(active_)].title
                   : std::string{};
    }

    void set_active_page(int index) {
        if (index < 0 || static_cast<size_t>(index) >= pages_.size()) return;
        if (index == active_) return;
        // Hide previous, show new.
        if (active_ >= 0 && static_cast<size_t>(active_) < pages_.size()) {
            if (auto* v = pages_[static_cast<size_t>(active_)].content) v->set_visible(false);
        }
        active_ = index;
        if (auto* v = pages_[static_cast<size_t>(active_)].content) v->set_visible(true);
        persist_active();
        notify_change();
    }

    bool set_active_page(std::string_view title) {
        for (size_t i = 0; i < pages_.size(); ++i) {
            if (pages_[i].title == title) {
                set_active_page(static_cast<int>(i));
                return true;
            }
        }
        return false;
    }

    void simulate_select(int index) { set_active_page(index); }
 
    // ── Persistence ──────────────────────────────────────────────────

    void bind_persistence(pulp::state::PropertiesFile* props) {
        props_ = props;
        if (!props_) return;
        if (auto stored = props_->get_string(persistence_key_)) {
            set_active_page(*stored);
        }
    }

    void clear_persistence() { props_ = nullptr; }
    bool has_persistence() const { return props_ != nullptr; }
 
    void set_persistence_key(std::string key) {
        persistence_key_ = std::move(key);
    }
    const std::string& persistence_key() const { return persistence_key_; }
 
    // ── Observers ────────────────────────────────────────────────────
 
    std::function<void(int active_index)> on_page_change;
 
private:
    void persist_active() const {
        if (!props_) return;
        if (active_ < 0 || static_cast<size_t>(active_) >= pages_.size()) return;
        props_->set_string(persistence_key_, pages_[static_cast<size_t>(active_)].title);
    }
    void notify_change() {
        if (on_page_change) on_page_change(active_);
    }
    static const std::string& empty_string() {
        static const std::string s;
        return s;
    }
 
    std::vector<Page> pages_;                 
    int active_ = -1;
    pulp::state::PropertiesFile* props_ = nullptr;
    std::string persistence_key_ = "preferences.active_page";
};
 
} // namespace pulp::view