Recategorize selectors as "AST" for Dartdoc (#1752)

This more closely matches the categorization of other AST nodes, which
aren't broken down into fine-grained categories.

This also adds the "Parsing" category to selector classes that have
`parse()` methods.
This commit is contained in:
Natalie Weizenbaum 2022-07-22 13:27:48 -07:00 committed by GitHub
parent 3e7c9dd702
commit 0d4c0d0365
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
16 changed files with 20 additions and 16 deletions

View File

@ -37,7 +37,7 @@ export 'selector/universal.dart';
///
/// Selectors have structural equality semantics.
///
/// {@category Selector}
/// {@category AST}
abstract class Selector {
/// Whether this selector, and complex selectors containing it, should not be
/// emitted.

View File

@ -12,7 +12,7 @@ import '../selector.dart';
/// This selects for elements with the given attribute, and optionally with a
/// value matching certain conditions as well.
///
/// {@category Selector}
/// {@category AST}
@sealed
class AttributeSelector extends SimpleSelector {
/// The name of the attribute being selected for.

View File

@ -12,7 +12,7 @@ import '../selector.dart';
/// This selects elements whose `class` attribute contains an identifier with
/// the given name.
///
/// {@category Selector}
/// {@category AST}
@sealed
class ClassSelector extends SimpleSelector {
/// The class name this selects for.

View File

@ -7,7 +7,7 @@ import 'package:meta/meta.dart';
/// A combinator that defines the relationship between selectors in a
/// [ComplexSelector].
///
/// {@category Selector}
/// {@category AST}
@sealed
class Combinator {
/// Matches the right-hand selector if it's immediately adjacent to the

View File

@ -16,7 +16,8 @@ import '../selector.dart';
/// A complex selector is composed of [CompoundSelector]s separated by
/// [Combinator]s. It selects elements based on their parent selectors.
///
/// {@category Selector}
/// {@category AST}
/// {@category Parsing}
@sealed
class ComplexSelector extends Selector {
/// This selector's leading combinators.

View File

@ -11,7 +11,7 @@ import '../selector.dart';
///
/// This a [CompoundSelector] with one or more trailing [Combinator]s.
///
/// {@category Selector}
/// {@category AST}
@sealed
class ComplexSelectorComponent {
/// This component's compound selector.

View File

@ -16,7 +16,8 @@ import '../selector.dart';
/// A compound selector is composed of [SimpleSelector]s. It matches an element
/// that matches all of the component simple selectors.
///
/// {@category Selector}
/// {@category AST}
/// {@category Parsing}
@sealed
class CompoundSelector extends Selector {
/// The components of this selector.

View File

@ -13,7 +13,7 @@ import '../selector.dart';
///
/// This selects elements whose `id` attribute exactly matches the given name.
///
/// {@category Selector}
/// {@category AST}
@sealed
class IDSelector extends SimpleSelector {
/// The ID name this selects for.

View File

@ -18,7 +18,8 @@ import '../selector.dart';
/// A selector list is composed of [ComplexSelector]s. It matches any element
/// that matches any of the component selectors.
///
/// {@category Selector}
/// {@category AST}
/// {@category Parsing}
@sealed
class SelectorList extends Selector {
/// The components of this selector.

View File

@ -12,7 +12,7 @@ import '../selector.dart';
/// This is not a plain CSS selectorit should be removed before emitting a CSS
/// document.
///
/// {@category Selector}
/// {@category AST}
@sealed
class ParentSelector extends SimpleSelector {
/// The suffix that will be added to the parent selector after it's been

View File

@ -14,7 +14,7 @@ import '../selector.dart';
/// `@extend`. It's not a plain CSS selector—it should be removed before
/// emitting a CSS document.
///
/// {@category Selector}
/// {@category AST}
@sealed
class PlaceholderSelector extends SimpleSelector {
/// The name of the placeholder.

View File

@ -18,7 +18,7 @@ import '../selector.dart';
/// logic for each pseudo selector that takes a selector as an argument, to
/// ensure that extension and other selector operations work properly.
///
/// {@category Selector}
/// {@category AST}
@sealed
class PseudoSelector extends SimpleSelector {
/// The name of this selector.

View File

@ -8,7 +8,7 @@ import 'package:meta/meta.dart';
///
/// [qualified name]: https://www.w3.org/TR/css3-namespace/#css-qnames
///
/// {@category Selector}
/// {@category AST}
@sealed
class QualifiedName {
/// The identifier name.

View File

@ -11,7 +11,8 @@ import '../selector.dart';
/// An abstract superclass for simple selectors.
///
/// {@category Selector}
/// {@category AST}
/// {@category Parsing}
abstract class SimpleSelector extends Selector {
/// The minimum possible specificity that this selector can have.
///

View File

@ -12,7 +12,7 @@ import '../selector.dart';
///
/// This selects elements whose name equals the given name.
///
/// {@category Selector}
/// {@category AST}
@sealed
class TypeSelector extends SimpleSelector {
/// The element name being selected.

View File

@ -10,7 +10,7 @@ import '../selector.dart';
/// Matches any element in the given namespace.
///
/// {@category Selector}
/// {@category AST}
@sealed
class UniversalSelector extends SimpleSelector {
/// The selector namespace.