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

#include "base/gtest_prod_util.h"
#include "base/time/time.h"
#include "base/types/expected.h"
#include "third_party/blink/renderer/core/dom/events/event_target.h"
#include "third_party/blink/renderer/core/geolocation/geolocation.h"
#include "third_party/blink/renderer/core/geolocation/geolocation_position_error.h"
#include "third_party/blink/renderer/core/geolocation/geolocation_watchers.h"
#include "third_party/blink/renderer/core/geolocation/geoposition.h"
#include "third_party/blink/renderer/core/html/html_capability_element_base.h"
#include "third_party/blink/renderer/platform/heap/member.h"
#include "third_party/blink/renderer/platform/timer.h"

namespace blink {

class CORE_EXPORT HTMLGeolocationElement final
    : public HTMLCapabilityElementBase {
  DEFINE_WRAPPERTYPEINFO();

 public:
  explicit HTMLGeolocationElement(Document&);

  ElementType GetElementType() const final {
    return ElementType::kHTMLGeolocationElement;
  }

  DEFINE_ATTRIBUTE_EVENT_LISTENER(location, kLocation)

  bool autolocate() const {
    return FastHasAttribute(html_names::kAutolocateAttr);
  }

  Geoposition* position() const;
  GeolocationPositionError* error() const;

  void Trace(Visitor*) const override;

  const base::TimeTicks& InProgressApearanceStartedTimeForTesting() {
    return in_progress_appearance_started_time_;
  }

 private:
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest,
                           GeolocationUsingLocationAppearance);
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest,
                           GeolocationTranslateInnerText);
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest,
                           GeolocationWatchPositionAppearance);
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest,
                           GeolocationGrantedClickBehavior);
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest, GeolocationAutolocate);
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest,
                           GeolocationAutolocateWatch);
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest,
                           GeolocationAutolocateTriggersOnce);
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest,
                           GeolocationTranslateInnerText);
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest,
                           RequestLocationAfterClickAndPermissionChanged);
  FRIEND_TEST_ALL_PREFIXES(HTMLGeolocationElementTest,
                           GeolocationRequestInProgress);

  // HTMLCapabilityElementBase:
  void UpdateAppearance() override;
  void UpdateIcon(mojom::blink::PermissionName permission) override;
  void UpdatePermissionStatusAndAppearance() override;
  mojom::blink::EmbeddedPermissionRequestDescriptorPtr
  CreateEmbeddedPermissionRequestDescriptor() override;
  void ParseAttribute(const AttributeModificationParams& params) override;
  void DefaultEventHandler(Event&) override;
  void OnPermissionStatusChange(mojom::blink::PermissionName,
                                mojom::blink::PermissionStatus) override;
  void DidFinishLifecycleUpdate(const LocalFrameView&) override;
  void DidAddUserAgentShadowRoot(ShadowRoot&) override;

  void OnActivated();
  void GetCurrentPosition();
  void WatchPosition();
  // Callback for Geolocation::getCurrentPosition. It is called when the
  // geolocation API returns a position or an error.
  void CurrentPositionCallback(
      base::expected<Geoposition*, GeolocationPositionError*>);
  Geolocation* GetGeolocation();
  void MaybeHideInProgressAppearance();
  void ShowInProgressAppearance();
  bool ShouldShowInProgressAppearance();
  void RequestGeolocation();
  void ClearWatch();
  enum class ForceAutolocate { kNo, kYes };
  void MaybeTriggerAutolocate(ForceAutolocate);
  void UpdateText();

  // The watch_id_ is used to identify the watcher in the Geolocation object.
  // The ids always start from 1. 0 means that the watch is not set.
  int watch_id_ = 0;
  bool did_autolocate_trigger_request = false;
  bool is_geolocation_request_in_progress_ = false;
  base::TimeTicks in_progress_appearance_started_time_;

  Member<Geoposition> position_;
  Member<GeolocationPositionError> error_;
};

}  // namespace blink
#endif  // THIRD_PARTY_BLINK_RENDERER_CORE_HTML_HTML_GEOLOCATION_ELEMENT_H_