cadran_kit.hpp

Go to the documentation of this file.

// cadran::kit — the small pieces every Cadran screen builds with: a label, an
// icon, a card, a pill, a chip, an empty state; a line's value without its
// "›", a dot for a value's colour, a date in words.
// Copyright (C) 2026 JigSawFr.  GPLv3-or-later (see LICENSE.GPL).
#pragma once
 
#include <string>
#include <aurore.hpp>
 
#include <aurore/cadran/view/cadran_icon.hpp>
 
namespace cadran::kit
{
constexpr float RADIUS_ROW   = 14;
constexpr float RADIUS_ICON  = 12;
constexpr float RADIUS_CARD  = 20;
constexpr float RADIUS_TOP   = 22;
constexpr float RADIUS_MODAL = 24;
 
constexpr float TEXT_META   = 15;
constexpr float TEXT_KICKER = 16;
constexpr float TEXT_NOTE   = 16.5f;
constexpr float TEXT_BODY   = 17;
constexpr float TEXT_LEAD   = 19;
constexpr float TEXT_TITLE  = 23;
 
NVGcolor color(const char* key);
 
aurore::Label* label(const std::string& text, float size, const char* color_key = "cadran/text");
 
aurore::Label* display(const std::string& text, float size, const char* color_key = "cadran/text");
 
CadranIcon* icon(const char* name, float size, const char* color_key = "cadran/text2");
 
aurore::Box* card(bool focusable, bool grow);
 
aurore::Box* top_card(bool grow);
void set_kicker(aurore::Label* label, const std::string& text = "");
aurore::Box* kicker(const char* icon_name, const std::string& title);
 
class Mark : public aurore::View
{
  public:
    explicit Mark(const char* color_key);
    void set(const char* color_key);
    void draw(NVGcontext* vg, float x, float y, float width, float height, aurore::Style style,
        aurore::FrameContext* ctx) override;
 
  private:
    enum class Shape
    {
        DOT,
        CHECK,
        WARN,
    } shape
        = Shape::DOT;
    std::string key; 
};
 
aurore::Box* pill(const std::string& text, const char* dot_key);
 
aurore::Box* key(const char* letter, float size = 24);
 
aurore::Box* qr(const std::string& payload, float side, const std::string& title, const std::string& caption,
    float width = 0);
 
class Bar : public aurore::View
{
  public:
    Bar();
    void set(float fraction); 
    void draw(NVGcontext* vg, float x, float y, float width, float height, aurore::Style style,
        aurore::FrameContext* ctx) override;
 
  private:
    float drawn() const; 
    float fraction     = 0;
    float from         = 0;
    aurore::Time since = 0;
};
 
class Chip : public aurore::Box
{
  public:
    Chip();
    void frame(aurore::FrameContext* ctx) override;
 
  protected:
    aurore::AccessibilityRole getDefaultAccessibilityRole() override { return aurore::AccessibilityRole::BUTTON; }
};
aurore::Box* chip(const std::string& text, float height = 48);
 
struct Empty
{
    aurore::Box* box     = nullptr;
    aurore::Label* title = nullptr;
    aurore::Label* text  = nullptr;
};
Empty empty(const char* icon_name);
aurore::Box* empty_around(aurore::Label* label, const char* icon_name);
 
void wrap(aurore::View* row);
 
void fit_button(aurore::Button* button);
 
void fit_head(aurore::Box* row);
 
void draw_more_below(NVGcontext* vg, aurore::ScrollingFrame* frame, float x, float y, float width, float height,
    const char* color_key, float corner = 0.0f);
 
std::string without_chevron(const std::string& value);
 
const char* dot_of(NVGcolor value_color);
 
std::string long_date();
std::string long_date(const std::string& ymd);
} // namespace cadran::kit