File: DocumentMarker.h

package info (click to toggle)
webkit2gtk 2.48.5-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 429,764 kB
  • sloc: cpp: 3,697,587; javascript: 194,444; ansic: 169,997; python: 46,499; asm: 19,295; ruby: 18,528; perl: 16,602; xml: 4,650; yacc: 2,360; sh: 2,098; java: 1,993; lex: 1,327; pascal: 366; makefile: 298
file content (243 lines) | stat: -rw-r--r-- 8,361 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
/*
 * Copyright (C) 2006-2020 Apple Inc. All rights reserved.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public License
 * along with this library; see the file COPYING.LIB.  If not, write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA 02110-1301, USA.
 *
 */

#pragma once

#include "DictationContext.h"
#include "SimpleRange.h"
#include <variant>
#include <wtf/Forward.h>
#include <wtf/OptionSet.h>
#include <wtf/UUID.h>
#include <wtf/WeakPtr.h>
#include <wtf/text/MakeString.h>
#include <wtf/text/WTFString.h>

#if PLATFORM(IOS_FAMILY)
#import <wtf/RetainPtr.h>
#endif

namespace WebCore {
class DocumentMarker;

namespace WritingTools {
using TextSuggestionID = WTF::UUID;
using SessionID = WTF::UUID;
}

} // namespace WebCore

namespace WTF {
template<typename T> struct IsDeprecatedWeakRefSmartPointerException;
template<> struct IsDeprecatedWeakRefSmartPointerException<WebCore::DocumentMarker> : std::true_type { };
}

namespace WebCore {

enum class DocumentMarkerType : uint32_t {
    Spelling = 1 << 0,
    Grammar = 1 << 1,
    TextMatch = 1 << 2,
    // Text has been modified by spell correction, reversion of spell correction or other type of substitution.
    // On some platforms, this prevents the text from being autocorrected again. On post Snow Leopard Mac OS X,
    // if a Replacement marker contains non-empty description, a reversion UI will be shown.
    Replacement = 1 << 3,
    // Renderer needs to add underline indicating that the text has been modified by spell
    // correction. Text with Replacement marker doesn't necessarily has CorrectionIndicator
    // marker. For instance, after some text has been corrected, it will have both Replacement
    // and CorrectionIndicator. However, if user further modifies such text, we would remove
    // CorrectionIndicator marker, but retain Replacement marker.
    CorrectionIndicator = 1 << 4,
    // Correction suggestion has been offered, but got rejected by user.
    RejectedCorrection = 1 << 5,
    // Text has been modified by autocorrection. The description of this marker is the original text before autocorrection.
    Autocorrected = 1 << 6,
    // On some platforms, this prevents the text from being spellchecked again.
    SpellCheckingExemption = 1 << 7,
    // This marker indicates user has deleted an autocorrection starting at the end of the
    // range that bears this marker. In some platforms, if the user later inserts the same original
    // word again at this position, it will not be autocorrected again. The description of this
    // marker is the original word before autocorrection was applied.
    DeletedAutocorrection = 1 << 8,
    // This marker indicates that the range of text spanned by the marker is entered by voice dictation,
    // and it has alternative text.
    DictationAlternatives = 1 << 9,
#if ENABLE(TELEPHONE_NUMBER_DETECTION)
    TelephoneNumber = 1 << 10,
#endif
#if PLATFORM(IOS_FAMILY)
    // FIXME: iOS should share the same dictation mark system with the other platforms.
    DictationPhraseWithAlternatives = 1 << 11,
    DictationResult = 1 << 12,
#endif
    // This marker indicates that the user has selected a text candidate.
    AcceptedCandidate = 1 << 13,
    // This marker indicates that the user has initiated a drag with this content.
    DraggedContent = 1 << 14,
#if ENABLE(PLATFORM_DRIVEN_TEXT_CHECKING)
    // This marker maintains state for the platform text checker.
    PlatformTextChecking = 1 << 15,
#endif
#if ENABLE(WRITING_TOOLS)
    WritingToolsTextSuggestion = 1 << 16,
#endif
    TransparentContent = 1 << 17,
};

// A range of a node within a document that is "marked", such as the range of a misspelled word.
// It optionally includes a description that could be displayed in the user interface.
class DocumentMarker : public CanMakeWeakPtr<DocumentMarker> {
public:
    static constexpr OptionSet<DocumentMarkerType> allMarkers();

