Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-browser-engine

Source of release 0.6.0

0.6.0 / src / web / painting / scrollbar.lucb

#==============================================================================================
#
#   scrollbar - Painting::Scrollbar: the chrome widget of a scroll container's scrollbar
#
#   DESCRIPTION:
#       Port of Libraries/LibWeb/Painting/Scrollbar.cpp (lines 1-131) and Scrollbar.h: hit
#       testing a scrollbar, dragging its thumb (pointer down captures, moves scroll, pointer up
#       releases) and the hovered state that widens it. `Scrollbar::mouse_down` is declared in
#       the header but never defined in C++, so it has no port.
#
#       Copyright (c) 2026, the Ladybird developers.
#       SPDX-License-Identifier: BSD-2-Clause
#
#==============================================================================================

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:19 Web::Painting::Scrollbar::create.
pub func paint_scrollbar_create(heap: gc.Heap*, paintable_box: PaintPaintableBox*, direction: PaintPaintableBoxScrollDirection) -> PaintScrollbar*:
    let this = (PaintScrollbar*)web_heap_allocate_cell(heap, &paint_scrollbar_class)
    gc.heap_defer_gc(heap)
    paint_scrollbar_construct(this, paintable_box, direction)
    gc.heap_undefer_gc(heap)
    return this

## Ported from Libraries/LibWeb/Painting/Scrollbar.h:21 Web::Painting::Scrollbar::direction.
pub func paint_scrollbar_direction(this: PaintScrollbar*) -> PaintPaintableBoxScrollDirection:
    return this.m_direction

## Ported from Libraries/LibWeb/Painting/Scrollbar.h:22 Web::Painting::Scrollbar::is_enlarged.
pub func paint_scrollbar_is_enlarged(this: PaintScrollbar*) -> bool:
    return this.m_hovered or this.m_thumb_grab_position != none

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:24 Web::Painting::Scrollbar::Scrollbar.
pub func paint_scrollbar_construct(this: PaintScrollbar*, paintable_box: PaintPaintableBox*, direction: PaintPaintableBoxScrollDirection):
    this.m_paintable_box = paintable_box
    this.m_direction = direction

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:30 Web::Painting::Scrollbar::visit_edges (override).
pub func paint_scrollbar_visit_edges_impl(base: gc.Cell*, visitor: gc.CellVisitor*):
    let this = (PaintScrollbar*)base
    gc.cell_visit_edges_impl(base, visitor)
    gc.cell_visitor_visit_t_2(visitor, this.m_paintable_box)

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:36 Web::Painting::Scrollbar::contains.
pub func paint_scrollbar_contains(this: PaintScrollbar*, position: gfx.CssPixelPoint, metrics: ChromeMetrics) -> bool:
    if let rect = paint_paintable_box_absolute_scrollbar_rect(this.m_paintable_box, this.m_direction, paint_scrollbar_is_enlarged(this), metrics):
        return gfx.css_pixel_rect_contains_css_pixel_point(&rect, position)
    return false

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:43 Web::Painting::Scrollbar::handle_pointer_event (override).
pub func paint_scrollbar_handle_pointer_event_impl(base: PaintChromeWidget*, type_: ak.FlyString, button: u32, visual_viewport_position: gfx.CssPixelPoint) -> PaintMouseAction:
    let this = (PaintScrollbar*)base
    if ak.fly_string_eq_fly_string(&type_, &ui_events_event_names_pointermove):
        if this.m_thumb_grab_position == none:
            return PaintMouseAction.none_
    elif button != (u32)UiEventsMouseButton.primary:
        return PaintMouseAction.none_

    let position = paint_paintable_box_transform_to_local_coordinates(this.m_paintable_box, visual_viewport_position)
    paint_scrollbar_scroll_to_mouse_position(this, position)
    paint_paintable_set_needs_repaint(this.m_paintable_box.paint_paintable(), InvalidateDisplayList.yes)

    if ak.fly_string_eq_fly_string(&type_, &ui_events_event_names_pointerup):
        this.m_thumb_grab_position = none
        return PaintMouseAction.none_

    return PaintMouseAction.capture_input

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:64 Web::Painting::Scrollbar::mouse_move.
pub func paint_scrollbar_mouse_move(this: PaintScrollbar*, position: gfx.CssPixelPoint) -> PaintMouseAction:
    if this.m_thumb_grab_position != none:
        let local_position = paint_paintable_box_transform_to_local_coordinates(this.m_paintable_box, position)
        paint_scrollbar_scroll_to_mouse_position(this, local_position)
        return PaintMouseAction.swallow_event
    return PaintMouseAction.none_

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:74 Web::Painting::Scrollbar::mouse_up.
pub func paint_scrollbar_mouse_up(this: PaintScrollbar*, arg0: gfx.CssPixelPoint, button: u32) -> PaintMouseAction:
    this.m_thumb_grab_position = none
    paint_paintable_set_needs_repaint(this.m_paintable_box.paint_paintable(), InvalidateDisplayList.yes)
    return PaintMouseAction.none_

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:81 Web::Painting::Scrollbar::mouse_enter (override).
pub func paint_scrollbar_mouse_enter_impl(base: PaintChromeWidget*):
    let this = (PaintScrollbar*)base
    if this.m_hovered:
        return
    this.m_hovered = true
    paint_paintable_set_needs_repaint(this.m_paintable_box.paint_paintable(), InvalidateDisplayList.yes)

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:89 Web::Painting::Scrollbar::mouse_leave (override).
pub func paint_scrollbar_mouse_leave_impl(base: PaintChromeWidget*):
    let this = (PaintScrollbar*)base
    if not this.m_hovered:
        return
    this.m_hovered = false
    paint_paintable_set_needs_repaint(this.m_paintable_box.paint_paintable(), InvalidateDisplayList.yes)

