GuiPopover.h

/****************************************************************************
 * libgui
 * Daryl Borth 2026
 * GuiPopover.h
 *
 * A question asked in place: a panel that opens beside the control that asked
 * it, over the screen it came from.
 ***************************************************************************/
#pragma once

class GuiPopover : public GuiOverlay
{
    public:
        struct Anchor
        {
            enum Edge { AUTO, LEFT_MARGIN, RIGHT_MARGIN, BESIDE };
            int x, y, w, h;
            bool valid;        
            Edge edge;
            Anchor() : x(0), y(0), w(0), h(0), valid(false), edge(AUTO) {}
            Anchor(int ax, int ay, int aw, int ah, Edge e = AUTO) : x(ax), y(ay), w(aw), h(ah), valid(true), edge(e) {}
            explicit Anchor(GuiElement& control, Edge e = AUTO) : x(control.getLeft()), y(control.getTop()), w(control.getWidth()), h(control.getHeight()), valid(true), edge(e) {}
        };

        struct Insets
        {
            int top, bottom, side;
            Insets(int t = 0, int b = 0, int s = 0) : top(t), bottom(b), side(s) {}
        };

        struct Position { int x, y; };

        enum class TAIL { UP, DOWN, LEFT, RIGHT };

        struct Tail { bool shown; TAIL direction; int x, y, w, h; };

        explicit GuiPopover(const Anchor& anchor = Anchor(), const Insets& insets = Insets());
        GuiPopover(const Anchor& anchor, const Insets& insets, int screenWidth, int screenHeight);

        void setPanel(GuiCard& panel, PixelColor tailColor);
        void setPanel(GuiCard& panel);

        int maxPanelHeight() const { return maxHeight(screenH, insets); }
        const Position& position() const { return placed; }
        const Tail& tail() const { return placedTail; }

        void dismiss();
        bool isDismissed() const { return dismissed; }
        int dismissedBy() const { return by; }
        void reopen() { dismissed = false; by = -1; }
        void update(InputController * c) override;

        static int maxHeight(int screenHeight, const Insets& insets);
        static Position place(const Anchor& anchor, int w, int h, int screenWidth, int screenHeight, const Insets& insets);
        static Tail tailAt(const Anchor& anchor, const Position& at, int panelW, int panelH);
 
    protected:
        UiScope ui;   
    private:
        Anchor anchor;
        Insets insets;
        int screenW, screenH;
        GuiTrigger * cancel;  // B
        GuiTrigger * click;       // the primary press, for a click outside the panel
        GuiElement * panel;
        Position placed;
        Tail placedTail;
        bool dismissed;
        int by;
};