@pravosleva/reactive-engine 0.3.12-beta → 0.4.2-beta
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.iife.js.map +1 -1
- package/dist/index.mjs.map +1 -1
- package/package.json +9 -2
package/README.md
CHANGED
|
@@ -2,8 +2,10 @@
|
|
|
2
2
|
A lightweight, type-safe reactive engine built with TypeScript, featuring Dependency Injection and seamless React integration.
|
|
3
3
|
|
|
4
4
|
## Instruction
|
|
5
|
-
- 🇬🇧 [In English](https://github.com/garage-13/reactive-engine/blob/main/
|
|
6
|
-
- 🇷🇺 [In Russian](https://github.com/garage-13/reactive-engine/blob/main/
|
|
5
|
+
- 🇬🇧 [In English](https://github.com/garage-13/reactive-engine/blob/main/docs/en/guides/index.md)
|
|
6
|
+
- 🇷🇺 [In Russian](https://github.com/garage-13/reactive-engine/blob/main/docs/guides/index.md)
|
|
7
|
+
|
|
8
|
+
**See also https://pravosleva.pro/reactive-engine**
|
|
7
9
|
|
|
8
10
|
## 📦 Installation
|
|
9
11
|
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/utils/getExtractedValues.ts","../src/core.ts","../src/decorators/createObserver.tsx","../src/decorators/withCache/withCache.ts","../src/decorators/withDebounce/withDebounce.ts","../src/decorators/withLongPolling/withLongPolling.ts","../src/decorators/withThrottle/withThrottle.ts","../src/decorators/withThrottleAndCache/withThrottleAndCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\nexport abstract class AbstractService {\n constructor(protected engine: ReactiveEngine) {\n // Вызываем метод инициализации, который можно переопределить в наследниках\n this.onInit();\n }\n\n // NOTE: Полезные хелперы для сокращения кода\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 protected createComputed<T>(fn: () => T) {\n return this.engine.computed(fn);\n }\n\n protected createSignal<T>(val: T, name?: string) {\n return this.engine.signal(val, name);\n }\n\n // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n // Удобно для инициализации сигналов, которые зависят от engine.\n protected onInit(): void { }\n}\n\nexport const BaseREService = AbstractService\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","export const getExtractedValues = ({\n tested, expectedKey, valueType\n}: {\n tested: string[];\n expectedKey: string;\n valueType: 'number' | 'string';\n}): string[] => {\n const results: string[] = [];\n for (let i = 0, max = tested.length; i < max; i++) {\n const t = tested[i];\n let regex;\n switch (valueType) {\n case 'number':\n regex = new RegExp(`\\\\[${expectedKey}=(?<value>\\\\d+)\\\\]`, 'g');\n break;\n case 'string':\n default:\n // NOTE: \"Ленивый\" квантификатор -> \".*?\" будет искать минимальное количество символов до следующего экранированного \"]\"\n regex = new RegExp(`\\\\[${expectedKey}=(?<value>.*?)\\\\]`, 'g');\n break;\n }\n\n // eslint-disable-next-line no-restricted-syntax\n for (const n of t.matchAll(regex)) {\n if (n?.groups) { results.push(n.groups.value); }\n }\n }\n return results;\n};\n","import { useState as useStateFromReact, useEffect as useEffectFromReact } from 'react';\nimport { getExtractedValues } from './utils';\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, S> {\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 /** Функция валидации входных зависимостей (source) перед запуском fetch.\n * Если возвращает false или string (текст ошибки) — запрос и ретраи блокируются. */\n validateBeforeFetch?: (sourceValue: S) => boolean | string;\n /** Настройка лимита повторов retry. */\n retryCount?: number;\n /** Настройка задержки первого повтора retry. */\n retryDelay?: number;\n /** Включить экспоненциальное увеличение задержки (каждая попытка ждет в 2 раза дольше). По умолчанию: false */\n isExponentialBackoffEnabled?: boolean;\n /** Максимальный лимит ожидания между попытками в миллисекундах. По умолчанию: 30000 (30 секунд) */\n maxRetryDelay?: number;\n /** Максимальное время ожидания ответа сервера в миллисекундах. По умолчанию: отсутствует (бесконечно) */\n timeout?: 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 * Вызов new DOMException('Aborted', 'AbortError') гарантирует,\n * что ваша кастомная пауза между ретраями this.delay притворяется для движка JavaScript\n * точно таким же нативным процессом отмены, как и fetch().\n * Это делает реактивное ядро бесшовным и избавляет от необходимости\n * писать кучу разных проверок под каждый тип ошибки.\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/200-resource/Example200.tsx Реализация базового компонента Example200}\n * @see {@link https://github.com/garage-13/reactive-engine/blob/main/src/examples/201-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 *\n * @example\n * // (Экспериментальная фича)\n * // В теле fetcher можно выкинуть ошибку в виде\n * // `throw new Error('[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1][MESSAGE=Your msg]')`\n * // Причина: Особенности внутренней реализации определения харакрера ошибки и необходимость делать retry (если такая опция передана)\n * // Рекомендуем вместо этого использовать `validateBeforeFetch` в опциях при создании ресурса.\n * const res = engine.resource(\n * async (counterValue, abortSignal) => {\n * if (counterValue === 0)\n * throw new Error([\n * '[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1]', // Иначе запустится механизм retry (напр. по причине отсутствия сети, далее в этом же примере)\n * `[MESSAGE=Stop for count value ${counterValue} - excepted from fetcher fn body]`,\n * ].join(' '))\n * const res = await fetch(\n * [\n * `${BASE_API_URL}/profile/search`,\n * '?',\n * [\n * `counter=${counterValue}`,\n * '_responseDelay=2000',\n * ].join('&')\n * ].join(''),\n * { signal: abortSignal }\n * )\n * if (!res.ok) throw new Error(`HTTP error! status: ${res.status}`)\n * return res.json()\n * },\n * this.counter,\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, S>,\n ): Resource<T> {\n const isOptionsObject = optionsOrName && typeof optionsOrName === 'object';\n const signalName = isOptionsObject\n ? (optionsOrName as ResourceOptions<T, S>).name\n : (optionsOrName as string) || 'unnamed_resource';\n\n const options: Partial<ResourceOptions<T, S>> = isOptionsObject\n ? (optionsOrName as ResourceOptions<T, S>)\n : {};\n\n const resetDataOnSourceChange = options.resetDataOnSourceChange ?? true;\n const responseValidate = options.responseValidate;\n const validateBeforeFetch = options.validateBeforeFetch;\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 const timeoutMs = options.timeout;\n\n const state = this.signal<ResourceState<T>>(\n { data: null, loading: true, error: null, isRetrying: false },\n signalName\n );\n\n const load = async (sValue: S, effectSignal: AbortSignal, isSourceChange = false) => {\n if (effectSignal.aborted) return;\n\n if (validateBeforeFetch) {\n const preValidationResult = validateBeforeFetch(sValue);\n if (preValidationResult === false || typeof preValidationResult === 'string') {\n if (effectSignal.aborted) return;\n const errorMsg = typeof preValidationResult === 'string'\n ? preValidationResult\n : 'Pre-fetch validation failed for resource';\n\n // При ручном refetch (не смена source) сохраняем старые данные, а не зануляем\n const currentData = isSourceChange ? null : this.untrack(() => state.value.data);\n state.value = { data: currentData, loading: false, error: new Error(errorMsg), isRetrying: false };\n return;\n }\n }\n\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 if (effectSignal.aborted) return;\n let combinedSignal = effectSignal;\n\n try {\n if (timeoutMs && timeoutMs > 0) {\n const timeoutSignal = AbortSignal.timeout(timeoutMs);\n combinedSignal = AbortSignal.any([effectSignal, timeoutSignal]);\n }\n\n const data = await fetcher(sValue, combinedSignal);\n\n if (effectSignal.aborted) return;\n\n if (combinedSignal.aborted) {\n throw new DOMException('The operation timed out.', 'TimeoutError');\n }\n\n if (responseValidate) {\n const validationResult = responseValidate(data);\n if (validationResult === false || typeof validationResult === 'string') {\n if (effectSignal.aborted) return;\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 if (effectSignal.aborted) return;\n\n state.value = { data, loading: false, error: null, isRetrying: false };\n return;\n } catch (e: any) {\n // ЖЕСТКИЙ ВЫХОД: Если внешняя область (эффект или новый refetch) сделала abort,\n // мы НЕМЕДЛЕННО прекращаем выполнение и ничего не пишем в стейт.\n if (effectSignal.aborted || (e.name === 'AbortError' && effectSignal.aborted)) return;\n\n const isTimeout = e.name === 'TimeoutError' || e.name === 'AbortError' || e.message?.includes('timeout');\n\n const isCustomValidationError = getExtractedValues({\n tested: [e.message], expectedKey: 'THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY', valueType: 'number',\n })?.[0] === '1' || false\n\n const __defaultCustomValidationErrorMessage = 'Custom validation error';\n let customValidationErrorMessage: string = isCustomValidationError\n ? (getExtractedValues({\n tested: [e.message], expectedKey: 'MESSAGE', valueType: 'string',\n })?.[0] || __defaultCustomValidationErrorMessage)\n : __defaultCustomValidationErrorMessage;\n\n const isFetchBodyValidationError = isCustomValidationError || e.name === 'ValidationError';\n\n if (attempt === retryCount || isFetchBodyValidationError) {\n if (effectSignal.aborted) return;\n\n const finalError = isTimeout\n ? new Error(`Request timed out after ${timeoutMs}ms`, { cause: e })\n : isCustomValidationError\n ? new Error(customValidationErrorMessage, { cause: e })\n : e;\n\n state.value = { data: null, loading: false, error: finalError, isRetrying: false };\n return;\n } else {\n if (effectSignal.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 // Безопасно обновляем статус ретрая, только если сигнал живой\n state.value = { data: state.value.data, loading: true, error: null, isRetrying: true };\n\n const logReason = isTimeout ? 'таймауту' : 'ошибке сети';\n console.warn(`[Resource Retry] \"${signalName}\" сбой по ${logReason}. Попытка ${attempt + 1}/${retryCount + 1}...`);\n\n try {\n await this.delay(currentDelay, effectSignal);\n if (effectSignal.aborted) return;\n } catch (delayError) {\n return;\n }\n }\n }\n }\n };\n\n let activeEffectController: AbortController | null = null;\n\n this.effect(() => {\n const sValue = source ? source.value : undefined as S;\n const effectController = new AbortController();\n activeEffectController = effectController;\n\n this.untrack(() => {\n load(sValue as S, effectController.signal, true);\n });\n\n return () => effectController.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 isRetrying() { return state.value.isRetrying; },\n get value() { return state.value; },\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 * Использование реактивного значения в 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","interface DebounceOptions {\n /** Задержка в миллисекундах. По умолчанию 300 мс */\n delay?: number;\n}\n\n/**\n * Декоратор для создания дебаунсящего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки дебаунса\n */\nexport const withDebounce = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: DebounceOptions = {}\n) => {\n const delay = options.delay ?? 300;\n\n // Храним ссылку на активный таймер текущего ожидания\n let timeoutId: ReturnType<typeof setTimeout> | null = null;\n // Храним функцию отмены для предыдущего неоконченного промиса ожидания\n let rejectPrevious: ((reason: any) => void) | null = null;\n\n return (source: S, signal: AbortSignal): Promise<T> => {\n // 1. Если уже идет ожидание другого запроса — отменяем его промис и очищаем таймер\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n if (rejectPrevious) {\n // Бросаем DOMException, имитируя нативную отмену fetch, чтобы движок понял, что запрос прерван\n rejectPrevious(new DOMException('Aborted due to debounce', 'AbortError'));\n }\n\n return new Promise<T>((resolve, reject) => {\n // Сохраняем ссылку на reject текущего промиса, чтобы его мог отменить следующий вызов\n rejectPrevious = reject;\n\n // 2. Слушаем нативный AbortSignal от движка (например, если компонент размонтировался во время дебаунса)\n const onAbort = () => {\n if (timeoutId) clearTimeout(timeoutId);\n reject(new DOMException('Aborted by resource signal', 'AbortError'));\n };\n\n if (signal.aborted) {\n return onAbort();\n }\n signal.addEventListener('abort', onAbort);\n\n // 3. Взводим отложенный таймер выполнения\n timeoutId = setTimeout(async () => {\n // Убираем слушатель, так как таймаут успешно дождался конца\n signal.removeEventListener('abort', onAbort);\n rejectPrevious = null;\n timeoutId = null;\n\n try {\n // 4. Запускаем оригинальный fetcher\n const data = await fetcher(source, signal);\n resolve(data);\n } catch (error) {\n reject(error);\n }\n }, delay);\n });\n };\n};\n","interface LongPollingOptions {\n /** Коллбэк для инкремента реактивного тика (перехода на следующую итерацию поллинга) */\n onNextTick: () => void;\n\n /**\n * Коллбэк, вызываемый при возникновении сетевой ошибки.\n * Позволяет внешней системе узнать о сбое и текущем времени ожидания до следующей попытки.\n *\n * @param {number} delayMs - Текущая задержка Exponential Backoff в миллисекундах перед следующим запросом.\n * @param {() => void} onRetryScheduled - Коллбэк-триггер. Должен быть вызван один раз, чтобы\n * просигнализировать декоратору, что шаг зафиксирован и задержка для следующей ошибки может быть увеличена.\n */\n onError: (delayMs: number, onRetryScheduled: () => void) => void;\n\n /** Пауза перед открытием следующего соединения в миллисекундах. По умолчанию 500 мс */\n delay?: number;\n /** Стартовая задержка Exponential Backoff в миллисекундах. По умолчанию 2000 мс */\n errorInitialDelay?: number;\n /** Потолок задержки Exponential Backoff в миллисекундах. По умолчанию 8000 мс */\n errorMaxDelay?: number;\n /** Внешний сигнал для жесткой остановки рекурсивных таймаутов */\n externalSignal?: AbortSignal;\n}\n\n/**\n * Адаптированный декоратор лонг-поллинга для engine.resource.\n * Принимает строго два аргумента: асинхронную функцию и конфиг-объект.\n */\nexport const withLongPolling = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: LongPollingOptions\n) => {\n const {\n onNextTick,\n onError,\n externalSignal,\n delay = 500,\n errorInitialDelay = 2000,\n errorMaxDelay = 8000\n } = options;\n\n let currentErrorDelay = errorInitialDelay;\n let currentSessionToken = 0;\n\n return (source: S, signal: AbortSignal): Promise<T> => {\n const activeSessionId = ++currentSessionToken;\n\n return new Promise<T>((resolve, reject) => {\n\n const poll = async () => {\n if (signal.aborted || externalSignal?.aborted) {\n reject(new DOMException('Aborted by long polling lifecycle', 'AbortError'));\n return;\n }\n\n try {\n const data = await fetcher(source, signal);\n currentErrorDelay = errorInitialDelay;\n\n if (signal.aborted || externalSignal?.aborted) {\n reject(new DOMException('Aborted by long polling lifecycle', 'AbortError'));\n return;\n }\n\n resolve(data);\n\n setTimeout(() => {\n if (activeSessionId === currentSessionToken && !signal.aborted && !externalSignal?.aborted) {\n onNextTick();\n }\n }, delay);\n\n } catch (error) {\n if (error instanceof DOMException && error.name === 'AbortError') {\n reject(error);\n return;\n }\n\n reject(error);\n const delayDuration = currentErrorDelay;\n\n onError(delayDuration, () => {\n if (activeSessionId === currentSessionToken) {\n currentErrorDelay = Math.min(currentErrorDelay * 2, errorMaxDelay);\n }\n });\n\n setTimeout(() => {\n if (activeSessionId === currentSessionToken && !signal.aborted && !externalSignal?.aborted) {\n onNextTick();\n }\n }, delayDuration);\n }\n };\n\n const forceKillTimer = () => {\n reject(new DOMException('Aborted by lifecycle event', 'AbortError'));\n };\n\n signal.addEventListener('abort', forceKillTimer);\n if (externalSignal) {\n externalSignal.addEventListener('abort', forceKillTimer);\n }\n\n if (signal.aborted || externalSignal?.aborted) {\n return forceKillTimer();\n }\n\n poll();\n });\n };\n};\n","interface ThrottleOptions {\n /** Интервал троттлинга в миллисекундах. По умолчанию 300 мс */\n limit?: number;\n}\n\n/**\n * Декоратор для создания троттлящего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки троттлинга\n */\nexport const withThrottle = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: ThrottleOptions = {}\n) => {\n const limit = options.limit ?? 300;\n\n let lastExecutionTime = 0;\n let throttleTimeoutId: ReturnType<typeof setTimeout> | null = null;\n\n // Храним параметры последнего \"заблокированного\" вызова, чтобы выполнить его на хвосте\n let lastSavedSource: S | null = null;\n let lastSavedResolve: ((value: T | PromiseLike<T>) => void) | null = null;\n let lastSavedReject: ((reason: any) => void) | null = null;\n let lastSavedSignal: AbortSignal | null = null;\n\n return (source: S, signal: AbortSignal): Promise<T> => {\n const now = Date.now();\n const remainingTime = limit - (now - lastExecutionTime);\n\n // Слушатель для мгновенной отмены ожидания, если ресурс размонтировался во время блокировки\n const onAbort = () => {\n if (throttleTimeoutId) {\n clearTimeout(throttleTimeoutId);\n throttleTimeoutId = null;\n }\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted by resource signal during throttle', 'AbortError'));\n lastSavedResolve = null;\n lastSavedReject = null;\n }\n };\n\n // СЦЕНАРИЙ 1: Интервал блокировки истек — выполняем запрос мгновенно (Leading edge)\n if (remainingTime <= 0) {\n // Если висел отложенный хвостовой вызов, отменяем его, так как пришел более свежий прямой запрос\n if (throttleTimeoutId) {\n clearTimeout(throttleTimeoutId);\n throttleTimeoutId = null;\n }\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted due to newer direct throttle execution', 'AbortError'));\n lastSavedResolve = null;\n lastSavedReject = null;\n }\n\n lastExecutionTime = now;\n return fetcher(source, signal);\n }\n\n // СЦЕНАРИЙ 2: Мы находимся внутри интервала блокировки.\n // Запоминаем текущие параметры как самые актуальные для выполнения на хвосте (Trailing edge).\n if (lastSavedReject) {\n // Отклоняем предыдущий сохраненный хвостовой промис, так как данные уже устарели\n lastSavedReject(new DOMException('Aborted due to newer throttled value', 'AbortError'));\n }\n\n return new Promise<T>((resolve, reject) => {\n lastSavedSource = source;\n lastSavedResolve = resolve;\n lastSavedReject = reject;\n lastSavedSignal = signal;\n\n if (signal.aborted) {\n return onAbort();\n }\n signal.addEventListener('abort', onAbort);\n\n // Если таймер хвостового вызова еще не запущен, взводим его на остаток времени блокировки\n if (!throttleTimeoutId) {\n throttleTimeoutId = setTimeout(async () => {\n throttleTimeoutId = null;\n\n const savedSource = lastSavedSource!;\n const savedResolve = lastSavedResolve!;\n const savedReject = lastSavedReject!;\n const savedSignal = lastSavedSignal!;\n\n // Очищаем ссылки перед асинхронным вызовом\n lastSavedSource = null;\n lastSavedResolve = null;\n lastSavedReject = null;\n lastSavedSignal = null;\n savedSignal.removeEventListener('abort', onAbort);\n\n try {\n lastExecutionTime = Date.now();\n const data = await fetcher(savedSource, savedSignal);\n savedResolve(data);\n } catch (error) {\n savedReject(error);\n }\n }, remainingTime);\n }\n });\n };\n};\n","interface ThrottleAndCacheOptions {\n /** Интервал троттлинга в миллисекундах. По умолчанию 300 мс */\n limit?: number;\n /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n ttl?: number;\n}\n\ninterface CacheEntry<T> {\n data: T;\n timestamp: number;\n}\n\n/**\n * Комбинированный декоратор: сначала применяет троттлинг к частоте вызовов,\n * а затем проверяет кэш перед отправкой реального fetcher-запроса.\n */\nexport const withThrottleAndCache = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: ThrottleAndCacheOptions = {}\n) => {\n const limit = options.limit ?? 300;\n const ttl = options.ttl ?? 5 * 60 * 1000;\n\n // Инфраструктура троттлинга\n let lastExecutionTime = 0;\n let throttleTimeoutId: ReturnType<typeof setTimeout> | null = null;\n let lastSavedSource: S | null = null;\n let lastSavedResolve: ((value: T | PromiseLike<T>) => void) | null = null;\n let lastSavedReject: ((reason: any) => void) | null = null;\n let lastSavedSignal: AbortSignal | null = null;\n\n // Инфраструктура кэширования\n const cache = new Map<string, CacheEntry<T>>();\n\n // Внутренний хелпер для генерации ключа кэша\n const getCacheKey = (source: S): string => {\n return typeof source === 'object' && source !== null\n ? JSON.stringify(source)\n : String(source);\n };\n\n return (source: S, signal: AbortSignal): Promise<T> => {\n const now = Date.now();\n const remainingTime = limit - (now - lastExecutionTime);\n const cacheKey = getCacheKey(source);\n\n const onAbort = () => {\n if (throttleTimeoutId) {\n clearTimeout(throttleTimeoutId);\n throttleTimeoutId = null;\n }\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted by resource signal during throttle', 'AbortError'));\n lastSavedResolve = null;\n lastSavedReject = null;\n }\n };\n\n // --- ФУНКЦИЯ ВЫПОЛНЕНИЯ ЗАПРОСА С УЧЕТОМ КЭША ---\n const executeWithCache = async (src: S, sig: AbortSignal): Promise<T> => {\n const currentNow = Date.now();\n const currentKey = getCacheKey(src);\n const cached = cache.get(currentKey);\n\n // Проверяем оперативную память на валидность кэша\n if (cached && currentNow - cached.timestamp < ttl) {\n return cached.data;\n }\n\n // Если кэша нет — делаем реальный запрос\n const freshData = await fetcher(src, sig);\n\n // Сохраняем в кэш\n cache.set(currentKey, {\n data: freshData,\n timestamp: Date.now(),\n });\n\n return freshData;\n };\n\n // --- ВЕТКА 1: Leading edge (Окно блокировки закрыто, выполняем сразу) ---\n if (remainingTime <= 0) {\n if (throttleTimeoutId) {\n clearTimeout(throttleTimeoutId);\n throttleTimeoutId = null;\n }\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted due to newer direct execution', 'AbortError'));\n lastSavedResolve = null;\n lastSavedReject = null;\n }\n\n lastExecutionTime = now;\n return executeWithCache(source, signal);\n }\n\n // --- ВЕТКА 2: Trailing edge (Внутри окна блокировки, перезаписываем хвост) ---\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted due to newer throttled value', 'AbortError'));\n }\n\n return new Promise<T>((resolve, reject) => {\n lastSavedSource = source;\n lastSavedResolve = resolve;\n lastSavedReject = reject;\n lastSavedSignal = signal;\n\n if (signal.aborted) {\n return onAbort();\n }\n signal.addEventListener('abort', onAbort);\n\n if (!throttleTimeoutId) {\n throttleTimeoutId = setTimeout(async () => {\n throttleTimeoutId = null;\n\n const savedSource = lastSavedSource!;\n const savedResolve = lastSavedResolve!;\n const savedReject = lastSavedReject!;\n const savedSignal = lastSavedSignal!;\n\n lastSavedSource = null;\n lastSavedResolve = null;\n lastSavedReject = null;\n lastSavedSignal = null;\n savedSignal.removeEventListener('abort', onAbort);\n\n try {\n lastExecutionTime = Date.now();\n const data = await executeWithCache(savedSource, savedSignal);\n savedResolve(data);\n } catch (error) {\n savedReject(error);\n }\n }, remainingTime);\n }\n });\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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"}
|
|
1
|
+
{"version":3,"file":"index.cjs","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/utils/getExtractedValues.ts","../src/core.ts","../src/decorators/createObserver.tsx","../src/decorators/withCache/withCache.ts","../src/decorators/withDebounce/withDebounce.ts","../src/decorators/withLongPolling/withLongPolling.ts","../src/decorators/withThrottle/withThrottle.ts","../src/decorators/withThrottleAndCache/withThrottleAndCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\nexport abstract class AbstractService {\n constructor(protected engine: ReactiveEngine) {\n // Вызываем метод инициализации, который можно переопределить в наследниках\n this.onInit();\n }\n\n // NOTE: Полезные хелперы для сокращения кода\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 protected createComputed<T>(fn: () => T) {\n return this.engine.computed(fn);\n }\n\n protected createSignal<T>(val: T, name?: string) {\n return this.engine.signal(val, name);\n }\n\n // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n // Удобно для инициализации сигналов, которые зависят от engine.\n protected onInit(): void { }\n}\n\nexport const BaseREService = AbstractService\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","export const getExtractedValues = ({\n tested, expectedKey, valueType\n}: {\n tested: string[];\n expectedKey: string;\n valueType: 'number' | 'string';\n}): string[] => {\n const results: string[] = [];\n for (let i = 0, max = tested.length; i < max; i++) {\n const t = tested[i];\n let regex;\n switch (valueType) {\n case 'number':\n regex = new RegExp(`\\\\[${expectedKey}=(?<value>\\\\d+)\\\\]`, 'g');\n break;\n case 'string':\n default:\n // NOTE: \"Ленивый\" квантификатор -> \".*?\" будет искать минимальное количество символов до следующего экранированного \"]\"\n regex = new RegExp(`\\\\[${expectedKey}=(?<value>.*?)\\\\]`, 'g');\n break;\n }\n\n // eslint-disable-next-line no-restricted-syntax\n for (const n of t.matchAll(regex)) {\n if (n?.groups) { results.push(n.groups.value); }\n }\n }\n return results;\n};\n","import { useState as useStateFromReact, useEffect as useEffectFromReact } from 'react';\nimport { getExtractedValues } from './utils';\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, S> {\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 /** Функция валидации входных зависимостей (source) перед запуском fetch.\n * Если возвращает false или string (текст ошибки) — запрос и ретраи блокируются. */\n validateBeforeFetch?: (sourceValue: S) => boolean | string;\n /** Настройка лимита повторов retry. */\n retryCount?: number;\n /** Настройка задержки первого повтора retry. */\n retryDelay?: number;\n /** Включить экспоненциальное увеличение задержки (каждая попытка ждет в 2 раза дольше). По умолчанию: false */\n isExponentialBackoffEnabled?: boolean;\n /** Максимальный лимит ожидания между попытками в миллисекундах. По умолчанию: 30000 (30 секунд) */\n maxRetryDelay?: number;\n /** Максимальное время ожидания ответа сервера в миллисекундах. По умолчанию: отсутствует (бесконечно) */\n timeout?: 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 * Вызов new DOMException('Aborted', 'AbortError') гарантирует,\n * что ваша кастомная пауза между ретраями this.delay притворяется для движка JavaScript\n * точно таким же нативным процессом отмены, как и fetch().\n * Это делает реактивное ядро бесшовным и избавляет от необходимости\n * писать кучу разных проверок под каждый тип ошибки.\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/examples/200-resource/Example200.tsx Реализация базового компонента Example200}\n * @see {@link https://github.com/garage-13/reactive-engine/blob/main/examples/201-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 *\n * @example\n * // (Экспериментальная фича)\n * // В теле fetcher можно выкинуть ошибку в виде\n * // `throw new Error('[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1][MESSAGE=Your msg]')`\n * // Причина: Особенности внутренней реализации определения харакрера ошибки и необходимость делать retry (если такая опция передана)\n * // Рекомендуем вместо этого использовать `validateBeforeFetch` в опциях при создании ресурса.\n * const res = engine.resource(\n * async (counterValue, abortSignal) => {\n * if (counterValue === 0)\n * throw new Error([\n * '[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1]', // Иначе запустится механизм retry (напр. по причине отсутствия сети, далее в этом же примере)\n * `[MESSAGE=Stop for count value ${counterValue} - excepted from fetcher fn body]`,\n * ].join(' '))\n * const res = await fetch(\n * [\n * `${BASE_API_URL}/profile/search`,\n * '?',\n * [\n * `counter=${counterValue}`,\n * '_responseDelay=2000',\n * ].join('&')\n * ].join(''),\n * { signal: abortSignal }\n * )\n * if (!res.ok) throw new Error(`HTTP error! status: ${res.status}`)\n * return res.json()\n * },\n * this.counter,\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, S>,\n ): Resource<T> {\n const isOptionsObject = optionsOrName && typeof optionsOrName === 'object';\n const signalName = isOptionsObject\n ? (optionsOrName as ResourceOptions<T, S>).name\n : (optionsOrName as string) || 'unnamed_resource';\n\n const options: Partial<ResourceOptions<T, S>> = isOptionsObject\n ? (optionsOrName as ResourceOptions<T, S>)\n : {};\n\n const resetDataOnSourceChange = options.resetDataOnSourceChange ?? true;\n const responseValidate = options.responseValidate;\n const validateBeforeFetch = options.validateBeforeFetch;\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 const timeoutMs = options.timeout;\n\n const state = this.signal<ResourceState<T>>(\n { data: null, loading: true, error: null, isRetrying: false },\n signalName\n );\n\n const load = async (sValue: S, effectSignal: AbortSignal, isSourceChange = false) => {\n if (effectSignal.aborted) return;\n\n if (validateBeforeFetch) {\n const preValidationResult = validateBeforeFetch(sValue);\n if (preValidationResult === false || typeof preValidationResult === 'string') {\n if (effectSignal.aborted) return;\n const errorMsg = typeof preValidationResult === 'string'\n ? preValidationResult\n : 'Pre-fetch validation failed for resource';\n\n // При ручном refetch (не смена source) сохраняем старые данные, а не зануляем\n const currentData = isSourceChange ? null : this.untrack(() => state.value.data);\n state.value = { data: currentData, loading: false, error: new Error(errorMsg), isRetrying: false };\n return;\n }\n }\n\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 if (effectSignal.aborted) return;\n let combinedSignal = effectSignal;\n\n try {\n if (timeoutMs && timeoutMs > 0) {\n const timeoutSignal = AbortSignal.timeout(timeoutMs);\n combinedSignal = AbortSignal.any([effectSignal, timeoutSignal]);\n }\n\n const data = await fetcher(sValue, combinedSignal);\n\n if (effectSignal.aborted) return;\n\n if (combinedSignal.aborted) {\n throw new DOMException('The operation timed out.', 'TimeoutError');\n }\n\n if (responseValidate) {\n const validationResult = responseValidate(data);\n if (validationResult === false || typeof validationResult === 'string') {\n if (effectSignal.aborted) return;\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 if (effectSignal.aborted) return;\n\n state.value = { data, loading: false, error: null, isRetrying: false };\n return;\n } catch (e: any) {\n // ЖЕСТКИЙ ВЫХОД: Если внешняя область (эффект или новый refetch) сделала abort,\n // мы НЕМЕДЛЕННО прекращаем выполнение и ничего не пишем в стейт.\n if (effectSignal.aborted || (e.name === 'AbortError' && effectSignal.aborted)) return;\n\n const isTimeout = e.name === 'TimeoutError' || e.name === 'AbortError' || e.message?.includes('timeout');\n\n const isCustomValidationError = getExtractedValues({\n tested: [e.message], expectedKey: 'THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY', valueType: 'number',\n })?.[0] === '1' || false\n\n const __defaultCustomValidationErrorMessage = 'Custom validation error';\n let customValidationErrorMessage: string = isCustomValidationError\n ? (getExtractedValues({\n tested: [e.message], expectedKey: 'MESSAGE', valueType: 'string',\n })?.[0] || __defaultCustomValidationErrorMessage)\n : __defaultCustomValidationErrorMessage;\n\n const isFetchBodyValidationError = isCustomValidationError || e.name === 'ValidationError';\n\n if (attempt === retryCount || isFetchBodyValidationError) {\n if (effectSignal.aborted) return;\n\n const finalError = isTimeout\n ? new Error(`Request timed out after ${timeoutMs}ms`, { cause: e })\n : isCustomValidationError\n ? new Error(customValidationErrorMessage, { cause: e })\n : e;\n\n state.value = { data: null, loading: false, error: finalError, isRetrying: false };\n return;\n } else {\n if (effectSignal.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 // Безопасно обновляем статус ретрая, только если сигнал живой\n state.value = { data: state.value.data, loading: true, error: null, isRetrying: true };\n\n const logReason = isTimeout ? 'таймауту' : 'ошибке сети';\n console.warn(`[Resource Retry] \"${signalName}\" сбой по ${logReason}. Попытка ${attempt + 1}/${retryCount + 1}...`);\n\n try {\n await this.delay(currentDelay, effectSignal);\n if (effectSignal.aborted) return;\n } catch (delayError) {\n return;\n }\n }\n }\n }\n };\n\n let activeEffectController: AbortController | null = null;\n\n this.effect(() => {\n const sValue = source ? source.value : undefined as S;\n const effectController = new AbortController();\n activeEffectController = effectController;\n\n this.untrack(() => {\n load(sValue as S, effectController.signal, true);\n });\n\n return () => effectController.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 isRetrying() { return state.value.isRetrying; },\n get value() { return state.value; },\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 * Использование реактивного значения в 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","interface DebounceOptions {\n /** Задержка в миллисекундах. По умолчанию 300 мс */\n delay?: number;\n}\n\n/**\n * Декоратор для создания дебаунсящего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки дебаунса\n */\nexport const withDebounce = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: DebounceOptions = {}\n) => {\n const delay = options.delay ?? 300;\n\n // Храним ссылку на активный таймер текущего ожидания\n let timeoutId: ReturnType<typeof setTimeout> | null = null;\n // Храним функцию отмены для предыдущего неоконченного промиса ожидания\n let rejectPrevious: ((reason: any) => void) | null = null;\n\n return (source: S, signal: AbortSignal): Promise<T> => {\n // 1. Если уже идет ожидание другого запроса — отменяем его промис и очищаем таймер\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n if (rejectPrevious) {\n // Бросаем DOMException, имитируя нативную отмену fetch, чтобы движок понял, что запрос прерван\n rejectPrevious(new DOMException('Aborted due to debounce', 'AbortError'));\n }\n\n return new Promise<T>((resolve, reject) => {\n // Сохраняем ссылку на reject текущего промиса, чтобы его мог отменить следующий вызов\n rejectPrevious = reject;\n\n // 2. Слушаем нативный AbortSignal от движка (например, если компонент размонтировался во время дебаунса)\n const onAbort = () => {\n if (timeoutId) clearTimeout(timeoutId);\n reject(new DOMException('Aborted by resource signal', 'AbortError'));\n };\n\n if (signal.aborted) {\n return onAbort();\n }\n signal.addEventListener('abort', onAbort);\n\n // 3. Взводим отложенный таймер выполнения\n timeoutId = setTimeout(async () => {\n // Убираем слушатель, так как таймаут успешно дождался конца\n signal.removeEventListener('abort', onAbort);\n rejectPrevious = null;\n timeoutId = null;\n\n try {\n // 4. Запускаем оригинальный fetcher\n const data = await fetcher(source, signal);\n resolve(data);\n } catch (error) {\n reject(error);\n }\n }, delay);\n });\n };\n};\n","interface LongPollingOptions {\n /** Коллбэк для инкремента реактивного тика (перехода на следующую итерацию поллинга) */\n onNextTick: () => void;\n\n /**\n * Коллбэк, вызываемый при возникновении сетевой ошибки.\n * Позволяет внешней системе узнать о сбое и текущем времени ожидания до следующей попытки.\n *\n * @param {number} delayMs - Текущая задержка Exponential Backoff в миллисекундах перед следующим запросом.\n * @param {() => void} onRetryScheduled - Коллбэк-триггер. Должен быть вызван один раз, чтобы\n * просигнализировать декоратору, что шаг зафиксирован и задержка для следующей ошибки может быть увеличена.\n */\n onError: (delayMs: number, onRetryScheduled: () => void) => void;\n\n /** Пауза перед открытием следующего соединения в миллисекундах. По умолчанию 500 мс */\n delay?: number;\n /** Стартовая задержка Exponential Backoff в миллисекундах. По умолчанию 2000 мс */\n errorInitialDelay?: number;\n /** Потолок задержки Exponential Backoff в миллисекундах. По умолчанию 8000 мс */\n errorMaxDelay?: number;\n /** Внешний сигнал для жесткой остановки рекурсивных таймаутов */\n externalSignal?: AbortSignal;\n}\n\n/**\n * Адаптированный декоратор лонг-поллинга для engine.resource.\n * Принимает строго два аргумента: асинхронную функцию и конфиг-объект.\n */\nexport const withLongPolling = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: LongPollingOptions\n) => {\n const {\n onNextTick,\n onError,\n externalSignal,\n delay = 500,\n errorInitialDelay = 2000,\n errorMaxDelay = 8000\n } = options;\n\n let currentErrorDelay = errorInitialDelay;\n let currentSessionToken = 0;\n\n return (source: S, signal: AbortSignal): Promise<T> => {\n const activeSessionId = ++currentSessionToken;\n\n return new Promise<T>((resolve, reject) => {\n\n const poll = async () => {\n if (signal.aborted || externalSignal?.aborted) {\n reject(new DOMException('Aborted by long polling lifecycle', 'AbortError'));\n return;\n }\n\n try {\n const data = await fetcher(source, signal);\n currentErrorDelay = errorInitialDelay;\n\n if (signal.aborted || externalSignal?.aborted) {\n reject(new DOMException('Aborted by long polling lifecycle', 'AbortError'));\n return;\n }\n\n resolve(data);\n\n setTimeout(() => {\n if (activeSessionId === currentSessionToken && !signal.aborted && !externalSignal?.aborted) {\n onNextTick();\n }\n }, delay);\n\n } catch (error) {\n if (error instanceof DOMException && error.name === 'AbortError') {\n reject(error);\n return;\n }\n\n reject(error);\n const delayDuration = currentErrorDelay;\n\n onError(delayDuration, () => {\n if (activeSessionId === currentSessionToken) {\n currentErrorDelay = Math.min(currentErrorDelay * 2, errorMaxDelay);\n }\n });\n\n setTimeout(() => {\n if (activeSessionId === currentSessionToken && !signal.aborted && !externalSignal?.aborted) {\n onNextTick();\n }\n }, delayDuration);\n }\n };\n\n const forceKillTimer = () => {\n reject(new DOMException('Aborted by lifecycle event', 'AbortError'));\n };\n\n signal.addEventListener('abort', forceKillTimer);\n if (externalSignal) {\n externalSignal.addEventListener('abort', forceKillTimer);\n }\n\n if (signal.aborted || externalSignal?.aborted) {\n return forceKillTimer();\n }\n\n poll();\n });\n };\n};\n","interface ThrottleOptions {\n /** Интервал троттлинга в миллисекундах. По умолчанию 300 мс */\n limit?: number;\n}\n\n/**\n * Декоратор для создания троттлящего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки троттлинга\n */\nexport const withThrottle = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: ThrottleOptions = {}\n) => {\n const limit = options.limit ?? 300;\n\n let lastExecutionTime = 0;\n let throttleTimeoutId: ReturnType<typeof setTimeout> | null = null;\n\n // Храним параметры последнего \"заблокированного\" вызова, чтобы выполнить его на хвосте\n let lastSavedSource: S | null = null;\n let lastSavedResolve: ((value: T | PromiseLike<T>) => void) | null = null;\n let lastSavedReject: ((reason: any) => void) | null = null;\n let lastSavedSignal: AbortSignal | null = null;\n\n return (source: S, signal: AbortSignal): Promise<T> => {\n const now = Date.now();\n const remainingTime = limit - (now - lastExecutionTime);\n\n // Слушатель для мгновенной отмены ожидания, если ресурс размонтировался во время блокировки\n const onAbort = () => {\n if (throttleTimeoutId) {\n clearTimeout(throttleTimeoutId);\n throttleTimeoutId = null;\n }\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted by resource signal during throttle', 'AbortError'));\n lastSavedResolve = null;\n lastSavedReject = null;\n }\n };\n\n // СЦЕНАРИЙ 1: Интервал блокировки истек — выполняем запрос мгновенно (Leading edge)\n if (remainingTime <= 0) {\n // Если висел отложенный хвостовой вызов, отменяем его, так как пришел более свежий прямой запрос\n if (throttleTimeoutId) {\n clearTimeout(throttleTimeoutId);\n throttleTimeoutId = null;\n }\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted due to newer direct throttle execution', 'AbortError'));\n lastSavedResolve = null;\n lastSavedReject = null;\n }\n\n lastExecutionTime = now;\n return fetcher(source, signal);\n }\n\n // СЦЕНАРИЙ 2: Мы находимся внутри интервала блокировки.\n // Запоминаем текущие параметры как самые актуальные для выполнения на хвосте (Trailing edge).\n if (lastSavedReject) {\n // Отклоняем предыдущий сохраненный хвостовой промис, так как данные уже устарели\n lastSavedReject(new DOMException('Aborted due to newer throttled value', 'AbortError'));\n }\n\n return new Promise<T>((resolve, reject) => {\n lastSavedSource = source;\n lastSavedResolve = resolve;\n lastSavedReject = reject;\n lastSavedSignal = signal;\n\n if (signal.aborted) {\n return onAbort();\n }\n signal.addEventListener('abort', onAbort);\n\n // Если таймер хвостового вызова еще не запущен, взводим его на остаток времени блокировки\n if (!throttleTimeoutId) {\n throttleTimeoutId = setTimeout(async () => {\n throttleTimeoutId = null;\n\n const savedSource = lastSavedSource!;\n const savedResolve = lastSavedResolve!;\n const savedReject = lastSavedReject!;\n const savedSignal = lastSavedSignal!;\n\n // Очищаем ссылки перед асинхронным вызовом\n lastSavedSource = null;\n lastSavedResolve = null;\n lastSavedReject = null;\n lastSavedSignal = null;\n savedSignal.removeEventListener('abort', onAbort);\n\n try {\n lastExecutionTime = Date.now();\n const data = await fetcher(savedSource, savedSignal);\n savedResolve(data);\n } catch (error) {\n savedReject(error);\n }\n }, remainingTime);\n }\n });\n };\n};\n","interface ThrottleAndCacheOptions {\n /** Интервал троттлинга в миллисекундах. По умолчанию 300 мс */\n limit?: number;\n /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n ttl?: number;\n}\n\ninterface CacheEntry<T> {\n data: T;\n timestamp: number;\n}\n\n/**\n * Комбинированный декоратор: сначала применяет троттлинг к частоте вызовов,\n * а затем проверяет кэш перед отправкой реального fetcher-запроса.\n */\nexport const withThrottleAndCache = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: ThrottleAndCacheOptions = {}\n) => {\n const limit = options.limit ?? 300;\n const ttl = options.ttl ?? 5 * 60 * 1000;\n\n // Инфраструктура троттлинга\n let lastExecutionTime = 0;\n let throttleTimeoutId: ReturnType<typeof setTimeout> | null = null;\n let lastSavedSource: S | null = null;\n let lastSavedResolve: ((value: T | PromiseLike<T>) => void) | null = null;\n let lastSavedReject: ((reason: any) => void) | null = null;\n let lastSavedSignal: AbortSignal | null = null;\n\n // Инфраструктура кэширования\n const cache = new Map<string, CacheEntry<T>>();\n\n // Внутренний хелпер для генерации ключа кэша\n const getCacheKey = (source: S): string => {\n return typeof source === 'object' && source !== null\n ? JSON.stringify(source)\n : String(source);\n };\n\n return (source: S, signal: AbortSignal): Promise<T> => {\n const now = Date.now();\n const remainingTime = limit - (now - lastExecutionTime);\n const cacheKey = getCacheKey(source);\n\n const onAbort = () => {\n if (throttleTimeoutId) {\n clearTimeout(throttleTimeoutId);\n throttleTimeoutId = null;\n }\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted by resource signal during throttle', 'AbortError'));\n lastSavedResolve = null;\n lastSavedReject = null;\n }\n };\n\n // --- ФУНКЦИЯ ВЫПОЛНЕНИЯ ЗАПРОСА С УЧЕТОМ КЭША ---\n const executeWithCache = async (src: S, sig: AbortSignal): Promise<T> => {\n const currentNow = Date.now();\n const currentKey = getCacheKey(src);\n const cached = cache.get(currentKey);\n\n // Проверяем оперативную память на валидность кэша\n if (cached && currentNow - cached.timestamp < ttl) {\n return cached.data;\n }\n\n // Если кэша нет — делаем реальный запрос\n const freshData = await fetcher(src, sig);\n\n // Сохраняем в кэш\n cache.set(currentKey, {\n data: freshData,\n timestamp: Date.now(),\n });\n\n return freshData;\n };\n\n // --- ВЕТКА 1: Leading edge (Окно блокировки закрыто, выполняем сразу) ---\n if (remainingTime <= 0) {\n if (throttleTimeoutId) {\n clearTimeout(throttleTimeoutId);\n throttleTimeoutId = null;\n }\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted due to newer direct execution', 'AbortError'));\n lastSavedResolve = null;\n lastSavedReject = null;\n }\n\n lastExecutionTime = now;\n return executeWithCache(source, signal);\n }\n\n // --- ВЕТКА 2: Trailing edge (Внутри окна блокировки, перезаписываем хвост) ---\n if (lastSavedReject) {\n lastSavedReject(new DOMException('Aborted due to newer throttled value', 'AbortError'));\n }\n\n return new Promise<T>((resolve, reject) => {\n lastSavedSource = source;\n lastSavedResolve = resolve;\n lastSavedReject = reject;\n lastSavedSignal = signal;\n\n if (signal.aborted) {\n return onAbort();\n }\n signal.addEventListener('abort', onAbort);\n\n if (!throttleTimeoutId) {\n throttleTimeoutId = setTimeout(async () => {\n throttleTimeoutId = null;\n\n const savedSource = lastSavedSource!;\n const savedResolve = lastSavedResolve!;\n const savedReject = lastSavedReject!;\n const savedSignal = lastSavedSignal!;\n\n lastSavedSource = null;\n lastSavedResolve = null;\n lastSavedReject = null;\n lastSavedSignal = null;\n savedSignal.removeEventListener('abort', onAbort);\n\n try {\n lastExecutionTime = Date.now();\n const data = await executeWithCache(savedSource, savedSignal);\n savedResolve(data);\n } catch (error) {\n savedReject(error);\n }\n }, remainingTime);\n }\n });\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/index.d.ts
CHANGED
|
@@ -304,8 +304,8 @@ export declare class ReactiveEngine {
|
|
|
304
304
|
* Explained 👉 {@link https://github.com/garage-13/reactive-engine/blob/main/README_EN.md#1-async-resources-dependent-on-multiple-signals}
|
|
305
305
|
*
|
|
306
306
|
* @template T, S
|
|
307
|
-
* @see {@link https://github.com/garage-13/reactive-engine/blob/main/
|
|
308
|
-
* @see {@link https://github.com/garage-13/reactive-engine/blob/main/
|
|
307
|
+
* @see {@link https://github.com/garage-13/reactive-engine/blob/main/examples/200-resource/Example200.tsx Реализация базового компонента Example200}
|
|
308
|
+
* @see {@link https://github.com/garage-13/reactive-engine/blob/main/examples/201-multi-resource/service.secondary.ts Сложный пример зависимости ресурсов через computed}
|
|
309
309
|
* @function resource
|
|
310
310
|
* @param {Function} fetcher - Асинхронная функция для загрузки данных.
|
|
311
311
|
* @param {{ value: S }} [source] - Источник данных.
|