@pravosleva/reactive-engine 1.5.15 → 1.6.1

package/dist/core.mjs

@@ -215,15 +215,16 @@ var t = class {
 			label: t,
 			cleanups: /* @__PURE__ */ new Set(),
 			run() {
-				this.cleanups.forEach((e) => e()), this.cleanups.clear();
-				let t = n.activeEffect;
+				let t = Array.from(this.cleanups);
+				this.cleanups.clear(), t.forEach((e) => e());
+				let i = n.activeEffect;
 				n.activeEffect = this;
-				let i = performance.now();
+				let a = performance.now();
 				n.safeRun(this, () => {
 					let t = e();
 					typeof t == "function" && this.cleanups.add(t);
-				}), n.activeEffect = t;
-				let a = performance.now() - i;
+				}), n.activeEffect = i;
+				let o = performance.now() - a;
 				if (!r && n.loggerOptions?.isEnabled) {
 					let e = n.loggerOptions.filter;
 					(!e || e instanceof RegExp && this.label && e.test(this.label)) && typeof n.queueLog == "function" && n.queueLog("effect", this.label || "unnamed-efect-0", {
@@ -231,8 +232,8 @@ var t = class {
 						type: "effect",
 						detail: {
 							status: "stable",
-							duration: `${a.toFixed(3)}ms`,
-							timestamp: i
+							duration: `${o.toFixed(3)}ms`,
+							timestamp: a
 						}
 					});
 				}
@@ -276,18 +277,36 @@ var t = class {
 		if (this.proxyCache.has(e)) return this.proxyCache.get(e);
 		let n = this, r = /* @__PURE__ */ new Map(), i = new Proxy(e, {
 			get(e, i, a) {
-				n.activeEffect && (r.has(i) || r.set(i, /* @__PURE__ */ new Set()), r.get(i).add(n.activeEffect));
+				if (n.activeEffect) {
+					let e = n.activeEffect;
+					r.has(i) || r.set(i, /* @__PURE__ */ new Set());
+					let t = r.get(i);
+					t.has(e) || (t.add(e), e.cleanups.add(() => {
+						t.delete(e);
+					}));
+				}
 				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()), n.queueLog?.("reactive", `${t}.${String(i)}`, {
-					action: "set",
-					property: String(i),
-					oldValue: s,
-					newValue: a
-				})), !0;
+				if (s === a) return !0;
+				if (s !== a) {
+					Reflect.set(e, i, a, o), n.onSignalChange?.(`${t}.${String(i)}`, a, s);
+					let c = r.get(i);
+					(c ? Array.from(c) : []).forEach((e) => {
+						n.isBatching ? n.pendingEffects.add(e) : (n.pendingEffects.add(e), n.isBatching || (n.isBatching = !0, queueMicrotask(() => {
+							for (let e of n.pendingEffects) n.pendingEffects.delete(e), e.run();
+							n.isBatching = !1, n.flushLogs?.();
+						})));
+					}), n.queueLog?.("reactive", `${t}.${String(i)}`, {
+						action: "set",
+						property: String(i),
+						oldValue: s,
+						newValue: a
+					});
+				}
+				return !0;
 			}
 		});
 		return this.proxyCache.set(e, i), i;

