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);
 
        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;
        float       _rowItemWidth;
        float       _rowSpacing;
        bool        _visible;
        bool        _hovered;
    };
 
}
 
#endif // AVARA3D_UI_PANEL_H