@pravosleva/reactive-engine 0.3.0-beta → 0.3.1-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 +40 -0
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +7 -4
- package/dist/index.iife.js +1 -1
- package/dist/index.iife.js.map +1 -1
- package/dist/index.mjs +8 -7
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,3 +4,43 @@ A lightweight, type-safe reactive engine built with TypeScript, featuring Depend
|
|
|
4
4
|
## Instruction
|
|
5
5
|
- 🇬🇧 [In English](https://github.com/garage-13/reactive-engine/blob/main/README_EN.md)
|
|
6
6
|
- 🇷🇺 [In Russian](https://github.com/garage-13/reactive-engine/blob/main/README_RU.md)
|
|
7
|
+
|
|
8
|
+
## 📦 Installation
|
|
9
|
+
|
|
10
|
+
Install the package via your favorite package manager:
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
npm install @pravosleva/reactive-engine
|
|
14
|
+
# or
|
|
15
|
+
yarn add @pravosleva/reactive-engine
|
|
16
|
+
# or
|
|
17
|
+
pnpm add @pravosleva/reactive-engine
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## 🎯 What Problems This Library Solves
|
|
21
|
+
|
|
22
|
+
When building large-scale React applications, developers constantly run into architectural bottlenecks imposed by built-in state tools. `@pravosleva/reactive-engine` is designed to elegantly solve the following pain points:
|
|
23
|
+
|
|
24
|
+
1. **Unnecessary Over-Rendering:**
|
|
25
|
+
* *The Problem:* React Context API and traditional immutability-based stores (Redux/Zustand) force all components reading from that state slice to re-render whenever even a single deeply nested property changes.
|
|
26
|
+
* *The Solution:* Fine-grained reactivity. Components micro-subscribe only to the specific primitive signals they display. State mutations update strictly the necessary DOM nodes.
|
|
27
|
+
|
|
28
|
+
2. **UI Tearing and Lags in React 18+:**
|
|
29
|
+
* *The Problem:* Under React Concurrent Mode, standard external state managers can lead to UI tearing, where different parts of the screen temporarily display asynchronous, mismatching data.
|
|
30
|
+
* *The Solution:* The `useReactiveValue` hook is built on top of native `useSyncExternalStore`. This ensures absolute cross-component synchronization, shielding your interface from glitches and tearing.
|
|
31
|
+
|
|
32
|
+
3. **Expensive CPU Re-calculations:**
|
|
33
|
+
* *The Problem:* Heavy array filtration, sorting, or data analytics functions trigger re-evaluations on every parent re-render or whenever unrelated props shift.
|
|
34
|
+
* *The Solution:* Lazy `Computed` properties with O(1) computation caching. The logic evaluates *only* when its underlying dependency signals change.
|
|
35
|
+
|
|
36
|
+
4. **Network Request Flooding (Race Conditions):**
|
|
37
|
+
* *The Problem:* A user rapidly clicking through catalog filters or pagination options spawns cascades of overlapping network requests. An older, slower request might resolve *after* a newer one, overwriting fresh data (Race Condition).
|
|
38
|
+
* *The Solution:* The `Resource` utility automatically orchestrates native `AbortController` instances. Whenever dependency signals change, the previous pending fetch request is instantly cancelled at the browser's system level.
|
|
39
|
+
|
|
40
|
+
5. **Cascading UI Updates (Render Cascades):**
|
|
41
|
+
* *The Problem:* Updating 3–4 connected state parameters inside a single event handler prompts 3–4 sequential UI update ticks, clogging the Event Loop.
|
|
42
|
+
* *The Solution:* 100% out-of-the-box automatic batching. The engine bundles all consecutive synchronous and asynchronous modifications into a single microtask, triggering exactly 1 final unified re-render.
|
|
43
|
+
|
|
44
|
+
6. **Memory Leaks in Dynamic Architectures:**
|
|
45
|
+
* *The Problem:* Dynamically instantiating computed properties (e.g., dynamically filtering an active tab) accumulates abandoned reactive effects in memory that continue to listen to global state updates forever.
|
|
46
|
+
* *The Solution:* Built-in memory cleanup and computation memoization inside the core engine. The library hooks automatically trigger `.destroy()` on component unmount, seamlessly purging dead reactive effects from RAM.
|
package/dist/index.cjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("react");var t=class{engine;constructor(e){this.engine=e}createNumericSignal(e,t){return this.engine.signal(e,{name:t,validate:e=>typeof e==`number`&&!isNaN(e)})}},n=class{engine;constructor(e){this.engine=e,setTimeout(()=>this.onInit(),0)}onInit(){}},r=class{activeEffect=null;isBatching=!1;pendingEffects=new Set;services=new Map;factories=new Map;proxyCache=new WeakMap;allEffects=new Set;onSignalChange;reactAdapters={useState:e.useState,useEffect:e.useEffect};provide(e,t){typeof t==`function`&&!t.prototype?this.factories.set(e,t):this.services.set(e,t)}inject(e){if(!e)throw Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`);if(this.services.has(
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("react");var t=class{engine;constructor(e){this.engine=e}createNumericSignal(e,t){return this.engine.signal(e,{name:t,validate:e=>typeof e==`number`&&!isNaN(e)})}},n=class{engine;constructor(e){this.engine=e,setTimeout(()=>this.onInit(),0)}onInit(){}},r=class{activeEffect=null;isBatching=!1;pendingEffects=new Set;services=new Map;factories=new Map;proxyCache=new WeakMap;allEffects=new Set;onSignalChange;reactAdapters={useState:e.useState,useEffect:e.useEffect};provide(e,t){typeof t==`function`&&!t.prototype?this.factories.set(e,t):this.services.set(e,t)}inject(e){if(!e)throw Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`);let t=e;if(this.services.has(t))return this.services.get(t);try{let n=this.factories.get(t);if(n){let e=n(this);return this.services.set(t,e),e}if(typeof e==`function`&&e.prototype){let n=new e(this);return this.services.set(t,n),n}throw Error(`Service not found: ${String(e)}`)}catch(t){throw Error(`[DI Error]: Не удалось создать сервис ${String(e)}. Ошибка: ${t?.message||`No e?.message`}`)}}signal(e,t){let n=this,r=e,i=new Set,a=typeof t==`string`?{name:t}:t||{},o=a.name||`unnamed_signal`;return{get value(){return n.activeEffect&&i.add(n.activeEffect),r},set value(e){if(r===e)return;if(a.validate){let t=a.validate(e);if(t===!1||typeof t==`string`){let n=typeof t==`string`?t:`[Validation Error]: Некорректное значение для сигнала "${o}"`;console.error(`%c${n}`,`color: orange; font-weight: bold;`,{received:e,current:r});return}}let t=r;r=e,n.onSignalChange?.(o,e,t),i.forEach(e=>n.pendingEffects.add(e)),n.isBatching||(n.isBatching=!0,queueMicrotask(()=>{let e=Array.from(n.pendingEffects);n.pendingEffects.clear(),n.isBatching=!1,e.forEach(e=>e.run())}))},subscribe(e){return n.effect(()=>{e(this.value)})}}}effect(e){let t=this,n={cleanups:new Set,run(){this.cleanups.forEach(e=>e()),this.cleanups.clear();let n=t.activeEffect;t.activeEffect=this,t.safeRun(this,()=>{let t=e();typeof t==`function`&&this.cleanups.add(t)}),t.activeEffect=n}};return this.allEffects.add(n),n.run(),()=>{n.cleanups.forEach(e=>e()),t.pendingEffects.delete(n),t.allEffects.delete(n)}}computedCache=new Map;computed(e,t){if(this.computedCache.has(e))return this.computedCache.get(e);let n=this,r=this.signal(void 0,t||`unnamed_computed`),i=this.effect(()=>{let t=e();r.value=t}),a=Array.from(this.allEffects)[this.allEffects.size-1],o={get value(){return r.value},subscribe:e=>r.subscribe(e),destroy(){i(),a&&n.allEffects.delete(a),n.computedCache.delete(e)}};return this.computedCache.set(e,o),o}reactive(e,t=`reactive`){if(this.proxyCache.has(e))return this.proxyCache.get(e);let n=this,r=new Map,i=new Proxy(e,{get(e,i,a){n.activeEffect&&(r.has(i)||r.set(i,new Set),r.get(i).add(n.activeEffect));let o=Reflect.get(e,i,a);return typeof o==`object`&&o?n.reactive(o,`${t}.${String(i)}`):o},set(e,i,a,o){let s=Reflect.get(e,i,o);return s===a||s!==a&&(Reflect.set(e,i,a,o),n.onSignalChange?.(`${t}.${String(i)}`,a,s),r.get(i)?.forEach(e=>n.isBatching?n.pendingEffects.add(e):e.run())),!0}});return this.proxyCache.set(e,i),i}batch(e){e()}resource(e,t,n){let r=this.signal({data:null,loading:!0,error:null},n||`unnamed_resource`),i=null,a=async t=>{i?.abort(),i=new AbortController;let n=this.untrack(()=>r.value.data);r.value={data:n,loading:!0,error:null};try{let n=await e(t,i.signal);i.signal.aborted||(r.value={data:n,loading:!1,error:null})}catch(e){e.name!==`AbortError`&&(r.value={data:null,loading:!1,error:e})}};return this.effect(()=>{let e=t?t.value:void 0;return a(e),()=>i?.abort()}),{get data(){return r.value.data},get loading(){return r.value.loading},get error(){return r.value.error},get value(){return r.value},refetch:()=>a(t?t.value:void 0),subscribe:e=>r.subscribe(e)}}untrack(e){let t=this.activeEffect;this.activeEffect=null;try{return e()}finally{this.activeEffect=t}}setReactAdapters(e,t){this.reactAdapters={useState:e,useEffect:t}}use(e){if(!this.reactAdapters)throw Error(`[React Error]: Адаптеры React не установлены. Вызовите engine.setReactAdapters(useState, useEffect).`);if(!e||typeof e.subscribe!=`function`){let t=`
|
|
2
2
|
[Reactive Error]: engine.use() получил некорректный объект!
|
|
3
3
|
Скорее всего, вы пытаетесь подписаться на свойство сервиса, которое не было инициализировано.
|
|
4
4
|
Проверьте, что в классе написано: public mySignal = this.engine.signal(...)
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.cjs","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/core.ts","../src/decorators/withCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\n// export abstract class BaseService {\n// constructor(protected engine: ReactiveEngine) {\n// // Вызываем метод инициализации, который можно переопределить в наследниках\n// this.onInit();\n// }\n\n// // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n// // Удобно для инициализации сигналов, которые зависят от engine.\n// protected onInit(): void {}\n\n// // NOTE: Полезные хелперы для сокращения кода\n// protected createSignal<T>(val: T, name?: string) {\n// return this.engine.signal(val, name);\n// }\n\n// protected createComputed<T>(fn: () => T) {\n// return this.engine.computed(fn);\n// }\n// }\n\nexport abstract class BaseREService {\n constructor(protected engine: ReactiveEngine) { } // Просто сохраняем engine\n\n protected createNumericSignal(val: number, name: string) {\n return this.engine.signal(val, {\n name,\n validate: (v) => typeof v === 'number' && !isNaN(v)\n });\n }\n}\n","import { ReactiveEngine } from './core';\n\nexport abstract class BaseREServiceEnhanced {\n constructor(protected engine: ReactiveEngine) {\n setTimeout(() => this.onInit(), 0)\n }\n\n protected onInit(): void { }\n}\n","import { useState, useEffect } from 'react';\n\n// --- ТИПЫ ---\nexport type CleanupFn = () => void;\nexport type EffectFn = () => CleanupFn | void;\nexport type Token<T> = string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T };\nexport type Factory<T> = (engine: ReactiveEngine) => T;\n\nexport interface IEffect {\n run: () => void;\n cleanups: Set<CleanupFn>;\n}\n\nexport interface ResourceState<T> {\n data: T | null;\n loading: boolean;\n error: any | null;\n}\n\n/**\n * Функция для очистки эффекта.\n * @typedef {() => void} CleanupFn\n */\n\n/**\n * Функция эффекта, которая может возвращать функцию очистки.\n * @typedef {() => CleanupFn | void} EffectFn\n */\n\n/**\n * Токен для зависимости.\n * @typedef {string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T }} Token<T>\n */\n\n/**\n * Фабрика для создания сервиса.\n * @template T\n * @typedef {(engine: ReactiveEngine) => T} Factory<T>\n */\n\n/**\n * Интерфейс для эффекта.\n * @interface IEffect\n */\nexport interface IEffect {\n /**\n * Запуск эффекта.\n * @function run\n * @returns {void}\n */\n run: () => void;\n\n /**\n * Коллекция функций очистки.\n * @type {Set<CleanupFn>}\n */\n cleanups: Set<CleanupFn>;\n}\n\n/**\n * Интерфейс для состояния ресурса.\n * @template T Data format\n * @interface ResourceState<T>\n */\nexport interface ResourceState<T> {\n /**\n * Данные ресурса.\n * @type {T | null}\n */\n data: T | null;\n\n /**\n * Состояние загрузки ресурса.\n * @type {boolean}\n */\n loading: boolean;\n\n /**\n * Ошибка ресурса.\n * @type {any | null}\n */\n error: any | null;\n}\n\n/**\n * Интерфейс для сигнала.\n * @template T\n * @interface Signal<T>\n */\nexport interface Signal<T> {\n /**\n * Значение сигнала.\n * @type {T}\n */\n value: T;\n\n /**\n * Подписка на изменение значения сигнала.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n}\n\n/**\n * Интерфейс для вычисляемого значения.\n * @template T\n * @interface Computed<T>\n */\nexport interface Computed<T> {\n /**\n * Только читаемое значение вычисляемого значения.\n * @type {T}\n */\n readonly value: T;\n\n /**\n * Подписка на изменение вычисляемого значения.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n\n /**\n * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.\n */\n destroy: () => void;\n}\n\n\n/**\n * Интерфейс для ресурса.\n * @template T\n * @interface Resource<T>\n */\nexport interface Resource<T> extends ResourceState<T> {\n /**\n * Перезагрузка ресурса.\n * @function refetch\n * @returns {void}\n */\n refetch: () => void;\n\n /**\n * Подписка на изменение состояния ресурса.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;\n\n /**\n * Только читаемое состояние ресурса.\n * @type {ResourceState<T>}\n */\n readonly value: ResourceState<T>;\n}\n\n/**\n * Интерфейс для опций сигнала.\n * @template T\n * @interface SignalOptions<T>\n */\nexport interface SignalOptions<T> {\n /**\n * Имя сигнала.\n * @type {string}\n */\n name?: string;\n\n /**\n * Валидатор значения сигнала.\n * @function validate\n * @param {T} val - Значение для валидации.\n * @returns {boolean | string} - Результат валидации.\n */\n validate?: (val: T) => boolean | string;\n}\n\n// --- ЯДРО ---\n/**\n * Класс реактивного движка.\n */\nexport class ReactiveEngine {\n private activeEffect: IEffect | null = null;\n private isBatching = false;\n private pendingEffects = new Set<IEffect>();\n private services = new Map<Token<any>, any>();\n private factories = new Map<Token<any>, Factory<any>>();\n private proxyCache = new WeakMap<object, any>();\n private allEffects = new Set<IEffect>();\n\n /**\n * Коллбек для уведомления о изменении сигнала.\n * @type {Function}\n */\n public onSignalChange?: (name: string, next: any, prev: any) => void;\n\n private reactAdapters = {\n useState: useState as any,\n useEffect: useEffect as any,\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 */\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 */\n public inject<T>(token: Token<T>): T {\n if (!token) {\n throw new Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`);\n }\n\n if (this.services.has(token)) return this.services.get(token);\n\n // NOTE: (new way) Если это класс, но мы забыли его унаследовать от BaseService или передать engine\n try {\n // NOTE: Логика создания инстанса\n const factory = this.factories.get(token);\n if (factory) {\n const instance = factory(this);\n this.services.set(token, 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(token, 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 */\n public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n const engine = this;\n let val = initialValue;\n const subscribers = new Set<IEffect>();\n const options = typeof optionsOrName === 'string'\n ? { name: optionsOrName }\n : optionsOrName || {};\n const name = options.name || 'unnamed_signal';\n\n return {\n get value(): T {\n if (engine.activeEffect) subscribers.add(engine.activeEffect);\n return val;\n },\n set value(newValue: T) {\n if (val === newValue) return;\n\n // ВАЛИДАЦИЯ В RUNTIME\n if (options.validate) {\n const result = options.validate(newValue);\n if (result === false || typeof result === 'string') {\n const errorMsg = typeof result === 'string'\n ? result\n : `[Validation Error]: Некорректное значение для сигнала \"${name}\"`;\n\n console.error(`%c${errorMsg}`, \"color: orange; font-weight: bold;\", {\n received: newValue,\n current: val\n });\n return; // Прерываем обновление, если данные не валидны\n }\n }\n\n const old = val;\n val = newValue;\n engine.onSignalChange?.(name, newValue, old);\n\n // 1. Всегда добавляем подписчиков в очередь отложенных эффектов\n subscribers.forEach(e => engine.pendingEffects.add(e));\n\n // 2. Если очередь еще не запущена, планируем её автоматическое выполнение в микрозадачу\n if (!engine.isBatching) {\n engine.isBatching = true;\n\n queueMicrotask(() => {\n const effects = Array.from(engine.pendingEffects);\n engine.pendingEffects.clear();\n engine.isBatching = false;\n\n // Запускаем все накопившиеся эффекты и ререндеры за один раз\n effects.forEach(e => e.run());\n });\n }\n },\n subscribe(cb) {\n // Чистая и безопасная подписка для React:\n // Мы вызываем cb, но НЕ передаем туда аргументы, чтобы не ломать useSyncExternalStore\n return engine.effect(() => {\n cb(this.value);\n });\n }\n };\n }\n\n /**\n * Создание эффекта.\n * @function effect\n * @param {EffectFn} fn - Функция эффекта.\n * @returns {CleanupFn} - Функция для очистки эффекта.\n */\n public effect(fn: EffectFn): CleanupFn {\n const engine = this;\n const effectObj: IEffect = {\n cleanups: new Set(),\n run() {\n this.cleanups.forEach(c => c());\n this.cleanups.clear();\n const prev = engine.activeEffect;\n engine.activeEffect = this;\n engine.safeRun(this, () => {\n const cleanup = fn();\n if (typeof cleanup === 'function') this.cleanups.add(cleanup);\n });\n engine.activeEffect = prev;\n }\n };\n this.allEffects.add(effectObj);\n effectObj.run();\n\n return () => {\n effectObj.cleanups.forEach(c => c());\n engine.pendingEffects.delete(effectObj);\n engine.allEffects.delete(effectObj); // Всегда чистим за собой\n };\n }\n\n // Добавляем кэш для вычисляемых свойств\n private computedCache = new Map<Function, any>();\n\n /**\n * Создание вычисляемого значения.\n * @template T\n * @function computed\n * @param {Function} fn - Функция для вычисления значения.\n * @param {string} [signalName] - Имя сигнала.\n * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n */\n public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n // Если для этой функции вычисление уже создано — просто возвращаем его!\n if (this.computedCache.has(fn)) {\n return this.computedCache.get(fn);\n }\n\n const engine = this;\n const sig = this.signal<T>(undefined as any, signalName || 'unnamed_computed');\n\n const unsubscribeEffect = this.effect(() => {\n const newValue = fn();\n sig.value = newValue;\n });\n\n // Извлекаем ссылку на объект эффекта, который только что зарегистировался в конце Set\n const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1];\n\n // Создаем инстанс computed\n const computedInstance: Computed<T> = {\n get value() { return sig.value; },\n subscribe: (cb) => sig.subscribe(cb),\n destroy() {\n unsubscribeEffect();\n if (effectObj) {\n engine.allEffects.delete(effectObj);\n }\n // Не забываем удалить из кэша при принудительном уничтожении\n engine.computedCache.delete(fn);\n }\n };\n\n // Сохраняем в кэш перед возвратом\n this.computedCache.set(fn, computedInstance);\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 */\n public reactive<T extends object>(target: T, name: string = 'reactive'): T {\n if (this.proxyCache.has(target)) return this.proxyCache.get(target);\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 */\n public batch(fn: () => void): void {\n // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n // поэтому здесь мы можем просто выполнить функцию\n fn();\n }\n\n\n /**\n * Создание асинхронного ресурса.\n * @template T\n * @function resource\n * @param {Function} fetcher - Функция для загрузки данных.\n * @param {{ value: S }} [source] - Источник данных.\n * @param {string} [signalName] - Имя сигнала ресурса.\n * @returns {Resource<T>} - Асинхронный ресурс.\n */\n public resource<T, S = void>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n source?: { value: S },\n signalName?: string,\n ): Resource<T> {\n const state = this.signal<ResourceState<T>>({ data: null, loading: true, error: null }, signalName || 'unnamed_resource');\n let controller: AbortController | null = null;\n\n const load = async (sValue: S) => {\n controller?.abort();\n controller = new AbortController();\n\n // Читаем текущие данные без создания зависимости!\n const currentData = this.untrack(() => state.value.data);\n\n // Теперь обновление состояния не вызовет перезапуск эффекта\n state.value = { data: currentData, loading: true, error: null };\n\n try {\n const data = await fetcher(sValue, controller.signal);\n if (!controller.signal.aborted) {\n state.value = { data, loading: false, error: null };\n }\n } catch (e: any) {\n if (e.name !== 'AbortError') {\n state.value = { data: null, loading: false, error: e };\n }\n }\n };\n\n // Чтобы эффект не подписывался на state,\n // нам нужно изолировать чтение source от чтения state\n this.effect(() => {\n // Читаем ТОЛЬКО source. Это наша единственная зависимость.\n const sValue = source ? source.value : undefined as S;\n\n // Вызываем load. Внутри load чтение state.value\n // не должно регистрироваться как зависимость этого эффекта.\n load(sValue);\n\n return () => controller?.abort();\n });\n\n return {\n get data() { return state.value.data; },\n get loading() { return state.value.loading; },\n get error() { return state.value.error; },\n get value() { return state.value; },\n refetch: () => load(source ? source.value : undefined as S),\n subscribe: (cb) => state.subscribe(cb)\n };\n }\n\n /**\n * Выполняет функцию без отслеживания зависимостей.\n * @template T\n * @function untrack\n * @param {Function} fn - Функция для выполнения.\n * @returns {T} - Результат выполнения функции.\n */\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 */\n public setReactAdapters(useState: any, useEffect: any) {\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 */\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 */\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 { CleanupFn } from '../core'; // импорт типа отписки, если нужен\n\ninterface CacheEntry<T> {\n data: T;\n timestamp: number;\n}\n\ninterface CacheOptions {\n /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки кэширования\n */\nexport const withCache = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: CacheOptions = {}\n) => {\n const ttl = options.ttl ?? 5 * 60 * 1000; // Дефолтный TTL: 5 минут\n const cache = new Map<string, CacheEntry<T>>();\n\n return async (source: S, signal: AbortSignal): Promise<T> => {\n // 1. Генерируем уникальный ключ на основе зависимостей (массива или объекта)\n const cacheKey = typeof source === 'object' && source !== null\n ? JSON.stringify(source)\n : String(source);\n\n const now = Date.now();\n const cached = cache.get(cacheKey);\n\n // 2. Проверяем, есть ли валидный (не устаревший) кэш\n if (cached && (now - cached.timestamp < ttl)) {\n return cached.data;\n }\n\n // 3. Если кэша нет или он устарел — делаем реальный сетевой запрос\n const freshData = await fetcher(source, signal);\n\n // 4. Сохраняем свежие данные и метку времени в кэш\n cache.set(cacheKey, {\n data: freshData,\n timestamp: Date.now() // берем актуальное время после завершения запроса\n });\n\n return freshData;\n };\n};\n","import { useEffect, useRef } from 'react';\nimport { Signal, CleanupFn } from '../core';\n\n/**\n * Универсальный хук для подписки на изменения Signal, Computed или Resource.\n * @template T Тип данных внутри реактивного контейнера\n * @param {Signal<T> | { subscribe: (cb: (val: T) => void) => CleanupFn }} signal Объект подписки\n * @param {(val: T) => void} callback Функция обратного вызова, принимающая новое значение\n */\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 */\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 */\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":"0FAsBA,IAAsB,EAAtB,KAAoC,CACZ,OAAtB,YAAY,EAAkC,CAAxB,KAAA,OAAA,CAA0B,CAEhD,oBAA8B,EAAa,EAAc,CACvD,OAAO,KAAK,OAAO,OAAO,EAAK,CAC7B,OACA,SAAW,GAAM,OAAO,GAAM,UAAY,CAAC,MAAM,CAAC,CACpD,CAAC,CACH,CACF,EC7BsB,EAAtB,KAA4C,CACpB,OAAtB,YAAY,EAAkC,CAAxB,KAAA,OAAA,EACpB,eAAiB,KAAK,OAAO,EAAG,CAAC,CACnC,CAEA,QAAyB,CAAE,CAC7B,ECiLa,EAAb,KAA4B,CAC1B,aAAuC,KACvC,WAAqB,GACrB,eAAyB,IAAI,IAC7B,SAAmB,IAAI,IACvB,UAAoB,IAAI,IACxB,WAAqB,IAAI,QACzB,WAAqB,IAAI,IAMzB,eAEA,cAAwB,CACZ,SAAA,EAAA,SACC,UAAA,EAAA,SACb,EAUA,QAAkB,EAAiB,EAAsC,CACnE,OAAO,GAAmB,YAAc,CAAC,EAAe,UAC1D,KAAK,UAAU,IAAI,EAAO,CAA4B,EAEtD,KAAK,SAAS,IAAI,EAAO,CAAc,CAE3C,CASA,OAAiB,EAAoB,CACnC,GAAI,CAAC,EACH,MAAU,MAAM,qFAAqF,EAGvG,GAAI,KAAK,SAAS,IAAI,CAAK,EAAG,OAAO,KAAK,SAAS,IAAI,CAAK,EAG5D,GAAI,CAEF,IAAM,EAAU,KAAK,UAAU,IAAI,CAAK,EACxC,GAAI,EAAS,CACX,IAAM,EAAW,EAAQ,IAAI,EAE7B,OADA,KAAK,SAAS,IAAI,EAAO,CAAQ,EAC1B,CACT,CACA,GAAI,OAAO,GAAU,YAAc,EAAM,UAAW,CAClD,IAAM,EAAW,IAAK,EAA0C,IAAI,EAEpE,OADA,KAAK,SAAS,IAAI,EAAO,CAAQ,EAC1B,CACT,CACA,MAAU,MAAM,sBAAsB,OAAO,CAAK,GAAG,CACvD,OAAS,EAAG,CACV,MAAU,MAAM,yCAAyC,OAAO,CAAK,EAAE,YAAa,GAAa,SAAW,iBAAiB,CAC/H,CACF,CAUA,OAAiB,EAAiB,EAAsD,CACtF,IAAM,EAAS,KACX,EAAM,EACJ,EAAc,IAAI,IAClB,EAAU,OAAO,GAAkB,SACrC,CAAE,KAAM,CAAc,EACtB,GAAiB,CAAC,EAChB,EAAO,EAAQ,MAAQ,iBAE7B,MAAO,CACL,IAAI,OAAW,CAEb,OADI,EAAO,cAAc,EAAY,IAAI,EAAO,YAAY,EACrD,CACT,EACA,IAAI,MAAM,EAAa,CACrB,GAAI,IAAQ,EAAU,OAGtB,GAAI,EAAQ,SAAU,CACpB,IAAM,EAAS,EAAQ,SAAS,CAAQ,EACxC,GAAI,IAAW,IAAS,OAAO,GAAW,SAAU,CAClD,IAAM,EAAW,OAAO,GAAW,SAC/B,EACA,0DAA0D,EAAK,GAEnE,QAAQ,MAAM,KAAK,IAAY,oCAAqC,CAClE,SAAU,EACV,QAAS,CACX,CAAC,EACD,MACF,CACF,CAEA,IAAM,EAAM,EACZ,EAAM,EACN,EAAO,iBAAiB,EAAM,EAAU,CAAG,EAG3C,EAAY,QAAQ,GAAK,EAAO,eAAe,IAAI,CAAC,CAAC,EAGhD,EAAO,aACV,EAAO,WAAa,GAEpB,mBAAqB,CACnB,IAAM,EAAU,MAAM,KAAK,EAAO,cAAc,EAChD,EAAO,eAAe,MAAM,EAC5B,EAAO,WAAa,GAGpB,EAAQ,QAAQ,GAAK,EAAE,IAAI,CAAC,CAC9B,CAAC,EAEL,EACA,UAAU,EAAI,CAGZ,OAAO,EAAO,WAAa,CACzB,EAAG,KAAK,KAAK,CACf,CAAC,CACH,CACF,CACF,CAQA,OAAc,EAAyB,CACrC,IAAM,EAAS,KACT,EAAqB,CACzB,SAAU,IAAI,IACd,KAAM,CACJ,KAAK,SAAS,QAAQ,GAAK,EAAE,CAAC,EAC9B,KAAK,SAAS,MAAM,EACpB,IAAM,EAAO,EAAO,aACpB,EAAO,aAAe,KACtB,EAAO,QAAQ,SAAY,CACzB,IAAM,EAAU,EAAG,EACf,OAAO,GAAY,YAAY,KAAK,SAAS,IAAI,CAAO,CAC9D,CAAC,EACD,EAAO,aAAe,CACxB,CACF,EAIA,OAHA,KAAK,WAAW,IAAI,CAAS,EAC7B,EAAU,IAAI,MAED,CACX,EAAU,SAAS,QAAQ,GAAK,EAAE,CAAC,EACnC,EAAO,eAAe,OAAO,CAAS,EACtC,EAAO,WAAW,OAAO,CAAS,CACpC,CACF,CAGA,cAAwB,IAAI,IAU5B,SAAmB,EAAa,EAAkC,CAEhE,GAAI,KAAK,cAAc,IAAI,CAAE,EAC3B,OAAO,KAAK,cAAc,IAAI,CAAE,EAGlC,IAAM,EAAS,KACT,EAAM,KAAK,OAAU,IAAA,GAAkB,GAAc,kBAAkB,EAEvE,EAAoB,KAAK,WAAa,CAC1C,IAAM,EAAW,EAAG,EACpB,EAAI,MAAQ,CACd,CAAC,EAGK,EAAY,MAAM,KAAK,KAAK,UAAU,CAAC,CAAC,KAAK,WAAW,KAAO,GAG/D,EAAgC,CACpC,IAAI,OAAQ,CAAE,OAAO,EAAI,KAAO,EAChC,UAAY,GAAO,EAAI,UAAU,CAAE,EACnC,SAAU,CACR,EAAkB,EACd,GACF,EAAO,WAAW,OAAO,CAAS,EAGpC,EAAO,cAAc,OAAO,CAAE,CAChC,CACF,EAKA,OAFA,KAAK,cAAc,IAAI,EAAI,CAAgB,EAEpC,CACT,CAUA,SAAkC,EAAW,EAAe,WAAe,CACzE,GAAI,KAAK,WAAW,IAAI,CAAM,EAAG,OAAO,KAAK,WAAW,IAAI,CAAM,EAClE,IAAM,EAAS,KACT,EAAmB,IAAI,IAEvB,EAAQ,IAAI,MAAM,EAAQ,CAC9B,IAAI,EAAK,EAAM,EAAU,CACnB,EAAO,eACJ,EAAiB,IAAI,CAAI,GAAG,EAAiB,IAAI,EAAM,IAAI,GAAK,EACrE,EAAiB,IAAI,CAAI,CAAC,CAAE,IAAI,EAAO,YAAY,GAErD,IAAM,EAAQ,QAAQ,IAAI,EAAK,EAAM,CAAQ,EAC7C,OAA0B,OAAO,GAAU,UAAnC,EACJ,EAAO,SAAS,EAAO,GAAG,EAAK,GAAG,OAAO,CAAI,GAAG,EAChD,CACN,EACA,IAAI,EAAK,EAAM,EAAO,EAAU,CAC9B,IAAM,EAAM,QAAQ,IAAI,EAAK,EAAM,CAAQ,EAW3C,OATI,IAAQ,GAER,IAAQ,IACV,QAAQ,IAAI,EAAK,EAAM,EAAO,CAAQ,EACtC,EAAO,iBAAiB,GAAG,EAAK,GAAG,OAAO,CAAI,IAAK,EAAO,CAAG,EAC7D,EAAiB,IAAI,CAAI,CAAC,EAAE,QAAQ,GAClC,EAAO,WAAa,EAAO,eAAe,IAAI,CAAC,EAAI,EAAE,IAAI,CAC3D,GAPwB,EAU5B,CACF,CAAC,EAED,OADA,KAAK,WAAW,IAAI,EAAQ,CAAK,EAC1B,CACT,CAQA,MAAa,EAAsB,CAGjC,EAAG,CACL,CAYA,SACE,EACA,EACA,EACa,CACb,IAAM,EAAQ,KAAK,OAAyB,CAAE,KAAM,KAAM,QAAS,GAAM,MAAO,IAAK,EAAG,GAAc,kBAAkB,EACpH,EAAqC,KAEnC,EAAO,KAAO,IAAc,CAChC,GAAY,MAAM,EAClB,EAAa,IAAI,gBAGjB,IAAM,EAAc,KAAK,YAAc,EAAM,MAAM,IAAI,EAGvD,EAAM,MAAQ,CAAE,KAAM,EAAa,QAAS,GAAM,MAAO,IAAK,EAE9D,GAAI,CACF,IAAM,EAAO,MAAM,EAAQ,EAAQ,EAAW,MAAM,EAC/C,EAAW,OAAO,UACrB,EAAM,MAAQ,CAAE,OAAM,QAAS,GAAO,MAAO,IAAK,EAEtD,OAAS,EAAQ,CACX,EAAE,OAAS,eACb,EAAM,MAAQ,CAAE,KAAM,KAAM,QAAS,GAAO,MAAO,CAAE,EAEzD,CACF,EAeA,OAXA,KAAK,WAAa,CAEhB,IAAM,EAAS,EAAS,EAAO,MAAQ,IAAA,GAMvC,OAFA,EAAK,CAAM,MAEE,GAAY,MAAM,CACjC,CAAC,EAEM,CACL,IAAI,MAAO,CAAE,OAAO,EAAM,MAAM,IAAM,EACtC,IAAI,SAAU,CAAE,OAAO,EAAM,MAAM,OAAS,EAC5C,IAAI,OAAQ,CAAE,OAAO,EAAM,MAAM,KAAO,EACxC,IAAI,OAAQ,CAAE,OAAO,EAAM,KAAO,EAClC,YAAe,EAAK,EAAS,EAAO,MAAQ,IAAA,EAAc,EAC1D,UAAY,GAAO,EAAM,UAAU,CAAE,CACvC,CACF,CASA,QAAkB,EAAgB,CAChC,IAAM,EAAO,KAAK,aAClB,KAAK,aAAe,KACpB,GAAI,CACF,OAAO,EAAG,CACZ,QAAU,CACR,KAAK,aAAe,CACtB,CACF,CASA,iBAAwB,EAAe,EAAgB,CACrD,KAAK,cAAgB,CAAE,WAAU,WAAU,CAC7C,CASA,IAAc,EAAqE,CACjF,GAAI,CAAC,KAAK,cACR,MAAU,MAAM,sGAAsG,EAIxH,GAAI,CAAC,GAAQ,OAAO,EAAK,WAAc,WAAY,CACjD,IAAM,EAAW;;;;QAMjB,MADA,QAAQ,MAAM,EAAU,CAAE,MAAK,CAAC,EACtB,MAAM,CAAQ,CAC1B,CACA,GAAM,CAAC,EAAK,GAAU,KAAK,cAAc,SAAS,EAAK,KAAK,EAS5D,OAPA,KAAK,cAAc,cAER,EAAK,UAAU,CAAM,EAE9B,CAAC,CAAI,CACP,EAEO,CACT,CAUA,QAAgB,EAAiB,EAAgB,CAC/C,GAAI,CACF,EAAG,CACL,OAAS,EAAO,CACd,QAAQ,MACN,kDACA,uEACA,qBACA,CACF,CAEF,CACF,CACF,EC/kBa,GACX,EACA,EAAwB,CAAC,IACtB,CACH,IAAM,EAAM,EAAQ,KAAO,IAAS,IAC9B,EAAQ,IAAI,IAElB,OAAO,MAAO,EAAW,IAAoC,CAE3D,IAAM,EAAW,OAAO,GAAW,UAAY,EAC3C,KAAK,UAAU,CAAM,EACrB,OAAO,CAAM,EAEX,EAAM,KAAK,IAAI,EACf,EAAS,EAAM,IAAI,CAAQ,EAGjC,GAAI,GAAW,EAAM,EAAO,UAAY,EACtC,OAAO,EAAO,KAIhB,IAAM,EAAY,MAAM,EAAQ,EAAQ,CAAM,EAQ9C,OALA,EAAM,IAAI,EAAU,CAClB,KAAM,EACN,UAAW,KAAK,IAAI,CACtB,CAAC,EAEM,CACT,CACF,ECxCa,GACX,EACA,IACS,CAET,IAAM,GAAA,EAAA,EAAA,OAAA,CAAqB,CAAQ,GAEnC,EAAA,EAAA,UAAA,KAAgB,CACd,EAAY,QAAU,CACxB,EAAG,CAAC,CAAQ,CAAC,GAEb,EAAA,EAAA,UAAA,KAEiC,EAAO,UAAW,GAAQ,CACvD,EAAY,QAAQ,CAAG,CACzB,CAGO,EACN,CAAC,CAAM,CAAC,CACb,ECda,EAAuB,GAA+B,CAEjE,IAAM,GAAA,EAAA,EAAA,QAAA,KACG,OAAO,GAAU,WAAa,EAAM,EAAI,EAC9C,CAAC,CAAK,CAAC,EAGJ,GAAA,EAAA,EAAA,YAAA,CACH,GACQ,EAAa,UAAU,CAAa,EAE7C,CAAC,CAAY,CACf,EAEM,GAAA,EAAA,EAAA,YAAA,KACG,EAAa,MACnB,CAAC,CAAY,CAAC,EAWjB,OARA,EAAA,EAAA,UAAA,SACe,CACP,GAAgB,OAAO,EAAa,SAAY,YAClD,EAAa,QAAQ,CAEzB,EACC,CAAC,CAAY,CAAC,GAEjB,EAAA,EAAA,qBAAA,CAA4B,EAAW,CAAW,CACpD,EC7Ba,EAAwB,GAA+B,CAClE,IAAM,GAAA,EAAA,EAAA,QAAA,KACG,OAAO,GAAU,WAAa,EAAM,EAAI,EAC9C,CAAC,CAAK,CAAC,EAEJ,CAAC,EAAO,IAAA,EAAA,EAAA,SAAA,CAAwB,EAAa,KAAK,EAClD,GAAA,EAAA,EAAA,OAAA,CAAqB,CAAQ,EAqBnC,OAnBA,EAAA,EAAA,UAAA,KAAgB,CACd,EAAY,QAAU,CACxB,EAAG,CAAC,CAAQ,CAAC,GAEb,EAAA,EAAA,UAAA,KAAgB,CACd,EAAY,QAAQ,EAAa,KAAK,EAEtC,IAAM,EAAc,EAAa,UAAW,GAAa,CACvD,EAAY,QAAQ,CAAQ,CAC9B,CAAC,EAED,UAAa,CACX,EAAY,EACR,GAAgB,OAAO,EAAa,SAAY,YAClD,EAAa,QAAQ,CAEzB,CACF,EAAG,CAAC,CAAY,CAAC,EAEV,CACT"}
|
|
1
|
+
{"version":3,"file":"index.cjs","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/core.ts","../src/decorators/withCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\n// export abstract class BaseService {\n// constructor(protected engine: ReactiveEngine) {\n// // Вызываем метод инициализации, который можно переопределить в наследниках\n// this.onInit();\n// }\n\n// // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n// // Удобно для инициализации сигналов, которые зависят от engine.\n// protected onInit(): void {}\n\n// // NOTE: Полезные хелперы для сокращения кода\n// protected createSignal<T>(val: T, name?: string) {\n// return this.engine.signal(val, name);\n// }\n\n// protected createComputed<T>(fn: () => T) {\n// return this.engine.computed(fn);\n// }\n// }\n\nexport abstract class BaseREService {\n constructor(protected engine: ReactiveEngine) { } // Просто сохраняем engine\n\n protected createNumericSignal(val: number, name: string) {\n return this.engine.signal(val, {\n name,\n validate: (v) => typeof v === 'number' && !isNaN(v)\n });\n }\n}\n","import { ReactiveEngine } from './core';\n\nexport abstract class BaseREServiceEnhanced {\n constructor(protected engine: ReactiveEngine) {\n setTimeout(() => this.onInit(), 0)\n }\n\n protected onInit(): void { }\n}\n","import { useState as useStateFromReact, useEffect as useEffectFromReact } from 'react';\n\n// --- ТИПЫ ---\nexport type CleanupFn = () => void;\nexport type EffectFn = () => CleanupFn | void;\nexport type Token<T> = string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T };\nexport type Factory<T> = (engine: ReactiveEngine) => T;\n\nexport interface IEffect {\n run: () => void;\n cleanups: Set<CleanupFn>;\n}\n\nexport interface ResourceState<T> {\n data: T | null;\n loading: boolean;\n error: any | null;\n}\n\n/**\n * Функция для очистки эффекта.\n * @typedef {() => void} CleanupFn\n */\n\n/**\n * Функция эффекта, которая может возвращать функцию очистки.\n * @typedef {() => CleanupFn | void} EffectFn\n */\n\n/**\n * Токен для зависимости.\n * @typedef {string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T }} Token<T>\n */\n\n/**\n * Фабрика для создания сервиса.\n * @template T\n * @typedef {(engine: ReactiveEngine) => T} Factory<T>\n */\n\n/**\n * Интерфейс для эффекта.\n * @interface IEffect\n */\nexport interface IEffect {\n /**\n * Запуск эффекта.\n * @function run\n * @returns {void}\n */\n run: () => void;\n\n /**\n * Коллекция функций очистки.\n * @type {Set<CleanupFn>}\n */\n cleanups: Set<CleanupFn>;\n}\n\n/**\n * Интерфейс для состояния ресурса.\n * @template T Data format\n * @interface ResourceState<T>\n */\nexport interface ResourceState<T> {\n /**\n * Данные ресурса.\n * @type {T | null}\n */\n data: T | null;\n\n /**\n * Состояние загрузки ресурса.\n * @type {boolean}\n */\n loading: boolean;\n\n /**\n * Ошибка ресурса.\n * @type {any | null}\n */\n error: any | null;\n}\n\n/**\n * Интерфейс для сигнала.\n * @template T\n * @interface Signal<T>\n */\nexport interface Signal<T> {\n /**\n * Значение сигнала.\n * @type {T}\n */\n value: T;\n\n /**\n * Подписка на изменение значения сигнала.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n}\n\n/**\n * Интерфейс для вычисляемого значения.\n * @template T\n * @interface Computed<T>\n */\nexport interface Computed<T> {\n /**\n * Только читаемое значение вычисляемого значения.\n * @type {T}\n */\n readonly value: T;\n\n /**\n * Подписка на изменение вычисляемого значения.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n\n /**\n * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.\n */\n destroy: () => void;\n}\n\n\n/**\n * Интерфейс для ресурса.\n * @template T\n * @interface Resource<T>\n */\nexport interface Resource<T> extends ResourceState<T> {\n /**\n * Перезагрузка ресурса.\n * @function refetch\n * @returns {void}\n */\n refetch: () => void;\n\n /**\n * Подписка на изменение состояния ресурса.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;\n\n /**\n * Только читаемое состояние ресурса.\n * @type {ResourceState<T>}\n */\n readonly value: ResourceState<T>;\n}\n\n/**\n * Интерфейс для опций сигнала.\n * @template T\n * @interface SignalOptions<T>\n */\nexport interface SignalOptions<T> {\n /**\n * Имя сигнала.\n * @type {string}\n */\n name?: string;\n\n /**\n * Валидатор значения сигнала.\n * @function validate\n * @param {T} val - Значение для валидации.\n * @returns {boolean | string} - Результат валидации.\n */\n validate?: (val: T) => boolean | string;\n}\n\n// --- ЯДРО ---\n/**\n * Класс реактивного движка.\n */\nexport class ReactiveEngine {\n private activeEffect: IEffect | null = null;\n private isBatching = false;\n private pendingEffects = new Set<IEffect>();\n\n // В контейнерах DI вместо any используем unknown. Это заставит методы inject/provide\n // явно приводить типы через дженерики <T>, защищая от рантайм-ошибок.\n private services = new Map<Token<unknown>, unknown>();\n private factories = new Map<Token<unknown>, Factory<unknown>>();\n\n // Объект-ключ мапится на объект-прокси. Здесь идеально подходит тип object.\n private proxyCache = new WeakMap<object, object>();\n private allEffects = new Set<IEffect>();\n\n /**\n * Коллбек для уведомления об изменении сигнала.\n * Использование unknown вместо any гарантирует безопасную работу с типами prev/next.\n */\n public onSignalChange?: (name: string, next: unknown, prev: unknown) => void;\n\n // Описываем строгие типы для адаптеров React, чтобы не ломать встроенные типы React.\n private reactAdapters: {\n useState: typeof useStateFromReact;\n useEffect: typeof useEffectFromReact;\n } = {\n useState: useStateFromReact,\n useEffect: useEffectFromReact,\n };\n\n /**\n * DI: Регистрация зависимости.\n * @template T\n * @function provide\n * @param {Token<T>} token - Токен для зависимости.\n * @param {T | Factory<T>} valueOrFactory - Значение или фабрика для создания сервиса.\n * @returns {void}\n */\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 */\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 */\n public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n const engine = this;\n let val = initialValue;\n const subscribers = new Set<IEffect>();\n const options = typeof optionsOrName === 'string'\n ? { name: optionsOrName }\n : optionsOrName || {};\n const name = options.name || 'unnamed_signal';\n\n return {\n get value(): T {\n if (engine.activeEffect) subscribers.add(engine.activeEffect);\n return val;\n },\n set value(newValue: T) {\n if (val === newValue) return;\n\n // ВАЛИДАЦИЯ В RUNTIME\n if (options.validate) {\n const result = options.validate(newValue);\n if (result === false || typeof result === 'string') {\n const errorMsg = typeof result === 'string'\n ? result\n : `[Validation Error]: Некорректное значение для сигнала \"${name}\"`;\n\n console.error(`%c${errorMsg}`, \"color: orange; font-weight: bold;\", {\n received: newValue,\n current: val\n });\n return; // Прерываем обновление, если данные не валидны\n }\n }\n\n const old = val;\n val = newValue;\n engine.onSignalChange?.(name, newValue, old);\n\n // 1. Всегда добавляем подписчиков в очередь отложенных эффектов\n subscribers.forEach(e => engine.pendingEffects.add(e));\n\n // 2. Если очередь еще не запущена, планируем её автоматическое выполнение в микрозадачу\n if (!engine.isBatching) {\n engine.isBatching = true;\n\n queueMicrotask(() => {\n const effects = Array.from(engine.pendingEffects);\n engine.pendingEffects.clear();\n engine.isBatching = false;\n\n // Запускаем все накопившиеся эффекты и ререндеры за один раз\n effects.forEach(e => e.run());\n });\n }\n },\n subscribe(cb) {\n // Чистая и безопасная подписка для React:\n // Мы вызываем cb, но НЕ передаем туда аргументы, чтобы не ломать useSyncExternalStore\n return engine.effect(() => {\n cb(this.value);\n });\n }\n };\n }\n\n /**\n * Создание эффекта.\n * @function effect\n * @param {EffectFn} fn - Функция эффекта.\n * @returns {CleanupFn} - Функция для очистки эффекта.\n */\n public effect(fn: EffectFn): CleanupFn {\n const engine = this;\n const effectObj: IEffect = {\n cleanups: new Set(),\n run() {\n this.cleanups.forEach(c => c());\n this.cleanups.clear();\n const prev = engine.activeEffect;\n engine.activeEffect = this;\n engine.safeRun(this, () => {\n const cleanup = fn();\n if (typeof cleanup === 'function') this.cleanups.add(cleanup);\n });\n engine.activeEffect = prev;\n }\n };\n this.allEffects.add(effectObj);\n effectObj.run();\n\n return () => {\n effectObj.cleanups.forEach(c => c());\n engine.pendingEffects.delete(effectObj);\n engine.allEffects.delete(effectObj); // Всегда чистим за собой\n };\n }\n\n // Кэш для вычисляемых свойств: Вместо Map<Function, any> используем строгий интерфейс с unknown дженериком\n private computedCache = new Map<Function, Computed<unknown>>();\n\n /**\n * Создание вычисляемого значения.\n * @template T\n * @function computed\n * @param {Function} fn - Функция для вычисления значения.\n * @param {string} [signalName] - Имя сигнала.\n * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n */\n public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n // 1. Если для этой функции вычисление уже создано — приводим unknown к целевому типу T\n if (this.computedCache.has(fn)) {\n return this.computedCache.get(fn) as Computed<T>;\n }\n\n const engine = this;\n\n // 2. Избавляемся от any при инициализации пустого сигнала через двойной кастинг типов\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 // Извлекаем ссылку на объект эффекта, который только что зарегистрировался в конце Set\n const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1];\n\n // Создаем инстанс computed\n const computedInstance: Computed<T> = {\n get value() { return sig.value; },\n subscribe: (cb) => sig.subscribe(cb),\n destroy() {\n unsubscribeEffect();\n if (effectObj) {\n engine.allEffects.delete(effectObj);\n }\n // Не забываем удалить из кэша при принудительном уничтожении\n engine.computedCache.delete(fn);\n }\n };\n\n // 3. Сохраняем в кэш. TypeScript автоматически приведёт Computed<T> к Computed<unknown>\n this.computedCache.set(fn, 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 */\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 */\n public batch(fn: () => void): void {\n // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n // поэтому здесь мы можем просто выполнить функцию\n fn();\n }\n\n /**\n * Создание асинхронного ресурса.\n * @template T\n * @function resource\n * @param {Function} fetcher - Функция для загрузки данных.\n * @param {{ value: S }} [source] - Источник данных.\n * @param {string} [signalName] - Имя сигнала ресурса.\n * @returns {Resource<T>} - Асинхронный ресурс.\n */\n public resource<T, S = void>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n source?: { value: S },\n signalName?: string,\n ): Resource<T> {\n const state = this.signal<ResourceState<T>>({ data: null, loading: true, error: null }, signalName || 'unnamed_resource');\n let controller: AbortController | null = null;\n\n const load = async (sValue: S) => {\n controller?.abort();\n controller = new AbortController();\n\n // Читаем текущие данные без создания зависимости!\n const currentData = this.untrack(() => state.value.data);\n\n // Теперь обновление состояния не вызовет перезапуск эффекта\n state.value = { data: currentData, loading: true, error: null };\n\n try {\n const data = await fetcher(sValue, controller.signal);\n if (!controller.signal.aborted) {\n state.value = { data, loading: false, error: null };\n }\n } catch (e: any) {\n if (e.name !== 'AbortError') {\n state.value = { data: null, loading: false, error: e };\n }\n }\n };\n\n // Чтобы эффект не подписывался на state,\n // нам нужно изолировать чтение source от чтения state\n this.effect(() => {\n // Читаем ТОЛЬКО source. Это наша единственная зависимость.\n const sValue = source ? source.value : undefined as S;\n\n // Вызываем load. Внутри load чтение state.value\n // не должно регистрироваться как зависимость этого эффекта.\n load(sValue);\n\n return () => controller?.abort();\n });\n\n return {\n get data() { return state.value.data; },\n get loading() { return state.value.loading; },\n get error() { return state.value.error; },\n get value() { return state.value; },\n refetch: () => load(source ? source.value : undefined as S),\n subscribe: (cb) => state.subscribe(cb)\n };\n }\n\n /**\n * Выполняет функцию без отслеживания зависимостей.\n * @template T\n * @function untrack\n * @param {Function} fn - Функция для выполнения.\n * @returns {T} - Результат выполнения функции.\n */\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 */\n // Импортируйте useState и useEffect на верхнем уровне файла из 'react'\n public setReactAdapters(\n useState: typeof useStateFromReact,\n useEffect: typeof useEffectFromReact\n ): void {\n this.reactAdapters = { useState, useEffect };\n }\n\n\n /**\n * Использование реактивного значения в React компоненте.\n * @template T\n * @function use\n * @param {{ value: T; subscribe: (cb: (v: T) => void) => CleanupFn }} item - Реактивный объект.\n * @returns {T} - Значение реактивного объекта.\n */\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 */\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 { CleanupFn } from '../core'; // импорт типа отписки, если нужен\n\ninterface CacheEntry<T> {\n data: T;\n timestamp: number;\n}\n\ninterface CacheOptions {\n /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки кэширования\n */\nexport const withCache = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: CacheOptions = {}\n) => {\n const ttl = options.ttl ?? 5 * 60 * 1000; // Дефолтный TTL: 5 минут\n const cache = new Map<string, CacheEntry<T>>();\n\n return async (source: S, signal: AbortSignal): Promise<T> => {\n // 1. Генерируем уникальный ключ на основе зависимостей (массива или объекта)\n const cacheKey = typeof source === 'object' && source !== null\n ? JSON.stringify(source)\n : String(source);\n\n const now = Date.now();\n const cached = cache.get(cacheKey);\n\n // 2. Проверяем, есть ли валидный (не устаревший) кэш\n if (cached && (now - cached.timestamp < ttl)) {\n return cached.data;\n }\n\n // 3. Если кэша нет или он устарел — делаем реальный сетевой запрос\n const freshData = await fetcher(source, signal);\n\n // 4. Сохраняем свежие данные и метку времени в кэш\n cache.set(cacheKey, {\n data: freshData,\n timestamp: Date.now() // берем актуальное время после завершения запроса\n });\n\n return freshData;\n };\n};\n","import { useEffect, useRef } from 'react';\nimport { Signal, CleanupFn } from '../core';\n\n/**\n * Универсальный хук для подписки на изменения Signal, Computed или Resource.\n * @template T Тип данных внутри реактивного контейнера\n * @param {Signal<T> | { subscribe: (cb: (val: T) => void) => CleanupFn }} signal Объект подписки\n * @param {(val: T) => void} callback Функция обратного вызова, принимающая новое значение\n */\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 */\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 */\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
|
@@ -1,3 +1,6 @@
|
|
|
1
|
+
import { useEffect } from 'react';
|
|
2
|
+
import { useState } from 'react';
|
|
3
|
+
|
|
1
4
|
export declare abstract class BaseREService {
|
|
2
5
|
protected engine: ReactiveEngine;
|
|
3
6
|
constructor(engine: ReactiveEngine);
|
|
@@ -109,10 +112,10 @@ export declare class ReactiveEngine {
|
|
|
109
112
|
private proxyCache;
|
|
110
113
|
private allEffects;
|
|
111
114
|
/**
|
|
112
|
-
* Коллбек для уведомления
|
|
113
|
-
*
|
|
115
|
+
* Коллбек для уведомления об изменении сигнала.
|
|
116
|
+
* Использование unknown вместо any гарантирует безопасную работу с типами prev/next.
|
|
114
117
|
*/
|
|
115
|
-
onSignalChange?: (name: string, next:
|
|
118
|
+
onSignalChange?: (name: string, next: unknown, prev: unknown) => void;
|
|
116
119
|
private reactAdapters;
|
|
117
120
|
/**
|
|
118
121
|
* DI: Регистрация зависимости.
|
|
@@ -200,7 +203,7 @@ export declare class ReactiveEngine {
|
|
|
200
203
|
* @param {Function} useEffect - Функция useEffect из React.
|
|
201
204
|
* @returns {void}
|
|
202
205
|
*/
|
|
203
|
-
setReactAdapters(useState:
|
|
206
|
+
setReactAdapters(useState: typeof useState, useEffect: typeof useEffect): void;
|
|
204
207
|
/**
|
|
205
208
|
* Использование реактивного значения в React компоненте.
|
|
206
209
|
* @template T
|
package/dist/index.iife.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
var ReactiveEngineLib=(function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var n=class{engine;constructor(e){this.engine=e}createNumericSignal(e,t){return this.engine.signal(e,{name:t,validate:e=>typeof e==`number`&&!isNaN(e)})}},r=class{engine;constructor(e){this.engine=e,setTimeout(()=>this.onInit(),0)}onInit(){}},i=class{activeEffect=null;isBatching=!1;pendingEffects=new Set;services=new Map;factories=new Map;proxyCache=new WeakMap;allEffects=new Set;onSignalChange;reactAdapters={useState:t.useState,useEffect:t.useEffect};provide(e,t){typeof t==`function`&&!t.prototype?this.factories.set(e,t):this.services.set(e,t)}inject(e){if(!e)throw Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`);if(this.services.has(
|
|
1
|
+
var ReactiveEngineLib=(function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var n=class{engine;constructor(e){this.engine=e}createNumericSignal(e,t){return this.engine.signal(e,{name:t,validate:e=>typeof e==`number`&&!isNaN(e)})}},r=class{engine;constructor(e){this.engine=e,setTimeout(()=>this.onInit(),0)}onInit(){}},i=class{activeEffect=null;isBatching=!1;pendingEffects=new Set;services=new Map;factories=new Map;proxyCache=new WeakMap;allEffects=new Set;onSignalChange;reactAdapters={useState:t.useState,useEffect:t.useEffect};provide(e,t){typeof t==`function`&&!t.prototype?this.factories.set(e,t):this.services.set(e,t)}inject(e){if(!e)throw Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`);let t=e;if(this.services.has(t))return this.services.get(t);try{let n=this.factories.get(t);if(n){let e=n(this);return this.services.set(t,e),e}if(typeof e==`function`&&e.prototype){let n=new e(this);return this.services.set(t,n),n}throw Error(`Service not found: ${String(e)}`)}catch(t){throw Error(`[DI Error]: Не удалось создать сервис ${String(e)}. Ошибка: ${t?.message||`No e?.message`}`)}}signal(e,t){let n=this,r=e,i=new Set,a=typeof t==`string`?{name:t}:t||{},o=a.name||`unnamed_signal`;return{get value(){return n.activeEffect&&i.add(n.activeEffect),r},set value(e){if(r===e)return;if(a.validate){let t=a.validate(e);if(t===!1||typeof t==`string`){let n=typeof t==`string`?t:`[Validation Error]: Некорректное значение для сигнала "${o}"`;console.error(`%c${n}`,`color: orange; font-weight: bold;`,{received:e,current:r});return}}let t=r;r=e,n.onSignalChange?.(o,e,t),i.forEach(e=>n.pendingEffects.add(e)),n.isBatching||(n.isBatching=!0,queueMicrotask(()=>{let e=Array.from(n.pendingEffects);n.pendingEffects.clear(),n.isBatching=!1,e.forEach(e=>e.run())}))},subscribe(e){return n.effect(()=>{e(this.value)})}}}effect(e){let t=this,n={cleanups:new Set,run(){this.cleanups.forEach(e=>e()),this.cleanups.clear();let n=t.activeEffect;t.activeEffect=this,t.safeRun(this,()=>{let t=e();typeof t==`function`&&this.cleanups.add(t)}),t.activeEffect=n}};return this.allEffects.add(n),n.run(),()=>{n.cleanups.forEach(e=>e()),t.pendingEffects.delete(n),t.allEffects.delete(n)}}computedCache=new Map;computed(e,t){if(this.computedCache.has(e))return this.computedCache.get(e);let n=this,r=this.signal(void 0,t||`unnamed_computed`),i=this.effect(()=>{let t=e();r.value=t}),a=Array.from(this.allEffects)[this.allEffects.size-1],o={get value(){return r.value},subscribe:e=>r.subscribe(e),destroy(){i(),a&&n.allEffects.delete(a),n.computedCache.delete(e)}};return this.computedCache.set(e,o),o}reactive(e,t=`reactive`){if(this.proxyCache.has(e))return this.proxyCache.get(e);let n=this,r=new Map,i=new Proxy(e,{get(e,i,a){n.activeEffect&&(r.has(i)||r.set(i,new Set),r.get(i).add(n.activeEffect));let o=Reflect.get(e,i,a);return typeof o==`object`&&o?n.reactive(o,`${t}.${String(i)}`):o},set(e,i,a,o){let s=Reflect.get(e,i,o);return s===a||s!==a&&(Reflect.set(e,i,a,o),n.onSignalChange?.(`${t}.${String(i)}`,a,s),r.get(i)?.forEach(e=>n.isBatching?n.pendingEffects.add(e):e.run())),!0}});return this.proxyCache.set(e,i),i}batch(e){e()}resource(e,t,n){let r=this.signal({data:null,loading:!0,error:null},n||`unnamed_resource`),i=null,a=async t=>{i?.abort(),i=new AbortController;let n=this.untrack(()=>r.value.data);r.value={data:n,loading:!0,error:null};try{let n=await e(t,i.signal);i.signal.aborted||(r.value={data:n,loading:!1,error:null})}catch(e){e.name!==`AbortError`&&(r.value={data:null,loading:!1,error:e})}};return this.effect(()=>{let e=t?t.value:void 0;return a(e),()=>i?.abort()}),{get data(){return r.value.data},get loading(){return r.value.loading},get error(){return r.value.error},get value(){return r.value},refetch:()=>a(t?t.value:void 0),subscribe:e=>r.subscribe(e)}}untrack(e){let t=this.activeEffect;this.activeEffect=null;try{return e()}finally{this.activeEffect=t}}setReactAdapters(e,t){this.reactAdapters={useState:e,useEffect:t}}use(e){if(!this.reactAdapters)throw Error(`[React Error]: Адаптеры React не установлены. Вызовите engine.setReactAdapters(useState, useEffect).`);if(!e||typeof e.subscribe!=`function`){let t=`
|
|
2
2
|
[Reactive Error]: engine.use() получил некорректный объект!
|
|
3
3
|
Скорее всего, вы пытаетесь подписаться на свойство сервиса, которое не было инициализировано.
|
|
4
4
|
Проверьте, что в классе написано: public mySignal = this.engine.signal(...)
|
package/dist/index.iife.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.iife.js","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/core.ts","../src/decorators/withCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\n// export abstract class BaseService {\n// constructor(protected engine: ReactiveEngine) {\n// // Вызываем метод инициализации, который можно переопределить в наследниках\n// this.onInit();\n// }\n\n// // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n// // Удобно для инициализации сигналов, которые зависят от engine.\n// protected onInit(): void {}\n\n// // NOTE: Полезные хелперы для сокращения кода\n// protected createSignal<T>(val: T, name?: string) {\n// return this.engine.signal(val, name);\n// }\n\n// protected createComputed<T>(fn: () => T) {\n// return this.engine.computed(fn);\n// }\n// }\n\nexport abstract class BaseREService {\n constructor(protected engine: ReactiveEngine) { } // Просто сохраняем engine\n\n protected createNumericSignal(val: number, name: string) {\n return this.engine.signal(val, {\n name,\n validate: (v) => typeof v === 'number' && !isNaN(v)\n });\n }\n}\n","import { ReactiveEngine } from './core';\n\nexport abstract class BaseREServiceEnhanced {\n constructor(protected engine: ReactiveEngine) {\n setTimeout(() => this.onInit(), 0)\n }\n\n protected onInit(): void { }\n}\n","import { useState, useEffect } from 'react';\n\n// --- ТИПЫ ---\nexport type CleanupFn = () => void;\nexport type EffectFn = () => CleanupFn | void;\nexport type Token<T> = string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T };\nexport type Factory<T> = (engine: ReactiveEngine) => T;\n\nexport interface IEffect {\n run: () => void;\n cleanups: Set<CleanupFn>;\n}\n\nexport interface ResourceState<T> {\n data: T | null;\n loading: boolean;\n error: any | null;\n}\n\n/**\n * Функция для очистки эффекта.\n * @typedef {() => void} CleanupFn\n */\n\n/**\n * Функция эффекта, которая может возвращать функцию очистки.\n * @typedef {() => CleanupFn | void} EffectFn\n */\n\n/**\n * Токен для зависимости.\n * @typedef {string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T }} Token<T>\n */\n\n/**\n * Фабрика для создания сервиса.\n * @template T\n * @typedef {(engine: ReactiveEngine) => T} Factory<T>\n */\n\n/**\n * Интерфейс для эффекта.\n * @interface IEffect\n */\nexport interface IEffect {\n /**\n * Запуск эффекта.\n * @function run\n * @returns {void}\n */\n run: () => void;\n\n /**\n * Коллекция функций очистки.\n * @type {Set<CleanupFn>}\n */\n cleanups: Set<CleanupFn>;\n}\n\n/**\n * Интерфейс для состояния ресурса.\n * @template T Data format\n * @interface ResourceState<T>\n */\nexport interface ResourceState<T> {\n /**\n * Данные ресурса.\n * @type {T | null}\n */\n data: T | null;\n\n /**\n * Состояние загрузки ресурса.\n * @type {boolean}\n */\n loading: boolean;\n\n /**\n * Ошибка ресурса.\n * @type {any | null}\n */\n error: any | null;\n}\n\n/**\n * Интерфейс для сигнала.\n * @template T\n * @interface Signal<T>\n */\nexport interface Signal<T> {\n /**\n * Значение сигнала.\n * @type {T}\n */\n value: T;\n\n /**\n * Подписка на изменение значения сигнала.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n}\n\n/**\n * Интерфейс для вычисляемого значения.\n * @template T\n * @interface Computed<T>\n */\nexport interface Computed<T> {\n /**\n * Только читаемое значение вычисляемого значения.\n * @type {T}\n */\n readonly value: T;\n\n /**\n * Подписка на изменение вычисляемого значения.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n\n /**\n * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.\n */\n destroy: () => void;\n}\n\n\n/**\n * Интерфейс для ресурса.\n * @template T\n * @interface Resource<T>\n */\nexport interface Resource<T> extends ResourceState<T> {\n /**\n * Перезагрузка ресурса.\n * @function refetch\n * @returns {void}\n */\n refetch: () => void;\n\n /**\n * Подписка на изменение состояния ресурса.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;\n\n /**\n * Только читаемое состояние ресурса.\n * @type {ResourceState<T>}\n */\n readonly value: ResourceState<T>;\n}\n\n/**\n * Интерфейс для опций сигнала.\n * @template T\n * @interface SignalOptions<T>\n */\nexport interface SignalOptions<T> {\n /**\n * Имя сигнала.\n * @type {string}\n */\n name?: string;\n\n /**\n * Валидатор значения сигнала.\n * @function validate\n * @param {T} val - Значение для валидации.\n * @returns {boolean | string} - Результат валидации.\n */\n validate?: (val: T) => boolean | string;\n}\n\n// --- ЯДРО ---\n/**\n * Класс реактивного движка.\n */\nexport class ReactiveEngine {\n private activeEffect: IEffect | null = null;\n private isBatching = false;\n private pendingEffects = new Set<IEffect>();\n private services = new Map<Token<any>, any>();\n private factories = new Map<Token<any>, Factory<any>>();\n private proxyCache = new WeakMap<object, any>();\n private allEffects = new Set<IEffect>();\n\n /**\n * Коллбек для уведомления о изменении сигнала.\n * @type {Function}\n */\n public onSignalChange?: (name: string, next: any, prev: any) => void;\n\n private reactAdapters = {\n useState: useState as any,\n useEffect: useEffect as any,\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 */\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 */\n public inject<T>(token: Token<T>): T {\n if (!token) {\n throw new Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`);\n }\n\n if (this.services.has(token)) return this.services.get(token);\n\n // NOTE: (new way) Если это класс, но мы забыли его унаследовать от BaseService или передать engine\n try {\n // NOTE: Логика создания инстанса\n const factory = this.factories.get(token);\n if (factory) {\n const instance = factory(this);\n this.services.set(token, 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(token, 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 */\n public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n const engine = this;\n let val = initialValue;\n const subscribers = new Set<IEffect>();\n const options = typeof optionsOrName === 'string'\n ? { name: optionsOrName }\n : optionsOrName || {};\n const name = options.name || 'unnamed_signal';\n\n return {\n get value(): T {\n if (engine.activeEffect) subscribers.add(engine.activeEffect);\n return val;\n },\n set value(newValue: T) {\n if (val === newValue) return;\n\n // ВАЛИДАЦИЯ В RUNTIME\n if (options.validate) {\n const result = options.validate(newValue);\n if (result === false || typeof result === 'string') {\n const errorMsg = typeof result === 'string'\n ? result\n : `[Validation Error]: Некорректное значение для сигнала \"${name}\"`;\n\n console.error(`%c${errorMsg}`, \"color: orange; font-weight: bold;\", {\n received: newValue,\n current: val\n });\n return; // Прерываем обновление, если данные не валидны\n }\n }\n\n const old = val;\n val = newValue;\n engine.onSignalChange?.(name, newValue, old);\n\n // 1. Всегда добавляем подписчиков в очередь отложенных эффектов\n subscribers.forEach(e => engine.pendingEffects.add(e));\n\n // 2. Если очередь еще не запущена, планируем её автоматическое выполнение в микрозадачу\n if (!engine.isBatching) {\n engine.isBatching = true;\n\n queueMicrotask(() => {\n const effects = Array.from(engine.pendingEffects);\n engine.pendingEffects.clear();\n engine.isBatching = false;\n\n // Запускаем все накопившиеся эффекты и ререндеры за один раз\n effects.forEach(e => e.run());\n });\n }\n },\n subscribe(cb) {\n // Чистая и безопасная подписка для React:\n // Мы вызываем cb, но НЕ передаем туда аргументы, чтобы не ломать useSyncExternalStore\n return engine.effect(() => {\n cb(this.value);\n });\n }\n };\n }\n\n /**\n * Создание эффекта.\n * @function effect\n * @param {EffectFn} fn - Функция эффекта.\n * @returns {CleanupFn} - Функция для очистки эффекта.\n */\n public effect(fn: EffectFn): CleanupFn {\n const engine = this;\n const effectObj: IEffect = {\n cleanups: new Set(),\n run() {\n this.cleanups.forEach(c => c());\n this.cleanups.clear();\n const prev = engine.activeEffect;\n engine.activeEffect = this;\n engine.safeRun(this, () => {\n const cleanup = fn();\n if (typeof cleanup === 'function') this.cleanups.add(cleanup);\n });\n engine.activeEffect = prev;\n }\n };\n this.allEffects.add(effectObj);\n effectObj.run();\n\n return () => {\n effectObj.cleanups.forEach(c => c());\n engine.pendingEffects.delete(effectObj);\n engine.allEffects.delete(effectObj); // Всегда чистим за собой\n };\n }\n\n // Добавляем кэш для вычисляемых свойств\n private computedCache = new Map<Function, any>();\n\n /**\n * Создание вычисляемого значения.\n * @template T\n * @function computed\n * @param {Function} fn - Функция для вычисления значения.\n * @param {string} [signalName] - Имя сигнала.\n * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n */\n public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n // Если для этой функции вычисление уже создано — просто возвращаем его!\n if (this.computedCache.has(fn)) {\n return this.computedCache.get(fn);\n }\n\n const engine = this;\n const sig = this.signal<T>(undefined as any, signalName || 'unnamed_computed');\n\n const unsubscribeEffect = this.effect(() => {\n const newValue = fn();\n sig.value = newValue;\n });\n\n // Извлекаем ссылку на объект эффекта, который только что зарегистировался в конце Set\n const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1];\n\n // Создаем инстанс computed\n const computedInstance: Computed<T> = {\n get value() { return sig.value; },\n subscribe: (cb) => sig.subscribe(cb),\n destroy() {\n unsubscribeEffect();\n if (effectObj) {\n engine.allEffects.delete(effectObj);\n }\n // Не забываем удалить из кэша при принудительном уничтожении\n engine.computedCache.delete(fn);\n }\n };\n\n // Сохраняем в кэш перед возвратом\n this.computedCache.set(fn, computedInstance);\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 */\n public reactive<T extends object>(target: T, name: string = 'reactive'): T {\n if (this.proxyCache.has(target)) return this.proxyCache.get(target);\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 */\n public batch(fn: () => void): void {\n // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n // поэтому здесь мы можем просто выполнить функцию\n fn();\n }\n\n\n /**\n * Создание асинхронного ресурса.\n * @template T\n * @function resource\n * @param {Function} fetcher - Функция для загрузки данных.\n * @param {{ value: S }} [source] - Источник данных.\n * @param {string} [signalName] - Имя сигнала ресурса.\n * @returns {Resource<T>} - Асинхронный ресурс.\n */\n public resource<T, S = void>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n source?: { value: S },\n signalName?: string,\n ): Resource<T> {\n const state = this.signal<ResourceState<T>>({ data: null, loading: true, error: null }, signalName || 'unnamed_resource');\n let controller: AbortController | null = null;\n\n const load = async (sValue: S) => {\n controller?.abort();\n controller = new AbortController();\n\n // Читаем текущие данные без создания зависимости!\n const currentData = this.untrack(() => state.value.data);\n\n // Теперь обновление состояния не вызовет перезапуск эффекта\n state.value = { data: currentData, loading: true, error: null };\n\n try {\n const data = await fetcher(sValue, controller.signal);\n if (!controller.signal.aborted) {\n state.value = { data, loading: false, error: null };\n }\n } catch (e: any) {\n if (e.name !== 'AbortError') {\n state.value = { data: null, loading: false, error: e };\n }\n }\n };\n\n // Чтобы эффект не подписывался на state,\n // нам нужно изолировать чтение source от чтения state\n this.effect(() => {\n // Читаем ТОЛЬКО source. Это наша единственная зависимость.\n const sValue = source ? source.value : undefined as S;\n\n // Вызываем load. Внутри load чтение state.value\n // не должно регистрироваться как зависимость этого эффекта.\n load(sValue);\n\n return () => controller?.abort();\n });\n\n return {\n get data() { return state.value.data; },\n get loading() { return state.value.loading; },\n get error() { return state.value.error; },\n get value() { return state.value; },\n refetch: () => load(source ? source.value : undefined as S),\n subscribe: (cb) => state.subscribe(cb)\n };\n }\n\n /**\n * Выполняет функцию без отслеживания зависимостей.\n * @template T\n * @function untrack\n * @param {Function} fn - Функция для выполнения.\n * @returns {T} - Результат выполнения функции.\n */\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 */\n public setReactAdapters(useState: any, useEffect: any) {\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 */\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 */\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 { CleanupFn } from '../core'; // импорт типа отписки, если нужен\n\ninterface CacheEntry<T> {\n data: T;\n timestamp: number;\n}\n\ninterface CacheOptions {\n /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки кэширования\n */\nexport const withCache = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: CacheOptions = {}\n) => {\n const ttl = options.ttl ?? 5 * 60 * 1000; // Дефолтный TTL: 5 минут\n const cache = new Map<string, CacheEntry<T>>();\n\n return async (source: S, signal: AbortSignal): Promise<T> => {\n // 1. Генерируем уникальный ключ на основе зависимостей (массива или объекта)\n const cacheKey = typeof source === 'object' && source !== null\n ? JSON.stringify(source)\n : String(source);\n\n const now = Date.now();\n const cached = cache.get(cacheKey);\n\n // 2. Проверяем, есть ли валидный (не устаревший) кэш\n if (cached && (now - cached.timestamp < ttl)) {\n return cached.data;\n }\n\n // 3. Если кэша нет или он устарел — делаем реальный сетевой запрос\n const freshData = await fetcher(source, signal);\n\n // 4. Сохраняем свежие данные и метку времени в кэш\n cache.set(cacheKey, {\n data: freshData,\n timestamp: Date.now() // берем актуальное время после завершения запроса\n });\n\n return freshData;\n };\n};\n","import { useEffect, useRef } from 'react';\nimport { Signal, CleanupFn } from '../core';\n\n/**\n * Универсальный хук для подписки на изменения Signal, Computed или Resource.\n * @template T Тип данных внутри реактивного контейнера\n * @param {Signal<T> | { subscribe: (cb: (val: T) => void) => CleanupFn }} signal Объект подписки\n * @param {(val: T) => void} callback Функция обратного вызова, принимающая новое значение\n */\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 */\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 */\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.iife.js","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/core.ts","../src/decorators/withCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\n// export abstract class BaseService {\n// constructor(protected engine: ReactiveEngine) {\n// // Вызываем метод инициализации, который можно переопределить в наследниках\n// this.onInit();\n// }\n\n// // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n// // Удобно для инициализации сигналов, которые зависят от engine.\n// protected onInit(): void {}\n\n// // NOTE: Полезные хелперы для сокращения кода\n// protected createSignal<T>(val: T, name?: string) {\n// return this.engine.signal(val, name);\n// }\n\n// protected createComputed<T>(fn: () => T) {\n// return this.engine.computed(fn);\n// }\n// }\n\nexport abstract class BaseREService {\n constructor(protected engine: ReactiveEngine) { } // Просто сохраняем engine\n\n protected createNumericSignal(val: number, name: string) {\n return this.engine.signal(val, {\n name,\n validate: (v) => typeof v === 'number' && !isNaN(v)\n });\n }\n}\n","import { ReactiveEngine } from './core';\n\nexport abstract class BaseREServiceEnhanced {\n constructor(protected engine: ReactiveEngine) {\n setTimeout(() => this.onInit(), 0)\n }\n\n protected onInit(): void { }\n}\n","import { useState as useStateFromReact, useEffect as useEffectFromReact } from 'react';\n\n// --- ТИПЫ ---\nexport type CleanupFn = () => void;\nexport type EffectFn = () => CleanupFn | void;\nexport type Token<T> = string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T };\nexport type Factory<T> = (engine: ReactiveEngine) => T;\n\nexport interface IEffect {\n run: () => void;\n cleanups: Set<CleanupFn>;\n}\n\nexport interface ResourceState<T> {\n data: T | null;\n loading: boolean;\n error: any | null;\n}\n\n/**\n * Функция для очистки эффекта.\n * @typedef {() => void} CleanupFn\n */\n\n/**\n * Функция эффекта, которая может возвращать функцию очистки.\n * @typedef {() => CleanupFn | void} EffectFn\n */\n\n/**\n * Токен для зависимости.\n * @typedef {string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T }} Token<T>\n */\n\n/**\n * Фабрика для создания сервиса.\n * @template T\n * @typedef {(engine: ReactiveEngine) => T} Factory<T>\n */\n\n/**\n * Интерфейс для эффекта.\n * @interface IEffect\n */\nexport interface IEffect {\n /**\n * Запуск эффекта.\n * @function run\n * @returns {void}\n */\n run: () => void;\n\n /**\n * Коллекция функций очистки.\n * @type {Set<CleanupFn>}\n */\n cleanups: Set<CleanupFn>;\n}\n\n/**\n * Интерфейс для состояния ресурса.\n * @template T Data format\n * @interface ResourceState<T>\n */\nexport interface ResourceState<T> {\n /**\n * Данные ресурса.\n * @type {T | null}\n */\n data: T | null;\n\n /**\n * Состояние загрузки ресурса.\n * @type {boolean}\n */\n loading: boolean;\n\n /**\n * Ошибка ресурса.\n * @type {any | null}\n */\n error: any | null;\n}\n\n/**\n * Интерфейс для сигнала.\n * @template T\n * @interface Signal<T>\n */\nexport interface Signal<T> {\n /**\n * Значение сигнала.\n * @type {T}\n */\n value: T;\n\n /**\n * Подписка на изменение значения сигнала.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n}\n\n/**\n * Интерфейс для вычисляемого значения.\n * @template T\n * @interface Computed<T>\n */\nexport interface Computed<T> {\n /**\n * Только читаемое значение вычисляемого значения.\n * @type {T}\n */\n readonly value: T;\n\n /**\n * Подписка на изменение вычисляемого значения.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n\n /**\n * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.\n */\n destroy: () => void;\n}\n\n\n/**\n * Интерфейс для ресурса.\n * @template T\n * @interface Resource<T>\n */\nexport interface Resource<T> extends ResourceState<T> {\n /**\n * Перезагрузка ресурса.\n * @function refetch\n * @returns {void}\n */\n refetch: () => void;\n\n /**\n * Подписка на изменение состояния ресурса.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;\n\n /**\n * Только читаемое состояние ресурса.\n * @type {ResourceState<T>}\n */\n readonly value: ResourceState<T>;\n}\n\n/**\n * Интерфейс для опций сигнала.\n * @template T\n * @interface SignalOptions<T>\n */\nexport interface SignalOptions<T> {\n /**\n * Имя сигнала.\n * @type {string}\n */\n name?: string;\n\n /**\n * Валидатор значения сигнала.\n * @function validate\n * @param {T} val - Значение для валидации.\n * @returns {boolean | string} - Результат валидации.\n */\n validate?: (val: T) => boolean | string;\n}\n\n// --- ЯДРО ---\n/**\n * Класс реактивного движка.\n */\nexport class ReactiveEngine {\n private activeEffect: IEffect | null = null;\n private isBatching = false;\n private pendingEffects = new Set<IEffect>();\n\n // В контейнерах DI вместо any используем unknown. Это заставит методы inject/provide\n // явно приводить типы через дженерики <T>, защищая от рантайм-ошибок.\n private services = new Map<Token<unknown>, unknown>();\n private factories = new Map<Token<unknown>, Factory<unknown>>();\n\n // Объект-ключ мапится на объект-прокси. Здесь идеально подходит тип object.\n private proxyCache = new WeakMap<object, object>();\n private allEffects = new Set<IEffect>();\n\n /**\n * Коллбек для уведомления об изменении сигнала.\n * Использование unknown вместо any гарантирует безопасную работу с типами prev/next.\n */\n public onSignalChange?: (name: string, next: unknown, prev: unknown) => void;\n\n // Описываем строгие типы для адаптеров React, чтобы не ломать встроенные типы React.\n private reactAdapters: {\n useState: typeof useStateFromReact;\n useEffect: typeof useEffectFromReact;\n } = {\n useState: useStateFromReact,\n useEffect: useEffectFromReact,\n };\n\n /**\n * DI: Регистрация зависимости.\n * @template T\n * @function provide\n * @param {Token<T>} token - Токен для зависимости.\n * @param {T | Factory<T>} valueOrFactory - Значение или фабрика для создания сервиса.\n * @returns {void}\n */\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 */\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 */\n public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n const engine = this;\n let val = initialValue;\n const subscribers = new Set<IEffect>();\n const options = typeof optionsOrName === 'string'\n ? { name: optionsOrName }\n : optionsOrName || {};\n const name = options.name || 'unnamed_signal';\n\n return {\n get value(): T {\n if (engine.activeEffect) subscribers.add(engine.activeEffect);\n return val;\n },\n set value(newValue: T) {\n if (val === newValue) return;\n\n // ВАЛИДАЦИЯ В RUNTIME\n if (options.validate) {\n const result = options.validate(newValue);\n if (result === false || typeof result === 'string') {\n const errorMsg = typeof result === 'string'\n ? result\n : `[Validation Error]: Некорректное значение для сигнала \"${name}\"`;\n\n console.error(`%c${errorMsg}`, \"color: orange; font-weight: bold;\", {\n received: newValue,\n current: val\n });\n return; // Прерываем обновление, если данные не валидны\n }\n }\n\n const old = val;\n val = newValue;\n engine.onSignalChange?.(name, newValue, old);\n\n // 1. Всегда добавляем подписчиков в очередь отложенных эффектов\n subscribers.forEach(e => engine.pendingEffects.add(e));\n\n // 2. Если очередь еще не запущена, планируем её автоматическое выполнение в микрозадачу\n if (!engine.isBatching) {\n engine.isBatching = true;\n\n queueMicrotask(() => {\n const effects = Array.from(engine.pendingEffects);\n engine.pendingEffects.clear();\n engine.isBatching = false;\n\n // Запускаем все накопившиеся эффекты и ререндеры за один раз\n effects.forEach(e => e.run());\n });\n }\n },\n subscribe(cb) {\n // Чистая и безопасная подписка для React:\n // Мы вызываем cb, но НЕ передаем туда аргументы, чтобы не ломать useSyncExternalStore\n return engine.effect(() => {\n cb(this.value);\n });\n }\n };\n }\n\n /**\n * Создание эффекта.\n * @function effect\n * @param {EffectFn} fn - Функция эффекта.\n * @returns {CleanupFn} - Функция для очистки эффекта.\n */\n public effect(fn: EffectFn): CleanupFn {\n const engine = this;\n const effectObj: IEffect = {\n cleanups: new Set(),\n run() {\n this.cleanups.forEach(c => c());\n this.cleanups.clear();\n const prev = engine.activeEffect;\n engine.activeEffect = this;\n engine.safeRun(this, () => {\n const cleanup = fn();\n if (typeof cleanup === 'function') this.cleanups.add(cleanup);\n });\n engine.activeEffect = prev;\n }\n };\n this.allEffects.add(effectObj);\n effectObj.run();\n\n return () => {\n effectObj.cleanups.forEach(c => c());\n engine.pendingEffects.delete(effectObj);\n engine.allEffects.delete(effectObj); // Всегда чистим за собой\n };\n }\n\n // Кэш для вычисляемых свойств: Вместо Map<Function, any> используем строгий интерфейс с unknown дженериком\n private computedCache = new Map<Function, Computed<unknown>>();\n\n /**\n * Создание вычисляемого значения.\n * @template T\n * @function computed\n * @param {Function} fn - Функция для вычисления значения.\n * @param {string} [signalName] - Имя сигнала.\n * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n */\n public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n // 1. Если для этой функции вычисление уже создано — приводим unknown к целевому типу T\n if (this.computedCache.has(fn)) {\n return this.computedCache.get(fn) as Computed<T>;\n }\n\n const engine = this;\n\n // 2. Избавляемся от any при инициализации пустого сигнала через двойной кастинг типов\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 // Извлекаем ссылку на объект эффекта, который только что зарегистрировался в конце Set\n const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1];\n\n // Создаем инстанс computed\n const computedInstance: Computed<T> = {\n get value() { return sig.value; },\n subscribe: (cb) => sig.subscribe(cb),\n destroy() {\n unsubscribeEffect();\n if (effectObj) {\n engine.allEffects.delete(effectObj);\n }\n // Не забываем удалить из кэша при принудительном уничтожении\n engine.computedCache.delete(fn);\n }\n };\n\n // 3. Сохраняем в кэш. TypeScript автоматически приведёт Computed<T> к Computed<unknown>\n this.computedCache.set(fn, 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 */\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 */\n public batch(fn: () => void): void {\n // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n // поэтому здесь мы можем просто выполнить функцию\n fn();\n }\n\n /**\n * Создание асинхронного ресурса.\n * @template T\n * @function resource\n * @param {Function} fetcher - Функция для загрузки данных.\n * @param {{ value: S }} [source] - Источник данных.\n * @param {string} [signalName] - Имя сигнала ресурса.\n * @returns {Resource<T>} - Асинхронный ресурс.\n */\n public resource<T, S = void>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n source?: { value: S },\n signalName?: string,\n ): Resource<T> {\n const state = this.signal<ResourceState<T>>({ data: null, loading: true, error: null }, signalName || 'unnamed_resource');\n let controller: AbortController | null = null;\n\n const load = async (sValue: S) => {\n controller?.abort();\n controller = new AbortController();\n\n // Читаем текущие данные без создания зависимости!\n const currentData = this.untrack(() => state.value.data);\n\n // Теперь обновление состояния не вызовет перезапуск эффекта\n state.value = { data: currentData, loading: true, error: null };\n\n try {\n const data = await fetcher(sValue, controller.signal);\n if (!controller.signal.aborted) {\n state.value = { data, loading: false, error: null };\n }\n } catch (e: any) {\n if (e.name !== 'AbortError') {\n state.value = { data: null, loading: false, error: e };\n }\n }\n };\n\n // Чтобы эффект не подписывался на state,\n // нам нужно изолировать чтение source от чтения state\n this.effect(() => {\n // Читаем ТОЛЬКО source. Это наша единственная зависимость.\n const sValue = source ? source.value : undefined as S;\n\n // Вызываем load. Внутри load чтение state.value\n // не должно регистрироваться как зависимость этого эффекта.\n load(sValue);\n\n return () => controller?.abort();\n });\n\n return {\n get data() { return state.value.data; },\n get loading() { return state.value.loading; },\n get error() { return state.value.error; },\n get value() { return state.value; },\n refetch: () => load(source ? source.value : undefined as S),\n subscribe: (cb) => state.subscribe(cb)\n };\n }\n\n /**\n * Выполняет функцию без отслеживания зависимостей.\n * @template T\n * @function untrack\n * @param {Function} fn - Функция для выполнения.\n * @returns {T} - Результат выполнения функции.\n */\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 */\n // Импортируйте useState и useEffect на верхнем уровне файла из 'react'\n public setReactAdapters(\n useState: typeof useStateFromReact,\n useEffect: typeof useEffectFromReact\n ): void {\n this.reactAdapters = { useState, useEffect };\n }\n\n\n /**\n * Использование реактивного значения в React компоненте.\n * @template T\n * @function use\n * @param {{ value: T; subscribe: (cb: (v: T) => void) => CleanupFn }} item - Реактивный объект.\n * @returns {T} - Значение реактивного объекта.\n */\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 */\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 { CleanupFn } from '../core'; // импорт типа отписки, если нужен\n\ninterface CacheEntry<T> {\n data: T;\n timestamp: number;\n}\n\ninterface CacheOptions {\n /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки кэширования\n */\nexport const withCache = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: CacheOptions = {}\n) => {\n const ttl = options.ttl ?? 5 * 60 * 1000; // Дефолтный TTL: 5 минут\n const cache = new Map<string, CacheEntry<T>>();\n\n return async (source: S, signal: AbortSignal): Promise<T> => {\n // 1. Генерируем уникальный ключ на основе зависимостей (массива или объекта)\n const cacheKey = typeof source === 'object' && source !== null\n ? JSON.stringify(source)\n : String(source);\n\n const now = Date.now();\n const cached = cache.get(cacheKey);\n\n // 2. Проверяем, есть ли валидный (не устаревший) кэш\n if (cached && (now - cached.timestamp < ttl)) {\n return cached.data;\n }\n\n // 3. Если кэша нет или он устарел — делаем реальный сетевой запрос\n const freshData = await fetcher(source, signal);\n\n // 4. Сохраняем свежие данные и метку времени в кэш\n cache.set(cacheKey, {\n data: freshData,\n timestamp: Date.now() // берем актуальное время после завершения запроса\n });\n\n return freshData;\n };\n};\n","import { useEffect, useRef } from 'react';\nimport { Signal, CleanupFn } from '../core';\n\n/**\n * Универсальный хук для подписки на изменения Signal, Computed или Resource.\n * @template T Тип данных внутри реактивного контейнера\n * @param {Signal<T> | { subscribe: (cb: (val: T) => void) => CleanupFn }} signal Объект подписки\n * @param {(val: T) => void} callback Функция обратного вызова, принимающая новое значение\n */\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 */\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 */\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.mjs
CHANGED
|
@@ -35,16 +35,17 @@ var o = class {
|
|
|
35
35
|
}
|
|
36
36
|
inject(e) {
|
|
37
37
|
if (!e) throw Error("[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.");
|
|
38
|
-
|
|
38
|
+
let t = e;
|
|
39
|
+
if (this.services.has(t)) return this.services.get(t);
|
|
39
40
|
try {
|
|
40
|
-
let
|
|
41
|
-
if (
|
|
42
|
-
let
|
|
43
|
-
return this.services.set(
|
|
41
|
+
let n = this.factories.get(t);
|
|
42
|
+
if (n) {
|
|
43
|
+
let e = n(this);
|
|
44
|
+
return this.services.set(t, e), e;
|
|
44
45
|
}
|
|
45
46
|
if (typeof e == "function" && e.prototype) {
|
|
46
|
-
let
|
|
47
|
-
return this.services.set(
|
|
47
|
+
let n = new e(this);
|
|
48
|
+
return this.services.set(t, n), n;
|
|
48
49
|
}
|
|
49
50
|
throw Error(`Service not found: ${String(e)}`);
|
|
50
51
|
} catch (t) {
|
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.mjs","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/core.ts","../src/decorators/withCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\n// export abstract class BaseService {\n// constructor(protected engine: ReactiveEngine) {\n// // Вызываем метод инициализации, который можно переопределить в наследниках\n// this.onInit();\n// }\n\n// // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n// // Удобно для инициализации сигналов, которые зависят от engine.\n// protected onInit(): void {}\n\n// // NOTE: Полезные хелперы для сокращения кода\n// protected createSignal<T>(val: T, name?: string) {\n// return this.engine.signal(val, name);\n// }\n\n// protected createComputed<T>(fn: () => T) {\n// return this.engine.computed(fn);\n// }\n// }\n\nexport abstract class BaseREService {\n constructor(protected engine: ReactiveEngine) { } // Просто сохраняем engine\n\n protected createNumericSignal(val: number, name: string) {\n return this.engine.signal(val, {\n name,\n validate: (v) => typeof v === 'number' && !isNaN(v)\n });\n }\n}\n","import { ReactiveEngine } from './core';\n\nexport abstract class BaseREServiceEnhanced {\n constructor(protected engine: ReactiveEngine) {\n setTimeout(() => this.onInit(), 0)\n }\n\n protected onInit(): void { }\n}\n","import { useState, useEffect } from 'react';\n\n// --- ТИПЫ ---\nexport type CleanupFn = () => void;\nexport type EffectFn = () => CleanupFn | void;\nexport type Token<T> = string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T };\nexport type Factory<T> = (engine: ReactiveEngine) => T;\n\nexport interface IEffect {\n run: () => void;\n cleanups: Set<CleanupFn>;\n}\n\nexport interface ResourceState<T> {\n data: T | null;\n loading: boolean;\n error: any | null;\n}\n\n/**\n * Функция для очистки эффекта.\n * @typedef {() => void} CleanupFn\n */\n\n/**\n * Функция эффекта, которая может возвращать функцию очистки.\n * @typedef {() => CleanupFn | void} EffectFn\n */\n\n/**\n * Токен для зависимости.\n * @typedef {string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T }} Token<T>\n */\n\n/**\n * Фабрика для создания сервиса.\n * @template T\n * @typedef {(engine: ReactiveEngine) => T} Factory<T>\n */\n\n/**\n * Интерфейс для эффекта.\n * @interface IEffect\n */\nexport interface IEffect {\n /**\n * Запуск эффекта.\n * @function run\n * @returns {void}\n */\n run: () => void;\n\n /**\n * Коллекция функций очистки.\n * @type {Set<CleanupFn>}\n */\n cleanups: Set<CleanupFn>;\n}\n\n/**\n * Интерфейс для состояния ресурса.\n * @template T Data format\n * @interface ResourceState<T>\n */\nexport interface ResourceState<T> {\n /**\n * Данные ресурса.\n * @type {T | null}\n */\n data: T | null;\n\n /**\n * Состояние загрузки ресурса.\n * @type {boolean}\n */\n loading: boolean;\n\n /**\n * Ошибка ресурса.\n * @type {any | null}\n */\n error: any | null;\n}\n\n/**\n * Интерфейс для сигнала.\n * @template T\n * @interface Signal<T>\n */\nexport interface Signal<T> {\n /**\n * Значение сигнала.\n * @type {T}\n */\n value: T;\n\n /**\n * Подписка на изменение значения сигнала.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n}\n\n/**\n * Интерфейс для вычисляемого значения.\n * @template T\n * @interface Computed<T>\n */\nexport interface Computed<T> {\n /**\n * Только читаемое значение вычисляемого значения.\n * @type {T}\n */\n readonly value: T;\n\n /**\n * Подписка на изменение вычисляемого значения.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n\n /**\n * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.\n */\n destroy: () => void;\n}\n\n\n/**\n * Интерфейс для ресурса.\n * @template T\n * @interface Resource<T>\n */\nexport interface Resource<T> extends ResourceState<T> {\n /**\n * Перезагрузка ресурса.\n * @function refetch\n * @returns {void}\n */\n refetch: () => void;\n\n /**\n * Подписка на изменение состояния ресурса.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;\n\n /**\n * Только читаемое состояние ресурса.\n * @type {ResourceState<T>}\n */\n readonly value: ResourceState<T>;\n}\n\n/**\n * Интерфейс для опций сигнала.\n * @template T\n * @interface SignalOptions<T>\n */\nexport interface SignalOptions<T> {\n /**\n * Имя сигнала.\n * @type {string}\n */\n name?: string;\n\n /**\n * Валидатор значения сигнала.\n * @function validate\n * @param {T} val - Значение для валидации.\n * @returns {boolean | string} - Результат валидации.\n */\n validate?: (val: T) => boolean | string;\n}\n\n// --- ЯДРО ---\n/**\n * Класс реактивного движка.\n */\nexport class ReactiveEngine {\n private activeEffect: IEffect | null = null;\n private isBatching = false;\n private pendingEffects = new Set<IEffect>();\n private services = new Map<Token<any>, any>();\n private factories = new Map<Token<any>, Factory<any>>();\n private proxyCache = new WeakMap<object, any>();\n private allEffects = new Set<IEffect>();\n\n /**\n * Коллбек для уведомления о изменении сигнала.\n * @type {Function}\n */\n public onSignalChange?: (name: string, next: any, prev: any) => void;\n\n private reactAdapters = {\n useState: useState as any,\n useEffect: useEffect as any,\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 */\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 */\n public inject<T>(token: Token<T>): T {\n if (!token) {\n throw new Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`);\n }\n\n if (this.services.has(token)) return this.services.get(token);\n\n // NOTE: (new way) Если это класс, но мы забыли его унаследовать от BaseService или передать engine\n try {\n // NOTE: Логика создания инстанса\n const factory = this.factories.get(token);\n if (factory) {\n const instance = factory(this);\n this.services.set(token, 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(token, 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 */\n public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n const engine = this;\n let val = initialValue;\n const subscribers = new Set<IEffect>();\n const options = typeof optionsOrName === 'string'\n ? { name: optionsOrName }\n : optionsOrName || {};\n const name = options.name || 'unnamed_signal';\n\n return {\n get value(): T {\n if (engine.activeEffect) subscribers.add(engine.activeEffect);\n return val;\n },\n set value(newValue: T) {\n if (val === newValue) return;\n\n // ВАЛИДАЦИЯ В RUNTIME\n if (options.validate) {\n const result = options.validate(newValue);\n if (result === false || typeof result === 'string') {\n const errorMsg = typeof result === 'string'\n ? result\n : `[Validation Error]: Некорректное значение для сигнала \"${name}\"`;\n\n console.error(`%c${errorMsg}`, \"color: orange; font-weight: bold;\", {\n received: newValue,\n current: val\n });\n return; // Прерываем обновление, если данные не валидны\n }\n }\n\n const old = val;\n val = newValue;\n engine.onSignalChange?.(name, newValue, old);\n\n // 1. Всегда добавляем подписчиков в очередь отложенных эффектов\n subscribers.forEach(e => engine.pendingEffects.add(e));\n\n // 2. Если очередь еще не запущена, планируем её автоматическое выполнение в микрозадачу\n if (!engine.isBatching) {\n engine.isBatching = true;\n\n queueMicrotask(() => {\n const effects = Array.from(engine.pendingEffects);\n engine.pendingEffects.clear();\n engine.isBatching = false;\n\n // Запускаем все накопившиеся эффекты и ререндеры за один раз\n effects.forEach(e => e.run());\n });\n }\n },\n subscribe(cb) {\n // Чистая и безопасная подписка для React:\n // Мы вызываем cb, но НЕ передаем туда аргументы, чтобы не ломать useSyncExternalStore\n return engine.effect(() => {\n cb(this.value);\n });\n }\n };\n }\n\n /**\n * Создание эффекта.\n * @function effect\n * @param {EffectFn} fn - Функция эффекта.\n * @returns {CleanupFn} - Функция для очистки эффекта.\n */\n public effect(fn: EffectFn): CleanupFn {\n const engine = this;\n const effectObj: IEffect = {\n cleanups: new Set(),\n run() {\n this.cleanups.forEach(c => c());\n this.cleanups.clear();\n const prev = engine.activeEffect;\n engine.activeEffect = this;\n engine.safeRun(this, () => {\n const cleanup = fn();\n if (typeof cleanup === 'function') this.cleanups.add(cleanup);\n });\n engine.activeEffect = prev;\n }\n };\n this.allEffects.add(effectObj);\n effectObj.run();\n\n return () => {\n effectObj.cleanups.forEach(c => c());\n engine.pendingEffects.delete(effectObj);\n engine.allEffects.delete(effectObj); // Всегда чистим за собой\n };\n }\n\n // Добавляем кэш для вычисляемых свойств\n private computedCache = new Map<Function, any>();\n\n /**\n * Создание вычисляемого значения.\n * @template T\n * @function computed\n * @param {Function} fn - Функция для вычисления значения.\n * @param {string} [signalName] - Имя сигнала.\n * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n */\n public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n // Если для этой функции вычисление уже создано — просто возвращаем его!\n if (this.computedCache.has(fn)) {\n return this.computedCache.get(fn);\n }\n\n const engine = this;\n const sig = this.signal<T>(undefined as any, signalName || 'unnamed_computed');\n\n const unsubscribeEffect = this.effect(() => {\n const newValue = fn();\n sig.value = newValue;\n });\n\n // Извлекаем ссылку на объект эффекта, который только что зарегистировался в конце Set\n const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1];\n\n // Создаем инстанс computed\n const computedInstance: Computed<T> = {\n get value() { return sig.value; },\n subscribe: (cb) => sig.subscribe(cb),\n destroy() {\n unsubscribeEffect();\n if (effectObj) {\n engine.allEffects.delete(effectObj);\n }\n // Не забываем удалить из кэша при принудительном уничтожении\n engine.computedCache.delete(fn);\n }\n };\n\n // Сохраняем в кэш перед возвратом\n this.computedCache.set(fn, computedInstance);\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 */\n public reactive<T extends object>(target: T, name: string = 'reactive'): T {\n if (this.proxyCache.has(target)) return this.proxyCache.get(target);\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 */\n public batch(fn: () => void): void {\n // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n // поэтому здесь мы можем просто выполнить функцию\n fn();\n }\n\n\n /**\n * Создание асинхронного ресурса.\n * @template T\n * @function resource\n * @param {Function} fetcher - Функция для загрузки данных.\n * @param {{ value: S }} [source] - Источник данных.\n * @param {string} [signalName] - Имя сигнала ресурса.\n * @returns {Resource<T>} - Асинхронный ресурс.\n */\n public resource<T, S = void>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n source?: { value: S },\n signalName?: string,\n ): Resource<T> {\n const state = this.signal<ResourceState<T>>({ data: null, loading: true, error: null }, signalName || 'unnamed_resource');\n let controller: AbortController | null = null;\n\n const load = async (sValue: S) => {\n controller?.abort();\n controller = new AbortController();\n\n // Читаем текущие данные без создания зависимости!\n const currentData = this.untrack(() => state.value.data);\n\n // Теперь обновление состояния не вызовет перезапуск эффекта\n state.value = { data: currentData, loading: true, error: null };\n\n try {\n const data = await fetcher(sValue, controller.signal);\n if (!controller.signal.aborted) {\n state.value = { data, loading: false, error: null };\n }\n } catch (e: any) {\n if (e.name !== 'AbortError') {\n state.value = { data: null, loading: false, error: e };\n }\n }\n };\n\n // Чтобы эффект не подписывался на state,\n // нам нужно изолировать чтение source от чтения state\n this.effect(() => {\n // Читаем ТОЛЬКО source. Это наша единственная зависимость.\n const sValue = source ? source.value : undefined as S;\n\n // Вызываем load. Внутри load чтение state.value\n // не должно регистрироваться как зависимость этого эффекта.\n load(sValue);\n\n return () => controller?.abort();\n });\n\n return {\n get data() { return state.value.data; },\n get loading() { return state.value.loading; },\n get error() { return state.value.error; },\n get value() { return state.value; },\n refetch: () => load(source ? source.value : undefined as S),\n subscribe: (cb) => state.subscribe(cb)\n };\n }\n\n /**\n * Выполняет функцию без отслеживания зависимостей.\n * @template T\n * @function untrack\n * @param {Function} fn - Функция для выполнения.\n * @returns {T} - Результат выполнения функции.\n */\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 */\n public setReactAdapters(useState: any, useEffect: any) {\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 */\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 */\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 { CleanupFn } from '../core'; // импорт типа отписки, если нужен\n\ninterface CacheEntry<T> {\n data: T;\n timestamp: number;\n}\n\ninterface CacheOptions {\n /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки кэширования\n */\nexport const withCache = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: CacheOptions = {}\n) => {\n const ttl = options.ttl ?? 5 * 60 * 1000; // Дефолтный TTL: 5 минут\n const cache = new Map<string, CacheEntry<T>>();\n\n return async (source: S, signal: AbortSignal): Promise<T> => {\n // 1. Генерируем уникальный ключ на основе зависимостей (массива или объекта)\n const cacheKey = typeof source === 'object' && source !== null\n ? JSON.stringify(source)\n : String(source);\n\n const now = Date.now();\n const cached = cache.get(cacheKey);\n\n // 2. Проверяем, есть ли валидный (не устаревший) кэш\n if (cached && (now - cached.timestamp < ttl)) {\n return cached.data;\n }\n\n // 3. Если кэша нет или он устарел — делаем реальный сетевой запрос\n const freshData = await fetcher(source, signal);\n\n // 4. Сохраняем свежие данные и метку времени в кэш\n cache.set(cacheKey, {\n data: freshData,\n timestamp: Date.now() // берем актуальное время после завершения запроса\n });\n\n return freshData;\n };\n};\n","import { useEffect, useRef } from 'react';\nimport { Signal, CleanupFn } from '../core';\n\n/**\n * Универсальный хук для подписки на изменения Signal, Computed или Resource.\n * @template T Тип данных внутри реактивного контейнера\n * @param {Signal<T> | { subscribe: (cb: (val: T) => void) => CleanupFn }} signal Объект подписки\n * @param {(val: T) => void} callback Функция обратного вызова, принимающая новое значение\n */\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 */\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 */\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.mjs","names":[],"sources":["../src/BaseREService.ts","../src/BaseREServiceEnhanced.ts","../src/core.ts","../src/decorators/withCache.ts","../src/hooks/useReactiveSubscription.ts","../src/hooks/useReactiveValue.ts","../src/hooks/useReactiveValue0.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\n// export abstract class BaseService {\n// constructor(protected engine: ReactiveEngine) {\n// // Вызываем метод инициализации, который можно переопределить в наследниках\n// this.onInit();\n// }\n\n// // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n// // Удобно для инициализации сигналов, которые зависят от engine.\n// protected onInit(): void {}\n\n// // NOTE: Полезные хелперы для сокращения кода\n// protected createSignal<T>(val: T, name?: string) {\n// return this.engine.signal(val, name);\n// }\n\n// protected createComputed<T>(fn: () => T) {\n// return this.engine.computed(fn);\n// }\n// }\n\nexport abstract class BaseREService {\n constructor(protected engine: ReactiveEngine) { } // Просто сохраняем engine\n\n protected createNumericSignal(val: number, name: string) {\n return this.engine.signal(val, {\n name,\n validate: (v) => typeof v === 'number' && !isNaN(v)\n });\n }\n}\n","import { ReactiveEngine } from './core';\n\nexport abstract class BaseREServiceEnhanced {\n constructor(protected engine: ReactiveEngine) {\n setTimeout(() => this.onInit(), 0)\n }\n\n protected onInit(): void { }\n}\n","import { useState as useStateFromReact, useEffect as useEffectFromReact } from 'react';\n\n// --- ТИПЫ ---\nexport type CleanupFn = () => void;\nexport type EffectFn = () => CleanupFn | void;\nexport type Token<T> = string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T };\nexport type Factory<T> = (engine: ReactiveEngine) => T;\n\nexport interface IEffect {\n run: () => void;\n cleanups: Set<CleanupFn>;\n}\n\nexport interface ResourceState<T> {\n data: T | null;\n loading: boolean;\n error: any | null;\n}\n\n/**\n * Функция для очистки эффекта.\n * @typedef {() => void} CleanupFn\n */\n\n/**\n * Функция эффекта, которая может возвращать функцию очистки.\n * @typedef {() => CleanupFn | void} EffectFn\n */\n\n/**\n * Токен для зависимости.\n * @typedef {string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T }} Token<T>\n */\n\n/**\n * Фабрика для создания сервиса.\n * @template T\n * @typedef {(engine: ReactiveEngine) => T} Factory<T>\n */\n\n/**\n * Интерфейс для эффекта.\n * @interface IEffect\n */\nexport interface IEffect {\n /**\n * Запуск эффекта.\n * @function run\n * @returns {void}\n */\n run: () => void;\n\n /**\n * Коллекция функций очистки.\n * @type {Set<CleanupFn>}\n */\n cleanups: Set<CleanupFn>;\n}\n\n/**\n * Интерфейс для состояния ресурса.\n * @template T Data format\n * @interface ResourceState<T>\n */\nexport interface ResourceState<T> {\n /**\n * Данные ресурса.\n * @type {T | null}\n */\n data: T | null;\n\n /**\n * Состояние загрузки ресурса.\n * @type {boolean}\n */\n loading: boolean;\n\n /**\n * Ошибка ресурса.\n * @type {any | null}\n */\n error: any | null;\n}\n\n/**\n * Интерфейс для сигнала.\n * @template T\n * @interface Signal<T>\n */\nexport interface Signal<T> {\n /**\n * Значение сигнала.\n * @type {T}\n */\n value: T;\n\n /**\n * Подписка на изменение значения сигнала.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n}\n\n/**\n * Интерфейс для вычисляемого значения.\n * @template T\n * @interface Computed<T>\n */\nexport interface Computed<T> {\n /**\n * Только читаемое значение вычисляемого значения.\n * @type {T}\n */\n readonly value: T;\n\n /**\n * Подписка на изменение вычисляемого значения.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: T) => void) => CleanupFn;\n\n /**\n * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.\n */\n destroy: () => void;\n}\n\n\n/**\n * Интерфейс для ресурса.\n * @template T\n * @interface Resource<T>\n */\nexport interface Resource<T> extends ResourceState<T> {\n /**\n * Перезагрузка ресурса.\n * @function refetch\n * @returns {void}\n */\n refetch: () => void;\n\n /**\n * Подписка на изменение состояния ресурса.\n * @function subscribe\n * @param {Function} cb - Коллбек функция для обработки изменения.\n * @returns {CleanupFn} - Функция для очистки подписки.\n */\n subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;\n\n /**\n * Только читаемое состояние ресурса.\n * @type {ResourceState<T>}\n */\n readonly value: ResourceState<T>;\n}\n\n/**\n * Интерфейс для опций сигнала.\n * @template T\n * @interface SignalOptions<T>\n */\nexport interface SignalOptions<T> {\n /**\n * Имя сигнала.\n * @type {string}\n */\n name?: string;\n\n /**\n * Валидатор значения сигнала.\n * @function validate\n * @param {T} val - Значение для валидации.\n * @returns {boolean | string} - Результат валидации.\n */\n validate?: (val: T) => boolean | string;\n}\n\n// --- ЯДРО ---\n/**\n * Класс реактивного движка.\n */\nexport class ReactiveEngine {\n private activeEffect: IEffect | null = null;\n private isBatching = false;\n private pendingEffects = new Set<IEffect>();\n\n // В контейнерах DI вместо any используем unknown. Это заставит методы inject/provide\n // явно приводить типы через дженерики <T>, защищая от рантайм-ошибок.\n private services = new Map<Token<unknown>, unknown>();\n private factories = new Map<Token<unknown>, Factory<unknown>>();\n\n // Объект-ключ мапится на объект-прокси. Здесь идеально подходит тип object.\n private proxyCache = new WeakMap<object, object>();\n private allEffects = new Set<IEffect>();\n\n /**\n * Коллбек для уведомления об изменении сигнала.\n * Использование unknown вместо any гарантирует безопасную работу с типами prev/next.\n */\n public onSignalChange?: (name: string, next: unknown, prev: unknown) => void;\n\n // Описываем строгие типы для адаптеров React, чтобы не ломать встроенные типы React.\n private reactAdapters: {\n useState: typeof useStateFromReact;\n useEffect: typeof useEffectFromReact;\n } = {\n useState: useStateFromReact,\n useEffect: useEffectFromReact,\n };\n\n /**\n * DI: Регистрация зависимости.\n * @template T\n * @function provide\n * @param {Token<T>} token - Токен для зависимости.\n * @param {T | Factory<T>} valueOrFactory - Значение или фабрика для создания сервиса.\n * @returns {void}\n */\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 */\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 */\n public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n const engine = this;\n let val = initialValue;\n const subscribers = new Set<IEffect>();\n const options = typeof optionsOrName === 'string'\n ? { name: optionsOrName }\n : optionsOrName || {};\n const name = options.name || 'unnamed_signal';\n\n return {\n get value(): T {\n if (engine.activeEffect) subscribers.add(engine.activeEffect);\n return val;\n },\n set value(newValue: T) {\n if (val === newValue) return;\n\n // ВАЛИДАЦИЯ В RUNTIME\n if (options.validate) {\n const result = options.validate(newValue);\n if (result === false || typeof result === 'string') {\n const errorMsg = typeof result === 'string'\n ? result\n : `[Validation Error]: Некорректное значение для сигнала \"${name}\"`;\n\n console.error(`%c${errorMsg}`, \"color: orange; font-weight: bold;\", {\n received: newValue,\n current: val\n });\n return; // Прерываем обновление, если данные не валидны\n }\n }\n\n const old = val;\n val = newValue;\n engine.onSignalChange?.(name, newValue, old);\n\n // 1. Всегда добавляем подписчиков в очередь отложенных эффектов\n subscribers.forEach(e => engine.pendingEffects.add(e));\n\n // 2. Если очередь еще не запущена, планируем её автоматическое выполнение в микрозадачу\n if (!engine.isBatching) {\n engine.isBatching = true;\n\n queueMicrotask(() => {\n const effects = Array.from(engine.pendingEffects);\n engine.pendingEffects.clear();\n engine.isBatching = false;\n\n // Запускаем все накопившиеся эффекты и ререндеры за один раз\n effects.forEach(e => e.run());\n });\n }\n },\n subscribe(cb) {\n // Чистая и безопасная подписка для React:\n // Мы вызываем cb, но НЕ передаем туда аргументы, чтобы не ломать useSyncExternalStore\n return engine.effect(() => {\n cb(this.value);\n });\n }\n };\n }\n\n /**\n * Создание эффекта.\n * @function effect\n * @param {EffectFn} fn - Функция эффекта.\n * @returns {CleanupFn} - Функция для очистки эффекта.\n */\n public effect(fn: EffectFn): CleanupFn {\n const engine = this;\n const effectObj: IEffect = {\n cleanups: new Set(),\n run() {\n this.cleanups.forEach(c => c());\n this.cleanups.clear();\n const prev = engine.activeEffect;\n engine.activeEffect = this;\n engine.safeRun(this, () => {\n const cleanup = fn();\n if (typeof cleanup === 'function') this.cleanups.add(cleanup);\n });\n engine.activeEffect = prev;\n }\n };\n this.allEffects.add(effectObj);\n effectObj.run();\n\n return () => {\n effectObj.cleanups.forEach(c => c());\n engine.pendingEffects.delete(effectObj);\n engine.allEffects.delete(effectObj); // Всегда чистим за собой\n };\n }\n\n // Кэш для вычисляемых свойств: Вместо Map<Function, any> используем строгий интерфейс с unknown дженериком\n private computedCache = new Map<Function, Computed<unknown>>();\n\n /**\n * Создание вычисляемого значения.\n * @template T\n * @function computed\n * @param {Function} fn - Функция для вычисления значения.\n * @param {string} [signalName] - Имя сигнала.\n * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n */\n public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n // 1. Если для этой функции вычисление уже создано — приводим unknown к целевому типу T\n if (this.computedCache.has(fn)) {\n return this.computedCache.get(fn) as Computed<T>;\n }\n\n const engine = this;\n\n // 2. Избавляемся от any при инициализации пустого сигнала через двойной кастинг типов\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 // Извлекаем ссылку на объект эффекта, который только что зарегистрировался в конце Set\n const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1];\n\n // Создаем инстанс computed\n const computedInstance: Computed<T> = {\n get value() { return sig.value; },\n subscribe: (cb) => sig.subscribe(cb),\n destroy() {\n unsubscribeEffect();\n if (effectObj) {\n engine.allEffects.delete(effectObj);\n }\n // Не забываем удалить из кэша при принудительном уничтожении\n engine.computedCache.delete(fn);\n }\n };\n\n // 3. Сохраняем в кэш. TypeScript автоматически приведёт Computed<T> к Computed<unknown>\n this.computedCache.set(fn, 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 */\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 */\n public batch(fn: () => void): void {\n // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n // поэтому здесь мы можем просто выполнить функцию\n fn();\n }\n\n /**\n * Создание асинхронного ресурса.\n * @template T\n * @function resource\n * @param {Function} fetcher - Функция для загрузки данных.\n * @param {{ value: S }} [source] - Источник данных.\n * @param {string} [signalName] - Имя сигнала ресурса.\n * @returns {Resource<T>} - Асинхронный ресурс.\n */\n public resource<T, S = void>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n source?: { value: S },\n signalName?: string,\n ): Resource<T> {\n const state = this.signal<ResourceState<T>>({ data: null, loading: true, error: null }, signalName || 'unnamed_resource');\n let controller: AbortController | null = null;\n\n const load = async (sValue: S) => {\n controller?.abort();\n controller = new AbortController();\n\n // Читаем текущие данные без создания зависимости!\n const currentData = this.untrack(() => state.value.data);\n\n // Теперь обновление состояния не вызовет перезапуск эффекта\n state.value = { data: currentData, loading: true, error: null };\n\n try {\n const data = await fetcher(sValue, controller.signal);\n if (!controller.signal.aborted) {\n state.value = { data, loading: false, error: null };\n }\n } catch (e: any) {\n if (e.name !== 'AbortError') {\n state.value = { data: null, loading: false, error: e };\n }\n }\n };\n\n // Чтобы эффект не подписывался на state,\n // нам нужно изолировать чтение source от чтения state\n this.effect(() => {\n // Читаем ТОЛЬКО source. Это наша единственная зависимость.\n const sValue = source ? source.value : undefined as S;\n\n // Вызываем load. Внутри load чтение state.value\n // не должно регистрироваться как зависимость этого эффекта.\n load(sValue);\n\n return () => controller?.abort();\n });\n\n return {\n get data() { return state.value.data; },\n get loading() { return state.value.loading; },\n get error() { return state.value.error; },\n get value() { return state.value; },\n refetch: () => load(source ? source.value : undefined as S),\n subscribe: (cb) => state.subscribe(cb)\n };\n }\n\n /**\n * Выполняет функцию без отслеживания зависимостей.\n * @template T\n * @function untrack\n * @param {Function} fn - Функция для выполнения.\n * @returns {T} - Результат выполнения функции.\n */\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 */\n // Импортируйте useState и useEffect на верхнем уровне файла из 'react'\n public setReactAdapters(\n useState: typeof useStateFromReact,\n useEffect: typeof useEffectFromReact\n ): void {\n this.reactAdapters = { useState, useEffect };\n }\n\n\n /**\n * Использование реактивного значения в React компоненте.\n * @template T\n * @function use\n * @param {{ value: T; subscribe: (cb: (v: T) => void) => CleanupFn }} item - Реактивный объект.\n * @returns {T} - Значение реактивного объекта.\n */\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 */\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 { CleanupFn } from '../core'; // импорт типа отписки, если нужен\n\ninterface CacheEntry<T> {\n data: T;\n timestamp: number;\n}\n\ninterface CacheOptions {\n /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего fetcher-а для engine.resource\n * @param fetcher Оригинальная асинхронная функция запроса\n * @param options Настройки кэширования\n */\nexport const withCache = <S, T>(\n fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n options: CacheOptions = {}\n) => {\n const ttl = options.ttl ?? 5 * 60 * 1000; // Дефолтный TTL: 5 минут\n const cache = new Map<string, CacheEntry<T>>();\n\n return async (source: S, signal: AbortSignal): Promise<T> => {\n // 1. Генерируем уникальный ключ на основе зависимостей (массива или объекта)\n const cacheKey = typeof source === 'object' && source !== null\n ? JSON.stringify(source)\n : String(source);\n\n const now = Date.now();\n const cached = cache.get(cacheKey);\n\n // 2. Проверяем, есть ли валидный (не устаревший) кэш\n if (cached && (now - cached.timestamp < ttl)) {\n return cached.data;\n }\n\n // 3. Если кэша нет или он устарел — делаем реальный сетевой запрос\n const freshData = await fetcher(source, signal);\n\n // 4. Сохраняем свежие данные и метку времени в кэш\n cache.set(cacheKey, {\n data: freshData,\n timestamp: Date.now() // берем актуальное время после завершения запроса\n });\n\n return freshData;\n };\n};\n","import { useEffect, useRef } from 'react';\nimport { Signal, CleanupFn } from '../core';\n\n/**\n * Универсальный хук для подписки на изменения Signal, Computed или Resource.\n * @template T Тип данных внутри реактивного контейнера\n * @param {Signal<T> | { subscribe: (cb: (val: T) => void) => CleanupFn }} signal Объект подписки\n * @param {(val: T) => void} callback Функция обратного вызова, принимающая новое значение\n */\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 */\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 */\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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"}
|