// Copyright 2018 The Chromium Authors // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #ifndef COMPONENTS_SEARCH_NTP_FEATURES_H_ #define COMPONENTS_SEARCH_NTP_FEATURES_H_ #include #include #include "base/feature_list.h" #include "base/metrics/field_trial_params.h" namespace base { class TimeDelta; } // namespace base namespace ntp_features { // The features should be documented alongside the definition of their values in // the .cc file. BASE_DECLARE_FEATURE(kConfirmSuggestionRemovals); BASE_DECLARE_FEATURE(kCustomizeChromeSidePanelExtensionsCard); BASE_DECLARE_FEATURE(kCustomizeChromeWallpaperSearch); BASE_DECLARE_FEATURE(kCustomizeChromeWallpaperSearchButton); BASE_DECLARE_FEATURE(kCustomizeChromeWallpaperSearchInspirationCard); enum class EnergyEffectVariant { // Default (M149 / 12% shadow) kEnergyEffectOriginal = 0, // Variant 1 (20% shadow) kEnergyEffectDarkerShadow = 1, // Variant 2 (reduced original shadow + darker border) kPreEnergyEffectWithBorder = 2, // Variant 4 (Fusebox shadow @ 16%) kEnergyEffectFusebox = 3, }; BASE_DECLARE_FEATURE(kEnergyEffect); BASE_DECLARE_FEATURE(kEnergyEffectAnimation); BASE_DECLARE_FEATURE(kRealboxCr23Theming); BASE_DECLARE_FEATURE(kRealboxMatchOmniboxTheme); BASE_DECLARE_FEATURE(kNtpAlphaBackgroundCollections); BASE_DECLARE_FEATURE(kNtpAnimatedCaret); BASE_DECLARE_FEATURE(kNtpBackgroundImageErrorDetection); BASE_DECLARE_FEATURE(kNtpCalendarModule); BASE_DECLARE_FEATURE(kNtpChromeCartModule); BASE_DECLARE_FEATURE(kNtpCustomizeChromeAutoOpen); BASE_DECLARE_FEATURE(kNtpCustomizeWebUiAndroid); BASE_DECLARE_FEATURE(kNtpDisableBrowserInitiatedLinks); BASE_DECLARE_FEATURE(kNtpDriveModule); BASE_DECLARE_FEATURE(kNtpDriveModuleHistorySyncRequirement); BASE_DECLARE_FEATURE(kNtpDriveModuleLink); BASE_DECLARE_FEATURE(kNtpDriveModuleSegmentation); #if !defined(OFFICIAL_BUILD) BASE_DECLARE_FEATURE(kNtpDummyModules); #endif BASE_DECLARE_FEATURE(kNtpComprehensiveTheming); BASE_DECLARE_FEATURE(kNtpGoogleLogo26); BASE_DECLARE_FEATURE(kNtpLogo); BASE_DECLARE_FEATURE(kNtpMiddleSlotPromo); BASE_DECLARE_FEATURE(kNtpMiddleSlotPromoDismissal); BASE_DECLARE_FEATURE(kNtpModulesLoadTimeoutMilliseconds); BASE_DECLARE_FEATURE(kNtpModulesOrder); BASE_DECLARE_FEATURE(kNtpModulesLoad); BASE_DECLARE_FEATURE(kNtpModuleSignInRequirement); BASE_DECLARE_FEATURE(kNtpOutlookCalendarModule); BASE_DECLARE_FEATURE(kNtpOneGoogleBar); BASE_DECLARE_FEATURE(kNtpRichImageSuggestions); BASE_DECLARE_FEATURE(kNtpScaledActionChips); BASE_DECLARE_FEATURE(kNtpScaledActionChipsSmall); BASE_DECLARE_FEATURE(kNtpSharepointModule); enum class NtpSharepointModuleDataType { kTrendingInsights, kNonInsights, kTrendingInsightsFakeData, kNonInsightsFakeData, kCombinedSuggestions, }; BASE_DECLARE_FEATURE(kNtpShortcuts); BASE_DECLARE_FEATURE(kNtpMostVisitedHighDpiFavicons); BASE_DECLARE_FEATURE(kNtpHandleMostVisitedNavigationExplicitly); BASE_DECLARE_FEATURE(kNtpMostRelevantTabResumptionModule); BASE_DECLARE_FEATURE(kNtpMostRelevantTabResumptionAllowFaviconServerFallback); BASE_DECLARE_FEATURE(kNtpMostRelevantTabResumptionModuleFallbackToHost); BASE_DECLARE_FEATURE(kNtpTabResumptionModuleCategories); BASE_DECLARE_FEATURE(kNtpTabResumptionModuleTimeLimit); BASE_DECLARE_FEATURE(kNtpWallpaperSearchButton); BASE_DECLARE_FEATURE(kNtpWallpaperSearchButtonAnimation); BASE_DECLARE_FEATURE(kNtpWallpaperSearchButtonAnimationShownThreshold); BASE_DECLARE_FEATURE(kNtpMicrosoftAuthenticationModule); BASE_DECLARE_FEATURE(kNtpNextFeatures); BASE_DECLARE_FEATURE(kNtpNextCanvasChip); BASE_DECLARE_FEATURE(kNtpStarterChip); BASE_DECLARE_FEATURE(kNtpOneGoogleBarAsyncBarParts); BASE_DECLARE_FEATURE(kNtpFooter); BASE_DECLARE_FEATURE(kNtpTabGroupsModule); BASE_DECLARE_FEATURE(kNtpTabGroupsModuleZeroState); BASE_DECLARE_FEATURE(kNtpFeatureOptimizationModuleRemoval); BASE_DECLARE_FEATURE(kNtpFeatureOptimizationShortcutsRemoval); BASE_DECLARE_FEATURE(kNtpFeatureOptimizationDismissModulesRemoval); BASE_DECLARE_FEATURE(kNtpAnimatedDoodles); BASE_DECLARE_FEATURE(kNtpDoodleMurals); BASE_DECLARE_FEATURE(kLightningTakeoverEdition); BASE_DECLARE_FEATURE(kNtpShortcutsRedesign); BASE_DECLARE_FEATURE(kNtpSimplificationBookmarkBar); BASE_DECLARE_FEATURE(kBookmarkBarUpdatesForTesting); BASE_DECLARE_FEATURE(kNtpThreadsRail); // Parameter for controlling the luminosity difference for NTP elements on light // backgrounds. extern const base::FeatureParam kNtpElementLuminosityChangeForLightBackgroundParam; // Parameter for controlling the luminosity difference for NTP elements on dark // backgrounds. extern const base::FeatureParam kNtpElementLuminosityChangeForDarkBackgroundParam; // Parameter determining the ignore based survey launch delay time. extern const char kNtpModuleIgnoredHaTSDelayTimeParam[]; // Parameter determining the number of times a module must have loaded with no // interaction by the user before it's considered as ignored. extern const char kNtpModuleIgnoredCriteriaThreshold[]; // Parameter determining the module load timeout. extern const char kNtpModulesLoadTimeoutMillisecondsParam[]; // Parameter determining the module order. extern const char kNtpModulesOrderParam[]; // Parameter determining the type of calendar data used to render module. extern const char kNtpCalendarModuleDataParam[]; // Parameter determining the type of cart data used to render module. extern const char kNtpChromeCartModuleDataParam[]; // Parameter for enabling the abandoned cart discount. extern const char kNtpChromeCartModuleAbandonedCartDiscountParam[]; // Parameter for enabling the abandoned cart discount with utm_source tag to // indicate the feature state. extern const char kNtpChromeCartModuleAbandonedCartDiscountUseUtmParam[]; // Parameter for enabling the cart heuristics improvement. extern const char kNtpChromeCartModuleHeuristicsImprovementParam[]; // Parameter for enabling coupons on the Cart module. extern const char kNtpChromeCartModuleCouponParam[]; // Parameter determining the type of Drive data to render. extern const char kNtpDriveModuleDataParam[]; // Parameter for enabling the Drive module for managed users only. extern const char kNtpDriveModuleManagedUsersOnlyParam[]; // Parameter determining the max age in seconds of the cache for drive data. extern const char kNtpDriveModuleCacheMaxAgeSParam[]; // Parameter for communicating the experiment group of the Drive module // experiment. extern const char kNtpDriveModuleExperimentGroupParam[]; // Parameter determining the type of calendar data to render. extern const char kNtpOutlookCalendarModuleDataParam[]; // Parameter determining the type of middle slot promo data to render. extern const char kNtpMiddleSlotPromoDismissalParam[]; // Parameter determining the modules that are eligigle for HaTS. extern const char kNtpModulesEligibleForHappinessTrackingSurveyParam[]; // Parameter determining module trigger ids for HaTS for eligible module ids for // a given module interaction type. extern const char kNtpModulesInteractionBasedSurveyEligibleIdsParam[]; // Parameter determining the variation of the omnibox theme matching. extern const char kRealboxMatchOmniboxThemeVariantParam[]; extern const char kNtpMostRelevantTabResumptionModuleDataParam[]; // Parameter determining the max visits to show. extern const char kNtpMostRelevantTabResumptionModuleMaxVisitsParam[]; extern const char kNtpRealboxWidthBehaviorParam[]; // Parameter determining the type of tab groups data to render. extern const char kNtpTabGroupsModuleDataParam[]; // Parameter for determining the categories a tab must not fall into // to be shown. extern const char kNtpTabResumptionModuleCategoriesBlocklistParam[]; extern const char kNtpTabResumptionModuleDataParam[]; // Parameter determining for how long a dismissed tab should be discarded // from the module's displayed visit resumption suggestions. extern const char kNtpTabResumptionModuleDismissalDurationParam[]; // Parameter determining what types result types to request when fetching URL // visit aggregate data. extern const char kNtpTabResumptionModuleResultTypesParam[]; // Parameter determining the recency of tabs in the Tab Resumption module. extern const char kNtpTabResumptionModuleTimeLimitParam[]; extern const char kNtpTabResumptionModuleVisibilityThresholdDataParam[]; // Parameter determining the number of times to animate the NTP Wallpaper Search // button. extern const char kNtpWallpaperSearchButtonAnimationShownThresholdParam[]; // Parameter determining what condition to use to hide the wallpaper search // button. extern const char kNtpWallpaperSearchButtonHideConditionParam[]; // Parameter determining the trigger delay of the Wallpaper Search HaTS survey. extern const char kWallpaperSearchHatsDelayParam[]; // Parameter determining the experiment name to pass to the Google Calendar // API. extern const base::FeatureParam kNtpCalendarModuleExperimentParam; // Parameter determining the number of events to show on the calendar module. extern const base::FeatureParam kNtpCalendarModuleMaxEventsParam; // Parameter determining the time delta from now for the end of the event // window. extern const base::FeatureParam kNtpCalendarModuleWindowEndDeltaParam; // Parameter determining the time delta from now for the start of the event // window. extern const base::FeatureParam kNtpCalendarModuleWindowStartDeltaParam; // Parameter for the maximum number of times to automatically show // Customize Chrome. extern const base::FeatureParam kNtpCustomizeChromeAutoShownMaxCount; // Parameter for the maximum number of times to automatically show // Customize Chrome in a session. extern const base::FeatureParam kNtpCustomizeChromeAutoShownSessionMaxCount; // Parameter determining whether the existence of Outlook attachment pages // should be checked. extern const base::FeatureParam kNtpOutlookCalendarModuleAttachmentCheckParam; // Parameter determining whether attachments should be disabled. extern const base::FeatureParam kNtpOutlookCalendarModuleDisableAttachmentsParam; // Parameter determining the max number of events to display on the Outlook // Calendar module. extern const base::FeatureParam kNtpOutlookCalendarModuleMaxEventsParam; // Parameter determining the time range of events. extern const base::FeatureParam kNtpOutlookCalendarModuleRetrievalWindowParam; // Parameter determining the background color of the expanded state realbox. extern const base::FeatureParam kNtpRealboxCr23ExpandedStateBgMatchesOmnibox; // Parameter determining the whether the steady state realbox has a shadow. extern const base::FeatureParam kNtpRealboxCr23SteadyStateShadow; // Parameter determining the type of data to render. extern const base::FeatureParam kNtpSharepointModuleDataParam; // Parameter determining the max number of files to display on the Microsoft // files module. extern const base::FeatureParam kNtpMicrosoftFilesModuleMaxFilesParam; // Parameter determining the max number of trending files to display on the // Microsoft files module. Used only for the // `NtpSharepointModuleDataType::kCombinedSuggestions` variation. extern const base::FeatureParam kNtpMicrosoftFilesModuleMaxTrendingFilesForCombinedParam; // Parameter determining the max number of used and shared files to display on // the Microsoft files module. Used only for the // `NtpSharepointModuleDataType::kCombinedSuggestions` variation. extern const base::FeatureParam kNtpMicrosoftFilesModuleMaxNonInsightsFilesForCombinedParam; // Parameter determining whether the tab resumption module should filter visits // that are associated with local tabs. extern const base::FeatureParam kNtpMostRelevantTabResumptionModuleFilterLocalTabsParam; // Parameter determining the time range of events. extern const base::FeatureParam kNtpTabGroupsModuleWindowEndDeltaParam; // Parameter determing the max number of tab groups to show in the module. extern const base::FeatureParam kNtpTabGroupsModuleMaxGroupCountParam; // Parameter determining if the Action Chips on the NTP should display static // text instead of real suggestions. extern const base::FeatureParam kNtpNextShowStaticTextParam; // Parameter determining if the recent tab should be run through client-side // sensitivity check. extern const base::FeatureParam kNtpNextClientSensitivityCheckParam; // Parameter determining if a recent tab chip/row should be generated in the // steady state in NTP. If false, one is NOT generated in the steady state, // while one is still generated in the deep-dive state. extern const base::FeatureParam kNtpNextShowStaticRecentTabChipParam; // Parameter determining if the Action Chips on the NTP should display the // dismissal UI. extern const base::FeatureParam kNtpNextShowDismissalUIParam; // Parameter determining if right-clicking an action chip should display the // disablement context menu. extern const base::FeatureParam kNtpNextDisablementContextMenuParam; // Parameter determining if the disablement is enabled for NTP Next. extern const base::FeatureParam kNtpNextDisablementParam; // Parameter determining if the tab upload should be delayed when tab context is // added from an action chip. extern const base::FeatureParam kAddTabUploadDelayOnActionChipClick; // Parameter determining the maximum number of small action chips to show. extern const base::FeatureParam kNtpMaxSmallChips; // Parameter determining if in test mode for small action chips. extern const base::FeatureParam kNtpScaledActionChipsSmallInTestMode; // Parameter determining if fallback action chips should be shown. // Used for local testing. extern const base::FeatureParam kNtpScaledActionChipsShowFallback; // Parameter determining the minimum amount of time that must pass before // shortcuts staleness counters will be incremented. extern const base::FeatureParam kShortcutsMinStalenessUpdateTimeInterval; // Parameter determining the minimum amount of time that must pass before // staleness counters will be incremented. extern const base::FeatureParam kModuleMinStalenessUpdateTimeInterval; // Parameter determining the count at which shortcuts will be considered stale // and be eligible for auto-removal. extern const base::FeatureParam kStaleShortcutsCountThreshold; // Parameter determining the count at which modules will be considered stale // and eligible for auto-removal. extern const base::FeatureParam kStaleModulesCountThreshold; // Parameter determining the count at which the bookmark bar will be eligible // for auto-removal. extern const base::FeatureParam kBookmarkBarCountThreshold; // Parameter determining the minimum amount of time before auto-removal prefs // are updated. extern const base::FeatureParam kBookmarkBarMinStalenessTimeInterval; // Returns the timeout after which the load of a module should be aborted. base::TimeDelta GetModulesLoadTimeout(); // Returns the maximum number of columns to show on the redesigned modules UI // experience. int GetModulesMaxColumnCount(); // Returns the maximum number of instances to render for a given module when the // module has loaded with other modules. A sentinel value of -1 implies there is // no limit. int GetMultipleLoadedModulesMaxModuleInstanceCount(); // Returns a list of module IDs ordered by how they should appear on the NTP. std::vector GetModulesOrder(); // Returns the maximum number of times to show animation for NTP wallpaper // search button. int GetWallpaperSearchButtonAnimationShownThreshold(); // Returns the condition to use to hide the wallpaper search button. int GetWallpaperSearchButtonHideCondition(); // Parameter determining the max number of tiles to show in the collapsed state. extern const base::FeatureParam kMaxTilesInCollapsedState; // Parameter determining the max number of shortcuts to show in the expanded // state. extern const base::FeatureParam kMaxShortcutsInExpandedState; // Parameter determining the max number of MV tiles to show in the expanded // state. extern const base::FeatureParam kMaxMostVisitedTilesInExpandedState; // Parameter determining the max number of enterprise shortcuts allowed. extern const base::FeatureParam kMaxEnterpriseShortcuts; // Returns the max number of tiles to show in the collapsed state. int GetMaxTilesInCollapsedState(); // Returns the max number of shortcuts to show in the expanded state. int GetMaxShortcutsInExpandedState(); // Returns the max number of MV tiles to show in the expanded state. int GetMaxMostVisitedTilesInExpandedState(); // Returns the max number of enterprise shortcuts allowed. int GetMaxEnterpriseShortcuts(); base::TimeDelta GetBookmarkBarMinStalenessTimeInterval(); int GetBookmarkBarCountThreshold(); extern const base::FeatureParam kEnergyEffectVariantParam; } // namespace ntp_features #endif // COMPONENTS_SEARCH_NTP_FEATURES_H_