// 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 IOS_CHROME_BROWSER_READER_MODE_MODEL_CONSTANTS_H_
#define IOS_CHROME_BROWSER_READER_MODE_MODEL_CONSTANTS_H_

#import <Foundation/Foundation.h>

#import <vector>

#import "base/time/time.h"

// Recorded for IOS.ReaderMode.State. Entries should not be renumbered and
// numeric values should never be reused.
// LINT.IfChange(ReaderModeState)
enum class ReaderModeState {
  kHeuristicCanceled = 0,
  kHeuristicStarted = 1,
  kHeuristicCompleted = 2,
  kDistillationStarted = 3,
  kDistillationCompleted = 4,
  kReaderShown = 5,
  kDistillationTimedOut = 6,
  kMaxValue = kDistillationTimedOut,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeState)

// Recorded for IOS.ReaderMode.Distiller.Result. Entries should not
// be renumbered and numeric values should never be reused.
// LINT.IfChange(ReaderModeDistillerResult)
enum class ReaderModeDistillerResult {
  kPageIsNotDistillable = 0,
  kPageIsDistillable = 1,
  kMaxValue = kPageIsDistillable,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeDistillerResult)

// Recorded for IOS.ReaderMode.Heuristic.Result. Entries should not
// be renumbered and numeric values should never be reused.
// LINT.IfChange(ReaderModeHeuristicResult)
enum class ReaderModeHeuristicResult {
  kMalformedResponse = 0,
  kReaderModeEligible = 1,
  kReaderModeNotEligibleContentOnly = 2,
  kReaderModeNotEligibleContentLength = 3,
  kReaderModeNotEligibleContentAndLength = 4,
  kReaderModeNotEligibleOptimizationGuideIneligible = 5,
  kReaderModeNotEligibleOptimizationGuideUnknown = 6,
  kMaxValue = kReaderModeNotEligibleOptimizationGuideUnknown,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeHeuristicResult)

// Recorded for IOS.ReaderMode.Heuristic.Classification.
// Compares the state between the Reader Mode heuristic classification
// and the result of the distiller. Entries should not
// be renumbered and numeric values should never be reused.
// LINT.IfChange(ReaderModeHeuristicClassification)
enum class ReaderModeHeuristicClassification {
  kPageNotEligibleWithEmptyDistill = 0,
  kPageNotEligibleWithPopulatedDistill = 1,
  kPageEligibleWithEmptyDistill = 2,
  kPageEligibleWithPopulatedDistill = 3,
  kMaxValue = kPageEligibleWithPopulatedDistill,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeHeuristicClassification)

// LINT.IfChange(ReaderModeCustomizationType)
enum class ReaderModeCustomizationType {
  kFontScale = 0,
  kFontFamily = 1,
  kTheme = 2,
  kLinksEnabled = 3,
  kMaxValue = kLinksEnabled,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeCustomizationType)

// Recorded for IOS.ReaderMode.Theme. Entries should not
// be renumbered and numeric values should never be reused.
// LINT.IfChange(ReaderModeTheme)
enum class ReaderModeTheme {
  kLight = 0,
  kDark = 1,
  kSepia = 2,
  kMaxValue = kSepia,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeTheme)

// Recorded for IOS.ReaderMode.FontFamily. Entries should not
// be renumbered and numeric values should never be reused.
// LINT.IfChange(ReaderModeFontFamily)
enum class ReaderModeFontFamily {
  kSansSerif = 0,
  kSerif = 1,
  kMonospace = 2,
  kLexend = 3,
  kMaxValue = kLexend,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeFontFamily)

// Recorded for IOS.ReaderMode.AccessPoint. Entries should not be renumbered and
// numeric values should never be reused.
// LINT.IfChange(ReaderModeAccessPoint)
enum class ReaderModeAccessPoint {
  kContextualChip = 0,
  kToolsMenu = 1,
  kAIHub = 2,
  kMaxValue = kAIHub,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeAccessPoint)

// Recorded for IOS.ReaderMode.AccessPointWithMode. Entries should not be
// renumbered and numeric values should never be reused.
// LINT.IfChange(ReaderModeAccessPointWithMode)
enum class ReaderModeAccessPointWithMode {
  kContextualChipInRegular = 0,
  kContextualChipInIncognito = 1,
  kToolsMenuInRegular = 2,
  kToolsMenuInIncognito = 3,
  kAIHubInRegular = 4,
  kAIHubInIncognito = 5,
  kMaxValue = kAIHubInIncognito,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeAccessPointWithMode)

// Recorded for IOS.ReaderMode.Distiller.Result. Entries should not be
// renumbered and numeric values should never be reused.
// LINT.IfChange(ReaderModeDistillerOutcome)
enum class ReaderModeDistillerOutcome {
  kContextualChipIsDistillable = 0,
  kContextualChipIsNotDistillable = 1,
  kToolsMenuIsDistillable = 2,
  kToolsMenuIsNotDistillable = 3,
  kAIHubIsDistillable = 4,
  kAIHubIsNotDistillable = 5,
  kMaxValue = kAIHubIsNotDistillable,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeDistillerOutcome)