    struct DictationData {
        DictationContext context;
        String originalText;
    };
#if ENABLE(PLATFORM_DRIVEN_TEXT_CHECKING)
    struct PlatformTextCheckingData {
        String key;
        String value;
    };
#endif

#if ENABLE(WRITING_TOOLS)
    struct WritingToolsTextSuggestionData {
        enum class State: uint8_t {
            Accepted,
            Rejected
        };

        enum class Decoration: uint8_t {
            None,
            Underline,
        };

        String originalText;
        WritingTools::TextSuggestionID suggestionID;
        State state { State::Accepted };
        Decoration decoration { Decoration::None };
    };
#endif

    struct TransparentContentData {
        RefPtr<Node> node;
        WTF::UUID uuid;
    };

    using Data = std::variant<
        String
        , DictationData // DictationAlternatives
#if PLATFORM(IOS_FAMILY)
        , Vector<String> // DictationPhraseWithAlternatives
        , RetainPtr<id> // DictationResult
#endif
        , RefPtr<Node> // DraggedContent
#if ENABLE(PLATFORM_DRIVEN_TEXT_CHECKING)
        , PlatformTextCheckingData // PlatformTextChecking
#endif
#if ENABLE(WRITING_TOOLS)
        , WritingToolsTextSuggestionData // WritingToolsTextSuggestion
#endif
        , TransparentContentData // TransparentContent
    >;

    DocumentMarker(DocumentMarkerType, OffsetRange, Data&& = { });

    DocumentMarkerType type() const { return m_type; }
    unsigned startOffset() const { return m_range.start; }
    unsigned endOffset() const { return m_range.end; }

    String description() const;

    const Data& data() const { return m_data; }
    void clearData() { m_data = String { }; }

    // Offset modifications are done by DocumentMarkerController.
    // Other classes should not call following setters.
    void setStartOffset(unsigned offset) { m_range.start = offset; }
    void setEndOffset(unsigned offset) { m_range.end = offset; }
    void shiftOffsets(int delta);

private:
    DocumentMarkerType m_type;
    OffsetRange m_range;
    Data m_data;
};

constexpr auto DocumentMarker::allMarkers() -> OptionSet<DocumentMarkerType>
{
    return {
        DocumentMarkerType::AcceptedCandidate,
        DocumentMarkerType::Autocorrected,
        DocumentMarkerType::CorrectionIndicator,
        DocumentMarkerType::DeletedAutocorrection,
        DocumentMarkerType::DictationAlternatives,
        DocumentMarkerType::DraggedContent,
        DocumentMarkerType::Grammar,
        DocumentMarkerType::RejectedCorrection,
        DocumentMarkerType::Replacement,
        DocumentMarkerType::SpellCheckingExemption,
        DocumentMarkerType::Spelling,
        DocumentMarkerType::TextMatch,
#if ENABLE(TELEPHONE_NUMBER_DETECTION)
        DocumentMarkerType::TelephoneNumber,
#endif
#if PLATFORM(IOS_FAMILY)
        DocumentMarkerType::DictationPhraseWithAlternatives,
        DocumentMarkerType::DictationResult,
#endif
#if ENABLE(PLATFORM_DRIVEN_TEXT_CHECKING)
        DocumentMarkerType::PlatformTextChecking,
#endif
#if ENABLE(WRITING_TOOLS)
        DocumentMarkerType::WritingToolsTextSuggestion,
#endif
        DocumentMarkerType::TransparentContent,
    };
}

inline DocumentMarker::DocumentMarker(DocumentMarkerType type, OffsetRange range, Data&& data)
    : m_type(type)
    , m_range(range)
    , m_data(WTFMove(data))
{
}

inline void DocumentMarker::shiftOffsets(int delta)
{
    m_range.start += delta;
    m_range.end += delta;
}

inline String DocumentMarker::description() const
{
    if (auto* description = std::get_if<String>(&m_data))
        return *description;

#if ENABLE(WRITING_TOOLS)
    if (auto* data = std::get_if<DocumentMarker::WritingToolsTextSuggestionData>(&m_data))
        return makeString("('"_s, data->originalText, "', state: "_s, enumToUnderlyingType(data->state), ')');
#endif

    return emptyString();
}

} // namespace WebCore