mirror of
				https://github.com/LadybirdBrowser/ladybird.git
				synced 2025-10-31 13:20:59 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			917 lines
		
	
	
	
		
			38 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			917 lines
		
	
	
	
		
			38 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
| /*
 | ||
|  * Copyright (c) 2018-2020, Andreas Kling <andreas@ladybird.org>
 | ||
|  * Copyright (c) 2021-2025, Sam Atkins <sam@ladybird.org>
 | ||
|  *
 | ||
|  * SPDX-License-Identifier: BSD-2-Clause
 | ||
|  */
 | ||
| 
 | ||
| #include "Selector.h"
 | ||
| #include <AK/GenericShorthands.h>
 | ||
| #include <LibWeb/CSS/Parser/ErrorReporter.h>
 | ||
| #include <LibWeb/CSS/Serialize.h>
 | ||
| 
 | ||
| namespace Web::CSS {
 | ||
| 
 | ||
| static bool component_value_contains_nesting_selector(Parser::ComponentValue const& component_value)
 | ||
| {
 | ||
|     if (component_value.is_delim('&'))
 | ||
|         return true;
 | ||
| 
 | ||
|     if (component_value.is_block()) {
 | ||
|         for (auto const& child_value : component_value.block().value) {
 | ||
|             if (component_value_contains_nesting_selector(child_value))
 | ||
|                 return true;
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     if (component_value.is_function()) {
 | ||
|         for (auto const& child_value : component_value.function().value) {
 | ||
|             if (component_value_contains_nesting_selector(child_value))
 | ||
|                 return true;
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     return false;
 | ||
| }
 | ||
| 
 | ||
| static bool can_selector_use_fast_matches(Selector const& selector)
 | ||
| {
 | ||
|     for (auto const& compound_selector : selector.compound_selectors()) {
 | ||
|         if (!first_is_one_of(compound_selector.combinator,
 | ||
|                 Selector::Combinator::None, Selector::Combinator::Descendant, Selector::Combinator::ImmediateChild)) {
 | ||
|             return false;
 | ||
|         }
 | ||
| 
 | ||
|         for (auto const& simple_selector : compound_selector.simple_selectors) {
 | ||
|             if (simple_selector.type == Selector::SimpleSelector::Type::PseudoClass) {
 | ||
|                 auto const pseudo_class = simple_selector.pseudo_class().type;
 | ||
|                 if (!first_is_one_of(pseudo_class,
 | ||
|                         PseudoClass::Active,
 | ||
|                         PseudoClass::AnyLink,
 | ||
|                         PseudoClass::Checked,
 | ||
|                         PseudoClass::Disabled,
 | ||
|                         PseudoClass::Empty,
 | ||
|                         PseudoClass::Enabled,
 | ||
|                         PseudoClass::FirstChild,
 | ||
|                         PseudoClass::Focus,
 | ||
|                         PseudoClass::FocusVisible,
 | ||
|                         PseudoClass::FocusWithin,
 | ||
|                         PseudoClass::Hover,
 | ||
|                         PseudoClass::LastChild,
 | ||
|                         PseudoClass::Link,
 | ||
|                         PseudoClass::LocalLink,
 | ||
|                         PseudoClass::OnlyChild,
 | ||
|                         PseudoClass::Root,
 | ||
|                         PseudoClass::State,
 | ||
|                         PseudoClass::Unchecked,
 | ||
|                         PseudoClass::Visited))
 | ||
|                     return false;
 | ||
|             } else if (!first_is_one_of(simple_selector.type,
 | ||
|                            Selector::SimpleSelector::Type::TagName,
 | ||
|                            Selector::SimpleSelector::Type::Universal,
 | ||
|                            Selector::SimpleSelector::Type::Class,
 | ||
|                            Selector::SimpleSelector::Type::Id,
 | ||
|                            Selector::SimpleSelector::Type::Attribute)) {
 | ||
|                 return false;
 | ||
|             }
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     return true;
 | ||
| }
 | ||
| 
 | ||
| Selector::Selector(Vector<CompoundSelector>&& compound_selectors)
 | ||
|     : m_compound_selectors(move(compound_selectors))
 | ||
| {
 | ||
|     // FIXME: This assumes that only one pseudo-element is allowed in a selector, and that it appears at the end.
 | ||
|     //        This is not true in Selectors-4!
 | ||
|     if (!m_compound_selectors.is_empty()) {
 | ||
|         for (auto const& simple_selector : m_compound_selectors.last().simple_selectors) {
 | ||
|             if (simple_selector.type == SimpleSelector::Type::PseudoElement) {
 | ||
|                 m_pseudo_element = simple_selector.pseudo_element();
 | ||
|                 break;
 | ||
|             }
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     // https://drafts.csswg.org/css-nesting-1/#contain-the-nesting-selector
 | ||
|     // "A selector is said to contain the nesting selector if, when it was parsed as any type of selector,
 | ||
|     // a <delim-token> with the value "&" (U+0026 AMPERSAND) was encountered."
 | ||
|     for (auto const& compound_selector : m_compound_selectors) {
 | ||
|         for (auto const& simple_selector : compound_selector.simple_selectors) {
 | ||
|             if (simple_selector.type == SimpleSelector::Type::Nesting) {
 | ||
|                 m_contains_the_nesting_selector = true;
 | ||
|                 break;
 | ||
|             }
 | ||
|             if (simple_selector.type == SimpleSelector::Type::PseudoClass) {
 | ||
|                 m_contained_pseudo_classes.set(simple_selector.pseudo_class().type, true);
 | ||
|                 for (auto const& child_selector : simple_selector.pseudo_class().argument_selector_list) {
 | ||
|                     if (child_selector->contains_the_nesting_selector()) {
 | ||
|                         m_contains_the_nesting_selector = true;
 | ||
|                     }
 | ||
|                     m_contained_pseudo_classes |= child_selector->m_contained_pseudo_classes;
 | ||
|                 }
 | ||
|                 if (m_contains_the_nesting_selector)
 | ||
|                     break;
 | ||
|             }
 | ||
|             if (simple_selector.type == SimpleSelector::Type::Invalid) {
 | ||
|                 auto& invalid = simple_selector.value.get<SimpleSelector::Invalid>();
 | ||
|                 for (auto& item : invalid.component_values) {
 | ||
|                     if (component_value_contains_nesting_selector(item)) {
 | ||
|                         m_contains_the_nesting_selector = true;
 | ||
|                         break;
 | ||
|                     }
 | ||
|                 }
 | ||
|                 if (m_contains_the_nesting_selector)
 | ||
|                     break;
 | ||
|             }
 | ||
|         }
 | ||
|         if (m_contains_the_nesting_selector)
 | ||
|             break;
 | ||
|     }
 | ||
| 
 | ||
|     collect_ancestor_hashes();
 | ||
| 
 | ||
|     m_can_use_fast_matches = can_selector_use_fast_matches(*this);
 | ||
| }
 | ||
| 
 | ||
| void Selector::collect_ancestor_hashes()
 | ||
| {
 | ||
|     if (is_slotted()) {
 | ||
|         // Ancestor filtering is not supported for slotted selectors, because those
 | ||
|         // are supposed to be collected for element inside a slot, while being
 | ||
|         // matched against slot element.
 | ||
|         return;
 | ||
|     }
 | ||
| 
 | ||
|     size_t next_hash_index = 0;
 | ||
|     auto append_unique_hash = [&](u32 hash) -> bool {
 | ||
|         if (next_hash_index >= m_ancestor_hashes.size())
 | ||
|             return true;
 | ||
|         for (size_t i = 0; i < next_hash_index; ++i) {
 | ||
|             if (m_ancestor_hashes[i] == hash)
 | ||
|                 return false;
 | ||
|         }
 | ||
|         m_ancestor_hashes[next_hash_index++] = hash;
 | ||
|         return false;
 | ||
|     };
 | ||
| 
 | ||
|     auto last_combinator = m_compound_selectors.last().combinator;
 | ||
|     for (ssize_t compound_selector_index = static_cast<ssize_t>(m_compound_selectors.size()) - 2; compound_selector_index >= 0; --compound_selector_index) {
 | ||
|         auto const& compound_selector = m_compound_selectors[compound_selector_index];
 | ||
|         if (last_combinator == Combinator::Descendant || last_combinator == Combinator::ImmediateChild) {
 | ||
|             m_can_use_ancestor_filter = true;
 | ||
|             for (auto const& simple_selector : compound_selector.simple_selectors) {
 | ||
|                 switch (simple_selector.type) {
 | ||
|                 case SimpleSelector::Type::Id:
 | ||
|                 case SimpleSelector::Type::Class:
 | ||
|                     if (append_unique_hash(simple_selector.name().hash()))
 | ||
|                         return;
 | ||
|                     break;
 | ||
|                 case SimpleSelector::Type::TagName:
 | ||
|                     if (append_unique_hash(simple_selector.qualified_name().name.lowercase_name.hash()))
 | ||
|                         return;
 | ||
|                     break;
 | ||
|                 case SimpleSelector::Type::Attribute:
 | ||
|                     if (append_unique_hash(simple_selector.attribute().qualified_name.name.lowercase_name.hash()))
 | ||
|                         return;
 | ||
|                     break;
 | ||
|                 default:
 | ||
|                     break;
 | ||
|                 }
 | ||
|             }
 | ||
|         }
 | ||
|         last_combinator = compound_selector.combinator;
 | ||
|     }
 | ||
| 
 | ||
|     for (size_t i = next_hash_index; i < m_ancestor_hashes.size(); ++i)
 | ||
|         m_ancestor_hashes[i] = 0;
 | ||
| }
 | ||
| 
 | ||
| // https://www.w3.org/TR/selectors-4/#specificity-rules
 | ||
| u32 Selector::specificity() const
 | ||
| {
 | ||
|     if (m_specificity.has_value())
 | ||
|         return *m_specificity;
 | ||
| 
 | ||
|     constexpr u32 ids_shift = 16;
 | ||
|     constexpr u32 classes_shift = 8;
 | ||
|     constexpr u32 tag_names_shift = 0;
 | ||
|     constexpr u32 ids_mask = 0xff << ids_shift;
 | ||
|     constexpr u32 classes_mask = 0xff << classes_shift;
 | ||
|     constexpr u32 tag_names_mask = 0xff << tag_names_shift;
 | ||
| 
 | ||
|     u32 ids = 0;
 | ||
|     u32 classes = 0;
 | ||
|     u32 tag_names = 0;
 | ||
| 
 | ||
|     auto count_specificity_of_most_complex_selector = [&](auto& selector_list) {
 | ||
|         u32 max_selector_list_argument_specificity = 0;
 | ||
|         for (auto const& complex_selector : selector_list) {
 | ||
|             max_selector_list_argument_specificity = max(max_selector_list_argument_specificity, complex_selector->specificity());
 | ||
|         }
 | ||
| 
 | ||
|         u32 child_ids = (max_selector_list_argument_specificity & ids_mask) >> ids_shift;
 | ||
|         u32 child_classes = (max_selector_list_argument_specificity & classes_mask) >> classes_shift;
 | ||
|         u32 child_tag_names = (max_selector_list_argument_specificity & tag_names_mask) >> tag_names_shift;
 | ||
| 
 | ||
|         ids += child_ids;
 | ||
|         classes += child_classes;
 | ||
|         tag_names += child_tag_names;
 | ||
|     };
 | ||
| 
 | ||
|     for (auto& list : m_compound_selectors) {
 | ||
|         for (auto& simple_selector : list.simple_selectors) {
 | ||
|             switch (simple_selector.type) {
 | ||
|             case SimpleSelector::Type::Id:
 | ||
|                 // count the number of ID selectors in the selector (= A)
 | ||
|                 ++ids;
 | ||
|                 break;
 | ||
|             case SimpleSelector::Type::Class:
 | ||
|             case SimpleSelector::Type::Attribute:
 | ||
|                 // count the number of class selectors, attributes selectors, and pseudo-classes in the selector (= B)
 | ||
|                 ++classes;
 | ||
|                 break;
 | ||
|             case SimpleSelector::Type::PseudoClass: {
 | ||
|                 auto& pseudo_class = simple_selector.pseudo_class();
 | ||
|                 switch (pseudo_class.type) {
 | ||
|                 case PseudoClass::Has:
 | ||
|                 case PseudoClass::Is:
 | ||
|                 case PseudoClass::Not: {
 | ||
|                     // The specificity of an :is(), :not(), or :has() pseudo-class is replaced by the
 | ||
|                     // specificity of the most specific complex selector in its selector list argument.
 | ||
|                     count_specificity_of_most_complex_selector(pseudo_class.argument_selector_list);
 | ||
|                     break;
 | ||
|                 }
 | ||
|                 case PseudoClass::NthChild:
 | ||
|                 case PseudoClass::NthLastChild: {
 | ||
|                     // Analogously, the specificity of an :nth-child() or :nth-last-child() selector
 | ||
|                     // is the specificity of the pseudo class itself (counting as one pseudo-class selector)
 | ||
|                     // plus the specificity of the most specific complex selector in its selector list argument (if any).
 | ||
|                     ++classes;
 | ||
|                     count_specificity_of_most_complex_selector(pseudo_class.argument_selector_list);
 | ||
|                     break;
 | ||
|                 }
 | ||
|                 case PseudoClass::Where:
 | ||
|                     // The specificity of a :where() pseudo-class is replaced by zero.
 | ||
|                     break;
 | ||
|                 default:
 | ||
|                     ++classes;
 | ||
|                     break;
 | ||
|                 }
 | ||
|                 break;
 | ||
|             }
 | ||
|             case SimpleSelector::Type::TagName:
 | ||
|                 // count the number of type selectors and pseudo-elements in the selector (= C)
 | ||
|                 ++tag_names;
 | ||
|                 break;
 | ||
|             case SimpleSelector::Type::PseudoElement:
 | ||
|                 // count the number of type selectors and pseudo-elements in the selector (= C)
 | ||
|                 // FIXME: This needs special handling for view transition pseudos:
 | ||
|                 //        https://drafts.csswg.org/css-view-transitions-1/#named-view-transition-pseudo
 | ||
|                 ++tag_names;
 | ||
|                 break;
 | ||
|             case SimpleSelector::Type::Universal:
 | ||
|                 // ignore the universal selector
 | ||
|                 break;
 | ||
|             case SimpleSelector::Type::Nesting:
 | ||
|                 // "The specificity of the nesting selector is equal to the largest specificity among the complex selectors in the parent style rule’s selector list (identical to the behavior of :is()), or zero if no such selector list exists."
 | ||
|                 // - https://drafts.csswg.org/css-nesting/#ref-for-specificity
 | ||
|                 // The parented case is handled by replacing & with :is().
 | ||
|                 // So if we got here, the specificity is 0.
 | ||
|                 break;
 | ||
|             case SimpleSelector::Type::Invalid:
 | ||
|                 // Ignore invalid selectors
 | ||
|                 break;
 | ||
|             }
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     // Due to storage limitations, implementations may have limitations on the size of A, B, or C.
 | ||
|     // If so, values higher than the limit must be clamped to that limit, and not overflow.
 | ||
|     m_specificity = (min(ids, 0xff) << ids_shift)
 | ||
|         + (min(classes, 0xff) << classes_shift)
 | ||
|         + (min(tag_names, 0xff) << tag_names_shift);
 | ||
| 
 | ||
|     return *m_specificity;
 | ||
| }
 | ||
| 
 | ||
| String Selector::PseudoElementSelector::serialize() const
 | ||
| {
 | ||
|     StringBuilder builder;
 | ||
|     builder.append("::"sv);
 | ||
| 
 | ||
|     if (!m_name.is_empty()) {
 | ||
|         builder.append(m_name);
 | ||
|     } else {
 | ||
|         builder.append(pseudo_element_name(m_type));
 | ||
|     }
 | ||
| 
 | ||
|     m_value.visit(
 | ||
|         [&builder](NonnullRefPtr<Selector> const& compund_selector) {
 | ||
|             builder.append('(');
 | ||
|             builder.append(compund_selector->serialize());
 | ||
|             builder.append(')');
 | ||
|         },
 | ||
|         [&builder](PTNameSelector const& pt_name_selector) {
 | ||
|             builder.append('(');
 | ||
|             if (pt_name_selector.is_universal)
 | ||
|                 builder.append('*');
 | ||
|             else
 | ||
|                 builder.append(pt_name_selector.value);
 | ||
|             builder.append(')');
 | ||
|         },
 | ||
|         [](Empty const&) {});
 | ||
| 
 | ||
|     return builder.to_string_without_validation();
 | ||
| }
 | ||
| 
 | ||
| // https://www.w3.org/TR/cssom/#serialize-a-simple-selector
 | ||
| String Selector::SimpleSelector::serialize() const
 | ||
| {
 | ||
|     StringBuilder s;
 | ||
|     switch (type) {
 | ||
|     case Selector::SimpleSelector::Type::TagName:
 | ||
|     case Selector::SimpleSelector::Type::Universal: {
 | ||
|         auto qualified_name = this->qualified_name();
 | ||
|         // 1. If the namespace prefix maps to a namespace that is not the default namespace and is not the null
 | ||
|         //    namespace (not in a namespace) append the serialization of the namespace prefix as an identifier,
 | ||
|         //    followed by a "|" (U+007C) to s.
 | ||
|         if (qualified_name.namespace_type == QualifiedName::NamespaceType::Named) {
 | ||
|             serialize_an_identifier(s, qualified_name.namespace_);
 | ||
|             s.append('|');
 | ||
|         }
 | ||
| 
 | ||
|         // 2. If the namespace prefix maps to a namespace that is the null namespace (not in a namespace)
 | ||
|         //    append "|" (U+007C) to s.
 | ||
|         if (qualified_name.namespace_type == QualifiedName::NamespaceType::None)
 | ||
|             s.append('|');
 | ||
| 
 | ||
|         // 3. If this is a type selector append the serialization of the element name as an identifier to s.
 | ||
|         if (type == Selector::SimpleSelector::Type::TagName)
 | ||
|             serialize_an_identifier(s, qualified_name.name.name);
 | ||
| 
 | ||
|         // 4. If this is a universal selector append "*" (U+002A) to s.
 | ||
|         if (type == Selector::SimpleSelector::Type::Universal)
 | ||
|             s.append('*');
 | ||
| 
 | ||
|         break;
 | ||
|     }
 | ||
|     case Selector::SimpleSelector::Type::Attribute: {
 | ||
|         auto& attribute = this->attribute();
 | ||
| 
 | ||
|         // 1. Append "[" (U+005B) to s.
 | ||
|         s.append('[');
 | ||
| 
 | ||
|         // 2. If the namespace prefix maps to a namespace that is not the null namespace (not in a namespace)
 | ||
|         //    append the serialization of the namespace prefix as an identifier, followed by a "|" (U+007C) to s.
 | ||
|         if (attribute.qualified_name.namespace_type == QualifiedName::NamespaceType::Named) {
 | ||
|             serialize_an_identifier(s, attribute.qualified_name.namespace_);
 | ||
|             s.append('|');
 | ||
|         } else if (attribute.qualified_name.namespace_type == QualifiedName::NamespaceType::Any) {
 | ||
|             s.append("*|"sv);
 | ||
|         }
 | ||
| 
 | ||
|         // 3. Append the serialization of the attribute name as an identifier to s.
 | ||
|         serialize_an_identifier(s, attribute.qualified_name.name.name);
 | ||
| 
 | ||
|         // 4. If there is an attribute value specified, append "=", "~=", "|=", "^=", "$=", or "*=" as appropriate (depending on the type of attribute selector),
 | ||
|         //    followed by the serialization of the attribute value as a string, to s.
 | ||
|         if (!attribute.value.is_empty()) {
 | ||
|             switch (attribute.match_type) {
 | ||
|             case Selector::SimpleSelector::Attribute::MatchType::ExactValueMatch:
 | ||
|                 s.append("="sv);
 | ||
|                 break;
 | ||
|             case Selector::SimpleSelector::Attribute::MatchType::ContainsWord:
 | ||
|                 s.append("~="sv);
 | ||
|                 break;
 | ||
|             case Selector::SimpleSelector::Attribute::MatchType::ContainsString:
 | ||
|                 s.append("*="sv);
 | ||
|                 break;
 | ||
|             case Selector::SimpleSelector::Attribute::MatchType::StartsWithSegment:
 | ||
|                 s.append("|="sv);
 | ||
|                 break;
 | ||
|             case Selector::SimpleSelector::Attribute::MatchType::StartsWithString:
 | ||
|                 s.append("^="sv);
 | ||
|                 break;
 | ||
|             case Selector::SimpleSelector::Attribute::MatchType::EndsWithString:
 | ||
|                 s.append("$="sv);
 | ||
|                 break;
 | ||
|             default:
 | ||
|                 break;
 | ||
|             }
 | ||
| 
 | ||
|             serialize_a_string(s, attribute.value);
 | ||
|         }
 | ||
| 
 | ||
|         // 5. If the attribute selector has the case-insensitivity flag present, append " i" (U+0020 U+0069) to s.
 | ||
|         //    If the attribute selector has the case-insensitivity flag present, append " s" (U+0020 U+0073) to s.
 | ||
|         //    (the line just above is an addition to CSS OM to match Selectors Level 4 last draft)
 | ||
|         switch (attribute.case_type) {
 | ||
|         case Selector::SimpleSelector::Attribute::CaseType::CaseInsensitiveMatch:
 | ||
|             s.append(" i"sv);
 | ||
|             break;
 | ||
|         case Selector::SimpleSelector::Attribute::CaseType::CaseSensitiveMatch:
 | ||
|             s.append(" s"sv);
 | ||
|             break;
 | ||
|         default:
 | ||
|             break;
 | ||
|         }
 | ||
| 
 | ||
|         // 6. Append "]" (U+005D) to s.
 | ||
|         s.append(']');
 | ||
|         break;
 | ||
|     }
 | ||
| 
 | ||
|     case Selector::SimpleSelector::Type::Class:
 | ||
|         // Append a "." (U+002E), followed by the serialization of the class name as an identifier to s.
 | ||
|         s.append('.');
 | ||
|         serialize_an_identifier(s, name());
 | ||
|         break;
 | ||
| 
 | ||
|     case Selector::SimpleSelector::Type::Id:
 | ||
|         // Append a "#" (U+0023), followed by the serialization of the ID as an identifier to s.
 | ||
|         s.append('#');
 | ||
|         serialize_an_identifier(s, name());
 | ||
|         break;
 | ||
| 
 | ||
|     case Selector::SimpleSelector::Type::PseudoClass: {
 | ||
|         auto& pseudo_class = this->pseudo_class();
 | ||
| 
 | ||
|         auto metadata = pseudo_class_metadata(pseudo_class.type);
 | ||
|         bool accepts_arguments = [&]() {
 | ||
|             if (!metadata.is_valid_as_function)
 | ||
|                 return false;
 | ||
|             if (!metadata.is_valid_as_identifier)
 | ||
|                 return true;
 | ||
|             // For pseudo-classes with both a function and identifier form, see if they have arguments.
 | ||
|             switch (pseudo_class.type) {
 | ||
|             case PseudoClass::Heading:
 | ||
|                 return !pseudo_class.levels.is_empty();
 | ||
|             case PseudoClass::Host:
 | ||
|                 return !pseudo_class.argument_selector_list.is_empty();
 | ||
|             default:
 | ||
|                 VERIFY_NOT_REACHED();
 | ||
|             }
 | ||
|         }();
 | ||
| 
 | ||
|         // If the pseudo-class does not accept arguments append ":" (U+003A), followed by the name of the pseudo-class, to s.
 | ||
|         if (!accepts_arguments) {
 | ||
|             s.append(':');
 | ||
|             s.append(pseudo_class_name(pseudo_class.type));
 | ||
|         }
 | ||
|         // Otherwise, append ":" (U+003A), followed by the name of the pseudo-class, followed by "(" (U+0028),
 | ||
|         // followed by the value of the pseudo-class argument(s) determined as per below, followed by ")" (U+0029), to s.
 | ||
|         else {
 | ||
|             s.append(':');
 | ||
|             s.append(pseudo_class_name(pseudo_class.type));
 | ||
|             s.append('(');
 | ||
|             // NB: The spec list is incomplete. For ease of maintenance, we use the data from PseudoClasses.json for
 | ||
|             //     this instead of a hard-coded list.
 | ||
|             switch (metadata.parameter_type) {
 | ||
|             case PseudoClassMetadata::ParameterType::None:
 | ||
|                 break;
 | ||
|             case PseudoClassMetadata::ParameterType::ANPlusB:
 | ||
|             case PseudoClassMetadata::ParameterType::ANPlusBOf:
 | ||
|                 // The result of serializing the value using the rules to serialize an <an+b> value.
 | ||
|                 s.append(pseudo_class.an_plus_b_pattern.serialize());
 | ||
|                 break;
 | ||
|             case PseudoClassMetadata::ParameterType::CompoundSelector:
 | ||
|             case PseudoClassMetadata::ParameterType::ForgivingSelectorList:
 | ||
|             case PseudoClassMetadata::ParameterType::ForgivingRelativeSelectorList:
 | ||
|             case PseudoClassMetadata::ParameterType::RelativeSelectorList:
 | ||
|             case PseudoClassMetadata::ParameterType::SelectorList:
 | ||
|                 // The result of serializing the value using the rules for serializing a group of selectors.
 | ||
|                 s.append(serialize_a_group_of_selectors(pseudo_class.argument_selector_list));
 | ||
|                 break;
 | ||
|             case PseudoClassMetadata::ParameterType::Ident:
 | ||
|                 s.append(serialize_an_identifier(pseudo_class.ident->string_value));
 | ||
|                 break;
 | ||
|             case PseudoClassMetadata::ParameterType::LanguageRanges:
 | ||
|                 // The serialization of a comma-separated list of each argument’s serialization as a string, preserving relative order.
 | ||
|                 s.join(", "sv, pseudo_class.languages);
 | ||
|                 break;
 | ||
|             case PseudoClassMetadata::ParameterType::LevelList:
 | ||
|                 // AD-HOC: not in the spec.
 | ||
|                 s.join(", "sv, pseudo_class.levels);
 | ||
|                 break;
 | ||
|             }
 | ||
|             s.append(')');
 | ||
|         }
 | ||
|         break;
 | ||
|     }
 | ||
|     case Selector::SimpleSelector::Type::PseudoElement:
 | ||
|         // AD-HOC: Spec issue: https://github.com/w3c/csswg-drafts/issues/11997
 | ||
|         s.append(this->pseudo_element().serialize());
 | ||
|         break;
 | ||
|     case Type::Nesting:
 | ||
|         // AD-HOC: Not in spec yet.
 | ||
|         s.append('&');
 | ||
|         break;
 | ||
|     case Type::Invalid:
 | ||
|         // AD-HOC: We're not told how to do these. Just serialize their component values.
 | ||
|         auto invalid = value.get<Invalid>();
 | ||
|         for (auto const& component_value : invalid.component_values)
 | ||
|             s.append(component_value.to_string());
 | ||
|         break;
 | ||
|     }
 | ||
|     return MUST(s.to_string());
 | ||
| }
 | ||
| 
 | ||
| // https://www.w3.org/TR/cssom/#serialize-a-selector
 | ||
| String Selector::serialize() const
 | ||
| {
 | ||
|     StringBuilder s;
 | ||
| 
 | ||
|     // AD-HOC: If this is a relative selector, we need to serialize the starting combinator.
 | ||
|     if (!compound_selectors().is_empty()) {
 | ||
|         switch (compound_selectors().first().combinator) {
 | ||
|         case Combinator::ImmediateChild:
 | ||
|             s.append("> "sv);
 | ||
|             break;
 | ||
|         case Combinator::NextSibling:
 | ||
|             s.append("+ "sv);
 | ||
|             break;
 | ||
|         case Combinator::SubsequentSibling:
 | ||
|             s.append("~ "sv);
 | ||
|             break;
 | ||
|         case Combinator::Column:
 | ||
|             s.append("|| "sv);
 | ||
|             break;
 | ||
|         default:
 | ||
|             break;
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     // To serialize a selector let s be the empty string, run the steps below for each part of the chain of the selector, and finally return s:
 | ||
|     for (size_t i = 0; i < compound_selectors().size(); ++i) {
 | ||
|         auto const& compound_selector = compound_selectors()[i];
 | ||
|         // 1. If there is only one simple selector in the compound selectors which is a universal selector, append the result of serializing the universal selector to s.
 | ||
|         if (compound_selector.simple_selectors.size() == 1
 | ||
|             && compound_selector.simple_selectors.first().type == Selector::SimpleSelector::Type::Universal) {
 | ||
|             s.append(compound_selector.simple_selectors.first().serialize());
 | ||
|         }
 | ||
|         // 2. Otherwise, for each simple selector in the compound selectors that is not a universal selector
 | ||
|         //    of which the namespace prefix maps to a namespace that is not the default namespace
 | ||
|         //    serialize the simple selector and append the result to s.
 | ||
|         else {
 | ||
|             for (auto& simple_selector : compound_selector.simple_selectors) {
 | ||
|                 if (simple_selector.type == SimpleSelector::Type::Universal) {
 | ||
|                     auto qualified_name = simple_selector.qualified_name();
 | ||
|                     if (qualified_name.namespace_type == SimpleSelector::QualifiedName::NamespaceType::Default
 | ||
|                         || qualified_name.namespace_type == SimpleSelector::QualifiedName::NamespaceType::Any)
 | ||
|                         continue;
 | ||
|                     // FIXME: I *think* if we have a namespace prefix that happens to equal the same as the default namespace,
 | ||
|                     //        we also should skip it. But we don't have access to that here. eg:
 | ||
|                     // <style>
 | ||
|                     //   @namespace "http://example";
 | ||
|                     //   @namespace foo "http://example";
 | ||
|                     //   foo|*.bar { } /* This would skip the `foo|*` when serializing. */
 | ||
|                     // </style>
 | ||
|                 }
 | ||
|                 s.append(simple_selector.serialize());
 | ||
|             }
 | ||
|         }
 | ||
| 
 | ||
|         // 3. If this is not the last part of the chain of the selector append a single SPACE (U+0020),
 | ||
|         //    followed by the combinator ">", "+", "~", ">>", "||", as appropriate, followed by another
 | ||
|         //    single SPACE (U+0020) if the combinator was not whitespace, to s.
 | ||
|         if (i != compound_selectors().size() - 1) {
 | ||
|             s.append(' ');
 | ||
|             // Note: The combinator that appears between parts `i` and `i+1` appears with the `i+1` selector,
 | ||
|             //       so we have to check that one.
 | ||
|             switch (compound_selectors()[i + 1].combinator) {
 | ||
|             case Selector::Combinator::ImmediateChild:
 | ||
|                 s.append("> "sv);
 | ||
|                 break;
 | ||
|             case Selector::Combinator::NextSibling:
 | ||
|                 s.append("+ "sv);
 | ||
|                 break;
 | ||
|             case Selector::Combinator::SubsequentSibling:
 | ||
|                 s.append("~ "sv);
 | ||
|                 break;
 | ||
|             case Selector::Combinator::Column:
 | ||
|                 s.append("|| "sv);
 | ||
|                 break;
 | ||
|             default:
 | ||
|                 break;
 | ||
|             }
 | ||
|         } else {
 | ||
|             // 4. If this is the last part of the chain of the selector and there is a pseudo-element,
 | ||
|             // append "::" followed by the name of the pseudo-element, to s.
 | ||
|             // This algorithm has a problem, see https://github.com/w3c/csswg-drafts/issues/11997
 | ||
|             //      serialization of pseudoElements was moved to SimpleSelector::serialize()
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     return MUST(s.to_string());
 | ||
| }
 | ||
| 
 | ||
| // https://www.w3.org/TR/cssom/#serialize-a-group-of-selectors
 | ||
| String serialize_a_group_of_selectors(SelectorList const& selectors)
 | ||
| {
 | ||
|     // To serialize a group of selectors serialize each selector in the group of selectors and then serialize a comma-separated list of these serializations.
 | ||
|     return MUST(String::join(", "sv, selectors));
 | ||
| }
 | ||
| 
 | ||
| NonnullRefPtr<Selector> Selector::relative_to(SimpleSelector const& parent) const
 | ||
| {
 | ||
|     // To make us relative to the parent, prepend it to the list of compound selectors,
 | ||
|     // and ensure the next compound selector starts with a combinator.
 | ||
|     Vector<CompoundSelector> copied_compound_selectors;
 | ||
|     copied_compound_selectors.ensure_capacity(compound_selectors().size() + 1);
 | ||
|     copied_compound_selectors.empend(CompoundSelector { .simple_selectors = { parent } });
 | ||
| 
 | ||
|     bool first = true;
 | ||
|     for (auto compound_selector : compound_selectors()) {
 | ||
|         if (first) {
 | ||
|             if (compound_selector.combinator == Combinator::None)
 | ||
|                 compound_selector.combinator = Combinator::Descendant;
 | ||
|             first = false;
 | ||
|         }
 | ||
| 
 | ||
|         copied_compound_selectors.append(move(compound_selector));
 | ||
|     }
 | ||
| 
 | ||
|     return Selector::create(move(copied_compound_selectors));
 | ||
| }
 | ||
| 
 | ||
| bool Selector::contains_unknown_webkit_pseudo_element() const
 | ||
| {
 | ||
|     for (auto const& compound_selector : m_compound_selectors) {
 | ||
|         for (auto const& simple_selector : compound_selector.simple_selectors) {
 | ||
|             if (simple_selector.type == SimpleSelector::Type::PseudoClass) {
 | ||
|                 for (auto const& child_selector : simple_selector.pseudo_class().argument_selector_list) {
 | ||
|                     if (child_selector->contains_unknown_webkit_pseudo_element()) {
 | ||
|                         return true;
 | ||
|                     }
 | ||
|                 }
 | ||
|             }
 | ||
|             if (simple_selector.type == SimpleSelector::Type::PseudoElement && simple_selector.pseudo_element().type() == PseudoElement::UnknownWebKit)
 | ||
|                 return true;
 | ||
|         }
 | ||
|     }
 | ||
|     return false;
 | ||
| }
 | ||
| 
 | ||
| RefPtr<Selector> Selector::absolutized(Selector::SimpleSelector const& selector_for_nesting) const
 | ||
| {
 | ||
|     if (!contains_the_nesting_selector())
 | ||
|         return fixme_launder_const_through_pointer_cast(*this);
 | ||
| 
 | ||
|     Vector<CompoundSelector> absolutized_compound_selectors;
 | ||
|     absolutized_compound_selectors.ensure_capacity(m_compound_selectors.size());
 | ||
|     for (auto const& compound_selector : m_compound_selectors) {
 | ||
|         if (auto absolutized = compound_selector.absolutized(selector_for_nesting); absolutized.has_value()) {
 | ||
|             absolutized_compound_selectors.append(absolutized.release_value());
 | ||
|         } else {
 | ||
|             return nullptr;
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     return Selector::create(move(absolutized_compound_selectors));
 | ||
| }
 | ||
| 
 | ||
| Optional<Selector::CompoundSelector> Selector::CompoundSelector::absolutized(Selector::SimpleSelector const& selector_for_nesting) const
 | ||
| {
 | ||
|     // TODO: Cache if it contains the nesting selector?
 | ||
| 
 | ||
|     Vector<SimpleSelector> absolutized_simple_selectors;
 | ||
|     absolutized_simple_selectors.ensure_capacity(simple_selectors.size());
 | ||
|     for (auto const& simple_selector : simple_selectors) {
 | ||
|         if (auto absolutized = simple_selector.absolutized(selector_for_nesting); absolutized.has_value()) {
 | ||
|             absolutized_simple_selectors.append(absolutized.release_value());
 | ||
|         } else {
 | ||
|             return {};
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     return CompoundSelector {
 | ||
|         .combinator = this->combinator,
 | ||
|         .simple_selectors = absolutized_simple_selectors,
 | ||
|     };
 | ||
| }
 | ||
| 
 | ||
| static bool contains_invalid_contents_for_has(Selector const& selector)
 | ||
| {
 | ||
|     // :has() has special validity rules:
 | ||
|     // - It can't appear inside itself
 | ||
|     // - It bans most pseudo-elements
 | ||
|     // https://drafts.csswg.org/selectors/#relational
 | ||
| 
 | ||
|     for (auto const& compound_selector : selector.compound_selectors()) {
 | ||
|         for (auto const& simple_selector : compound_selector.simple_selectors) {
 | ||
|             if (simple_selector.type == Selector::SimpleSelector::Type::PseudoElement) {
 | ||
|                 if (!is_has_allowed_pseudo_element(simple_selector.pseudo_element().type()))
 | ||
|                     return true;
 | ||
|             }
 | ||
|             if (simple_selector.type == Selector::SimpleSelector::Type::PseudoClass) {
 | ||
|                 if (simple_selector.pseudo_class().type == PseudoClass::Has)
 | ||
|                     return true;
 | ||
|                 for (auto& child_selector : simple_selector.pseudo_class().argument_selector_list) {
 | ||
|                     if (contains_invalid_contents_for_has(*child_selector))
 | ||
|                         return true;
 | ||
|                 }
 | ||
|             }
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     return false;
 | ||
| }
 | ||
| 
 | ||
| Optional<Selector::SimpleSelector> Selector::SimpleSelector::absolutized(Selector::SimpleSelector const& selector_for_nesting) const
 | ||
| {
 | ||
|     switch (type) {
 | ||
|     case Type::Nesting:
 | ||
|         // Nesting selectors get replaced directly.
 | ||
|         return selector_for_nesting;
 | ||
| 
 | ||
|     case Type::PseudoClass: {
 | ||
|         // Pseudo-classes may contain other selectors, so we need to absolutize them.
 | ||
|         // Copy the PseudoClassSelector, and then replace its argument selector list.
 | ||
|         auto pseudo_class = this->pseudo_class();
 | ||
|         if (!pseudo_class.argument_selector_list.is_empty()) {
 | ||
|             SelectorList new_selector_list;
 | ||
|             new_selector_list.ensure_capacity(pseudo_class.argument_selector_list.size());
 | ||
|             for (auto const& argument_selector : pseudo_class.argument_selector_list) {
 | ||
|                 if (auto absolutized = argument_selector->absolutized(selector_for_nesting)) {
 | ||
|                     new_selector_list.append(absolutized.release_nonnull());
 | ||
|                 } else if (!pseudo_class.is_forgiving) {
 | ||
|                     return {};
 | ||
|                 }
 | ||
|             }
 | ||
|             pseudo_class.argument_selector_list = move(new_selector_list);
 | ||
|         }
 | ||
| 
 | ||
|         // :has() has special validity rules
 | ||
|         if (pseudo_class.type == PseudoClass::Has) {
 | ||
|             for (auto const& selector : pseudo_class.argument_selector_list) {
 | ||
|                 if (contains_invalid_contents_for_has(selector)) {
 | ||
|                     Parser::ErrorReporter::the().report(Parser::InvalidSelectorError {
 | ||
|                         .value_string = selector->serialize(),
 | ||
|                         .description = "After absolutizing, :has() would contain invalid contents."_string,
 | ||
|                     });
 | ||
|                     return {};
 | ||
|                 }
 | ||
|             }
 | ||
|         }
 | ||
| 
 | ||
|         return SimpleSelector {
 | ||
|             .type = Type::PseudoClass,
 | ||
|             .value = move(pseudo_class),
 | ||
|         };
 | ||
|     }
 | ||
| 
 | ||
|     case Type::Universal:
 | ||
|     case Type::TagName:
 | ||
|     case Type::Id:
 | ||
|     case Type::Class:
 | ||
|     case Type::Attribute:
 | ||
|     case Type::PseudoElement:
 | ||
|     case Type::Invalid:
 | ||
|         // Everything else isn't affected
 | ||
|         return *this;
 | ||
|     }
 | ||
| 
 | ||
|     VERIFY_NOT_REACHED();
 | ||
| }
 | ||
| 
 | ||
| size_t Selector::sibling_invalidation_distance() const
 | ||
| {
 | ||
|     if (m_sibling_invalidation_distance.has_value())
 | ||
|         return *m_sibling_invalidation_distance;
 | ||
| 
 | ||
|     m_sibling_invalidation_distance = 0;
 | ||
|     size_t current_distance = 0;
 | ||
|     for (auto const& compound_selector : compound_selectors()) {
 | ||
|         if (compound_selector.combinator == Combinator::None)
 | ||
|             continue;
 | ||
| 
 | ||
|         if (compound_selector.combinator == Combinator::SubsequentSibling) {
 | ||
|             m_sibling_invalidation_distance = NumericLimits<size_t>::max();
 | ||
|             return *m_sibling_invalidation_distance;
 | ||
|         }
 | ||
| 
 | ||
|         if (compound_selector.combinator == Combinator::NextSibling) {
 | ||
|             current_distance++;
 | ||
|         } else {
 | ||
|             m_sibling_invalidation_distance = max(*m_sibling_invalidation_distance, current_distance);
 | ||
|             current_distance = 0;
 | ||
|         }
 | ||
|     }
 | ||
| 
 | ||
|     if (current_distance > 0) {
 | ||
|         m_sibling_invalidation_distance = max(*m_sibling_invalidation_distance, current_distance);
 | ||
|     }
 | ||
|     return *m_sibling_invalidation_distance;
 | ||
| }
 | ||
| 
 | ||
| SelectorList adapt_nested_relative_selector_list(SelectorList const& selectors)
 | ||
| {
 | ||
|     // "Nested style rules differ from non-nested rules in the following ways:
 | ||
|     // - A nested style rule accepts a <relative-selector-list> as its prelude (rather than just a <selector-list>).
 | ||
|     //   Any relative selectors are relative to the elements represented by the nesting selector.
 | ||
|     // - If a selector in the <relative-selector-list> does not start with a combinator but does contain the nesting
 | ||
|     //   selector, it is interpreted as a non-relative selector."
 | ||
|     // https://drafts.csswg.org/css-nesting-1/#syntax
 | ||
|     // NOTE: We already parsed the selectors as a <relative-selector-list>
 | ||
| 
 | ||
|     // Nested relative selectors get a `&` inserted at the beginning.
 | ||
|     // This is, handily, how the spec wants them serialized:
 | ||
|     // "When serializing a relative selector in a nested style rule, the selector must be absolutized,
 | ||
|     // with the implied nesting selector inserted."
 | ||
|     // - https://drafts.csswg.org/css-nesting-1/#cssom
 | ||
| 
 | ||
|     CSS::SelectorList new_list;
 | ||
|     new_list.ensure_capacity(selectors.size());
 | ||
|     for (auto const& selector : selectors) {
 | ||
|         auto first_combinator = selector->compound_selectors().first().combinator;
 | ||
|         if (!first_is_one_of(first_combinator, CSS::Selector::Combinator::None, CSS::Selector::Combinator::Descendant)
 | ||
|             || !selector->contains_the_nesting_selector()) {
 | ||
|             new_list.append(selector->relative_to(CSS::Selector::SimpleSelector { .type = CSS::Selector::SimpleSelector::Type::Nesting }));
 | ||
|         } else if (first_combinator == CSS::Selector::Combinator::Descendant) {
 | ||
|             // Replace leading descendant combinator (whitespace) with none, because we're not actually relative.
 | ||
|             auto copied_compound_selectors = selector->compound_selectors();
 | ||
|             copied_compound_selectors.first().combinator = CSS::Selector::Combinator::None;
 | ||
|             new_list.append(CSS::Selector::create(move(copied_compound_selectors)));
 | ||
|         } else {
 | ||
|             new_list.append(selector);
 | ||
|         }
 | ||
|     }
 | ||
|     return new_list;
 | ||
| }
 | ||
| 
 | ||
| // https://drafts.csswg.org/css-syntax-3/#anb-microsyntax
 | ||
| bool Selector::SimpleSelector::ANPlusBPattern::matches(int index) const
 | ||
| {
 | ||
|     // "If both a and b are equal to zero, the pseudo-class represents no element in the document tree."
 | ||
|     if (step_size == 0 && offset == 0)
 | ||
|         return false;
 | ||
| 
 | ||
|     // When "step_size == -1", selector represents first "offset" elements in document tree.
 | ||
|     if (step_size == -1)
 | ||
|         return !(offset <= 0 || index > offset);
 | ||
| 
 | ||
|     // When "step_size == 1", selector represents last "offset" elements in document tree.
 | ||
|     if (step_size == 1)
 | ||
|         return !(offset < 0 || index < offset);
 | ||
| 
 | ||
|     // When "step_size == 0", selector picks only the "offset" element.
 | ||
|     if (step_size == 0)
 | ||
|         return index == offset;
 | ||
| 
 | ||
|     // If both are negative, nothing can match.
 | ||
|     if (step_size < 0 && offset < 0)
 | ||
|         return false;
 | ||
| 
 | ||
|     // Like "a % b", but handles negative integers correctly.
 | ||
|     auto const canonical_modulo = [](int a, int b) -> int {
 | ||
|         int c = a % b;
 | ||
|         if ((c < 0 && b > 0) || (c > 0 && b < 0)) {
 | ||
|             c += b;
 | ||
|         }
 | ||
|         return c;
 | ||
|     };
 | ||
| 
 | ||
|     // When "step_size < 0", we start at "offset" and count backwards.
 | ||
|     if (step_size < 0)
 | ||
|         return index <= offset && canonical_modulo(index - offset, -step_size) == 0;
 | ||
| 
 | ||
|     // Otherwise, we start at "offset" and count forwards.
 | ||
|     return index >= offset && canonical_modulo(index - offset, step_size) == 0;
 | ||
| }
 | ||
| 
 | ||
| // https://drafts.csswg.org/css-syntax-3/#serializing-anb
 | ||
| String Selector::SimpleSelector::ANPlusBPattern::serialize() const
 | ||
| {
 | ||
|     // 1. If A is zero, return the serialization of B.
 | ||
|     if (step_size == 0)
 | ||
|         return String::number(offset);
 | ||
| 
 | ||
|     // 2. Otherwise, let result initially be an empty string.
 | ||
|     StringBuilder result;
 | ||
| 
 | ||
|     // 3.
 | ||
|     // - A is 1: Append "n" to result.
 | ||
|     if (step_size == 1)
 | ||
|         result.append('n');
 | ||
|     // - A is -1: Append "-n" to result.
 | ||
|     else if (step_size == -1)
 | ||
|         result.append("-n"sv);
 | ||
|     // - A is non-zero: Serialize A and append it to result, then append "n" to result.
 | ||
|     else if (step_size != 0)
 | ||
|         result.appendff("{}n", step_size);
 | ||
| 
 | ||
|     // 4.
 | ||
|     // - B is greater than zero: Append "+" to result, then append the serialization of B to result.
 | ||
|     if (offset > 0)
 | ||
|         result.appendff("+{}", offset);
 | ||
|     // - B is less than zero: Append the serialization of B to result.
 | ||
|     else if (offset < 0)
 | ||
|         result.appendff("{}", offset);
 | ||
| 
 | ||
|     // 5. Return result.
 | ||
|     return MUST(result.to_string());
 | ||
| }
 | ||
| 
 | ||
| }
 | 
