Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-browser-engine

Source of release 0.6.1

0.6.1 / src / web / dom / event.lucb

#==============================================================================================
#
#   event - DOM::Event: creation, the event flags, the event path and composedPath()
#
#   DESCRIPTION:
#       Port of Libraries/LibWeb/DOM/Event.cpp (lines 1-277) with the inline functions of
#       Event.h (lines 1-198): the inner event creation steps, the accessors and flag setters
#       the dispatch algorithm uses, appending to an event path, initializing an event and the
#       composed path. Event::initialize's unforgeable `isTrusted` attribute belongs to the JS
#       wrapper (phase 3).
#
#       Copyright (c) 2020, the SerenityOS developers.
#       Copyright (c) 2021, Luke Wilde <lukew@serenityos.org>
#       Copyright (c) 2022, Andreas Kling <andreas@ladybird.org>
#       SPDX-License-Identifier: BSD-2-Clause
#
#==============================================================================================

# mark: Creation ================================================================================

## Ported from Libraries/LibWeb/DOM/Event.cpp:24 Web::DOM::Event::create.
## https://dom.spec.whatwg.org/#concept-event-create
pub func dom_event_create(realm: Realm*, event_name: ak.FlyString, event_init: DomEventInit = DomEventInit()) -> DomEvent*:
    let event = realm_create_dom_event_dom_event_init(realm, realm, event_name, event_init)
    # 4. Initialize event’s isTrusted attribute to true.
    event.m_is_trusted = true
    return event

## Ported from Libraries/LibWeb/DOM/Event.cpp:32 Web::DOM::Event::construct_impl.
pub func dom_event_construct_impl(realm: Realm*, event_name: ak.FlyString, event_init: DomEventInit) -> DomEvent*!:
    return realm_create_dom_event_dom_event_init(realm, realm, event_name, event_init)

## Ported from Libraries/LibWeb/DOM/Event.cpp:38 Web::DOM::Event::Event(JS::Realm&, FlyString const&).
## https://dom.spec.whatwg.org/#inner-event-creation-steps
pub func dom_event_construct(this: DomEvent*, realm: Realm*, type_: ak.FlyString):
    bind_platform_object_construct_realm(this.bind_platform_object(), realm)
    this.m_type = type_
    this.m_initialized = true
    this.m_time_stamp = high_resolution_time_current_high_resolution_time(html_relevant_global_object((JsObject*)this))

## Ported from Libraries/LibWeb/DOM/Event.cpp:47 Web::DOM::Event::Event(JS::Realm&, FlyString const&, EventInit const&).
## https://dom.spec.whatwg.org/#inner-event-creation-steps
pub func dom_event_construct_dom_event_init(this: DomEvent*, realm: Realm*, type_: ak.FlyString, event_init: DomEventInit):
    bind_platform_object_construct_realm(this.bind_platform_object(), realm)
    this.m_type = type_
    this.m_bubbles = event_init.bubbles
    this.m_cancelable = event_init.cancelable
    this.m_composed = event_init.composed
    this.m_initialized = true
    this.m_time_stamp = high_resolution_time_current_high_resolution_time(html_relevant_global_object((JsObject*)this))

## Ported from Libraries/LibWeb/DOM/Event.cpp:58 Web::DOM::Event::initialize (override).
pub func dom_event_initialize_impl(base: JsCell*, realm: Realm*):
    web_set_prototype_for_interface(base, realm, BindInterfaceName.event)
    # Base::initialize(realm): PlatformObject inherits JS::Object's, which is JS::Cell's.
    js_cell_initialize_impl(base, realm)
    # Bindings::EventPrototype::define_unforgeable_attributes(realm, *this): the unforgeable
    # `isTrusted` attribute is a property of the JS wrapper (phase 3).

## Ported from Libraries/LibWeb/DOM/Event.cpp:65 Web::DOM::Event::visit_edges (override).
pub func dom_event_visit_edges_impl(base: gc.Cell*, visitor: gc.CellVisitor*):
    let this = (DomEvent*)base
    bind_platform_object_visit_edges_impl(base, visitor)
    gc.cell_visitor_visit_t(visitor, this.m_target)
    gc.cell_visitor_visit_t(visitor, this.m_related_target)
    gc.cell_visitor_visit_t(visitor, this.m_current_target)
    for it in ak.vector_span(&this.m_path):
        gc.cell_visitor_visit_t(visitor, it.invocation_target)
        gc.cell_visitor_visit_t(visitor, it.shadow_adjusted_target)
        gc.cell_visitor_visit_t(visitor, it.related_target)
        gc.cell_visitor_visit_vector_nullable(visitor, &it.touch_target_list)
    gc.cell_visitor_visit_vector_nullable(visitor, &this.m_touch_target_list)

