Плагин MEL для Android Studio

Довести нынешний базовый JEditorPane-инспектор до выбранного в дизайне варианта D: упорядоченная палитра, разделитель на каждое поле, действия-на-месте (self-переходы с ключом команды, debounce, интентами-результатами, эффектами), всё с кликом в исходник.

Польза: держит диаграмму чистой для плотных состояний (у Content 7 self-переходов), а детали — читаемы и навигируемы по запросу.

Иконка стейт-машины в gutter рядом с каждой on<State,Intent>{}, start(), subscribe<> и листом-состоянием; клик открывает граф, сфокусированный на этом узле/ребре.

Польза: двусторонняя навигация код↔граф и узнавание MEL-клеток с одного взгляда.

Показать 26 PSI-правил :tools:detekt-rules живыми инспекциями IntelliJ с подсветкой в редакторе, а не только на сборке (правила уже чисто-PSI и работают инкрементально).

Польза: мгновенная обратная связь по нарушениям MEL прямо при наборе.

Quick-fix-интенции к инспекциям: throw в reduce → эффект /ShowError, ручной collect потока → subscribe<>, добавить пропущенный onError, сырой конструктор фреймворка → MEL-фабрика, is-проверка → клетка on<>.

Польза: каждое нарушение лечится одним нажатием — дешевле писать идиоматичный MEL и переносить с v3.

Отдельная вкладка тул-виндоу: находит конструкции v3 (Mutator/хендлеры, Listen-эффекты, type-checks) и предлагает MEL-маппинг (хендлеры → on<>, Listen-эффект → команда/подписка, переформовка sealed), повторяя примеры из mel-migration.

Польза: ведёт по конкретным повторяющимся шагам переноса легаси-экранов — главный барьер внедрения.

Дерево/outline выбранной машины: состояния (с бейджами start/overlay/terminal и фактами) → их клетки on<> → эффекты/команды/результаты, плюс ветка подписок. На той же модели MelGraphExtractor.

Польза: быстрый текстовый индекс машины для навигации и ревью — дополнение к графу для тех, кто мыслит деревьями.

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

Польза: рассуждать о достижимости и потоке («что будет, если послать Rescan из Content?») без сборки и тапов по живому экрану.

Второй режим диаграммы: команды (ключ, debounce, интенты-результаты успеха/ошибки) и подписки (ключ, скоуп-состояния, испускаемые интенты, onError) как узлы, связанные с состояниями, которые их «взводят», и интентами, что они подают обратно.

Польза: делает невидимый async-слой явным — видно, какие состояния взводят какие команды/подписки и где циклы обратной связи.

Сравнить граф экрана между двумя git-ревизиями (рабочее дерево vs HEAD или любые два коммита) и визуально диффнуть: добавленные/удалённые состояния и рёбра, изменения ключей команд, debounce, эффектов, скоупа подписок — с цветовой разметкой.

Польза: показывает поведенческие изменения машины в терминах ревьюера, а не стеной Kotlin-диффа.

Расширить Find Usages: от интента или состояния прыгать туда, где он объявлен в контракте, где обработан (on<>) или порождён (результат команды / эмит подписки) и где отрисован/диспатчится в Compose-view.

Польза: объединяет три слоя MEL под одним жестом — трассировать интент end-to-end без ручного текст-поиска по файлам.

Действие New → MEL Screen: генерит контракт (sealed State/Intent/Effect), скелет машины (start(), пара on<>, заглушка subscribe<>) и Compose-view + проводку melViewModel, с пакетом и именами из целевого модуля.

Польза: убирает бойлерплейт и зашивает канонический layout файлов — новые экраны идиоматичны by construction.

Шаблоны редактора для частых клеток: on<S,I>{ next/push/pop/stay }, start(), subscribe<>(key){} с onError, блок команды с результатами, лист-состояние с фактами; postfix-варианты на имени состояния.

Польза: ускоряет ручное письмо машин и навязывает правильную форму конструкций (например всегда предлагает слот onError).

Бейджи на узлах и рёбрах диаграммы по MEL-находкам detekt в их исходном диапазоне (например значок-предупреждение на клетке, у которой reduce с побочками), с кликом-в-фикс.

Польза: связывает архитектурный линт с визуальной моделью — проблемы видны ровно там, где живёт нарушающее поведение.

Одно действие — отдать диаграмму экрана (Mermaid или PNG, плагин уже умеет) прямо в формат docs/-сайта MEL (например в mel-migration.html или пер-экранную страницу), а не копировать руками.

Польза: держит опубликованную документацию MEL в синхроне с кодом без ручного сопровождения диаграмм.

Minimap-обзор для навигации по большим машинам и focus-режим, гасящий всё кроме выбранного узла и его 1-hop-окрестности (входящие/исходящие рёбра, взведённые команды, скоуп-подписки).

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

Статически флагать интенты из контракта, которые не обрабатывает ни одна on<>; состояния, недостижимые ни одним ребром; интенты-результаты команд, которые никто не обрабатывает — как бейджи на графе и как предупреждения.

Польза: ловит неполные/устаревшие машины (сироты-интенты, недостижимые состояния), которые компилируются, но это мёртвое или отсутствующее поведение.

Экстрактор уже метит рёбра, чью цель нельзя резолвить статически (next(EXPR) со сложным выражением), как to=null. Рисовать их пунктирными «висячими» рёбрами и подсказывать сделать цель статически анализируемой.

Польза: делает границы статического анализа видимыми и подталкивает код к формам, понятным графу (и ревьюеру).

Модель уже хранит, из какой секции (include(...)) пришла клетка on<> или подписка. Красить/группировать узлы и рёбра по секции-источнику и дать фильтр «показать одну секцию».

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