/* * Copyright (c) 2025-2026, Tim Flynn * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace WebView { struct TabSettings { bool vertical_tabs_enabled { false }; bool vertical_tabs_expanded { true }; bool vertical_tabs_expand_on_hover { false }; Optional vertical_tabs_expanded_width; }; struct BrowsingBehavior { bool enable_autoscroll { true }; bool enable_primary_paste { true }; }; struct SiteSetting { OrderedHashTable site_filters; protected: SiteSetting() = default; }; struct AutoplaySiteSetting : public SiteSetting { Web::HTML::AutoplayPolicy policy { Web::HTML::AutoplayPolicy::BlockAudio }; }; struct BrowsingDataSettings { HTTP::DiskCacheSettings disk_cache_settings; }; enum class GlobalPrivacyControl { No, Yes, }; enum class ConfigVariableID : u8 { ShowWebContentProcessIDInTabTitle, ShowAdvancedDebugMenu, ContentBlockerListPaths, UseRoundedWindowCorners, UseServerSideWindowDecorations, Count, }; struct ConfigVariableDefinition { ConfigVariableID id; StringView name; StringView title; StringView description; JsonValue default_value; Optional array_element_type; }; WEBVIEW_API ReadonlySpan config_variable_definitions(); WEBVIEW_API Optional config_variable_id_from_name(StringView); class WEBVIEW_API SettingsObserver { public: explicit SettingsObserver(); virtual ~SettingsObserver(); virtual void new_tab_page_url_changed() { } virtual void tab_settings_changed() { } virtual void show_menu_bar_changed() { } virtual void show_bookmarks_bar_changed() { } virtual void default_zoom_level_factor_changed() { } virtual void zoom_per_host_changed(StringView host) { (void)host; } virtual void languages_changed() { } virtual void browsing_behavior_changed() { } virtual void search_engine_changed() { } virtual void autocomplete_engine_changed() { } virtual void autoplay_settings_changed() { } virtual void browsing_data_settings_changed() { } virtual void global_privacy_control_changed() { } virtual void dns_settings_changed() { } virtual void config_variable_changed(ConfigVariableID) { } }; class WEBVIEW_API Settings { public: static Settings create(Badge); JsonValue serialize_json() const; URL::URL const& new_tab_page_url() const { return m_new_tab_page_url; } void set_new_tab_page_url(URL::URL); static TabSettings parse_tab_settings(JsonValue const&); TabSettings const& tab_settings() const { return m_tab_settings; } void set_tab_settings(TabSettings); bool show_menu_bar() const { return m_show_menu_bar; } void set_show_menu_bar(bool); bool show_bookmarks_bar() const { return m_show_bookmarks_bar; } void set_show_bookmarks_bar(bool); double default_zoom_level_factor() const { return m_default_zoom_level_factor; } void set_default_zoom_level_factor(double); Optional zoom_for_host(StringView host) const; void set_zoom_for_host(StringView host, double zoom_level); static Vector parse_json_languages(JsonValue const&); Vector const& languages() const { return m_languages; } void set_languages(Vector); static BrowsingBehavior parse_browsing_behavior(JsonValue const&); BrowsingBehavior browsing_behavior() const; void set_browsing_behavior(BrowsingBehavior); Optional const& search_engine() const { return m_search_engine; } void set_search_engine(Optional search_engine_name); static Optional parse_custom_search_engine(JsonValue const&); void add_custom_search_engine(SearchEngine); void remove_custom_search_engine(SearchEngine const&); Optional const& autocomplete_engine() const { return m_autocomplete_engine; } void set_autocomplete_engine(Optional autocomplete_engine_name); AutoplaySiteSetting const& autoplay_settings() const { return m_autoplay; } void set_autoplay_policy(Web::HTML::AutoplayPolicy); void add_autoplay_site_filter(String const&); void remove_autoplay_site_filter(String const&); void remove_all_autoplay_site_filters(); static BrowsingDataSettings parse_browsing_data_settings(JsonValue const&); BrowsingDataSettings const& browsing_data_settings() const { return m_browsing_data_settings; } void set_browsing_data_settings(BrowsingDataSettings); GlobalPrivacyControl global_privacy_control() const { return m_global_privacy_control; } void set_global_privacy_control(GlobalPrivacyControl); static DNSSettings parse_dns_settings(JsonValue const&); DNSSettings const& dns_settings() const { return m_dns_settings; } void set_dns_settings(DNSSettings const&, bool override_by_command_line = false); JsonValue const& config_variable(ConfigVariableID) const; bool config_variable_as_bool(ConfigVariableID) const; Vector config_variable_as_string_array(ConfigVariableID) const; void set_config_variable(ConfigVariableID, JsonValue); void set_config_variable(StringView name, JsonValue const&); static void add_observer(Badge, SettingsObserver&); static void remove_observer(Badge, SettingsObserver&); private: explicit Settings(ByteString settings_path); void persist_settings(); Optional find_search_engine_by_name(StringView name); ByteString m_settings_path; URL::URL m_new_tab_page_url; TabSettings m_tab_settings; bool m_show_menu_bar { false }; bool m_show_bookmarks_bar { true }; double m_default_zoom_level_factor { 0 }; HashMap m_zoom_per_host; Vector m_languages; BrowsingBehavior m_browsing_behavior; Optional m_search_engine; Vector m_custom_search_engines; Optional m_autocomplete_engine; AutoplaySiteSetting m_autoplay; BrowsingDataSettings m_browsing_data_settings; GlobalPrivacyControl m_global_privacy_control { GlobalPrivacyControl::No }; DNSSettings m_dns_settings { SystemDNS() }; bool m_dns_override_by_command_line { false }; Array(ConfigVariableID::Count)> m_config_variables {}; Vector m_observers; }; } namespace IPC { template<> WEBVIEW_API ErrorOr encode(Encoder&, WebView::BrowsingBehavior const&); template<> WEBVIEW_API ErrorOr decode(Decoder&); }