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

#ifndef CHROME_BROWSER_UI_AUTOFILL_AUTOFILL_SUGGESTION_CONTROLLER_UTILS_H_
#define CHROME_BROWSER_UI_AUTOFILL_AUTOFILL_SUGGESTION_CONTROLLER_UTILS_H_

#include <vector>

#include "base/containers/span.h"
#include "components/autofill/core/browser/suggestions/suggestion_type.h"
#include "components/autofill/core/common/aliases.h"

namespace content {
class RenderFrameHost;
class WebContents;
}  // namespace content

namespace autofill {

class AutofillSuggestionDelegate;
struct SelectOption;
struct Suggestion;

enum class SuggestionSection {
  kBody,
  kFooter,
  kStructure,
};

// Returns the target section (body, footer, or structure) of this `type`.
SuggestionSection GetSuggestionSection(SuggestionType type);

// Returns whether the suggestion with this `type` belongs into
// the footer section of the popup. Returns `false` for separators, which may
// belong either to the main or the footer section.
bool IsFooterSuggestionType(SuggestionType type);

// Returns `true` if the item at `line_number` belongs into the footer section
// of the popup. For separators, the result is that of the next item.
bool IsFooterItem(const std::vector<Suggestion>& suggestions,
                  size_t line_number);

// Returns `true` if the popup should remain open with a suggestion of `type`
// as the first suggestion (e.g. after deleting a suggestion). This is true for
// all non-footer suggestions and false for most footer suggestions.
bool IsStandaloneSuggestionType(SuggestionType type);

// Returns whether `suggestion` should be displayed with deactivated visual
// styling (e.g. disabled text style and grayed-out icons).
bool ShouldApplyDeactivatedStyle(const Suggestion& suggestion);

// When suggestions update in an open popup, a 500ms lockout against accidental
// clicks is normally restarted. Returns whether `trigger_source` restarts this
// lockout.
bool ShouldResetIdleBarrier(AutofillSuggestionTriggerSource trigger_source);

// Will be removed together with kAutofillSimplifyFocusCheck.
// Returns the `RenderFrameHost` corresponding to an
// `AutofillSuggestionDelegate`.
content::RenderFrameHost* GetRenderFrameHost_DoNotUse(
    AutofillSuggestionDelegate& delegate);

// Returns true if `ancestor` is an `ancestor` of `descendant`.
bool IsAncestorOf(content::RenderFrameHost* ancestor,
                  content::RenderFrameHost* descendant);

// Returns whether the pointer is locked in `web_contents`.
bool IsPointerLocked(content::WebContents* web_contents);

// Informs the user education trackers about an accepted suggestion if the
// suggestion had relevance for in-product-help or for "new" badges.
void NotifyUserEducationAboutAcceptedSuggestion(content::WebContents* contents,
                                                const Suggestion& suggestion);

std::vector<Suggestion> UpdateSuggestionsFromDataList(
    base::span<const SelectOption> options,
    std::vector<Suggestion> suggestions);

}  // namespace autofill

#endif  // CHROME_BROWSER_UI_AUTOFILL_AUTOFILL_SUGGESTION_CONTROLLER_UTILS_H_