Panel.h

//
//  Panel.h
//  avara3d
//
//  Created by Morgan Davis on 8/10/26.
//  Copyright © 2026 Morgan K Davis. All rights reserved.
//
 
#ifndef AVARA3D_UI_PANEL_H
#define AVARA3D_UI_PANEL_H
 
#include <optional>
#include <string>
#include <string_view>
 
namespace a3d::ui {
 
class Panel {
 
public:
    // [Public Types]
 
    struct Options {
        float          width {260.0f}; 
        float          margin {12.0f}; 
 
        static Options Default() {
            return {0.0f, 0.0f};
        }
    };
 
    struct Padding {
        float          top {0.0f}; 
        float          bottom {0.0f}; 
        float          left {0.0f}; 
        float          right {0.0f}; 
 
        static Padding Default() {
            return {0.0f, 0.0f, 0.0f, 0.0f};
        }
    };
 
    struct SectionConfig {
        bool                 line {true}; 
        bool                 uppercase {false}; 
 
        static SectionConfig Default() {
            return {true, false};
        }
    };
 
    // [Public Lifecycle Functions]
 
    explicit Panel(std::string_view id, const Options& options = Options::Default());
 
    Panel(const Panel&)            = delete;
    Panel& operator=(const Panel&) = delete;
 
    Panel(Panel&&)            = delete;
    Panel& operator=(Panel&&) = delete;
 
    ~Panel();
 
    // [Public Member Functions]
 
    void section(std::string_view text,
                 SectionConfig    config  = SectionConfig::Default(),
                 Padding          padding = {12.0f, 4.0f, 0.0f, 0.0f});
 
    void text(std::string_view text, Padding padding = Padding::Default());
 
    void value(std::string_view label, std::string_view value, Padding padding = Padding::Default());
 
    void spacer(float height);
 
    void row(unsigned itemCount);
 
    void segmentedRow(unsigned itemCount);
 
    bool button(std::string_view label, Padding padding = {2.0f, 0.0f, 0.0f, 0.0f});
 
    bool option(std::string_view label, bool selected, Padding padding = {2.0f, 0.0f, 0.0f, 0.0f});
 
    bool subOption(std::string_view label, bool selected, Padding padding = {2.0f, 0.0f, 0.0f, 0.0f});
 
    bool slider(std::string_view label,
                float&           value,
                float            minimum,
                float            maximum,
                std::string_view format  = "%.2f",
                Padding          padding = {2.0f, 0.0f, 0.0f, 0.0f});
 
    bool slider(std::string_view label,
                int&             value,
                int              minimum,
                int              maximum,
                std::string_view format  = "%d",
                Padding          padding = {2.0f, 0.0f, 0.0f, 0.0f});
 
    bool toggle(std::string_view label, bool& value, Padding padding = Padding::Default());
 
    bool hovered() const;
 
private:
    // [Private Member Functions]
 
    float       beginItem() const;
    void        endItem();
    bool        drawButton(std::string_view label, bool selected, Padding padding);
 
    // [Private Member Variables]
 
    std::string _windowName;
    unsigned    _rowItemsRemaining;
    unsigned    _rowItemCount;
    float       _rowItemWidth;
    float       _rowSpacing;
    bool        _segmentedRow;
    bool        _visible;
    bool        _hovered;
};
 
} // namespace a3d::ui
 
#endif // AVARA3D_UI_PANEL_H