bem/bem-tools

##### BEM.create.mod()

Создание модификатора блока или модификатора элемента.

 * **String** `level` директория уровня переопределения, по умолчанию текущая 
 * **String** `blockName` имя блока (обязательный параметр) 
 * **String** `elemName` имя элемента 
 * **Array** `modVal` значения модификатора 
 * **Array** `addTech` добавить перечисленные технологии к технологиям для уровня по умолчанию 
 * **Array** `forceTech` использовать только указанные технологии 
 * **Array** `noTech` исключить указанные технологии из использования 
 * **Boolean** `force` принудительно создавать файлы модификатора

 * **Array** `names` имена создаваемых модификаторов

Q.when(BEM.create.mod({ forceTechs: forceTechs, blockName: block, modVal: vals }, { names: mods }), function() { 
    console.log('Create mod %s of block %s with vals %s', elems.join(', '), block, vals.join(', ')); 
});

Q.when(BEM.create.mod({ forceTechs: forceTechs, blockName: block, elemName: elem, modVal: vals }, { names: elems }), function() { 
    console.log('Create mod %s of elem %s of block %s with vals %s', elems.join(', '), elem, block, vals.join(', ')); 
}); 
```

#### BEM.build()

Сборка файлов.

 * **String** `outputDir` директория для записи результата, по умолчанию текущая 
 * **String** `outputName` имя (префикс имени файла) для записи результата 
 * **Level** `outputLevel` объект уровня переопределения, на котором нужно создать файлы БЭМ сущности 
 * **String** `block` название блока 
 * **String** `elem` название элемента 
 * **String** `mod` название модификатора 
 * **String** `val` значение модификатора 
 * **String** `declaration` имя файла декларации использования (обязательный параметр) 
 * **Array** `level` уровень переопределения 
 * **Array** `tech` собирать файлы указанных технологий

Вы можете использовать один из следующих вариантов для задания префикса для сохранения результата сборки:

 * `outputName` для задания полного пути-префикса 
 * `outputDir` плюс `outputName` для задания пути для директории и префикса файлов (они будут склеены автоматически) 
 * `outputLevel` плюс свойста, описывающие БЭМ сущность: `block`, `elem`, `mod` и `val` (путь-префикс будет построен 
   автоматически на базе правил маппинга сущностей в файлы, заданных для уровня)

```js 
var Q = require('q'), 
    B = require('bem'), 
    BEM = B.api,

    decl = 'page.deps.js', 
    outputDir = 'build', 
    outputName = 'page', 
    levels = ['blocks-common', 'blocks-desktop'], 
    techs = ['css', 'js'];

// используем outputDir и outputName 
Q.when( 
    BEM.build({ 
        outputDir: outputDir, 
        outputName: outputName, 
        declaration: decl, 
        level: levels, 
        tech: techs 
    }), 
    function() { 
        console.log('Finished build of techs %s for levels %s. Result in %s/%s.* files.', 
            techs.join(', '), levels.join(', '), outputDir, outputName); 
    } 
);

// используем outputLevel 
var level = B.createLevel('path/to/level'), 
    block = 'page'; 
Q.when( 
    BEM.build({ 
        outputLevel: level, 
        block: block 
    }), 
    function() { 
        console.log('Finished build of techs %s for levels %s. Result in %s.* files.', 
            techs.join(', '), levels.join(', '), level.getRelByObj({ block: block })); 
    } 
); 
```

#### BEM.decl

Команды для работы с декларациями использования.

##### BEM.decl.merge()

Объединение деклараций.

 * **String** `output` файл для записи результата, по умолчанию STDOUT 
 * **Array** `declaration` имя файла декларации использования (обязательный параметр)