## Ported from Libraries/LibWeb/Painting/Scrollbar.cpp:97 Web::Painting::Scrollbar::scroll_to_mouse_position.
pub func paint_scrollbar_scroll_to_mouse_position(this: PaintScrollbar*, position: gfx.CssPixelPoint):
    let document = paint_paintable_document(this.m_paintable_box.paint_paintable())
    let metrics = page_chrome_metrics(dom_document_page(document))

    let viewport_paintable = dom_document_paintable(document) else trap("the document has no paintable")
    let scroll_state = paint_viewport_paintable_scroll_state_snapshot(viewport_paintable)
    let scrollbar_data = paint_paintable_box_compute_scrollbar_data(this.m_paintable_box, this.m_direction, metrics, &scroll_state) else trap("VERIFY: scrollbar_data.has_value()")

    let orientation = gfx.Orientation.horizontal if this.m_direction == PaintPaintableBoxScrollDirection.horizontal else gfx.Orientation.vertical
    let gutter_location = gfx.css_pixel_rect_location(&scrollbar_data.gutter_rect)
    let relative_to_gutter = gfx.css_pixel_point_sub(&position, gutter_location)
    let offset_relative_to_gutter = gfx.css_pixel_point_primary_offset_for_orientation(&relative_to_gutter, orientation)
    let gutter_size = gfx.css_pixel_rect_primary_size_for_orientation(&scrollbar_data.gutter_rect, orientation)
    let thumb_size = gfx.css_pixel_rect_primary_size_for_orientation(&scrollbar_data.thumb_rect, orientation)

    if gutter_size.lt(thumb_size):
        return

    if this.m_thumb_grab_position == none:
        if gfx.css_pixel_rect_contains_css_pixel_point(&scrollbar_data.thumb_rect, position):
            let relative_to_thumb = gfx.css_pixel_point_sub(&position, gfx.css_pixel_rect_location(&scrollbar_data.thumb_rect))
            this.m_thumb_grab_position = gfx.css_pixel_point_primary_offset_for_orientation(&relative_to_thumb, orientation)
        else:
            let half_thumb_size = gfx.div_css_pixels_int(thumb_size, 2)
            this.m_thumb_grab_position = ak.max(ak.min(offset_relative_to_gutter, gfx.css_pixel_fraction_to_css_pixels(&half_thumb_size)), offset_relative_to_gutter.sub(gutter_size).add(thumb_size))

    let thumb_grab_position = this.m_thumb_grab_position else trap("VERIFY: m_thumb_grab_position.has_value()")
    let constrained_offset = ak.clamp(offset_relative_to_gutter.sub(thumb_grab_position), gfx.CssPixels.from_int(0), gutter_size.sub(thumb_size))
    let scroll_position = constrained_offset.to_double() / gutter_size.sub(thumb_size).to_double()

    let scrollable_overflow_rect = paint_paintable_box_scrollable_overflow_rect(this.m_paintable_box) else trap("VERIFY: no scrollable overflow rect")
    let scrollable_overflow_size = gfx.css_pixel_rect_primary_size_for_orientation(&scrollable_overflow_rect, orientation)
    let padding_box_rect = paint_paintable_box_absolute_padding_box_rect(this.m_paintable_box)
    let padding_size = gfx.css_pixel_rect_primary_size_for_orientation(&padding_box_rect, orientation)
    # scroll_position * (scrollable_overflow_size - padding_size): double * CSSPixels is a double.
    let scroll_position_in_pixels = gfx.css_pixels_nearest_value_for_f64(gfx.mul_f64(scroll_position, scrollable_overflow_size.sub(padding_size)))

    var new_scroll_offset = paint_paintable_box_scroll_offset(this.m_paintable_box)
    gfx.css_pixel_point_set_primary_offset_for_orientation(&new_scroll_offset, orientation, scroll_position_in_pixels)
    _ = paint_paintable_box_set_scroll_offset(this.m_paintable_box, new_scroll_offset)