Lego-модули: рабочая композиция моно-модулей
Сложный блок с серверной отрисовкой (SSR) из самостоятельных участников: один владелец состояния, общий протокол и именованные места.

Сложный блок без монолита
Lego-композиция связывает готовые секции декларацией module.compose.json. Координатор задаёт раскладку и именованные места для серверной отрисовки, существующий state_owner хранит данные, а модули представления и действий занимают свои места.
В примере каталога product_vitrine по-прежнему отвечает за товары, фильтры, пагинацию и состояние адреса. catalog_listing не выполняет второй запрос и не создаёт второе дерево Vue.
Участники композиции
У каждой роли одна ясная ответственность.
Координатор
Владеет раскладкой и объявляет именованные места для серверной отрисовки, но не дублирует данные.
Владелец состояния
Единственный источник истины: данные, состояние, пагинация и адрес страницы.
Источник данных
Основная секция, которую координатор помещает в главное именованное место.
Представление
Показывает состояние владельца — например, панель фильтров.
Протокол
Версионированный договор совместимости всех участников.
Именованное место
Область координатора, предназначенная для целой дочерней секции.
Рабочий пример каталога
catalog_listing координатор, раскладка
├── filters
│ └── catalog_filter_panel необязательное представление
└── listing
└── product_vitrine владелец состояния и источник данныхКоординатор
{
"composition": {
"protocol": "catalog.view.v1",
"role": "coordinator",
"state_owner": "product_vitrine",
"slot": "listing",
"children": [
{
"slot": "filters",
"module": "catalog_filter_panel",
"optional": true
}
]
}
}Владелец состояния и источник данных
{
"composition": {
"protocol": "catalog.view.v1",
"role": "data_source",
"state_owner": "product_vitrine",
"slot": "listing"
}
}Дочернее представление
{
"composition": {
"protocol": "catalog.view.v1",
"role": "presentation",
"state_owner": "product_vitrine",
"slot": "filters",
"optional": true
}
}Все участники используют одну версию договора в поле protocol. Поле composition записывается штатно через module_update_compose.
Сначала серверная отрисовка, затем улучшения
После обычной отрисовки ядро находит координатор, проверяет стабильные ссылки, протокол и именованные места, выбирает ровно одного владельца и переносит готовые секции в маркеры. Браузер сразу получает содержательный HTML.
Если связь неполна, обязательная дочерняя секция отсутствует или участники неоднозначны, ядро ничего не поглощает: независимые секции остаются видимыми. Отсутствующая необязательная секция просто оставляет свободное место.
Маркеры именованных мест в шаблоне
Каждое именованное место из поля slot должно присутствовать в шаблоне координатора в двух точных формах: атрибут для браузерной части и буквальный комментарий для серверного размещения.
<section data-bnx-composition-state="pending">
<aside data-bnx-composition-slot="filters">
<!-- bnx:composition-slot:filters -->
</aside>
<main data-bnx-composition-slot="listing">
<!-- bnx:composition-slot:listing -->
</main>
</section>После успешного размещения ядро меняет состояние pending на mounted и убирает поглощённые секции с прежних позиций.
В v1 композиция переносит целые секции. Перенос внутреннего элемента остаётся улучшением в браузере, за которое отвечает сам модуль представления.
Как подключить готовую композицию
Пользователю достаточно подготовить основной блок и описать результат — совместимость и целостность установки проверит платформа.
Откройте нужную страницу
Выберите в Studio страницу, на которой должен появиться составной блок.
Добавьте основной блок
На странице уже должен быть раздел, которому принадлежат данные и состояние. Для каталога это витрина товаров.
Выберите дополнительные части
Решите, нужны ли панель фильтров и другие необязательные элементы готовой композиции.
Опишите желаемый результат
Попросите подключённого ИИ-помощника собрать готовую композицию на выбранной странице. Пример запроса приведён ниже.
Уточните основной блок
Если на странице несколько подходящих витрин, укажите, с какой из них нужно связать композицию.
Проверьте страницу
Откройте предпросмотр на широком и мобильном экране: данные не должны дублироваться, а все части должны занимать свои места.
Пример запроса к ИИ-помощнику
Вместо перечисления служебных команд опишите помощнику результат обычными словами:
На странице «Каталог» объедини существующую витрину товаров с панелью фильтров в композицию
catalog_listing. Используй витрину как основной блок с данными, подключи необязательные части и проверь результат на настольной и мобильной ширине.
Что сделает платформа
- сохранит витрину единственным владельцем товаров, фильтров, пагинации и адреса страницы;
- проверит совместимость всех частей до изменения страницы;
- добавит координатор и связанные разделы одной операцией;
- не создаст дубликаты при повторной установке;
- при удалении композиции сохранит основной блок с данными.
Если на странице несколько витрин, добавьте в запрос название или номер нужного раздела. Не редактируйте файл страницы вручную: тогда установка потеряет проверку целостности.
Что произойдёт в сложных случаях
Композиция устроена так, чтобы ошибка связи не скрывала полезный HTML, собранный сервером.