// Reasons for which Reader mode can be deactivated.
// Recorded for IOS.ReaderMode.DeactivationReason. Entries should not be
// renumbered and numeric values should never be reused.
// LINT.IfChange(ReaderModeDeactivationReason)
enum class ReaderModeDeactivationReason {
  // User deactivated Reader mode using the UI.
  kUserDeactivated = 0,
  // Reader mode was deactivated because a navigation occurred.
  kNavigationDeactivated = 1,
  // Reader mode was deactivated because distillation failed.
  kDistillationFailureDeactivated = 2,
  // Reader mode was deactivated because the host tab was destroyed.
  kHostTabDestructionDeactivated = 3,
  kMaxValue = kHostTabDestructionDeactivated,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeDeactivationReason)

// Translation states recorded when Reading Mode is deactivated.
// Recorded for IOS.ReaderMode.TranslationState. Entries should not be
// renumbered and numeric values should never be reused.
// LINT.IfChange(ReaderModeTranslationPageEventState)
enum class ReaderModeTranslationPageEventState {
  // Original page was not translated and Reading Mode was not translated.
  kSourceUntranslatedReaderModeUntranslated = 0,
  // Original page was not translated and Reading Mode was translated.
  kSourceUntranslatedReaderModeTranslated = 1,
  // Original page was manually translated and Reading Mode was translated.
  kSourceManuallyTranslatedReaderModeTranslated = 2,
  // Original page was manually translated and Reading Mode was translated with
  // a different language than on the original page.
  kSourceManuallyTranslatedReaderModeTranslatedWithLanguageChange = 3,
  // Original page was manually translated and Reading Mode was not translated.
  kSourceManuallyTranslatedReaderModeUntranslated = 4,
  // Original page was auto-translated and Reading Mode was translated.
  kSourceAutoTranslatedReaderModeTranslated = 5,
  // Original page was auto-translated and Reading Mode was translated with a
  // different language than on the original page.
  kSourceAutoTranslatedReaderModeTranslatedWithLanguageChange = 6,
  // Original page was auto-translated and Reading Mode was not translated.
  kSourceAutoTranslatedReaderModeUntranslated = 7,
  kMaxValue = kSourceAutoTranslatedReaderModeUntranslated,
};
// LINT.ThenChange(/tools/metrics/histograms/metadata/ios/enums.xml:ReaderModeTranslationPageEventState)

// The state of translation for a specific IOSChromeTranslateClient and it's
// associated web state.
struct ReaderModeTranslationState {
  std::string source_code;
  std::string target_code;
  bool is_page_translated = false;
  bool is_automated_translation = false;
};

// Default delay in seconds for triggering Reader Mode distiller heuristic.
// This allows the page to react to the DOM loading and ensures minimal
// interference with the JavaScript execution.
inline constexpr base::TimeDelta kReaderModeHeuristicPageLoadDelay =
    base::Seconds(1);

// Default timeout for distilling a page with Reader Mode enabled.
inline constexpr base::TimeDelta kReaderModeDistillationTimeout =
    base::Seconds(2);

// Histogram name for Reader Mode state.
extern const char kReaderModeStateHistogram[];

// Histogram name for Reader Mode deactivation reason.
extern const char kReaderModeDeactivationReasonHistogram[];

// Histogram name for Reader Mode translation state on deactivation.
extern const char kReaderModeTranslationStateHistogram[];

// Histogram name for Reader Mode heuristic result.
extern const char kReaderModeHeuristicResultHistogram[];

// Histogram name for Reader Mode heuristic latency.
extern const char kReaderModeHeuristicLatencyHistogram[];

// Histogram name for Reader Mode distillation latency.
extern const char kReaderModeDistillerLatencyHistogram[];

// Histogram name for Reader Mode distillation result.
extern const char kReaderModeDistillerResultHistogram[];

// Histogram name for Reader Mode data load latency.
extern const char kReaderModeDataLoadLatencyHistogram[];

// Histogram name for Reader Mode theme customization.
extern const char kReaderModeThemeCustomizationHistogram[];

// Histogram name for Reader Mode font family customization.
extern const char kReaderModeFontFamilyCustomizationHistogram[];

// Histogram name for Reader Mode font scale customization.
extern const char kReaderModeFontScaleCustomizationHistogram[];

// Histogram name for Reader Mode enable/disable link customization.
extern const char kReaderModeLinksEnabledHistogram[];

// Histogram name for Reader Mode customization.
extern const char kReaderModeCustomizationHistogram[];

// Histogram name for time spent in Reader Mode.
extern const char kReaderModeTimeSpentHistogram[];

// Histogram name for Reader Mode access point for starting distillation.
extern const char kReaderModeAccessPointHistogram[];

// Histogram name for Reader Mode access point with application mode.
extern const char kReaderModeAccessPointWithModeHistogram[];

// Deprecated. Pref holding the latest timestamps of when the user has
// interacted with Reading Mode.
extern const char kReaderModeRecentlyUsedTimestampsPref[];

// Reader mode font scale multipliers. Must be sorted.
// These values should be in the range defined in distilled_page_prefs.cc.
std::vector<double> ReaderModeFontScaleMultipliers();

#endif  // IOS_CHROME_BROWSER_READER_MODE_MODEL_CONSTANTS_H_