# mark: Accessors (Event.h) =====================================================================

## Ported from Libraries/LibWeb/DOM/Event.h:60 Web::DOM::Event::time_stamp.
## https://dom.spec.whatwg.org/#dom-event-timestamp
pub func dom_event_time_stamp(this: DomEvent*) -> f64:
    return this.m_time_stamp

## Ported from Libraries/LibWeb/DOM/Event.h:62 Web::DOM::Event::type.
pub func dom_event_type(this: DomEvent*) -> ak.FlyString:
    return this.m_type

## Ported from Libraries/LibWeb/DOM/Event.h:63 Web::DOM::Event::set_type.
pub func dom_event_set_type(this: DomEvent*, type_: ak.FlyString):
    this.m_type = type_

## Ported from Libraries/LibWeb/DOM/Event.h:65 Web::DOM::Event::target.
pub func dom_event_target(this: DomEvent*) -> DomEventTarget*?:
    return this.m_target

## Ported from Libraries/LibWeb/DOM/Event.h:66 Web::DOM::Event::set_target.
pub func dom_event_set_target(this: DomEvent*, target: DomEventTarget*?):
    this.m_target = target

## Ported from Libraries/LibWeb/DOM/Event.h:69 Web::DOM::Event::src_element.
## NOTE: This is intended for the JS bindings.
pub func dom_event_src_element(this: DomEvent*) -> DomEventTarget*?:
    return dom_event_target(this)

## Ported from Libraries/LibWeb/DOM/Event.h:71 Web::DOM::Event::related_target.
pub func dom_event_related_target(this: DomEvent*) -> DomEventTarget*?:
    return this.m_related_target

## Ported from Libraries/LibWeb/DOM/Event.h:72 Web::DOM::Event::set_related_target.
pub func dom_event_set_related_target(this: DomEvent*, related_target: DomEventTarget*?):
    this.m_related_target = related_target

## Ported from Libraries/LibWeb/DOM/Event.h:74 Web::DOM::Event::should_stop_propagation.
pub func dom_event_should_stop_propagation(this: DomEvent*) -> bool:
    return this.m_stop_propagation

## Ported from Libraries/LibWeb/DOM/Event.h:75 Web::DOM::Event::set_stop_propagation.
pub func dom_event_set_stop_propagation(this: DomEvent*, stop_propagation: bool):
    this.m_stop_propagation = stop_propagation

## Ported from Libraries/LibWeb/DOM/Event.h:77 Web::DOM::Event::should_stop_immediate_propagation.
pub func dom_event_should_stop_immediate_propagation(this: DomEvent*) -> bool:
    return this.m_stop_immediate_propagation

## Ported from Libraries/LibWeb/DOM/Event.h:78 Web::DOM::Event::set_stop_immediate_propagation.
pub func dom_event_set_stop_immediate_propagation(this: DomEvent*, stop_immediate_propagation: bool):
    this.m_stop_immediate_propagation = stop_immediate_propagation

## Ported from Libraries/LibWeb/DOM/Event.h:80 Web::DOM::Event::cancelled.
pub func dom_event_cancelled(this: DomEvent*) -> bool:
    return this.m_cancelled

## Ported from Libraries/LibWeb/DOM/Event.h:81 Web::DOM::Event::set_cancelled.
pub func dom_event_set_cancelled(this: DomEvent*, cancelled: bool):
    this.m_cancelled = cancelled

## Ported from Libraries/LibWeb/DOM/Event.h:83 Web::DOM::Event::in_passive_listener.
pub func dom_event_in_passive_listener(this: DomEvent*) -> bool:
    return this.m_in_passive_listener

## Ported from Libraries/LibWeb/DOM/Event.h:84 Web::DOM::Event::set_in_passive_listener.
pub func dom_event_set_in_passive_listener(this: DomEvent*, in_passive_listener: bool):
    this.m_in_passive_listener = in_passive_listener

## Ported from Libraries/LibWeb/DOM/Event.h:86 Web::DOM::Event::composed.
pub func dom_event_composed(this: DomEvent*) -> bool:
    return this.m_composed