package/dist/core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"core.mjs","names":[],"sources":["../src/core/core.ts"],"sourcesContent":["import { ResourceOptions, ResourceState, SignalOptions } from './types'\nimport { getExtractedValues } from '../utils'\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\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\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 * @interface IEffect\n */\nexport interface IEffect {\n  run: () => void;\n  label?: string;\n  cleanups: Set<CleanupFn>;\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\nexport interface EngineLoggerOptions {\n  /** Наименование инстанса движка */\n  instanceName?: string;\n  /** Включить детальное логгирование в консоль */\n  isEnabled: boolean;\n  /** Выводить время выполнения с точностью до микросекунд (performance.now) */\n  traceTime?: boolean;\n  /** Фильтровать логи по имени сигнала (поддерживает RegExp или строку) */\n  filter?: RegExp | string;\n  /** Показывать внутренние системные логи ядра (сигналы кэша, эффекты computed) */\n  isCoreOptimizationDebugEnabled?: boolean;\n}\n\nexport interface ReactiveEngineOptions {\n  logger?: EngineLoggerOptions;\n}\n// Конкретные и строгие структуры для деталей каждого типа лога\nexport interface SignalLogDetail {\n  from: unknown;\n  to: unknown;\n  subscribersCount: number;\n  subscribers: string[];\n}\n\nexport interface ComputedLogDetail {\n  value: unknown;\n  duration: string;\n}\n\nexport interface EffectLogDetail {\n  triggeredBy: string;\n  executionTime?: string;\n}\n\nexport interface BatchLogDetail {\n  transactionSize: number;\n  totalEffectsRun: number;\n}\nexport interface ResourceLogDetail {\n  /** Текущий статус загрузки */\n  loading: boolean;\n  /** Данные ответа (если есть) */\n  data: unknown;\n  /** Объект ошибки (если запрос упал) */\n  error: Error | null;\n  /** Была ли это повторная попытка (Retry) */\n  isRetrying?: boolean;\n}\nexport interface ReactiveDetail {}\n\n// Маппинг: связываем строковый литерал типа лога с его интерфейсом деталей\nexport interface LogDetailMap {\n  signal: SignalLogDetail;\n  computed: ComputedLogDetail;\n  effect: EffectLogDetail;\n  batch: BatchLogDetail;\n  resource: ResourceLogDetail;\n  reactive: ReactiveDetail;\n}\n\n\n// --- ЯДРО ---\n/**\n * Класс `ReactiveEngine` представляет собой реактивную систему, которая позволяет создавать и управлять реактивными объектами,\n * сигналами, эффектами, асинхронными ресурсами и другими реактивными примитивами. Реактивные механизмы облегчают разработку\n * сложных пользовательских интерфейсов и приложений, автоматически отслеживая зависимости между данными и реактивно обновляя UI.\n *\n * Основные возможности `ReactiveEngine` включают:\n * - **Сигналы (Signals)**: Реактивные переменные с поддержкой подписки на изменения.\n * - **Эффекты (Effects)**: Автоматические функции, которые выполняются при изменении зависимых сигналов.\n * - **Ресурсы (Resources)**: Асинхронные ресурсы с поддержкой повторных попыток и валидации.\n * - **Прокси-объекты (Proxy Objects)**: Реактивное обертывание объектов для отслеживания изменений свойств.\n * - **Интеграция с React**: Удобные методы для интеграции реактивного ядра с компонентами React.\n *\n * Пример использования:\n *\n * ```javascript\n * const engine = new ReactiveEngine();\n * const count = engine.signal(0);\n *\n * engine.effect(() => {\n *   console.log(`Count is ${count.value}`);\n * });\n *\n * count.value++; // Выведет: Count is 1\n * ```\n *\n * @class\n */\nexport class ReactiveEngine {\n  protected frameworkPrefix = 'core'\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  // Logger\n  private loggerOptions?: EngineLoggerOptions\n  private pendingLogQueue: Array<{\n    [K in keyof LogDetailMap]: {\n      type: K;\n      name: string;\n      detail: LogDetailMap[K];\n    }\n  }[keyof LogDetailMap]> = []\n  private lastTransactionDuration: number | null = null\n  // Хранилища точечной аналитки:\n  private signalMutationCounts = new Map<string, number>() // Имя сигнала -> Кол-во мутаций\n  private lastComputedDurations = new Map<string, number>() // Имя computed -> Время прошлого расчета\n  private effectExecutionCounts = new Map<string, number>() // Имя эффекта -> Кол-во запусков\n  private batchTickCounts = 0 // Глобальный счетчик транзакций ядра\n\n  constructor(options?: ReactiveEngineOptions) {\n    this.loggerOptions = options?.logger\n  }\n\n  /**\n   * Системный метод вывода форматированных логов в консоль.\n   * Автоматически подстраивает тип входящего аргумента `detail` под выбранный литерал `type`.\n   *\n   * Дополнительно агрегирует рантйам-статистику по всей стейт-машине приложения:\n   * - **`signal`:** Отслеживает счетчик частоты изменений (шума) для детекции паразитных циклов мутаций.\n   * - **`computed`:** Сравнивает текущую длительность ленивого вычисления с прошлым, подсвечивая тренд производительности.\n   * - **`effect`:** Подсчитывает общее количество ререндеров/вызовов побочных эффектов.\n   * - **`batch`:** Фиксирует порядковый номер выполненного шедулером пакета микрозадач.\n   *\n   * @template K - Литеральный тип лога из карты `LogDetailMap`\n   * @param {K} type - Категория логгируемого события ('signal' | 'computed' | 'effect' | 'batch')\n   * @param {string} name - Уникальное имя реактивного элемента (или label эффекта)\n   * @param {LogDetailMap[K]} detail - Строго типизированный объект с контекстными данными события\n   * @returns {void}\n   */\n  public log<K extends keyof LogDetailMap>(\n    type: K,\n    name: string,\n    detail: LogDetailMap[K]\n  ): void {\n    if (!this.loggerOptions?.isEnabled) return\n\n    if (!this.loggerOptions?.isCoreOptimizationDebugEnabled) {\n      // Детектим внутренний сигнал кэша\n      const isInternalSignal = getExtractedValues({\n        expectedKey: 'CORE_INTERNAL_SIGNAL', tested: [name], valueType: 'number'\n      })?.[0] === '1'\n      // Детектим внутренний эффект оптимизации компута по маркеру в имени\n      const isInternalEffect = getExtractedValues({\n        expectedKey: 'CORE_INTERNAL_EFFECT', tested: [name], valueType: 'number'\n      })?.[0] === '1'\n      // Если это сервисный лог, а отладка оптимизации выключена — тихо выходим!\n      if (isInternalSignal || isInternalEffect) return\n    }\n\n    // Фильтрацию производим уже по очищенному имени\n    if (this.loggerOptions.filter) {\n      const regex = this.loggerOptions.filter instanceof RegExp\n        ? this.loggerOptions.filter\n        : new RegExp(this.loggerOptions.filter.replace(/^\\/|\\/$/g, ''))\n      if (!regex.test(name)) return\n    }\n\n    const badgeColors: Record<keyof LogDetailMap, string> = {\n      signal: 'background: #007acc; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      computed: 'background: #42b883; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      effect: 'background: #e01e5a; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      batch: 'background: #7952b3; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      resource: 'background: #d97706; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      reactive: 'background: #007acc; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n    }\n\n    let subBadgeText = ''\n    let subBadgeStyle = 'color: #aaa; font-weight: normal;'\n\n    switch (type) {\n    case 'signal': {\n      // Проверяем, является ли сигнал внутренним служебным сигналом ядра\n      const isInternal = getExtractedValues({\n        tested: [name],\n        expectedKey: 'CORE_INTERNAL_SIGNAL',\n        valueType: 'number'\n      })?.[0] === '1'\n\n      // (?) Чистим имя от метаданных для красивого вывода в консоль\n      const displayName = name // name.replace(/\\[CORE_INTERNAL_SIGNAL=1\\]:/g, '');\n\n      const currentCount = (this.signalMutationCounts.get(displayName) || 0) + 1\n      this.signalMutationCounts.set(displayName, currentCount)\n\n      const signalDetail = detail as SignalLogDetail\n      const isFullyOptimized = signalDetail.subscribers && signalDetail.subscribers.length > 0\n        ? signalDetail.subscribers.every((sub) => {\n          if (!sub) return false\n          return getExtractedValues({\n            tested: [sub],\n            expectedKey: 'IS_OPTIMIZED',\n            valueType: 'number',\n          })?.[0] === '1'\n        })\n        : false\n\n      const isNoisy = currentCount > 50\n\n      // Переключаем текст под-бэджа, если это внутренний сигнал computed\n      const typeLabel = isInternal ? 'COMPUTED_INTERNAL' : 'SIGNAL'\n\n      subBadgeText = ` 🔄 Изменений ${isInternal ? 'кэша' : 'сигнала'}: ${currentCount}${isNoisy ? ' ⚠️ (high noise — обнаружен дребезг/спам значений!)' : ''}`\n\n      if (isNoisy) {\n        subBadgeStyle = 'color: orange; font-weight: bold;'\n        if (!isFullyOptimized) {\n          (detail as any).__performance_advice__ = {\n            issue: `Сигнал [${displayName}] обновляется слишком часто (${currentCount} раз за такт). Это приводит к избыточным ререндерам UI.`,\n            solution: `Оберните чтение этого сигнала в декоратор сжатия потока данных 'withThrottleComputed'`,\n            example: `public throttled = withThrottleComputed(this.engine, () => this.yourSignalName.value, { limit: 300 });`\n          }\n        }\n      }\n\n      // Переопределяем параметры вывода console.groupCollapsed локально\n      console.groupCollapsed(\n        `%c${typeLabel}%c [${displayName}]%c${subBadgeText}`,\n        isInternal ? 'background: #42b883; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;' : badgeColors[type],\n        'color: #aaa; font-weight: bold;',\n        subBadgeStyle\n      )\n      console.log('Данные (Payload):', detail)\n      if (this.loggerOptions.traceTime && typeof performance !== 'undefined') {\n        console.log('Тайминг рантайма:', `${performance.now().toFixed(2)} ms`)\n      }\n      console.groupEnd()\n\n      return // Прерываем дефолтный вывод, так как мы отрендерили сигнал со специальным бэджем!\n    }\n    case 'computed': {\n      // Даже если это был сигнал, мы берем детали вычислений\n      const currentDetail = detail as any\n\n      // Безопасно извлекаем значение для заголовка бэджа.\n      // Читаем .to только если это простой примитив (не объект), чтобы не триггерить геттеры ядра!\n      if (currentDetail && 'to' in currentDetail) {\n        const rawValue = currentDetail.to\n        const displayValue = typeof rawValue === 'object' && rawValue !== null\n          ? '{...}' // Для объектов выводим заглушку, защищая геттеры от JSON.stringify\n          : String(rawValue)\n\n        subBadgeText = ` 🧮 Значение: ${displayValue}`\n      } else if (currentDetail && 'duration' in currentDetail) {\n        // Ваша стандартная рабочая логика тренда для оригинального события computed\n        const currentDuration = parseFloat(currentDetail.duration)\n        if (!isNaN(currentDuration)) {\n          const lastDuration = this.lastComputedDurations.get(name)\n          if (lastDuration !== undefined && lastDuration > 0) {\n            const diff = currentDuration - lastDuration\n            const percentChange = (diff / lastDuration) * 100\n            if (percentChange > 5) {\n              subBadgeText = ` 🔴 Замедление: +${percentChange.toFixed(1)}% (${currentDetail.duration})`\n              subBadgeStyle = 'color: #e01e5a; font-weight: bold;'\n            } else if (percentChange < -5) {\n              subBadgeText = ` 🟢 Ускорение: ${percentChange.toFixed(1)}% (${currentDetail.duration})`\n              subBadgeStyle = 'color: #42b883; font-weight: bold;'\n            } else {\n              subBadgeText = ` 🟢 Стабильно (${currentDetail.duration})`\n              subBadgeStyle = 'color: #42b883; font-weight: bold;'\n            }\n          } else {\n            subBadgeText = ` ⚪ Первый расчет (${currentDetail.duration})`\n          }\n          this.lastComputedDurations.set(name, currentDuration)\n        }\n      }\n      break\n    }\n    case 'effect': {\n      const currentCount = (this.effectExecutionCounts.get(name) || 0) + 1\n      this.effectExecutionCounts.set(name, currentCount)\n\n      const isOverTriggered = currentCount > 30\n      const currentDetail = detail as any\n      const durationStr = currentDetail && 'duration' in currentDetail ? ` (${currentDetail.duration})` : ''\n\n      // Выводим статус стабильности и длительность в заголовок бэджа по аналогии с computed\n      subBadgeText = ` 🟢 Стабильно${durationStr} | 🚀 Вызовов: ${currentCount}${isOverTriggered ? ' ⚠️ (heavy re-renders)' : ''}`\n      subBadgeStyle = 'color: #42b883; font-weight: bold;'\n\n      if (isOverTriggered) subBadgeStyle = 'color: #ff4a4a; font-weight: bold;'\n      break\n    }\n    case 'batch': {\n      this.batchTickCounts += 1\n      subBadgeText = ` 📦 Номер транзакции: #${this.batchTickCounts}`\n      break\n    }\n    case 'resource': {\n      const resourceDetail = detail as ResourceLogDetail\n\n      // Формируем динамический статус-маркер для заголовка\n      if (resourceDetail.loading) {\n        subBadgeText = ' ⏳ ЗАГРУЗКА (fetching...)'\n        subBadgeStyle = 'color: #d97706; font-weight: bold;' // Оранжевый\n      } else if (resourceDetail.error) {\n        subBadgeText = ` 🔴 ОШИБКА: ${resourceDetail.error.message || 'Unknown Error'}`\n        subBadgeStyle = 'color: #ff4a4a; font-weight: bold;' // Красный\n      } else {\n        // Данные успешно загружены\n        const rawData = resourceDetail.data\n        const displayData = typeof rawData === 'object' && rawData !== null\n          ? '{...}'\n          : String(rawData)\n\n        subBadgeText = ` 🟢 УСПЕХ (data: ${displayData})`\n        subBadgeStyle = 'color: #42b883; font-weight: bold;' // Зеленый\n      }\n      break\n    }\n    default:\n      break\n    }\n\n    // Выводим красивый свернутый заголовок под-элемента с аналитикой\n    console.groupCollapsed(\n      `%c${type.toUpperCase()}%c [${name}]%c${subBadgeText}`,\n      badgeColors[type],\n      'color: #aaa; font-weight: bold;',\n      subBadgeStyle\n    )\n    console.log('Данные (Payload):', detail)\n    if (this.loggerOptions.traceTime && typeof performance !== 'undefined') {\n      console.log('Тайминг рантайма:', `${performance.now().toFixed(2)} ms`)\n    }\n    console.groupEnd()\n  }\n\n  /**\n   * Коллбек для уведомления об изменении сигнала.\n   * Использование unknown вместо any гарантирует безопасную работу с типами prev/next.\n   */\n  public onSignalChange?: (name: string, next: unknown, prev: unknown) => void\n\n  /**\n   * DI: Регистрация зависимости.\n   * @template T\n   * @function provide\n   * @param {Token<T>} token - Токен для зависимости.\n   * @param {T | Factory<T>} valueOrFactory - Значение или фабрика для создания сервиса.\n   * @returns {void}\n   * @source\n   */\n  public provide<T>(token: Token<T>, valueOrFactory: T | Factory<T>): void {\n    if (typeof valueOrFactory === 'function' && !valueOrFactory.prototype)\n      this.factories.set(token, valueOrFactory as Factory<T>)\n    else\n      this.services.set(token, valueOrFactory)\n  }\n\n  /**\n   * DI: Инъекция; Получение сервиса по токену.\n   * @template T\n   * @function inject\n   * @param {Token<T>} token - Токен для зависимости.\n   * @returns {T} - Сервис.\n   * @source\n   */\n  public inject<T>(token: Token<T>): T {\n    if (!token) {\n      throw new Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`)\n    }\n\n    // Приводим токен к базовому типу Token<unknown> для совместимости с Map\n    const targetToken = token as Token<unknown>\n\n    if (this.services.has(targetToken)) {\n      return this.services.get(targetToken) as T\n    }\n\n    try {\n      const factory = this.factories.get(targetToken)\n      if (factory) {\n        const instance = factory(this) as T\n        this.services.set(targetToken, instance)\n        return instance\n      }\n      if (typeof token === 'function' && token.prototype) {\n        const instance = new (token as { new(eng: ReactiveEngine): T })(this)\n        this.services.set(targetToken, instance)\n        return instance\n      }\n      throw new Error(`Service not found: ${String(token)}`)\n    } catch (e) {\n      throw new Error(`[DI Error]: Не удалось создать сервис ${String(token)}. Ошибка: ${(e as Error)?.message || 'No e?.message'}`)\n    }\n  }\n\n  /**\n   * Накапливает логи об изменениях в буфер текущей микрозадачи\n   */\n  public queueLog(type: keyof LogDetailMap, name: string, detail: any): void {\n    if (!this.loggerOptions?.isEnabled) return\n    this.pendingLogQueue.push({ type, name, detail })\n  }\n\n  /**\n   * Синхронно обрабатывает и выводит в консоль накопленный буфер логов\n   * для текущего тика микрозадачи (реактивной транзакции).\n   *\n   * Метод автоматически вызывается планировщиком ядра (`queueMicrotask`) непосредственно\n   * перед запуском каскада отложенных эффектов фреймворков и ререндеров интерфейса.\n   *\n   * ### Особенности рантайм-логики:\n   * 1. **Атомарный батчинг:** Предотвращает лавинообразный спам в консоли разработчика при\n   *    множественных синхронных мутациях сигналов. Все тики склеиваются в единую мастер-группу.\n   * 2. **Безопасная фильтрация:** Изолирует логи по маске, переданной в `loggerOptions.filter`.\n   *    Если после фильтрации очередь оказывается пустой, метод бережно зачищает буфер и\n   *    возвращает управление шедулеру ядра, не блокируя выполнение `pendingEffects`.\n   * 3. **Профайлинг производительности (Pull Duration):** При включенном `traceTime` рассчитывает\n   *    чистую длительность калькуляции и фильтрации транзакции графа в миллисекундах\n   *    с точностью до микросекунд (`performance.now`), помогая находить узкие места.\n   *\n   * @function flushLogs\n   * @returns {void} Метод не возвращает значения, а только очищает внутренний буфер `pendingLogQueue`.\n   */\n  public flushLogs(): void {\n    if (!this.loggerOptions?.isEnabled || this.pendingLogQueue.length === 0) return\n\n    const startTime = typeof performance !== 'undefined' ? performance.now() : 0\n    let logsToRender = this.pendingLogQueue\n\n    if (this.loggerOptions.filter) {\n      try {\n        let regex: RegExp\n        if (this.loggerOptions.filter instanceof RegExp) {\n          regex = this.loggerOptions.filter\n        } else {\n          const cleanStr = this.loggerOptions.filter.replace(/^\\/|\\/$/g, '')\n          regex = new RegExp(cleanStr)\n        }\n        logsToRender = logsToRender.filter(item => regex.test(item.name))\n      } catch (e) {\n        console.warn('[Logger Error]: Некорректный паттерн фильтрации логов', e)\n      }\n    }\n\n    if (logsToRender.length === 0) {\n      this.pendingLogQueue = []\n      return\n    }\n\n    // ШАГ 1: Переносим замер времени ВВЕРХ, чтобы знать длительность ДО рендеринга заголовка\n    let durationText = ''\n    let trendText = ''\n    let trendStyle = 'color: #aaa; font-weight: normal;' // Дефолтный серый стиль для тренда в заголовке\n\n    if (this.loggerOptions.traceTime && startTime) {\n      const endTime = performance.now()\n      const duration = endTime - startTime\n\n      durationText = ` | Duration: ${duration.toFixed(3)} ms`\n\n      // Расчет дельты тренда\n      if (this.lastTransactionDuration !== null && this.lastTransactionDuration > 0) {\n        const diff = duration - this.lastTransactionDuration\n        const percentChange = (diff / this.lastTransactionDuration) * 100\n\n        if (percentChange > 0.1) {\n          // Просадка производительности (время выросло) -> КРАСНЫЙ\n          trendText = ` 🔴 +${percentChange.toFixed(1)}%`\n          trendStyle = 'color: #e01e5a; font-weight: bold;'\n        } else if (percentChange < -0.1) {\n          // Ускорение графа (время уменьшилось) -> ЗЕЛЕНЫЙ\n          trendText = ` 🟢 ${percentChange.toFixed(1)}%`\n          trendStyle = 'color: #42b883; font-weight: bold;'\n        } else {\n          // Изменения в пределах погрешности -> СТАБИЛЬНО (ЗЕЛЕНЫЙ)\n          trendText = ' 🟢 stable'\n          trendStyle = 'color: #42b883; font-weight: bold;'\n        }\n      } else {\n        trendText = ' ⚪ first'\n      }\n\n      // Сохраняем значение для следующего тика микрозадачи\n      this.lastTransactionDuration = duration\n    }\n\n    // ШАГ 2: ВЫВОДИМ ВСЁ В ОДИН ЗАГОЛOВОК ГРУППЫ\n    // %c №1 - Стильный фиолетовый бэдж TRANSACTION\n    // %c №2 - Серый текст с размером батча и чистым временем выполнения (ms)\n    // %c №3 - Динамический цветной индикатор тренда (Красный/Зеленый) с процентами\n    console.groupCollapsed(\n      `%cREACTIVE TRANSACTION${!!this.loggerOptions.instanceName ? ` ${this.loggerOptions.instanceName}` : ''}%c Microtask Tick (Size: ${logsToRender.length}${durationText})%c${trendText}`,\n      'background: #7952b3; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      'color: #aaa; font-weight: normal;',\n      trendStyle\n    )\n\n    // Рендерим вложенные детальные логи сигналов и computed\n    logsToRender.forEach(item => {\n      this.log(item.type as any, item.name, item.detail as any)\n    })\n\n    if (this.loggerOptions.traceTime && typeof performance !== 'undefined') {\n      console.log(`%c[Execution Timestamp]: ${performance.now().toFixed(2)} ms`, 'color: #7952b3; font-weight: bold;')\n    }\n\n    console.groupEnd()\n    this.pendingLogQueue = []\n  }\n\n  /**\n   * Создание сигнала.\n   * @template T\n   * @function signal\n   * @param {T} initialValue - Начальное значение сигнала.\n   * @param {string | SignalOptions<T>} [optionsOrName] - Имя или опции сигнала.\n   * @returns {Signal<T>} - Сигнал.\n   * @source\n   */\n  public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n    const engine = this\n    let val = initialValue\n    const subscribers = new Set<IEffect>()\n    const options = typeof optionsOrName === 'string'\n      ? { name: optionsOrName }\n      : optionsOrName || {}\n    const name = options.name || 'unnamed_signal'\n\n    return {\n      get value(): T {\n        if (engine.activeEffect) {\n          const currentEffect = engine.activeEffect\n\n          // Защита от раздувания памяти!\n          // Добавляем функцию очистки в cleanups СТРОГО один раз — при первой регистрации эффекта.\n          if (!subscribers.has(currentEffect)) {\n            subscribers.add(currentEffect)\n\n            currentEffect.cleanups.add(() => {\n              subscribers.delete(currentEffect) // При уничтожении эффекта сигнал забудет его\n            })\n          }\n        }\n\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        // Извлекаем текстовые метки подписчиков для логгера\n        const subscriberLabels = Array.from(subscribers).map(\n          (e) => e.label || 'unnamed_effect'\n        )\n        engine.queueLog?.('signal', name, {\n          from: old,\n          to: newValue,\n          subscribersCount: subscribers.size,\n          subscribers: subscriberLabels,\n        })\n\n        // 1. Всегда добавляем подписчиков в очередь отложенных эффектов\n        subscribers.forEach(e => engine.pendingEffects.add(e))\n\n        // 2. Планируем автоматическое выполнение транзакции ВСЕГДА!\n        // Теперь микрозадача гарантированно выполнится и зачистит буфер flushLogs,\n        // даже если у сигнала было 0 подписчиков.\n        if (!engine.isBatching) {\n          engine.isBatching = true\n\n          queueMicrotask(() => {\n            // Динамический каскадный цикл (Push-домино)\n            for (const effectObj of engine.pendingEffects) {\n              engine.pendingEffects.delete(effectObj)\n              effectObj.run()\n            }\n            // Гасим флаг батчинга строго после того, как ВСЕ эффекты завершились\n            engine.isBatching = false\n            // Вызываем flushLogs на самом финише, когда вся транзакция полностью стабилизировалась\n            engine.flushLogs?.()\n          })\n        }\n      },\n      subscribe(cb: (val: T) => void) {\n        // Чистая и безопасная подписка для React/Vue/Angular адаптеров\n        return engine.effect(\n          () => {\n            cb(this.value)\n          },\n          `${engine.frameworkPrefix}:use:${name}`\n        )\n      }\n    }\n  }\n\n  /**\n   * Создание эффекта.\n   * @function effect\n   * @param {EffectFn} fn - Функция эффекта.\n   * @param {string} [label] - Необязательная метка для логирования и отладки.\n   * @returns {CleanupFn} - Функция для очистки эффекта.\n   * @source\n   */\n  public effect(fn: EffectFn, label?: string): CleanupFn {\n    const engine = this\n    // Теперь он жестко изолирован в памяти для данного инстанса эффекта,\n    // никогда не потеряет контекст и гарантированно станет false после первого тика!\n    // Эта переменная она полностью блокирует ложные «холостые» логи при инициализации (монтировании) эффекта\n    let isFirstRun = true\n    const effectObj: IEffect = {\n      label, // Запоминаем имя эффекта для профайлера/логов\n      cleanups: new Set(),\n      run() {\n        this.cleanups.forEach(c => c())\n        this.cleanups.clear()\n        const prev = engine.activeEffect\n        engine.activeEffect = this\n        // Замер производительности эффекта:\n        const startTime = performance.now()\n        engine.safeRun(this, () => {\n          const cleanup = fn()\n          if (typeof cleanup === 'function') this.cleanups.add(cleanup)\n        })\n\n        engine.activeEffect = prev\n\n        // Logger integretion (Читаем флаг из замыкания):\n        // Логируем только если это боевой перезапуск (isFirstRun === false)\n        const duration = performance.now() - startTime\n        if (!isFirstRun && engine.loggerOptions?.isEnabled) {\n          const filter = engine.loggerOptions.filter\n\n          if (!filter || (filter instanceof RegExp && !!this.label && filter.test(this.label))) {\n            if (typeof engine.queueLog === 'function') {\n              engine.queueLog('effect', this.label || 'unnamed-efect-0', {\n                name: this.label || 'unnamed-efect-0', // Ключ для фильтрации во flushLogs\n                type: 'effect', // Ключ для switch/case в методе log()\n                detail: {\n                  status: 'stable',\n                  duration: `${duration.toFixed(3)}ms`,\n                  timestamp: startTime\n                }\n              })\n            }\n          }\n        }\n        // После первого прохода снимаем флаг\n        isFirstRun = false\n      }\n    }\n    this.allEffects.add(effectObj)\n    effectObj.run()\n\n    return () => {\n      effectObj.cleanups.forEach(c => c())\n      engine.pendingEffects.delete(effectObj)\n      engine.allEffects.delete(effectObj) // Всегда чистим за собой\n    }\n  }\n\n  // Кэш для вычисляемых свойств: Вместо Map<Function, any> используем строгий интерфейс с unknown дженериком\n  private computedCache = new Map<Function, WeakRef<Computed<unknown>>>()\n\n  // 1. Создаем реестр финализации под капотом движка.\n  // В качестве токена очистки передаем функцию, которую нужно выполнить.\n  private cleanupRegistry = new FinalizationRegistry<() => void>(\n    (cleanupFn) => {\n      cleanupFn() // Вызовется автоматически, когда сборщик мусора удалит computedInstance\n    }\n  )\n\n  /**\n   * Создание вычисляемого значения.\n   * @template T\n   * @function computed\n   * @param {Function} fn - Функция для вычисления значения.\n   * @param {string} [signalName] - Имя сигнала.\n   * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n   * @source\n   */\n  public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n    if (this.computedCache.has(fn)) {\n      const cachedRef = this.computedCache.get(fn)\n      const cachedInstance = cachedRef?.deref()\n      if (cachedInstance) {\n        return cachedInstance as Computed<T>\n      }\n    }\n\n    const engine = this\n    const name = signalName || 'unnamed_computed'\n\n    // Маркируем внутренний сигнал ядра метаданными для утилиты getExtractedValues\n    const sig = this.signal<T>(undefined as unknown as T, `[CORE_INTERNAL_SIGNAL=1]:${name}`)\n\n    let isDirty = true\n    let cachedValue: T\n\n    // Core effect:\n    // Переносим логику логгера и замер таймингов прямо сюда — в единственное место,\n    // где реально выполняется функция fn() при изменении зависимостей!\n    const unsubscribeEffect = this.effect(() => {\n      // СЕКРЕТ PUSH-КАСКАДА:\n      // Мы принудительно вычисляем fn() на каждый тик зависимостей.\n      // Благодаря этому, когда меняется count -> step-A синхронно просыпается в микрозадаче,\n      // меняет свой sig.value -> этот сигнал мгновенно будит step-B, который уже добавлен\n      // в pendingEffects текущей транзакции!\n      cachedValue = fn()\n      isDirty = false\n\n      const startTime = typeof performance !== 'undefined' ? performance.now() : 0\n      const durationStr = startTime ? `0.010ms` : 'N/A' // Пассивный замер для логгера\n\n      if (typeof engine.queueLog === 'function') {\n        engine.queueLog('computed', name, {\n          value: cachedValue,\n          duration: durationStr\n        })\n      }\n\n      // Пушим значение. Сеттер сигнала подхватит следующий шаг,\n      // так как флаг isBatching удерживается шедулером!\n      (sig as any).value = cachedValue\n    }, `[CORE_INTERNAL_EFFECT=1]:${name}`)\n\n    const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1]\n\n    const performCleanup = () => {\n      unsubscribeEffect()\n      if (effectObj) {\n        engine.allEffects.delete(effectObj)\n      }\n      engine.computedCache.delete(fn)\n    }\n\n    const computedInstance: Computed<T> = {\n      get value() {\n        // Если кто-то читает .value вручную вне эффектов фреймворка,\n        // и флаг грязен — производим ленивый Pull-расчет\n        if (isDirty) {\n          cachedValue = fn()\n          isDirty = false;\n          (sig as any).value = cachedValue\n        }\n        return sig.value\n      },\n      subscribe: (cb: (val: T) => void) => sig.subscribe(cb),\n      destroy() {\n        unsubscribeEffect()\n        performCleanup()\n        engine.computedCache.delete(fn)\n      }\n    }\n\n    this.cleanupRegistry.register(computedInstance, performCleanup)\n    this.computedCache.set(fn, new WeakRef(computedInstance as Computed<unknown>))\n\n    return computedInstance\n  }\n\n  /**\n   * Создает глубокий реактивный объект (Proxy) на основе переданного целевого объекта или массива.\n   *\n   * В отличие от атомарных сигналов (`signal`), требующих ручного обращения через `.value`,\n   * метод `reactive` позволяет работать со сложными разветвленными структурами данных нативно,\n   * используя стандартный синтаксис JavaScript для чтения и прямой мутации свойств.\n   *\n   * ### Архитектурные особенности рантайма:\n   * 1. **Гранулярность подписок (Property-level Subscriptions):** Зависимости графа ядра трекаются\n   *    не для всего объекта целиком, а строго для конкретных ключей (`prop`). Если эффект или\n   *    компонент читает свойство `user.name`, он подписывается исключительно на этот ключ.\n   *    Изменение свойства `user.age` не вызовет его повторного выполнения.\n   * 2. **Глубокое проксирование (Deep Reactivity):** При обращении к вложенным объектам или массивам,\n   *    метод динамически и лениво оборачивает их в Proxy-структуры, автоматически формируя\n   *    понятные строковые пути для подсистемы логирования (например, `user.meta.role`).\n   * 3. **Иммунизация кэша (Proxy Mirroring Cache):** Все созданные Proxy зеркалируются во внутреннем\n   *    реестре `proxyCache`. Повторный вызов метода для одного и того же объекта вернет\n   *    уже существующий Proxy, предотвращая утечки памяти и дублирование подписок.\n   *\n   * ### Применение в оптимизации больших форм:\n   * Идеально подходит для тяжелых интерфейсов (динамические таблицы, анкеты из сотен полей),\n   * так как прямая мутация конкретного инпута изолирует поток изменений и избавляет от необходимости\n   * иммутабельного копирования всего стейта формы через оператор расширения (`...spread`).\n   *\n   * @template T - Тип целевого объекта, расширяющий базовый интерфейс `object`.\n   * @function reactive\n   * @param {T} target - Исходный объект или массив JavaScript для проксирования.\n   * @param {string} [name='reactive'] - Уникальное базовое имя объекта для трассировки и фильтрации в логгере.\n   * @returns {T} Глубоко проксированный реактивный объект типа `T`.\n   *\n   * @example\n   * ```typescript\n   * // 1. Инициализация в сервисе бизнес-логики:\n   * public form = this.engine.reactive({\n   *   user: { name: 'Иван', age: 25 }\n   * }, 'profile-form');\n   *\n   * // 2. Прямая мутация в экшене (Proxy перехватит тик и запустит атомарный батчинг):\n   * public updateAge() {\n   *   this.form.user.age += 1; // Автоматический лог: SIGNAL [profile-form.user.age]\n   * }\n   *\n   * // 3. Мост подписки для UI-компонентов:\n   * public uiBridge = this.engine.computed(() => ({\n   *   name: this.form.user.name,\n   *   age: this.form.user.age\n   * }));\n   * ```\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        // engine.queueLog?.('reactive', `${name}.${String(prop)}`, { action: 'get', property: String(prop), value })\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        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          engine.queueLog?.('reactive', `${name}.${String(prop)}`, {\n            action: 'set',\n            property: String(prop),\n            oldValue: old,\n            newValue: value\n          })\n        }\n        return true\n      }\n    })\n    this.proxyCache.set(target, proxy)\n    return proxy\n  }\n\n  /**\n   * Группировка изменений. (Оставил для обратной совместимости)\n   * @function batch\n   * @param {Function} fn - Функция для выполнения в группе.\n   * @returns {void}\n   * @source\n   */\n  public batch(fn: () => void): void {\n    // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n    // поэтому здесь мы можем просто выполнить функцию\n    fn()\n  }\n\n  /**\n   * Вспомогательная функция для задержки (sleep), чувствительная к AbortSignal\n   *\n   * Вызов new DOMException('Aborted', 'AbortError') гарантирует,\n   * что ваша кастомная пауза между ретраями this.delay притворяется для движка JavaScript\n   * точно таким же нативным процессом отмены, как и fetch().\n   * Это делает реактивное ядро бесшовным и избавляет от необходимости\n   * писать кучу разных проверок под каждый тип ошибки.\n   */\n  private delay(ms: number, signal: AbortSignal): Promise<void> {\n    return new Promise((resolve, reject) => {\n      if (signal.aborted) {\n        return reject(new DOMException('Aborted', 'AbortError'))\n      }\n\n      const timeoutId = setTimeout(() => {\n        signal.removeEventListener('abort', onAbort)\n        resolve()\n      }, ms)\n\n      const onAbort = () => {\n        clearTimeout(timeoutId) // СИНХРОННО УБИВАЕТ ТАЙМЕР. В Vitest это заставит таймер исчезнуть из очереди прокрутки\n        reject(new DOMException('Aborted', 'AbortError'))\n      }\n\n      signal.addEventListener('abort', onAbort, { once: true })\n    })\n  }\n\n  /**\n   * Создание асинхронного ресурса. Типы на входе: <T - формат ответа, S - источник изменений (сигнал либо computed-кортеж из зачений сигналов через конструкцию `.value`)>\n   *\n   * Explained 👉 {@link https://github.com/garage-13/reactive-engine/blob/main/README_EN.md#1-async-resources-dependent-on-multiple-signals}\n   *\n   * @template T, S\n   * @see {@link https://github.com/garage-13/reactive-engine/blob/main/examples/200-resource/Example200.tsx Реализация базового компонента Example200}\n   * @see {@link https://github.com/garage-13/reactive-engine/blob/main/examples/201-multi-resource/service.secondary.ts Сложный пример зависимости ресурсов через computed}\n   * @function resource\n   * @param {Function} fetcher - Асинхронная функция для загрузки данных.\n   * @param {{ value: S }} [source] - Источник данных.\n   * @param {string | ResourceOptions<T>} [optionsOrName] - Имя сигнала или объект конфигурации `{ name: string; validate: (res) => boolean | string; resetDataOnSourceChange?: boolean }`.\n   * @returns {Resource<T>} - Асинхронный ресурс.\n   *\n   * @example\n   * // Базовый вызов со строкой (обратная совместимость):\n   * const res = engine.resource(fetcher, source, 'my-resource-name');\n   *\n   * @example\n   * // Современный вызов с валидацией ответа:\n   * const res = engine.resource(fetcher, source, {\n   *   name: 'my-resource-name',\n   *   resetDataOnSourceChange: true, // true by default\n   *   responseValidate: (data) => !!data || 'Данные пусты', // Проверяйте формат в соотв. с дженериком\n   * });\n   *\n   * @example\n   * // (Экспериментальная фича)\n   * // В теле fetcher можно выкинуть ошибку в виде\n   * // `throw new Error('[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1][MESSAGE=Your msg]')`\n   * // Причина: Особенности внутренней реализации определения харакрера ошибки и необходимость делать retry (если такая опция передана)\n   * // Рекомендуем вместо этого использовать `validateBeforeFetch` в опциях при создании ресурса.\n   * const res = engine.resource(\n   *   async (counterValue, abortSignal) => {\n   *     if (counterValue === 0)\n   *       throw new Error([\n   *         '[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1]', // Иначе запустится механизм retry (напр. по причине отсутствия сети, далее в этом же примере)\n   *         `[MESSAGE=Stop for count value ${counterValue} - excepted from fetcher fn body]`,\n   *       ].join(' '))\n   *     const res = await fetch(\n   *       [\n   *         `${BASE_API_URL}/profile/search`,\n   *         '?',\n   *         [\n   *           `counter=${counterValue}`,\n   *           '_responseDelay=2000',\n   *         ].join('&')\n   *       ].join(''),\n   *       { signal: abortSignal }\n   *     )\n   *     if (!res.ok) throw new Error(`HTTP error! status: ${res.status}`)\n   *     return res.json()\n   *   },\n   *   this.counter,\n   * )\n   * @source\n   */\n  public resource<T, S = void>(\n    fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n    source?: { value: S },\n    optionsOrName?: string | ResourceOptions<T, S>,\n  ): Resource<T> {\n    const isOptionsObject = optionsOrName && typeof optionsOrName === 'object'\n    const signalName = isOptionsObject\n      ? (optionsOrName as ResourceOptions<T, S>).name\n      : (optionsOrName as string) || 'unnamed_resource'\n\n    const options: Partial<ResourceOptions<T, S>> = isOptionsObject\n      ? (optionsOrName as ResourceOptions<T, S>)\n      : {}\n\n    const resetDataOnSourceChange = options.resetDataOnSourceChange ?? true\n    const responseValidate = options.responseValidate\n    const validateBeforeFetch = options.validateBeforeFetch\n\n    const retryCount = options.retryCount ?? 0\n    const baseDelay = options.retryDelay ?? 1000\n    const useExponential = options.isExponentialBackoffEnabled ?? false\n    const maxRetryDelay = options.maxRetryDelay ?? 30000\n    const timeoutMs = options.timeout\n\n    // Оставляем префикс метаданных для внутренней подсистемы логгера\n    const state = this.signal<ResourceState<T>>(\n      { data: null, loading: true, error: null, isRetrying: false },\n      `[CORE_INTERNAL_SIGNAL=1]:resource:state:${signalName}`\n    )\n\n    // Внутренний метод для безопасного обновления стейта и отправки лога\n    const updateResourceState = (nextState: ResourceState<T>) => {\n      (state as any).value = nextState\n\n      // Logger Trigger for Resource: Передаем чистое signalName, чтобы заголовок в консоли оставался аккуратным\n      if (typeof this.queueLog === 'function') {\n        this.queueLog('resource', signalName, {\n          loading: nextState.loading,\n          data: nextState.data,\n          error: nextState.error,\n          isRetrying: nextState.isRetrying\n        })\n      }\n    }\n\n    const load = async (sValue: S, effectSignal: AbortSignal, isSourceChange = false) => {\n      if (effectSignal.aborted) return\n\n      // const isValid = options.validateBeforeFetch ? options.validateBeforeFetch(sValue) : true;\n\n      /**\n       * 🧐 WIP_CORE: Есть два пути, ни один не будет ошибкой, если разкомментировать код ниже. Чуть бозже добавлю опци для более тонкой отладки ядра.\n       *\n       * - АКТИВНО: Разделяем мирную блокировку (false) и боевую ошибку (string): работать будет идеально, но без логов, связанных с пре-валидацией\n       * - НЕАКТИВНО: Более очевидное логирование процессов пре-валидации (выставление ошибок и мониторинг разработчиком)\n      */\n      // --\n      // if (isValid === false) {\n      //   // Если валидатор вернул строго false — мы тихо блокируем старт фетчера,\n      //   // переводя ресурс в состояние ПОКОЯ (loading: false, error: null).\n      //   // Это полностью ликвидирует генерацию ложных ошибок при монтировании!\n      //   state.value = {\n      //     loading: false,\n      //     data: null,\n      //     error: null, // 🟢 ФИКС: Ошибки нет! Стейт стабилен.\n      //     isRetrying: false\n      //   };\n      //   return;\n      // }\n      // if (typeof isValid === 'string') {\n      //   // Если валидатор вернул строку — это боевая декларативная ошибка валидации формы.\n      //   // Здесь мы честно переводим ресурс в стейт ошибки, как и требовалось ранее.\n      //   state.value = {\n      //     loading: false,\n      //     data: null,\n      //     error: new Error(isValid),\n      //     isRetrying: false\n      //   };\n      //   return;\n      // }\n      // --\n\n      if (validateBeforeFetch) {\n        const preValidationResult = validateBeforeFetch(sValue)\n        if (preValidationResult === false || typeof preValidationResult === 'string') {\n          if (effectSignal.aborted) return\n          const errorMsg = typeof preValidationResult === 'string'\n            ? preValidationResult\n            : 'Pre-fetch validation failed for resource'\n\n          const currentData = isSourceChange ? null : this.untrack(() => state.value.data)\n          updateResourceState({ data: currentData, loading: false, error: new Error(errorMsg), isRetrying: false })\n          return\n        }\n      }\n\n      const shouldClear = isSourceChange && resetDataOnSourceChange\n      const currentData = shouldClear ? null : this.untrack(() => state.value.data)\n\n      updateResourceState({ data: currentData, loading: true, error: null, isRetrying: false })\n\n      for (let attempt = 0; attempt <= retryCount; attempt++) {\n        if (effectSignal.aborted) return\n        let combinedSignal = effectSignal\n\n        try {\n          if (timeoutMs && timeoutMs > 0) {\n            const timeoutSignal = AbortSignal.timeout(timeoutMs)\n            combinedSignal = AbortSignal.any([effectSignal, timeoutSignal])\n          }\n\n          const data = await fetcher(sValue, combinedSignal)\n\n          if (effectSignal.aborted) return\n\n          if (combinedSignal.aborted) {\n            throw new DOMException('The operation timed out.', 'TimeoutError')\n          }\n\n          if (responseValidate) {\n            const validationResult = responseValidate(data)\n            if (validationResult === false || typeof validationResult === 'string') {\n              if (effectSignal.aborted) return\n              const errorMsg = typeof validationResult === 'string' ? validationResult : 'Validation failed'\n              updateResourceState({ data: null, loading: false, error: new Error(errorMsg), isRetrying: false })\n              return\n            }\n          }\n\n          if (effectSignal.aborted) return\n\n          // Успешное завершение запроса\n          updateResourceState({ data, loading: false, error: null, isRetrying: false })\n          return\n        } catch (e: any) {\n          if (effectSignal.aborted || (e.name === 'AbortError' && effectSignal.aborted)) return\n\n          const isTimeout = e.name === 'TimeoutError' || e.name === 'AbortError' || e.message?.includes('timeout')\n\n          const isCustomValidationError = getExtractedValues({\n            tested: [e.message], expectedKey: 'THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY', valueType: 'number',\n          })?.[0] === '1' || false\n\n          const __defaultCustomValidationErrorMessage = 'Custom validation error'\n          let customValidationErrorMessage: string = isCustomValidationError\n            ? (getExtractedValues({\n              tested: [e.message], expectedKey: 'MESSAGE', valueType: 'string',\n            })?.[0] || __defaultCustomValidationErrorMessage)\n            : __defaultCustomValidationErrorMessage\n\n          const isFetchBodyValidationError = isCustomValidationError || e.name === 'ValidationError'\n\n          if (attempt === retryCount || isFetchBodyValidationError) {\n            if (effectSignal.aborted) return\n\n            const finalError = isTimeout\n              ? new Error(`Request timed out after ${timeoutMs}ms`, { cause: e })\n              : isCustomValidationError\n                ? new Error(customValidationErrorMessage, { cause: e })\n                : e\n\n            // Фиксация финальной ошибки\n            updateResourceState({ data: null, loading: false, error: finalError, isRetrying: false })\n            return\n          } else {\n            if (effectSignal.aborted) return\n\n            let currentDelay = useExponential ? baseDelay * Math.pow(2, attempt) : baseDelay\n            currentDelay = Math.min(currentDelay, maxRetryDelay)\n            const jitter = Math.random() * 200\n            currentDelay = currentDelay + jitter\n\n            // Безопасное обновление статуса ретрая с логгированием фазы повтора\n            updateResourceState({ data: state.value.data, loading: true, error: null, isRetrying: true })\n\n            const logReason = isTimeout ? 'таймауту' : 'ошибке сети'\n            console.warn(`[Resource Retry] \"${signalName}\" сбой по ${logReason}. Попытка ${attempt + 1}/${retryCount + 1}...`)\n\n            try {\n              await this.delay(currentDelay, effectSignal)\n              if (effectSignal.aborted) return\n            } catch (delayError) {\n              return\n            }\n          }\n        }\n      }\n    }\n\n    let activeEffectController: AbortController | null = null\n\n    this.effect(() => {\n      const sValue = source ? source.value : undefined as S\n      const effectController = new AbortController()\n      activeEffectController = effectController\n\n      this.untrack(() => {\n        load(sValue as S, effectController.signal, true)\n      })\n\n      return () => effectController.abort()\n    }, '[dev]')\n\n    return {\n      get data() { return state.value.data },\n      get loading() { return state.value.loading },\n      get error() { return state.value.error },\n      get isRetrying() { return state.value.isRetrying },\n      get value() { return state.value },\n      refetch: () => {\n        activeEffectController?.abort()\n        activeEffectController = new AbortController()\n        load(source ? source.value : undefined as S, activeEffectController.signal, false)\n      },\n      subscribe: (cb: (val: ResourceState<T>) => void) => state.subscribe(cb)\n    }\n  }\n\n  /**\n   * Выполняет функцию без отслеживания зависимостей.\n   * @template T\n   * @function untrack\n   * @param {Function} fn - Функция для выполнения.\n   * @returns {T} - Результат выполнения функции.\n   * @source\n   */\n  public untrack<T>(fn: () => T): T {\n    const prev = this.activeEffect\n    this.activeEffect = null // Временно \"забываем\" про активный эффект\n    try {\n      return fn()\n    } finally {\n      this.activeEffect = prev // Возвращаем эффект на место\n    }\n  }\n\n  /**\n   * Безопасное выполнение функции.\n   * @private\n   * @function safeRun\n   * @param {IEffect} effect - Эффект.\n   * @param {Function} fn - Функция для выполнения.\n   * @returns {void}\n   * @source\n   */\n  private safeRun(effect: IEffect, fn: () => void) {\n    try {\n      fn()\n    } catch (error) {\n      console.error(\n        `%c[Reactive Error] %cОшибка в эффекте/computed:`,\n        \"color: white; background: red; padding: 2px 4px; border-radius: 3px;\",\n        \"font-weight: bold;\",\n        error\n      )\n      // Здесь можно отправить ошибку в Sentry или другой сервис мониторинга\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"core.mjs","names":[],"sources":["../src/core/core.ts"],"sourcesContent":["import { ResourceOptions, ResourceState, SignalOptions } from './types'\nimport { getExtractedValues } from '../utils'\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\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\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 * @interface IEffect\n */\nexport interface IEffect {\n  run: () => void;\n  label?: string;\n  cleanups: Set<CleanupFn>;\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\nexport interface EngineLoggerOptions {\n  /** Наименование инстанса движка */\n  instanceName?: string;\n  /** Включить детальное логгирование в консоль */\n  isEnabled: boolean;\n  /** Выводить время выполнения с точностью до микросекунд (performance.now) */\n  traceTime?: boolean;\n  /** Фильтровать логи по имени сигнала (поддерживает RegExp или строку) */\n  filter?: RegExp | string;\n  /** Показывать внутренние системные логи ядра (сигналы кэша, эффекты computed) */\n  isCoreOptimizationDebugEnabled?: boolean;\n}\n\nexport interface ReactiveEngineOptions {\n  logger?: EngineLoggerOptions;\n}\n// Конкретные и строгие структуры для деталей каждого типа лога\nexport interface SignalLogDetail {\n  from: unknown;\n  to: unknown;\n  subscribersCount: number;\n  subscribers: string[];\n}\n\nexport interface ComputedLogDetail {\n  value: unknown;\n  duration: string;\n}\n\nexport interface EffectLogDetail {\n  triggeredBy: string;\n  executionTime?: string;\n}\n\nexport interface BatchLogDetail {\n  transactionSize: number;\n  totalEffectsRun: number;\n}\nexport interface ResourceLogDetail {\n  /** Текущий статус загрузки */\n  loading: boolean;\n  /** Данные ответа (если есть) */\n  data: unknown;\n  /** Объект ошибки (если запрос упал) */\n  error: Error | null;\n  /** Была ли это повторная попытка (Retry) */\n  isRetrying?: boolean;\n}\nexport interface ReactiveDetail {}\n\n// Маппинг: связываем строковый литерал типа лога с его интерфейсом деталей\nexport interface LogDetailMap {\n  signal: SignalLogDetail;\n  computed: ComputedLogDetail;\n  effect: EffectLogDetail;\n  batch: BatchLogDetail;\n  resource: ResourceLogDetail;\n  reactive: ReactiveDetail;\n}\n\n\n// --- ЯДРО ---\n/**\n * Класс `ReactiveEngine` представляет собой реактивную систему, которая позволяет создавать и управлять реактивными объектами,\n * сигналами, эффектами, асинхронными ресурсами и другими реактивными примитивами. Реактивные механизмы облегчают разработку\n * сложных пользовательских интерфейсов и приложений, автоматически отслеживая зависимости между данными и реактивно обновляя UI.\n *\n * Основные возможности `ReactiveEngine` включают:\n * - **Сигналы (Signals)**: Реактивные переменные с поддержкой подписки на изменения.\n * - **Эффекты (Effects)**: Автоматические функции, которые выполняются при изменении зависимых сигналов.\n * - **Ресурсы (Resources)**: Асинхронные ресурсы с поддержкой повторных попыток и валидации.\n * - **Прокси-объекты (Proxy Objects)**: Реактивное обертывание объектов для отслеживания изменений свойств.\n * - **Интеграция с React**: Удобные методы для интеграции реактивного ядра с компонентами React.\n *\n * Пример использования:\n *\n * ```javascript\n * const engine = new ReactiveEngine();\n * const count = engine.signal(0);\n *\n * engine.effect(() => {\n *   console.log(`Count is ${count.value}`);\n * });\n *\n * count.value++; // Выведет: Count is 1\n * ```\n *\n * @class\n */\nexport class ReactiveEngine {\n  protected frameworkPrefix = 'core'\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  // Logger\n  private loggerOptions?: EngineLoggerOptions\n  private pendingLogQueue: Array<{\n    [K in keyof LogDetailMap]: {\n      type: K;\n      name: string;\n      detail: LogDetailMap[K];\n    }\n  }[keyof LogDetailMap]> = []\n  private lastTransactionDuration: number | null = null\n  // Хранилища точечной аналитки:\n  private signalMutationCounts = new Map<string, number>() // Имя сигнала -> Кол-во мутаций\n  private lastComputedDurations = new Map<string, number>() // Имя computed -> Время прошлого расчета\n  private effectExecutionCounts = new Map<string, number>() // Имя эффекта -> Кол-во запусков\n  private batchTickCounts = 0 // Глобальный счетчик транзакций ядра\n\n  constructor(options?: ReactiveEngineOptions) {\n    this.loggerOptions = options?.logger\n  }\n\n  /**\n   * Системный метод вывода форматированных логов в консоль.\n   * Автоматически подстраивает тип входящего аргумента `detail` под выбранный литерал `type`.\n   *\n   * Дополнительно агрегирует рантйам-статистику по всей стейт-машине приложения:\n   * - **`signal`:** Отслеживает счетчик частоты изменений (шума) для детекции паразитных циклов мутаций.\n   * - **`computed`:** Сравнивает текущую длительность ленивого вычисления с прошлым, подсвечивая тренд производительности.\n   * - **`effect`:** Подсчитывает общее количество ререндеров/вызовов побочных эффектов.\n   * - **`batch`:** Фиксирует порядковый номер выполненного шедулером пакета микрозадач.\n   *\n   * @template K - Литеральный тип лога из карты `LogDetailMap`\n   * @param {K} type - Категория логгируемого события ('signal' | 'computed' | 'effect' | 'batch')\n   * @param {string} name - Уникальное имя реактивного элемента (или label эффекта)\n   * @param {LogDetailMap[K]} detail - Строго типизированный объект с контекстными данными события\n   * @returns {void}\n   */\n  public log<K extends keyof LogDetailMap>(\n    type: K,\n    name: string,\n    detail: LogDetailMap[K]\n  ): void {\n    if (!this.loggerOptions?.isEnabled) return\n\n    if (!this.loggerOptions?.isCoreOptimizationDebugEnabled) {\n      // Детектим внутренний сигнал кэша\n      const isInternalSignal = getExtractedValues({\n        expectedKey: 'CORE_INTERNAL_SIGNAL', tested: [name], valueType: 'number'\n      })?.[0] === '1'\n      // Детектим внутренний эффект оптимизации компута по маркеру в имени\n      const isInternalEffect = getExtractedValues({\n        expectedKey: 'CORE_INTERNAL_EFFECT', tested: [name], valueType: 'number'\n      })?.[0] === '1'\n      // Если это сервисный лог, а отладка оптимизации выключена — тихо выходим!\n      if (isInternalSignal || isInternalEffect) return\n    }\n\n    // Фильтрацию производим уже по очищенному имени\n    if (this.loggerOptions.filter) {\n      const regex = this.loggerOptions.filter instanceof RegExp\n        ? this.loggerOptions.filter\n        : new RegExp(this.loggerOptions.filter.replace(/^\\/|\\/$/g, ''))\n      if (!regex.test(name)) return\n    }\n\n    const badgeColors: Record<keyof LogDetailMap, string> = {\n      signal: 'background: #007acc; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      computed: 'background: #42b883; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      effect: 'background: #e01e5a; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      batch: 'background: #7952b3; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      resource: 'background: #d97706; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      reactive: 'background: #007acc; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n    }\n\n    let subBadgeText = ''\n    let subBadgeStyle = 'color: #aaa; font-weight: normal;'\n\n    switch (type) {\n    case 'signal': {\n      // Проверяем, является ли сигнал внутренним служебным сигналом ядра\n      const isInternal = getExtractedValues({\n        tested: [name],\n        expectedKey: 'CORE_INTERNAL_SIGNAL',\n        valueType: 'number'\n      })?.[0] === '1'\n\n      // (?) Чистим имя от метаданных для красивого вывода в консоль\n      const displayName = name // name.replace(/\\[CORE_INTERNAL_SIGNAL=1\\]:/g, '');\n\n      const currentCount = (this.signalMutationCounts.get(displayName) || 0) + 1\n      this.signalMutationCounts.set(displayName, currentCount)\n\n      const signalDetail = detail as SignalLogDetail\n      const isFullyOptimized = signalDetail.subscribers && signalDetail.subscribers.length > 0\n        ? signalDetail.subscribers.every((sub) => {\n          if (!sub) return false\n          return getExtractedValues({\n            tested: [sub],\n            expectedKey: 'IS_OPTIMIZED',\n            valueType: 'number',\n          })?.[0] === '1'\n        })\n        : false\n\n      const isNoisy = currentCount > 50\n\n      // Переключаем текст под-бэджа, если это внутренний сигнал computed\n      const typeLabel = isInternal ? 'COMPUTED_INTERNAL' : 'SIGNAL'\n\n      subBadgeText = ` 🔄 Изменений ${isInternal ? 'кэша' : 'сигнала'}: ${currentCount}${isNoisy ? ' ⚠️ (high noise — обнаружен дребезг/спам значений!)' : ''}`\n\n      if (isNoisy) {\n        subBadgeStyle = 'color: orange; font-weight: bold;'\n        if (!isFullyOptimized) {\n          (detail as any).__performance_advice__ = {\n            issue: `Сигнал [${displayName}] обновляется слишком часто (${currentCount} раз за такт). Это приводит к избыточным ререндерам UI.`,\n            solution: `Оберните чтение этого сигнала в декоратор сжатия потока данных 'withThrottleComputed'`,\n            example: `public throttled = withThrottleComputed(this.engine, () => this.yourSignalName.value, { limit: 300 });`\n          }\n        }\n      }\n\n      // Переопределяем параметры вывода console.groupCollapsed локально\n      console.groupCollapsed(\n        `%c${typeLabel}%c [${displayName}]%c${subBadgeText}`,\n        isInternal ? 'background: #42b883; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;' : badgeColors[type],\n        'color: #aaa; font-weight: bold;',\n        subBadgeStyle\n      )\n      console.log('Данные (Payload):', detail)\n      if (this.loggerOptions.traceTime && typeof performance !== 'undefined') {\n        console.log('Тайминг рантайма:', `${performance.now().toFixed(2)} ms`)\n      }\n      console.groupEnd()\n\n      return // Прерываем дефолтный вывод, так как мы отрендерили сигнал со специальным бэджем!\n    }\n    case 'computed': {\n      // Даже если это был сигнал, мы берем детали вычислений\n      const currentDetail = detail as any\n\n      // Безопасно извлекаем значение для заголовка бэджа.\n      // Читаем .to только если это простой примитив (не объект), чтобы не триггерить геттеры ядра!\n      if (currentDetail && 'to' in currentDetail) {\n        const rawValue = currentDetail.to\n        const displayValue = typeof rawValue === 'object' && rawValue !== null\n          ? '{...}' // Для объектов выводим заглушку, защищая геттеры от JSON.stringify\n          : String(rawValue)\n\n        subBadgeText = ` 🧮 Значение: ${displayValue}`\n      } else if (currentDetail && 'duration' in currentDetail) {\n        // Ваша стандартная рабочая логика тренда для оригинального события computed\n        const currentDuration = parseFloat(currentDetail.duration)\n        if (!isNaN(currentDuration)) {\n          const lastDuration = this.lastComputedDurations.get(name)\n          if (lastDuration !== undefined && lastDuration > 0) {\n            const diff = currentDuration - lastDuration\n            const percentChange = (diff / lastDuration) * 100\n            if (percentChange > 5) {\n              subBadgeText = ` 🔴 Замедление: +${percentChange.toFixed(1)}% (${currentDetail.duration})`\n              subBadgeStyle = 'color: #e01e5a; font-weight: bold;'\n            } else if (percentChange < -5) {\n              subBadgeText = ` 🟢 Ускорение: ${percentChange.toFixed(1)}% (${currentDetail.duration})`\n              subBadgeStyle = 'color: #42b883; font-weight: bold;'\n            } else {\n              subBadgeText = ` 🟢 Стабильно (${currentDetail.duration})`\n              subBadgeStyle = 'color: #42b883; font-weight: bold;'\n            }\n          } else {\n            subBadgeText = ` ⚪ Первый расчет (${currentDetail.duration})`\n          }\n          this.lastComputedDurations.set(name, currentDuration)\n        }\n      }\n      break\n    }\n    case 'effect': {\n      const currentCount = (this.effectExecutionCounts.get(name) || 0) + 1\n      this.effectExecutionCounts.set(name, currentCount)\n\n      const isOverTriggered = currentCount > 30\n      const currentDetail = detail as any\n      const durationStr = currentDetail && 'duration' in currentDetail ? ` (${currentDetail.duration})` : ''\n\n      // Выводим статус стабильности и длительность в заголовок бэджа по аналогии с computed\n      subBadgeText = ` 🟢 Стабильно${durationStr} | 🚀 Вызовов: ${currentCount}${isOverTriggered ? ' ⚠️ (heavy re-renders)' : ''}`\n      subBadgeStyle = 'color: #42b883; font-weight: bold;'\n\n      if (isOverTriggered) subBadgeStyle = 'color: #ff4a4a; font-weight: bold;'\n      break\n    }\n    case 'batch': {\n      this.batchTickCounts += 1\n      subBadgeText = ` 📦 Номер транзакции: #${this.batchTickCounts}`\n      break\n    }\n    case 'resource': {\n      const resourceDetail = detail as ResourceLogDetail\n\n      // Формируем динамический статус-маркер для заголовка\n      if (resourceDetail.loading) {\n        subBadgeText = ' ⏳ ЗАГРУЗКА (fetching...)'\n        subBadgeStyle = 'color: #d97706; font-weight: bold;' // Оранжевый\n      } else if (resourceDetail.error) {\n        subBadgeText = ` 🔴 ОШИБКА: ${resourceDetail.error.message || 'Unknown Error'}`\n        subBadgeStyle = 'color: #ff4a4a; font-weight: bold;' // Красный\n      } else {\n        // Данные успешно загружены\n        const rawData = resourceDetail.data\n        const displayData = typeof rawData === 'object' && rawData !== null\n          ? '{...}'\n          : String(rawData)\n\n        subBadgeText = ` 🟢 УСПЕХ (data: ${displayData})`\n        subBadgeStyle = 'color: #42b883; font-weight: bold;' // Зеленый\n      }\n      break\n    }\n    default:\n      break\n    }\n\n    // Выводим красивый свернутый заголовок под-элемента с аналитикой\n    console.groupCollapsed(\n      `%c${type.toUpperCase()}%c [${name}]%c${subBadgeText}`,\n      badgeColors[type],\n      'color: #aaa; font-weight: bold;',\n      subBadgeStyle\n    )\n    console.log('Данные (Payload):', detail)\n    if (this.loggerOptions.traceTime && typeof performance !== 'undefined') {\n      console.log('Тайминг рантайма:', `${performance.now().toFixed(2)} ms`)\n    }\n    console.groupEnd()\n  }\n\n  /**\n   * Коллбек для уведомления об изменении сигнала.\n   * Использование unknown вместо any гарантирует безопасную работу с типами prev/next.\n   */\n  public onSignalChange?: (name: string, next: unknown, prev: unknown) => void\n\n  /**\n   * DI: Регистрация зависимости.\n   * @template T\n   * @function provide\n   * @param {Token<T>} token - Токен для зависимости.\n   * @param {T | Factory<T>} valueOrFactory - Значение или фабрика для создания сервиса.\n   * @returns {void}\n   * @source\n   */\n  public provide<T>(token: Token<T>, valueOrFactory: T | Factory<T>): void {\n    if (typeof valueOrFactory === 'function' && !valueOrFactory.prototype)\n      this.factories.set(token, valueOrFactory as Factory<T>)\n    else\n      this.services.set(token, valueOrFactory)\n  }\n\n  /**\n   * DI: Инъекция; Получение сервиса по токену.\n   * @template T\n   * @function inject\n   * @param {Token<T>} token - Токен для зависимости.\n   * @returns {T} - Сервис.\n   * @source\n   */\n  public inject<T>(token: Token<T>): T {\n    if (!token) {\n      throw new Error(`[DI Error]: Вы пытаетесь внедрить пустой токен (undefined/null). Проверьте импорты.`)\n    }\n\n    // Приводим токен к базовому типу Token<unknown> для совместимости с Map\n    const targetToken = token as Token<unknown>\n\n    if (this.services.has(targetToken)) {\n      return this.services.get(targetToken) as T\n    }\n\n    try {\n      const factory = this.factories.get(targetToken)\n      if (factory) {\n        const instance = factory(this) as T\n        this.services.set(targetToken, instance)\n        return instance\n      }\n      if (typeof token === 'function' && token.prototype) {\n        const instance = new (token as { new(eng: ReactiveEngine): T })(this)\n        this.services.set(targetToken, instance)\n        return instance\n      }\n      throw new Error(`Service not found: ${String(token)}`)\n    } catch (e) {\n      throw new Error(`[DI Error]: Не удалось создать сервис ${String(token)}. Ошибка: ${(e as Error)?.message || 'No e?.message'}`)\n    }\n  }\n\n  /**\n   * Накапливает логи об изменениях в буфер текущей микрозадачи\n   */\n  public queueLog(type: keyof LogDetailMap, name: string, detail: any): void {\n    if (!this.loggerOptions?.isEnabled) return\n    this.pendingLogQueue.push({ type, name, detail })\n  }\n\n  /**\n   * Синхронно обрабатывает и выводит в консоль накопленный буфер логов\n   * для текущего тика микрозадачи (реактивной транзакции).\n   *\n   * Метод автоматически вызывается планировщиком ядра (`queueMicrotask`) непосредственно\n   * перед запуском каскада отложенных эффектов фреймворков и ререндеров интерфейса.\n   *\n   * ### Особенности рантайм-логики:\n   * 1. **Атомарный батчинг:** Предотвращает лавинообразный спам в консоли разработчика при\n   *    множественных синхронных мутациях сигналов. Все тики склеиваются в единую мастер-группу.\n   * 2. **Безопасная фильтрация:** Изолирует логи по маске, переданной в `loggerOptions.filter`.\n   *    Если после фильтрации очередь оказывается пустой, метод бережно зачищает буфер и\n   *    возвращает управление шедулеру ядра, не блокируя выполнение `pendingEffects`.\n   * 3. **Профайлинг производительности (Pull Duration):** При включенном `traceTime` рассчитывает\n   *    чистую длительность калькуляции и фильтрации транзакции графа в миллисекундах\n   *    с точностью до микросекунд (`performance.now`), помогая находить узкие места.\n   *\n   * @function flushLogs\n   * @returns {void} Метод не возвращает значения, а только очищает внутренний буфер `pendingLogQueue`.\n   */\n  public flushLogs(): void {\n    if (!this.loggerOptions?.isEnabled || this.pendingLogQueue.length === 0) return\n\n    const startTime = typeof performance !== 'undefined' ? performance.now() : 0\n    let logsToRender = this.pendingLogQueue\n\n    if (this.loggerOptions.filter) {\n      try {\n        let regex: RegExp\n        if (this.loggerOptions.filter instanceof RegExp) {\n          regex = this.loggerOptions.filter\n        } else {\n          const cleanStr = this.loggerOptions.filter.replace(/^\\/|\\/$/g, '')\n          regex = new RegExp(cleanStr)\n        }\n        logsToRender = logsToRender.filter(item => regex.test(item.name))\n      } catch (e) {\n        console.warn('[Logger Error]: Некорректный паттерн фильтрации логов', e)\n      }\n    }\n\n    if (logsToRender.length === 0) {\n      this.pendingLogQueue = []\n      return\n    }\n\n    // ШАГ 1: Переносим замер времени ВВЕРХ, чтобы знать длительность ДО рендеринга заголовка\n    let durationText = ''\n    let trendText = ''\n    let trendStyle = 'color: #aaa; font-weight: normal;' // Дефолтный серый стиль для тренда в заголовке\n\n    if (this.loggerOptions.traceTime && startTime) {\n      const endTime = performance.now()\n      const duration = endTime - startTime\n\n      durationText = ` | Duration: ${duration.toFixed(3)} ms`\n\n      // Расчет дельты тренда\n      if (this.lastTransactionDuration !== null && this.lastTransactionDuration > 0) {\n        const diff = duration - this.lastTransactionDuration\n        const percentChange = (diff / this.lastTransactionDuration) * 100\n\n        if (percentChange > 0.1) {\n          // Просадка производительности (время выросло) -> КРАСНЫЙ\n          trendText = ` 🔴 +${percentChange.toFixed(1)}%`\n          trendStyle = 'color: #e01e5a; font-weight: bold;'\n        } else if (percentChange < -0.1) {\n          // Ускорение графа (время уменьшилось) -> ЗЕЛЕНЫЙ\n          trendText = ` 🟢 ${percentChange.toFixed(1)}%`\n          trendStyle = 'color: #42b883; font-weight: bold;'\n        } else {\n          // Изменения в пределах погрешности -> СТАБИЛЬНО (ЗЕЛЕНЫЙ)\n          trendText = ' 🟢 stable'\n          trendStyle = 'color: #42b883; font-weight: bold;'\n        }\n      } else {\n        trendText = ' ⚪ first'\n      }\n\n      // Сохраняем значение для следующего тика микрозадачи\n      this.lastTransactionDuration = duration\n    }\n\n    // ШАГ 2: ВЫВОДИМ ВСЁ В ОДИН ЗАГОЛOВОК ГРУППЫ\n    // %c №1 - Стильный фиолетовый бэдж TRANSACTION\n    // %c №2 - Серый текст с размером батча и чистым временем выполнения (ms)\n    // %c №3 - Динамический цветной индикатор тренда (Красный/Зеленый) с процентами\n    console.groupCollapsed(\n      `%cREACTIVE TRANSACTION${!!this.loggerOptions.instanceName ? ` ${this.loggerOptions.instanceName}` : ''}%c Microtask Tick (Size: ${logsToRender.length}${durationText})%c${trendText}`,\n      'background: #7952b3; color: #fff; padding: 2px 6px; border-radius: 4px; font-weight: bold;',\n      'color: #aaa; font-weight: normal;',\n      trendStyle\n    )\n\n    // Рендерим вложенные детальные логи сигналов и computed\n    logsToRender.forEach(item => {\n      this.log(item.type as any, item.name, item.detail as any)\n    })\n\n    if (this.loggerOptions.traceTime && typeof performance !== 'undefined') {\n      console.log(`%c[Execution Timestamp]: ${performance.now().toFixed(2)} ms`, 'color: #7952b3; font-weight: bold;')\n    }\n\n    console.groupEnd()\n    this.pendingLogQueue = []\n  }\n\n  /**\n   * Создание сигнала.\n   * @template T\n   * @function signal\n   * @param {T} initialValue - Начальное значение сигнала.\n   * @param {string | SignalOptions<T>} [optionsOrName] - Имя или опции сигнала.\n   * @returns {Signal<T>} - Сигнал.\n   * @source\n   */\n  public signal<T>(initialValue: T, optionsOrName?: string | SignalOptions<T>): Signal<T> {\n    const engine = this\n    let val = initialValue\n    const subscribers = new Set<IEffect>()\n    const options = typeof optionsOrName === 'string'\n      ? { name: optionsOrName }\n      : optionsOrName || {}\n    const name = options.name || 'unnamed_signal'\n\n    return {\n      get value(): T {\n        if (engine.activeEffect) {\n          const currentEffect = engine.activeEffect\n\n          // Защита от раздувания памяти!\n          // Добавляем функцию очистки в cleanups СТРОГО один раз — при первой регистрации эффекта.\n          if (!subscribers.has(currentEffect)) {\n            subscribers.add(currentEffect)\n\n            currentEffect.cleanups.add(() => {\n              subscribers.delete(currentEffect) // При уничтожении эффекта сигнал забудет его\n            })\n          }\n        }\n\n        return val\n      },\n      set value(newValue: T) {\n        if (val === newValue) return\n\n        // Валидация в рантайме\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        // Извлекаем текстовые метки подписчиков для логгера\n        const subscriberLabels = Array.from(subscribers).map(\n          (e) => e.label || 'unnamed_effect'\n        )\n        engine.queueLog?.('signal', name, {\n          from: old,\n          to: newValue,\n          subscribersCount: subscribers.size,\n          subscribers: subscriberLabels,\n        })\n\n        // Всегда добавляем подписчиков в очередь отложенных эффектов\n        subscribers.forEach(e => engine.pendingEffects.add(e))\n\n        // Планируем автоматическое выполнение транзакции ВСЕГДА!\n        // Теперь микрозадача гарантированно выполнится и зачистит буфер flushLogs,\n        // даже если у сигнала было 0 подписчиков.\n        if (!engine.isBatching) {\n          engine.isBatching = true\n\n          queueMicrotask(() => {\n            // Динамический каскадный цикл (Push-домино)\n            for (const effectObj of engine.pendingEffects) {\n              engine.pendingEffects.delete(effectObj)\n              effectObj.run()\n            }\n            // Гасим флаг батчинга строго после того, как ВСЕ эффекты завершились\n            engine.isBatching = false\n            // Вызываем flushLogs на самом финише, когда вся транзакция полностью стабилизировалась\n            engine.flushLogs?.()\n          })\n        }\n      },\n      subscribe(cb: (val: T) => void) {\n        // Чистая и безопасная подписка для React/Vue/Angular адаптеров\n        return engine.effect(\n          () => {\n            cb(this.value)\n          },\n          `${engine.frameworkPrefix}:use:${name}`\n        )\n      }\n    }\n  }\n\n  /**\n   * Создание эффекта.\n   * @function effect\n   * @param {EffectFn} fn - Функция эффекта.\n   * @param {string} [label] - Необязательная метка для логирования и отладки.\n   * @returns {CleanupFn} - Функция для очистки эффекта.\n   * @source\n   */\n  public effect(fn: EffectFn, label?: string): CleanupFn {\n    const engine = this\n    // Теперь он жестко изолирован в памяти для данного инстанса эффекта,\n    // никогда не потеряет контекст и гарантированно станет false после первого тика!\n    // Эта переменная она полностью блокирует ложные «холостые» логи при инициализации (монтировании) эффекта\n    let isFirstRun = true\n    const effectObj: IEffect = {\n      label, // Запоминаем имя эффекта для профайлера/логов\n      cleanups: new Set(),\n      run() {\n        // 1. Создаем моментальный снимок (копию) функций очистки.\n        // Итерация по копии гарантирует, что даже если внутри колбэков очистки\n        // или последующего safeRun в Set прилетят новые элементы,\n        // текущий цикл .forEach завершится строго по старой длине и НЕ зациклится!\n        const cleanupsToRun = Array.from(this.cleanups)\n        this.cleanups.clear()\n\n        cleanupsToRun.forEach(c => c())\n\n        const prev = engine.activeEffect\n        engine.activeEffect = this\n\n        const startTime = performance.now()\n        engine.safeRun(this, () => {\n          const cleanup = fn()\n          if (typeof cleanup === 'function') this.cleanups.add(cleanup)\n        })\n\n        engine.activeEffect = prev\n\n        // Logger integretion (Читаем флаг из замыкания):\n        // Логируем только если это боевой перезапуск (isFirstRun === false)\n        const duration = performance.now() - startTime\n        if (!isFirstRun && engine.loggerOptions?.isEnabled) {\n          const filter = engine.loggerOptions.filter\n\n          if (!filter || (filter instanceof RegExp && !!this.label && filter.test(this.label))) {\n            if (typeof engine.queueLog === 'function') {\n              engine.queueLog('effect', this.label || 'unnamed-efect-0', {\n                name: this.label || 'unnamed-efect-0', // Ключ для фильтрации во flushLogs\n                type: 'effect', // Ключ для switch/case в методе log()\n                detail: {\n                  status: 'stable',\n                  duration: `${duration.toFixed(3)}ms`,\n                  timestamp: startTime\n                }\n              })\n            }\n          }\n        }\n        // После первого прохода снимаем флаг\n        isFirstRun = false\n      }\n    }\n    this.allEffects.add(effectObj)\n    effectObj.run()\n\n    return () => {\n      effectObj.cleanups.forEach(c => c())\n      engine.pendingEffects.delete(effectObj)\n      engine.allEffects.delete(effectObj) // Всегда чистим за собой\n    }\n  }\n\n  // Кэш для вычисляемых свойств: Вместо Map<Function, any> используем строгий интерфейс с unknown дженериком\n  private computedCache = new Map<Function, WeakRef<Computed<unknown>>>()\n\n  // 1. Создаем реестр финализации под капотом движка.\n  // В качестве токена очистки передаем функцию, которую нужно выполнить.\n  private cleanupRegistry = new FinalizationRegistry<() => void>(\n    (cleanupFn) => {\n      cleanupFn() // Вызовется автоматически, когда сборщик мусора удалит computedInstance\n    }\n  )\n\n  /**\n   * Создание вычисляемого значения.\n   * @template T\n   * @function computed\n   * @param {Function} fn - Функция для вычисления значения.\n   * @param {string} [signalName] - Имя сигнала.\n   * @returns {Computed<T>} - Вычисляемое значение с методом destroy.\n   * @source\n   */\n  public computed<T>(fn: () => T, signalName?: string): Computed<T> {\n    if (this.computedCache.has(fn)) {\n      const cachedRef = this.computedCache.get(fn)\n      const cachedInstance = cachedRef?.deref()\n      if (cachedInstance) {\n        return cachedInstance as Computed<T>\n      }\n    }\n\n    const engine = this\n    const name = signalName || 'unnamed_computed'\n\n    // Маркируем внутренний сигнал ядра метаданными для утилиты getExtractedValues\n    const sig = this.signal<T>(undefined as unknown as T, `[CORE_INTERNAL_SIGNAL=1]:${name}`)\n\n    let isDirty = true\n    let cachedValue: T\n\n    // Core effect:\n    // Переносим логику логгера и замер таймингов прямо сюда — в единственное место,\n    // где реально выполняется функция fn() при изменении зависимостей!\n    const unsubscribeEffect = this.effect(() => {\n      // СЕКРЕТ PUSH-КАСКАДА:\n      // Мы принудительно вычисляем fn() на каждый тик зависимостей.\n      // Благодаря этому, когда меняется count -> step-A синхронно просыпается в микрозадаче,\n      // меняет свой sig.value -> этот сигнал мгновенно будит step-B, который уже добавлен\n      // в pendingEffects текущей транзакции!\n      cachedValue = fn()\n      isDirty = false\n\n      const startTime = typeof performance !== 'undefined' ? performance.now() : 0\n      const durationStr = startTime ? `0.010ms` : 'N/A' // Пассивный замер для логгера\n\n      if (typeof engine.queueLog === 'function') {\n        engine.queueLog('computed', name, {\n          value: cachedValue,\n          duration: durationStr\n        })\n      }\n\n      // Пушим значение. Сеттер сигнала подхватит следующий шаг,\n      // так как флаг isBatching удерживается шедулером!\n      (sig as any).value = cachedValue\n    }, `[CORE_INTERNAL_EFFECT=1]:${name}`)\n\n    const effectObj = Array.from(this.allEffects)[this.allEffects.size - 1]\n\n    const performCleanup = () => {\n      unsubscribeEffect()\n      if (effectObj) {\n        engine.allEffects.delete(effectObj)\n      }\n      engine.computedCache.delete(fn)\n    }\n\n    const computedInstance: Computed<T> = {\n      get value() {\n        // Если кто-то читает .value вручную вне эффектов фреймворка,\n        // и флаг грязен — производим ленивый Pull-расчет\n        if (isDirty) {\n          cachedValue = fn()\n          isDirty = false;\n          (sig as any).value = cachedValue\n        }\n        return sig.value\n      },\n      subscribe: (cb: (val: T) => void) => sig.subscribe(cb),\n      destroy() {\n        unsubscribeEffect()\n        performCleanup()\n        engine.computedCache.delete(fn)\n      }\n    }\n\n    this.cleanupRegistry.register(computedInstance, performCleanup)\n    this.computedCache.set(fn, new WeakRef(computedInstance as Computed<unknown>))\n\n    return computedInstance\n  }\n\n  /**\n   * Создает глубокий реактивный объект (Proxy) на основе переданного целевого объекта или массива.\n   *\n   * В отличие от атомарных сигналов (`signal`), требующих ручного обращения через `.value`,\n   * метод `reactive` позволяет работать со сложными разветвленными структурами данных нативно,\n   * используя стандартный синтаксис JavaScript для чтения и прямой мутации свойств.\n   *\n   * ### Архитектурные особенности рантайма:\n   * 1. **Гранулярность подписок (Property-level Subscriptions):** Зависимости графа ядра трекаются\n   *    не для всего объекта целиком, а строго для конкретных ключей (`prop`). Если эффект или\n   *    компонент читает свойство `user.name`, он подписывается исключительно на этот ключ.\n   *    Изменение свойства `user.age` не вызовет его повторного выполнения.\n   * 2. **Глубокое проксирование (Deep Reactivity):** При обращении к вложенным объектам или массивам,\n   *    метод динамически и лениво оборачивает их в Proxy-структуры, автоматически формируя\n   *    понятные строковые пути для подсистемы логирования (например, `user.meta.role`).\n   * 3. **Иммунизация кэша (Proxy Mirroring Cache):** Все созданные Proxy зеркалируются во внутреннем\n   *    реестре `proxyCache`. Повторный вызов метода для одного и того же объекта вернет\n   *    уже существующий Proxy, предотвращая утечки памяти и дублирование подписок.\n   *\n   * ### Применение в оптимизации больших форм:\n   * Идеально подходит для тяжелых интерфейсов (динамические таблицы, анкеты из сотен полей),\n   * так как прямая мутация конкретного инпута изолирует поток изменений и избавляет от необходимости\n   * иммутабельного копирования всего стейта формы через оператор расширения (`...spread`).\n   *\n   * @template T - Тип целевого объекта, расширяющий базовый интерфейс `object`.\n   * @function reactive\n   * @param {T} target - Исходный объект или массив JavaScript для проксирования.\n   * @param {string} [name='reactive'] - Уникальное базовое имя объекта для трассировки и фильтрации в логгере.\n   * @returns {T} Глубоко проксированный реактивный объект типа `T`.\n   *\n   * @example\n   * ```typescript\n   * // 1. Инициализация в сервисе бизнес-логики:\n   * public form = this.engine.reactive({\n   *   user: { name: 'Иван', age: 25 }\n   * }, 'profile-form');\n   *\n   * // 2. Прямая мутация в экшене (Proxy перехватит тик и запустит атомарный батчинг):\n   * public updateAge() {\n   *   this.form.user.age += 1; // Автоматический лог: SIGNAL [profile-form.user.age]\n   * }\n   *\n   * // 3. Мост подписки для UI-компонентов:\n   * public uiBridge = this.engine.computed(() => ({\n   *   name: this.form.user.name,\n   *   age: this.form.user.age\n   * }));\n   * ```\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          const currentEffect = engine.activeEffect\n          if (!propsSubscribers.has(prop)) propsSubscribers.set(prop, new Set())\n\n          const subscribers = propsSubscribers.get(prop)!\n\n          // Проверяем, что эффект еще НЕ находится в подписчиках,\n          // И что эта конкретная функция очистки еще не была зарегистрирована,\n          // предотвращая каскадный дребезг Set.forEach\n          if (!subscribers.has(currentEffect)) {\n            subscribers.add(currentEffect)\n\n            const cleanupFn = () => {\n              subscribers.delete(currentEffect)\n            }\n\n            currentEffect.cleanups.add(cleanupFn)\n          }\n        }\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        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\n          // Берем моментальный снимок подписчиков этого ключа.\n          // Это гарантирует, что синхронный перезапуск эффекта не зациклит текущий .forEach\n          const targets = propsSubscribers.get(prop)\n          const effectsToRun = targets ? Array.from(targets) : []\n\n          effectsToRun.forEach(e => {\n            if (engine.isBatching) {\n              engine.pendingEffects.add(e)\n            } else {\n              // Автобатчинг для Proxy: Взводим флаг и планируем микрозадачу,\n              // как это делает нативный Signal\n              // чтобы разделить фазу мутации и фазу синхронного перезапуска эффектов UI.\n              engine.pendingEffects.add(e)\n\n              if (!engine.isBatching) {\n                engine.isBatching = true\n\n                queueMicrotask(() => {\n                  for (const effectObj of engine.pendingEffects) {\n                    engine.pendingEffects.delete(effectObj)\n                    effectObj.run()\n                  }\n                  engine.isBatching = false\n                  engine.flushLogs?.()\n                })\n              }\n            }\n          })\n\n          engine.queueLog?.('reactive', `${name}.${String(prop)}`, {\n            action: 'set',\n            property: String(prop),\n            oldValue: old,\n            newValue: value\n          })\n        }\n        return true\n      }\n    })\n    this.proxyCache.set(target, proxy)\n    return proxy\n  }\n\n  /**\n   * Группировка изменений. (Оставил для обратной совместимости)\n   * @function batch\n   * @param {Function} fn - Функция для выполнения в группе.\n   * @returns {void}\n   * @source\n   */\n  public batch(fn: () => void): void {\n    // Наш асинхронный сеттер теперь сам выполняет всю работу в queueMicrotask,\n    // поэтому здесь мы можем просто выполнить функцию\n    fn()\n  }\n\n  /**\n   * Вспомогательная функция для задержки (sleep), чувствительная к AbortSignal\n   *\n   * Вызов new DOMException('Aborted', 'AbortError') гарантирует,\n   * что ваша кастомная пауза между ретраями this.delay притворяется для движка JavaScript\n   * точно таким же нативным процессом отмены, как и fetch().\n   * Это делает реактивное ядро бесшовным и избавляет от необходимости\n   * писать кучу разных проверок под каждый тип ошибки.\n   */\n  private delay(ms: number, signal: AbortSignal): Promise<void> {\n    return new Promise((resolve, reject) => {\n      if (signal.aborted) {\n        return reject(new DOMException('Aborted', 'AbortError'))\n      }\n\n      const timeoutId = setTimeout(() => {\n        signal.removeEventListener('abort', onAbort)\n        resolve()\n      }, ms)\n\n      const onAbort = () => {\n        clearTimeout(timeoutId) // СИНХРОННО УБИВАЕТ ТАЙМЕР. В Vitest это заставит таймер исчезнуть из очереди прокрутки\n        reject(new DOMException('Aborted', 'AbortError'))\n      }\n\n      signal.addEventListener('abort', onAbort, { once: true })\n    })\n  }\n\n  /**\n   * Создание асинхронного ресурса. Типы на входе: <T - формат ответа, S - источник изменений (сигнал либо computed-кортеж из зачений сигналов через конструкцию `.value`)>\n   *\n   * Explained 👉 {@link https://github.com/garage-13/reactive-engine/blob/main/README_EN.md#1-async-resources-dependent-on-multiple-signals}\n   *\n   * @template T, S\n   * @see {@link https://github.com/garage-13/reactive-engine/blob/main/examples/200-resource/Example200.tsx Реализация базового компонента Example200}\n   * @see {@link https://github.com/garage-13/reactive-engine/blob/main/examples/201-multi-resource/service.secondary.ts Сложный пример зависимости ресурсов через computed}\n   * @function resource\n   * @param {Function} fetcher - Асинхронная функция для загрузки данных.\n   * @param {{ value: S }} [source] - Источник данных.\n   * @param {string | ResourceOptions<T>} [optionsOrName] - Имя сигнала или объект конфигурации `{ name: string; validate: (res) => boolean | string; resetDataOnSourceChange?: boolean }`.\n   * @returns {Resource<T>} - Асинхронный ресурс.\n   *\n   * @example\n   * // Базовый вызов со строкой (обратная совместимость):\n   * const res = engine.resource(fetcher, source, 'my-resource-name');\n   *\n   * @example\n   * // Современный вызов с валидацией ответа:\n   * const res = engine.resource(fetcher, source, {\n   *   name: 'my-resource-name',\n   *   resetDataOnSourceChange: true, // true by default\n   *   responseValidate: (data) => !!data || 'Данные пусты', // Проверяйте формат в соотв. с дженериком\n   * });\n   *\n   * @example\n   * // (Экспериментальная фича)\n   * // В теле fetcher можно выкинуть ошибку в виде\n   * // `throw new Error('[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1][MESSAGE=Your msg]')`\n   * // Причина: Особенности внутренней реализации определения харакрера ошибки и необходимость делать retry (если такая опция передана)\n   * // Рекомендуем вместо этого использовать `validateBeforeFetch` в опциях при создании ресурса.\n   * const res = engine.resource(\n   *   async (counterValue, abortSignal) => {\n   *     if (counterValue === 0)\n   *       throw new Error([\n   *         '[THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY=1]', // Иначе запустится механизм retry (напр. по причине отсутствия сети, далее в этом же примере)\n   *         `[MESSAGE=Stop for count value ${counterValue} - excepted from fetcher fn body]`,\n   *       ].join(' '))\n   *     const res = await fetch(\n   *       [\n   *         `${BASE_API_URL}/profile/search`,\n   *         '?',\n   *         [\n   *           `counter=${counterValue}`,\n   *           '_responseDelay=2000',\n   *         ].join('&')\n   *       ].join(''),\n   *       { signal: abortSignal }\n   *     )\n   *     if (!res.ok) throw new Error(`HTTP error! status: ${res.status}`)\n   *     return res.json()\n   *   },\n   *   this.counter,\n   * )\n   * @source\n   */\n  public resource<T, S = void>(\n    fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n    source?: { value: S },\n    optionsOrName?: string | ResourceOptions<T, S>,\n  ): Resource<T> {\n    const isOptionsObject = optionsOrName && typeof optionsOrName === 'object'\n    const signalName = isOptionsObject\n      ? (optionsOrName as ResourceOptions<T, S>).name\n      : (optionsOrName as string) || 'unnamed_resource'\n\n    const options: Partial<ResourceOptions<T, S>> = isOptionsObject\n      ? (optionsOrName as ResourceOptions<T, S>)\n      : {}\n\n    const resetDataOnSourceChange = options.resetDataOnSourceChange ?? true\n    const responseValidate = options.responseValidate\n    const validateBeforeFetch = options.validateBeforeFetch\n\n    const retryCount = options.retryCount ?? 0\n    const baseDelay = options.retryDelay ?? 1000\n    const useExponential = options.isExponentialBackoffEnabled ?? false\n    const maxRetryDelay = options.maxRetryDelay ?? 30000\n    const timeoutMs = options.timeout\n\n    // Оставляем префикс метаданных для внутренней подсистемы логгера\n    const state = this.signal<ResourceState<T>>(\n      { data: null, loading: true, error: null, isRetrying: false },\n      `[CORE_INTERNAL_SIGNAL=1]:resource:state:${signalName}`\n    )\n\n    // Внутренний метод для безопасного обновления стейта и отправки лога\n    const updateResourceState = (nextState: ResourceState<T>) => {\n      (state as any).value = nextState\n\n      // Logger Trigger for Resource: Передаем чистое signalName, чтобы заголовок в консоли оставался аккуратным\n      if (typeof this.queueLog === 'function') {\n        this.queueLog('resource', signalName, {\n          loading: nextState.loading,\n          data: nextState.data,\n          error: nextState.error,\n          isRetrying: nextState.isRetrying\n        })\n      }\n    }\n\n    const load = async (sValue: S, effectSignal: AbortSignal, isSourceChange = false) => {\n      if (effectSignal.aborted) return\n\n      // const isValid = options.validateBeforeFetch ? options.validateBeforeFetch(sValue) : true;\n\n      /**\n       * 🧐 WIP_CORE: Есть два пути, ни один не будет ошибкой, если разкомментировать код ниже. Чуть бозже добавлю опци для более тонкой отладки ядра.\n       *\n       * - АКТИВНО: Разделяем мирную блокировку (false) и боевую ошибку (string): работать будет идеально, но без логов, связанных с пре-валидацией\n       * - НЕАКТИВНО: Более очевидное логирование процессов пре-валидации (выставление ошибок и мониторинг разработчиком)\n      */\n      // --\n      // if (isValid === false) {\n      //   // Если валидатор вернул строго false — мы тихо блокируем старт фетчера,\n      //   // переводя ресурс в состояние ПОКОЯ (loading: false, error: null).\n      //   // Это полностью ликвидирует генерацию ложных ошибок при монтировании!\n      //   state.value = {\n      //     loading: false,\n      //     data: null,\n      //     error: null, // 🟢 ФИКС: Ошибки нет! Стейт стабилен.\n      //     isRetrying: false\n      //   };\n      //   return;\n      // }\n      // if (typeof isValid === 'string') {\n      //   // Если валидатор вернул строку — это боевая декларативная ошибка валидации формы.\n      //   // Здесь мы честно переводим ресурс в стейт ошибки, как и требовалось ранее.\n      //   state.value = {\n      //     loading: false,\n      //     data: null,\n      //     error: new Error(isValid),\n      //     isRetrying: false\n      //   };\n      //   return;\n      // }\n      // --\n\n      if (validateBeforeFetch) {\n        const preValidationResult = validateBeforeFetch(sValue)\n        if (preValidationResult === false || typeof preValidationResult === 'string') {\n          if (effectSignal.aborted) return\n          const errorMsg = typeof preValidationResult === 'string'\n            ? preValidationResult\n            : 'Pre-fetch validation failed for resource'\n\n          const currentData = isSourceChange ? null : this.untrack(() => state.value.data)\n          updateResourceState({ data: currentData, loading: false, error: new Error(errorMsg), isRetrying: false })\n          return\n        }\n      }\n\n      const shouldClear = isSourceChange && resetDataOnSourceChange\n      const currentData = shouldClear ? null : this.untrack(() => state.value.data)\n\n      updateResourceState({ data: currentData, loading: true, error: null, isRetrying: false })\n\n      for (let attempt = 0; attempt <= retryCount; attempt++) {\n        if (effectSignal.aborted) return\n        let combinedSignal = effectSignal\n\n        try {\n          if (timeoutMs && timeoutMs > 0) {\n            const timeoutSignal = AbortSignal.timeout(timeoutMs)\n            combinedSignal = AbortSignal.any([effectSignal, timeoutSignal])\n          }\n\n          const data = await fetcher(sValue, combinedSignal)\n\n          if (effectSignal.aborted) return\n\n          if (combinedSignal.aborted) {\n            throw new DOMException('The operation timed out.', 'TimeoutError')\n          }\n\n          if (responseValidate) {\n            const validationResult = responseValidate(data)\n            if (validationResult === false || typeof validationResult === 'string') {\n              if (effectSignal.aborted) return\n              const errorMsg = typeof validationResult === 'string' ? validationResult : 'Validation failed'\n              updateResourceState({ data: null, loading: false, error: new Error(errorMsg), isRetrying: false })\n              return\n            }\n          }\n\n          if (effectSignal.aborted) return\n\n          // Успешное завершение запроса\n          updateResourceState({ data, loading: false, error: null, isRetrying: false })\n          return\n        } catch (e: any) {\n          if (effectSignal.aborted || (e.name === 'AbortError' && effectSignal.aborted)) return\n\n          const isTimeout = e.name === 'TimeoutError' || e.name === 'AbortError' || e.message?.includes('timeout')\n\n          const isCustomValidationError = getExtractedValues({\n            tested: [e.message], expectedKey: 'THROW_CUSTOM_VALIDATION_ERROR_NO_RETRY', valueType: 'number',\n          })?.[0] === '1' || false\n\n          const __defaultCustomValidationErrorMessage = 'Custom validation error'\n          let customValidationErrorMessage: string = isCustomValidationError\n            ? (getExtractedValues({\n              tested: [e.message], expectedKey: 'MESSAGE', valueType: 'string',\n            })?.[0] || __defaultCustomValidationErrorMessage)\n            : __defaultCustomValidationErrorMessage\n\n          const isFetchBodyValidationError = isCustomValidationError || e.name === 'ValidationError'\n\n          if (attempt === retryCount || isFetchBodyValidationError) {\n            if (effectSignal.aborted) return\n\n            const finalError = isTimeout\n              ? new Error(`Request timed out after ${timeoutMs}ms`, { cause: e })\n              : isCustomValidationError\n                ? new Error(customValidationErrorMessage, { cause: e })\n                : e\n\n            // Фиксация финальной ошибки\n            updateResourceState({ data: null, loading: false, error: finalError, isRetrying: false })\n            return\n          } else {\n            if (effectSignal.aborted) return\n\n            let currentDelay = useExponential ? baseDelay * Math.pow(2, attempt) : baseDelay\n            currentDelay = Math.min(currentDelay, maxRetryDelay)\n            const jitter = Math.random() * 200\n            currentDelay = currentDelay + jitter\n\n            // Безопасное обновление статуса ретрая с логгированием фазы повтора\n            updateResourceState({ data: state.value.data, loading: true, error: null, isRetrying: true })\n\n            const logReason = isTimeout ? 'таймауту' : 'ошибке сети'\n            console.warn(`[Resource Retry] \"${signalName}\" сбой по ${logReason}. Попытка ${attempt + 1}/${retryCount + 1}...`)\n\n            try {\n              await this.delay(currentDelay, effectSignal)\n              if (effectSignal.aborted) return\n            } catch (delayError) {\n              return\n            }\n          }\n        }\n      }\n    }\n\n    let activeEffectController: AbortController | null = null\n\n    this.effect(() => {\n      const sValue = source ? source.value : undefined as S\n      const effectController = new AbortController()\n      activeEffectController = effectController\n\n      this.untrack(() => {\n        load(sValue as S, effectController.signal, true)\n      })\n\n      return () => effectController.abort()\n    }, '[dev]')\n\n    return {\n      get data() { return state.value.data },\n      get loading() { return state.value.loading },\n      get error() { return state.value.error },\n      get isRetrying() { return state.value.isRetrying },\n      get value() { return state.value },\n      refetch: () => {\n        activeEffectController?.abort()\n        activeEffectController = new AbortController()\n        load(source ? source.value : undefined as S, activeEffectController.signal, false)\n      },\n      subscribe: (cb: (val: ResourceState<T>) => void) => state.subscribe(cb)\n    }\n  }\n\n  /**\n   * Выполняет функцию без отслеживания зависимостей.\n   * @template T\n   * @function untrack\n   * @param {Function} fn - Функция для выполнения.\n   * @returns {T} - Результат выполнения функции.\n   * @source\n   */\n  public untrack<T>(fn: () => T): T {\n    const prev = this.activeEffect\n    this.activeEffect = null // Временно \"забываем\" про активный эффект\n    try {\n      return fn()\n    } finally {\n      this.activeEffect = prev // Возвращаем эффект на место\n    }\n  }\n\n  /**\n   * Безопасное выполнение функции.\n   * @private\n   * @function safeRun\n   * @param {IEffect} effect - Эффект.\n   * @param {Function} fn - Функция для выполнения.\n   * @returns {void}\n   * @source\n   */\n  private safeRun(effect: IEffect, fn: () => void) {\n    try {\n      fn()\n    } catch (error) {\n      console.error(\n        `%c[Reactive Error] %cОшибка в эффекте/computed:`,\n        \"color: white; background: red; padding: 2px 4px; border-radius: 3px;\",\n        \"font-weight: bold;\",\n        error\n      )\n      // Здесь можно отправить ошибку в Sentry или другой сервис мониторинга\n    }\n  }\n}\n"],"mappings":";;AAsLA,IAAa,IAAb,MAA4B;CAC1B,kBAA4B;CAC5B,eAAuC;CACvC,aAAqB;CACrB,iCAAyB,IAAI,IAAa;CAI1C,2BAAmB,IAAI,IAA6B;CACpD,4BAAoB,IAAI,IAAsC;CAG9D,6BAAqB,IAAI,QAAwB;CACjD,6BAAqB,IAAI,IAAa;CAGtC;CACA,kBAMyB,CAAC;CAC1B,0BAAiD;CAEjD,uCAA+B,IAAI,IAAoB;CACvD,wCAAgC,IAAI,IAAoB;CACxD,wCAAgC,IAAI,IAAoB;CACxD,kBAA0B;CAE1B,YAAY,GAAiC;EAC3C,KAAK,gBAAgB,GAAS;CAChC;CAkBA,IACE,GACA,GACA,GACM;EACN,IAAI,CAAC,KAAK,eAAe,WAAW;EAEpC,IAAI,CAAC,KAAK,eAAe,gCAAgC;GAEvD,IAAM,IAAmB,EAAmB;IAC1C,aAAa;IAAwB,QAAQ,CAAC,CAAI;IAAG,WAAW;GAClE,CAAC,CAAC,GAAG,OAAO,KAEN,IAAmB,EAAmB;IAC1C,aAAa;IAAwB,QAAQ,CAAC,CAAI;IAAG,WAAW;GAClE,CAAC,CAAC,GAAG,OAAO;GAEZ,IAAI,KAAoB,GAAkB;EAC5C;EAGA,IAAI,KAAK,cAAc,UAIjB,EAHU,KAAK,cAAc,kBAAkB,SAC/C,KAAK,cAAc,SACnB,IAAI,OAAO,KAAK,cAAc,OAAO,QAAQ,YAAY,EAAE,CAAC,EAAA,CACrD,KAAK,CAAI,GAAG;EAGzB,IAAM,IAAkD;GACtD,QAAQ;GACR,UAAU;GACV,QAAQ;GACR,OAAO;GACP,UAAU;GACV,UAAU;EACZ,GAEI,IAAe,IACf,IAAgB;EAEpB,QAAQ,GAAR;GACA,KAAK,UAAU;IAEb,IAAM,IAAa,EAAmB;KACpC,QAAQ,CAAC,CAAI;KACb,aAAa;KACb,WAAW;IACb,CAAC,CAAC,GAAG,OAAO,KAGN,IAAc,GAEd,KAAgB,KAAK,qBAAqB,IAAI,CAAW,KAAK,KAAK;IACzE,KAAK,qBAAqB,IAAI,GAAa,CAAY;IAEvD,IAAM,IAAe,GACf,IAAmB,EAAa,eAAe,EAAa,YAAY,SAAS,IACnF,EAAa,YAAY,OAAO,MAC3B,IACE,EAAmB;KACxB,QAAQ,CAAC,CAAG;KACZ,aAAa;KACb,WAAW;IACb,CAAC,CAAC,GAAG,OAAO,MALK,EAMlB,IACC,IAEE,IAAU,IAAe,IAGzB,IAAY,IAAa,sBAAsB;IA0BrD,AAxBA,IAAe,iBAAiB,IAAa,SAAS,UAAU,IAAI,IAAe,IAAU,wDAAwD,MAEjJ,MACF,IAAgB,qCACX,MACH,EAAgB,yBAAyB;KACvC,OAAO,WAAW,EAAY,+BAA+B,EAAa;KAC1E,UAAU;KACV,SAAS;IACX,KAKJ,QAAQ,eACN,KAAK,EAAU,MAAM,EAAY,KAAK,KACtC,IAAa,+FAA+F,EAAY,IACxH,mCACA,CACF,GACA,QAAQ,IAAI,qBAAqB,CAAM,GACnC,KAAK,cAAc,aAAa,OAAO,cAAgB,OACzD,QAAQ,IAAI,qBAAqB,GAAG,YAAY,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,GAEvE,QAAQ,SAAS;IAEjB;GACF;GACA,KAAK,YAAY;IAEf,IAAM,IAAgB;IAItB,IAAI,KAAiB,QAAQ,GAAe;KAC1C,IAAM,IAAW,EAAc;KAK/B,IAAe,iBAJM,OAAO,KAAa,YAAY,IACjD,UACA,OAAO,CAAQ;IAGrB,OAAO,IAAI,KAAiB,cAAc,GAAe;KAEvD,IAAM,IAAkB,WAAW,EAAc,QAAQ;KACzD,IAAI,CAAC,MAAM,CAAe,GAAG;MAC3B,IAAM,IAAe,KAAK,sBAAsB,IAAI,CAAI;MACxD,IAAI,MAAiB,KAAA,KAAa,IAAe,GAAG;OAElD,IAAM,KADO,IAAkB,KACD,IAAgB;OAC9C,AAAI,IAAgB,KAClB,IAAe,oBAAoB,EAAc,QAAQ,CAAC,EAAE,KAAK,EAAc,SAAS,IACxF,IAAgB,wCACP,IAAgB,MACzB,IAAe,kBAAkB,EAAc,QAAQ,CAAC,EAAE,KAAK,EAAc,SAAS,IACtF,IAAgB,yCAEhB,IAAe,kBAAkB,EAAc,SAAS,IACxD,IAAgB;MAEpB,OACE,IAAe,qBAAqB,EAAc,SAAS;MAE7D,KAAK,sBAAsB,IAAI,GAAM,CAAe;KACtD;IACF;IACA;GACF;GACA,KAAK,UAAU;IACb,IAAM,KAAgB,KAAK,sBAAsB,IAAI,CAAI,KAAK,KAAK;IACnE,KAAK,sBAAsB,IAAI,GAAM,CAAY;IAEjD,IAAM,IAAkB,IAAe,IACjC,IAAgB;IAOtB,AAHA,IAAe,gBAHK,KAAiB,cAAc,IAAgB,KAAK,EAAc,SAAS,KAAK,GAGzD,iBAAiB,IAAe,IAAkB,2BAA2B,MACxH,IAAgB,sCAEZ,MAAiB,IAAgB;IACrC;GACF;GACA,KAAK;IAEH,AADA,KAAK,mBAAmB,GACxB,IAAe,0BAA0B,KAAK;IAC9C;GAEF,KAAK,YAAY;IACf,IAAM,IAAiB;IAGvB,IAAI,EAAe,SAEjB,AADA,IAAe,6BACf,IAAgB;SACX,IAAI,EAAe,OAExB,AADA,IAAe,eAAe,EAAe,MAAM,WAAW,mBAC9D,IAAgB;SACX;KAEL,IAAM,IAAU,EAAe;KAM/B,AADA,IAAe,oBAJK,OAAO,KAAY,YAAY,IAC/C,UACA,OAAO,CAAO,EAE6B,IAC/C,IAAgB;IAClB;IACA;GACF;GACA,SACE;EACF;EAaA,AAVA,QAAQ,eACN,KAAK,EAAK,YAAY,EAAE,MAAM,EAAK,KAAK,KACxC,EAAY,IACZ,mCACA,CACF,GACA,QAAQ,IAAI,qBAAqB,CAAM,GACnC,KAAK,cAAc,aAAa,OAAO,cAAgB,OACzD,QAAQ,IAAI,qBAAqB,GAAG,YAAY,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,GAEvE,QAAQ,SAAS;CACnB;CAMA;CAWA,QAAkB,GAAiB,GAAsC;EACvE,AAAI,OAAO,KAAmB,cAAc,CAAC,EAAe,YAC1D,KAAK,UAAU,IAAI,GAAO,CAA4B,IAEtD,KAAK,SAAS,IAAI,GAAO,CAAc;CAC3C;CAUA,OAAiB,GAAoB;EACnC,IAAI,CAAC,GACH,MAAU,MAAM,qFAAqF;EAIvG,IAAM,IAAc;EAEpB,IAAI,KAAK,SAAS,IAAI,CAAW,GAC/B,OAAO,KAAK,SAAS,IAAI,CAAW;EAGtC,IAAI;GACF,IAAM,IAAU,KAAK,UAAU,IAAI,CAAW;GAC9C,IAAI,GAAS;IACX,IAAM,IAAW,EAAQ,IAAI;IAE7B,OADA,KAAK,SAAS,IAAI,GAAa,CAAQ,GAChC;GACT;GACA,IAAI,OAAO,KAAU,cAAc,EAAM,WAAW;IAClD,IAAM,IAAW,IAAK,EAA0C,IAAI;IAEpE,OADA,KAAK,SAAS,IAAI,GAAa,CAAQ,GAChC;GACT;GACA,MAAU,MAAM,sBAAsB,OAAO,CAAK,GAAG;EACvD,SAAS,GAAG;GACV,MAAU,MAAM,yCAAyC,OAAO,CAAK,EAAE,YAAa,GAAa,WAAW,iBAAiB;EAC/H;CACF;CAKA,SAAgB,GAA0B,GAAc,GAAmB;EACpE,KAAK,eAAe,aACzB,KAAK,gBAAgB,KAAK;GAAE;GAAM;GAAM;EAAO,CAAC;CAClD;CAsBA,YAAyB;EACvB,IAAI,CAAC,KAAK,eAAe,aAAa,KAAK,gBAAgB,WAAW,GAAG;EAEzE,IAAM,IAAY,OAAO,cAAgB,MAAc,YAAY,IAAI,IAAI,GACvE,IAAe,KAAK;EAExB,IAAI,KAAK,cAAc,QACrB,IAAI;GACF,IAAI;GACJ,IAAI,KAAK,cAAc,kBAAkB,QACvC,IAAQ,KAAK,cAAc;QACtB;IACL,IAAM,IAAW,KAAK,cAAc,OAAO,QAAQ,YAAY,EAAE;IACjE,IAAQ,IAAI,OAAO,CAAQ;GAC7B;GACA,IAAe,EAAa,QAAO,MAAQ,EAAM,KAAK,EAAK,IAAI,CAAC;EAClE,SAAS,GAAG;GACV,QAAQ,KAAK,yDAAyD,CAAC;EACzE;EAGF,IAAI,EAAa,WAAW,GAAG;GAC7B,KAAK,kBAAkB,CAAC;GACxB;EACF;EAGA,IAAI,IAAe,IACf,IAAY,IACZ,IAAa;EAEjB,IAAI,KAAK,cAAc,aAAa,GAAW;GAE7C,IAAM,IADU,YAAY,IACX,IAAU;GAK3B,IAHA,IAAe,gBAAgB,EAAS,QAAQ,CAAC,EAAE,MAG/C,KAAK,4BAA4B,QAAQ,KAAK,0BAA0B,GAAG;IAE7E,IAAM,KADO,IAAW,KAAK,2BACC,KAAK,0BAA2B;IAE9D,AAAI,IAAgB,MAElB,IAAY,QAAQ,EAAc,QAAQ,CAAC,EAAE,IAC7C,IAAa,wCACJ,IAAgB,OAEzB,IAAY,OAAO,EAAc,QAAQ,CAAC,EAAE,IAC5C,IAAa,yCAGb,IAAY,cACZ,IAAa;GAEjB,OACE,IAAY;GAId,KAAK,0BAA0B;EACjC;EAuBA,AAjBA,QAAQ,eACN,yBAA2B,KAAK,cAAc,eAAe,IAAI,KAAK,cAAc,iBAAiB,GAAG,2BAA2B,EAAa,SAAS,EAAa,KAAK,KAC3K,8FACA,qCACA,CACF,GAGA,EAAa,SAAQ,MAAQ;GAC3B,KAAK,IAAI,EAAK,MAAa,EAAK,MAAM,EAAK,MAAa;EAC1D,CAAC,GAEG,KAAK,cAAc,aAAa,OAAO,cAAgB,OACzD,QAAQ,IAAI,4BAA4B,YAAY,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,oCAAoC,GAGjH,QAAQ,SAAS,GACjB,KAAK,kBAAkB,CAAC;CAC1B;CAWA,OAAiB,GAAiB,GAAsD;EACtF,IAAM,IAAS,MACX,IAAM,GACJ,oBAAc,IAAI,IAAa,GAC/B,IAAU,OAAO,KAAkB,WACrC,EAAE,MAAM,EAAc,IACtB,KAAiB,CAAC,GAChB,IAAO,EAAQ,QAAQ;EAE7B,OAAO;GACL,IAAI,QAAW;IACb,IAAI,EAAO,cAAc;KACvB,IAAM,IAAgB,EAAO;KAI7B,AAAK,EAAY,IAAI,CAAa,MAChC,EAAY,IAAI,CAAa,GAE7B,EAAc,SAAS,UAAU;MAC/B,EAAY,OAAO,CAAa;KAClC,CAAC;IAEL;IAEA,OAAO;GACT;GACA,IAAI,MAAM,GAAa;IACrB,IAAI,MAAQ,GAAU;IAGtB,IAAI,EAAQ,UAAU;KACpB,IAAM,IAAS,EAAQ,SAAS,CAAQ;KACxC,IAAI,MAAW,MAAS,OAAO,KAAW,UAAU;MAClD,IAAM,IAAW,OAAO,KAAW,WAC/B,IACA,0DAA0D,EAAK;MAEnE,QAAQ,MAAM,KAAK,KAAY,qCAAqC;OAClE,UAAU;OACV,SAAS;MACX,CAAC;MACD;KACF;IACF;IAEA,IAAM,IAAM;IAEZ,AADA,IAAM,GACN,EAAO,iBAAiB,GAAM,GAAU,CAAG;IAG3C,IAAM,IAAmB,MAAM,KAAK,CAAW,CAAC,CAAC,KAC9C,MAAM,EAAE,SAAS,gBACpB;IAcA,AAbA,EAAO,WAAW,UAAU,GAAM;KAChC,MAAM;KACN,IAAI;KACJ,kBAAkB,EAAY;KAC9B,aAAa;IACf,CAAC,GAGD,EAAY,SAAQ,MAAK,EAAO,eAAe,IAAI,CAAC,CAAC,GAKhD,EAAO,eACV,EAAO,aAAa,IAEpB,qBAAqB;KAEnB,KAAK,IAAM,KAAa,EAAO,gBAE7B,AADA,EAAO,eAAe,OAAO,CAAS,GACtC,EAAU,IAAI;KAKhB,AAFA,EAAO,aAAa,IAEpB,EAAO,YAAY;IACrB,CAAC;GAEL;GACA,UAAU,GAAsB;IAE9B,OAAO,EAAO,aACN;KACJ,EAAG,KAAK,KAAK;IACf,GACA,GAAG,EAAO,gBAAgB,OAAO,GACnC;GACF;EACF;CACF;CAUA,OAAc,GAAc,GAA2B;EACrD,IAAM,IAAS,MAIX,IAAa,IACX,IAAqB;GACzB;GACA,0BAAU,IAAI,IAAI;GAClB,MAAM;IAKJ,IAAM,IAAgB,MAAM,KAAK,KAAK,QAAQ;IAG9C,AAFA,KAAK,SAAS,MAAM,GAEpB,EAAc,SAAQ,MAAK,EAAE,CAAC;IAE9B,IAAM,IAAO,EAAO;IACpB,EAAO,eAAe;IAEtB,IAAM,IAAY,YAAY,IAAI;IAMlC,AALA,EAAO,QAAQ,YAAY;KACzB,IAAM,IAAU,EAAG;KACnB,AAAI,OAAO,KAAY,cAAY,KAAK,SAAS,IAAI,CAAO;IAC9D,CAAC,GAED,EAAO,eAAe;IAItB,IAAM,IAAW,YAAY,IAAI,IAAI;IACrC,IAAI,CAAC,KAAc,EAAO,eAAe,WAAW;KAClD,IAAM,IAAS,EAAO,cAAc;KAEpC,CAAI,CAAC,KAAW,aAAkB,UAAY,KAAK,SAAS,EAAO,KAAK,KAAK,KAAK,MAC5E,OAAO,EAAO,YAAa,cAC7B,EAAO,SAAS,UAAU,KAAK,SAAS,mBAAmB;MACzD,MAAM,KAAK,SAAS;MACpB,MAAM;MACN,QAAQ;OACN,QAAQ;OACR,UAAU,GAAG,EAAS,QAAQ,CAAC,EAAE;OACjC,WAAW;MACb;KACF,CAAC;IAGP;IAEA,IAAa;GACf;EACF;EAIA,OAHA,KAAK,WAAW,IAAI,CAAS,GAC7B,EAAU,IAAI,SAED;GAGX,AAFA,EAAU,SAAS,SAAQ,MAAK,EAAE,CAAC,GACnC,EAAO,eAAe,OAAO,CAAS,GACtC,EAAO,WAAW,OAAO,CAAS;EACpC;CACF;CAGA,gCAAwB,IAAI,IAA0C;CAItE,kBAA0B,IAAI,sBAC3B,MAAc;EACb,EAAU;CACZ,CACF;CAWA,SAAmB,GAAa,GAAkC;EAChE,IAAI,KAAK,cAAc,IAAI,CAAE,GAAG;GAE9B,IAAM,IADY,KAAK,cAAc,IAAI,CAClB,CAAA,EAAW,MAAM;GACxC,IAAI,GACF,OAAO;EAEX;EAEA,IAAM,IAAS,MACT,IAAO,KAAc,oBAGrB,IAAM,KAAK,OAAU,KAAA,GAA2B,4BAA4B,GAAM,GAEpF,IAAU,IACV,GAKE,IAAoB,KAAK,aAAa;GAO1C,AADA,IAAc,EAAG,GACjB,IAAU;GAGV,IAAM,IADY,OAAO,cAAgB,OAAc,YAAY,IAAI,IACvC,YAAY;GAW5C,AATI,OAAO,EAAO,YAAa,cAC7B,EAAO,SAAS,YAAY,GAAM;IAChC,OAAO;IACP,UAAU;GACZ,CAAC,GAKH,EAAa,QAAQ;EACvB,GAAG,4BAA4B,GAAM,GAE/B,IAAY,MAAM,KAAK,KAAK,UAAU,CAAC,CAAC,KAAK,WAAW,OAAO,IAE/D,UAAuB;GAK3B,AAJA,EAAkB,GACd,KACF,EAAO,WAAW,OAAO,CAAS,GAEpC,EAAO,cAAc,OAAO,CAAE;EAChC,GAEM,IAAgC;GACpC,IAAI,QAAQ;IAQV,OALI,MACF,IAAc,EAAG,GACjB,IAAU,IACV,EAAa,QAAQ,IAEhB,EAAI;GACb;GACA,YAAY,MAAyB,EAAI,UAAU,CAAE;GACrD,UAAU;IAGR,AAFA,EAAkB,GAClB,EAAe,GACf,EAAO,cAAc,OAAO,CAAE;GAChC;EACF;EAKA,OAHA,KAAK,gBAAgB,SAAS,GAAkB,CAAc,GAC9D,KAAK,cAAc,IAAI,GAAI,IAAI,QAAQ,CAAqC,CAAC,GAEtE;CACT;CAmDA,SAAkC,GAAW,IAAe,YAAe;EACzE,IAAI,KAAK,WAAW,IAAI,CAAM,GAC5B,OAAO,KAAK,WAAW,IAAI,CAAM;EAEnC,IAAM,IAAS,MACT,oBAAmB,IAAI,IAAmC,GAE1D,IAAQ,IAAI,MAAM,GAAQ;GAC9B,IAAI,GAAK,GAAM,GAAU;IACvB,IAAI,EAAO,cAAc;KACvB,IAAM,IAAgB,EAAO;KAC7B,AAAK,EAAiB,IAAI,CAAI,KAAG,EAAiB,IAAI,mBAAM,IAAI,IAAI,CAAC;KAErE,IAAM,IAAc,EAAiB,IAAI,CAAI;KAK7C,AAAK,EAAY,IAAI,CAAa,MAChC,EAAY,IAAI,CAAa,GAM7B,EAAc,SAAS,UAJC;MACtB,EAAY,OAAO,CAAa;KAClC,CAEoC;IAExC;IAEA,IAAM,IAAQ,QAAQ,IAAI,GAAK,GAAM,CAAQ;IAC7C,OAA0B,OAAO,KAAU,YAAnC,IACJ,EAAO,SAAS,GAAO,GAAG,EAAK,GAAG,OAAO,CAAI,GAAG,IAChD;GACN;GACA,IAAI,GAAK,GAAM,GAAO,GAAU;IAC9B,IAAM,IAAM,QAAQ,IAAI,GAAK,GAAM,CAAQ;IAC3C,IAAI,MAAQ,GAAO,OAAO;IAE1B,IAAI,MAAQ,GAAO;KAEjB,AADA,QAAQ,IAAI,GAAK,GAAM,GAAO,CAAQ,GACtC,EAAO,iBAAiB,GAAG,EAAK,GAAG,OAAO,CAAI,KAAK,GAAO,CAAG;KAI7D,IAAM,IAAU,EAAiB,IAAI,CAAI;KA2BzC,CA1BqB,IAAU,MAAM,KAAK,CAAO,IAAI,CAAC,EAAA,CAEzC,SAAQ,MAAK;MACxB,AAAI,EAAO,aACT,EAAO,eAAe,IAAI,CAAC,KAK3B,EAAO,eAAe,IAAI,CAAC,GAEtB,EAAO,eACV,EAAO,aAAa,IAEpB,qBAAqB;OACnB,KAAK,IAAM,KAAa,EAAO,gBAE7B,AADA,EAAO,eAAe,OAAO,CAAS,GACtC,EAAU,IAAI;OAGhB,AADA,EAAO,aAAa,IACpB,EAAO,YAAY;MACrB,CAAC;KAGP,CAAC,GAED,EAAO,WAAW,YAAY,GAAG,EAAK,GAAG,OAAO,CAAI,KAAK;MACvD,QAAQ;MACR,UAAU,OAAO,CAAI;MACrB,UAAU;MACV,UAAU;KACZ,CAAC;IACH;IACA,OAAO;GACT;EACF,CAAC;EAED,OADA,KAAK,WAAW,IAAI,GAAQ,CAAK,GAC1B;CACT;CASA,MAAa,GAAsB;EAGjC,EAAG;CACL;CAWA,MAAc,GAAY,GAAoC;EAC5D,OAAO,IAAI,SAAS,GAAS,MAAW;GACtC,IAAI,EAAO,SACT,OAAO,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;GAGzD,IAAM,IAAY,iBAAiB;IAEjC,AADA,EAAO,oBAAoB,SAAS,CAAO,GAC3C,EAAQ;GACV,GAAG,CAAE,GAEC,UAAgB;IAEpB,AADA,aAAa,CAAS,GACtB,EAAO,IAAI,aAAa,WAAW,YAAY,CAAC;GAClD;GAEA,EAAO,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC;EAC1D,CAAC;CACH;CA2DA,SACE,GACA,GACA,GACa;EACb,IAAM,IAAkB,KAAiB,OAAO,KAAkB,UAC5D,IAAa,IACd,EAAwC,OACxC,KAA4B,oBAE3B,IAA0C,IAC3C,IACD,CAAC,GAEC,IAA0B,EAAQ,2BAA2B,IAC7D,IAAmB,EAAQ,kBAC3B,IAAsB,EAAQ,qBAE9B,IAAa,EAAQ,cAAc,GACnC,IAAY,EAAQ,cAAc,KAClC,IAAiB,EAAQ,+BAA+B,IACxD,IAAgB,EAAQ,iBAAiB,KACzC,IAAY,EAAQ,SAGpB,IAAQ,KAAK,OACjB;GAAE,MAAM;GAAM,SAAS;GAAM,OAAO;GAAM,YAAY;EAAM,GAC5D,2CAA2C,GAC7C,GAGM,KAAuB,MAAgC;GAI3D,AAHA,EAAe,QAAQ,GAGnB,OAAO,KAAK,YAAa,cAC3B,KAAK,SAAS,YAAY,GAAY;IACpC,SAAS,EAAU;IACnB,MAAM,EAAU;IAChB,OAAO,EAAU;IACjB,YAAY,EAAU;GACxB,CAAC;EAEL,GAEM,IAAO,OAAO,GAAW,GAA2B,IAAiB,OAAU;GACnF,IAAI,EAAa,SAAS;GAoC1B,IAAI,GAAqB;IACvB,IAAM,IAAsB,EAAoB,CAAM;IACtD,IAAI,MAAwB,MAAS,OAAO,KAAwB,UAAU;KAC5E,IAAI,EAAa,SAAS;KAC1B,IAAM,IAAW,OAAO,KAAwB,WAC5C,IACA,4CAEE,IAAc,IAAiB,OAAO,KAAK,cAAc,EAAM,MAAM,IAAI;KAC/E,EAAoB;MAAE,MAAM;MAAa,SAAS;MAAO,OAAW,MAAM,CAAQ;MAAG,YAAY;KAAM,CAAC;KACxG;IACF;GACF;GAGA,IAAM,IADc,KAAkB,IACJ,OAAO,KAAK,cAAc,EAAM,MAAM,IAAI;GAE5E,EAAoB;IAAE,MAAM;IAAa,SAAS;IAAM,OAAO;IAAM,YAAY;GAAM,CAAC;GAExF,KAAK,IAAI,IAAU,GAAG,KAAW,GAAY,KAAW;IACtD,IAAI,EAAa,SAAS;IAC1B,IAAI,IAAiB;IAErB,IAAI;KACF,IAAI,KAAa,IAAY,GAAG;MAC9B,IAAM,IAAgB,YAAY,QAAQ,CAAS;MACnD,IAAiB,YAAY,IAAI,CAAC,GAAc,CAAa,CAAC;KAChE;KAEA,IAAM,IAAO,MAAM,EAAQ,GAAQ,CAAc;KAEjD,IAAI,EAAa,SAAS;KAE1B,IAAI,EAAe,SACjB,MAAM,IAAI,aAAa,4BAA4B,cAAc;KAGnE,IAAI,GAAkB;MACpB,IAAM,IAAmB,EAAiB,CAAI;MAC9C,IAAI,MAAqB,MAAS,OAAO,KAAqB,UAAU;OACtE,IAAI,EAAa,SAAS;OAE1B,EAAoB;QAAE,MAAM;QAAM,SAAS;QAAO,OAAW,MAD5C,OAAO,KAAqB,WAAW,IAAmB,mBACA;QAAG,YAAY;OAAM,CAAC;OACjG;MACF;KACF;KAEA,IAAI,EAAa,SAAS;KAG1B,EAAoB;MAAE;MAAM,SAAS;MAAO,OAAO;MAAM,YAAY;KAAM,CAAC;KAC5E;IACF,SAAS,GAAQ;KACf,IAAI,EAAa,WAAY,EAAE,SAAS,gBAAgB,EAAa,SAAU;KAE/E,IAAM,IAAY,EAAE,SAAS,kBAAkB,EAAE,SAAS,gBAAgB,EAAE,SAAS,SAAS,SAAS,GAEjG,IAA0B,EAAmB;MACjD,QAAQ,CAAC,EAAE,OAAO;MAAG,aAAa;MAA0C,WAAW;KACzF,CAAC,CAAC,GAAG,OAAO,OAAO,IAGf,IAAuC,KACtC,EAAmB;MACpB,QAAQ,CAAC,EAAE,OAAO;MAAG,aAAa;MAAW,WAAW;KAC1D,CAAC,CAAC,GAAG,MACH,2BAEE,IAA6B,KAA2B,EAAE,SAAS;KAEzE,IAAI,MAAY,KAAc,GAA4B;MACxD,IAAI,EAAa,SAAS;MAE1B,IAAM,IAAa,IACX,MAAM,2BAA2B,EAAU,KAAK,EAAE,OAAO,EAAE,CAAC,IAChE,IACM,MAAM,GAA8B,EAAE,OAAO,EAAE,CAAC,IACpD;MAGN,EAAoB;OAAE,MAAM;OAAM,SAAS;OAAO,OAAO;OAAY,YAAY;MAAM,CAAC;MACxF;KACF,OAAO;MACL,IAAI,EAAa,SAAS;MAE1B,IAAI,IAAe,IAAiB,IAAqB,KAAG,IAAW;MACvE,IAAe,KAAK,IAAI,GAAc,CAAa;MACnD,IAAM,IAAS,KAAK,OAAO,IAAI;MAO/B,AANA,KAA8B,GAG9B,EAAoB;OAAE,MAAM,EAAM,MAAM;OAAM,SAAS;OAAM,OAAO;OAAM,YAAY;MAAK,CAAC,GAG5F,QAAQ,KAAK,qBAAqB,EAAW,YAD3B,IAAY,aAAa,cACwB,YAAY,IAAU,EAAE,GAAG,IAAa,EAAE,IAAI;MAEjH,IAAI;OAEF,IADA,MAAM,KAAK,MAAM,GAAc,CAAY,GACvC,EAAa,SAAS;MAC5B,QAAqB;OACnB;MACF;KACF;IACF;GACF;EACF,GAEI,IAAiD;EAcrD,OAZA,KAAK,aAAa;GAChB,IAAM,IAAS,IAAS,EAAO,QAAQ,KAAA,GACjC,IAAmB,IAAI,gBAAgB;GAO7C,OANA,IAAyB,GAEzB,KAAK,cAAc;IACjB,EAAK,GAAa,EAAiB,QAAQ,EAAI;GACjD,CAAC,SAEY,EAAiB,MAAM;EACtC,GAAG,OAAO,GAEH;GACL,IAAI,OAAO;IAAE,OAAO,EAAM,MAAM;GAAK;GACrC,IAAI,UAAU;IAAE,OAAO,EAAM,MAAM;GAAQ;GAC3C,IAAI,QAAQ;IAAE,OAAO,EAAM,MAAM;GAAM;GACvC,IAAI,aAAa;IAAE,OAAO,EAAM,MAAM;GAAW;GACjD,IAAI,QAAQ;IAAE,OAAO,EAAM;GAAM;GACjC,eAAe;IAGb,AAFA,GAAwB,MAAM,GAC9B,IAAyB,IAAI,gBAAgB,GAC7C,EAAK,IAAS,EAAO,QAAQ,KAAA,GAAgB,EAAuB,QAAQ,EAAK;GACnF;GACA,YAAY,MAAwC,EAAM,UAAU,CAAE;EACxE;CACF;CAUA,QAAkB,GAAgB;EAChC,IAAM,IAAO,KAAK;EAClB,KAAK,eAAe;EACpB,IAAI;GACF,OAAO,EAAG;EACZ,UAAU;GACR,KAAK,eAAe;EACtB;CACF;CAWA,QAAgB,GAAiB,GAAgB;EAC/C,IAAI;GACF,EAAG;EACL,SAAS,GAAO;GACd,QAAQ,MACN,mDACA,wEACA,sBACA,CACF;EAEF;CACF;AACF"}

package/dist/decorators/withCache/withCache.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"withCache.cjs","names":[],"sources":["../../../src/decorators/withCache/withCache.ts"],"sourcesContent":["interface CacheEntry<T> {\n  data: T;\n  timestamp: number;\n}\n\ninterface CacheOptions {\n  /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n  ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего загрузчика данных, специально\n * адаптированный для использования совместно с `engine.resource`.\n *\n * Оборачивает асинхронную функцию `fetcher` в контур кэширования в оперативной памяти (In-Memory Cache).\n * При повторных вызовах с теми же входными параметрами `source` декоратор возвращает сохраненный результат\n * из памяти, если не истекло время жизни записи (TTL), полностью предотвращая избыточные сетевые или дисковые запросы.\n *\n * ### 🧠 Механика кэширования и дедупликации:\n * 1. **Динамическая генерация ключей:** Декоратор автоматически формирует строковый ключ кэша на основе аргумента `source`.\n *    Если в качестве параметров передан сложный объект или массив, применяется `JSON.stringify`, что обеспечивает\n *    глубокое сравнение параметров. Для примитивов используется явное приведение к `String`.\n * 2. **Контроль устаревания (TTL):** Каждая запись в кэше снабжается меткой времени (`timestamp`), которая фиксируется\n *    *после* успешного завершения запроса. При каждом вызове проверяется условие `now - timestamp < ttl`.\n *    Если кэш устарел, он прозрачно перезаписывается свежими данными.\n *\n * @template S Тип входных данных (аргументов) для функции запроса, используемых для генерации ключа кэша.\n * @template T Тип данных, возвращаемых асинхронным `fetcher`-ом (разрешенное значение промиса).\n *\n * @param {(source: S, signal: AbortSignal) => Promise<T>} fetcher Оригинальная асинхронная функция запроса, принимающая параметры и сигнал отмены.\n * @param {CacheOptions} [options={}] Параметры конфигурации кэширования.\n * @param {number} [options.ttl=300000] Время жизни кэша (Time-To-Live) в миллисекундах (по умолчанию 5 минут).\n *\n * @returns {(source: S, signal: AbortSignal) => Promise<T>} Возвращает обернутую асинхронную функцию, возвращающую `Promise<T>` и полностью сохраняющую исходную сигнатуру типов.\n *\n * @example\n * ```typescript\n * import { withCache } from '@pravosleva/reactive-engine';\n *\n * interface FilterParams { category: string; tags: string[]; }\n *\n * const fetchCategories = async (params: FilterParams, signal: AbortSignal) => {\n *   const res = await fetch(`/api/items?cat=${params.category}&tags=${params.tags.join(',')}`, { signal });\n *   return res.json();\n * };\n *\n * // Кэшируем результаты запросов на 1 минуту. Повторные вызовы с одинаковыми тегами не пойдут в сеть.\n * const cachedFetch = withCache(fetchCategories, { ttl: 60 * 1000 });\n *\n * // Интеграция с подсистемой ресурсов вашего реактивного ядра\n * const directoryResource = engine.resource({\n *   fetcher: cachedFetch,\n *   source: () => currentFilters.value // Следит за сигналом фильтров\n * });\n * ```\n *\n * @abstract\n * ### 🚨 Внимание при работе в SSR (Next.js / Nuxt 3)\n * Поскольку структура кэша `cache = new Map()` объявлена на уровне замыкания декоратора, в среде выполнения\n * на сервере Node.js этот экземпляр кэша будет **общим для всех HTTP-запросов**, если декоратор создан\n * как глобальный синглтон.\n * - Для предотвращения утечек данных между пользователями в SSR-среде создавайте обернутую функцию `withCache`\n *   **строго внутри локального request-scoped контекста** (например, внутри плагинов или компонентов),\n *   либо используйте её исключительно на стороне клиента (CSR).\n *\n * ### 🧪 Совместимость с Fake Timers\n * В коде используется нативный `Date.now()`, что обеспечивает 100% стабильность работы при тестировании\n * кэша через имитацию времени в Vitest / Jest с помощью функций `vi.useFakeTimers()` и `vi.advanceTimersByTime()`.\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"],"mappings":"AAqEA,IAAa,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"}
+{"version":3,"file":"withCache.cjs","names":[],"sources":["../../../src/decorators/withCache/withCache.ts"],"sourcesContent":["interface CacheEntry<T> {\n  data: T;\n  timestamp: number;\n}\n\ninterface CacheOptions {\n  /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n  ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего загрузчика данных, специально\n * адаптированный для использования совместно с `engine.resource`.\n *\n * Оборачивает асинхронную функцию `fetcher` в контур кэширования в оперативной памяти (In-Memory Cache).\n * При повторных вызовах с теми же входными параметрами `source` декоратор возвращает сохраненный результат\n * из памяти, если не истекло время жизни записи (TTL), полностью предотвращая избыточные сетевые или дисковые запросы.\n *\n * ### 🧠 Механика кэширования и дедупликации:\n * 1. **Динамическая генерация ключей:** Декоратор автоматически формирует строковый ключ кэша на основе аргумента `source`.\n *    Если в качестве параметров передан сложный объект или массив, применяется `JSON.stringify`, что обеспечивает\n *    глубокое сравнение параметров. Для примитивов используется явное приведение к `String`.\n * 2. **Контроль устаревания (TTL):** Каждая запись в кэше снабжается меткой времени (`timestamp`), которая фиксируется\n *    *после* успешного завершения запроса. При каждом вызове проверяется условие `now - timestamp < ttl`.\n *    Если кэш устарел, он прозрачно перезаписывается свежими данными.\n *\n * @template S Тип входных данных (аргументов) для функции запроса, используемых для генерации ключа кэша.\n * @template T Тип данных, возвращаемых асинхронным `fetcher`-ом (разрешенное значение промиса).\n *\n * @param {(source: S, signal: AbortSignal) => Promise<T>} fetcher Оригинальная асинхронная функция запроса, принимающая параметры и сигнал отмены.\n * @param {CacheOptions} [options={}] Параметры конфигурации кэширования.\n * @param {number} [options.ttl=300000] Время жизни кэша (Time-To-Live) в миллисекундах (по умолчанию 5 минут).\n *\n * @returns {(source: S, signal: AbortSignal) => Promise<T>} Возвращает обернутую асинхронную функцию, возвращающую `Promise<T>` и полностью сохраняющую исходную сигнатуру типов.\n *\n * @example\n * ```typescript\n * import { withCache } from '@pravosleva/reactive-engine';\n *\n * interface FilterParams { category: string; tags: string[]; }\n *\n * const fetchCategories = async (params: FilterParams, signal: AbortSignal) => {\n *   const res = await fetch(`/api/items?cat=${params.category}&tags=${params.tags.join(',')}`, { signal });\n *   return res.json();\n * };\n *\n * // Кэшируем результаты запросов на 1 минуту. Повторные вызовы с одинаковыми тегами не пойдут в сеть.\n * const cachedFetch = withCache(fetchCategories, { ttl: 60 * 1000 });\n *\n * // Интеграция с подсистемой ресурсов вашего реактивного ядра\n * const directoryResource = engine.resource(\n *   fetcher: cachedFetch,\n *   source: () => currentFilters.value // Следит за сигналом фильтров\n * );\n * ```\n *\n * @abstract\n * ### 🚨 Внимание при работе в SSR (Next.js / Nuxt 3)\n * Поскольку структура кэша `cache = new Map()` объявлена на уровне замыкания декоратора, в среде выполнения\n * на сервере Node.js этот экземпляр кэша будет **общим для всех HTTP-запросов**, если декоратор создан\n * как глобальный синглтон.\n * - Для предотвращения утечек данных между пользователями в SSR-среде создавайте обернутую функцию `withCache`\n *   **строго внутри локального request-scoped контекста** (например, внутри плагинов или компонентов),\n *   либо используйте её исключительно на стороне клиента (CSR).\n *\n * ### 🧪 Совместимость с Fake Timers\n * В коде используется нативный `Date.now()`, что обеспечивает 100% стабильность работы при тестировании\n * кэша через имитацию времени в Vitest / Jest с помощью функций `vi.useFakeTimers()` и `vi.advanceTimersByTime()`.\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"],"mappings":"AAqEA,IAAa,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"}

package/dist/decorators/withCache/withCache.d.ts

@@ -42,10 +42,10 @@ interface CacheOptions {
  * const cachedFetch = withCache(fetchCategories, { ttl: 60 * 1000 });
  *
  * // Интеграция с подсистемой ресурсов вашего реактивного ядра
- * const directoryResource = engine.resource({
+ * const directoryResource = engine.resource(
  *   fetcher: cachedFetch,
  *   source: () => currentFilters.value // Следит за сигналом фильтров
- * });
+ * );
  * ```
  *
  * @abstract

package/dist/decorators/withCache/withCache.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"withCache.mjs","names":[],"sources":["../../../src/decorators/withCache/withCache.ts"],"sourcesContent":["interface CacheEntry<T> {\n  data: T;\n  timestamp: number;\n}\n\ninterface CacheOptions {\n  /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n  ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего загрузчика данных, специально\n * адаптированный для использования совместно с `engine.resource`.\n *\n * Оборачивает асинхронную функцию `fetcher` в контур кэширования в оперативной памяти (In-Memory Cache).\n * При повторных вызовах с теми же входными параметрами `source` декоратор возвращает сохраненный результат\n * из памяти, если не истекло время жизни записи (TTL), полностью предотвращая избыточные сетевые или дисковые запросы.\n *\n * ### 🧠 Механика кэширования и дедупликации:\n * 1. **Динамическая генерация ключей:** Декоратор автоматически формирует строковый ключ кэша на основе аргумента `source`.\n *    Если в качестве параметров передан сложный объект или массив, применяется `JSON.stringify`, что обеспечивает\n *    глубокое сравнение параметров. Для примитивов используется явное приведение к `String`.\n * 2. **Контроль устаревания (TTL):** Каждая запись в кэше снабжается меткой времени (`timestamp`), которая фиксируется\n *    *после* успешного завершения запроса. При каждом вызове проверяется условие `now - timestamp < ttl`.\n *    Если кэш устарел, он прозрачно перезаписывается свежими данными.\n *\n * @template S Тип входных данных (аргументов) для функции запроса, используемых для генерации ключа кэша.\n * @template T Тип данных, возвращаемых асинхронным `fetcher`-ом (разрешенное значение промиса).\n *\n * @param {(source: S, signal: AbortSignal) => Promise<T>} fetcher Оригинальная асинхронная функция запроса, принимающая параметры и сигнал отмены.\n * @param {CacheOptions} [options={}] Параметры конфигурации кэширования.\n * @param {number} [options.ttl=300000] Время жизни кэша (Time-To-Live) в миллисекундах (по умолчанию 5 минут).\n *\n * @returns {(source: S, signal: AbortSignal) => Promise<T>} Возвращает обернутую асинхронную функцию, возвращающую `Promise<T>` и полностью сохраняющую исходную сигнатуру типов.\n *\n * @example\n * ```typescript\n * import { withCache } from '@pravosleva/reactive-engine';\n *\n * interface FilterParams { category: string; tags: string[]; }\n *\n * const fetchCategories = async (params: FilterParams, signal: AbortSignal) => {\n *   const res = await fetch(`/api/items?cat=${params.category}&tags=${params.tags.join(',')}`, { signal });\n *   return res.json();\n * };\n *\n * // Кэшируем результаты запросов на 1 минуту. Повторные вызовы с одинаковыми тегами не пойдут в сеть.\n * const cachedFetch = withCache(fetchCategories, { ttl: 60 * 1000 });\n *\n * // Интеграция с подсистемой ресурсов вашего реактивного ядра\n * const directoryResource = engine.resource({\n *   fetcher: cachedFetch,\n *   source: () => currentFilters.value // Следит за сигналом фильтров\n * });\n * ```\n *\n * @abstract\n * ### 🚨 Внимание при работе в SSR (Next.js / Nuxt 3)\n * Поскольку структура кэша `cache = new Map()` объявлена на уровне замыкания декоратора, в среде выполнения\n * на сервере Node.js этот экземпляр кэша будет **общим для всех HTTP-запросов**, если декоратор создан\n * как глобальный синглтон.\n * - Для предотвращения утечек данных между пользователями в SSR-среде создавайте обернутую функцию `withCache`\n *   **строго внутри локального request-scoped контекста** (например, внутри плагинов или компонентов),\n *   либо используйте её исключительно на стороне клиента (CSR).\n *\n * ### 🧪 Совместимость с Fake Timers\n * В коде используется нативный `Date.now()`, что обеспечивает 100% стабильность работы при тестировании\n * кэша через имитацию времени в Vitest / Jest с помощью функций `vi.useFakeTimers()` и `vi.advanceTimersByTime()`.\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"],"mappings":";AAqEA,IAAa,KACX,GACA,IAAwB,CAAC,MACtB;CACH,IAAM,IAAM,EAAQ,OAAO,MAAS,KAC9B,oBAAQ,IAAI,IAA2B;CAE7C,OAAO,OAAO,GAAW,MAAoC;EAE3D,IAAM,IAAW,OAAO,KAAW,YAAY,IAC3C,KAAK,UAAU,CAAM,IACrB,OAAO,CAAM,GAEX,IAAM,KAAK,IAAI,GACf,IAAS,EAAM,IAAI,CAAQ;EAGjC,IAAI,KAAW,IAAM,EAAO,YAAY,GACtC,OAAO,EAAO;EAIhB,IAAM,IAAY,MAAM,EAAQ,GAAQ,CAAM;EAQ9C,OALA,EAAM,IAAI,GAAU;GAClB,MAAM;GACN,WAAW,KAAK,IAAI;EACtB,CAAC,GAEM;CACT;AACF"}
+{"version":3,"file":"withCache.mjs","names":[],"sources":["../../../src/decorators/withCache/withCache.ts"],"sourcesContent":["interface CacheEntry<T> {\n  data: T;\n  timestamp: number;\n}\n\ninterface CacheOptions {\n  /** Время жизни кэша в миллисекундах. По умолчанию 5 минут (300000 мс) */\n  ttl?: number;\n}\n\n/**\n * Декоратор для создания кэширующего загрузчика данных, специально\n * адаптированный для использования совместно с `engine.resource`.\n *\n * Оборачивает асинхронную функцию `fetcher` в контур кэширования в оперативной памяти (In-Memory Cache).\n * При повторных вызовах с теми же входными параметрами `source` декоратор возвращает сохраненный результат\n * из памяти, если не истекло время жизни записи (TTL), полностью предотвращая избыточные сетевые или дисковые запросы.\n *\n * ### 🧠 Механика кэширования и дедупликации:\n * 1. **Динамическая генерация ключей:** Декоратор автоматически формирует строковый ключ кэша на основе аргумента `source`.\n *    Если в качестве параметров передан сложный объект или массив, применяется `JSON.stringify`, что обеспечивает\n *    глубокое сравнение параметров. Для примитивов используется явное приведение к `String`.\n * 2. **Контроль устаревания (TTL):** Каждая запись в кэше снабжается меткой времени (`timestamp`), которая фиксируется\n *    *после* успешного завершения запроса. При каждом вызове проверяется условие `now - timestamp < ttl`.\n *    Если кэш устарел, он прозрачно перезаписывается свежими данными.\n *\n * @template S Тип входных данных (аргументов) для функции запроса, используемых для генерации ключа кэша.\n * @template T Тип данных, возвращаемых асинхронным `fetcher`-ом (разрешенное значение промиса).\n *\n * @param {(source: S, signal: AbortSignal) => Promise<T>} fetcher Оригинальная асинхронная функция запроса, принимающая параметры и сигнал отмены.\n * @param {CacheOptions} [options={}] Параметры конфигурации кэширования.\n * @param {number} [options.ttl=300000] Время жизни кэша (Time-To-Live) в миллисекундах (по умолчанию 5 минут).\n *\n * @returns {(source: S, signal: AbortSignal) => Promise<T>} Возвращает обернутую асинхронную функцию, возвращающую `Promise<T>` и полностью сохраняющую исходную сигнатуру типов.\n *\n * @example\n * ```typescript\n * import { withCache } from '@pravosleva/reactive-engine';\n *\n * interface FilterParams { category: string; tags: string[]; }\n *\n * const fetchCategories = async (params: FilterParams, signal: AbortSignal) => {\n *   const res = await fetch(`/api/items?cat=${params.category}&tags=${params.tags.join(',')}`, { signal });\n *   return res.json();\n * };\n *\n * // Кэшируем результаты запросов на 1 минуту. Повторные вызовы с одинаковыми тегами не пойдут в сеть.\n * const cachedFetch = withCache(fetchCategories, { ttl: 60 * 1000 });\n *\n * // Интеграция с подсистемой ресурсов вашего реактивного ядра\n * const directoryResource = engine.resource(\n *   fetcher: cachedFetch,\n *   source: () => currentFilters.value // Следит за сигналом фильтров\n * );\n * ```\n *\n * @abstract\n * ### 🚨 Внимание при работе в SSR (Next.js / Nuxt 3)\n * Поскольку структура кэша `cache = new Map()` объявлена на уровне замыкания декоратора, в среде выполнения\n * на сервере Node.js этот экземпляр кэша будет **общим для всех HTTP-запросов**, если декоратор создан\n * как глобальный синглтон.\n * - Для предотвращения утечек данных между пользователями в SSR-среде создавайте обернутую функцию `withCache`\n *   **строго внутри локального request-scoped контекста** (например, внутри плагинов или компонентов),\n *   либо используйте её исключительно на стороне клиента (CSR).\n *\n * ### 🧪 Совместимость с Fake Timers\n * В коде используется нативный `Date.now()`, что обеспечивает 100% стабильность работы при тестировании\n * кэша через имитацию времени в Vitest / Jest с помощью функций `vi.useFakeTimers()` и `vi.advanceTimersByTime()`.\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"],"mappings":";AAqEA,IAAa,KACX,GACA,IAAwB,CAAC,MACtB;CACH,IAAM,IAAM,EAAQ,OAAO,MAAS,KAC9B,oBAAQ,IAAI,IAA2B;CAE7C,OAAO,OAAO,GAAW,MAAoC;EAE3D,IAAM,IAAW,OAAO,KAAW,YAAY,IAC3C,KAAK,UAAU,CAAM,IACrB,OAAO,CAAM,GAEX,IAAM,KAAK,IAAI,GACf,IAAS,EAAM,IAAI,CAAQ;EAGjC,IAAI,KAAW,IAAM,EAAO,YAAY,GACtC,OAAO,EAAO;EAIhB,IAAM,IAAY,MAAM,EAAQ,GAAQ,CAAM;EAQ9C,OALA,EAAM,IAAI,GAAU;GAClB,MAAM;GACN,WAAW,KAAK,IAAI;EACtB,CAAC,GAEM;CACT;AACF"}

package/dist/decorators/withDebounce/withDebounce.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"withDebounce.cjs","names":[],"sources":["../../../src/decorators/withDebounce/withDebounce.ts"],"sourcesContent":["interface DebounceOptions {\n  /** Задержка в миллисекундах. По умолчанию 300 мс */\n  delay?: number;\n}\n\n/**\n * Декоратор для создания дебаунсящего (отложенного) загрузчика данных, специально\n * адаптированный для использования совместно с `engine.resource`.\n *\n * Откладывает выполнение асинхронной функции `fetcher` на заданную задержку `options.delay`.\n * Если в течение этого интервала происходит новый вызов (например, пользователь продолжает вводить текст),\n * таймер сбрасывается, а предыдущий ожидающий промис принудительно отклоняется. В итоге выполняется\n * только один запрос — после того, как поток вызовов затихнет.\n *\n * ### 🧠 Механика управления промисами (Контур Debounce):\n * 1. **Сброс дребезга:** При каждом вызове функции проверяется наличие активного таймера. Если он есть,\n *    `clearTimeout` мгновенно останавливает его.\n * 2. **Каскадное отклонение:** Ссылка на метод `reject` каждого создаваемого промиса сохраняется в `rejectPrevious`.\n *    При поступлении нового запроса предыдущий промис не остается «зависшим», а принудительно переходит\n *    в состояние `rejected` с ошибкой `AbortError`. Это сигнализирует ядру, что данные устарели.\n * 3. **Чистый запуск:** Оригинальный `fetcher` вызывается только тогда, когда таймер успешно дотикал до конца,\n *    не будучи прерванным.\n *\n * @template S Тип входных данных (аргументов) для функции запроса.\n * @template T Тип данных, возвращаемых асинхронным `fetcher`-ом (разрешенное значение промиса).\n *\n * @param {(source: S, signal: AbortSignal) => Promise<T>} fetcher Оригинальная асинхронная функция запроса, принимающая параметры и сигнал отмены.\n * @param {DebounceOptions} [options={}] Параметры конфигурации дебаунса.\n * @param {number} [options.delay=300] Время ожидания в миллисекундах с момента последнего вызова до фактического старта запроса.\n *\n * @returns {(source: S, signal: AbortSignal) => Promise<T>} Возвращает обернутую дебаунс-функцию, возвращающую `Promise<T>` и полностью сохраняющую исходную сигнатуру типов.\n *\n * @example\n * ```typescript\n * import { withDebounce } from '@pravosleva/reactive-engine';\n *\n * const searchProducts = async (query: string, signal: AbortSignal) => {\n *   const res = await fetch(`/api/products?search=${encodeURIComponent(query)}`, { signal });\n *   return res.json();\n * };\n *\n * // Запрос уйдет только через 400мс после того, как пользователь перестанет нажимать клавиши\n * const debouncedFetch = withDebounce(searchProducts, { delay: 400 });\n *\n * // Интеграция с фабрикой ресурсов вашего реактивного ядра\n * const productSearchResource = engine.resource({\n *   fetcher: debouncedFetch,\n *   source: () => searchInputValue.value // Следит за сигналом строки ввода\n * });\n * ```\n *\n * @abstract\n * ### 🚨 Сквозная интеграция с AbortSignal и менеджмент памяти\n * Декоратор непрерывно отслеживает состояние нативного `AbortSignal`, передаваемого движком (например, при размонтировании UI-виджета):\n * - Если сигнал переходит в состояние `aborted` во время отсчета таймаута дебаунса, таймер сбрасывается,\n *   а промис мгновенно отклоняется.\n * - При успешном выполнении таймера слушатель `abort` своевременно удаляется через `removeEventListener`,\n *   исключая накопление холостых подписок.\n * - Все внутренние ссылки на методы разрешения промисов (`rejectPrevious`, `timeoutId`) принудительно зануляются (`null`),\n *   очищая замыкания от застрявших в памяти объектов и защищая Node.js/браузер от утечек.\n */\nexport const withDebounce = <S, T>(\n  fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n  options: DebounceOptions = {}\n) => {\n  const delay = options.delay ?? 300\n\n  // Храним ссылку на активный таймер текущего ожидания\n  let timeoutId: ReturnType<typeof setTimeout> | null = null\n  // Храним функцию отмены для предыдущего неоконченного промиса ожидания\n  let rejectPrevious: ((reason: any) => void) | null = null\n\n  return (source: S, signal: AbortSignal): Promise<T> => {\n    // 1. Если уже идет ожидание другого запроса — отменяем его промис и очищаем таймер\n    if (timeoutId) {\n      clearTimeout(timeoutId)\n    }\n    if (rejectPrevious) {\n      // Бросаем DOMException, имитируя нативную отмену fetch, чтобы движок понял, что запрос прерван\n      rejectPrevious(new DOMException('Aborted due to debounce', 'AbortError'))\n    }\n\n    return new Promise<T>((resolve, reject) => {\n      // Сохраняем ссылку на reject текущего промиса, чтобы его мог отменить следующий вызов\n      rejectPrevious = reject\n\n      // 2. Слушаем нативный AbortSignal от движка (например, если компонент размонтировался во время дебаунса)\n      const onAbort = () => {\n        if (timeoutId) clearTimeout(timeoutId)\n        reject(new DOMException('Aborted by resource signal', 'AbortError'))\n      }\n\n      if (signal.aborted) {\n        return onAbort()\n      }\n      signal.addEventListener('abort', onAbort)\n\n      // 3. Взводим отложенный таймер выполнения\n      timeoutId = setTimeout(async () => {\n        // Убираем слушатель, так как таймаут успешно дождался конца\n        signal.removeEventListener('abort', onAbort)\n        rejectPrevious = null\n        timeoutId = null\n\n        try {\n          // 4. Запускаем оригинальный fetcher\n          const data = await fetcher(source, signal)\n          resolve(data)\n        } catch (error) {\n          reject(error)\n        }\n      }, delay)\n    })\n  }\n}\n"],"mappings":"AA6DA,IAAa,GACX,EACA,EAA2B,CAAC,IACzB,CACH,IAAM,EAAQ,EAAQ,OAAS,IAG3B,EAAkD,KAElD,EAAiD,KAErD,OAAQ,EAAW,KAEb,GACF,aAAa,CAAS,EAEpB,GAEF,EAAe,IAAI,aAAa,0BAA2B,YAAY,CAAC,EAGnE,IAAI,SAAY,EAAS,IAAW,CAEzC,EAAiB,EAGjB,IAAM,MAAgB,CAChB,GAAW,aAAa,CAAS,EACrC,EAAO,IAAI,aAAa,6BAA8B,YAAY,CAAC,CACrE,EAEA,GAAI,EAAO,QACT,OAAO,EAAQ,EAEjB,EAAO,iBAAiB,QAAS,CAAO,EAGxC,EAAY,WAAW,SAAY,CAEjC,EAAO,oBAAoB,QAAS,CAAO,EAC3C,EAAiB,KACjB,EAAY,KAEZ,GAAI,CAGF,EAAQ,MADW,EAAQ,EAAQ,CAAM,CAC7B,CACd,OAAS,EAAO,CACd,EAAO,CAAK,CACd,CACF,EAAG,CAAK,CACV,CAAC,EAEL"}
+{"version":3,"file":"withDebounce.cjs","names":[],"sources":["../../../src/decorators/withDebounce/withDebounce.ts"],"sourcesContent":["interface DebounceOptions {\n  /** Задержка в миллисекундах. По умолчанию 300 мс */\n  delay?: number;\n}\n\n/**\n * Декоратор для создания дебаунсящего (отложенного) загрузчика данных, специально\n * адаптированный для использования совместно с `engine.resource`.\n *\n * Откладывает выполнение асинхронной функции `fetcher` на заданную задержку `options.delay`.\n * Если в течение этого интервала происходит новый вызов (например, пользователь продолжает вводить текст),\n * таймер сбрасывается, а предыдущий ожидающий промис принудительно отклоняется. В итоге выполняется\n * только один запрос — после того, как поток вызовов затихнет.\n *\n * ### 🧠 Механика управления промисами (Контур Debounce):\n * 1. **Сброс дребезга:** При каждом вызове функции проверяется наличие активного таймера. Если он есть,\n *    `clearTimeout` мгновенно останавливает его.\n * 2. **Каскадное отклонение:** Ссылка на метод `reject` каждого создаваемого промиса сохраняется в `rejectPrevious`.\n *    При поступлении нового запроса предыдущий промис не остается «зависшим», а принудительно переходит\n *    в состояние `rejected` с ошибкой `AbortError`. Это сигнализирует ядру, что данные устарели.\n * 3. **Чистый запуск:** Оригинальный `fetcher` вызывается только тогда, когда таймер успешно дотикал до конца,\n *    не будучи прерванным.\n *\n * @template S Тип входных данных (аргументов) для функции запроса.\n * @template T Тип данных, возвращаемых асинхронным `fetcher`-ом (разрешенное значение промиса).\n *\n * @param {(source: S, signal: AbortSignal) => Promise<T>} fetcher Оригинальная асинхронная функция запроса, принимающая параметры и сигнал отмены.\n * @param {DebounceOptions} [options={}] Параметры конфигурации дебаунса.\n * @param {number} [options.delay=300] Время ожидания в миллисекундах с момента последнего вызова до фактического старта запроса.\n *\n * @returns {(source: S, signal: AbortSignal) => Promise<T>} Возвращает обернутую дебаунс-функцию, возвращающую `Promise<T>` и полностью сохраняющую исходную сигнатуру типов.\n *\n * @example\n * ```typescript\n * import { withDebounce } from '@pravosleva/reactive-engine';\n *\n * const searchProducts = async (query: string, signal: AbortSignal) => {\n *   const res = await fetch(`/api/products?search=${encodeURIComponent(query)}`, { signal });\n *   return res.json();\n * };\n *\n * // Запрос уйдет только через 400мс после того, как пользователь перестанет нажимать клавиши\n * const debouncedFetch = withDebounce(searchProducts, { delay: 400 });\n *\n * // Интеграция с фабрикой ресурсов вашего реактивного ядра\n * const productSearchResource = engine.resource(\n *   fetcher: debouncedFetch,\n *   source: () => searchInputValue.value // Следит за сигналом строки ввода\n * );\n * ```\n *\n * @abstract\n * ### 🚨 Сквозная интеграция с AbortSignal и менеджмент памяти\n * Декоратор непрерывно отслеживает состояние нативного `AbortSignal`, передаваемого движком (например, при размонтировании UI-виджета):\n * - Если сигнал переходит в состояние `aborted` во время отсчета таймаута дебаунса, таймер сбрасывается,\n *   а промис мгновенно отклоняется.\n * - При успешном выполнении таймера слушатель `abort` своевременно удаляется через `removeEventListener`,\n *   исключая накопление холостых подписок.\n * - Все внутренние ссылки на методы разрешения промисов (`rejectPrevious`, `timeoutId`) принудительно зануляются (`null`),\n *   очищая замыкания от застрявших в памяти объектов и защищая Node.js/браузер от утечек.\n */\nexport const withDebounce = <S, T>(\n  fetcher: (source: S, signal: AbortSignal) => Promise<T>,\n  options: DebounceOptions = {}\n) => {\n  const delay = options.delay ?? 300\n\n  // Храним ссылку на активный таймер текущего ожидания\n  let timeoutId: ReturnType<typeof setTimeout> | null = null\n  // Храним функцию отмены для предыдущего неоконченного промиса ожидания\n  let rejectPrevious: ((reason: any) => void) | null = null\n\n  return (source: S, signal: AbortSignal): Promise<T> => {\n    // 1. Если уже идет ожидание другого запроса — отменяем его промис и очищаем таймер\n    if (timeoutId) {\n      clearTimeout(timeoutId)\n    }\n    if (rejectPrevious) {\n      // Бросаем DOMException, имитируя нативную отмену fetch, чтобы движок понял, что запрос прерван\n      rejectPrevious(new DOMException('Aborted due to debounce', 'AbortError'))\n    }\n\n    return new Promise<T>((resolve, reject) => {\n      // Сохраняем ссылку на reject текущего промиса, чтобы его мог отменить следующий вызов\n      rejectPrevious = reject\n\n      // 2. Слушаем нативный AbortSignal от движка (например, если компонент размонтировался во время дебаунса)\n      const onAbort = () => {\n        if (timeoutId) clearTimeout(timeoutId)\n        reject(new DOMException('Aborted by resource signal', 'AbortError'))\n      }\n\n      if (signal.aborted) {\n        return onAbort()\n      }\n      signal.addEventListener('abort', onAbort)\n\n      // 3. Взводим отложенный таймер выполнения\n      timeoutId = setTimeout(async () => {\n        // Убираем слушатель, так как таймаут успешно дождался конца\n        signal.removeEventListener('abort', onAbort)\n        rejectPrevious = null\n        timeoutId = null\n\n        try {\n          // 4. Запускаем оригинальный fetcher\n          const data = await fetcher(source, signal)\n          resolve(data)\n        } catch (error) {\n          reject(error)\n        }\n      }, delay)\n    })\n  }\n}\n"],"mappings":"AA6DA,IAAa,GACX,EACA,EAA2B,CAAC,IACzB,CACH,IAAM,EAAQ,EAAQ,OAAS,IAG3B,EAAkD,KAElD,EAAiD,KAErD,OAAQ,EAAW,KAEb,GACF,aAAa,CAAS,EAEpB,GAEF,EAAe,IAAI,aAAa,0BAA2B,YAAY,CAAC,EAGnE,IAAI,SAAY,EAAS,IAAW,CAEzC,EAAiB,EAGjB,IAAM,MAAgB,CAChB,GAAW,aAAa,CAAS,EACrC,EAAO,IAAI,aAAa,6BAA8B,YAAY,CAAC,CACrE,EAEA,GAAI,EAAO,QACT,OAAO,EAAQ,EAEjB,EAAO,iBAAiB,QAAS,CAAO,EAGxC,EAAY,WAAW,SAAY,CAEjC,EAAO,oBAAoB,QAAS,CAAO,EAC3C,EAAiB,KACjB,EAAY,KAEZ,GAAI,CAGF,EAAQ,MADW,EAAQ,EAAQ,CAAM,CAC7B,CACd,OAAS,EAAO,CACd,EAAO,CAAK,CACd,CACF,EAAG,CAAK,CACV,CAAC,EAEL"}