# CSSP API

## Подключение API

При установленном CSSP подключение API происходит так: `require('cssp')`. После чего использовать API можно примерно так:

    var cssp = require('cssp'),
        src = 'a { color: red }',
        tree;
    ..
    tree = cssp.parse(src);
    ..

## Получение объектов CSSP

    ..
    var CSSParser = require('cssp').CSSParser,
        CSSTransformer = require('cssp').CSSTransformer,
        CSSTranslator = require('cssp').CSSTranslator;
    ..

## P: разбор CSS в дерево

Функция: `tree = parse(src, [rule = 'stylesheet'], [parser = undefined])`

Аргументы:

* `src` — исходный текст CSS в виде строки; обязательно.
* `rule` — правило максимального уровня; опционально.
* `parser` — парсер, который следует соединить с базовым парсером; опционально.

Возвращает: дерево, представляющее исходный CSS.

## TF: трансформация

Функция: `tree = transform(tree, [rule = 'stylesheet'], [transformer = undefined])`

Аргументы:

* `tree` — дерево для трансформации; обязательно.
* `rule` — правило максимального уровня; опционально.
* `transformer` — трансформер, который следует соединить с базовым трансформером; опционально.

Возвращает: дерево после трансформации; если не был указан `transformer`, результат равен исходному дереву.

## TL: трансляция

Функция: `src = translate(tree, [rule = 'stylesheet'], [translator = undefined])`

Аргументы:

* `tree` — дерево для трансляции; обязательно.
* `rule` — правило максимального уровня; опционально.
* `translator` — транслятор, который следует соединить с базовым транслятором; опционально.

Возвращает: текст CSS в виде строки.

## Сериализация дерева в строку

Функция: `str = treeToString(tree, [level = 0])`

Возвращает: дерево в виде отформатированной строки.

Аргументы:

* `tree` — дерево для сериализации в строку.
* `level` — уровень начального отступа.

## Вывод дерева на консоль

Функция: `printTree(tree)`

Аргументы:

* `tree` — дерево для вывода на консоль.