Repository navigation
v3.0.0
🚀 Release v3.0.0 — Интрузивный граф (NodeLink), пулинг памяти и O(1) трекинг
Мажорный релиз v3.0.0 переводит реактивное ядро @pravosleva/reactive-engine с хэш-таблиц (Set / Map) на двунаправленные интрузивные связи (NodeLink), пулинг объектов (LinkPool) и курсорное переиспользование зависимостей за O(1).
При сохранении 100% обратной совместимости публичного API, DI-контейнера, транзакционного логгера и адаптеров для React, Vue и Angular, библиотека вышла на паритет с @vue/reactivity по семантике графа (159 из 161 тестов, 98.8%) и ускорилась в десятки раз на высоконагруженных сценариях.
Результаты аудита и бенчмарков (Ноябрь 2026)
1. Семантика графа (reactive-framework-test-suite)
- Pass Rate: 98.8% (159 / 161 тестов, 100% coverage) — уровень
@vue/reactivity3.5.45. - Исправлены все 3 теста секции Inner Write (#180, #182, #186): Побочные записи из
computedбольше не приводят к рассинхронизации каналов и застреванию кэша.
2. Производительность (js-reactivity-benchmark)
Живой PR transitive-bullshit/js-reactivity-benchmark#18
Геометрическое среднее времени выполнения относительно самого быстрого движка в каждом семействе нагрузок (меньше — лучше, 1.00× — абсолютный лидер):
| Движок | kairo |
mol |
dynamic |
cellx |
s |
|---|---|---|---|---|---|
alien-signals (3.2.1) |
1.00× | 1.03× | 1.00× | 1.10× | 1.02× |
Preact Signals (1.14.4) |
1.19× | 1.03× | 1.52× | 1.32× | 1.37× |
@pravosleva/reactive-engine (3.0.0) |
1.69× | 1.06× | 1.30× | 1.22× | 3.69× |
@vue/reactivity (3.5.44) |
1.89× | 1.00× | 2.03× | 1.51× | 1.54× |
@amadeus-it-group/tansu (2.0.0) |
2.79× | 1.10× | 2.47× | 2.23× | 3.22× |
@angular/signals (22.1.7) |
2.72× | 1.05× | 3.32× | 1.63× | 3.29× |
SolidJS (1.9.17) |
3.78× | 1.27× | 4.39× | 1.63× | 3.89× |
Svelte v5 (5.57.0) |
3.92× | 1.03× | 2.80× | 111.18× | 3.40× |
MobX (7.0.6) |
4.41× | 1.28× | 4.37× | 2.54× | 4.90× |
updateComputations1000to1:4.79 мс(в 220 раз быстрее v2.7.2 и быстрееalien-signals—7.25 мс).1000x5 - 25 sources(wide dense):681.5 мс(почти в 2 раза быстрее@vue/reactivityи в 3 раза быстрееSolidJS).
Что нового в версии 3.0.0
- Двунаправленные интрузивные связи (
NodeLink) иLinkPool: Вместо созданияSetиMapна каждый узел графа связи представлены плоскими мономорфными объектамиNodeLink. При разрыве подписки ребро не удаляется в кучу, а обнуляется и возвращается в статический пулLinkPoolдля переиспользования без нагрузки на Garbage Collector. - Курсорный трекинг зависимостей за O(1): При перерасчёте узла курсор
depsCursorдвижется по существующему списку зависимостей. Если порядок чтения не изменился, переподписка выполняется за O(1) без поиска и переаллокаций. - Мономорфные классы узлов (
SignalNode,ComputedNode): Объединение внутреннего узла и публичной обёртки в единый прототипный класс с ленивой инициализацией коллекций ускорило создание сигналов в 9 раз. - Полная поддержка React 18/19
StrictMode: ХукuseReactiveValueпереведён на синхронный счётчик версий (useRef) дляuseSyncExternalStoreс защитой от преждевременного каскадного уничтожения ленивыхcomputedпри двойном монтировании в режиме разработки.
⚠️ Анализ ограничений и меры предосторожности (Тесты #212 и #213)
В реальных кейсах при повседневной разработке таким ограничениям места пока не нашел.
Два оставшихся граничных теста (#212 и #213) в reactive-framework-test-suite связаны с динамическим самоуничтожением или переподпиской внутри уже выполняющейся волны обновлений (Mid-Propagation Disposal & Re-subscription).
В v3.0.0 ради максимальной скорости O(1)-итерации и предсказуемости топологического порядка (EffectScheduler) обход подписчиков NodeLink опирается на целостность указателей текущего кадра. Если во время одной синхронной транзакции происходит одновременное изменение топологии и уничтожение промежуточных узлов, возможны редкие граничные эффекты.
Ниже приведены оба сценария, примеры потенциальных ошибок на практике и способы их безопасного обхода.
❌ Тест #212: Уничтожение эффекта из соседнего эффекта в одной волне обновлений (Sibling Disposal Mid-Wave)
Что проверяет тест: Ситуацию, когда два эффекта (effectA и effectB) подписаны на один и тот же сигнал trigger. При изменении trigger первый эффект (effectA) императивно вызывает disposeB() (уничтожает второй эффект), но из-за того, что effectB уже поставлен в текущий бакет планировщика или его ссылка nextSubscriber уже захвачена в цикле уведомлений, он успевает сработать один лишний раз перед утилизацией.
import { ReactiveEngine } from '@pravosleva/reactive-engine'
const engine = new ReactiveEngine()
const trigger = engine.signal(0, 'trigger')
// ❌ АНТИПАТТЕРН (воспроизводит граничный случай теста #212)
// Один эффект императивно уничтожает другой эффект прямо во время общей волны уведомлений
const disposeB = engine.effect(() => {
if (trigger.value > 0) {
// Может успеть выполниться в этом же тике, даже если disposeA вызван раньше
console.log('Effect B:', trigger.value)
}
})
engine.effect(() => {
if (trigger.value === 1) {
disposeB() // Императивная отписка соседа в середине волны
}
})
trigger.value = 1✅ Как надо (Безопасный обход паттерна #212)
Вместо императивного вызова dispose() из соседнего эффекта используйте декларативное ветвление внутри самого эффекта или контрольный сигнал активности (isActive), который проверяется в начале вычисления:
import { ReactiveEngine } from '@pravosleva/reactive-engine'
const engine = new ReactiveEngine()
const trigger = engine.signal(0, 'trigger')
const isBEnabled = engine.signal(true, 'isBEnabled')
// ✅ КАК НАДО: Декларативное управление жизненным циклом через состояние
engine.effect(() => {
if (!isBEnabled.value) return // Мгновенный выход и автоматическая отписка от trigger
if (trigger.value > 0) {
console.log('Effect B:', trigger.value)
}
})
// Либо выносите императивную очистку за пределы синхронного тика через queueMicrotask:
// queueMicrotask(() => disposeB())❌ Тест #213: Динамическая смена зависимостей в сочетании с возвратом к старому значению в одном батче (Branch Switch + Net-Zero Revert)
Что проверяет тест: Сложную комбинацию, когда внутри одного batch() узел сначала переключает ветку зависимостей с a на b, мутирует b, а затем возвращает исходный флаг обратно на a (Net-Zero откат), в то время как a также менялся внутри этого же батча. При оптимизации Net-Zero отката движок сравнивает начальное и конечное значения сигнала на выходе из транзакции, что при одновременной смене топологии ветвей может пропустить промежуточную перестройку курсора.
import { ReactiveEngine } from '@pravosleva/reactive-engine'
const engine = new ReactiveEngine()
const useBranchA = engine.signal(true, 'useBranchA')
const a = engine.signal(1, 'a')
const b = engine.signal(10, 'b')
const result = engine.computed(() => {
return useBranchA.value ? a.value : b.value
})
// ❌ АНТИПАТТЕРН (воспроизводит граничный случай теста #213)
// В одном батче переключаем ветку туда-обратно и одновременно мутируем оба источника
engine.batch(() => {
useBranchA.value = false // Переключили на ветку B
b.value = 20
useBranchA.value = true // Вернули обратно на ветку A (Net-Zero для флага)
a.value = 1 // Значение A осталось прежним
})✅ Как надо (Безопасный обход паттерна #213)
Не смешивайте в одном синхронном batch() переключение управляющих флагов ветвления туда-обратно и мутацию данных обеих веток. Разделяйте изменение режима работы (переключение ветки) и обновление данных на последовательные шаги либо фиксируйте итоговое состояние флага до входа в батч:
import { ReactiveEngine } from '@pravosleva/reactive-engine'
const engine = new ReactiveEngine()
const useBranchA = engine.signal(true, 'useBranchA')
const a = engine.signal(1, 'a')
const b = engine.signal(10, 'b')
const result = engine.computed(() => {
return useBranchA.value ? a.value : b.value
})
// ✅ КАК НАДО: Вычисляем итоговое состояние управляющего флага до мутации стейта
const nextBranch = true
engine.batch(() => {
useBranchA.value = nextBranch
if (nextBranch) {
a.value = 2
} else {
b.value = 20
}
})