## Ported from Libraries/LibWeb/DOM/Event.h:87 Web::DOM::Event::set_composed.
pub func dom_event_set_composed(this: DomEvent*, composed: bool):
    this.m_composed = composed

## Ported from Libraries/LibWeb/DOM/Event.h:89 Web::DOM::Event::initialized.
pub func dom_event_initialized(this: DomEvent*) -> bool:
    return this.m_initialized

## Ported from Libraries/LibWeb/DOM/Event.h:90 Web::DOM::Event::set_initialized.
pub func dom_event_set_initialized(this: DomEvent*, initialized: bool):
    this.m_initialized = initialized

## Ported from Libraries/LibWeb/DOM/Event.h:92 Web::DOM::Event::dispatched.
pub func dom_event_dispatched(this: DomEvent*) -> bool:
    return this.m_dispatch

## Ported from Libraries/LibWeb/DOM/Event.h:93 Web::DOM::Event::set_dispatched.
pub func dom_event_set_dispatched(this: DomEvent*, dispatched: bool):
    this.m_dispatch = dispatched

## Ported from Libraries/LibWeb/DOM/Event.h:95 Web::DOM::Event::prevent_default.
pub func dom_event_prevent_default(this: DomEvent*):
    dom_event_set_cancelled_flag(this)

## Ported from Libraries/LibWeb/DOM/Event.h:96 Web::DOM::Event::default_prevented.
pub func dom_event_default_prevented(this: DomEvent*) -> bool:
    return dom_event_cancelled(this)

## Ported from Libraries/LibWeb/DOM/Event.h:98 Web::DOM::Event::event_phase.
pub func dom_event_event_phase(this: DomEvent*) -> u16:
    return (u16)this.m_phase

## Ported from Libraries/LibWeb/DOM/Event.h:99 Web::DOM::Event::set_phase.
pub func dom_event_set_phase(this: DomEvent*, phase: DomEventPhase):
    this.m_phase = phase

## Ported from Libraries/LibWeb/DOM/Event.h:101 Web::DOM::Event::current_target.
pub func dom_event_current_target(this: DomEvent*) -> DomEventTarget*?:
    return this.m_current_target

## Ported from Libraries/LibWeb/DOM/Event.h:102 Web::DOM::Event::set_current_target.
pub func dom_event_set_current_target(this: DomEvent*, current_target: DomEventTarget*?):
    this.m_current_target = current_target

## Ported from Libraries/LibWeb/DOM/Event.h:106 Web::DOM::Event::return_value.
pub func dom_event_return_value(this: DomEvent*) -> bool:
    return not this.m_cancelled

## Ported from Libraries/LibWeb/DOM/Event.h:107 Web::DOM::Event::set_return_value.
pub func dom_event_set_return_value(this: DomEvent*, return_value: bool):
    if not return_value:
        dom_event_set_cancelled_flag(this)

# mark: The event path ==========================================================================

## Ported from Libraries/LibWeb/DOM/Event.cpp:81 Web::DOM::Event::append_to_path.
## https://dom.spec.whatwg.org/#concept-event-path-append
pub func dom_event_append_to_path(this: DomEvent*, invocation_target: DomEventTarget*, shadow_adjusted_target: DomEventTarget*?, related_target: DomEventTarget*?, touch_targets: ak.Vector[DomEventTarget*?]*, slot_in_closed_tree: bool):
    # 1. Let invocationTargetInShadowTree be false.
    var invocation_target_in_shadow_tree = false

    # 3. Let root-of-closed-tree be false.
    var root_of_closed_tree = false

    # 2. If invocationTarget is a node and its root is a shadow root, then set invocationTargetInShadowTree to true.
    if let invocation_target_node = as_if_dom_node(invocation_target):
        if is_dom_shadow_root(tree_node_root(invocation_target_node)):
            invocation_target_in_shadow_tree = true
        if let invocation_target_shadow_root = as_if_dom_shadow_root(invocation_target_node):
            # 4. If invocationTarget is a shadow root whose mode is "closed", then set root-of-closed-tree to true.
            root_of_closed_tree = dom_shadow_root_mode(invocation_target_shadow_root) == BindShadowRootMode.closed

    # 5. Append a new struct to event’s path whose invocation target is invocationTarget, invocation-target-in-shadow-tree is invocationTargetInShadowTree,
    # shadow-adjusted target is shadowAdjustedTarget, relatedTarget is relatedTarget, touch target list is touchTargets, root-of-closed-tree is root-of-closed-tree,
    # and slot-in-closed-tree is slot-in-closed-tree.
    # (The touch target list is copied, as C++ copies the Vector into the struct.)
    ak.vector_append_t(&this.m_path, DomEventPathEntry(invocation_target = invocation_target, invocation_target_in_shadow_tree = invocation_target_in_shadow_tree, shadow_adjusted_target = shadow_adjusted_target, related_target = related_target, touch_target_list = ak.vector_clone(touch_targets), root_of_closed_tree = root_of_closed_tree, slot_in_closed_tree = slot_in_closed_tree, index = ak.vector_size(&this.m_path)))

