tiny-css-parser

Tiny Css Parser
===============

[![Install size][size-image]][size-url] [![Dependencies][deps-image]][deps-url] [![NPM version][npm-image]][npm-url]

A very small css parser.

Consists of a lazy tokenizer, a lazy parser and an incremental tree builder.
Both the tokenizer as well as the parser produce a stream of tokens.

The parser inserts properly balanced start and end tokens into the stream,
effectively producing a traversal of the full parse tree. This stream can be fed to the tree builder to incrementally build an object tree from the stream.

[npm-image]: https://img.shields.io/npm/v/tiny-css-parser.svg
[npm-url]: https://npmjs.org/package/tiny-css-parser
[deps-image]: https://img.shields.io/david/alwinb/tiny-css-parser.svg
[deps-url]: https://david-dm.org/alwinb/tiny-css-parser
[size-url]: https://packagephobia.com/result?p=tiny-css-parser
[size-image]: https://packagephobia.com/badge?p=tiny-css-parser

Example
-------

To parse a stylesheet into an object tree:

``javascript
var css = require ('tiny-css-parser')
var tree = css.parseTree ('#menu { padding:0; margin:0; display:block }')
console.log (tree)
`

To lazily parse and traverse a stylesheet:

`javascript
var stream = css.parse ('#menu { padding:0; margin:0; display:block }')

for (var token of stream)
console.log (token)
`

It is possible to query the stream for state info and source position,
as follows:

`javascript
var stream = css.parse ('#menu { padding:0; margin:0; display:block }')

for (var token of stream)
console.log (token, stream.state)
`

API
---

- tokenize (string) (generator function)
- parse (string) (generator function)
- parseTree (string) (function)
- tokens` (object/ dictionary)