@pravosleva/reactive-engine 0.3.6-beta → 0.3.8-beta

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/core.ts","../src/decorators/createObserver.tsx","../src/decorators/withCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\n// export abstract class BaseService {\n//   constructor(protected engine: ReactiveEngine) {\n//     // Вызываем метод инициализации, который можно переопределить в наследниках\n//     this.onInit();\n//   }\n\n//   // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n//   // Удобно для инициализации сигналов, которые зависят от engine.\n//   protected onInit(): void {}\n\n//   // NOTE: Полезные хелперы для сокращения кода\n//   protected createSignal<T>(val: T, name?: string) {\n//     return this.engine.signal(val, name);\n//   }\n\n//   protected createComputed<T>(fn: () => T) {\n//     return this.engine.computed(fn);\n//   }\n// }\n\nexport abstract class BaseREService {\n  constructor(protected engine: ReactiveEngine) { } // Просто сохраняем engine\n\n  protected createNumericSignal(val: number, name: string) {\n    return this.engine.signal(val, {\n      name,\n      validate: (v) => typeof v === 'number' && !isNaN(v)\n    });\n  }\n}\n","import { ReactiveEngine } from './core';\n\nexport abstract class BaseREServiceEnhanced {\n  constructor(protected engine: ReactiveEngine) {\n    setTimeout(() => this.onInit(), 0)\n  }\n\n  protected onInit(): void { }\n}\n","import { useState as useStateFromReact, useEffect as useEffectFromReact } from 'react';\n\n// --- ТИПЫ ---\nexport type CleanupFn = () => void;\nexport type EffectFn = () => CleanupFn | void;\nexport type Token<T> = string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T };\nexport type Factory<T> = (engine: ReactiveEngine) => T;\n\nexport interface IEffect {\n  run: () => void;\n  cleanups: Set<CleanupFn>;\n}\n\nexport interface ResourceState<T> {\n  data: T | null;\n  loading: boolean;\n  error: any | null;\n}\n\n/**\n * Функция для очистки эффекта.\n * @typedef {() => void} CleanupFn\n */\n\n/**\n * Функция эффекта, которая может возвращать функцию очистки.\n * @typedef {() => CleanupFn | void} EffectFn\n */\n\n/**\n * Токен для зависимости.\n * @typedef {string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T }} Token<T>\n */\n\n/**\n * Фабрика для создания сервиса.\n * @template T\n * @typedef {(engine: ReactiveEngine) => T} Factory<T>\n */\n\n/**\n * Интерфейс для эффекта.\n * @interface IEffect\n */\nexport interface IEffect {\n  /**\n   * Запуск эффекта.\n   * @function run\n   * @returns {void}\n   */\n  run: () => void;\n\n  /**\n   * Коллекция функций очистки.\n   * @type {Set<CleanupFn>}\n   */\n  cleanups: Set<CleanupFn>;\n}\n\n/**\n * Интерфейс для состояния ресурса.\n * @template T Data format\n * @interface ResourceState<T>\n */\nexport interface ResourceState<T> {\n  /**\n   * Данные ресурса.\n   * @type {T | null}\n   */\n  data: T | null;\n\n  /**\n   * Состояние загрузки ресурса.\n   * @type {boolean}\n   */\n  loading: boolean;\n\n  /**\n   * Ошибка ресурса.\n   * @type {any | null}\n   */\n  error: any | null;\n}\n\n/**\n * Интерфейс для сигнала.\n * @template T\n * @interface Signal<T>\n */\nexport interface Signal<T> {\n  /**\n   * Значение сигнала.\n   * @type {T}\n   */\n  value: T;\n\n  /**\n   * Подписка на изменение значения сигнала.\n   * @function subscribe\n   * @param {Function} cb - Коллбек функция для обработки изменения.\n   * @returns {CleanupFn} - Функция для очистки подписки.\n   */\n  subscribe: (cb: (val: T) => void) => CleanupFn;\n}\n\n/**\n * Интерфейс для вычисляемого значения.\n * @template T\n * @interface Computed<T>\n */\nexport interface Computed<T> {\n  /**\n   * Только читаемое значение вычисляемого значения.\n   * @type {T}\n   */\n  readonly value: T;\n\n  /**\n   * Подписка на изменение вычисляемого значения.\n   * @function subscribe\n   * @param {Function} cb - Коллбек функция для обработки изменения.\n   * @returns {CleanupFn} - Функция для очистки подписки.\n   */\n  subscribe: (cb: (val: T) => void) => CleanupFn;\n\n  /**\n   * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.\n   */\n  destroy: () => void;\n}\n\n\n/**\n * Интерфейс для ресурса.\n * @template T\n * @interface Resource<T>\n */\nexport interface Resource<T> extends ResourceState<T> {\n  /**\n   * Перезагрузка ресурса.\n   * @function refetch\n   * @returns {void}\n   */\n  refetch: () => void;\n\n  /**\n   * Подписка на изменение состояния ресурса.\n   * @function subscribe\n   * @param {Function} cb - Коллбек функция для обработки изменения.\n   * @returns {CleanupFn} - Функция для очистки подписки.\n   */\n  subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;\n\n  /**\n   * Только читаемое состояние ресурса.\n   * @type {ResourceState<T>}\n   */\n  readonly value: ResourceState<T>;\n}\n\n/**\n * Интерфейс для опций сигнала.\n * @template T\n * @interface SignalOptions<T>\n */\nexport interface SignalOptions<T> {\n  /**\n   * Имя сигнала.\n   * @type {string}\n   */\n  name?: string;\n\n  /**\n   * Валидатор значения сигнала.\n   * @function validate\n   * @param {T} val - Значение для валидации.\n   * @returns {boolean | string} - Результат валидации.\n   */\n  validate?: (val: T) => boolean | string;\n}\n\n// --- ЯДРО ---\n/**\n * Класс реактивного движка.\n */\nexport class ReactiveEngine {\n  private activeEffect: IEffect | null = null;\n  private isBatching = false;\n  private pendingEffects = new Set<IEffect>();\n\n  // В контейнерах DI вместо any используем unknown. Это заставит методы inject/provide\n  // явно приводить типы через дженерики <T>, защищая от рантайм-ошибок.\n  private services = new Map<Token<unknown>, unknown>();\n  private factories = new Map<Token<unknown>, Factory<unknown>>();\n\n  // Объект-ключ мапится на объект-прокси. Здесь идеально подходит тип object.\n  private proxyCache = new WeakMap<object, object>();\n  private allEffects = new Set<IEffect>();\n\n  /**\n   * Коллбек для уведомления об изменении сигнала.\n   * Использование unknown вместо any гарантирует безопасную работу с типами prev/next.\n   */\n  public onSignalChange?: (name: string, next: unknown, prev: unknown) => void;\n\n  // Описываем строгие типы для адаптеров React, чтобы не ломать встроенные типы React.\n  private reactAdapters: {\n    useState: typeof useStateFromReact;\n    useEffect: typeof useEffectFromReact;\n  } = {\n      useState: useStateFromReact,\n      useEffect: useEffectFromReact,\n    };\n\n  /**\n   * DI: Регистрация зависимости.\n   * @template T\n   * @function provide\n   * @param {Token<T>} token - Токен для зависимости.\n   * @param {T | Factory<T>} valueOrFactory - Значение или фабрика для создания сервиса.\n   * @returns {void}\n   * @source\n   */\n  public provide<T>(token: Token<T>, valueOrFactory: T | Factory<T>): void {\n    if (typeof valueOrFactory === 'function' && !valueOrFactory.prototype) {\n      this.factories.set(token, valueOrFactory as Factory<T>);\n    } else {\n      this.services.set(token, valueOrFactory);\n    }\n  }\n\n  /**\n   * DI: Инъекция; Получение сервиса по токену.\n   * @template T\n   * @function inject\n   * @param {Token<T>} token - Токен для зависимости.\n   * @returns {T} - Сервис.\n   * @source\n   */\n  public inject<T>(token: Token<T>): T {\n    if (!token) {\n      throw new Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`);\n    }\n\n    // Приводим токен к базовому типу Token<unknown> для совместимости с Map\n    const targetToken = token as Token<unknown>;\n\n    if (this.services.has(targetToken)) {\n      return this.services.get(targetToken) as T;\n    }\n\n    try {\n      const factory = this.factories.get(targetToken);\n      if (factory) {\n        const instance = factory(this) as T;\n        this.services.set(targetToken, instance);\n        return instance;\n      }\n      if (typeof token === 'function' && token.prototype) {\n        const instance = new (token as { new(eng: ReactiveEngine): T })(this);\n        this.services.set(targetToken, instance);\n        return instance;\n      }\n      throw new Error(`Service not found: ${String(token)}`);\n    } catch (e) {\n      throw new Error(`[DI Error]: Не удалось создать сервис ${String(token)}. Ошибка: ${(e as Error)?.message || 'No e?.message'}`);\n    }\n  }\n\n  /**\n   * Создание сигнала.\n   * @template T\n   * @function signal\n   * @param {T} initialValue - Начальное значение сигнала.\n   * @param {string | SignalOptions<T>} [optionsOrName] - Имя или опции сигнала.\n   * @returns {Signal<T>} - Сигнал.\n   * @source\n   */\n  public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n    const engine = this;\n    let val = initialValue;\n    const subscribers = new Set<IEffect>();\n    const options = typeof optionsOrName === 'string'\n      ? { name: optionsOrName }\n      : optionsOrName || {};\n    const name = options.name || 'unnamed_signal';\n\n    return {\n      get value(): T {\n        if (engine.activeEffect) subscribers.add(engine.activeEffect);\n        return val;\n      },\n      set value(newValue: T) {\n        if (val === newValue) return;\n\n        // ВАЛИДАЦИЯ В RUNTIME\n        if (options.validate) {\n          const result = options.validate(newValue);\n          if (result === false || typeof result === 'string') {\n            const errorMsg = typeof result === 'string'\n              ? result\n              : `[Validation Error]: Некорректное значение для сигнала \"${name}\"`;\n\n            console.error(`%c${errorMsg}`, \"color: orange; font-weight: bold;\", {\n              received: newValue,\n              current: val\n            });\n            return; // Прерываем обновление, если данные не валидны\n          }\n        }\n\n        const old = val;\n        val = newValue;\n        engine.onSignalChange?.(name, newValue, old);\n\n        // 1. Всегда добавляем подписчиков в очередь отложенных эффектов\n        subscribers.forEach(e => engine.pendingEffects.add(e));\n\n        // 2. Если очередь еще не запущена, планируем её автоматическое выполнение в микрозадачу\n        if (!engine.isBatching) {\n          engine.isBatching = true;\n\n          queueMicrotask(() => {\n            const effects = Array.from(engine.pendingEffects);\n            engine.pendingEffects.clear();\n            engine.isBatching = false;\n\n            // Запускаем все накопившиеся эффекты и ререндеры за один раз\n            effects.forEach(e => e.run());\n          });\n        }\n      },\n      subscribe(cb) {\n        // Чистая и безопасная подписка для React:\n        // Мы вызываем cb, но НЕ передаем туда аргументы, чтобы не ломать useSyncExternalStore\n        return engine.effect(() => {\n          cb(this.value);\n        });\n      }\n    };\n  }\n\n  /**\n   * Создание эффекта.\n   * @function effect\n   * @param {EffectFn} fn - Функция эффекта.\n   * @returns {CleanupFn} - Функция для очистки эффекта.\n   * @source\n   */\n  public effect(fn: EffectFn): CleanupFn {\n    const engine = this;\n    const effectObj: IEffect = {\n      cleanups: new Set(),\n      run() {\n        this.cleanups.forEach(c => c());\n        this.cleanups.clear();\n        const prev = engine.activeEffect;\n        engine.activeEffect = this;\n        engine.safeRun(this, () => {\n          const cleanup = fn();\n          if (typeof cleanup === 'function') this.cleanups.add(cleanup);\n        });\n        engine.activeEffect = prev;\n      }\n    };\n    this.allEffects.add(effectObj);\n    effectObj.run();\n\n    return () => {\n      effectObj.cleanups.forEach(c => c());\n      engine.pendingEffects.delete(effectObj);\n      engine.allEffects.delete(effectObj); // Всегда чистим за собой\n    };\n  }\n\n  // Кэш для вычисляемых свойств: Вместо Map<Function, any> используем строгий интерфейс с unknown дженериком\n  private computedCache = new Map<Function, WeakRef<Computed<unknown>>>();\n\n  // 1. Создаем реестр финализации под капотом движка.\n  // В качестве токена очистки передаем функцию, которую нужно выполнить.\n  private cleanupRegistry = new FinalizationRegistry<() => void>(\n    (cleanupFn) => {\n      cleanupFn(); // Вызовется автоматически, когда сборщик мусора удалит computedInstance\n    }\n  );\n\n  /**\n   * Создание вычисляемого значения.\n   * @template T\n   * @function computed\n   * @param {Function} fn - Функция для вычисления значения.\n   * @param {string} [signalName] - Имя сигнала.\n   * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n   * @source\n   */\n  public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n    // 1. Проверяем кэш. Если WeakRef существует и объект внутри него еще не удален GC:\n    if (this.computedCache.has(fn)) {\n      const cachedRef = this.computedCache.get(fn);\n      const cachedInstance = cachedRef?.deref();\n      if (cachedInstance) {\n        return cachedInstance as Computed<T>;\n      }\n    }\n\n    const engine = this;\n    const sig = this.signal<T>(undefined as unknown as T, signalName || 'unnamed_computed');\n\n    const unsubscribeEffect = this.effect(() => {\n      const newValue = fn();\n      sig.value = newValue;\n    });\n\n    const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1];\n\n    const performCleanup = () => {\n      unsubscribeEffect();\n      if (effectObj) {\n        engine.allEffects.delete(effectObj);\n      }\n      engine.computedCache.delete(fn);\n    };\n\n    // Создаем инстанс computed\n    const computedInstance: Computed<T> = {\n      get value() { return sig.value; },\n      subscribe: (cb) => sig.subscribe(cb),\n      destroy() {\n        performCleanup();\n      }\n    };\n\n    this.cleanupRegistry.register(computedInstance, performCleanup);\n\n    // 2. Сохраняем в кэш СЛАБУЮ ССЫЛКУ (WeakRef) на наш объект.\n    // Теперь этот кэш больше НЕ будет удерживать объект в памяти насильно!\n    this.computedCache.set(fn, new WeakRef(computedInstance as Computed<unknown>));\n\n    return computedInstance;\n  }\n\n  /**\n   * Создание реактивного объекта (Proxy).\n   * @template T\n   * @function reactive\n   * @param {T} target - Целевой объект для проксирования.\n   * @param {string} [name] - Имя проксируемого объекта.\n   * @returns {T} - Реактивный объект.\n   * @source\n   */\n  public reactive<T extends object>(target: T, name: string = 'reactive'): T {\n    if (this.proxyCache.has(target)) {\n      return this.proxyCache.get(target) as T;\n    }\n    const engine = this;\n    const propsSubscribers = new Map<string | symbol, Set<IEffect>>();\n\n    const proxy = new Proxy(target, {\n      get(obj, prop, receiver) {\n        if (engine.activeEffect) {\n          if (!propsSubscribers.has(prop)) propsSubscribers.set(prop, new Set());\n          propsSubscribers.get(prop)!.add(engine.activeEffect);\n        }\n        const value = Reflect.get(obj, prop, receiver);\n        return (value !== null && typeof value === 'object')\n          ? engine.reactive(value, `${name}.${String(prop)}`)\n          : value;\n      },\n      set(obj, prop, value, receiver) {\n        const old = Reflect.get(obj, prop, receiver);\n        // ПРОВЕРКА НА ИДЕНТИЧНОСТЬ\n        if (old === value) return true;\n\n        if (old !== value) {\n          Reflect.set(obj, prop, value, receiver);\n          engine.onSignalChange?.(`${name}.${String(prop)}`, value, old);\n          propsSubscribers.get(prop)?.forEach(e =>\n            engine.isBatching ? engine.pendingEffects.add(e) : e.run()\n          );\n        }\n        return true;\n      }\n    });\n    this.proxyCache.set(target, proxy);\n    return proxy;\n  }\n\n  /**\n   * Группировка изменений. (Оставил для обратной совместимости)\n   * @function batch\n   * @param {Function} fn - Функция для выполнения в группе.\n   * @returns {void}\n   * @source\n   */\n  public batch(fn: () => void): void {\n    // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n    // поэтому здесь мы можем просто выполнить функцию\n    fn();\n  }\n\n  /**\n   * Создание асинхронного ресурса.\n   * @template T\n   * @function resource\n   * @param {Function} fetcher - Функция для загрузки данных.\n   * @param {{ value: S }} [source] - Источник данных.\n   * @param {string} [signalName] - Имя сигнала ресурса.\n   * @returns {Resource<T>} - Асинхронный ресурс.\n   * @source\n   */\n  public resource<T, S = void>(\n    fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n    source?: { value: S },\n    signalName?: string,\n  ): Resource<T> {\n    const state = this.signal<ResourceState<T>>({ data: null, loading: true, error: null }, signalName || 'unnamed_resource');\n    let controller: AbortController | null = null;\n\n    const load = async (sValue: S) => {\n      controller?.abort();\n      controller = new AbortController();\n\n      // Читаем текущие данные без создания зависимости!\n      const currentData = this.untrack(() => state.value.data);\n\n      // Теперь обновление состояния не вызовет перезапуск эффекта\n      state.value = { data: currentData, loading: true, error: null };\n\n      try {\n        const data = await fetcher(sValue, controller.signal);\n        if (!controller.signal.aborted) {\n          state.value = { data, loading: false, error: null };\n        }\n      } catch (e: any) {\n        if (e.name !== 'AbortError') {\n          state.value = { data: null, loading: false, error: e };\n        }\n      }\n    };\n\n    // Чтобы эффект не подписывался на state,\n    // нам нужно изолировать чтение source от чтения state\n    this.effect(() => {\n      // Читаем ТОЛЬКО source. Это наша единственная зависимость.\n      const sValue = source ? source.value : undefined as S;\n\n      // Вызываем load. Внутри load чтение state.value\n      // не должно регистрироваться как зависимость этого эффекта.\n      load(sValue);\n\n      return () => controller?.abort();\n    });\n\n    return {\n      get data() { return state.value.data; },\n      get loading() { return state.value.loading; },\n      get error() { return state.value.error; },\n      get value() { return state.value; },\n      refetch: () => load(source ? source.value : undefined as S),\n      subscribe: (cb) => state.subscribe(cb)\n    };\n  }\n\n  /**\n   * Выполняет функцию без отслеживания зависимостей.\n   * @template T\n   * @function untrack\n   * @param {Function} fn - Функция для выполнения.\n   * @returns {T} - Результат выполнения функции.\n   * @source\n   */\n  public untrack<T>(fn: () => T): T {\n    const prev = this.activeEffect;\n    this.activeEffect = null; // Временно \"забываем\" про активный эффект\n    try {\n      return fn();\n    } finally {\n      this.activeEffect = prev; // Возвращаем эффект на место\n    }\n  }\n\n  /**\n   * Установка адаптеров React.\n   * @function setReactAdapters\n   * @param {Function} useState - Функция useState из React.\n   * @param {Function} useEffect - Функция useEffect из React.\n   * @returns {void}\n   * @source\n   */\n  // Импортируйте useState и useEffect на верхнем уровне файла из 'react'\n  public setReactAdapters(\n    useState: typeof useStateFromReact,\n    useEffect: typeof useEffectFromReact\n  ): void {\n    this.reactAdapters = { useState, useEffect };\n  }\n\n\n  /**\n   * Использование реактивного значения в React компоненте.\n   * @template T\n   * @function use\n   * @param {{ value: T; subscribe: (cb: (v: T) => void) => CleanupFn }} item - Реактивный объект.\n   * @returns {T} - Значение реактивного объекта.\n   * @source\n   */\n  public use<T>(item: { value: T; subscribe: (cb: (v: T) => void) => CleanupFn }): T {\n    if (!this.reactAdapters) {\n      throw new Error(\"[React Error]: Адаптеры React не установлены. Вызовите engine.setReactAdapters(useState, useEffect).\");\n    }\n\n    // NOTE: (защита) проверяем, что нам передали объект сигнала\n    if (!item || typeof item.subscribe !== 'function') {\n      const errorMsg = `\n        [Reactive Error]: engine.use() получил некорректный объект!\n        Скорее всего, вы пытаетесь подписаться на свойство сервиса, которое не было инициализировано.\n        Проверьте, что в классе написано: public mySignal = this.engine.signal(...)\n      `;\n      console.error(errorMsg, { item });\n      throw new Error(errorMsg);\n    }\n    const [val, setVal] = this.reactAdapters.useState(item.value);\n\n    this.reactAdapters.useEffect(\n      () => {\n        return item.subscribe(setVal);\n      },\n      [item]\n    );\n\n    return val;\n  }\n\n  /**\n   * Безопасное выполнение функции.\n   * @private\n   * @function safeRun\n   * @param {IEffect} effect - Эффект.\n   * @param {Function} fn - Функция для выполнения.\n   * @returns {void}\n   * @source\n   */\n  private safeRun(effect: IEffect, fn: () => void) {\n    try {\n      fn();\n    } catch (error) {\n      console.error(\n        `%c[Reactive Error] %cОшибка в эффекте/computed:`,\n        \"color: white; background: red; padding: 2px 4px; border-radius: 3px;\",\n        \"font-weight: bold;\",\n        error\n      );\n      // Здесь можно отправить ошибку в Sentry или другой сервис мониторинга\n    }\n  }\n}\n","import React, { useSyncExternalStore, useMemo, useEffect, useRef } from 'react';\nimport { ReactiveEngine } from '../core';\n\n/**\n * Свойства для инлайн-компонента {@link Observer}.\n */\ninterface ObserverProps {\n  /**\n   * Функция-рендер, возвращающая JSX-разметку.\n   * Сигналы, прочитанные внутри этого коллбека, будут автоматически отслеживаться.\n   */\n  children: () => React.ReactNode;\n}\n\n/**\n * Фабрика для создания инлайн-компонента `<Observer>`.\n *\n * @param engine - Экземпляр реактивного движка {@link ReactiveEngine}.\n * @returns Специальный React-компонент для точечной изоляции реактивных обновлений в JSX.\n *\n * @example\n * ```tsx\n * import { createObserverComponent, engine } from '@pravosleva/reactive-engine';\n *\n * const Observer = createObserverComponent(engine);\n * const priceSignal = engine.signal(100);\n *\n * export const MyComponent = () => {\n *   return (\n *     <div>\n *       <h1>Статический тяжелый контент (не перерисовывается)</h1>\n *       <Observer>\n *         {() => <span>Живая цена: {priceSignal.value}</span>}\n *       </Observer>\n *     </div>\n *   );\n * };\n * ```\n */\nexport const createObserverComponent = (engine: ReactiveEngine) => {\n  return ({ children }: ObserverProps): any => {\n    const versionRef = useRef(0);\n    const onStoreChangeRef = useRef<(() => void) | null>(null);\n\n    // Ссылки для удержания инстанса эффекта и функции отписки\n    const unsubscribeRef = useRef<(() => void) | null>(null);\n    const effectObjRef = useRef<any>(null);\n\n    // 1. Создаем стабильный мост подписки для React ОДИН раз за жизнь компонента\n    const storeBridge = useMemo(() => {\n      return {\n        subscribe(onStoreChange: () => void) {\n          onStoreChangeRef.current = onStoreChange;\n          return () => {\n            onStoreChangeRef.current = null;\n            if (unsubscribeRef.current) {\n              unsubscribeRef.current();\n              unsubscribeRef.current = null;\n              effectObjRef.current = null;\n            }\n          };\n        },\n        getSnapshot() {\n          return versionRef.current;\n        }\n      };\n    }, []);\n\n    // Очистка при полном размонтировании из DOM\n    useEffect(() => {\n      return () => {\n        if (unsubscribeRef.current) unsubscribeRef.current();\n      };\n    }, []);\n\n    // 2. ЛЕЗИ-ИНИЦИАЛИЗАЦИЯ: Создаем реактивный эффект ядра ровно 1 раз.\n    // Этот эффект будет жить вечно вместе с компонентом и никогда не сбросит свои подписки!\n    if (!unsubscribeRef.current) {\n      unsubscribeRef.current = engine.effect(() => {\n        // Если этот эффект триггерится асинхронно из-за изменения сигнала в ядре:\n        if (onStoreChangeRef.current) {\n          versionRef.current++; // Инкрементируем версию снапшота для React\n\n          // Мягко пушим React на ререндер через микрозадачу\n          queueMicrotask(() => {\n            if (onStoreChangeRef.current) {\n              onStoreChangeRef.current();\n            }\n          });\n        }\n      });\n\n      // Хак: Вытаскиваем ссылку на сам объект эффекта, который только что зарегился в ядре\n      effectObjRef.current = Array.from((engine as any).allEffects).pop();\n    }\n\n    // 3. ГЛАВНАЯ МАГИЯ: Каждый раз, когда React заходит на рендер (включая StrictMode),\n    // мы вручную подменяем activeEffect ядра на НАШ долгоживущий эффект на время выполнения children().\n    // Это заставляет ядро автоматически ДОБАВЛЯТЬ новые сигналы в зависимости и никогда не терять старые!\n    const prevActiveEffect = (engine as any).activeEffect;\n    (engine as any).activeEffect = effectObjRef.current;\n\n    let result: React.ReactNode = null;\n    try {\n      result = children(); // Синхронно выполняем рендер компонента и собираем сигналы\n    } finally {\n      // Возвращаем глобальный контекст ядра в исходное состояние\n      (engine as any).activeEffect = prevActiveEffect;\n    }\n\n    // Подключаем нативныйuseSyncExternalStore к нашей стабильной версии стейта\n    useSyncExternalStore(storeBridge.subscribe, storeBridge.getSnapshot);\n\n    return result as unknown as React.ReactElement;\n  };\n};\n\ninterface TriggerProps {\n  engine: ReactiveEngine;\n  Component: React.ComponentType<any>;\n  props: any;\n  onTrigger: () => void;\n}\n\n/**\n * Вспомогательный компонент, изолирующий выполнение пользовательского компонента\n * от функции safeRun движка во время сбора реактивных зависимостей.\n */\nconst ReactiveRenderTrigger = ({ engine, Component, props, onTrigger }: TriggerProps) => {\n  let renderedElement: React.ReactNode = null;\n\n  // 1. Создаем эффект движка. Он инициализируется пустым, чтобы не оборачивать\n  // вызов компонента в safeRun и не ломать правила хуков React.\n  const unsub = engine.effect(() => {\n    // Этот коллбек сработает, когда изменятся сигналы, считанные в JSX ниже\n    onTrigger();\n  });\n\n  // Преобразуем инстанс движка в any, чтобы достучаться до внутренних (private/protected) свойств\n  const enginePrivate = engine as any;\n\n  // 2. Извлекаем объект созданного эффекта из внутренней коллекции движка.\n  // Если у вас свойство называется иначе, проверьте имя в коде: this.allEffects.add(effectObj);\n  const allEffectsArray = Array.from(enginePrivate.allEffects || []);\n  const currentEffectObj = allEffectsArray[allEffectsArray.length - 1];\n\n  // Определяем точное имя свойства активного эффекта.\n  // Если в коде класса оно написано как activeEffect, то используем его через any.\n  const activeEffectKey = 'activeEffect' in enginePrivate ? 'activeEffect' : '_activeEffect';\n\n  const prevActive = enginePrivate[activeEffectKey];\n  enginePrivate[activeEffectKey] = currentEffectObj;\n\n  try {\n    // 3. Вызываем компонент напрямую в экосистеме React.\n    // Все внутренние хуки (useEffect, useRef) теперь работают штатно.\n    if (typeof Component === 'function' && !Component.prototype?.isReactComponent) {\n      renderedElement = (Component as Function)(props);\n    } else {\n      renderedElement = React.createElement(Component, props);\n    }\n  } finally {\n    // 4. Возвращаем движок в исходное состояние и подчищаем временный эффект\n    enginePrivate[activeEffectKey] = prevActive;\n    unsub();\n  }\n\n  return renderedElement;\n};\n\n/**\n * Функция высшего порядка (HOC) для автоматического отслеживания сигналов внутри React-компонента.\n * Полный аналог `observer` из MobX.\n *\n * @template P - Объект пропсов оборачиваемого компонента.\n * @param engine - Экземпляр реактивного движка {@link ReactiveEngine}.\n * @returns Функция-декоратор, преобразующая обычный компонент в реактивный.\n *\n * @example\n * ```tsx\n * import { createObserver } from '@pravosleva/reactive-engine';\n * import { engine } from '~/utils/ReactiveEngine'; // Ваш локальный экземпляр движка\n *\n * const observer = createObserver(engine);\n * const counterSignal = engine.signal(0);\n *\n * // Компонент автоматически перерисуется при изменении counterSignal.value\n * export const CounterView = observer(() => {\n *   return (\n *     <div>\n *       <p>Счетчик: {counterSignal.value}</p>\n *       <button onClick={() => counterSignal.value++}>+1</button>\n *     </div>\n *   );\n * });\n * ```\n *\n * @source\n */\nexport const createObserver = (engine: ReactiveEngine) => {\n  return <P extends object>(Component: React.ComponentType<P>): React.ComponentType<P> => {\n\n    const ObserverComponent = (props: P) => {\n      const versionRef = useRef(0);\n      const enginePrivate = engine as any;\n\n      // Опеределяем внутреннее имя свойства активного эффекта в вашем движке\n      const activeEffectKey = 'activeEffect' in enginePrivate ? 'activeEffect' : '_activeEffect';\n\n      // Хранилище для инстанса долгоживущего эффекта движка\n      const effectObjRef = useRef<any>(null);\n\n      // Интеграция с подписками React 18+ через useSyncExternalStore\n      const { subscribe, getSnapshot } = useMemo(() => {\n        return {\n          subscribe: (onStoreChange: () => void) => {\n            // Создаем ОДИН долгоживущий эффект на весь жизненный цикл компонента.\n            // Он уничтожится только тогда, когда React размонтирует компонент.\n            const unsub = engine.effect(() => {\n              // При изменении сигналов инкрементируем версию и уведомляем React\n              versionRef.current++;\n              onStoreChange();\n            });\n\n            // Нам нужно получить объект этого эффекта.\n            // Из вашего кода метода `effect`: эффект добавляется в `this.allEffects.add(effectObj)`.\n            const allEffectsArray = Array.from(enginePrivate.allEffects || []);\n            effectObjRef.current = allEffectsArray[allEffectsArray.length - 1];\n\n            return () => {\n              unsub(); // Чистим эффект при размонтировании\n              effectObjRef.current = null;\n            };\n          },\n          getSnapshot: () => versionRef.current\n        };\n      }, []);\n\n      // Подписываем компонент. React сам управляет вызовами subscribe/unsubscribe в StrictMode.\n      useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n      // --- ФАЗА СБОРА ЗАВИСИМОСТЕЙ ---\n      // Если эффект уже создан (компонент смонтирован), мы временно подставляем его в движок.\n      // Если это самый первый рендер (эффекта еще нет в subscribe), мы берем временный \"заглушечный\"\n      // объект эффекта, чтобы движок не упал, а сигналы зарегистрировали чтение.\n      const fallbackEffect = { cleanups: new Set(), run: () => { } };\n      const currentEffect = effectObjRef.current || fallbackEffect;\n\n      // Перед рендером подменяем активный эффект\n      const prevActive = enginePrivate[activeEffectKey];\n      enginePrivate[activeEffectKey] = currentEffect;\n\n      let renderedElement: React.ReactNode = null;\n      try {\n        // Вызываем компонент напрямую. Хуки типа useEffect работают идеально,\n        // так как они не обернуты в safeRun движка.\n        if (typeof Component === 'function' && !Component.prototype?.isReactComponent) {\n          renderedElement = (Component as Function)(props);\n        } else {\n          renderedElement = React.createElement(Component, props);\n        }\n      } finally {\n        // После рендера возвращаем исходное состояние движка\n        enginePrivate[activeEffectKey] = prevActive;\n      }\n\n      return renderedElement;\n    };\n\n    ObserverComponent.displayName = `Observer(${Component.displayName || Component.name || 'Component'})`;\n    return ObserverComponent as React.ComponentType<P>;\n  };\n};\n","import { CleanupFn } from '../core'; // импорт типа отписки, если нужен\n\ninterface CacheEntry<T> {\n  data: T;\n  timestamp: number;\n}\n\ninterface CacheOptions {\n  /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n  ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки кэширования\n * @source\n */\nexport const withCache = <S, T>(\n  fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n  options: CacheOptions = {}\n) => {\n  const ttl = options.ttl ?? 5 * 60 * 1000; // Дефолтный TTL: 5 минут\n  const cache = new Map<string, CacheEntry<T>>();\n\n  return async (source: S, signal: AbortSignal): Promise<T> => {\n    // 1. Генерируем уникальный ключ на основе зависимостей (массива или объекта)\n    const cacheKey = typeof source === 'object' && source !== null\n      ? JSON.stringify(source)\n      : String(source);\n\n    const now = Date.now();\n    const cached = cache.get(cacheKey);\n\n    // 2. Проверяем, есть ли валидный (не устаревший) кэш\n    if (cached && (now - cached.timestamp < ttl)) {\n      return cached.data;\n    }\n\n    // 3. Если кэша нет или он устарел — делаем реальный сетевой запрос\n    const freshData = await fetcher(source, signal);\n\n    // 4. Сохраняем свежие данные и метку времени в кэш\n    cache.set(cacheKey, {\n      data: freshData,\n      timestamp: Date.now() // берем актуальное время после завершения запроса\n    });\n\n    return freshData;\n  };\n};\n","import { useEffect, useRef } from 'react';\nimport { Signal, CleanupFn } from '../core';\n\n/**\n * Универсальный хук для подписки на изменения Signal, Computed или Resource.\n * @template T Тип данных внутри реактивного контейнера\n * @param {Signal<T> | { subscribe: (cb: (val: T) => void) => CleanupFn }} signal Объект подписки\n * @param {(val: T) => void} callback Функция обратного вызова, принимающая новое значение\n * @source\n */\nexport const useReactiveSubscription = <T>(\n  signal: Pick<Signal<T>, 'subscribe'>,\n  callback: (val: T) => void\n): void => {\n  // Сохраняем актуальный callback в ref, чтобы не перезапускать эффект при его изменении\n  const callbackRef = useRef(callback);\n\n  useEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n\n  useEffect(() => {\n    // Подписываемся один раз при изменении самого signal\n    const unsubscribe: CleanupFn = signal.subscribe((val) => {\n      callbackRef.current(val);\n    });\n\n    // Возвращаем функцию очистки для автоматической отписки при размонтировании\n    return unsubscribe;\n  }, [signal]);\n};\n","import { useSyncExternalStore, useCallback, useMemo, useEffect } from \"react\";\nimport { CleanupFn } from '../core';\n\ninterface ObservableItem<T> {\n  readonly value: T;\n  subscribe: (cb: (val: T) => void) => CleanupFn;\n  destroy?: () => void;\n}\n\ntype ReactiveInput<T> = ObservableItem<T> | (() => ObservableItem<T>);\n\n/**\n * Хук для извлечения значения из Signal/Computed/Resource и авто-ререндера компонента.\n * Поддерживает React 18+ и ленивые фабрики без утечек памяти.\n *\n * @source\n */\nexport const useReactiveValue = <T>(input: ReactiveInput<T>): T => {\n  // 1. Всегда получаем чистый объект, даже если передали функцию-фабрику () => engine.computed(...)\n  const reactiveItem = useMemo(() => {\n    return typeof input === 'function' ? input() : input;\n  }, [input]);\n\n  // 2. Стабилизируем функции для useSyncExternalStore\n  const subscribe = useCallback(\n    (reactCallback: () => void) => {\n      return reactiveItem.subscribe(reactCallback);\n    },\n    [reactiveItem]\n  );\n\n  const getSnapshot = useCallback(() => {\n    return reactiveItem.value;\n  }, [reactiveItem]);\n\n  // 3. Автоматически подчищаем динамические вычисления при размонтировании\n  useEffect(() => {\n    return () => {\n      if (reactiveItem && typeof reactiveItem.destroy === 'function') {\n        reactiveItem.destroy();\n      }\n    };\n  }, [reactiveItem]);\n\n  return useSyncExternalStore(subscribe, getSnapshot);\n};\n","import { useState, useEffect, useRef, useMemo } from \"react\";\nimport { CleanupFn } from '../core';\n\ninterface ObservableItem<T> {\n  readonly value: T;\n  subscribe: (cb: (val: T) => void) => CleanupFn;\n  destroy?: () => void;\n}\n\ntype ReactiveInput<T> = ObservableItem<T> | (() => ObservableItem<T>);\n\n/**\n * Fallback хук для извлечения значения из сигналов. Поддерживает React 16.8+.\n *\n * @source\n */\nexport const useReactiveValue0 = <T>(input: ReactiveInput<T>): T => {\n  const reactiveItem = useMemo(() => {\n    return typeof input === 'function' ? input() : input;\n  }, [input]);\n\n  const [state, setState] = useState<T>(reactiveItem.value);\n  const setStateRef = useRef(setState);\n\n  useEffect(() => {\n    setStateRef.current = setState;\n  }, [setState]);\n\n  useEffect(() => {\n    setStateRef.current(reactiveItem.value);\n\n    const unsubscribe = reactiveItem.subscribe((newValue) => {\n      setStateRef.current(newValue);\n    });\n\n    return () => {\n      unsubscribe();\n      if (reactiveItem && typeof reactiveItem.destroy === 'function') {\n        reactiveItem.destroy();\n      }\n    };\n  }, [reactiveItem]);\n\n  return state;\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/core.ts","../src/decorators/createObserver.tsx","../src/decorators/withCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\n// export abstract class BaseService {\n//   constructor(protected engine: ReactiveEngine) {\n//     // Вызываем метод инициализации, который можно переопределить в наследниках\n//     this.onInit();\n//   }\n\n//   // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n//   // Удобно для инициализации сигналов, которые зависят от engine.\n//   protected onInit(): void {}\n\n//   // NOTE: Полезные хелперы для сокращения кода\n//   protected createSignal<T>(val: T, name?: string) {\n//     return this.engine.signal(val, name);\n//   }\n\n//   protected createComputed<T>(fn: () => T) {\n//     return this.engine.computed(fn);\n//   }\n// }\n\nexport abstract class BaseREService {\n  constructor(protected engine: ReactiveEngine) { } // Просто сохраняем engine\n\n  protected createNumericSignal(val: number, name: string) {\n    return this.engine.signal(val, {\n      name,\n      validate: (v) => typeof v === 'number' && !isNaN(v)\n    });\n  }\n}\n","import { ReactiveEngine } from './core';\n\nexport abstract class BaseREServiceEnhanced {\n  constructor(protected engine: ReactiveEngine) {\n    setTimeout(() => this.onInit(), 0)\n  }\n\n  protected onInit(): void { }\n}\n","import { useState as useStateFromReact, useEffect as useEffectFromReact } from 'react';\n\n// --- ТИПЫ ---\nexport type CleanupFn = () => void;\nexport type EffectFn = () => CleanupFn | void;\nexport type Token<T> = string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T };\nexport type Factory<T> = (engine: ReactiveEngine) => T;\n\nexport interface IEffect {\n  run: () => void;\n  label?: string;\n  cleanups: Set<CleanupFn>;\n}\n\nexport interface ResourceState<T> {\n  data: T | null;\n  loading: boolean;\n  error: any | null;\n}\n\n/**\n * Функция для очистки эффекта.\n * @typedef {() => void} CleanupFn\n */\n\n/**\n * Функция эффекта, которая может возвращать функцию очистки.\n * @typedef {() => CleanupFn | void} EffectFn\n */\n\n/**\n * Токен для зависимости.\n * @typedef {string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T }} Token<T>\n */\n\n/**\n * Фабрика для создания сервиса.\n * @template T\n * @typedef {(engine: ReactiveEngine) => T} Factory<T>\n */\n\n/**\n * Интерфейс для эффекта.\n * @interface IEffect\n */\nexport interface IEffect {\n  /**\n   * Запуск эффекта.\n   * @function run\n   * @returns {void}\n   */\n  run: () => void;\n\n  /**\n   * Коллекция функций очистки.\n   * @type {Set<CleanupFn>}\n   */\n  cleanups: Set<CleanupFn>;\n}\n\n/**\n * Интерфейс для состояния ресурса.\n * @template T Data format\n * @interface ResourceState<T>\n */\nexport interface ResourceState<T> {\n  /**\n   * Данные ресурса.\n   * @type {T | null}\n   */\n  data: T | null;\n\n  /**\n   * Состояние загрузки ресурса.\n   * @type {boolean}\n   */\n  loading: boolean;\n\n  /**\n   * Ошибка ресурса.\n   * @type {any | null}\n   */\n  error: any | null;\n\n  /** Флаг активного процесса повторных попыток после сбоя сети */\n  isRetrying: boolean;\n}\n\n/**\n * Интерфейс для сигнала.\n * @template T\n * @interface Signal<T>\n */\nexport interface Signal<T> {\n  /**\n   * Значение сигнала.\n   * @type {T}\n   */\n  value: T;\n\n  /**\n   * Подписка на изменение значения сигнала.\n   * @function subscribe\n   * @param {Function} cb - Коллбек функция для обработки изменения.\n   * @returns {CleanupFn} - Функция для очистки подписки.\n   */\n  subscribe: (cb: (val: T) => void) => CleanupFn;\n}\n\n/**\n * Интерфейс для вычисляемого значения.\n * @template T\n * @interface Computed<T>\n */\nexport interface Computed<T> {\n  /**\n   * Только читаемое значение вычисляемого значения.\n   * @type {T}\n   */\n  readonly value: T;\n\n  /**\n   * Подписка на изменение вычисляемого значения.\n   * @function subscribe\n   * @param {Function} cb - Коллбек функция для обработки изменения.\n   * @returns {CleanupFn} - Функция для очистки подписки.\n   */\n  subscribe: (cb: (val: T) => void) => CleanupFn;\n\n  /**\n   * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.\n   */\n  destroy: () => void;\n}\n\nexport interface ResourceOptions<T> {\n  name: string;\n  /** Автоматически сбрасывать data в null при изменении source. По умолчанию: true */\n  resetDataOnSourceChange?: boolean;\n  /** Функция для валидации успешного ответа сервера перед его сохранением в стейт.\n   *\n   * Варианты возвращаемого значения:\n   * - true 👉 все ок\n   * - false 👉 в error попадет стандартный текст ошибки\n   * - string 👉 попадет в поле error\n   * */\n  responseValidate?: (responseData: T) => boolean | string;\n\n  // НАСТРОЙКИ RETRY:\n  retryCount?: number;\n  retryDelay?: number;\n  /** Включить экспоненциальное увеличение задержки (каждая попытка ждет в 2 раза дольше). По умолчанию: false */\n  isExponentialBackoffEnabled?: boolean;\n  /** Максимальный лимит ожидания между попытками в миллисекундах. По умолчанию: 30000 (30 секунд) */\n  maxRetryDelay?: number;\n}\n\n/**\n * Интерфейс для ресурса.\n * @template T\n * @interface Resource<T>\n */\nexport interface Resource<T> extends ResourceState<T> {\n  /**\n   * Перезагрузка ресурса.\n   * @function refetch\n   * @returns {void}\n   */\n  refetch: () => void;\n\n  /**\n   * Подписка на изменение состояния ресурса.\n   * @function subscribe\n   * @param {Function} cb - Коллбек функция для обработки изменения.\n   * @returns {CleanupFn} - Функция для очистки подписки.\n   */\n  subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;\n\n  /**\n   * Только читаемое состояние ресурса.\n   * @type {ResourceState<T>}\n   */\n  readonly value: ResourceState<T>;\n}\n\n/**\n * Интерфейс для опций сигнала.\n * @template T\n * @interface SignalOptions<T>\n */\nexport interface SignalOptions<T> {\n  /**\n   * Имя сигнала.\n   * @type {string}\n   */\n  name?: string;\n\n  /**\n   * Валидатор значения сигнала.\n   * @function validate\n   * @param {T} val - Значение для валидации.\n   * @returns {boolean | string} - Результат валидации.\n   */\n  validate?: (val: T) => boolean | string;\n}\n\n// --- ЯДРО ---\n/**\n * Класс реактивного движка.\n */\nexport class ReactiveEngine {\n  private activeEffect: IEffect | null = null;\n  private isBatching = false;\n  private pendingEffects = new Set<IEffect>();\n\n  // В контейнерах DI вместо any используем unknown. Это заставит методы inject/provide\n  // явно приводить типы через дженерики <T>, защищая от рантайм-ошибок.\n  private services = new Map<Token<unknown>, unknown>();\n  private factories = new Map<Token<unknown>, Factory<unknown>>();\n\n  // Объект-ключ мапится на объект-прокси. Здесь идеально подходит тип object.\n  private proxyCache = new WeakMap<object, object>();\n  private allEffects = new Set<IEffect>();\n\n  /**\n   * Коллбек для уведомления об изменении сигнала.\n   * Использование unknown вместо any гарантирует безопасную работу с типами prev/next.\n   */\n  public onSignalChange?: (name: string, next: unknown, prev: unknown) => void;\n\n  // Описываем строгие типы для адаптеров React, чтобы не ломать встроенные типы React.\n  private reactAdapters: {\n    useState: typeof useStateFromReact;\n    useEffect: typeof useEffectFromReact;\n  } = {\n      useState: useStateFromReact,\n      useEffect: useEffectFromReact,\n    };\n\n  /**\n   * DI: Регистрация зависимости.\n   * @template T\n   * @function provide\n   * @param {Token<T>} token - Токен для зависимости.\n   * @param {T | Factory<T>} valueOrFactory - Значение или фабрика для создания сервиса.\n   * @returns {void}\n   * @source\n   */\n  public provide<T>(token: Token<T>, valueOrFactory: T | Factory<T>): void {\n    if (typeof valueOrFactory === 'function' && !valueOrFactory.prototype) {\n      this.factories.set(token, valueOrFactory as Factory<T>);\n    } else {\n      this.services.set(token, valueOrFactory);\n    }\n  }\n\n  /**\n   * DI: Инъекция; Получение сервиса по токену.\n   * @template T\n   * @function inject\n   * @param {Token<T>} token - Токен для зависимости.\n   * @returns {T} - Сервис.\n   * @source\n   */\n  public inject<T>(token: Token<T>): T {\n    if (!token) {\n      throw new Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`);\n    }\n\n    // Приводим токен к базовому типу Token<unknown> для совместимости с Map\n    const targetToken = token as Token<unknown>;\n\n    if (this.services.has(targetToken)) {\n      return this.services.get(targetToken) as T;\n    }\n\n    try {\n      const factory = this.factories.get(targetToken);\n      if (factory) {\n        const instance = factory(this) as T;\n        this.services.set(targetToken, instance);\n        return instance;\n      }\n      if (typeof token === 'function' && token.prototype) {\n        const instance = new (token as { new(eng: ReactiveEngine): T })(this);\n        this.services.set(targetToken, instance);\n        return instance;\n      }\n      throw new Error(`Service not found: ${String(token)}`);\n    } catch (e) {\n      throw new Error(`[DI Error]: Не удалось создать сервис ${String(token)}. Ошибка: ${(e as Error)?.message || 'No e?.message'}`);\n    }\n  }\n\n  /**\n   * Создание сигнала.\n   * @template T\n   * @function signal\n   * @param {T} initialValue - Начальное значение сигнала.\n   * @param {string | SignalOptions<T>} [optionsOrName] - Имя или опции сигнала.\n   * @returns {Signal<T>} - Сигнал.\n   * @source\n   */\n  public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n    const engine = this;\n    let val = initialValue;\n    const subscribers = new Set<IEffect>();\n    const options = typeof optionsOrName === 'string'\n      ? { name: optionsOrName }\n      : optionsOrName || {};\n    const name = options.name || 'unnamed_signal';\n\n    return {\n      get value(): T {\n        if (engine.activeEffect) subscribers.add(engine.activeEffect);\n        return val;\n      },\n      set value(newValue: T) {\n        if (val === newValue) return;\n\n        // ВАЛИДАЦИЯ В RUNTIME\n        if (options.validate) {\n          const result = options.validate(newValue);\n          if (result === false || typeof result === 'string') {\n            const errorMsg = typeof result === 'string'\n              ? result\n              : `[Validation Error]: Некорректное значение для сигнала \"${name}\"`;\n\n            console.error(`%c${errorMsg}`, \"color: orange; font-weight: bold;\", {\n              received: newValue,\n              current: val\n            });\n            return; // Прерываем обновление, если данные не валидны\n          }\n        }\n\n        const old = val;\n        val = newValue;\n        engine.onSignalChange?.(name, newValue, old);\n\n        // 1. Всегда добавляем подписчиков в очередь отложенных эффектов\n        subscribers.forEach(e => engine.pendingEffects.add(e));\n\n        // 2. Если очередь еще не запущена, планируем её автоматическое выполнение в микрозадачу\n        if (!engine.isBatching) {\n          engine.isBatching = true;\n\n          queueMicrotask(() => {\n            const effects = Array.from(engine.pendingEffects);\n            engine.pendingEffects.clear();\n            engine.isBatching = false;\n\n            // Запускаем все накопившиеся эффекты и ререндеры за один раз\n            effects.forEach(e => e.run());\n          });\n        }\n      },\n      subscribe(cb) {\n        // Чистая и безопасная подписка для React:\n        // Мы вызываем cb, но НЕ передаем туда аргументы, чтобы не ломать useSyncExternalStore\n        return engine.effect(() => {\n          cb(this.value);\n        });\n      }\n    };\n  }\n\n  /**\n   * Создание эффекта.\n   * @function effect\n   * @param {EffectFn} fn - Функция эффекта.\n   * @param {string} [label] - Необязательная метка для логирования и отладки.\n   * @returns {CleanupFn} - Функция для очистки эффекта.\n   * @source\n   */\n  public effect(fn: EffectFn, label?: string): CleanupFn {\n    const engine = this;\n    const effectObj: IEffect = {\n      label, // Запоминаем имя эффекта для профайлера/логов\n      cleanups: new Set(),\n      run() {\n        this.cleanups.forEach(c => c());\n        this.cleanups.clear();\n        const prev = engine.activeEffect;\n        engine.activeEffect = this;\n        engine.safeRun(this, () => {\n          const cleanup = fn();\n          if (typeof cleanup === 'function') this.cleanups.add(cleanup);\n        });\n        engine.activeEffect = prev;\n      }\n    };\n    this.allEffects.add(effectObj);\n    effectObj.run();\n\n    return () => {\n      effectObj.cleanups.forEach(c => c());\n      engine.pendingEffects.delete(effectObj);\n      engine.allEffects.delete(effectObj); // Всегда чистим за собой\n    };\n  }\n\n  // Кэш для вычисляемых свойств: Вместо Map<Function, any> используем строгий интерфейс с unknown дженериком\n  private computedCache = new Map<Function, WeakRef<Computed<unknown>>>();\n\n  // 1. Создаем реестр финализации под капотом движка.\n  // В качестве токена очистки передаем функцию, которую нужно выполнить.\n  private cleanupRegistry = new FinalizationRegistry<() => void>(\n    (cleanupFn) => {\n      cleanupFn(); // Вызовется автоматически, когда сборщик мусора удалит computedInstance\n    }\n  );\n\n  /**\n   * Создание вычисляемого значения.\n   * @template T\n   * @function computed\n   * @param {Function} fn - Функция для вычисления значения.\n   * @param {string} [signalName] - Имя сигнала.\n   * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n   * @source\n   */\n  public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n    // 1. Проверяем кэш. Если WeakRef существует и объект внутри него еще не удален GC:\n    if (this.computedCache.has(fn)) {\n      const cachedRef = this.computedCache.get(fn);\n      const cachedInstance = cachedRef?.deref();\n      if (cachedInstance) {\n        return cachedInstance as Computed<T>;\n      }\n    }\n\n    const engine = this;\n    const sig = this.signal<T>(undefined as unknown as T, signalName || 'unnamed_computed');\n\n    const unsubscribeEffect = this.effect(() => {\n      const newValue = fn();\n      sig.value = newValue;\n    });\n\n    const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1];\n\n    const performCleanup = () => {\n      unsubscribeEffect();\n      if (effectObj) {\n        engine.allEffects.delete(effectObj);\n      }\n      engine.computedCache.delete(fn);\n    };\n\n    // Создаем инстанс computed\n    const computedInstance: Computed<T> = {\n      get value() { return sig.value; },\n      subscribe: (cb) => sig.subscribe(cb),\n      destroy() {\n        performCleanup();\n      }\n    };\n\n    this.cleanupRegistry.register(computedInstance, performCleanup);\n\n    // 2. Сохраняем в кэш СЛАБУЮ ССЫЛКУ (WeakRef) на наш объект.\n    // Теперь этот кэш больше НЕ будет удерживать объект в памяти насильно!\n    this.computedCache.set(fn, new WeakRef(computedInstance as Computed<unknown>));\n\n    return computedInstance;\n  }\n\n  /**\n   * Создание реактивного объекта (Proxy).\n   * @template T\n   * @function reactive\n   * @param {T} target - Целевой объект для проксирования.\n   * @param {string} [name] - Имя проксируемого объекта.\n   * @returns {T} - Реактивный объект.\n   * @source\n   */\n  public reactive<T extends object>(target: T, name: string = 'reactive'): T {\n    if (this.proxyCache.has(target)) {\n      return this.proxyCache.get(target) as T;\n    }\n    const engine = this;\n    const propsSubscribers = new Map<string | symbol, Set<IEffect>>();\n\n    const proxy = new Proxy(target, {\n      get(obj, prop, receiver) {\n        if (engine.activeEffect) {\n          if (!propsSubscribers.has(prop)) propsSubscribers.set(prop, new Set());\n          propsSubscribers.get(prop)!.add(engine.activeEffect);\n        }\n        const value = Reflect.get(obj, prop, receiver);\n        return (value !== null && typeof value === 'object')\n          ? engine.reactive(value, `${name}.${String(prop)}`)\n          : value;\n      },\n      set(obj, prop, value, receiver) {\n        const old = Reflect.get(obj, prop, receiver);\n        // ПРОВЕРКА НА ИДЕНТИЧНОСТЬ\n        if (old === value) return true;\n\n        if (old !== value) {\n          Reflect.set(obj, prop, value, receiver);\n          engine.onSignalChange?.(`${name}.${String(prop)}`, value, old);\n          propsSubscribers.get(prop)?.forEach(e =>\n            engine.isBatching ? engine.pendingEffects.add(e) : e.run()\n          );\n        }\n        return true;\n      }\n    });\n    this.proxyCache.set(target, proxy);\n    return proxy;\n  }\n\n  /**\n   * Группировка изменений. (Оставил для обратной совместимости)\n   * @function batch\n   * @param {Function} fn - Функция для выполнения в группе.\n   * @returns {void}\n   * @source\n   */\n  public batch(fn: () => void): void {\n    // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n    // поэтому здесь мы можем просто выполнить функцию\n    fn();\n  }\n\n  /**\n   * Вспомогательная функция для задержки (sleep), чувствительная к AbortSignal\n   */\n  /**\n   * Вспомогательная функция для задержки, чувствительная к AbortSignal\n   */\n  private delay(ms: number, signal: AbortSignal): Promise<void> {\n    return new Promise((resolve, reject) => {\n      if (signal.aborted) {\n        return reject(new DOMException('Aborted', 'AbortError'));\n      }\n\n      const timeoutId = setTimeout(() => {\n        signal.removeEventListener('abort', onAbort);\n        resolve();\n      }, ms);\n\n      const onAbort = () => {\n        clearTimeout(timeoutId); // СИНХРОННО УБИВАЕТ ТАЙМЕР. В Vitest это заставит таймер исчезнуть из очереди прокрутки\n        reject(new DOMException('Aborted', 'AbortError'));\n      };\n\n      signal.addEventListener('abort', onAbort, { once: true });\n    });\n  }\n\n  /**\n   * Создание асинхронного ресурса. Типы на входе: <T - формат ответа, S - источник изменений (сигнал либо computed-кортеж из зачений сигналов .value)>\n   *\n   * Explained 👉 {@link https://github.com/garage-13/reactive-engine/blob/main/README_EN.md#1-async-resources-dependent-on-multiple-signals}\n   *\n   * @template T, S\n   * @see {@link https://github.com/garage-13/reactive-engine/blob/main/src/examples/20-resource/Example20.tsx Реализация базового компонента Example20}\n   * @see {@link https://github.com/garage-13/reactive-engine/blob/main/src/examples/21-multi-resource/service.secondary.ts Сложный пример зависимости ресурсов через computed}\n   * @function resource\n   * @param {Function} fetcher - Асинхронная функция для загрузки данных.\n   * @param {{ value: S }} [source] - Источник данных.\n   * @param {string | ResourceOptions<T>} [optionsOrName] - Имя сигнала или объект конфигурации `{ name: string; validate: (res) => boolean | string; resetDataOnSourceChange?: boolean }`.\n   * @returns {Resource<T>} - Асинхронный ресурс.\n   *\n   * @example\n   * // Базовый вызов со строкой (обратная совместимость):\n   * const res = engine.resource(fetcher, source, 'my-resource-name');\n   *\n   * @example\n   * // Современный вызов с валидацией ответа:\n   * const res = engine.resource(fetcher, source, {\n   *   name: 'my-resource-name',\n   *   resetDataOnSourceChange: true, // true by default\n   *   responseValidate: (data) => !!data || 'Данные пусты', // Проверяйте формат в соотв. с дженериком\n   * });\n   * @source\n   */\n  public resource<T, S = void>(\n    fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n    source?: { value: S },\n    optionsOrName?: string | ResourceOptions<T>,\n  ): Resource<T> {\n    const isOptionsObject = optionsOrName && typeof optionsOrName === 'object';\n    const signalName = isOptionsObject\n      ? (optionsOrName as ResourceOptions<T>).name\n      : (optionsOrName as string) || 'unnamed_resource';\n\n    const options: Partial<ResourceOptions<T>> = isOptionsObject\n      ? (optionsOrName as ResourceOptions<T>)\n      : {};\n\n    const resetDataOnSourceChange = options.resetDataOnSourceChange ?? true;\n    const validate = options.responseValidate;\n\n    const retryCount = options.retryCount ?? 0;\n    const baseDelay = options.retryDelay ?? 1000;\n    const useExponential = options.isExponentialBackoffEnabled ?? false;\n    const maxRetryDelay = options.maxRetryDelay ?? 30000;\n\n    const state = this.signal<ResourceState<T>>(\n      { data: null, loading: true, error: null, isRetrying: false },\n      signalName\n    );\n\n    // ИСПРАВЛЕНИЕ 1: Функция load теперь принимает нативный AbortSignal в качестве аргумента!\n    const load = async (sValue: S, currentSignal: AbortSignal, isSourceChange = false) => {\n      const shouldClear = isSourceChange && resetDataOnSourceChange;\n      const currentData = shouldClear ? null : this.untrack(() => state.value.data);\n\n      state.value = { data: currentData, loading: true, error: null, isRetrying: false };\n\n      for (let attempt = 0; attempt <= retryCount; attempt++) {\n        try {\n          if (currentSignal.aborted) return; // Условие 1: до запроса\n\n          const data = await fetcher(sValue, currentSignal);\n\n          // КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ 1: Жесткая проверка СРАЗУ после fetcher.\n          // Если пока парсился json() или выполнялся fetch, прилетел abort — мгновенно выходим!\n          if (currentSignal.aborted) {\n            return;\n          }\n\n          if (validate) {\n            const validationResult = validate(data);\n            if (validationResult === false || typeof validationResult === 'string') {\n              // ЕЩЕ ОДНА ПРОВЕРИКА: Вдруг отмена прилетела во время валидации\n              if (currentSignal.aborted) return;\n\n              const errorMsg = typeof validationResult === 'string' ? validationResult : 'Validation failed';\n              state.value = { data: null, loading: false, error: new Error(errorMsg), isRetrying: false };\n              return;\n            }\n          }\n\n          // КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ 2: Последняя guard-проверка прямо перед изменением стейта!\n          // Это гарантирует, что старый асинхронный поток НИКОГДА не затрет актуальные новые данные.\n          if (currentSignal.aborted) {\n            return;\n          }\n\n          state.value = { data, loading: false, error: null, isRetrying: false };\n          return;\n\n        } catch (e: any) {\n          // 1. Если прилетел abort во время fetch — мгновенно выходим\n          if (currentSignal.aborted || e.name === 'AbortError' || e.message?.includes('abort')) {\n            return;\n          }\n\n          if (attempt === retryCount) {\n            // Защищаем запись ошибки от Race Condition\n            if (currentSignal.aborted) return;\n            state.value = { data: null, loading: false, error: e, isRetrying: false };\n          } else {\n            // 2. ЖЕСТКИЙ GUARD: Если отмена прилетела прямо перед расчетом задержки,\n            // мы вообще не создаем новый таймер и не пускаем цикл дальше!\n            if (currentSignal.aborted) return;\n\n            let currentDelay = useExponential ? baseDelay * Math.pow(2, attempt) : baseDelay;\n            currentDelay = Math.min(currentDelay, maxRetryDelay);\n            const jitter = Math.random() * 200;\n            currentDelay = currentDelay + jitter;\n\n            state.value = { data: state.value.data, loading: true, error: null, isRetrying: true };\n\n            try {\n              // 3. Уходим в сон\n              await this.delay(currentDelay, currentSignal);\n\n              // 4. КРИТИЧЕСКОЕ ИСПРАВЛЕНИЕ: Проверяем сигнал СРАЗУ после просыпания,\n              // ПЕРЕД тем, как цикл for перейдет на следующую итерацию и вызовет fetcher!\n              if (currentSignal.aborted) return;\n            } catch (delayError) {\n              // Если за время сна прилетел abort и delay выкинул исключение\n              return;\n            }\n          }\n        }\n      }\n    };\n\n    // ИСПРАВЛЕНИЕ 2: Для ручного метода refetch храним ссылку на контроллер ПОСЛЕДНЕГО активного эффекта\n    let activeEffectController: AbortController | null = null;\n\n    this.effect(() => {\n      // 1. Четко регистрируем зависимость ТОЛЬКО от источника\n      const sValue = source ? source.value : undefined as S;\n\n      const effectController = new AbortController();\n      activeEffectController = effectController;\n\n      // 2. ИСПРАВЛЕНИЕ: Вызываем load внутри untrack!\n      // Это гарантирует, что мутации state.value внутри load()\n      // НЕ подпишут текущий эффект на изменения самого себя и не вызовут каскадный перезапуск.\n      this.untrack(() => {\n        load(sValue as S, effectController.signal, true);\n      });\n\n      return () => {\n        effectController.abort();\n      };\n    });\n\n    return {\n      get data() { return state.value.data; },\n      get loading() { return state.value.loading; },\n      get error() { return state.value.error; },\n      get isRetrying() { return state.value.isRetrying; },\n      get value() { return state.value; },\n      // При ручном рефетче отменяем текущий активный контроллер и создаем новый для внеочередного load\n      refetch: () => {\n        activeEffectController?.abort();\n        activeEffectController = new AbortController();\n        load(source ? source.value : undefined as S, activeEffectController.signal, false);\n      },\n      subscribe: (cb) => state.subscribe(cb)\n    };\n  }\n\n  /**\n   * Выполняет функцию без отслеживания зависимостей.\n   * @template T\n   * @function untrack\n   * @param {Function} fn - Функция для выполнения.\n   * @returns {T} - Результат выполнения функции.\n   * @source\n   */\n  public untrack<T>(fn: () => T): T {\n    const prev = this.activeEffect;\n    this.activeEffect = null; // Временно \"забываем\" про активный эффект\n    try {\n      return fn();\n    } finally {\n      this.activeEffect = prev; // Возвращаем эффект на место\n    }\n  }\n\n  /**\n   * Установка адаптеров React.\n   * @function setReactAdapters\n   * @param {Function} useState - Функция useState из React.\n   * @param {Function} useEffect - Функция useEffect из React.\n   * @returns {void}\n   * @source\n   */\n  // Импортируйте useState и useEffect на верхнем уровне файла из 'react'\n  public setReactAdapters(\n    useState: typeof useStateFromReact,\n    useEffect: typeof useEffectFromReact\n  ): void {\n    this.reactAdapters = { useState, useEffect };\n  }\n\n\n  /**\n   * Использование реактивного значения в React компоненте.\n   * @template T\n   * @function use\n   * @param {{ value: T; subscribe: (cb: (v: T) => void) => CleanupFn }} item - Реактивный объект.\n   * @returns {T} - Значение реактивного объекта.\n   * @source\n   */\n  public use<T>(item: { value: T; subscribe: (cb: (v: T) => void) => CleanupFn }): T {\n    if (!this.reactAdapters) {\n      throw new Error(\"[React Error]: Адаптеры React не установлены. Вызовите engine.setReactAdapters(useState, useEffect).\");\n    }\n\n    // NOTE: (защита) проверяем, что нам передали объект сигнала\n    if (!item || typeof item.subscribe !== 'function') {\n      const errorMsg = `\n        [Reactive Error]: engine.use() получил некорректный объект!\n        Скорее всего, вы пытаетесь подписаться на свойство сервиса, которое не было инициализировано.\n        Проверьте, что в классе написано: public mySignal = this.engine.signal(...)\n      `;\n      console.error(errorMsg, { item });\n      throw new Error(errorMsg);\n    }\n    const [val, setVal] = this.reactAdapters.useState(item.value);\n\n    this.reactAdapters.useEffect(\n      () => {\n        return item.subscribe(setVal);\n      },\n      [item]\n    );\n\n    return val;\n  }\n\n  /**\n   * Безопасное выполнение функции.\n   * @private\n   * @function safeRun\n   * @param {IEffect} effect - Эффект.\n   * @param {Function} fn - Функция для выполнения.\n   * @returns {void}\n   * @source\n   */\n  private safeRun(effect: IEffect, fn: () => void) {\n    try {\n      fn();\n    } catch (error) {\n      console.error(\n        `%c[Reactive Error] %cОшибка в эффекте/computed:`,\n        \"color: white; background: red; padding: 2px 4px; border-radius: 3px;\",\n        \"font-weight: bold;\",\n        error\n      );\n      // Здесь можно отправить ошибку в Sentry или другой сервис мониторинга\n    }\n  }\n}\n","import React, { useSyncExternalStore, useMemo, useEffect, useRef } from 'react';\nimport { ReactiveEngine } from '../core';\n\n/**\n * Свойства для инлайн-компонента {@link Observer}.\n */\ninterface ObserverProps {\n  /**\n   * Функция-рендер, возвращающая JSX-разметку.\n   * Сигналы, прочитанные внутри этого коллбека, будут автоматически отслеживаться.\n   */\n  children: () => React.ReactNode;\n}\n\n/**\n * Фабрика для создания инлайн-компонента `<Observer>`.\n *\n * @param engine - Экземпляр реактивного движка {@link ReactiveEngine}.\n * @returns Специальный React-компонент для точечной изоляции реактивных обновлений в JSX.\n *\n * @example\n * ```tsx\n * import { createObserverComponent, engine } from '@pravosleva/reactive-engine';\n *\n * const Observer = createObserverComponent(engine);\n * const priceSignal = engine.signal(100);\n *\n * export const MyComponent = () => {\n *   return (\n *     <div>\n *       <h1>Статический тяжелый контент (не перерисовывается)</h1>\n *       <Observer>\n *         {() => <span>Живая цена: {priceSignal.value}</span>}\n *       </Observer>\n *     </div>\n *   );\n * };\n * ```\n */\nexport const createObserverComponent = (engine: ReactiveEngine) => {\n  return ({ children }: ObserverProps): any => {\n    const versionRef = useRef(0);\n    const onStoreChangeRef = useRef<(() => void) | null>(null);\n\n    // Ссылки для удержания инстанса эффекта и функции отписки\n    const unsubscribeRef = useRef<(() => void) | null>(null);\n    const effectObjRef = useRef<any>(null);\n\n    // 1. Создаем стабильный мост подписки для React ОДИН раз за жизнь компонента\n    const storeBridge = useMemo(() => {\n      return {\n        subscribe(onStoreChange: () => void) {\n          onStoreChangeRef.current = onStoreChange;\n          return () => {\n            onStoreChangeRef.current = null;\n            if (unsubscribeRef.current) {\n              unsubscribeRef.current();\n              unsubscribeRef.current = null;\n              effectObjRef.current = null;\n            }\n          };\n        },\n        getSnapshot() {\n          return versionRef.current;\n        }\n      };\n    }, []);\n\n    // Очистка при полном размонтировании из DOM\n    useEffect(() => {\n      return () => {\n        if (unsubscribeRef.current) unsubscribeRef.current();\n      };\n    }, []);\n\n    // 2. ЛЕЗИ-ИНИЦИАЛИЗАЦИЯ: Создаем реактивный эффект ядра ровно 1 раз.\n    // Этот эффект будет жить вечно вместе с компонентом и никогда не сбросит свои подписки!\n    if (!unsubscribeRef.current) {\n      unsubscribeRef.current = engine.effect(() => {\n        // Если этот эффект триггерится асинхронно из-за изменения сигнала в ядре:\n        if (onStoreChangeRef.current) {\n          versionRef.current++; // Инкрементируем версию снапшота для React\n\n          // Мягко пушим React на ререндер через микрозадачу\n          queueMicrotask(() => {\n            if (onStoreChangeRef.current) {\n              onStoreChangeRef.current();\n            }\n          });\n        }\n      });\n\n      // Хак: Вытаскиваем ссылку на сам объект эффекта, который только что зарегился в ядре\n      effectObjRef.current = Array.from((engine as any).allEffects).pop();\n    }\n\n    // 3. ГЛАВНАЯ МАГИЯ: Каждый раз, когда React заходит на рендер (включая StrictMode),\n    // мы вручную подменяем activeEffect ядра на НАШ долгоживущий эффект на время выполнения children().\n    // Это заставляет ядро автоматически ДОБАВЛЯТЬ новые сигналы в зависимости и никогда не терять старые!\n    const prevActiveEffect = (engine as any).activeEffect;\n    (engine as any).activeEffect = effectObjRef.current;\n\n    let result: React.ReactNode = null;\n    try {\n      result = children(); // Синхронно выполняем рендер компонента и собираем сигналы\n    } finally {\n      // Возвращаем глобальный контекст ядра в исходное состояние\n      (engine as any).activeEffect = prevActiveEffect;\n    }\n\n    // Подключаем нативныйuseSyncExternalStore к нашей стабильной версии стейта\n    useSyncExternalStore(storeBridge.subscribe, storeBridge.getSnapshot);\n\n    return result as unknown as React.ReactElement;\n  };\n};\n\ninterface TriggerProps {\n  engine: ReactiveEngine;\n  Component: React.ComponentType<any>;\n  props: any;\n  onTrigger: () => void;\n}\n\n/**\n * Вспомогательный компонент, изолирующий выполнение пользовательского компонента\n * от функции safeRun движка во время сбора реактивных зависимостей.\n */\nconst ReactiveRenderTrigger = ({ engine, Component, props, onTrigger }: TriggerProps) => {\n  let renderedElement: React.ReactNode = null;\n\n  // 1. Создаем эффект движка. Он инициализируется пустым, чтобы не оборачивать\n  // вызов компонента в safeRun и не ломать правила хуков React.\n  const unsub = engine.effect(() => {\n    // Этот коллбек сработает, когда изменятся сигналы, считанные в JSX ниже\n    onTrigger();\n  });\n\n  // Преобразуем инстанс движка в any, чтобы достучаться до внутренних (private/protected) свойств\n  const enginePrivate = engine as any;\n\n  // 2. Извлекаем объект созданного эффекта из внутренней коллекции движка.\n  // Если у вас свойство называется иначе, проверьте имя в коде: this.allEffects.add(effectObj);\n  const allEffectsArray = Array.from(enginePrivate.allEffects || []);\n  const currentEffectObj = allEffectsArray[allEffectsArray.length - 1];\n\n  // Определяем точное имя свойства активного эффекта.\n  // Если в коде класса оно написано как activeEffect, то используем его через any.\n  const activeEffectKey = 'activeEffect' in enginePrivate ? 'activeEffect' : '_activeEffect';\n\n  const prevActive = enginePrivate[activeEffectKey];\n  enginePrivate[activeEffectKey] = currentEffectObj;\n\n  try {\n    // 3. Вызываем компонент напрямую в экосистеме React.\n    // Все внутренние хуки (useEffect, useRef) теперь работают штатно.\n    if (typeof Component === 'function' && !Component.prototype?.isReactComponent) {\n      renderedElement = (Component as Function)(props);\n    } else {\n      renderedElement = React.createElement(Component, props);\n    }\n  } finally {\n    // 4. Возвращаем движок в исходное состояние и подчищаем временный эффект\n    enginePrivate[activeEffectKey] = prevActive;\n    unsub();\n  }\n\n  return renderedElement;\n};\n\n/**\n * Функция высшего порядка (HOC) для автоматического отслеживания сигналов внутри React-компонента.\n * Полный аналог `observer` из MobX.\n *\n * @template P - Объект пропсов оборачиваемого компонента.\n * @param engine - Экземпляр реактивного движка {@link ReactiveEngine}.\n * @returns Функция-декоратор, преобразующая обычный компонент в реактивный.\n *\n * @example\n * ```tsx\n * import { createObserver } from '@pravosleva/reactive-engine';\n * import { engine } from '~/utils/ReactiveEngine'; // Ваш локальный экземпляр движка\n *\n * const observer = createObserver(engine);\n * const counterSignal = engine.signal(0);\n *\n * // Компонент автоматически перерисуется при изменении counterSignal.value\n * export const CounterView = observer(() => {\n *   return (\n *     <div>\n *       <p>Счетчик: {counterSignal.value}</p>\n *       <button onClick={() => counterSignal.value++}>+1</button>\n *     </div>\n *   );\n * });\n * ```\n *\n * @source\n */\nexport const createObserver = (engine: ReactiveEngine) => {\n  return <P extends object>(Component: React.ComponentType<P>): React.ComponentType<P> => {\n\n    const ObserverComponent = (props: P) => {\n      const versionRef = useRef(0);\n      const enginePrivate = engine as any;\n\n      // Опеределяем внутреннее имя свойства активного эффекта в вашем движке\n      const activeEffectKey = 'activeEffect' in enginePrivate ? 'activeEffect' : '_activeEffect';\n\n      // Хранилище для инстанса долгоживущего эффекта движка\n      const effectObjRef = useRef<any>(null);\n\n      // Интеграция с подписками React 18+ через useSyncExternalStore\n      const { subscribe, getSnapshot } = useMemo(() => {\n        return {\n          subscribe: (onStoreChange: () => void) => {\n            // Создаем ОДИН долгоживущий эффект на весь жизненный цикл компонента.\n            // Он уничтожится только тогда, когда React размонтирует компонент.\n            const unsub = engine.effect(() => {\n              // При изменении сигналов инкрементируем версию и уведомляем React\n              versionRef.current++;\n              onStoreChange();\n            });\n\n            // Нам нужно получить объект этого эффекта.\n            // Из вашего кода метода `effect`: эффект добавляется в `this.allEffects.add(effectObj)`.\n            const allEffectsArray = Array.from(enginePrivate.allEffects || []);\n            effectObjRef.current = allEffectsArray[allEffectsArray.length - 1];\n\n            return () => {\n              unsub(); // Чистим эффект при размонтировании\n              effectObjRef.current = null;\n            };\n          },\n          getSnapshot: () => versionRef.current\n        };\n      }, []);\n\n      // Подписываем компонент. React сам управляет вызовами subscribe/unsubscribe в StrictMode.\n      useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n\n      // --- ФАЗА СБОРА ЗАВИСИМОСТЕЙ ---\n      // Если эффект уже создан (компонент смонтирован), мы временно подставляем его в движок.\n      // Если это самый первый рендер (эффекта еще нет в subscribe), мы берем временный \"заглушечный\"\n      // объект эффекта, чтобы движок не упал, а сигналы зарегистрировали чтение.\n      const fallbackEffect = { cleanups: new Set(), run: () => { } };\n      const currentEffect = effectObjRef.current || fallbackEffect;\n\n      // Перед рендером подменяем активный эффект\n      const prevActive = enginePrivate[activeEffectKey];\n      enginePrivate[activeEffectKey] = currentEffect;\n\n      let renderedElement: React.ReactNode = null;\n      try {\n        // Вызываем компонент напрямую. Хуки типа useEffect работают идеально,\n        // так как они не обернуты в safeRun движка.\n        if (typeof Component === 'function' && !Component.prototype?.isReactComponent) {\n          renderedElement = (Component as Function)(props);\n        } else {\n          renderedElement = React.createElement(Component, props);\n        }\n      } finally {\n        // После рендера возвращаем исходное состояние движка\n        enginePrivate[activeEffectKey] = prevActive;\n      }\n\n      return renderedElement;\n    };\n\n    ObserverComponent.displayName = `Observer(${Component.displayName || Component.name || 'Component'})`;\n    return ObserverComponent as React.ComponentType<P>;\n  };\n};\n","interface CacheEntry<T> {\n  data: T;\n  timestamp: number;\n}\n\ninterface CacheOptions {\n  /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n  ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки кэширования\n * @source\n */\nexport const withCache = <S, T>(\n  fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n  options: CacheOptions = {}\n) => {\n  const ttl = options.ttl ?? 5 * 60 * 1000; // Дефолтный TTL: 5 минут\n  const cache = new Map<string, CacheEntry<T>>();\n\n  return async (source: S, signal: AbortSignal): Promise<T> => {\n    // 1. Генерируем уникальный ключ на основе зависимостей (массива или объекта)\n    const cacheKey = typeof source === 'object' && source !== null\n      ? JSON.stringify(source)\n      : String(source);\n\n    const now = Date.now();\n    const cached = cache.get(cacheKey);\n\n    // 2. Проверяем, есть ли валидный (не устаревший) кэш\n    if (cached && (now - cached.timestamp < ttl)) {\n      return cached.data;\n    }\n\n    // 3. Если кэша нет или он устарел — делаем реальный сетевой запрос\n    const freshData = await fetcher(source, signal);\n\n    // 4. Сохраняем свежие данные и метку времени в кэш\n    cache.set(cacheKey, {\n      data: freshData,\n      timestamp: Date.now() // берем актуальное время после завершения запроса\n    });\n\n    return freshData;\n  };\n};\n","import { useEffect, useRef } from 'react';\nimport { Signal, CleanupFn } from '../core';\n\n/**\n * Универсальный хук для подписки на изменения Signal, Computed или Resource.\n * @template T Тип данных внутри реактивного контейнера\n * @param {Signal<T> | { subscribe: (cb: (val: T) => void) => CleanupFn }} signal Объект подписки\n * @param {(val: T) => void} callback Функция обратного вызова, принимающая новое значение\n * @source\n */\nexport const useReactiveSubscription = <T>(\n  signal: Pick<Signal<T>, 'subscribe'>,\n  callback: (val: T) => void\n): void => {\n  // Сохраняем актуальный callback в ref, чтобы не перезапускать эффект при его изменении\n  const callbackRef = useRef(callback);\n\n  useEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n\n  useEffect(() => {\n    // Подписываемся один раз при изменении самого signal\n    const unsubscribe: CleanupFn = signal.subscribe((val) => {\n      callbackRef.current(val);\n    });\n\n    // Возвращаем функцию очистки для автоматической отписки при размонтировании\n    return unsubscribe;\n  }, [signal]);\n};\n","import { useSyncExternalStore, useCallback, useMemo, useEffect } from \"react\";\nimport { CleanupFn } from '../core';\n\ninterface ObservableItem<T> {\n  readonly value: T;\n  subscribe: (cb: (val: T) => void) => CleanupFn;\n  destroy?: () => void;\n}\n\ntype ReactiveInput<T> = ObservableItem<T> | (() => ObservableItem<T>);\n\n/**\n * Хук для извлечения значения из Signal/Computed/Resource и авто-ререндера компонента.\n * Поддерживает React 18+ и ленивые фабрики без утечек памяти.\n *\n * @source\n */\nexport const useReactiveValue = <T>(input: ReactiveInput<T>): T => {\n  // 1. Всегда получаем чистый объект, даже если передали функцию-фабрику () => engine.computed(...)\n  const reactiveItem = useMemo(() => {\n    return typeof input === 'function' ? input() : input;\n  }, [input]);\n\n  // 2. Стабилизируем функции для useSyncExternalStore\n  const subscribe = useCallback(\n    (reactCallback: () => void) => {\n      return reactiveItem.subscribe(reactCallback);\n    },\n    [reactiveItem]\n  );\n\n  const getSnapshot = useCallback(() => {\n    return reactiveItem.value;\n  }, [reactiveItem]);\n\n  // 3. Автоматически подчищаем динамические вычисления при размонтировании\n  useEffect(() => {\n    return () => {\n      if (reactiveItem && typeof reactiveItem.destroy === 'function') {\n        reactiveItem.destroy();\n      }\n    };\n  }, [reactiveItem]);\n\n  return useSyncExternalStore(subscribe, getSnapshot);\n};\n","import { useState, useEffect, useRef, useMemo } from \"react\";\nimport { CleanupFn } from '../core';\n\ninterface ObservableItem<T> {\n  readonly value: T;\n  subscribe: (cb: (val: T) => void) => CleanupFn;\n  destroy?: () => void;\n}\n\ntype ReactiveInput<T> = ObservableItem<T> | (() => ObservableItem<T>);\n\n/**\n * Fallback хук для извлечения значения из сигналов. Поддерживает React 16.8+.\n *\n * @source\n */\nexport const useReactiveValue0 = <T>(input: ReactiveInput<T>): T => {\n  const reactiveItem = useMemo(() => {\n    return typeof input === 'function' ? input() : input;\n  }, [input]);\n\n  const [state, setState] = useState<T>(reactiveItem.value);\n  const setStateRef = useRef(setState);\n\n  useEffect(() => {\n    setStateRef.current = setState;\n  }, [setState]);\n\n  useEffect(() => {\n    setStateRef.current(reactiveItem.value);\n\n    const unsubscribe = reactiveItem.subscribe((newValue) => {\n      setStateRef.current(newValue);\n    });\n\n    return () => {\n      unsubscribe();\n      if (reactiveItem && typeof reactiveItem.destroy === 'function') {\n        reactiveItem.destroy();\n      }\n    };\n  }, [reactiveItem]);\n\n  return state;\n};\n"],"mappings":"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"}