## Ported from Libraries/LibWeb/DOM/Event.h:114 Web::DOM::Event::path.
pub func dom_event_path(this: DomEvent*) -> ak.Vector[DomEventPathEntry]*:
    return &this.m_path

## Ported from Libraries/LibWeb/DOM/Event.h:115 Web::DOM::Event::path (const): the path itself,
## not a copy (C++ answers a const reference).
pub func dom_event_path_const(this: DomEvent*) -> const ak.Vector[DomEventPathEntry]*:
    return &this.m_path

## Ported from Libraries/LibWeb/DOM/Event.h:116 Web::DOM::Event::clear_path.
pub func dom_event_clear_path(this: DomEvent*):
    ak.vector_clear(&this.m_path)

## Ported from Libraries/LibWeb/DOM/Event.h:118 Web::DOM::Event::set_touch_target_list: a copy of
## the list (C++ copy-assigns the Vector).
pub func dom_event_set_touch_target_list(this: DomEvent*, touch_target_list: ak.Vector[DomEventTarget*?]*):
    this.m_touch_target_list = ak.vector_clone(touch_target_list)

## Ported from Libraries/LibWeb/DOM/Event.h:119 Web::DOM::Event::touch_target_list.
pub func dom_event_touch_target_list(this: DomEvent*) -> ak.Vector[DomEventTarget*?]*:
    return &this.m_touch_target_list

## Ported from Libraries/LibWeb/DOM/Event.h:120 Web::DOM::Event::clear_touch_target_list.
pub func dom_event_clear_touch_target_list(this: DomEvent*):
    ak.vector_clear(&this.m_touch_target_list)

# mark: More accessors (Event.h) ================================================================

## Ported from Libraries/LibWeb/DOM/Event.h:122 Web::DOM::Event::bubbles.
pub func dom_event_bubbles(this: DomEvent*) -> bool:
    return this.m_bubbles

## Ported from Libraries/LibWeb/DOM/Event.h:123 Web::DOM::Event::set_bubbles.
pub func dom_event_set_bubbles(this: DomEvent*, bubbles: bool):
    this.m_bubbles = bubbles

## Ported from Libraries/LibWeb/DOM/Event.h:125 Web::DOM::Event::cancelable.
pub func dom_event_cancelable(this: DomEvent*) -> bool:
    return this.m_cancelable

## Ported from Libraries/LibWeb/DOM/Event.h:126 Web::DOM::Event::set_cancelable.
pub func dom_event_set_cancelable(this: DomEvent*, cancelable: bool):
    this.m_cancelable = cancelable

## Ported from Libraries/LibWeb/DOM/Event.h:128 Web::DOM::Event::is_trusted.
pub func dom_event_is_trusted(this: DomEvent*) -> bool:
    return this.m_is_trusted

## Ported from Libraries/LibWeb/DOM/Event.h:129 Web::DOM::Event::set_is_trusted.
pub func dom_event_set_is_trusted(this: DomEvent*, is_trusted: bool):
    this.m_is_trusted = is_trusted

## Ported from Libraries/LibWeb/DOM/Event.h:131 Web::DOM::Event::stop_propagation.
pub func dom_event_stop_propagation(this: DomEvent*):
    this.m_stop_propagation = true

## Ported from Libraries/LibWeb/DOM/Event.h:133 Web::DOM::Event::cancel_bubble.
pub func dom_event_cancel_bubble(this: DomEvent*) -> bool:
    return this.m_stop_propagation

## Ported from Libraries/LibWeb/DOM/Event.h:134 Web::DOM::Event::set_cancel_bubble.
pub func dom_event_set_cancel_bubble(this: DomEvent*, cancel_bubble: bool):
    if cancel_bubble:
        this.m_stop_propagation = true

