// 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_WEBUI_UTIL_WEBUI_UTIL_DESKTOP_H_
#define CHROME_BROWSER_UI_WEBUI_UTIL_WEBUI_UTIL_DESKTOP_H_

#include <string>

#include "base/containers/flat_map.h"
#include "base/containers/span.h"
#include "ui/base/webui/resource_path.h"

namespace content {
class WebContents;
}

namespace ui {
class NativeTheme;
class ThemeProvider;
}  // namespace ui

class BrowserWindowInterface;
class GURL;

namespace webui {

// Returns the BrowserWindowInterface that should be used for opening WebUI.
// If `browser` is a picture-in-picture window, this will return the opener
// browser window interface if it exists.
BrowserWindowInterface* GetBrowserForOpeningWebUi(
    BrowserWindowInterface* browser);

// These methods should not be used. Instead, browser-related state should be
// passed from the owner of the WebUI instance to the WebUIController instance.
// See LensOverlayController for one example of how to do this.
// Returns whether WebContents should use dark mode colors depending on the
// theme.
ui::NativeTheme* GetNativeThemeDeprecated(content::WebContents* web_contents);

// Returns the ThemeProvider instance associated with the given web contents.
const ui::ThemeProvider* GetThemeProviderDeprecated(
    content::WebContents* web_contents);

// Sets a global theme provider that will be returned when calling
// webui::GetThemeProviderDeprecated(). Used only for testing.
void SetThemeProviderForTestingDeprecated(
    const ui::ThemeProvider* theme_provider);

// Gets the metrics appropriate hostname for a given WebUI URL for code cache
// metrics. Returns an empty string if no relevant mapping has been defined.
std::string GetWebUIHostnameForCodeCacheMetrics(const GURL& webui_url);

// Appends WebUI resource URLs to code cache resource ID pairs from the given
// `code_cache_resources` into `resource_code_cache_pairs`.
void AppendWebUIResourceURLToCodeCachePairs(
    std::string_view scheme,
    std::string_view host,
    base::span<const ResourcePath> code_cache_resources,
    std::vector<std::pair<GURL, int>>& resource_code_cache_pairs);

// Gets the WebUI URL to code cache resource ID map.
base::flat_map<GURL, int> GetWebUIResourceUrlToCodeCacheMap();

}  // namespace webui

#endif  // CHROME_BROWSER_UI_WEBUI_UTIL_WEBUI_UTIL_DESKTOP_H_