Быстрый старт с Vue 3.2+
Адаптер @pravosleva/reactive-engine/vue связывает граф ядра с реактивной системой Vue 3 через расширенный ReactiveEngine (engine.use(...)) или функцию useReactiveValue(...). Адаптер возвращает строго типизированный ShallowRef<T> и автоматически отписывается при размонтировании компонента через onScopeDispose.
Установка
yarn add @pravosleva/reactive-engineБазовый пример: Счётчик
<script setup lang="ts">
import { AbstractService } from '@pravosleva/reactive-engine'
import { ReactiveEngine } from '@pravosleva/reactive-engine/vue'
class CounterLogic extends AbstractService {
public counter = this.engine.signal<number>(0, 'vue-example:counter')
public doubled = this.engine.computed(() => this.counter.value * 2, 'vue-example:doubled')
public inc = () => {
this.counter.value += 1
}
}
const engine = new ReactiveEngine()
const logic = engine.inject(CounterLogic)
// Возвращает ShallowRef<number>, автоматически очищаемый через onScopeDispose
const counter = engine.use(logic.counter)
const doubled = engine.use(logic.doubled)
</script>
<template>
<div>
<h3>Vue 3 Signal Example</h3>
<p>
Счётчик: <code>{{ counter }}</code> (x2: <code>{{ doubled }}</code>)
</p>
<button type="button" @click="logic.inc">
+ INC
</button>
</div>
</template>Работа с Proxy-коллекциями (reactive) и resource
Адаптер корректно отслеживает глубокие Proxy-массивы и объекты (engine.reactive()), создавая поверхностную копию ссылки при мутациях .push() / .splice(), чтобы шаблон Vue 3 мгновенно перерисовывался без глубокого проксирования:
<script setup lang="ts">
import { AbstractService } from '@pravosleva/reactive-engine'
import { ReactiveEngine, useReactiveValue } from '@pravosleva/reactive-engine/vue'
class CartService extends AbstractService {
public items = this.engine.reactive<string[]>(['Ноутбук'], 'vue:cart')
public addItem(name: string) {
this.items.push(name)
}
}
const engine = new ReactiveEngine()
const cart = engine.inject(CartService)
// Можно использовать как engine.use(cart.items), так и функцию useReactiveValue(cart.items)
const items = useReactiveValue(cart.items)
</script>
<template>
<div>
<button type="button" @click="cart.addItem('Монитор')">
Добавить товар
</button>
<ul>
<li v-for="(item, idx) in items" :key="idx">
{{ item }}
</li>
</ul>
</div>
</template>SSR и гидратация данных с API (Nuxt 3 onServerPrefetch + useState)
В Nuxt 3 и других SSR-фреймворках на базе Vue 3 нельзя создавать const engine = new ReactiveEngine() на верхнем уровне модуля за пределами setup() — это приведёт к пересечению данных между запросами разных пользователей на сервере.
Лучший паттерн для Nuxt 3 объединяет:
- Изоляцию инстанса внутри
<script setup>(или Nuxt-плагина на каждый запрос). - Сериализуемый контейнер
useState('ssr:article'): Nuxt автоматически сериализует его в HTML на сервере (window.__NUXT__) и восстанавливает на клиенте. onServerPrefetch: Выполняет загрузку данных по API во время серверного рендера и записывает снимок вuseState.
Шаг 1. Сервис с поддержкой гидратации (ArticleService.ts)
import { AbstractService } from '@pravosleva/reactive-engine'
export interface ArticleDto {
id: string
title: string
content: string
}
export class ArticleService extends AbstractService {
public article = this.engine.signal<ArticleDto | null>(null, 'nuxt:article')
public isLoading = this.engine.signal(false, 'nuxt:isLoading')
public error = this.engine.signal<string | null>(null, 'nuxt:error')
public async loadArticle(id: string): Promise<ArticleDto | null> {
this.isLoading.value = true
this.error.value = null
try {
const res = await fetch(`https://example.com{encodeURIComponent(id)}`)
if (!res.ok) throw new Error(`HTTP ${res.status}`)
const data: ArticleDto = await res.json()
this.article.value = data
return data
} catch (err: unknown) {
this.error.value = err instanceof Error ? err.message : 'Ошибка загрузки статьи'
return null
} finally {
this.isLoading.value = false
}
}
public hydrate(snapshot: ArticleDto | null) {
if (snapshot) {
this.article.value = snapshot
}
}
}Шаг 2. Страница Nuxt 3 (pages/articles/[id].vue)
<script setup lang="ts">
import { onServerPrefetch, onMounted } from 'vue'
import { ReactiveEngine } from '@pravosleva/reactive-engine/vue'
import { ArticleService, type ArticleDto } from '~/services/ArticleService'
const route = useRoute()
const articleId = String(route.params.id)
// 1. Создаём изолированный экземпляр ядра строго для текущего рендера/запроса
const engine = new ReactiveEngine()
const service = engine.inject(ArticleService)
// 2. Контейнер Nuxt useState автоматически переносит данные с сервера на клиент
const ssrSnapshot = useState<ArticleDto | null>(`article:${articleId}`, () => null)
// 3. На клиенте мгновенно гидратируем сигнал из снимка до первого рендера шаблона
if (ssrSnapshot.value) {
service.hydrate(ssrSnapshot.value)
}
// 4. На сервере дожидаемся загрузки по API и сохраняем результат в useState
onServerPrefetch(async () => {
const loaded = await service.loadArticle(articleId)
ssrSnapshot.value = loaded
})
// 5. На клиенте догружаем данные только при SPA-переходе, если снимка ещё нет
onMounted(() => {
if (service.article.value?.id !== articleId) {
void service.loadArticle(articleId)
}
})
// Подписываем шаблон Vue 3 на сигналы сервиса
const article = engine.use(service.article)
const isLoading = engine.use(service.isLoading)
const error = engine.use(service.error)
</script>
<template>
<div>
<p v-if="isLoading && !article">Загрузка статьи...</p>
<p v-else-if="error">Ошибка: {{ error }}</p>
<article v-else-if="article">
<h1>{{ article.title }}</h1>
<p>{{ article.content }}</p>
</article>
</div>
</template>Важные особенности адаптера
- Использование
ShallowRefвместо глубокогоref: Адаптер намеренно возвращаетShallowRef, чтобы Vue 3 не оборачивал данные из ядра во второй слой собственныхProxyи не тратил CPU на рекурсивный обход больших структур. - Автоматическая очистка через
onScopeDispose: Подписка на ядро удаляется автоматически при уничтожении компонента или закрытииeffectScope().