## Ported from Libraries/LibWeb/DOM/Event.h:140 Web::DOM::Event::stop_immediate_propagation.
pub func dom_event_stop_immediate_propagation(this: DomEvent*):
    this.m_stop_propagation = true
    this.m_stop_immediate_propagation = true

## Ported from Libraries/LibWeb/DOM/Event.h:148 Web::DOM::Event::set_time_stamp.
pub func dom_event_set_time_stamp(this: DomEvent*, time_stamp: f64):
    this.m_time_stamp = time_stamp

## Ported from Libraries/LibWeb/DOM/Event.h:155 Web::DOM::Event::is_mouse_event (virtual).
pub func dom_event_is_mouse_event_impl(this: DomEvent*) -> bool:
    return false

## Ported from Libraries/LibWeb/DOM/Event.h:156 Web::DOM::Event::is_pointer_event (virtual).
pub func dom_event_is_pointer_event_impl(this: DomEvent*) -> bool:
    return false

## Ported from Libraries/LibWeb/DOM/Event.h:165 Web::DOM::Event::is_dom_event (virtual).
pub func dom_event_is_dom_event_impl(this: DomEvent*) -> bool:
    return true

# mark: Flags and initialization ================================================================

## Ported from Libraries/LibWeb/DOM/Event.cpp:107 Web::DOM::Event::set_cancelled_flag.
pub func dom_event_set_cancelled_flag(this: DomEvent*):
    if this.m_cancelable and not this.m_in_passive_listener:
        this.m_cancelled = true

## Ported from Libraries/LibWeb/DOM/Event.cpp:114 Web::DOM::Event::initialize_event.
## https://dom.spec.whatwg.org/#concept-event-initialize
pub func dom_event_initialize_event(this: DomEvent*, type_: ak.String, bubbles: bool, cancelable: bool):
    # 1. Set event’s initialized flag.
    this.m_initialized = true

    # 2. Unset event’s stop propagation flag, stop immediate propagation flag, and canceled flag.
    this.m_stop_propagation = false
    this.m_stop_immediate_propagation = false
    this.m_cancelled = false

    # 3. Set event’s isTrusted attribute to false.
    this.m_is_trusted = false

    # 4. Set event’s target to null.
    this.m_target = none

    # 5. Set event’s type attribute to type.
    this.m_type = ak.fly_string_from_string(type_)

    # 6. Set event’s bubbles attribute to bubbles.
    this.m_bubbles = bubbles

    # 8. Set event’s cancelable attribute to cancelable.
    this.m_cancelable = cancelable

## Ported from Libraries/LibWeb/DOM/Event.cpp:141 Web::DOM::Event::init_event.
## https://dom.spec.whatwg.org/#dom-event-initevent
pub func dom_event_init_event(this: DomEvent*, type_: ak.String, bubbles: bool, cancelable: bool):
    # 1. If this’s dispatch flag is set, then return.
    if this.m_dispatch:
        return

    # 2. Initialize this with type, bubbles, and cancelable.
    dom_event_initialize_event(this, type_, bubbles, cancelable)

# mark: composedPath() ==========================================================================

