app_framework.hpp

Go to the documentation of this file.

#pragma once

 
#include <pulp/view/input_events.hpp>
#include <functional>
#include <string>
#include <vector>
#include <unordered_map>
#include <filesystem>
#include <optional>
 
namespace pulp::view {
 
// ── Command System ───────────────────────────────────────────────────────

using CommandID = uint32_t;

struct KeyShortcut {
    KeyCode key = KeyCode::unknown;
    uint16_t modifiers = 0;
 
    bool matches(const KeyEvent& event) const {
        return event.key == key && event.modifiers == modifiers && event.is_down;
    }

    static KeyShortcut from_string(const std::string& s);

    std::string to_string() const;
};

struct Command {
    CommandID id = 0;
    std::string name;
    std::string category;      
    KeyShortcut shortcut;
    std::function<void()> action;
    std::function<bool()> is_enabled;  
    bool is_separator = false; 
};
 
// ── KeyMapping ───────────────────────────────────────────────────────────

class KeyMapping {
public:
    void add_command(Command cmd);
    void remove_command(CommandID id);

    bool handle_key(const KeyEvent& event);

    const std::vector<Command>& commands() const { return commands_; }

    std::vector<const Command*> commands_in_category(const std::string& category) const;

    void rebind(CommandID id, KeyShortcut shortcut);

    bool save_bindings(const std::filesystem::path& path) const;

    bool load_bindings(const std::filesystem::path& path);
 
private:
    std::vector<Command> commands_;
};
 
// ── MenuBar ──────────────────────────────────────────────────────────────

class MenuBar {
public:
    struct MenuItem {
        std::string title;
        std::function<void()> action;
        KeyShortcut shortcut;
        bool enabled = true;
        bool is_separator = false;
        std::vector<MenuItem> submenu; 
    };
 
    struct Menu {
        std::string title;
        std::vector<MenuItem> items;
    };

    void add_menu(std::string title, std::vector<MenuItem> items);

    void set_key_mapping(const KeyMapping& keys);

    const std::vector<Menu>& menus() const { return menus_; }
 
private:
    std::vector<Menu> menus_;
};
 
// ── NativeToolbar ────────────────────────────────────────────────────────

class NativeToolbar {
public:
    struct Item {
        std::string id;
        std::string label;
        std::string icon_name;     
        std::function<void()> action;
        bool is_separator = false;
    };
 
    void add_item(Item item);
    void add_separator();
 
    const std::vector<Item>& items() const { return items_; }
 
private:
    std::vector<Item> items_;
};
 
// ── AppSettings ──────────────────────────────────────────────────────────

class AppSettings {
public:
    explicit AppSettings(const std::string& app_name);

    std::optional<std::string> get_string(const std::string& key) const;
    std::optional<int> get_int(const std::string& key) const;
    std::optional<float> get_float(const std::string& key) const;
    std::optional<bool> get_bool(const std::string& key) const;

    void set_string(const std::string& key, const std::string& value);
    void set_int(const std::string& key, int value);
    void set_float(const std::string& key, float value);
    void set_bool(const std::string& key, bool value);

    bool save();
    bool load();

    void save_window_state(int x, int y, int width, int height);
    struct WindowState { int x, y, width, height; };
    std::optional<WindowState> load_window_state() const;

    std::filesystem::path settings_path() const { return settings_path_; }
 
private:
    std::filesystem::path settings_path_;
    std::unordered_map<std::string, std::string> values_;
};
 
} // namespace pulp::view