@pravosleva/reactive-engine 0.4.2-beta → 1.0.2-beta

package/README.md

@@ -19,6 +19,35 @@ yarn add @pravosleva/reactive-engine
 pnpm add @pravosleva/reactive-engine
 ```
 
+```tsx
+import { AbstractService, ReactiveEngine } from '@pravosleva/reactive-engine'
+
+class Logic extends AbstractService {
+  public counter = this.engine.signal<number>(0, 'example-01:signal:counter');
+
+  public inc() {
+    this.counter.value += 1
+  }
+}
+
+const engine = new ReactiveEngine()
+
+export const Example001 = () => {
+  const logic = engine.inject(Logic)
+  const counter = engine.use(logic.counter)
+
+  return (
+    <div>
+      <div>Signal example</div>
+      <code>{counter}</code>
+      <div className={baseClasses.catSection}>
+        <button onClick={() => logic.inc()}>+ INC</button>
+      </div>
+    </div>
+  )
+}
+```
+
 ## 🎯 What Problems This Library Solves
 
 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:

package/dist/AbstractService.cjs

@@ -0,0 +1,2 @@
+var e=class{engine;constructor(e){this.engine=e,this.onInit()}createNumericSignal(e,t){return this.engine.signal(e,{name:t,validate:e=>typeof e==`number`&&!isNaN(e)})}createComputed(e){return this.engine.computed(e)}createSignal(e,t){return this.engine.signal(e,t)}onInit(){}},t=e;exports.AbstractService=e,exports.BaseREService=t;
+//# sourceMappingURL=AbstractService.cjs.map

package/dist/AbstractService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractService.cjs","names":[],"sources":["../src/core/AbstractService.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\nexport abstract class AbstractService {\n  constructor(protected engine: ReactiveEngine) {\n    // Вызываем метод инициализации, который можно переопределить в наследниках\n    this.onInit();\n  }\n\n  // NOTE: Полезные хелперы для сокращения кода\n  protected createNumericSignal(val: number, name: string) {\n    return this.engine.signal(val, {\n      name,\n      validate: (v) => typeof v === 'number' && !isNaN(v)\n    });\n  }\n\n  protected createComputed<T>(fn: () => T) {\n    return this.engine.computed(fn);\n  }\n\n  protected createSignal<T>(val: T, name?: string) {\n    return this.engine.signal(val, name);\n  }\n\n  // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n  // Удобно для инициализации сигналов, которые зависят от engine.\n  protected onInit(): void { }\n}\n\nexport const BaseREService = AbstractService\n"],"mappings":"AAEA,IAAsB,EAAtB,KAAsC,CACd,OAAtB,YAAY,EAAkC,CAAxB,KAAA,OAAA,EAEpB,KAAK,OAAO,CACd,CAGA,oBAA8B,EAAa,EAAc,CACvD,OAAO,KAAK,OAAO,OAAO,EAAK,CAC7B,OACA,SAAW,GAAM,OAAO,GAAM,UAAY,CAAC,MAAM,CAAC,CACpD,CAAC,CACH,CAEA,eAA4B,EAAa,CACvC,OAAO,KAAK,OAAO,SAAS,CAAE,CAChC,CAEA,aAA0B,EAAQ,EAAe,CAC/C,OAAO,KAAK,OAAO,OAAO,EAAK,CAAI,CACrC,CAIA,QAAyB,CAAE,CAC7B,EAEa,EAAgB"}

package/dist/AbstractService.mjs

@@ -0,0 +1,24 @@
+//#region src/core/AbstractService.ts
+var e = class {
+	engine;
+	constructor(e) {
+		this.engine = e, this.onInit();
+	}
+	createNumericSignal(e, t) {
+		return this.engine.signal(e, {
+			name: t,
+			validate: (e) => typeof e == "number" && !isNaN(e)
+		});
+	}
+	createComputed(e) {
+		return this.engine.computed(e);
+	}
+	createSignal(e, t) {
+		return this.engine.signal(e, t);
+	}
+	onInit() {}
+}, t = e;
+//#endregion
+export { e as AbstractService, t as BaseREService };
+
+//# sourceMappingURL=AbstractService.mjs.map

package/dist/AbstractService.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractService.mjs","names":[],"sources":["../src/core/AbstractService.ts"],"sourcesContent":["import { ReactiveEngine } from './core';\n\nexport abstract class AbstractService {\n  constructor(protected engine: ReactiveEngine) {\n    // Вызываем метод инициализации, который можно переопределить в наследниках\n    this.onInit();\n  }\n\n  // NOTE: Полезные хелперы для сокращения кода\n  protected createNumericSignal(val: number, name: string) {\n    return this.engine.signal(val, {\n      name,\n      validate: (v) => typeof v === 'number' && !isNaN(v)\n    });\n  }\n\n  protected createComputed<T>(fn: () => T) {\n    return this.engine.computed(fn);\n  }\n\n  protected createSignal<T>(val: T, name?: string) {\n    return this.engine.signal(val, name);\n  }\n\n  // NOTE: Жизненный цикл: вызывается сразу после создания сервиса.\n  // Удобно для инициализации сигналов, которые зависят от engine.\n  protected onInit(): void { }\n}\n\nexport const BaseREService = AbstractService\n"],"mappings":";AAEA,IAAsB,IAAtB,MAAsC;CACd;CAAtB,YAAY,GAAkC;EAE5C,AAFoB,KAAA,SAAA,GAEpB,KAAK,OAAO;CACd;CAGA,oBAA8B,GAAa,GAAc;EACvD,OAAO,KAAK,OAAO,OAAO,GAAK;GAC7B;GACA,WAAW,MAAM,OAAO,KAAM,YAAY,CAAC,MAAM,CAAC;EACpD,CAAC;CACH;CAEA,eAA4B,GAAa;EACvC,OAAO,KAAK,OAAO,SAAS,CAAE;CAChC;CAEA,aAA0B,GAAQ,GAAe;EAC/C,OAAO,KAAK,OAAO,OAAO,GAAK,CAAI;CACrC;CAIA,SAAyB,CAAE;AAC7B,GAEa,IAAgB"}

package/dist/BaseREServiceEnhanced.cjs

@@ -0,0 +1,2 @@
+var e=class{engine;constructor(e){this.engine=e,setTimeout(()=>this.onInit(),0)}onInit(){}};exports.BaseREServiceEnhanced=e;
+//# sourceMappingURL=BaseREServiceEnhanced.cjs.map

package/dist/BaseREServiceEnhanced.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseREServiceEnhanced.cjs","names":[],"sources":["../src/core/BaseREServiceEnhanced.ts"],"sourcesContent":["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"],"mappings":"AAEA,IAAsB,EAAtB,KAA4C,CACpB,OAAtB,YAAY,EAAkC,CAAxB,KAAA,OAAA,EACpB,eAAiB,KAAK,OAAO,EAAG,CAAC,CACnC,CAEA,QAAyB,CAAE,CAC7B"}

package/dist/BaseREServiceEnhanced.mjs

@@ -0,0 +1,12 @@
+//#region src/core/BaseREServiceEnhanced.ts
+var e = class {
+	engine;
+	constructor(e) {
+		this.engine = e, setTimeout(() => this.onInit(), 0);
+	}
+	onInit() {}
+};
+//#endregion
+export { e as BaseREServiceEnhanced };
+
+//# sourceMappingURL=BaseREServiceEnhanced.mjs.map

package/dist/BaseREServiceEnhanced.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseREServiceEnhanced.mjs","names":[],"sources":["../src/core/BaseREServiceEnhanced.ts"],"sourcesContent":["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"],"mappings":";AAEA,IAAsB,IAAtB,MAA4C;CACpB;CAAtB,YAAY,GAAkC;EAC5C,AADoB,KAAA,SAAA,GACpB,iBAAiB,KAAK,OAAO,GAAG,CAAC;CACnC;CAEA,SAAyB,CAAE;AAC7B"}

package/dist/_react-bindings.d.ts

@@ -0,0 +1,17 @@
+import { ReactiveEngine } from './react';
+import { Signal, Computed, Resource } from './core';
+export declare const engine: ReactiveEngine;
+/**
+ * Хук для получения текущего значения Signal и его авто-обновления в React.
+ */
+export declare function useSignal<T>(signal: Signal<T>): T;
+/**
+ * Хук для получения значения вычисляемого свойства Computed.
+ */
+export declare function useComputed<T>(computed: Computed<T>): T;
+/**
+ * Хук для реактивного отслеживания асинхронного ресурса.
+ * Возвращает объект состояния { data, loading, error }
+ */
+export declare function useResource<T>(resource: Resource<T>): import('./core').ResourceState<T>;
+//# sourceMappingURL=_react-bindings.d.ts.map

package/dist/_react-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_react-bindings.d.ts","sourceRoot":"","sources":["../src/_react-bindings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAQpD,eAAO,MAAM,MAAM,gBAAuB,CAAC;AAK3C;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAGjD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAEvD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,qCAGnD"}

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__toESM=s;

package/dist/core/AbstractService.d.ts

@@ -0,0 +1,11 @@
+import { ReactiveEngine } from './core';
+export declare abstract class AbstractService {
+    protected engine: ReactiveEngine;
+    constructor(engine: ReactiveEngine);
+    protected createNumericSignal(val: number, name: string): import('./core').Signal<number>;
+    protected createComputed<T>(fn: () => T): import('./core').Computed<T>;
+    protected createSignal<T>(val: T, name?: string): import('./core').Signal<T>;
+    protected onInit(): void;
+}
+export declare const BaseREService: typeof AbstractService;
+//# sourceMappingURL=AbstractService.d.ts.map

package/dist/core/AbstractService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractService.d.ts","sourceRoot":"","sources":["../../src/core/AbstractService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,8BAAsB,eAAe;IACvB,SAAS,CAAC,MAAM,EAAE,cAAc;gBAAtB,MAAM,EAAE,cAAc;IAM5C,SAAS,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAOvD,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC;IAIvC,SAAS,CAAC,YAAY,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM;IAM/C,SAAS,CAAC,MAAM,IAAI,IAAI;CACzB;AAED,eAAO,MAAM,aAAa,wBAAkB,CAAA"}

package/dist/core/BaseREServiceEnhanced.d.ts

@@ -0,0 +1,7 @@
+import { ReactiveEngine } from './core';
+export declare abstract class BaseREServiceEnhanced {
+    protected engine: ReactiveEngine;
+    constructor(engine: ReactiveEngine);
+    protected onInit(): void;
+}
+//# sourceMappingURL=BaseREServiceEnhanced.d.ts.map

package/dist/core/BaseREServiceEnhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseREServiceEnhanced.d.ts","sourceRoot":"","sources":["../../src/core/BaseREServiceEnhanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAExC,8BAAsB,qBAAqB;IAC7B,SAAS,CAAC,MAAM,EAAE,cAAc;gBAAtB,MAAM,EAAE,cAAc;IAI5C,SAAS,CAAC,MAAM,IAAI,IAAI;CACzB"}

package/dist/core/core.d.ts

@@ -0,0 +1,282 @@
+import { ResourceOptions, ResourceState, SignalOptions } from './types';
+/**
+ * Интерфейс для сигнала.
+ * @template T
+ * @interface Signal<T>
+ */
+export interface Signal<T> {
+    /**
+     * Значение сигнала.
+     * @type {T}
+     */
+    value: T;
+    /**
+     * Подписка на изменение значения сигнала.
+     * @function subscribe
+     * @param {Function} cb - Коллбек функция для обработки изменения.
+     * @returns {CleanupFn} - Функция для очистки подписки.
+     */
+    subscribe: (cb: (val: T) => void) => CleanupFn;
+}
+export type CleanupFn = () => void;
+export type EffectFn = () => CleanupFn | void;
+export type Token<T> = string | symbol | {
+    new (engine: ReactiveEngine, ...args: any[]): T;
+};
+export type Factory<T> = (engine: ReactiveEngine) => T;
+/**
+ * Интерфейс для вычисляемого значения.
+ * @template T
+ * @interface Computed<T>
+ */
+export interface Computed<T> {
+    /**
+     * Только читаемое значение вычисляемого значения.
+     * @type {T}
+     */
+    readonly value: T;
+    /**
+     * Подписка на изменение вычисляемого значения.
+     * @function subscribe
+     * @param {Function} cb - Коллбек функция для обработки изменения.
+     * @returns {CleanupFn} - Функция для очистки подписки.
+     */
+    subscribe: (cb: (val: T) => void) => CleanupFn;
+    /**
+     * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.
+     */
+    destroy: () => void;
+}
+/**
+ * Интерфейс для эффекта.
+ * @interface IEffect
+ */
+export interface IEffect {
+    run: () => void;
+    label?: string;
+    cleanups: Set<CleanupFn>;
+}
+/**
+ * Интерфейс для ресурса.
+ * @template T
+ * @interface Resource<T>
+ */
+export interface Resource<T> extends ResourceState<T> {
+    /**
+     * Перезагрузка ресурса.
+     * @function refetch
+     * @returns {void}
+     */
+    refetch: () => void;
+    /**
+     * Подписка на изменение состояния ресурса.
+     * @function subscribe
+     * @param {Function} cb - Коллбек функция для обработки изменения.
+     * @returns {CleanupFn} - Функция для очистки подписки.
+     */
+    subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;
+    /**
+     * Только читаемое состояние ресурса.
+     * @type {ResourceState<T>}
+     */
+    readonly value: ResourceState<T>;
+}
+/**
+ * Класс `ReactiveEngine` представляет собой реактивную систему, которая позволяет создавать и управлять реактивными объектами,
+ * сигналами, эффектами, асинхронными ресурсами и другими реактивными примитивами. Реактивные механизмы облегчают разработку
+ * сложных пользовательских интерфейсов и приложений, автоматически отслеживая зависимости между данными и реактивно обновляя UI.
+ *
+ * Основные возможности `ReactiveEngine` включают:
+ * - **Сигналы (Signals)**: Реактивные переменные с поддержкой подписки на изменения.
+ * - **Эффекты (Effects)**: Автоматические функции, которые выполняются при изменении зависимых сигналов.
+ * - **Ресурсы (Resources)**: Асинхронные ресурсы с поддержкой повторных попыток и валидации.
+ * - **Прокси-объекты (Proxy Objects)**: Реактивное обертывание объектов для отслеживания изменений свойств.
+ * - **Интеграция с React**: Удобные методы для интеграции реактивного ядра с компонентами React.
+ *
+ * Пример использования:
+ *
+ * ```javascript
+ * const engine = new ReactiveEngine();
+ * const count = engine.signal(0);
+ *
+ * engine.effect(() => {
+ *   console.log(`Count is ${count.value}`);
+ * });
+ *
+ * count.value++; // Выведет: Count is 1
+ * ```
+ *
+ * @class
+ */
+export declare class ReactiveEngine {
+    private activeEffect;
+    private isBatching;
+    private pendingEffects;
+    private services;
+    private factories;
+    private proxyCache;
+    private allEffects;
+    /**
+     * Коллбек для уведомления об изменении сигнала.
+     * Использование unknown вместо any гарантирует безопасную работу с типами prev/next.
+     */
+    onSignalChange?: (name: string, next: unknown, prev: unknown) => void;
+    /**
+     * DI: Регистрация зависимости.
+     * @template T
+     * @function provide
+     * @param {Token<T>} token - Токен для зависимости.
+     * @param {T | Factory<T>} valueOrFactory - Значение или фабрика для создания сервиса.
+     * @returns {void}
+     * @source
+     */
+    provide<T>(token: Token<T>, valueOrFactory: T | Factory<T>): void;
+    /**
+     * DI: Инъекция; Получение сервиса по токену.
+     * @template T
+     * @function inject
+     * @param {Token<T>} token - Токен для зависимости.
+     * @returns {T} - Сервис.
+     * @source
+     */
+    inject<T>(token: Token<T>): T;
+    /**
+     * Создание сигнала.
+     * @template T
+     * @function signal
+     * @param {T} initialValue - Начальное значение сигнала.
+     * @param {string | SignalOptions<T>} [optionsOrName] - Имя или опции сигнала.
+     * @returns {Signal<T>} - Сигнал.
+     * @source
+     */
+    signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T>;
+    /**
+     * Создание эффекта.
+     * @function effect
+     * @param {EffectFn} fn - Функция эффекта.
+     * @param {string} [label] - Необязательная метка для логирования и отладки.
+     * @returns {CleanupFn} - Функция для очистки эффекта.
+     * @source
+     */
+    effect(fn: EffectFn, label?: string): CleanupFn;
+    private computedCache;
+    private cleanupRegistry;
+    /**
+     * Создание вычисляемого значения.
+     * @template T
+     * @function computed
+     * @param {Function} fn - Функция для вычисления значения.
+     * @param {string} [signalName] - Имя сигнала.
+     * @returns {Computed<T>} - Вычисляемое значение с методом destroy.
+     * @source
+     */
+    computed<T>(fn: () => T, signalName?: string): Computed<T>;
+    /**
+     * Создание реактивного объекта (Proxy).
+     * @template T
+     * @function reactive
+     * @param {T} target - Целевой объект для проксирования.
+     * @param {string} [name] - Имя проксируемого объекта.
+     * @returns {T} - Реактивный объект.
+     * @source
+     */
+    reactive<T extends object>(target: T, name?: string): T;
+    /**
+     * Группировка изменений. (Оставил для обратной совместимости)
+     * @function batch
+     * @param {Function} fn - Функция для выполнения в группе.
+     * @returns {void}
+     * @source
+     */
+    batch(fn: () => void): void;
+    /**
+     * Вспомогательная функция для задержки (sleep), чувствительная к AbortSignal
+     *
+     * Вызов new DOMException('Aborted', 'AbortError') гарантирует,
+     * что ваша кастомная пауза между ретраями this.delay притворяется для движка JavaScript
+     * точно таким же нативным процессом отмены, как и fetch().
+     * Это делает реактивное ядро бесшовным и избавляет от необходимости
+     * писать кучу разных проверок под каждый тип ошибки.
+     */
+    private delay;
+    /**
+     * Создание асинхронного ресурса. Типы на входе: <T - формат ответа, S - источник изменений (сигнал либо computed-кортеж из зачений сигналов через конструкцию `.value`)>
+     *
+     * Explained 👉 {@link https://github.com/garage-13/reactive-engine/blob/main/README_EN.md#1-async-resources-dependent-on-multiple-signals}
+     *
+     * @template T, S
+     * @see {@link https://github.com/garage-13/reactive-engine/blob/main/examples/200-resource/Example200.tsx Реализация базового компонента Example200}
+     * @see {@link https://github.com/garage-13/reactive-engine/blob/main/examples/201-multi-resource/service.secondary.ts Сложный пример зависимости ресурсов через computed}
+     * @function resource
+     * @param {Function} fetcher - Асинхронная функция для загрузки данных.
+     * @param {{ value: S }} [source] - Источник данных.
+     * @param {string | ResourceOptions<T>} [optionsOrName] - Имя сигнала или объект конфигурации `{ name: string; validate: (res) => boolean | string; resetDataOnSourceChange?: boolean }`.
+     * @returns {Resource<T>} - Асинхронный ресурс.
+     *
+     * @example
+     * // Базовый вызов со строкой (обратная совместимость):
+     * const res = engine.resource(fetcher, source, 'my-resource-name');
+     *
+     * @example
+     * // Современный вызов с валидацией ответа:
+     * const res = engine.resource(fetcher, source, {
+     *   name: 'my-resource-name',
+     *   resetDataOnSourceChange: true, // true by default
+     *   responseValidate: (data) => !!data || 'Данные пусты', // Проверяйте формат в соотв. с дженериком
+     * });
+     *
+     * @example
+     * // (Экспериментальная фича)
+     * // В теле fetcher можно выкинуть ошибку в виде
+     * // `throw new Error('[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1][MESSAGE=Your msg]')`
+     * // Причина: Особенности внутренней реализации определения харакрера ошибки и необходимость делать retry (если такая опция передана)
+     * // Рекомендуем вместо этого использовать `validateBeforeFetch` в опциях при создании ресурса.
+     * const res = engine.resource(
+     *   async (counterValue, abortSignal) => {
+     *     if (counterValue === 0)
+     *       throw new Error([
+     *         '[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1]', // Иначе запустится механизм retry (напр. по причине отсутствия сети, далее в этом же примере)
+     *         `[MESSAGE=Stop for count value ${counterValue} - excepted from fetcher fn body]`,
+     *       ].join(' '))
+     *     const res = await fetch(
+     *       [
+     *         `${BASE_API_URL}/profile/search`,
+     *         '?',
+     *         [
+     *           `counter=${counterValue}`,
+     *           '_responseDelay=2000',
+     *         ].join('&')
+     *       ].join(''),
+     *       { signal: abortSignal }
+     *     )
+     *     if (!res.ok) throw new Error(`HTTP error! status: ${res.status}`)
+     *     return res.json()
+     *   },
+     *   this.counter,
+     * )
+     * @source
+     */
+    resource<T, S = void>(fetcher: (source: S, signal: AbortSignal) => Promise<T>, source?: {
+        value: S;
+    }, optionsOrName?: string | ResourceOptions<T, S>): Resource<T>;
+    /**
+     * Выполняет функцию без отслеживания зависимостей.
+     * @template T
+     * @function untrack
+     * @param {Function} fn - Функция для выполнения.
+     * @returns {T} - Результат выполнения функции.
+     * @source
+     */
+    untrack<T>(fn: () => T): T;
+    /**
+     * Безопасное выполнение функции.
+     * @private
+     * @function safeRun
+     * @param {IEffect} effect - Эффект.
+     * @param {Function} fn - Функция для выполнения.
+     * @returns {void}
+     * @source
+     */
+    private safeRun;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/core/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxE;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC;IAET;;;;;OAKG;IACH,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,KAAK,SAAS,CAAC;CAChD;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC;AACnC,MAAM,MAAM,QAAQ,GAAG,MAAM,SAAS,GAAG,IAAI,CAAC;AAC9C,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,MAAM,GAAG;IAAE,KAAI,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,CAAC;AAC5F,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,KAAK,CAAC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAElB;;;;;OAKG;IACH,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,KAAK,SAAS,CAAC;IAE/C;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;IACnD;;;;OAIG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IAEpB;;;;;OAKG;IACH,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,SAAS,CAAC;IAE9D;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;CAClC;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAsB;IAI5C,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,SAAS,CAA+C;IAGhE,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,UAAU,CAAsB;IAExC;;;OAGG;IACI,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAE7E;;;;;;;;OAQG;IACI,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAQxE;;;;;;;OAOG;IACI,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IA8BpC;;;;;;;;OAQG;IACI,MAAM,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IAgEvF;;;;;;;OAOG;IACI,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS;IA4BtD,OAAO,CAAC,aAAa,CAAmD;IAIxE,OAAO,CAAC,eAAe,CAIrB;IAEF;;;;;;;;OAQG;IACI,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC;IA8CjE;;;;;;;;OAQG;IACI,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,GAAE,MAAmB,GAAG,CAAC;IAqC1E;;;;;;OAMG;IACI,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAMlC;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK;IAoBb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwDG;IACI,QAAQ,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EACzB,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EACvD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,CAAA;KAAE,EACrB,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7C,QAAQ,CAAC,CAAC,CAAC;IAqKd;;;;;;;OAOG;IACI,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAUjC;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO;CAahB"}

package/dist/core/core.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=core.test.d.ts.map

package/dist/core/core.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.test.d.ts","sourceRoot":"","sources":["../../src/core/core.test.ts"],"names":[],"mappings":""}

package/dist/core/index.d.ts

@@ -0,0 +1,5 @@
+export * from './core';
+export * from './types';
+export * from './AbstractService';
+export * from './BaseREServiceEnhanced';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA"}

package/dist/core/types.d.ts

@@ -0,0 +1,92 @@
+export interface ResourceState<T> {
+    data: T | null;
+    loading: boolean;
+    error: any | null;
+}
+/**
+ * Функция для очистки эффекта.
+ * @typedef {() => void} CleanupFn
+ */
+/**
+ * Функция эффекта, которая может возвращать функцию очистки.
+ * @typedef {() => CleanupFn | void} EffectFn
+ */
+/**
+ * Токен для зависимости.
+ * @typedef {string | symbol | { new(engine: ReactiveEngine, ...args: any[]): T }} Token<T>
+ */
+/**
+ * Фабрика для создания сервиса.
+ * @template T
+ * @typedef {(engine: ReactiveEngine) => T} Factory<T>
+ */
+/**
+ * Интерфейс для состояния ресурса.
+ * @template T Data format
+ * @interface ResourceState<T>
+ */
+export interface ResourceState<T> {
+    /**
+     * Данные ресурса.
+     * @type {T | null}
+     */
+    data: T | null;
+    /**
+     * Состояние загрузки ресурса.
+     * @type {boolean}
+     */
+    loading: boolean;
+    /**
+     * Ошибка ресурса.
+     * @type {any | null}
+     */
+    error: any | null;
+    /** Флаг активного процесса повторных попыток после сбоя сети */
+    isRetrying: boolean;
+}
+export interface ResourceOptions<T, S> {
+    name: string;
+    /** Автоматически сбрасывать data в null при изменении source. По умолчанию: true */
+    resetDataOnSourceChange?: boolean;
+    /** Функция для валидации успешного ответа сервера перед его сохранением в стейт.
+     *
+     * Варианты возвращаемого значения:
+     * - true 👉 все ок
+     * - false 👉 в error попадет стандартный текст ошибки
+     * - string 👉 попадет в поле error
+     * */
+    responseValidate?: (responseData: T) => boolean | string;
+    /** Функция валидации входных зависимостей (source) перед запуском fetch.
+     * Если возвращает false или string (текст ошибки) — запрос и ретраи блокируются. */
+    validateBeforeFetch?: (sourceValue: S) => boolean | string;
+    /** Настройка лимита повторов retry. */
+    retryCount?: number;
+    /** Настройка задержки первого повтора retry. */
+    retryDelay?: number;
+    /** Включить экспоненциальное увеличение задержки (каждая попытка ждет в 2 раза дольше). По умолчанию: false */
+    isExponentialBackoffEnabled?: boolean;
+    /** Максимальный лимит ожидания между попытками в миллисекундах. По умолчанию: 30000 (30 секунд) */
+    maxRetryDelay?: number;
+    /** Максимальное время ожидания ответа сервера в миллисекундах. По умолчанию: отсутствует (бесконечно) */
+    timeout?: number;
+}
+/**
+ * Интерфейс для опций сигнала.
+ * @template T
+ * @interface SignalOptions<T>
+ */
+export interface SignalOptions<T> {
+    /**
+     * Имя сигнала.
+     * @type {string}
+     */
+    name?: string;
+    /**
+     * Валидатор значения сигнала.
+     * @function validate
+     * @param {T} val - Значение для валидации.
+     * @returns {boolean | string} - Результат валидации.
+     */
+    validate?: (val: T) => boolean | string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;CACnB;AAED;;;GAGG;AAEH;;;GAGG;AAEH;;;GAGG;AAEH;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B;;;OAGG;IACH,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAEf;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IAElB,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,EAAE,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;SAMK;IACL,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC;IACzD;wFACoF;IACpF,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC;IAC3D,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+GAA+G;IAC/G,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,mGAAmG;IACnG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAAC;CACzC"}

package/dist/core.cjs

@@ -0,0 +1,2 @@
+const e=require("./utils/getExtractedValues.cjs");var t=class{activeEffect=null;isBatching=!1;pendingEffects=new Set;services=new Map;factories=new Map;proxyCache=new WeakMap;allEffects=new Set;onSignalChange;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,t){let n=this,r={label:t,cleanups:new Set,run(){this.cleanups.forEach(e=>e()),this.cleanups.clear();let t=n.activeEffect;n.activeEffect=this,n.safeRun(this,()=>{let t=e();typeof t==`function`&&this.cleanups.add(t)}),n.activeEffect=t}};return this.allEffects.add(r),r.run(),()=>{r.cleanups.forEach(e=>e()),n.pendingEffects.delete(r),n.allEffects.delete(r)}}computedCache=new Map;cleanupRegistry=new FinalizationRegistry(e=>{e()});computed(e,t){if(this.computedCache.has(e)){let t=this.computedCache.get(e)?.deref();if(t)return t}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=()=>{i(),a&&n.allEffects.delete(a),n.computedCache.delete(e)},s={get value(){return r.value},subscribe:e=>r.subscribe(e),destroy(){o()}};return this.cleanupRegistry.register(s,o),this.computedCache.set(e,new WeakRef(s)),s}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()}delay(e,t){return new Promise((n,r)=>{if(t.aborted)return r(new DOMException(`Aborted`,`AbortError`));let i=setTimeout(()=>{t.removeEventListener(`abort`,a),n()},e),a=()=>{clearTimeout(i),r(new DOMException(`Aborted`,`AbortError`))};t.addEventListener(`abort`,a,{once:!0})})}resource(t,n,r){let i=r&&typeof r==`object`,a=i?r.name:r||`unnamed_resource`,o=i?r:{},s=o.resetDataOnSourceChange??!0,c=o.responseValidate,l=o.validateBeforeFetch,u=o.retryCount??0,d=o.retryDelay??1e3,f=o.isExponentialBackoffEnabled??!1,p=o.maxRetryDelay??3e4,m=o.timeout,h=this.signal({data:null,loading:!0,error:null,isRetrying:!1},a),g=async(n,r,i=!1)=>{if(r.aborted)return;if(l){let e=l(n);if(e===!1||typeof e==`string`){if(r.aborted)return;let t=typeof e==`string`?e:`Pre-fetch validation failed for resource`,n=i?null:this.untrack(()=>h.value.data);h.value={data:n,loading:!1,error:Error(t),isRetrying:!1};return}}let o=i&&s?null:this.untrack(()=>h.value.data);h.value={data:o,loading:!0,error:null,isRetrying:!1};for(let i=0;i<=u;i++){if(r.aborted)return;let o=r;try{if(m&&m>0){let e=AbortSignal.timeout(m);o=AbortSignal.any([r,e])}let e=await t(n,o);if(r.aborted)return;if(o.aborted)throw new DOMException(`The operation timed out.`,`TimeoutError`);if(c){let t=c(e);if(t===!1||typeof t==`string`){if(r.aborted)return;h.value={data:null,loading:!1,error:Error(typeof t==`string`?t:`Validation failed`),isRetrying:!1};return}}if(r.aborted)return;h.value={data:e,loading:!1,error:null,isRetrying:!1};return}catch(t){if(r.aborted||t.name===`AbortError`&&r.aborted)return;let n=t.name===`TimeoutError`||t.name===`AbortError`||t.message?.includes(`timeout`),o=e.getExtractedValues({tested:[t.message],expectedKey:`THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY`,valueType:`number`})?.[0]===`1`||!1,s=o&&e.getExtractedValues({tested:[t.message],expectedKey:`MESSAGE`,valueType:`string`})?.[0]||`Custom validation error`,c=o||t.name===`ValidationError`;if(i===u||c){if(r.aborted)return;let e=n?Error(`Request timed out after ${m}ms`,{cause:t}):o?Error(s,{cause:t}):t;h.value={data:null,loading:!1,error:e,isRetrying:!1};return}else{if(r.aborted)return;let e=f?d*2**i:d;e=Math.min(e,p);let t=Math.random()*200;e+=t,h.value={data:h.value.data,loading:!0,error:null,isRetrying:!0},console.warn(`[Resource Retry] "${a}" сбой по ${n?`таймауту`:`ошибке сети`}. Попытка ${i+1}/${u+1}...`);try{if(await this.delay(e,r),r.aborted)return}catch{return}}}}},_=null;return this.effect(()=>{let e=n?n.value:void 0,t=new AbortController;return _=t,this.untrack(()=>{g(e,t.signal,!0)}),()=>t.abort()}),{get data(){return h.value.data},get loading(){return h.value.loading},get error(){return h.value.error},get isRetrying(){return h.value.isRetrying},get value(){return h.value},refetch:()=>{_?.abort(),_=new AbortController,g(n?n.value:void 0,_.signal,!1)},subscribe:e=>h.subscribe(e)}}untrack(e){let t=this.activeEffect;this.activeEffect=null;try{return e()}finally{this.activeEffect=t}}safeRun(e,t){try{t()}catch(e){console.error(`%c[Reactive Error] %cОшибка в эффекте/computed:`,`color: white; background: red; padding: 2px 4px; border-radius: 3px;`,`font-weight: bold;`,e)}}};exports.ReactiveEngine=t;
+//# sourceMappingURL=core.cjs.map