@pravosleva/reactive-engine 1.7.0-beta → 1.8.0-beta

package/dist/core/core.d.ts

@@ -1,426 +1,165 @@
-import { ResourceOptions, ResourceState, SignalOptions } from './types';
+import { ResourceOptions, SignalOptions, Signal, Computed, IEffect, Token, Factory, EngineLoggerOptions, LogDetailMap } from './types';
 /**
- * Интерфейс для сигнала.
- * @template T
- * @interface Signal<T>
+ * ⚡ 1. LIGHTWEIGHT CORE ENGINE (МЕНЬШЕ 1 КБ)
+ * Чистый синхронный Push/Pull граф реактивности. Без логов, Proxy и DI.
+ * Идеален для матрицы тестов johnsoncodehk на 100% Passed.
  */
-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}
+export declare class ReactiveEngineCore {
+    protected frameworkPrefix: string;
+    protected activeConsumer: {
+        id: number;
+        cleanups: Set<() => void>;
+        markDirty: () => void;
+    } | null;
+    protected subscriberId: number;
+    protected batchDepth: number;
+    protected pendingEffects: Set<IEffect>;
+    protected allEffects: Set<IEffect>;
+    computedCache: Map<Function, WeakRef<Computed<unknown>>>;
+    /**
+     * СИНХРОННО-ЛЕНИВОЕ ВЫЧИСЛЯЕМОЕ СВОЙСТВО (ЧЕСТНЫЙ ГИБРИДНЫЙ PUSH/PULL)
      */
-    readonly value: T;
+    computed<T>(fn: () => T, signalName?: string): Computed<T>;
     /**
-     * Подписка на изменение вычисляемого значения.
-     * @function subscribe
-     * @param {Function} cb - Коллбек функция для обработки изменения.
-     * @returns {CleanupFn} - Функция для очистки подписки.
+     * СИНХРОННЫЙ ПЛАНИРОВЩИК ЭФФЕКТОВ (EFFECT)
+     *
+     * @param {() => void | (() => void)} fn - Функция эффекта. Может возвращать деструктор (cleanup).
+     * @param {string} [label] - Необязательная метка для отладки и трассировки.
+     * @returns {() => void} - Функция принудительной отписки (dispose), уничтожающая связи эффекта.
      */
-    subscribe: (cb: (val: T) => void) => CleanupFn;
+    effect(fn: () => void | (() => void), label?: string): () => void;
     /**
-     * Принудительное уничтожение вычисляемого значения и его эффекта для предотвращения утечек памяти.
+     * СИНХРОННЫЙ АТОМАРНЫЙ СИГНАЛ (БЕЗРЕКУРСИОННЫЙ)
      */
-    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> {
+    signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T>;
     /**
-     * Перезагрузка ресурса.
-     * @function refetch
-     * @returns {void}
+     * МЕНЕДЖЕР СИНХРОННЫХ ТРАНЗАКЦИЙ (BATCH)
      */
-    refetch: () => void;
+    batch(fn: () => void): void;
     /**
-     * Подписка на изменение состояния ресурса.
-     * @function subscribe
-     * @param {Function} cb - Коллбек функция для обработки изменения.
-     * @returns {CleanupFn} - Функция для очистки подписки.
+     * ВНУТРЕННИЙ СИНХРОННЫЙ ПРОГОН ОЧЕРЕДИ ЭФФЕКТОВ
      */
-    subscribe: (cb: (val: ResourceState<T>) => void) => CleanupFn;
+    protected flushEffects(): void;
     /**
-     * Только читаемое состояние ресурса.
-     * @type {ResourceState<T>}
+     * ВЫПОЛНЕНИЕ ФУНКЦИИ БЕЗ ТРЕКИНГА ЗАВИСИМОСТЕЙ
      */
-    readonly value: ResourceState<T>;
-}
-export interface EngineLoggerOptions {
-    /** Наименование инстанса движка */
-    instanceName?: string;
-    /** Включить детальное логгирование в консоль */
-    isEnabled: boolean;
-    /** Выводить время выполнения с точностью до микросекунд (performance.now) */
-    traceTime?: boolean;
-    /** Фильтровать логи по имени сигнала (поддерживает RegExp или строку) */
-    filter?: RegExp | string;
-    /** Показывать внутренние системные логи ядра (сигналы кэша, эффекты computed) */
-    isCoreOptimizationDebugEnabled?: boolean;
-}
-export interface ReactiveEngineOptions {
-    logger?: EngineLoggerOptions;
-}
-export interface SignalLogDetail {
-    from: unknown;
-    to: unknown;
-    subscribersCount: number;
-    subscribers: string[];
-}
-export interface ComputedLogDetail {
-    value: unknown;
-    duration: string;
-}
-export interface EffectLogDetail {
-    triggeredBy: string;
-    executionTime?: string;
-}
-export interface BatchLogDetail {
-    transactionSize: number;
-    totalEffectsRun: number;
-}
-export interface ResourceLogDetail {
-    /** Текущий статус загрузки */
-    loading: boolean;
-    /** Данные ответа (если есть) */
-    data: unknown;
-    /** Объект ошибки (если запрос упал) */
-    error: Error | null;
-    /** Была ли это повторная попытка (Retry) */
-    isRetrying?: boolean;
-}
-export interface ReactiveDetail {
-}
-export interface LogDetailMap {
-    signal: SignalLogDetail;
-    computed: ComputedLogDetail;
-    effect: EffectLogDetail;
-    batch: BatchLogDetail;
-    resource: ResourceLogDetail;
-    reactive: ReactiveDetail;
+    untrack<T>(fn: () => T): T;
 }
 /**
- * Класс `ReactiveEngine` представляет собой реактивную систему, которая позволяет создавать и управлять реактивными объектами,
- * сигналами, эффектами, асинхронными ресурсами и другими реактивными примитивами. Реактивные механизмы облегчают разработку
- * сложных пользовательских интерфейсов и приложений, автоматически отслеживая зависимости между данными и реактивно обновляя UI.
- *
- * Основные возможности `ReactiveEngine` включают:
- * - **Сигналы (Signals)**: Реактивные переменные с поддержкой подписки на изменения.
- * - **Эффекты (Effects)**: Автоматические функции, которые выполняются при изменении зависимых сигналов.
- * - **Ресурсы (Resources)**: Асинхронные ресурсы с поддержкой повторных попыток и валидации.
- * - **Прокси-объекты (Proxy Objects)**: Реактивное обертывание объектов для отслеживания изменений свойств.
- * - **Интеграция с React**: Удобные методы для интеграции реактивного ядра с компонентами React.
- *
- * Пример использования:
- *
- * ```javascript
- * const engine = new ReactiveEngine();
- * const count = engine.signal(0);
+ * 🏢 ENTERPRISE REACTIVE ENGINE (ПОЛНАЯ ВЕРСИЯ)
  *
- * engine.effect(() => {
- *   console.log(`Count is ${count.value}`);
- * });
- *
- * count.value++; // Выведет: Count is 1
- * ```
- *
- * @class
+ * Наследует и расширяет легкое ядро ReactiveEngineCore.
+ * Включает: Глубокий reactive(), асинхронные ресурсы (resource), DI-контейнер и систему логирования.
  */
-export declare class ReactiveEngine {
-    protected frameworkPrefix: string;
-    private activeEffect;
-    private isBatching;
-    private pendingEffects;
+export declare class ReactiveEngine extends ReactiveEngineCore {
     private services;
     private factories;
     private proxyCache;
-    private allEffects;
     private loggerOptions?;
     private pendingLogQueue;
-    private lastTransactionDuration;
     private signalMutationCounts;
     private lastComputedDurations;
     private effectExecutionCounts;
     private batchTickCounts;
-    constructor(options?: ReactiveEngineOptions);
-    /**
-     * Системный метод вывода форматированных логов в консоль.
-     * Автоматически подстраивает тип входящего аргумента `detail` под выбранный литерал `type`.
-     *
-     * Дополнительно агрегирует рантйам-статистику по всей стейт-машине приложения:
-     * - **`signal`:** Отслеживает счетчик частоты изменений (шума) для детекции паразитных циклов мутаций.
-     * - **`computed`:** Сравнивает текущую длительность ленивого вычисления с прошлым, подсвечивая тренд производительности.
-     * - **`effect`:** Подсчитывает общее количество ререндеров/вызовов побочных эффектов.
-     * - **`batch`:** Фиксирует порядковый номер выполненного шедулером пакета микрозадач.
-     *
-     * @template K - Литеральный тип лога из карты `LogDetailMap`
-     * @param {K} type - Категория логгируемого события ('signal' | 'computed' | 'effect' | 'batch')
-     * @param {string} name - Уникальное имя реактивного элемента (или label эффекта)
-     * @param {LogDetailMap[K]} detail - Строго типизированный объект с контекстными данными события
-     * @returns {void}
-     */
-    log<K extends keyof LogDetailMap>(type: K, name: string, detail: LogDetailMap[K]): void;
+    private lastTransactionDuration;
+    constructor(options?: {
+        logger?: EngineLoggerOptions;
+    });
     /**
-     * Коллбек для уведомления об изменении сигнала.
-     * Использование unknown вместо any гарантирует безопасную работу с типами prev/next.
+     * ГЛУБОКИЙ РЕАКТИВНЫЙ PROXY-ОБЪЕКТ (СИНХРОННЫЙ PUSH/PULL С МИКРОБАЧИНГОМ ДЛЯ ФРЕЙМВОРКОВ)
      */
-    onSignalChange?: (name: string, next: unknown, prev: unknown) => void;
+    reactive<T extends object>(target: T, name?: string): T;
     /**
-     * DI: Регистрация зависимости.
-     * @template T
-     * @function provide
-     * @param {Token<T>} token - Токен для зависимости.
-     * @param {T | Factory<T>} valueOrFactory - Значение или фабрика для создания сервиса.
-     * @returns {void}
-     * @source
+     * DI-КОНТЕЙНЕР: РЕГИСТРАЦИЯ ЗАВИСИМОСТИ
      */
     provide<T>(token: Token<T>, valueOrFactory: T | Factory<T>): void;
     /**
-     * DI: Инъекция; Получение сервиса по токену.
-     * @template T
-     * @function inject
-     * @param {Token<T>} token - Токен для зависимости.
-     * @returns {T} - Сервис.
-     * @source
+     * DI-КОНТЕЙНЕР: ИНЪЕКЦИЯ (ПОЛУЧЕНИЕ СЕРВИСА ПО ТОКЕНУ)
      */
     inject<T>(token: Token<T>): T;
+    queueLog(type: string, name: string, detail: any): void;
+    flushLogs(): void;
     /**
-     * Накапливает логи об изменениях в буфер текущей микрозадачи
+     * АСИНХРОННЫЙ РЕСУРС (ПУЛЕНЕПРОБИВАЕМЫЙ СИНХРОННЫЙ PUSH/PULL)
      */
-    queueLog(type: keyof LogDetailMap, name: string, detail: any): void;
+    resource<T, S = void>(fetcher: (source: S, signal: AbortSignal) => Promise<T>, source?: {
+        value: S;
+    }, optionsOrName?: string | ResourceOptions<T, S>): any;
+}
+/**
+ * 🤖 AUTOMATIC BATCHING REACTIVE ENGINE
+ *
+ * Расширение Enterprise-ядра, реализующее аппаратный автобатчинг микрозадач.
+ * Автоматически склеивает множественные каскадные мутации стейта (включая асинхронные цепочки после await)
+ * и выполняет побочные эффекты ровно 1 раз на выходе в Event Loop без ручного вызова engine.batch().
+ */
+export declare class ReactiveEngineAutomatic extends ReactiveEngine {
+    private isFlushScheduled;
+    constructor(options?: {
+        logger?: EngineLoggerOptions;
+    });
     /**
-     * Синхронно обрабатывает и выводит в консоль накопленный буфер логов
-     * для текущего тика микрозадачи (реактивной транзакции).
-     *
-     * Метод автоматически вызывается планировщиком ядра (`queueMicrotask`) непосредственно
-     * перед запуском каскада отложенных эффектов фреймворков и ререндеров интерфейса.
-     *
-     * ### Особенности рантайм-логики:
-     * 1. **Атомарный батчинг:** Предотвращает лавинообразный спам в консоли разработчика при
-     *    множественных синхронных мутациях сигналов. Все тики склеиваются в единую мастер-группу.
-     * 2. **Безопасная фильтрация:** Изолирует логи по маске, переданной в `loggerOptions.filter`.
-     *    Если после фильтрации очередь оказывается пустой, метод бережно зачищает буфер и
-     *    возвращает управление шедулеру ядра, не блокируя выполнение `pendingEffects`.
-     * 3. **Профайлинг производительности (Pull Duration):** При включенном `traceTime` рассчитывает
-     *    чистую длительность калькуляции и фильтрации транзакции графа в миллисекундах
-     *    с точностью до микросекунд (`performance.now`), помогая находить узкие места.
-     *
-     * @function flushLogs
-     * @returns {void} Метод не возвращает значения, а только очищает внутренний буфер `pendingLogQueue`.
+     * ПЕРЕОПРЕДЕЛЕНИЕ РЕАКТИВНОГО PROXY ДЛЯ АВТОМАТИЧЕСКОГО ДВИЖКА
+     * Внедряет аппаратный микробатчинг (queueMicrotask) прямо в мост __subscribe фреймворков,
+     * защищая Vue 3 triggerRef() от каскадного дребезга кадров рендеринга.
      */
-    flushLogs(): void;
+    reactive<T extends object>(target: T, name?: string): 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>;
+    protected flushEffects(): void;
     /**
-     * Создание эффекта.
-     * @function effect
-     * @param {EffectFn} fn - Функция эффекта.
-     * @param {string} [label] - Необязательная метка для логирования и отладки.
-     * @returns {CleanupFn} - Функция для очистки эффекта.
-     * @source
+     * ПЕРЕОПРЕДЕЛЕНИЕ ПЛАНИРОВЩИКА ЭФФЕКТОВ (АСИНХРОННЫЙ АВТОБАТЧИНГ ПРИМИТИВОВ)
      */
-    effect(fn: EffectFn, label?: string): CleanupFn;
-    private computedCache;
-    private cleanupRegistry;
+    effect(fn: () => void | (() => void), label?: string): () => void;
+}
+interface ReactiveEngineOptions {
+    logger?: EngineLoggerOptions;
+}
+/**
+ * 📊 AUTOMATIC BATCHING HARD-LOGGING REACTIVE ENGINE
+ *
+ * Премиальное Enterprise-расширение автоматического ядра, сочетающее аппаратный асинхронный
+ * автобатчинг микрозадач (queueMicrotask) и тотальный рантайм-мониторинг всей стейт-машины.
+ */
+export declare class ReactiveEngineAutomaticHard extends ReactiveEngineAutomatic {
+    private autoLogQueue;
+    private isHardFlushScheduled;
+    constructor(options?: ReactiveEngineOptions);
     /**
-     * Создание вычисляемого значения.
-     * @template T
-     * @function computed
-     * @param {Function} fn - Функция для вычисления значения.
-     * @param {string} [signalName] - Имя сигнала.
-     * @returns {Computed<T>} - Вычисляемое значение с методом destroy.
-     * @source
+     * ПЕРЕХВАТ И ПЕРЕНАПРАВЛЕНИЕ ЛОГОВ В ЛОКАЛЬНЫЙ АСИНХРОННЫЙ БУФЕР
      */
-    computed<T>(fn: () => T, signalName?: string): Computed<T>;
+    queueLog<K extends keyof LogDetailMap>(type: K, name: string, detail: LogDetailMap[K]): void;
     /**
-     * Создает глубокий реактивный объект (Proxy) на основе переданного целевого объекта или массива.
-     *
-     * В отличие от атомарных сигналов (`signal`), требующих ручного обращения через `.value`,
-     * метод `reactive` позволяет работать со сложными разветвленными структурами данных нативно,
-     * используя стандартный синтаксис JavaScript для чтения и прямой мутации свойств.
-     *
-     * ### Архитектурные особенности рантайма:
-     * 1. **Гранулярность подписок (Property-level Subscriptions):** Зависимости графа ядра трекаются
-     *    не для всего объекта целиком, а строго для конкретных ключей (`prop`). Если эффект или
-     *    компонент читает свойство `user.name`, он подписывается исключительно на этот ключ.
-     *    Изменение свойства `user.age` не вызовет его повторного выполнения.
-     * 2. **Глубокое проксирование (Deep Reactivity):** При обращении к вложенным объектам или массивам,
-     *    метод динамически и лениво оборачивает их в Proxy-структуры, автоматически формируя
-     *    понятные строковые пути для подсистемы логирования (например, `user.meta.role`).
-     * 3. **Иммунизация кэша (Proxy Mirroring Cache):** Все созданные Proxy зеркалируются во внутреннем
-     *    реестре `proxyCache`. Повторный вызов метода для одного и того же объекта вернет
-     *    уже существующий Proxy, предотвращая утечки памяти и дублирование подписок.
-     *
-     * ### Применение в оптимизации больших форм:
-     * Идеально подходит для тяжелых интерфейсов (динамические таблицы, анкеты из сотен полей),
-     * так как прямая мутация конкретного инпута изолирует поток изменений и избавляет от необходимости
-     * иммутабельного копирования всего стейта формы через оператор расширения (`...spread`).
-     *
-     * @template T - Тип целевого объекта, расширяющий базовый интерфейс `object`.
-     * @function reactive
-     * @param {T} target - Исходный объект или массив JavaScript для проксирования.
-     * @param {string} [name='reactive'] - Уникальное базовое имя объекта для трассировки и фильтрации в логгере.
-     * @returns {T} Глубоко проксированный реактивный объект типа `T`.
-     *
-     * @example
-     * ```typescript
-     * // 1. Инициализация в сервисе бизнес-логики:
-     * public form = this.engine.reactive({
-     *   user: { name: 'Иван', age: 25 }
-     * }, 'profile-form');
-     *
-     * // 2. Прямая мутация в экшене (Proxy перехватит тик и запустит атомарный батчинг):
-     * public updateAge() {
-     *   this.form.user.age += 1; // Автоматический лог: SIGNAL [profile-form.user.age]
-     * }
-     *
-     * // 3. Мост подписки для UI-компонентов:
-     * public uiBridge = this.engine.computed(() => ({
-     *   name: this.form.user.name,
-     *   age: this.form.user.age
-     * }));
-     * ```
+     * АВТОНОМНЫЙ МЕТОД ФОРМАТИРОВАНИЯ И ВЫВОДА ENTERPRISE-ЛОГОВ В КОНСОЛЬ
      */
-    reactive<T extends object>(target: T, name?: string): T;
+    flushLogs(): void;
     /**
-     * Группировка изменений. (Оставил для обратной совместимости)
-     * @function batch
-     * @param {Function} fn - Функция для выполнения в группе.
-     * @returns {void}
-     * @source
+     * АТОМАРНЫЙ АСИНХРОННЫЙ СБРОС ЛОГОВ СОВМЕСТНО С ЭФФЕКТАМИ
      */
-    batch(fn: () => void): void;
+    protected flushEffects(): void;
     /**
-     * Вспомогательная функция для задержки (sleep), чувствительная к AbortSignal
-     *
-     * Вызов new DOMException('Aborted', 'AbortError') гарантирует,
-     * что ваша кастомная пауза между ретраями this.delay притворяется для движка JavaScript
-     * точно таким же нативным процессом отмены, как и fetch().
-     * Это делает реактивное ядро бесшовным и избавляет от необходимости
-     * писать кучу разных проверок под каждый тип ошибки.
+     * ПЕРЕОПРЕДЕЛЕНИЕ ПЛАНИРОВЩИКА ЭФФЕКТОВ (С ПОЛНЫМ ЛОГИРОВАНИЕМ ДЛИТЕЛЬНОСТИ И ВЫЗОВОВ)
      */
-    private delay;
+    effect(fn: () => void | (() => void), label?: string): () => void;
     /**
-     * Создание асинхронного ресурса. Типы на входе: <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
+     * АСИНХРОННЫЙ РЕСУРС (ИНТЕГРИРОВАННЫЙ В HARD-ЛОГГЕР)
      */
     resource<T, S = void>(fetcher: (source: S, signal: AbortSignal) => Promise<T>, source?: {
         value: S;
-    }, optionsOrName?: string | ResourceOptions<T, S>): Resource<T>;
+    }, optionsOrName?: string | ResourceOptions<T, S>): any;
     /**
-     * Выполняет функцию без отслеживания зависимостей.
-     * @template T
-     * @function untrack
-     * @param {Function} fn - Функция для выполнения.
-     * @returns {T} - Результат выполнения функции.
-     * @source
+     * ПЕРЕОПРЕДЕЛЕНИЕ РЕАКТИВНОГО PROXY ДЛЯ ХАРД-ЛОГГЕРА
      */
-    untrack<T>(fn: () => T): T;
+    reactive<T extends object>(target: T, name?: string): T;
     /**
-     * Безопасное выполнение функции.
-     * @private
-     * @function safeRun
-     * @param {IEffect} effect - Эффект.
-     * @param {Function} fn - Функция для выполнения.
-     * @returns {void}
-     * @source
+     * СИНХРОННЫЙ АТОМАРНЫЙ СИГНАЛ (ИНТЕГРИРОВАННЫЙ В HARD-ЛОГГЕР)
      */
-    private safeRun;
+    signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T>;
+    /**
+     * СИНХРОННО-ЛЕНИВОЕ ВЫЧИСЛЯЕМОЕ СВОЙСТВО (С ЗАМЕРОМ ТАЙМИНГОВ PULL И БЕЗ ANY)
+     */
+    computed<T>(fn: () => T, signalName?: string): Computed<T>;
 }
+export {};
 //# sourceMappingURL=core.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core/core.ts"],"names":[],"mappings":"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"}