Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-browser-engine

Source of release 0.6.0

0.6.0 / src / web / css / url.lucb

#==============================================================================================
#
#   url - URL and RequestURLModifier: <url> values and their request modifiers
#
#   DESCRIPTION:
#       Port of LibWeb/CSS/URL.cpp (lines 1-145) and the inline members of URL.h. The
#       defaulted operator==s are css_url_eq and css_request_url_modifier_eq; the lambda that
#       maps a referrer-policy modifier to a ReferrerPolicy is a function of its own.
#
#       Copyright (c) 2025, Sam Atkins <sam@ladybird.org>
#       SPDX-License-Identifier: BSD-2-Clause
#
#==============================================================================================

# mark: URL =====================================================================================

## Ported from Libraries/LibWeb/CSS/URL.cpp:14 Web::CSS::URL::URL.
pub func css_url_construct(this: CssUrl*, url: ak.String, type_: CssUrlType = CssUrlType.url, request_url_modifiers: ak.Vector[CssRequestUrlModifier]):
    this.m_type = type_
    this.m_url = url
    this.m_request_url_modifiers = request_url_modifiers

## Ported from Libraries/LibWeb/CSS/URL.h:55 Web::CSS::URL::url.
pub func css_url_url(this: const CssUrl*) -> ak.String:
    return this.m_url

## Ported from Libraries/LibWeb/CSS/URL.h:56 Web::CSS::URL::request_url_modifiers.
pub func css_url_request_url_modifiers(this: const CssUrl*) -> ak.Vector[CssRequestUrlModifier]:
    return this.m_request_url_modifiers

## Ported from Libraries/LibWeb/CSS/URL.cpp:22 Web::CSS::URL::to_string.
# https://drafts.csswg.org/cssom-1/#serialize-a-url
pub func css_url_to_string(this: const CssUrl*) -> ak.String:
    # To serialize a URL means to create a string represented by "url(", followed by the serialization of the URL as a
    # string, followed by ")".
    # AD-HOC: Serialize as src() if it was declared as that.
    var builder = ak.string_builder_new()
    match this.m_type:
        .url: ak.string_builder_append(&builder, "url(")
        .src: ak.string_builder_append(&builder, "src(")
        _: trap("VERIFY_NOT_REACHED")
    css_syntax.serialize_a_string_string_builder(&builder, ak.string_bytes_as_string_view(&this.m_url))

    # AD-HOC: Serialize the RequestURLModifiers
    # Spec issue: https://github.com/w3c/csswg-drafts/issues/12057
    for modifier in ak.vector_span_const(&this.m_request_url_modifiers):
        let modifier_string = css_request_url_modifier_to_string(&modifier)
        ak.string_builder_append(&builder, " ")
        ak.string_builder_append_string_view(&builder, ak.string_bytes_as_string_view(&modifier_string))
    ak.string_builder_append_u8(&builder, ')')
    return ak.string_builder_to_string_without_validation(&builder)

## Ported from Libraries/LibWeb/CSS/URL.cpp:48 Web::CSS::URL::operator== (defaulted).
pub func css_url_eq(this: const CssUrl*, arg0: CssUrl) -> bool:
    if this.m_type != arg0.m_type:
        return false
    if not ak.string_equals(&this.m_url, &arg0.m_url):
        return false
    let size = ak.vector_size(&this.m_request_url_modifiers)
    if size != ak.vector_size(&arg0.m_request_url_modifiers):
        return false
    for i in 0..<size:
        let modifier = ak.vector_at_const(&this.m_request_url_modifiers, i)
        if not css_request_url_modifier_eq(modifier, *ak.vector_at_const(&arg0.m_request_url_modifiers, i)):
            return false
    return true

# mark: RequestURLModifier ======================================================================

## Ported from Libraries/LibWeb/CSS/URL.cpp:50 Web::CSS::RequestURLModifier::create_cross_origin.
pub func css_request_url_modifier_create_cross_origin(value: css_data.CrossOriginModifierValue) -> CssRequestUrlModifier:
    return css_request_url_modifier_new(CssRequestUrlModifierType.cross_origin, .cross_origin_modifier_value(value))

## Ported from Libraries/LibWeb/CSS/URL.cpp:55 Web::CSS::RequestURLModifier::create_integrity.
pub func css_request_url_modifier_create_integrity(value: ak.FlyString) -> CssRequestUrlModifier:
    return css_request_url_modifier_new(CssRequestUrlModifierType.integrity, .fly_string(value))

## Ported from Libraries/LibWeb/CSS/URL.cpp:60 Web::CSS::RequestURLModifier::create_referrer_policy.
pub func css_request_url_modifier_create_referrer_policy(value: css_data.ReferrerPolicyModifierValue) -> CssRequestUrlModifier:
    return css_request_url_modifier_new(CssRequestUrlModifierType.referrer_policy, .referrer_policy_modifier_value(value))

## Ported from Libraries/LibWeb/CSS/URL.cpp:65 Web::CSS::RequestURLModifier::RequestURLModifier.
pub func css_request_url_modifier_construct(this: CssRequestUrlModifier*, type_: CssRequestUrlModifierType, value: css_data.CssRequestUrlModifierValue):
    this.m_type = type_
    this.m_value = value

## `RequestURLModifier { type, value }` as a value.
func css_request_url_modifier_new(type_: CssRequestUrlModifierType, value: css_data.CssRequestUrlModifierValue) -> CssRequestUrlModifier:
    var modifier: CssRequestUrlModifier = ---
    css_request_url_modifier_construct(&modifier, type_, value)
    return modifier

