// Copyright 2020 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

module blink.mojom;

import "url/mojom/url.mojom";
import "ui/gfx/geometry/mojom/geometry.mojom";

// The icon type in a page. The definition must be same as
// favicon_base::IconType.
// TODO: Figure out if it should be updated to be in sync.
enum FaviconIconType {
  kInvalid,
  kFavicon,
  kTouchIcon,
  kTouchPrecomposedIcon,
};

// The reason a favicon URL update was sent from the renderer to the browser.
enum FaviconUpdateReason {
  // Sent when the page finishes loading.
  kPageLoad,
  // A media feature change (e.g. prefers-color-scheme) triggered re-evaluation.
  kMediaQueryChange,
  // A <link> element was added, removed, or modified.
  kLinkElementChange,
};

// The favicon url from the document.
struct FaviconURL {
  // The url of the icon.
  url.mojom.Url icon_url;

  // The type of the icon
  FaviconIconType icon_type;

  // Icon's bitmaps' size
  array<gfx.mojom.Size> icon_sizes;

  // Whether the favicon URL is a default one generated
  // by Chrome in the absence of any provided icons,
  // using the document URL.
  bool is_default_icon;
};