SaneCaret.h

// This is convoluted, but....does the job.
class SaneCaret : public juce::CaretComponent
{
    // this only exists because our CaretComponent can't inherit from timer...
    class Timer : public juce::Timer
    {
    public:
        explicit Timer (SaneCaret& caret) : saneCaret (caret) {}

        void timerCallback() override
        {
            saneCaret.toggle();
        }

    private:
        SaneCaret& saneCaret;
    };

public:
    explicit SaneCaret (Component* keyFocusOwner) : CaretComponent (keyFocusOwner), textField (keyFocusOwner)
    {
        setPaintingIsUnclipped (true);
        setInterceptsMouseClicks (false, false);
    }

    void paint (juce::Graphics& g) override
    {
        g.setColour (Colors::cursor);
        g.fillRect (getLocalBounds());
    }

    void toggle()
    {
        setVisible (shouldShow() && !isVisible());
    }

    [[nodiscard]] bool shouldShow() const
    {
        return textField == nullptr || (textField->hasKeyboardFocus (false) && !textField->isCurrentlyBlockedByAnotherModalComponent());
    }

    void setCaretPosition (const juce::Rectangle<int>& characterArea) override
    {
        timer.startTimer (550);
        setVisible (shouldShow());
        setBounds (characterArea.withWidth (1));
    }

private:
    Component* textField;
    Timer timer { *this };
};