Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-browser-engine

Source of release 0.6.0

0.6.0 / src / web / css / media_list.lucb

#==============================================================================================
#
#   media_list - CSS::MediaList: the media query list of a style sheet or an @media/@import
#
#   DESCRIPTION:
#       Port of LibWeb/CSS/MediaList.cpp (lines 1-170) and the inline members of MediaList.h
#       (lines 19-49): mediaText, item(), appendMedium(), deleteMedium(), evaluation against a
#       document, and the dump.
#
#       Copyright (c) 2021-2025, Sam Atkins <sam@ladybird.org>
#       Copyright (c) 2022-2023, Andreas Kling <andreas@ladybird.org>
#       SPDX-License-Identifier: BSD-2-Clause
#
#==============================================================================================

# mark: Construction ============================================================================

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:22 Web::CSS::MediaList::create.
pub func css_media_list_create(realm: Realm*, media: ak.Vector[CssMediaQuery*]) -> CssMediaList*:
    return realm_create_css_media_list(realm, realm, media)

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:27 Web::CSS::MediaList::MediaList.
pub func css_media_list_construct(this: CssMediaList*, realm: Realm*, media: ak.Vector[CssMediaQuery*]):
    bind_platform_object_construct_realm(this.bind_platform_object(), realm)
    this.m_media = media
    this.platform_object.m_legacy_platform_object_flags = BindPlatformObjectLegacyPlatformObjectFlags(supports_indexed_properties = 1)

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:34 Web::CSS::MediaList::initialize (override).
pub func css_media_list_initialize_impl(base: JsCell*, realm: Realm*):
    web_set_prototype_for_interface(base, realm, BindInterfaceName.media_list)
    js_cell_initialize_impl(base, realm)

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:40 Web::CSS::MediaList::visit_edges (override).
pub func css_media_list_visit_edges_impl(base: gc.Cell*, visitor: gc.CellVisitor*):
    let this = (CssMediaList*)base
    bind_platform_object_visit_edges_impl(base, visitor)
    gc.cell_visitor_visit_t(visitor, this.m_associated_style_sheet)

# mark: The MediaList interface =================================================================

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:47 Web::CSS::MediaList::media_text.
# https://www.w3.org/TR/cssom-1/#dom-medialist-mediatext
pub func css_media_list_media_text(this: CssMediaList*) -> ak.String:
    return css_serialize_a_media_query_list(this.m_media)

## The previous effects of the associated style sheet, if there is one (the C++ initializer of
## `previous_sheet_effects` in set_media_text, append_medium and delete_medium).
func css_media_list_previous_sheet_effects(this: CssMediaList*) -> CssShadowRootStylesheetEffects?:
    if let sheet = this.m_associated_style_sheet:
        return css_determine_shadow_root_stylesheet_effects_css_css_style_sheet(as_css_css_style_sheet(sheet))
    return none

## Invalidate the owners of the associated style sheet, if there is one, for `reason`.
func css_media_list_invalidate_associated_style_sheet(this: CssMediaList*, reason: DomStyleInvalidationReason, previous_sheet_effects: CssShadowRootStylesheetEffects?):
    let sheet = this.m_associated_style_sheet else return
    if let effects = previous_sheet_effects:
        css_css_style_sheet_invalidate_owners(as_css_css_style_sheet(sheet), reason, &effects)
    else:
        css_css_style_sheet_invalidate_owners(as_css_css_style_sheet(sheet), reason, none)

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:53 Web::CSS::MediaList::set_media_text.
# https://www.w3.org/TR/cssom-1/#dom-medialist-mediatext
pub func css_media_list_set_media_text(this: CssMediaList*, text: ak.StringView):
    let previous_sheet_effects = css_media_list_previous_sheet_effects(this)

    # ScopeGuard guard = [&] { ... invalidate_owners(MediaListSetMediaText, ...) };
    defer css_media_list_invalidate_associated_style_sheet(this, DomStyleInvalidationReason.media_list_set_media_text, previous_sheet_effects)

    ak.vector_clear(&this.m_media)
    if ak.string_view_is_empty(&text):
        return
    var parsing_params: CssParsingParams = ---
    css_parsing_params_construct_realm_css_parsing_mode(&parsing_params, bind_platform_object_realm(this.bind_platform_object()))
    this.m_media = parse_media_query_list(parsing_params, text)

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:71 Web::CSS::MediaList::item.
# https://www.w3.org/TR/cssom-1/#dom-medialist-item
pub func css_media_list_item(this: CssMediaList*, index: u32) -> ak.String?:
    if (usize)index >= ak.vector_size(&this.m_media):
        return none

    return css_media_query_to_string(*ak.vector_at(&this.m_media, (usize)index))

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:80 Web::CSS::MediaList::append_medium.
# https://www.w3.org/TR/cssom-1/#dom-medialist-appendmedium
pub func css_media_list_append_medium(this: CssMediaList*, medium: ak.StringView):
    # 1. Let m be the result of parsing the given value.
    var parsing_params: CssParsingParams = ---
    css_parsing_params_construct_realm_css_parsing_mode(&parsing_params, bind_platform_object_realm(this.bind_platform_object()))

    # 2. If m is null, then return.
    let m = parse_media_query(parsing_params, medium) else return

    # 3. If comparing m with any of the media queries in the collection of media queries returns true, then return.
    let serialized = css_media_query_to_string(m)
    for existing_medium in ak.vector_span(&this.m_media):
        let existing_serialized = css_media_query_to_string(existing_medium)
        if ak.string_equals(&existing_serialized, &serialized):
            return

    let previous_sheet_effects = css_media_list_previous_sheet_effects(this)

    # 4. Append m to the collection of media queries.
    ak.vector_append_t(&this.m_media, m)

    css_media_list_invalidate_associated_style_sheet(this, DomStyleInvalidationReason.media_list_append_medium, previous_sheet_effects)

