RichTextBuffer.h

Go to the documentation of this file.

//
// RichTextBuffer.h
//
 
#ifndef MALENA_RICHTEXTBUFFER_H
#define MALENA_RICHTEXTBUFFER_H
 
#pragma once
 
#include <Malena/Core/malena_export.h>
#include <SFML/Graphics/Font.hpp>
#include <SFML/Graphics/Color.hpp>
#include <SFML/Graphics/Text.hpp>
#include <optional>
#include <string>
#include <vector>
 
namespace ml
{
    // ── TextAttribute ─────────────────────────────────────────────────────────

    struct TextAttribute
    {
        std::size_t start = 0;   
        std::size_t end   = 0;   
 
        const sf::Font*               font;      
        std::optional<unsigned int>   charSize;  
        std::optional<sf::Color>      color;     
        std::optional<bool>           bold;      
        std::optional<bool>           italic;    
        std::optional<bool>           underline; 
 
        // Paragraph-level (uniform across a line): horizontal alignment.
        // 0 = left, 1 = center, 2 = right. nullopt = inherit (left).
        std::optional<int>            align;
 
        // Paragraph-level list style. 0 = none, 1 = bullet, 2 = numbered.
        std::optional<int>            listType;
 
        // Paragraph-level indent depth (Tab/Shift+Tab). 0 = flush left.
        std::optional<int>            indentLevel;
 
        TextAttribute() : font(nullptr) {}
    };
 
    // ── RichTextBuffer ────────────────────────────────────────────────────────

    class MALENA_API RichTextBuffer
    {
    public:
        // ── Construction ──────────────────────────────────────────────────────
 
        RichTextBuffer() = default;
 
        // ── Buffer access ─────────────────────────────────────────────────────

        [[nodiscard]] const std::string& getText() const;

        [[nodiscard]] std::size_t size() const;

        [[nodiscard]] bool empty() const;

        [[nodiscard]] const std::vector<TextAttribute>& getAttributes() const;
 
        // ── Cursor ────────────────────────────────────────────────────────────

        [[nodiscard]] std::size_t getCursor() const;

        void setCursor(std::size_t pos);

        void moveCursor(int delta, bool extendSelection = false);

        void moveCursorByWord(int direction, bool extendSelection = false);

        void moveCursorToLineStart(bool extendSelection = false);

        void moveCursorToLineEnd(bool extendSelection = false);
 
        // ── Selection ─────────────────────────────────────────────────────────

        [[nodiscard]] bool hasSelection() const;

        [[nodiscard]] std::size_t getSelectionStart() const;

        [[nodiscard]] std::size_t getSelectionEnd() const;

        void setSelection(std::size_t start, std::size_t end);

        void selectAll();

        void clearSelection();

        [[nodiscard]] std::string getSelectedText() const;
 
        // ── Editing ───────────────────────────────────────────────────────────

        void insert(const std::string& text);

        void insertChar(char32_t unicode);

        void backspace();

        void deleteForward();

        void clear();

        void setText(const std::string& text);
 
        // ── Attributes ────────────────────────────────────────────────────────

        void applyAttribute(TextAttribute attr);

        void applyAttributeRange(std::size_t start, std::size_t end, TextAttribute attr);

        void clearAttributes();

        [[nodiscard]] TextAttribute getAttributeAt(
            std::size_t     index,
            const sf::Font* defaultFont,
            unsigned int    defaultSize,
            sf::Color       defaultColor) const;

        [[nodiscard]] bool hasPendingAttribute() const { return _hasPending; }

        [[nodiscard]] const TextAttribute& getPendingAttribute() const { return _pendingAttr; }
 
        // ── Clipboard helpers ─────────────────────────────────────────────────

        void copyToClipboard() const;

        void cutToClipboard();

        void pasteFromClipboard();
 
    private:
        std::string              _text;
        std::vector<TextAttribute> _attributes;
 
        std::size_t _cursor   = 0;
        std::size_t _selStart = 0;
        std::size_t _selEnd   = 0;
        bool        _hasSelection = false;
 
        // Pending attribute for next insert (applied when no selection active)
        TextAttribute _pendingAttr;
        bool          _hasPending = false;
 
        void deleteRange(std::size_t start, std::size_t end);
        void shiftAttributesAfterInsert(std::size_t pos, std::size_t count);
        void shiftAttributesAfterDelete(std::size_t start, std::size_t count);
        void splitAttributeAt(std::size_t pos);
        void mergeAdjacentAttributes();
        void normalizeAttributes();
 
        std::size_t findWordBoundary(std::size_t pos, int direction) const;
        std::size_t findLineStart(std::size_t pos) const;
        std::size_t findLineEnd(std::size_t pos) const;
    };
 
} // namespace ml
 
#endif // MALENA_RICHTEXTBUFFER_H