// Copyright 2025 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_PRELOADING_SEARCH_PRELOAD_SEARCH_PRELOAD_FEATURES_H_
#define CHROME_BROWSER_PRELOADING_SEARCH_PRELOAD_SEARCH_PRELOAD_FEATURES_H_

#include "base/feature_list.h"
#include "base/metrics/field_trial_params.h"

struct AutocompleteMatch;

namespace omnibox::mojom {
enum class NavigationPredictor;
}

namespace features {

// DefaultSearchEngine Preload v2
//
// - Base feature flag for DSE preload 2.
// - Disables `SearchPrefetch` (DSE v1).
// - Enables on-suggest preloads.
//
// https://crbug.com/394988793
BASE_DECLARE_FEATURE(kDsePreload2);

// The feature is disabled if device memory is smaller than the threshold.
extern const base::FeatureParam<size_t> kDsePreload2DeviceMemoryThresholdMiB;
// Pause triggering preloads when on-suggest prefetch failed.
extern const base::FeatureParam<base::TimeDelta>
    kDsePreload2ErrorBackoffDuration;
extern const base::FeatureParam<size_t> kDsePreload2MaxPrefetch;
// Time to live (TTL) of prefetch.
extern const base::FeatureParam<base::TimeDelta> kDsePreload2PrefetchTtl;
// Initial No-Vary-Search hint if there is no No-Vary-Search hint from Prefs.
//
// This feature flag is for debug purpose and we'll remove it finally.
extern const base::FeatureParam<std::string>
    kDsePreload2InitialNoVarySearchHint;

enum class DsePreload2PrefetchPriorityPolicy {
  // SearchPrefetch compatible. Use medium/highest if on-suggest/on-press.
  kSearchPrefetchCompat,
  // Use highest always.
  kAlwaysHighest,
  // Let `PrefetchService` fill the default priority.
  kNull,
};
// Priority policy for DSE preload 2 prefetch.
extern const base::FeatureParam<DsePreload2PrefetchPriorityPolicy>
    kDsePreload2PrefetchPriorityPolicy;

// Enables on-press prefetch.
BASE_DECLARE_FEATURE(kDsePreload2OnPress);

extern const base::FeatureParam<bool> kDsePreload2OnPressMouseDown;
extern const base::FeatureParam<bool> kDsePreload2OnPressUpOrDownArrowButton;
extern const base::FeatureParam<bool> kDsePreload2OnPressTouchDown;
extern const base::FeatureParam<bool> kDsePreload2OnPressIgnoreSaverModes;

// Enables on-press trigger in incognito mode.
//
// Corresponds to `SearchNavigationPrefetch.allow_incognito`.
//
// For more details, see
// https://docs.google.com/document/d/1f4dcNYP3O_Ft4yMmC42ETxGC5lM7YF5FDbEgnxUua7M/edit?tab=t.38v8gca76tmi
BASE_DECLARE_FEATURE(kDsePreload2OnPressIncognito);

// Enables on-suggest prefetch for non default match.
//
// For more details, see
// https://docs.google.com/document/d/1f4dcNYP3O_Ft4yMmC42ETxGC5lM7YF5FDbEgnxUua7M/edit?tab=t.38v8gca76tmi
BASE_DECLARE_FEATURE(kDsePreload2OnSuggestNonDefaultMatch);

// Returns true iff we should enter DsePreload2 code path.
bool IsDsePreload2Enabled();

// Returns true iff on-press triggers are enabled.
bool IsDsePreload2OnPressEnabled();
// Returns true iff we should start prefetch on
// `SearchPreloadService::OnNavigationLikely()` with a predictor.
bool DsePreload2OnPressIsPredictorEnabled(
    omnibox::mojom::NavigationPredictor navigation_predictor);

// Returns true iff on-press in incognito is enabled.
bool IsDsePreload2OnPressIncognitoEnabled();

// Returns true iff search preload can ignore battery and data saver modes for
// on-press navigation preloads.
bool IsDsePreload2IgnoreSaverModesOnPressEnabled();

// Enables suppressing preloads for unsupported search modes (e.g. udm=50, AIM).
BASE_DECLARE_FEATURE(kDsePreload2SuppressForUnsupportedSearchMode);
extern const base::FeatureParam<std::string> kDsePreload2UnsupportedSearchModes;

// Returns true iff preloads should be suppressed for unsupported search modes.
bool ShouldDsePreload2SuppressForUnsupportedMode(
    const AutocompleteMatch& match);

}  // namespace features

#endif  // CHROME_BROWSER_PRELOADING_SEARCH_PRELOAD_SEARCH_PRELOAD_FEATURES_H_