Подключение сервисов к UI-фреймворкам (View Layer Integration)
Ключевая архитектурная особенность @pravosleva/reactive-engine v3.0.1 заключается в полном отделении бизнес-логики и графа состояния (signal, computed, resource, AbstractService) от конкретного фреймворка рендеринга.
Один и тот же слой сервисов может одновременно обслуживать приложение на React, Vue 3, Angular или чистом DOM (Vanilla JS) без переписывания бизнес-правил и тестов.
Единый принцип интеграции
Независимо от выбранного фреймворка, связывание UI с реактивным ядром строится по трёхшаговой схеме:
- Изоляция бизнес-логики в
AbstractService: Компоненты не хранят в себе сложную логику запросов, кэширования или валидации — они лишь получают готовый инстанс сервиса черезengine.inject(MyService). - Точечная подписка на чтение (Fine-Grained Subscription): UI-компонент подписывается только на те сигналы и вычисляемые свойства, которые непосредственно отображает в шаблоне (через
useSyncExternalStoreв React,shallowRef/ адаптер во Vue илиengine.effectв Vanilla JS). - Декларативный вызов команд: Пользовательские события (клики, ввод текста, отправка форм) передаются обратно в сервис через вызов его публичных методов (
service.submit(),service.toggleTodo(id)).
Готовые руководства по фреймворкам
Подробные примеры интеграции, готовые адаптеры и рекомендации по оптимизации рендеринга для конкретных платформ вынесены в отдельные разделы Быстрого старта:
- Интеграция с Angular 20+ — преобразование сигналов, вычисляемых свойств и Proxy-объектов в Angular Signals через
toAngularSignalс автоматической очисткой черезDestroyRef. - Интеграция с React 18+ — подключение сервисов через
engine.use()иuseReactiveValueна базе нативногоuseSyncExternalStoreбез лишних ререндеров. - Интеграция с Vue 3.2+ — связывание примитивов ядра с
ShallowRefчерезengine.use()/useReactiveValueс автоматической очисткой вonScopeDispose. - Чистый JavaScript и DOM (Vanilla JS) — прямая привязка эффектов
engine.effect()и ресурсов к DOM-узлам без виртуального DOM.
Архитектурные советы при работе с UI
- Передавайте инстанс
ReactiveEngineчерез DI или Context дерева компонентов: Избегайте жёсткой привязки компонентов к глобальному модульному синглтону, если приложение поддерживает SSR или рендерит несколько независимых виджетов на одной странице (подробнее в разделе Изоляция инстансов и кросс-движковые мосты). - Не дублируйте состояние сервиса в локальном стейте компонентов: Если данные уже живут в
service.items.valueилиservice.form, не копируйте их вuseStateилиrefбез необходимости — держите единый источник истины внутри сервиса.