## Ported from Libraries/LibWeb/CSS/URL.cpp:71 Web::CSS::RequestURLModifier::modify_request.
pub func css_request_url_modifier_modify_request(this: const CssRequestUrlModifier*, request: FetchRequest*):
    match this.m_type:
        .cross_origin:
            # https://drafts.csswg.org/css-values-5/#typedef-request-url-modifier-crossorigin-modifier
            # The URL request modifier steps for this modifier given request req are:

            # 1. Set req’s mode to "cors".
            fetch_request_set_mode(request, FetchRequestMode.cors)

            # 2. If the given value is use-credentials, set req’s credentials mode to "include".
            if css_request_url_modifier_value_is(this, css_data.CrossOriginModifierValue.use_credentials):
                fetch_request_set_credentials_mode(request, FetchRequestCredentialsMode.include)
            # 3. Otherwise, set req’s credentials mode to "same-origin".
            else:
                fetch_request_set_credentials_mode(request, FetchRequestCredentialsMode.same_origin)
        .integrity:
            # https://drafts.csswg.org/css-values-5/#typedef-request-url-modifier-integrity-modifier
            # The URL request modifier steps for this modifier given request req are to set request’s integrity metadata to
            # the given <string>.
            match this.m_value:
                .fly_string(value): fetch_request_set_integrity_metadata(request, ak.fly_string_to_string_const(&value))
                _: trap("VERIFY: a FlyString")
        .referrer_policy:
            # https://drafts.csswg.org/css-values-5/#typedef-request-url-modifier-referrerpolicy-modifier
            # The URL request modifier steps for this modifier given request req are to set request’s referrer policy to the
            # ReferrerPolicy that matches the given value.
            match this.m_value:
                .referrer_policy_modifier_value(value): fetch_request_set_referrer_policy(request, css_request_url_modifier_referrer_policy(value))
                _: trap("VERIFY: a ReferrerPolicyModifierValue")
        _: trap("VERIFY_NOT_REACHED")

## `m_value == value` for a CrossOriginModifierValue (Variant::operator== with an alternative).
func css_request_url_modifier_value_is(this: const CssRequestUrlModifier*, value: css_data.CrossOriginModifierValue) -> bool:
    match this.m_value:
        .cross_origin_modifier_value(held): return held == value
        _: return false

## modify_request's lambda: the ReferrerPolicy of a referrer-policy() modifier value.
func css_request_url_modifier_referrer_policy(value: css_data.ReferrerPolicyModifierValue) -> ReferrerPolicyReferrerPolicy:
    match value:
        .no_referrer: return ReferrerPolicyReferrerPolicy.no_referrer
        .no_referrer_when_downgrade: return ReferrerPolicyReferrerPolicy.no_referrer_when_downgrade
        .same_origin: return ReferrerPolicyReferrerPolicy.same_origin
        .origin: return ReferrerPolicyReferrerPolicy.origin
        .strict_origin: return ReferrerPolicyReferrerPolicy.strict_origin
        .origin_when_cross_origin: return ReferrerPolicyReferrerPolicy.origin_when_cross_origin
        .strict_origin_when_cross_origin: return ReferrerPolicyReferrerPolicy.strict_origin_when_cross_origin
        .unsafe_url: return ReferrerPolicyReferrerPolicy.unsafe_url
        _: trap("VERIFY_NOT_REACHED")

## Ported from Libraries/LibWeb/CSS/URL.h:33 Web::CSS::RequestURLModifier::type.
pub func css_request_url_modifier_type(this: const CssRequestUrlModifier*) -> CssRequestUrlModifierType:
    return this.m_type

## Ported from Libraries/LibWeb/CSS/URL.cpp:130 Web::CSS::RequestURLModifier::to_string.
pub func css_request_url_modifier_to_string(this: const CssRequestUrlModifier*) -> ak.String:
    var builder = ak.string_builder_new()
    match this.m_value:
        .cross_origin_modifier_value(value):
            assert(this.m_type == CssRequestUrlModifierType.cross_origin)
            ak.string_builder_append(&builder, "cross-origin(")
            ak.string_builder_append_string_view(&builder, css_data.to_string_cross_origin_modifier_value(value))
        .fly_string(value):
            assert(this.m_type == CssRequestUrlModifierType.integrity)
            let serialized = css_syntax.serialize_a_string_string_view(ak.fly_string_bytes_as_string_view(&value))
            ak.string_builder_append(&builder, "integrity(")
            ak.string_builder_append_string_view(&builder, ak.string_bytes_as_string_view(&serialized))
        .referrer_policy_modifier_value(value):
            assert(this.m_type == CssRequestUrlModifierType.referrer_policy)
            ak.string_builder_append(&builder, "referrer-policy(")
            ak.string_builder_append_string_view(&builder, css_data.to_string_referrer_policy_modifier_value(value))
    ak.string_builder_append(&builder, ")")
    return ak.string_builder_to_string(&builder) else trap("MUST: String::formatted")

## Ported from Libraries/LibWeb/CSS/URL.cpp:143 Web::CSS::RequestURLModifier::operator== (defaulted).
pub func css_request_url_modifier_eq(this: const CssRequestUrlModifier*, arg0: CssRequestUrlModifier) -> bool:
    if this.m_type != arg0.m_type:
        return false
    match this.m_value:
        .cross_origin_modifier_value(value):
            match arg0.m_value:
                .cross_origin_modifier_value(other): return value == other
                _: return false
        .referrer_policy_modifier_value(value):
            match arg0.m_value:
                .referrer_policy_modifier_value(other): return value == other
                _: return false
        .fly_string(value):
            match arg0.m_value:
                .fly_string(other): return ak.fly_string_eq_fly_string(&value, &other)
                _: return false