package/dist/mockServiceWorker.js

@@ -0,0 +1,361 @@
+/* eslint-disable */
+/* tslint:disable */
+
+/**
+ * Mock Service Worker.
+ * @see https://github.com/mswjs/msw
+ * - Please do NOT modify this file.
+ */
+
+const PACKAGE_VERSION = '2.15.0'
+const INTEGRITY_CHECKSUM = '03cb67ac84128e63d7cd722a6e5b7f1e'
+const IS_MOCKED_RESPONSE = Symbol('isMockedResponse')
+const activeClientIds = new Set()
+
+addEventListener('install', function () {
+  self.skipWaiting()
+})
+
+addEventListener('activate', function (event) {
+  event.waitUntil(self.clients.claim())
+})
+
+addEventListener('message', async function (event) {
+  const clientId = Reflect.get(event.source || {}, 'id')
+
+  if (!clientId || !self.clients) {
+    return
+  }
+
+  const client = await self.clients.get(clientId)
+
+  if (!client) {
+    return
+  }
+
+  const allClients = await self.clients.matchAll({
+    type: 'window',
+  })
+
+  switch (event.data) {
+    case 'KEEPALIVE_REQUEST': {
+      sendToClient(client, {
+        type: 'KEEPALIVE_RESPONSE',
+      })
+      break
+    }
+
+    case 'INTEGRITY_CHECK_REQUEST': {
+      sendToClient(client, {
+        type: 'INTEGRITY_CHECK_RESPONSE',
+        payload: {
+          packageVersion: PACKAGE_VERSION,
+          checksum: INTEGRITY_CHECKSUM,
+        },
+      })
+      break
+    }
+
+    case 'MOCK_ACTIVATE': {
+      activeClientIds.add(clientId)
+
+      sendToClient(client, {
+        type: 'MOCKING_ENABLED',
+        payload: {
+          client: {
+            id: client.id,
+            frameType: client.frameType,
+          },
+        },
+      })
+      break
+    }
+
+    case 'CLIENT_CLOSED': {
+      activeClientIds.delete(clientId)
+
+      const remainingClients = allClients.filter((client) => {
+        return client.id !== clientId
+      })
+
+      // Unregister itself when there are no more clients
+      if (remainingClients.length === 0) {
+        self.registration.unregister()
+      }
+
+      break
+    }
+  }
+})
+
+addEventListener('fetch', function (event) {
+  const requestInterceptedAt = Date.now()
+
+  // Bypass navigation requests.
+  if (event.request.mode === 'navigate') {
+    return
+  }
+
+  // Opening the DevTools triggers the "only-if-cached" request
+  // that cannot be handled by the worker. Bypass such requests.
+  if (
+    event.request.cache === 'only-if-cached' &&
+    event.request.mode !== 'same-origin'
+  ) {
+    return
+  }
+
+  // Bypass all requests when there are no active clients.
+  // Prevents the self-unregistered worked from handling requests
+  // after it's been terminated (still remains active until the next reload).
+  if (activeClientIds.size === 0) {
+    return
+  }
+
+  const requestId = crypto.randomUUID()
+  event.respondWith(handleRequest(event, requestId, requestInterceptedAt))
+})
+
+/**
+ * @param {FetchEvent} event
+ * @param {string} requestId
+ * @param {number} requestInterceptedAt
+ */
+async function handleRequest(event, requestId, requestInterceptedAt) {
+  const client = await resolveMainClient(event)
+  const requestCloneForEvents = event.request.clone()
+  const response = await getResponse(
+    event,
+    client,
+    requestId,
+    requestInterceptedAt,
+  )
+
+  // Send back the response clone for the "response:*" life-cycle events.
+  // Ensure MSW is active and ready to handle the message, otherwise
+  // this message will pend indefinitely.
+  if (client && activeClientIds.has(client.id)) {
+    const serializedRequest = await serializeRequest(requestCloneForEvents)
+
+    // Omit the body of server-sent event stream responses.
+    // Cloning such responses would prevent client-side stream cancelations
+    // from reaching the original stream (a teed stream only cancels its
+    // source once both of its branches cancel) and would buffer the
+    // entire stream into the unconsumed clone indefinitely.
+    const isEventStreamResponse = response.headers
+      .get('content-type')
+      ?.toLowerCase()
+      .startsWith('text/event-stream')
+
+    // Clone the response so both the client and the library could consume it.
+    const responseClone = isEventStreamResponse ? null : response.clone()
+
+    sendToClient(
+      client,
+      {
+        type: 'RESPONSE',
+        payload: {
+          isMockedResponse: IS_MOCKED_RESPONSE in response,
+          request: {
+            id: requestId,
+            ...serializedRequest,
+          },
+          response: {
+            type: response.type,
+            status: response.status,
+            statusText: response.statusText,
+            headers: Object.fromEntries(response.headers.entries()),
+            body: responseClone ? responseClone.body : null,
+          },
+        },
+      },
+      responseClone && responseClone.body
+        ? [serializedRequest.body, responseClone.body]
+        : [],
+    )
+  }
+
+  return response
+}
+
+/**
+ * Resolve the main client for the given event.
+ * Client that issues a request doesn't necessarily equal the client
+ * that registered the worker. It's with the latter the worker should
+ * communicate with during the response resolving phase.
+ * @param {FetchEvent} event
+ * @returns {Promise<Client | undefined>}
+ */
+async function resolveMainClient(event) {
+  const client = await self.clients.get(event.clientId)
+
+  if (activeClientIds.has(event.clientId)) {
+    return client
+  }
+
+  if (client?.frameType === 'top-level') {
+    return client
+  }
+
+  const allClients = await self.clients.matchAll({
+    type: 'window',
+  })
+
+  return allClients
+    .filter((client) => {
+      // Get only those clients that are currently visible.
+      return client.visibilityState === 'visible'
+    })
+    .find((client) => {
+      // Find the client ID that's recorded in the
+      // set of clients that have registered the worker.
+      return activeClientIds.has(client.id)
+    })
+}
+
+/**
+ * @param {FetchEvent} event
+ * @param {Client | undefined} client
+ * @param {string} requestId
+ * @param {number} requestInterceptedAt
+ * @returns {Promise<Response>}
+ */
+async function getResponse(event, client, requestId, requestInterceptedAt) {
+  // Clone the request because it might've been already used
+  // (i.e. its body has been read and sent to the client).
+  const requestClone = event.request.clone()
+
+  function passthrough() {
+    // Cast the request headers to a new Headers instance
+    // so the headers can be manipulated with.
+    const headers = new Headers(requestClone.headers)
+
+    // Remove the "accept" header value that marked this request as passthrough.
+    // This prevents request alteration and also keeps it compliant with the
+    // user-defined CORS policies.
+    const acceptHeader = headers.get('accept')
+    if (acceptHeader) {
+      const values = acceptHeader.split(',').map((value) => value.trim())
+      const filteredValues = values.filter(
+        (value) => value !== 'msw/passthrough',
+      )
+
+      if (filteredValues.length > 0) {
+        headers.set('accept', filteredValues.join(', '))
+      } else {
+        headers.delete('accept')
+      }
+    }
+
+    return fetch(requestClone, { headers })
+  }
+
+  // Bypass mocking when the client is not active.
+  if (!client) {
+    return passthrough()
+  }
+
+  // Bypass initial page load requests (i.e. static assets).
+  // The absence of the immediate/parent client in the map of the active clients
+  // means that MSW hasn't dispatched the "MOCK_ACTIVATE" event yet
+  // and is not ready to handle requests.
+  if (!activeClientIds.has(client.id)) {
+    return passthrough()
+  }
+
+  // Notify the client that a request has been intercepted.
+  const serializedRequest = await serializeRequest(event.request)
+  const clientMessage = await sendToClient(
+    client,
+    {
+      type: 'REQUEST',
+      payload: {
+        id: requestId,
+        interceptedAt: requestInterceptedAt,
+        ...serializedRequest,
+      },
+    },
+    [serializedRequest.body],
+  )
+
+  switch (clientMessage.type) {
+    case 'MOCK_RESPONSE': {
+      return respondWithMock(clientMessage.data)
+    }
+
+    case 'PASSTHROUGH': {
+      return passthrough()
+    }
+  }
+
+  return passthrough()
+}
+
+/**
+ * @param {Client} client
+ * @param {any} message
+ * @param {Array<Transferable>} transferrables
+ * @returns {Promise<any>}
+ */
+function sendToClient(client, message, transferrables = []) {
+  return new Promise((resolve, reject) => {
+    const channel = new MessageChannel()
+
+    channel.port1.onmessage = (event) => {
+      if (event.data && event.data.error) {
+        return reject(event.data.error)
+      }
+
+      resolve(event.data)
+    }
+
+    client.postMessage(message, [
+      channel.port2,
+      ...transferrables.filter(Boolean),
+    ])
+  })
+}
+
+/**
+ * @param {Response} response
+ * @returns {Response}
+ */
+function respondWithMock(response) {
+  // Setting response status code to 0 is a no-op.
+  // However, when responding with a "Response.error()", the produced Response
+  // instance will have status code set to 0. Since it's not possible to create
+  // a Response instance with status code 0, handle that use-case separately.
+  if (response.status === 0) {
+    return Response.error()
+  }
+
+  const mockedResponse = new Response(response.body, response)
+
+  Reflect.defineProperty(mockedResponse, IS_MOCKED_RESPONSE, {
+    value: true,
+    enumerable: true,
+  })
+
+  return mockedResponse
+}
+
+/**
+ * @param {Request} request
+ */
+async function serializeRequest(request) {
+  return {
+    url: request.url,
+    mode: request.mode,
+    method: request.method,
+    headers: Object.fromEntries(request.headers.entries()),
+    cache: request.cache,
+    credentials: request.credentials,
+    destination: request.destination,
+    integrity: request.integrity,
+    redirect: request.redirect,
+    referrer: request.referrer,
+    referrerPolicy: request.referrerPolicy,
+    body: await request.arrayBuffer(),
+    keepalive: request.keepalive,
+  }
+}