Skip to content

v3.0.0

Choose a tag to compare

@pravosleva pravosleva released this 13 Nov 09:37
· 6 commits to main since this release

🚀 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/reactivity 3.5.45.
  • Исправлены все 3 теста секции Inner Write (#180, #182, #186): Побочные записи из computed больше не приводят к рассинхронизации каналов и застреванию кэша.

2. Производительность (js-reactivity-benchmark)

Живой PR transitive-bullshit/js-reactivity-benchmark#18

Ожидаю что-то вроде этого:
latest-benchmark_reactiveEngine@3 0 0-alpha 6

Геометрическое среднее времени выполнения относительно самого быстрого движка в каждом семействе нагрузок (меньше — лучше, 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
  }
})