asciidisco.com/build/node_modules/css-tree/docs/ast.md

AST format

CSSTree's AST is an object tree. Each node is object with type property that indicates its type. Other property set depends on node type.

Each node have a loc property, but not included in descriptions to avoid noise. Its value contains an object with node content positions in source string or null depending on parsing settings.

Details on each node to be done

Other node types are stable enough.

Node types:

• AnPlusB
• Atrule
• AtrulePrelude
• AttributeSelector
• Block
• Brackets
• CDC
• CDO
• ClassSelector
• Combinator
• Comment
• Declaration
• DeclarationList
• Dimension
• Function
• HexColor
• IdSelector
• Identifier
• MediaFeature
• MediaQuery
• MediaQueryList
• Nth
• Number
• Operator
• Parentheses
• Percentage
• PseudoClassSelector
• PseudoElementSelector
• Ratio
• Raw
• Rule
• Selector
• SelectorList
• String
• StyleSheet
• TypeSelector
• UnicodeRange
• Url
• Value
• WhiteSpace

AnPlusB

Used to represent the An+B microsyntax.

{
    "type": "AnPlusB",
    "a": String | null,
    "b": String | null
}

a and b may have no value (to be equals to null) but not both at the same time. Parser normalizes a value to store a valid interger, i.e. for -n it will contains -1 and for n it will contains 1.

Atrule

{
    "type": "Atrule",
    "name": String,
    "prelude": <AtrulePrelude> | <Raw> | null,
    "block": <Block> | null
}

AtrulePrelude

{
    "type": "AtrulePrelude",
    "children": List
}

AttributeSelector

{
    "type": "AttributeSelector",
    "name": <Identifier>,
    "matcher": String | null,
    "value": <String> | <Identifier> | null,
    "flags": String | null
}

Block

{
    "type": "Block",
    "children": List
}

Brackets

{
    "type": "Brackets",
    "children": List
}

CDC

{
    "type": "CDC"
}

CDO

{
    "type": "CDO"
}

ClassSelector

{
    "type": "ClassSelector",
    "name": String
}

Combinator

{
    "type": "Combinator",
    "name": String
}

Comment

{
    "type": "Comment",
    "value": String
}

Declaration

{
    "type": "Declaration",
    "important": Boolean | String,
    "property": String,
    "value": <Value> | <Raw>
}

DeclarationList

{
    "type": "DeclarationList",
    "children": List
}

Dimension

{
    "type": "Dimension",
    "value": String,
    "unit": String
}

Function

{
    "type": "Function",
    "name": String,
    "children": List
}

HexColor

{
    "type": "HexColor",
    "value": String
}

IdSelector

{
    "type": "IdSelector",
    "name": String
}

Identifier

{
    "type": "Identifier",
    "name": String
}

MediaFeature

{
    "type": "MediaFeature",
    "name": String,
    "value": <Identifier> | <Number> | <Dimension> | <Ratio> | null
}

MediaQuery

{
    "type": "MediaQuery",
    "children": List
}

MediaQueryList

{
    "type": "MediaQueryList",
    "children": List
}

Nth

{
    "type": "Nth",
    "nth": <AnPlusB> | <Identifier>,
    "selector": <SelectorList> | null
}

Number

{
    "type": "Number",
    "value": String
}

Operator

{
    "type": "Operator",
    "value": String
}

Parentheses

{
    "type": "Parentheses",
    "children": List
}

Percentage

{
    "type": "Percentage",
    "value": String
}

PseudoClassSelector

{
    "type": "PseudoClassSelector",
    "name": String,
    "children": List | null
}

PseudoElementSelector

{
    "type": "PseudoElementSelector",
    "name": String,
    "children": List | null
}

Ratio

{
    "type": "Ratio",
    "left": String,
    "right": String
}

Raw

{
    "type": "Raw",
    "value": String
}

Rule

{
    "type": "Rule",
    "prelude": <SelectorList> | <Raw>,
    "block": <Block>
}

Selector

{
    "type": "Selector",
    "children": List
}

SelectorList

{
    "type": "SelectorList",
    "children": List
}

String

{
    "type": "String",
    "value": String
}

StyleSheet

{
    "type": "StyleSheet",
    "children": List
}

TypeSelector

{
    "type": "TypeSelector",
    "name": String
}

UnicodeRange

{
    "type": "UnicodeRange",
    "value": String
}

Url

{
    "type": "Url",
    "value": <String> | <Raw>
}

Value

{
    "type": "Value",
    "children": List
}

WhiteSpace

{
    "type": "WhiteSpace",
    "value": String
}