ladybird/Libraries/LibWeb/CSS/CSSRule.h

/*
 * Copyright (c) 2021, the SerenityOS developers.
 * Copyright (c) 2022, Andreas Kling <andreas@ladybird.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <AK/String.h>
#include <LibJS/Heap/GCPtr.h>
#include <LibWeb/Bindings/PlatformObject.h>
#include <LibWeb/CSS/CSSStyleDeclaration.h>
#include <LibWeb/CSS/Selector.h>
#include <LibWeb/WebIDL/Types.h>

namespace Web::CSS {

class CSSRule : public Bindings::PlatformObject {
    WEB_PLATFORM_OBJECT(CSSRule, Bindings::PlatformObject);

public:
    virtual ~CSSRule() = default;

    // https://drafts.csswg.org/cssom/#dom-cssrule-type
    enum class Type : WebIDL::UnsignedShort {
        Style = 1,
        Import = 3,
        Media = 4,
        FontFace = 5,
        Keyframes = 7,
        Keyframe = 8,
        Namespace = 10,
        Supports = 12,
        // AD-HOC: These are not included in the spec, but we need them internally. So, their numbers are arbitrary.
        LayerBlock = 100,
        LayerStatement = 101,
        NestedDeclarations = 102,
        Property = 103,
    };

    Type type() const { return m_type; }
    WebIDL::UnsignedShort type_for_bindings() const;

    String css_text() const;
    void set_css_text(StringView);

    CSSRule* parent_rule() { return m_parent_rule.ptr(); }
    CSSRule const* parent_rule() const { return m_parent_rule.ptr(); }
    void set_parent_rule(CSSRule*);

    CSSStyleSheet* parent_style_sheet() { return m_parent_style_sheet.ptr(); }
    virtual void set_parent_style_sheet(CSSStyleSheet*);

    template<typename T>
    bool fast_is() const = delete;

    // https://drafts.csswg.org/cssom-1/#serialize-a-css-rule
    virtual String serialized() const = 0;

    virtual void clear_caches();

protected:
    explicit CSSRule(JS::Realm&, Type);

    virtual void visit_edges(Cell::Visitor&) override;

    [[nodiscard]] FlyString const& parent_layer_internal_qualified_name() const
    {
        if (!m_cached_layer_name.has_value())
            return parent_layer_internal_qualified_name_slow_case();
        return m_cached_layer_name.value();
    }

    [[nodiscard]] FlyString const& parent_layer_internal_qualified_name_slow_case() const;

    Type m_type;
    JS::GCPtr<CSSRule> m_parent_rule;
    JS::GCPtr<CSSStyleSheet> m_parent_style_sheet;

    mutable Optional<FlyString> m_cached_layer_name;
};

}