// Copyright 2016 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef THIRD_PARTY_BLINK_RENDERER_CORE_CSS_CSS_SYNTAX_DEFINITION_H_
#define THIRD_PARTY_BLINK_RENDERER_CORE_CSS_CSS_SYNTAX_DEFINITION_H_

#include <algorithm>
#include <optional>

#include "third_party/blink/renderer/core/core_export.h"
#include "third_party/blink/renderer/core/css/css_syntax_component.h"
#include "third_party/blink/renderer/core/css/parser/css_parser_local_context.h"
#include "third_party/blink/renderer/core/css/parser/css_parser_token_stream.h"
#include "third_party/blink/renderer/platform/wtf/cross_thread_copier.h"

namespace blink {

class CSSParserContext;
class CSSValue;

class CORE_EXPORT CSSSyntaxDefinition {
 public:
  // Leaves an undefined state; only exists so that we can store it in
  // a hash table (in MixinParameterBindings).
  CSSSyntaxDefinition() = default;

  // https://drafts.csswg.org/css-values-5/#css-syntax
  static std::optional<CSSSyntaxDefinition> Consume(CSSParserTokenStream&);
  // https://drafts.csswg.org/css-values-5/#typedef-syntax-component
  static std::optional<CSSSyntaxDefinition> ConsumeComponent(
      CSSParserTokenStream&);
  const CSSValue* Parse(StringView,
                        const CSSParserContext&,
                        CSSParserLocalContext&,
                        bool is_animation_tainted,
                        bool is_attr_tainted = false) const;

  // https://drafts.css-houdini.org/css-properties-values-api-1/#universal-syntax-descriptor
  bool IsUniversal() const {
    return syntax_components_.size() == 1 &&
           syntax_components_[0].GetType() == CSSSyntaxType::kTokenStream;
  }
  bool ContainsUrlComponent() const {
    return std::find_if(syntax_components_.begin(), syntax_components_.end(),
                        [](const CSSSyntaxComponent& component) {
                          return component.GetType() == CSSSyntaxType::kUrl;
                        }) != syntax_components_.end();
  }
  const Vector<CSSSyntaxComponent>& Components() const {
    return syntax_components_;
  }
  bool operator==(const CSSSyntaxDefinition& a) const {
    return Components() == a.Components();
  }

  String ToString() const;

  // https://drafts.css-houdini.org/css-properties-values-api-1/#universal-syntax-descriptor
  static CSSSyntaxDefinition CreateUniversal();

  // Returns syntax: <number> | <length> | <percentage> | <angle> | <time> |
  // <resolution>.
  // Used for container style range queries,
  // https://github.com/w3c/csswg-drafts/issues/8376#issuecomment-2751161553.
  static CSSSyntaxDefinition CreateNumericSyntax();

 private:
  friend class CSSSyntaxStringParser;
  friend class CSSSyntaxStringParserTest;
  friend class CSSSyntaxDefinitionTest;

  explicit CSSSyntaxDefinition(Vector<CSSSyntaxComponent>);

  Vector<CSSSyntaxComponent> syntax_components_;
};

}  // namespace blink

#endif  // THIRD_PARTY_BLINK_RENDERER_CORE_CSS_CSS_SYNTAX_DEFINITION_H_