## Ported from Libraries/LibWeb/DOM/Event.cpp:152 Web::DOM::Event::composed_path.
## https://dom.spec.whatwg.org/#dom-event-composedpath
## The hidden-subtree levels are size_t in C++ and wrap below zero; so do these.
pub func dom_event_composed_path(this: DomEvent*) -> ak.Vector[DomEventTarget*?]:
    # 1. Let composedPath be an empty list.
    var composed_path: ak.Vector[DomEventTarget*?]

    # 2. Let path be this’s path. (NOTE: Not necessary)

    # 3. If path is empty, then return composedPath.
    if ak.vector_is_empty(&this.m_path):
        return composed_path

    # 4. Let currentTarget be this’s currentTarget attribute value. (NOTE: Not necessary)

    # 5. Assert: currentTarget is an EventTarget object.
    let current_target = this.m_current_target else trap("VERIFY: composedPath without a current target")

    # 6. Append currentTarget to composedPath.
    # NOTE: If path is not empty, then the event is being dispatched and will have a currentTarget.
    ak.vector_append_t(&composed_path, current_target)

    # 7. Let currentTargetIndex be 0.
    var current_target_index: usize = 0

    # 8. Let currentTargetHiddenSubtreeLevel be 0.
    var current_target_hidden_subtree_level: usize = 0

    # 9. Let index be path’s size − 1.
    # 10. While index is greater than or equal to 0:
    var index = (isize)ak.vector_size(&this.m_path) - 1
    while index >= 0:
        let path_entry = ak.vector_at(&this.m_path, (usize)index)

        # 1. If path[index]'s root-of-closed-tree is true, then increase currentTargetHiddenSubtreeLevel by 1.
        if path_entry.root_of_closed_tree:
            current_target_hidden_subtree_level = current_target_hidden_subtree_level +% 1

        # 2. If path[index]'s invocation target is currentTarget, then set currentTargetIndex to index and break.
        if path_entry.invocation_target == this.m_current_target:
            current_target_index = (usize)index
            break

        # 3. If path[index]'s slot-in-closed-tree is true, then decrease currentTargetHiddenSubtreeLevel by 1.
        if path_entry.slot_in_closed_tree:
            current_target_hidden_subtree_level = current_target_hidden_subtree_level -% 1

        # 4. Decrease index by 1.
        index -= 1

    # 11. Let currentHiddenLevel and maxHiddenLevel be currentTargetHiddenSubtreeLevel.
    var current_hidden_level = current_target_hidden_subtree_level
    var max_hidden_level = current_target_hidden_subtree_level

    # 12. Set index to currentTargetIndex − 1.
    # 13. While index is greater than or equal to 0:
    index = (isize)current_target_index - 1
    while index >= 0:
        let path_entry = ak.vector_at(&this.m_path, (usize)index)

        # 1. If path[index]'s root-of-closed-tree is true, then increase currentHiddenLevel by 1.
        if path_entry.root_of_closed_tree:
            current_hidden_level = current_hidden_level +% 1

        # 2. If currentHiddenLevel is less than or equal to maxHiddenLevel, then prepend path[index]'s invocation target to composedPath.
        if current_hidden_level <= max_hidden_level:
            let invocation_target = path_entry.invocation_target else trap("VERIFY: a path entry without an invocation target")
            ak.vector_prepend_u(&composed_path, invocation_target)

        # 3. If path[index]'s slot-in-closed-tree is true, then:
        if path_entry.slot_in_closed_tree:
            # 1. Decrease currentHiddenLevel by 1.
            current_hidden_level = current_hidden_level -% 1

            # 2. If currentHiddenLevel is less than maxHiddenLevel, then set maxHiddenLevel to currentHiddenLevel.
            if current_hidden_level < max_hidden_level:
                max_hidden_level = current_hidden_level

        # 4. Decrease index by 1.
        index -= 1

    # 14. Set currentHiddenLevel and maxHiddenLevel to currentTargetHiddenSubtreeLevel.
    current_hidden_level = current_target_hidden_subtree_level
    max_hidden_level = current_target_hidden_subtree_level

    # 15. Set index to currentTargetIndex + 1.
    # 16. While index is less than path’s size:
    for forward_index in current_target_index + 1..<ak.vector_size(&this.m_path):
        let path_entry = ak.vector_at(&this.m_path, forward_index)

        # 1. If path[index]'s slot-in-closed-tree is true, then increase currentHiddenLevel by 1.
        if path_entry.slot_in_closed_tree:
            current_hidden_level = current_hidden_level +% 1

        # 2. If currentHiddenLevel is less than or equal to maxHiddenLevel, then append path[index]'s invocation target to composedPath.
        if current_hidden_level <= max_hidden_level:
            let invocation_target = path_entry.invocation_target else trap("VERIFY: a path entry without an invocation target")
            ak.vector_append_t(&composed_path, invocation_target)

        # 3. If path[index]'s root-of-closed-tree is true, then:
        if path_entry.root_of_closed_tree:
            # 1. Decrease currentHiddenLevel by 1.
            current_hidden_level = current_hidden_level -% 1

            # 2. If currentHiddenLevel is less than maxHiddenLevel, then set maxHiddenLevel to currentHiddenLevel.
            if current_hidden_level < max_hidden_level:
                max_hidden_level = current_hidden_level

        # 4. Increase index by 1.

    # 17. Return composedPath.
    return composed_path

## Ported from Libraries/LibWeb/DOM/Event.cpp:270 Web::DOM::Event::current_target_for_bindings.
## AD-HOC: Needed to return a WindowProxy when the current target is a Window,
## ensuring that JavaScript sees the correct global object instead of the internal Window.
pub func dom_event_current_target_for_bindings(this: DomEvent*) -> DomEventTarget*?:
    if let current_target = this.m_current_target:
        if let window = as_if_html_window(current_target):
            return html_window_window(window).dom_event_target()
    return this.m_current_target