@spec parse(String.t()) :: [selector_chain()]

Parses a CSS selector string into a list of selector chains.

Each chain is a list of {combinator, selector} tuples where combinator indicates the relationship to the previous selector in the chain.

Combinators

• nil - First selector in chain (no combinator)
• :descendant - Descendant combinator (space)
• :child - Child combinator (>)
• :adjacent_sibling - Adjacent sibling combinator (+)
• :general_sibling - General sibling combinator (~)

Examples

iex> PureHTML.Query.Selector.Parser.parse("div")
[[{nil, %PureHTML.Query.Selector{type: "div"}}]]

iex> PureHTML.Query.Selector.Parser.parse("div > p")
[[{nil, %PureHTML.Query.Selector{type: "div"}}, {:child, %PureHTML.Query.Selector{type: "p"}}]]

iex> PureHTML.Query.Selector.Parser.parse("div p")
[[{nil, %PureHTML.Query.Selector{type: "div"}}, {:descendant, %PureHTML.Query.Selector{type: "p"}}]]

iex> PureHTML.Query.Selector.Parser.parse(".a, .b")
[[{nil, %PureHTML.Query.Selector{classes: ["a"]}}], [{nil, %PureHTML.Query.Selector{classes: ["b"]}}]]