MEL

Экран как маленькая стейт-машина: что показываем, какие события приходят и как одно превращается в другое.

Реализовано в модулях :core:mel + :core:mel-test + :core:mel-compose-material, опубликовано как ru.sberbank_sbbol.mel 0.2.0. Документы ниже — учитесь, переносите, сверяйтесь с каноном, подключайте проверки и ставьте плагин.

Учебное

Руководствоначните здесь

mel-guide.html

Как пользоваться MEL по шагам, простым языком и с диаграммами: от идеи и клетки до машины, эффект-слоя и правил.

17 шагов · для тех, кто пишет экран

Открыть руководство Перенос

Примеры переноса

mel-migration.html

Перенос экранов из MVI v3 в MEL: код «до / после» и развилки с вопросами. Пример 1 — Listen-эффект → команда/подписка.

v3 → MEL · паттерн на раздел, растёт

Открыть примеры Канон

Спека

mel-design.html

Каноническая архитектура и инварианты: стейт-машина вместо карт обработчиков. Формальная модель и точные гарантии рантайма.

источник истины после кода

Открыть спеку Проверки

Detekt-правила

mel-detekt.html

Как подключить набор mel к сборке и какие 26 проверок архитектуры он ловит: машина без корутин, контракты-данные, чистый reduce, async-слой.

26 правил · ruleset mel · подключение + каталог

Открыть detekt-гайд Инструмент

Плагин для IDE

mel-plugin.html

Плагин MEL для Android Studio: тул-окно с каталогом экранов, графом состояний, инспектором, превью и проблемами; 26 инспекций в редакторе. Установка, совместимость, планы.

установка · что умеет · что дальше

Открыть плагин

С чего начать Никогда не видели MEL — идите в Руководство. Переносите экран из MVI v3 — в Примеры переноса. Нужны точные инварианты и формулировки — в Спеку. Подключаете статические проверки к сборке — в Detekt-правила. Хотите видеть граф экрана и нарушения прямо в студии — в Плагин для IDE.

Источник истины — код в :core:mel, затем спека, затем руководство и примеры. Если документы разойдутся с кодом — прав код.