## The predicate of delete_medium's remove_all_matching: `m->to_string() == existing->to_string()`.
func css_media_list_delete_medium_matches(context: void*?, existing: const (CssMediaQuery*)*) -> bool:
    let m = (CssMediaQuery*)(context else trap("no media query"))
    let serialized = css_media_query_to_string(m)
    let existing_serialized = css_media_query_to_string(*existing)
    return ak.string_equals(&serialized, &existing_serialized)

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:107 Web::CSS::MediaList::delete_medium.
# https://www.w3.org/TR/cssom-1/#dom-medialist-deletemedium
pub func css_media_list_delete_medium(this: CssMediaList*, medium: ak.StringView) -> !:
    # 1. Let m be the result of parsing the given value.
    var parsing_params: CssParsingParams = ---
    css_parsing_params_construct_realm_css_parsing_mode(&parsing_params, bind_platform_object_realm(this.bind_platform_object()))

    # 2. If m is null, then return.
    let m = parse_media_query(parsing_params, medium) else return

    let previous_sheet_effects = css_media_list_previous_sheet_effects(this)

    # 3. Remove any media query from the collection of media queries for which comparing the media query with m
    #    returns true. If nothing was removed, then throw a NotFoundError exception.
    let was_removed = ak.vector_remove_all_matching(&this.m_media, ak.Function1[const (CssMediaQuery*)*, bool](call = css_media_list_delete_medium_matches, context = m))
    if not was_removed:
        try idl_throw(.idl_dom_exception(idl_not_found_error_create(bind_platform_object_realm(this.bind_platform_object()), ak.utf16_string_from_str("Media query not found in list"))))

    css_media_list_invalidate_associated_style_sheet(this, DomStyleInvalidationReason.media_list_delete_medium, previous_sheet_effects)

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:135 Web::CSS::MediaList::evaluate.
pub func css_media_list_evaluate(this: CssMediaList*, document: DomDocument*) -> bool:
    for media in ak.vector_span(&this.m_media):
        _ = css_media_query_evaluate(media, document)

    return css_media_list_matches(this)

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:139 Web::CSS::MediaList::matches.
pub func css_media_list_matches(this: CssMediaList*) -> bool:
    if ak.vector_is_empty(&this.m_media):
        return true

    for media in ak.vector_span(&this.m_media):
        if css_media_query_matches(media):
            return true
    return false

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:155 Web::CSS::MediaList::item_value (override).
pub func css_media_list_item_value_impl(base: BindPlatformObject*, index: usize) -> JsValue?:
    let this = (CssMediaList*)base
    if index >= ak.vector_size(&this.m_media):
        return none
    return js_primitive_string_create_string(js_cell_vm(this.js_cell()), css_media_query_to_string(*ak.vector_at(&this.m_media, index)))

## Ported from Libraries/LibWeb/CSS/MediaList.cpp:162 Web::CSS::MediaList::dump.
pub func css_media_list_dump(this: CssMediaList*, builder: ak.StringBuilder*, indent_levels: i32 = 0):
    dump_indent(builder, indent_levels)
    dump_appendff(builder, "Media list ({}):\n", [ak.arg_u64((u64)ak.vector_size(&this.m_media))])
    for media in ak.vector_span(&this.m_media):
        css_media_query_dump(media, builder, indent_levels + 1)

# mark: MediaList.h =============================================================================

## Ported from Libraries/LibWeb/CSS/MediaList.h:28 Web::CSS::MediaList::length.
pub func css_media_list_length(this: CssMediaList*) -> usize:
    return ak.vector_size(&this.m_media)

## Ported from Libraries/LibWeb/CSS/MediaList.h:38 Web::CSS::MediaList::set_associated_style_sheet.
pub func css_media_list_set_associated_style_sheet(this: CssMediaList*, style_sheet: CssStyleSheet*):
    this.m_associated_style_sheet = style_sheet