/* * Copyright (c) 2018-2021, Andreas Kling * Copyright (c) 2022, the SerenityOS developers. * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace GUI { struct TextDocumentSpan { TextRange range; Gfx::TextAttributes attributes; u64 data { 0 }; bool is_skippable { false }; }; class TextDocument : public RefCounted { public: enum class SearchShouldWrap { No = 0, Yes }; class Client { public: virtual ~Client() = default; virtual void document_did_append_line() = 0; virtual void document_did_insert_line(size_t) = 0; virtual void document_did_remove_line(size_t) = 0; virtual void document_did_remove_all_lines() = 0; virtual void document_did_change(AllowCallback = AllowCallback::Yes) = 0; virtual void document_did_set_text(AllowCallback = AllowCallback::Yes) = 0; virtual void document_did_set_cursor(const TextPosition&) = 0; virtual void document_did_update_undo_stack() = 0; virtual bool is_automatic_indentation_enabled() const = 0; virtual int soft_tab_width() const = 0; }; static NonnullRefPtr create(Client* client = nullptr); virtual ~TextDocument() = default; size_t line_count() const { return m_lines.size(); } const TextDocumentLine& line(size_t line_index) const { return m_lines[line_index]; } TextDocumentLine& line(size_t line_index) { return m_lines[line_index]; } void set_spans(Vector spans) { m_spans = move(spans); } bool set_text(StringView, AllowCallback = AllowCallback::Yes); const NonnullOwnPtrVector& lines() const { return m_lines; } NonnullOwnPtrVector& lines() { return m_lines; } bool has_spans() const { return !m_spans.is_empty(); } Vector& spans() { return m_spans; } const Vector& spans() const { return m_spans; } void set_span_at_index(size_t index, TextDocumentSpan span) { m_spans[index] = move(span); } const TextDocumentSpan* span_at(const TextPosition&) const; void append_line(NonnullOwnPtr); void remove_line(size_t line_index); void remove_all_lines(); void insert_line(size_t line_index, NonnullOwnPtr); void register_client(Client&); void unregister_client(Client&); void update_views(Badge); String text() const; String text_in_range(const TextRange&) const; Vector find_all(StringView needle, bool regmatch = false); void update_regex_matches(StringView); TextRange find_next(StringView, const TextPosition& start = {}, SearchShouldWrap = SearchShouldWrap::Yes, bool regmatch = false, bool match_case = true); TextRange find_previous(StringView, const TextPosition& start = {}, SearchShouldWrap = SearchShouldWrap::Yes, bool regmatch = false, bool match_case = true); TextPosition next_position_after(const TextPosition&, SearchShouldWrap = SearchShouldWrap::Yes) const; TextPosition previous_position_before(const TextPosition&, SearchShouldWrap = SearchShouldWrap::Yes) const; u32 code_point_at(const TextPosition&) const; TextRange range_for_entire_line(size_t line_index) const; Optional first_non_skippable_span_before(const TextPosition&) const; Optional first_non_skippable_span_after(const TextPosition&) const; TextPosition first_word_break_before(const TextPosition&, bool start_at_column_before) const; TextPosition first_word_break_after(const TextPosition&) const; TextPosition first_word_before(const TextPosition&, bool start_at_column_before) const; void add_to_undo_stack(NonnullOwnPtr); bool can_undo() const { return m_undo_stack.can_undo(); } bool can_redo() const { return m_undo_stack.can_redo(); } void undo(); void redo(); UndoStack const& undo_stack() const { return m_undo_stack; } void notify_did_change(); void set_all_cursors(const TextPosition&); TextPosition insert_at(const TextPosition&, u32, const Client* = nullptr); TextPosition insert_at(const TextPosition&, StringView, const Client* = nullptr); void remove(const TextRange&); virtual bool is_code_document() const { return false; } bool is_empty() const; bool is_modified() const { return m_undo_stack.is_current_modified(); } void set_unmodified(); protected: explicit TextDocument(Client* client); private: NonnullOwnPtrVector m_lines; Vector m_spans; HashTable m_clients; bool m_client_notifications_enabled { true }; UndoStack m_undo_stack; RegexResult m_regex_result; size_t m_regex_result_match_index { 0 }; size_t m_regex_result_match_capture_group_index { 0 }; bool m_regex_needs_update { true }; String m_regex_needle; }; class TextDocumentLine { public: explicit TextDocumentLine(TextDocument&); explicit TextDocumentLine(TextDocument&, StringView); String to_utf8() const; Utf32View view() const { return { code_points(), length() }; } const u32* code_points() const { return m_text.data(); } size_t length() const { return m_text.size(); } bool set_text(TextDocument&, StringView); void set_text(TextDocument&, Vector); void append(TextDocument&, u32); void prepend(TextDocument&, u32); void insert(TextDocument&, size_t index, u32); void remove(TextDocument&, size_t index); void append(TextDocument&, const u32*, size_t); void truncate(TextDocument&, size_t length); void clear(TextDocument&); void remove_range(TextDocument&, size_t start, size_t length); size_t first_non_whitespace_column() const; Optional last_non_whitespace_column() const; bool ends_in_whitespace() const; bool can_select() const; bool is_empty() const { return length() == 0; } size_t leading_spaces() const; private: // NOTE: This vector is null terminated. Vector m_text; }; class TextDocumentUndoCommand : public Command { public: TextDocumentUndoCommand(TextDocument&); virtual ~TextDocumentUndoCommand() = default; virtual void perform_formatting(const TextDocument::Client&) { } void execute_from(const TextDocument::Client& client) { m_client = &client; redo(); m_client = nullptr; } protected: TextDocument& m_document; const TextDocument::Client* m_client { nullptr }; }; class InsertTextCommand : public TextDocumentUndoCommand { public: InsertTextCommand(TextDocument&, const String&, const TextPosition&); virtual void perform_formatting(const TextDocument::Client&) override; virtual void undo() override; virtual void redo() override; virtual bool merge_with(GUI::Command const&) override; virtual String action_text() const override; const String& text() const { return m_text; } const TextRange& range() const { return m_range; } private: String m_text; TextRange m_range; }; class RemoveTextCommand : public TextDocumentUndoCommand { public: RemoveTextCommand(TextDocument&, const String&, const TextRange&); virtual void undo() override; virtual void redo() override; const TextRange& range() const { return m_range; } virtual bool merge_with(GUI::Command const&) override; virtual String action_text() const override; private: String m_text; TextRange m_range; }; }