cc @andrewblond @zxqfox @arikon @SevInf @narqo @scf2k @veged

https://github.com/bem/bem-talk/issues/2#issuecomment-28503961

Мой список:

• API для манипуляции уровнями
  • создать уровень
  • получить мета-информацию об уровне (путь, схема маппинга БЭМ <-> fs)
  • получить путь на fs для БЭМ-сущности (по объекту-дескриптору или строковому id)
  • получить объект-дескриптор БЭМ-сущности по пути на fs
  • получить список БЭМ-сущностей на уровне
• API для работы с упорядоченными множествами БЭМ-сущностей
  • map / reduce / filter / transform
• API для работы с зависимостями
  • хелперы для вычисления зависимостей БЭМ-сущности
    • парсинг deps.js
    • парсинг deps.yml
    • парсинг js файлов с модульной системой или i-bem декларациями
  • инкрементальное накопление информации о зависимостях (последовательный парсинг и сложение множеств)
  • merge / subtract / intersect
  • вычисление упорядоченного множества БЭМ-сущностей из объектной модели дерева зависимостей по заданным критериям

DB-like интерфейс к БЭМ-проекту. Не отдает наружу никаких знаний об организиации файлов, позволяет манипулировать БЭМ-сущностями на высоком уровне. Список операций:

• BEMDB.open('/path/to/project') - создание нового инстанса, единственное место где фигурирует какой-либо файловый путь.
• BEMDB.getLevels() - возвращает список типизорованных уровней проекта.
• Level.getBlocks() - получить список блоков на уровне.
• Level.get(block, [elem], [mod], [val]) - получить конкретную бэм-сущность с уровня.
• Level.put(block, [elem], [mod], [val]) - добавить бэм-сущность на уровень.
• дополнительные возможности, зависящие от типа уровня. Для уровня бандлов это может быть, например, список исходных блоков.
• BemEntity.get(suffix) - получить контент исходника для бэм-сущности.
• BemEntity.put(suffix, content) - записать контент.
• Полее сложные запросы с фильтрацией, группировкой, map, reduce.

Может строится поверх более простого модуля 'Storage', который будет инкапсулировать в себе всю работу с физическим расположением файлов. Таким образом, возможна будет работа с различными типам хранилищ, не только с FS.

@SevInf Есть примеры, когда недостаточно fs? Реальные из жизни ;)

@arikon

1. Создаешь блок динамически в какой-то админке, как его использовать в сборке без сохранения на диск?
2. Загружаем блоки через веб, как? Поднимать fuse ради этого? Ну и т.д. Задачи необычные, но из реальной жизни.

И вопрос тут больше не в том, что это не нужно в реальной жизни, а в том, что есть завязка на FS, это значит, что все технологии, все модули должны будут обладать информацией о том, как строятся пути, это значит, что levels будет выбрасывать кишки наружу, в итоге ничего не изменится толком. Если можно сразу сделать правильно — почему не сделать?

это значит, что все технологии, все модули должны будут обладать информацией о том, как строятся пути, это значит, что levels будет выбрасывать кишки наружу, в итоге ничего не изменится толком.

Им не надо ничего этого знать. Схема именования заключена в уровне. Спросил у уровня путь для такого-то блока - получил. Никаких кишок.

Есть ещё идеи?

@scf2k спросил у уровня — это уже не high-level, не хочется выкидывать внутреннее API, поскольку потом ничего с ним нельзя будет сделать. @arikon Думаю, что ключевая идея — это работа с блоками как с множествами или кортежами. На ум приходят taffydb, или некая ORM, все остальное выкидывать в API нужно крайне осторожно. multum in parvo

спросил у уровня — это уже не high-level, не хочется выкидывать внутреннее API, поскольку потом ничего с ним нельзя будет сделать.

Не понял.

@scf2k high-level это

блок('not-a-button').создатьМодификатор({...}).then(...).fail(...);
проект.получитьСписокБлоков().filter(...); // массив или array-like объект со списком доступных блоков
блок('page').получитьМодификаторы(); // тот же array-like со списком модификаторов
технология('js').получитьЗависимости() // вернет coffee, если он доступен.
// etc.

В #10 начал описывать API модуля bem-deps.

Предлагаю начать с него, потому что это вполне понятная штука, и её можно опробовать сразу на текущих версиях enb и bem-tools. Кроме того, в bem-tools работа с зависимостями реализована сейчас очень запутанно, и там есть баги. Ни один разработчик, который пытался там что-то исправить, не вернулся (кроме меня и @veged).

Этот модуль начнёт сразу приносить пользу после релиза ;)

Завёл топик для сбора текущих ограничений в выражении зависимостей #11. Добавляйте свои случаи.

@arikon а когда релиз?)

@zxqfox Когда напишем, очевидно ;)