// Copyright 2023 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef IOS_WEB_COMMON_ANNOTATIONS_UTILS_H_
#define IOS_WEB_COMMON_ANNOTATIONS_UTILS_H_

#import <UIKit/UIKit.h>

#import "base/values.h"

@protocol CRWWebViewHandlerDelegate;

namespace web {

// Encodes the given `match` into a base64 string that can be parsed back.
// Note that `match.range` isn't encoded because it is not needed on the
// 'way back'.
NSString* EncodeNSTextCheckingResultData(NSTextCheckingResult* match);

// Decodes a string generated by `EncodeNSTextCheckingResultData` into a
// `NSTextCheckingResult` (without range).
NSTextCheckingResult* DecodeNSTextCheckingResultData(NSString* base64_data);

// Checks if the detected entity is an URL and more specifically an email.
bool IsNSTextCheckingResultEmail(NSTextCheckingResult* result);

// Returns a NSTextCheckingTypeLink result from an email string.
NSTextCheckingResult* MakeNSTextCheckingResultEmail(NSString* email,
                                                    NSRange range);

// Encapsulates data into a `base::Value::Type::DICT` that can be
// passed to JS. `data` must come from `EncodeNSTextCheckingResultData`.
base::Value::Dict ConvertMatchToAnnotation(NSString* source,
                                           NSRange range,
                                           NSString* data,
                                           NSString* type);

// Checks whether to activate the web page annotations or not, depending on the
// experiences enabled (emails, phone numbers or maps).
bool WebPageAnnotationsEnabled();

}  // namespace web

#endif  // IOS_WEB_COMMON_ANNOTATIONS_UTILS_H_