@endge/utils 0.25.6 → 0.26.1

package/dist/collection/collection.d.ts

@@ -1,9 +1,9 @@
 import { CollectionEntity, CollectionEvents } from './collection.types';
-import { ChangeNotifier } from '../events/ChangeNotifier';
+import { Subscribable } from '../events/Subscribable';
 /**
  * Описывает ответственность Collection в архитектуре проекта.
  */
-export declare class Collection<T extends CollectionEntity> extends ChangeNotifier {
+export declare class Collection<T extends CollectionEntity> extends Subscribable {
     private _items;
     private _indices;
     private _rootIds;

package/dist/events/Subscribable.d.ts

@@ -0,0 +1,12 @@
+/** Минимальный framework-independent contract объекта с подпиской на изменения. */
+export interface SubscribableLike {
+    subscribe: (listener: () => void) => () => void;
+}
+/** Публикует изменения владельца состояния без зависимости от UI framework. */
+export declare class Subscribable implements SubscribableLike {
+    private readonly _subscribers;
+    /** Подписывает listener и возвращает идемпотентную функцию отписки. */
+    subscribe(listener: () => void): () => void;
+    /** Уведомляет текущих подписчиков об изменении владельца состояния. */
+    notify(): void;
+}

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export * from './collection/indexed-collection';
 export * from './collection/RingBuffer';
 export * from './database/PayloadHttpClient';
 export * from './events/EventBus';
+export * from './events/Subscribable';
 export * from './execute/delay-executor';
 export * from './execute/NamedExecutor';
 export * from './serialize/decorators/json';
@@ -15,8 +16,8 @@ export * from './serialize/decorators/typeRecord';
 export * from './serialize/Serialize';
 export * from './shared/serialize/decorator';
 export { toInstance, toPlain } from './shared/serialize/parse';
-export { isNullOrUndefined } from './shared/types/maybe';
-export type { Maybe as SharedMaybe } from './shared/types/maybe';
+export { isNullOrUndefined } from './shared/types/Maybe';
+export type { Maybe as SharedMaybe } from './shared/types/Maybe';
 export * from './tools/compare';
 export * from './tools/console';
 export * from './tools/debug';

package/dist/shared/types/getter-fn.d.ts

@@ -1,3 +1,3 @@
-import { Maybe } from './maybe';
+import { Maybe } from './Maybe';
 type GetterFn<T> = (x: T) => Maybe<T>;
 export default GetterFn;

package/dist/shared/utils/compare.d.ts

@@ -1 +1 @@
-export declare function compareNumber(a: any, b: any): number;
+export declare function compareNumber(a: number, b: number): number;

package/dist/shared/utils/time.d.ts

@@ -8,8 +8,8 @@ export declare function isDateInRange(date: Date, validFrom: Date, validTo: Date
 export declare const parseDate: (isoString: string) => "" | Date;
 export declare function formatDatetime(date: Date, formatString?: string, options?: {}): string;
 export declare function formatDatetimeTZ(date: Date | string | object, formatString?: string, options?: {}, isLocalTime?: boolean): string;
-export declare function getDayOfWeek(date: any): string;
-export declare function formatDateToMSK(date: any): string;
+export declare function getDayOfWeek(date: Date | number): string;
+export declare function formatDateToMSK(date: Date | string | number): string;
 export declare function extractTime(date: Date | string | object, isLocalTime?: boolean): string;
 export declare function findMinMaxDates(dates: Set<Date>): {
     minDate: Date;
@@ -26,9 +26,9 @@ export declare function toIsoZDate(value: string): string | null;
 export declare function toIsoZDateTime(value: string): string | null;
 export declare function isoToDateInput(value: unknown): string;
 export declare function isoToDateTimeLocalInput(value: unknown): string;
-/** Formats a DateTime as `HH:mm` in the configured IANA timezone or browser-local timezone. */
+/** Форматирует DateTime как `HH:mm` в настроенном часовом поясе IANA или локальном поясе браузера. */
 export declare function isoDateTimeToTimeInput(value: unknown, timezone?: unknown): string;
-/** Replaces only hours and minutes while preserving the DateTime calendar date in the selected timezone. */
+/** Заменяет только часы и минуты, сохраняя календарную дату DateTime в выбранном часовом поясе. */
 export declare function mergeTimeIntoDateTime(value: unknown, time: unknown, timezone?: unknown): string | null;
 export declare function timeToTimeInput(value: unknown): string;
 export declare function toTimeHHMMSS(value: unknown): string | null;

package/dist/tools/console.d.ts

@@ -1,4 +1,4 @@
-/** Returns a bounded string without traversing or retaining the supplied value. */
+/** Возвращает строку ограниченной длины без обхода или удержания переданного значения. */
 export declare function consoleValueSummary(value: unknown): string;
-/** Returns Error metadata as text without forwarding the Error object to Console. */
+/** Возвращает метаданные Error как текст, не передавая объект Error в Console. */
 export declare function consoleErrorSummary(error: unknown): string;

package/dist/tools/keyboard.d.ts

@@ -15,7 +15,7 @@ export interface KeyboardStateSnapshot {
         code: string[];
     };
 }
-/** Returns the shared document-scoped keyboard snapshot, installing one tracker lazily. */
+/** Возвращает общий snapshot клавиатуры уровня document, лениво устанавливая один tracker. */
 export declare function getKeyboardStateSnapshot(target: Document): KeyboardStateSnapshot;
-/** Subscribes to the shared document-scoped keyboard state and immediately emits its snapshot. */
+/** Подписывается на общее состояние клавиатуры уровня document и сразу публикует его snapshot. */
 export declare function subscribeKeyboardState(target: Document, listener: (snapshot: KeyboardStateSnapshot) => void): () => void;

package/dist/tools/logs.d.ts

@@ -1,4 +1,4 @@
-import { ChangeNotifier } from '../events/ChangeNotifier';
+import { Subscribable } from '../events/Subscribable';
 /**
  * Структурированная запись лога.
  *
@@ -30,7 +30,7 @@ export interface StructuredLogEntry {
     actions?: Array<{
         icon: string;
         tooltip?: string;
-        handler: () => void;
+        handler?: () => void;
     }>;
 }
 /**
@@ -61,7 +61,7 @@ export interface StructuredLogEntry {
  * // Получаем все логи
  * const logs = logger.getLogs()
  */
-export declare class StructuredLogger extends ChangeNotifier {
+export declare class StructuredLogger extends Subscribable {
     /** Массив всех логов */
     private _logs;
     /** Текущий контекст (иерархия) */

package/dist/tools/tools.types.d.ts

@@ -45,7 +45,7 @@ export type Awaitable<T> = T | Promise<T>;
  */
 export type VoidFn = () => void;
 /**
- * Backward-compatible alias used by legacy packages.
+ * Alias для обратной совместимости, используемый legacy-пакетами.
  */
 export type VoidFunction = VoidFn;
 /**
@@ -53,7 +53,7 @@ export type VoidFunction = VoidFn;
  */
 export type Dictionary<T = any> = Record<string, T>;
 /**
- * Backward-compatible loose object record.
+ * Нестрогая запись объекта для обратной совместимости.
  */
 export type AnyRecord = Record<string, any>;
 /**

package/dist/updates/SSEManager.d.ts

@@ -18,6 +18,7 @@ export declare class SSEManager {
     constructor(options: SSEManagerOptions);
     start(): void;
     stop(): void;
+    private _isCurrent;
     private _scheduleReconnect;
     private _clearReconnect;
     private _buildHeaders;

package/dist/utils.js

@@ -1,31 +1,15 @@
 var V = Object.defineProperty;
 var G = (r, t, e) => t in r ? V(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
 var o = (r, t, e) => G(r, typeof t != "symbol" ? t + "" : t, e);
-import { Transform as f, TransformationType as _, plainToInstance as T, instanceToPlain as S, Expose as J } from "class-transformer";
+import { Transform as d, TransformationType as _, plainToInstance as b, instanceToPlain as T, Expose as J } from "class-transformer";
 import { IsOptional as Z } from "class-validator";
 import "reflect-metadata";
 import { v4 as W } from "uuid";
 import { DateTime as Y } from "ts-luxon";
-import { differenceInSeconds as N, format as g, differenceInCalendarDays as q, isAfter as D, isEqual as Q, isBefore as z, startOfDay as p, endOfDay as X } from "date-fns";
-import { utcToZonedTime as I, getTimezoneOffset as w, zonedTimeToUtc as v } from "date-fns-tz";
+import { differenceInSeconds as z, format as g, differenceInCalendarDays as q, isAfter as I, isEqual as Q, isBefore as P, startOfDay as p, endOfDay as X } from "date-fns";
+import { utcToZonedTime as E, getTimezoneOffset as w, zonedTimeToUtc as v } from "date-fns-tz";
 import { fetchEventSource as tt, EventStreamContentType as et } from "@microsoft/fetch-event-source";
 var m = /* @__PURE__ */ ((r) => (r.Add = "add", r.Remove = "remove", r.Update = "update", r.IndexCreate = "indexCreate", r))(m || {});
-class P {
-  constructor() {
-    o(this, "_listeners", /* @__PURE__ */ new Set());
-  }
-  /** Подписывает listener на изменения utility owner. */
-  subscribe(t) {
-    return this._listeners.add(t), () => {
-      this._listeners.delete(t);
-    };
-  }
-  /** Уведомляет текущих listeners об изменении. */
-  notify() {
-    for (const t of this._listeners)
-      t();
-  }
-}
 class H {
   /**
    * Создает экземпляр EventBus и подготавливает базовое состояние.
@@ -153,7 +137,23 @@ class H {
   }
 }
 const wt = new H(Object.keys({}));
-class xt extends P {
+class U {
+  constructor() {
+    o(this, "_subscribers", /* @__PURE__ */ new Set());
+  }
+  /** Подписывает listener и возвращает идемпотентную функцию отписки. */
+  subscribe(t) {
+    return this._subscribers.add(t), () => {
+      this._subscribers.delete(t);
+    };
+  }
+  /** Уведомляет текущих подписчиков об изменении владельца состояния. */
+  notify() {
+    for (const t of this._subscribers)
+      t();
+  }
+}
+class xt extends U {
   /**
    * Создает экземпляр Collection и подготавливает базовое состояние.
    */
@@ -185,8 +185,8 @@ class xt extends P {
       const a = typeof s == "string" ? s : s.id, l = this._items.findIndex((u) => u.id === a);
       if (l !== -1) {
         const [u] = this._items.splice(l, 1);
-        this._indices.forEach((c, h) => {
-          c.delete(u[h]);
+        this._indices.forEach((c, f) => {
+          c.delete(u[f]);
         }), u.parentId || this._rootIds.delete(u.id), i.push(u);
       }
     }), i.length && (this._bus.emit(m.Remove, i), this.notify());
@@ -591,7 +591,7 @@ class Et {
     return await n.json().catch(() => ({}));
   }
 }
-class At {
+class Ct {
   /**
    * Создает экземпляр DelayedExecutor и подготавливает базовое состояние.
    */
@@ -635,10 +635,10 @@ function x(r) {
   var t;
   return r == null ? String(r) : typeof r == "string" ? `string(${r.length})` : typeof r != "object" ? `${typeof r}(${String(r)})` : Array.isArray(r) ? `Array(${r.length})` : r instanceof Map ? `Map(${r.size})` : r instanceof Set ? `Set(${r.size})` : ((t = r.constructor) == null ? void 0 : t.name) || "Object";
 }
-function U(r) {
+function D(r) {
   return r instanceof Error ? `${r.name}: ${r.message}` : x(r);
 }
-class Ot {
+class At {
   /**
    * Создает экземпляр NamedExecutor и подготавливает базовое состояние.
    */
@@ -675,7 +675,7 @@ class Ot {
       const e = this._callbacks.get(t);
       e && e();
     } catch (e) {
-      console.error(`[NamedExecutor] flush error: ${U(e)}`);
+      console.error(`[NamedExecutor] flush error: ${D(e)}`);
     }
     this._clear(t);
   }
@@ -699,9 +699,9 @@ class Ot {
     clearTimeout(this._delayTimers.get(t)), clearTimeout(this._maxTimers.get(t)), this._delayTimers.delete(t), this._maxTimers.delete(t), this._callbacks.delete(t), this._firstCallTime.delete(t);
   }
 }
-function Ct() {
+function Ot() {
   return function(r, t) {
-    f(
+    d(
       ({ value: e }) => {
         if (typeof e == "string")
           try {
@@ -712,7 +712,7 @@ function Ct() {
         return e;
       },
       { toClassOnly: !0 }
-    )(r, t), f(
+    )(r, t), d(
       ({ value: e }) => {
         try {
           return JSON.stringify(e);
@@ -726,7 +726,7 @@ function Ct() {
 }
 function Mt() {
   return function(r, t) {
-    f(
+    d(
       ({ value: e }) => {
         if (e == null)
           return "{}";
@@ -739,7 +739,7 @@ function Mt() {
         return e;
       },
       { toClassOnly: !0 }
-    )(r, t), f(
+    )(r, t), d(
       ({ value: e }) => {
         if (!e)
           return {};
@@ -755,39 +755,39 @@ function Mt() {
     )(r, t);
   };
 }
-const R = Symbol("onDeserialized");
+const K = Symbol("onDeserialized");
 function $t() {
   return function(r, t) {
-    Reflect.defineMetadata(R, t, r);
+    Reflect.defineMetadata(K, t, r);
   };
 }
 function rt(r) {
   const t = Reflect.getMetadata(
-    R,
+    K,
     r
   );
   return t ? r[t].bind(r) : null;
 }
-function Ft() {
+function kt() {
   return function(r, t) {
-    f(
+    d(
       ({ value: e }) => typeof e == "string" ? e.trim() : String(e ?? ""),
       { toClassOnly: !0 }
-    )(r, t), f(
+    )(r, t), d(
       ({ value: e }) => typeof e == "string" ? e : String(e ?? ""),
       { toPlainOnly: !0 }
     )(r, t);
   };
 }
-function kt(r, t) {
-  return f(({ value: e, type: n }) => {
+function Ft(r, t) {
+  return d(({ value: e, type: n }) => {
     if (!e)
       return /* @__PURE__ */ new Map();
     if (n === _.PLAIN_TO_CLASS) {
       if (Array.isArray(e))
         return t ? new Map(
           e.map((i) => {
-            const s = T(r, i);
+            const s = b(r, i);
             return [s[t], s];
           })
         ) : (console.warn(
@@ -804,23 +804,23 @@ function kt(r, t) {
       }
       return console.warn(`[TypeMap] Expected object or array, got ${x(e)}`), /* @__PURE__ */ new Map();
     }
-    return n === _.CLASS_TO_PLAIN ? e instanceof Map ? Array.from(e.values()).map((i) => S(i)) : (console.warn(`[TypeMap] Expected Map, got ${x(e)}`), t ? [] : {}) : (console.warn(`[TypeMap] Unexpected transformation type: ${String(n)}`), e);
+    return n === _.CLASS_TO_PLAIN ? e instanceof Map ? Array.from(e.values()).map((i) => T(i)) : (console.warn(`[TypeMap] Expected Map, got ${x(e)}`), t ? [] : {}) : (console.warn(`[TypeMap] Unexpected transformation type: ${String(n)}`), e);
   });
 }
 function Lt(r) {
-  return f(({ value: t, type: e }) => {
+  return d(({ value: t, type: e }) => {
     if (!t || typeof t != "object")
       return {};
     if (e === _.PLAIN_TO_CLASS) {
       const n = {};
       for (const i of Object.keys(t))
-        n[i] = T(r, t[i]);
+        n[i] = b(r, t[i]);
       return n;
     }
     if (e === _.CLASS_TO_PLAIN) {
       const n = {};
       for (const i of Object.keys(t))
-        n[i] = S(t[i]);
+        n[i] = T(t[i]);
       return n;
     }
     return t;
@@ -831,7 +831,7 @@ class Nt {
    * Выполняет действие toPlain в рамках ответственности Serialize.
    */
   static toPlain(t) {
-    return S(t, {
+    return T(t, {
       exposeDefaultValues: !0,
       excludeExtraneousValues: !0
     });
@@ -840,7 +840,7 @@ class Nt {
    * Выполняет действие fromJSON в рамках ответственности Serialize.
    */
   static fromJSON(t, e) {
-    const n = T(t, e, {
+    const n = b(t, e, {
       exposeDefaultValues: !0,
       excludeExtraneousValues: !0
     }), i = rt(n);
@@ -863,32 +863,32 @@ function Ht(r, t, e) {
 }
 function Ut(r) {
   return function(t, e) {
-    f(({ value: n }) => n === null ? void 0 : n, { toPlainOnly: !0 })(t, e), Z(r)(t, e);
+    d(({ value: n }) => n === null ? void 0 : n, { toPlainOnly: !0 })(t, e), Z(r)(t, e);
   };
 }
-function Rt() {
-  return f(({ value: r, type: t }) => t === _.PLAIN_TO_CLASS ? r == null ? void 0 : r.id : r);
+function Kt() {
+  return d(({ value: r, type: t }) => t === _.PLAIN_TO_CLASS ? r == null ? void 0 : r.id : r);
 }
-function Kt(r) {
-  return f(({ value: t, type: e }) => e === _.PLAIN_TO_CLASS ? t == null ? void 0 : t.map((n) => n == null ? void 0 : n[r]) : t);
+function Rt(r) {
+  return d(({ value: t, type: e }) => e === _.PLAIN_TO_CLASS ? t == null ? void 0 : t.map((n) => n == null ? void 0 : n[r]) : t);
 }
 function jt() {
-  return f(({ value: r, type: t }) => t === _.CLASS_TO_PLAIN && (r == null ? void 0 : r.id) || r);
+  return d(({ value: r, type: t }) => t === _.CLASS_TO_PLAIN && (r == null ? void 0 : r.id) || r);
 }
 function Bt() {
-  return f(({ value: r, type: t }) => t === _.CLASS_TO_PLAIN ? r.map((e) => e.id) : r);
+  return d(({ value: r, type: t }) => t === _.CLASS_TO_PLAIN ? r.map((e) => e.id) : r);
 }
 function Vt() {
-  return f(({ value: r, type: t }) => t === "classToPlain" ? void 0 : r, { toPlainOnly: !0 });
+  return d(({ value: r, type: t }) => t === _.CLASS_TO_PLAIN ? void 0 : r, { toPlainOnly: !0 });
 }
 function Gt(r, t) {
-  return T(r, t, {
+  return b(r, t, {
     exposeDefaultValues: !0,
     excludeExtraneousValues: !0
   });
 }
 function Jt(r) {
-  return S(r, {
+  return T(r, {
     exposeUnsetFields: !1
   });
 }
@@ -902,11 +902,11 @@ const Yt = !1;
 function qt(r, t) {
   return t();
 }
-const Qt = () => W(), M = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+const Qt = () => W(), $ = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
 function Xt(r) {
   let t = "";
   for (let e = 0; e < r; ++e)
-    t += M[Math.floor(M.length * Math.random())];
+    t += $[Math.floor($.length * Math.random())];
   return t;
 }
 class vt {
@@ -938,7 +938,7 @@ class vt {
    * Обрабатывает runtime-событие HotkeyManager.
    */
   _handle(t) {
-    if (!this._enabled || this._isIgnoredTarget(t.target))
+    if (!(t instanceof KeyboardEvent) || !this._enabled || this._isIgnoredTarget(t.target))
       return;
     const e = this._normalizeKey(t), n = this._bindings.get(e);
     if (n)
@@ -998,7 +998,7 @@ function te(r, t) {
     return n && i && s && a && l;
   }) : !1;
 }
-const $ = /* @__PURE__ */ new WeakMap(), it = /* @__PURE__ */ new Set([
+const k = /* @__PURE__ */ new WeakMap(), it = /* @__PURE__ */ new Set([
   "Alt",
   "AltGraph",
   "CapsLock",
@@ -1016,15 +1016,15 @@ const $ = /* @__PURE__ */ new WeakMap(), it = /* @__PURE__ */ new Set([
   "SymbolLock"
 ]);
 function ee(r) {
-  return E(K(r).snapshot);
+  return C(R(r).snapshot);
 }
 function re(r, t) {
-  const e = K(r);
-  return e.subscribers.add(t), t(E(e.snapshot)), () => e.subscribers.delete(t);
+  const e = R(r);
+  return e.subscribers.add(t), t(C(e.snapshot)), () => e.subscribers.delete(t);
 }
-function K(r) {
+function R(r) {
   var a, l, u;
-  const t = $.get(r);
+  const t = k.get(r);
   if (t)
     return t;
   const e = st((a = r.defaultView) == null ? void 0 : a.navigator), n = {
@@ -1032,42 +1032,42 @@ function K(r) {
     entries: /* @__PURE__ */ new Map(),
     subscribers: /* @__PURE__ */ new Set()
   }, i = (c) => {
-    var C;
-    const h = c ? {
+    var M;
+    const f = c ? {
       ctrl: c.ctrlKey,
       shift: c.shiftKey,
       alt: c.altKey,
       meta: c.metaKey,
       mod: e === "macos" ? c.metaKey : e === "windows" || e === "linux" ? c.ctrlKey : c.ctrlKey || c.metaKey,
-      altGraph: ((C = c.getModifierState) == null ? void 0 : C.call(c, "AltGraph")) === !0
-    } : F(e).modifiers, O = [...n.entries.values()], b = {
+      altGraph: ((M = c.getModifierState) == null ? void 0 : M.call(c, "AltGraph")) === !0
+    } : F(e).modifiers, O = [...n.entries.values()], S = {
       platform: e,
-      modifiers: h,
+      modifiers: f,
       held: {
         key: [...new Set(O.map((y) => y.key))].sort(),
         code: [...new Set(O.map((y) => y.code).filter(Boolean))].sort()
       }
     };
-    if (!ot(n.snapshot, b)) {
-      n.snapshot = b;
+    if (!ot(n.snapshot, S)) {
+      n.snapshot = S;
       for (const y of n.subscribers)
-        y(E(b));
+        y(C(S));
     }
   }, s = () => {
     n.entries.clear(), i();
   };
   return r.addEventListener("keydown", (c) => {
     if (!it.has(c.key)) {
-      const h = c.key.toLowerCase();
-      n.entries.set(c.code || `key:${h}`, { key: h, code: c.code });
+      const f = c.key.toLowerCase();
+      n.entries.set(c.code || `key:${f}`, { key: f, code: c.code });
     }
     i(c);
   }, !0), r.addEventListener("keyup", (c) => {
-    const h = c.key.toLowerCase();
-    n.entries.delete(c.code || `key:${h}`), i(c);
+    const f = c.key.toLowerCase();
+    n.entries.delete(c.code || `key:${f}`), i(c);
   }, !0), r.addEventListener("visibilitychange", () => {
     r.visibilityState === "hidden" && s();
-  }), (l = r.defaultView) == null || l.addEventListener("blur", s), (u = r.defaultView) == null || u.addEventListener("pagehide", s), $.set(r, n), n;
+  }), (l = r.defaultView) == null || l.addEventListener("blur", s), (u = r.defaultView) == null || u.addEventListener("pagehide", s), k.set(r, n), n;
 }
 function F(r) {
   return {
@@ -1089,19 +1089,19 @@ function st(r) {
   return e.includes("mac") || e.includes("darwin") || e.includes("iphone") || e.includes("ipad") ? "macos" : e.includes("win") ? "windows" : e.includes("linux") || e.includes("x11") || e.includes("cros") ? "linux" : "unknown";
 }
 function ot(r, t) {
-  return r.platform === t.platform && r.modifiers.ctrl === t.modifiers.ctrl && r.modifiers.shift === t.modifiers.shift && r.modifiers.alt === t.modifiers.alt && r.modifiers.meta === t.modifiers.meta && r.modifiers.mod === t.modifiers.mod && r.modifiers.altGraph === t.modifiers.altGraph && k(r.held.key, t.held.key) && k(r.held.code, t.held.code);
+  return r.platform === t.platform && r.modifiers.ctrl === t.modifiers.ctrl && r.modifiers.shift === t.modifiers.shift && r.modifiers.alt === t.modifiers.alt && r.modifiers.meta === t.modifiers.meta && r.modifiers.mod === t.modifiers.mod && r.modifiers.altGraph === t.modifiers.altGraph && L(r.held.key, t.held.key) && L(r.held.code, t.held.code);
 }
-function k(r, t) {
+function L(r, t) {
   return r.length === t.length && r.every((e, n) => e === t[n]);
 }
-function E(r) {
+function C(r) {
   return {
     platform: r.platform,
     modifiers: { ...r.modifiers },
     held: { key: [...r.held.key], code: [...r.held.code] }
   };
 }
-class ne extends P {
+class ne extends U {
   constructor() {
     super(...arguments);
     /** Массив всех логов */
@@ -1145,7 +1145,7 @@ class ne extends P {
    */
   end(e, n, i) {
     if (n) {
-      const s = i ?? this._currentActions.length ? this._currentActions : void 0;
+      const s = i != null && i.length ? i : this._currentActions.length > 0 ? this._currentActions : void 0;
       this._log(e ?? "info", n, s);
     }
     return this._currentContext.pop(), this._currentActions = [], this;
@@ -1305,14 +1305,14 @@ function ae(r) {
   return String(r).charAt(0).toUpperCase() + String(r).slice(1);
 }
 function ce(r, t) {
-  return D(r, t) || Q(r, t);
+  return I(r, t) || Q(r, t);
 }
 function le(r, t, e, n) {
   const i = p(r), s = p(t), a = p(e), l = p(n);
-  return !z(s, a) && !D(i, l);
+  return !P(s, a) && !I(i, l);
 }
 function ue(r, t, e) {
-  return !z(r, p(t)) && !D(r, X(e));
+  return !P(r, p(t)) && !I(r, X(e));
 }
 const fe = (r) => r && new Date(r);
 function de(r, t = "HH:mm dd.MM.yyyy", e = {}) {
@@ -1328,7 +1328,7 @@ function ut(r, t = "HH:mm dd.MM.yyyy", e = {}, n = !0) {
       return "";
   } else
     r = new Date(r.toString());
-  return n ? g(r, t, e) : g(I(r, "utc"), t, e);
+  return n ? g(r, t, e) : g(E(r, "utc"), t, e);
 }
 function he(r) {
   const t = { weekday: "short" }, e = new Intl.DateTimeFormat("ru-RU", t).format(r);
@@ -1349,18 +1349,18 @@ function ye(r) {
   };
 }
 function pe(r, t) {
-  const e = N(r, t), { hours: n, minutes: i } = A(e);
-  return n || i ? `${e > 0 ? "-" : "+"}${d(n)}:${d(i)}` : "";
+  const e = z(r, t), { hours: n, minutes: i } = A(e);
+  return n || i ? `${e > 0 ? "-" : "+"}${h(n)}:${h(i)}` : "";
 }
 function ge(r, t) {
-  const e = N(r, t), { hours: n, minutes: i } = A(e);
-  return n || i ? `${e > 0 ? "-" : ""}${d(n)}:${d(i)}` : "";
+  const e = z(r, t), { hours: n, minutes: i } = A(e);
+  return n || i ? `${e > 0 ? "-" : ""}${h(n)}:${h(i)}` : "";
 }
-function L(r = /* @__PURE__ */ new Date()) {
+function N(r = /* @__PURE__ */ new Date()) {
   return new Date(r.getFullYear(), r.getMonth(), r.getDate());
 }
-function Te(r, t) {
-  const e = q(L(r), L(t));
+function be(r, t) {
+  const e = q(N(r), N(t));
   return e ? e > 7 ? {
     variant: "red",
     value: ">7"
@@ -1375,21 +1375,21 @@ function Te(r, t) {
     value: `${e}`
   } : null;
 }
-function Se(r) {
+function Te(r) {
   const e = String(r ?? "").trim().match(/^(\d{4})-(\d{2})-(\d{2})$/);
   if (!e)
     return null;
   const n = Number(e[1]), i = Number(e[2]) - 1, s = Number(e[3]), a = new Date(Date.UTC(n, i, s, 0, 0, 0, 0));
   return Number.isNaN(a.getTime()) ? null : a.toISOString();
 }
-function be(r) {
+function Se(r) {
   const t = String(r ?? "").trim();
   if (!t)
     return null;
   const e = t.match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2}))?$/);
   if (e) {
-    const i = Number(e[1]), s = Number(e[2]) - 1, a = Number(e[3]), l = Number(e[4]), u = Number(e[5]), c = e[6] != null ? Number(e[6]) : 0, h = new Date(i, s, a, l, u, c, 0);
-    return Number.isNaN(h.getTime()) ? null : h.toISOString();
+    const i = Number(e[1]), s = Number(e[2]) - 1, a = Number(e[3]), l = Number(e[4]), u = Number(e[5]), c = e[6] != null ? Number(e[6]) : 0, f = new Date(i, s, a, l, u, c, 0);
+    return Number.isNaN(f.getTime()) ? null : f.toISOString();
   }
   const n = new Date(t);
   return Number.isNaN(n.getTime()) ? null : n.toISOString();
@@ -1405,7 +1405,7 @@ function xe(r) {
   const e = new Date(t);
   if (Number.isNaN(e.getTime()))
     return t.slice(0, 16);
-  const n = e.getFullYear(), i = d(e.getMonth() + 1), s = d(e.getDate()), a = d(e.getHours()), l = d(e.getMinutes());
+  const n = e.getFullYear(), i = h(e.getMonth() + 1), s = h(e.getDate()), a = h(e.getHours()), l = h(e.getMinutes());
   return `${n}-${i}-${s}T${a}:${l}`;
 }
 function De(r, t) {
@@ -1415,8 +1415,8 @@ function De(r, t) {
   const n = new Date(String(r ?? "").trim());
   if (Number.isNaN(n.getTime()))
     return "";
-  const i = B(t), s = i ? I(n, i) : n;
-  return `${d(s.getHours())}:${d(s.getMinutes())}`;
+  const i = B(t), s = i ? E(n, i) : n;
+  return `${h(s.getHours())}:${h(s.getMinutes())}`;
 }
 function Ie(r, t, e) {
   const n = j(t).match(/^(\d{2}):(\d{2})$/);
@@ -1431,7 +1431,7 @@ function Ie(r, t, e) {
   const l = B(e);
   if (!l)
     return i.setHours(s, a, 0, 0), i.toISOString();
-  const u = I(i, l);
+  const u = E(i, l);
   return u.setHours(s, a, 0, 0), v(u, l).toISOString();
 }
 function j(r) {
@@ -1468,11 +1468,11 @@ function Ee(r) {
   const n = t.match(/^(\d{2}):(\d{2})$/);
   return n ? `${n[1]}:${n[2]}:00` : null;
 }
-function Ae(r) {
+function Ce(r) {
   const t = dt(r), e = Math.sign(t) >= 0 ? "" : "-", { hours: n, minutes: i } = A(t);
-  return `${e}${d(n)}:${d(i)}`;
+  return `${e}${h(n)}:${h(i)}`;
 }
-function Oe(r = null, t = "dd", e = {}) {
+function Ae(r = null, t = "dd", e = {}) {
   const n = ft(r);
   if (!n)
     return "";
@@ -1506,10 +1506,10 @@ function dt(r) {
   }
   return 0;
 }
-function d(r) {
+function h(r) {
   return String(r).padStart(2, "0");
 }
-function Ce(r) {
+function Oe(r) {
   const t = /* @__PURE__ */ new Date();
   try {
     const e = w(r, t), n = Intl.supportedValuesOf("timeZone");
@@ -1535,14 +1535,23 @@ class $e {
     this._url = t.url, this._retryInterval = t.retryInterval ?? 3e3, this._options = t;
   }
   start() {
-    this._abortController = new AbortController(), this._connect();
+    if (this._abortController)
+      return;
+    const t = new AbortController();
+    this._abortController = t, this._connect(t);
   }
   stop() {
-    var t;
-    this._clearReconnect(), this._isConnected = !1, (t = this._abortController) == null || t.abort(), this._abortController = null;
+    this._clearReconnect(), this._isConnected = !1;
+    const t = this._abortController;
+    this._abortController = null, t == null || t.abort();
+  }
+  _isCurrent(t) {
+    return this._abortController === t && !t.signal.aborted;
   }
-  _scheduleReconnect() {
-    this._clearReconnect(), this._reconnectTimeout = setTimeout(() => this.start(), this._retryInterval);
+  _scheduleReconnect(t) {
+    this._isCurrent(t) && (this._clearReconnect(), this._reconnectTimeout = setTimeout(() => {
+      this._isCurrent(t) && (this.stop(), this.start());
+    }, this._retryInterval));
   }
   _clearReconnect() {
     this._reconnectTimeout && (clearTimeout(this._reconnectTimeout), this._reconnectTimeout = null);
@@ -1552,48 +1561,62 @@ class $e {
     const t = { ...this._options.headers }, e = await ((i = (n = this._options).getToken) == null ? void 0 : i.call(n));
     return e && (t.Authorization = `Bearer ${e}`), t;
   }
-  async _connect() {
-    var t, e, n;
+  async _connect(t) {
+    var e, n;
     try {
+      const i = await this._buildHeaders();
+      if (!this._isCurrent(t))
+        return;
       await tt(this._url, {
         method: "GET",
-        headers: await this._buildHeaders(),
-        signal: (t = this._abortController) == null ? void 0 : t.signal,
+        headers: i,
+        signal: t.signal,
         openWhenHidden: !0,
-        onopen: (i) => {
-          var a, l;
-          if (i.ok && i.headers.get("content-type") === et) {
-            this._isConnected = !0, (l = (a = this._options).onOpen) == null || l.call(a);
+        onopen: async (s) => {
+          var l, u, c, f;
+          if (!this._isCurrent(t))
+            throw new Error("[SSEManager] Connection was stopped.");
+          if (s.ok && ((u = (l = s.headers.get("content-type")) == null ? void 0 : l.split(";")[0]) == null ? void 0 : u.trim()) === et) {
+            this._isConnected = !0, (f = (c = this._options).onOpen) == null || f.call(c);
             return;
           }
-          throw new Error(`Unexpected response: ${i.status}`);
+          throw new Error(`Unexpected response: ${s.status}`);
         },
-        onmessage: (i) => {
-          try {
-            this._options.onEvent(JSON.parse(i.data));
-          } catch (s) {
-            console.warn(`[SSEManager] Failed to parse message: ${U(s)}`);
-          }
+        onmessage: (s) => {
+          if (this._isCurrent(t))
+            try {
+              this._options.onEvent(JSON.parse(s.data));
+            } catch (a) {
+              console.warn(`[SSEManager] Failed to parse message: ${D(a)}`);
+            }
         },
         onclose: () => {
-          var i, s;
-          this._isConnected = !1, (s = (i = this._options).onClose) == null || s.call(i), this._scheduleReconnect();
-        },
-        onerror: (i) => {
           var s, a;
-          this._isConnected = !1, (a = (s = this._options).onError) == null || a.call(s, i instanceof Error ? i : new Error(String(i))), this._scheduleReconnect();
+          this._isCurrent(t) && (this._isConnected = !1, (a = (s = this._options).onClose) == null || a.call(s));
+        },
+        // Retry belongs to this manager. Throwing disables the library's retry loop.
+        onerror: (s) => {
+          throw s;
         }
       });
     } catch (i) {
-      const s = i instanceof Error ? i : new Error(String(i));
-      console.error("[SSEManager] Fatal error:", s.message), this._isConnected = !1, (n = (e = this._options).onError) == null || n.call(e, s), this._scheduleReconnect();
+      if (this._isCurrent(t)) {
+        this._isConnected = !1;
+        try {
+          (n = (e = this._options).onError) == null || n.call(e, i instanceof Error ? i : new Error(String(i)));
+        } catch (s) {
+          console.warn(`[SSEManager] Error callback failed: ${D(s)}`);
+        }
+      }
+    } finally {
+      this._isCurrent(t) && (this._isConnected = !1, this._scheduleReconnect(t));
     }
   }
   get isConnected() {
     return this._isConnected;
   }
 }
-class Fe {
+class ke {
   constructor() {
     o(this, "_currentCount", 0);
     o(this, "_lastResetTime", Date.now());
@@ -1615,9 +1638,9 @@ export {
   wt as AppBus,
   Pt as BeforeSerialize,
   xt as Collection,
-  At as DelayedExecutor,
-  Kt as DeserializeArrayField,
-  Rt as DeserializeId,
+  Ct as DelayedExecutor,
+  Rt as DeserializeArrayField,
+  Kt as DeserializeId,
   H as EventBus,
   m as Events,
   zt as GenericExpose,
@@ -1626,24 +1649,25 @@ export {
   Vt as IgnoreToPlain,
   Dt as IndexedCollection,
   Ut as IsOptionalTransformed,
-  Ct as Json,
+  Ot as Json,
   Mt as JsonString,
-  Ot as NamedExecutor,
+  At as NamedExecutor,
   Et as PayloadHttpClient,
   It as RingBuffer,
   $e as SSEManager,
-  Ft as Script,
+  kt as Script,
   Nt as Serialize,
   jt as SerializeId,
   Bt as SerializeIds,
   ne as StructuredLogger,
+  U as Subscribable,
   lt as SystemClock,
-  kt as TypeMap,
+  Ft as TypeMap,
   Lt as TypeRecord,
-  Fe as UPSMeter_Service,
+  ke as UPSMeter_Service,
   ae as capitalize,
   Wt as compareNumber,
-  U as consoleErrorSummary,
+  D as consoleErrorSummary,
   x as consoleValueSummary,
   ie as createInstance,
   pe as diffDuration,
@@ -1654,9 +1678,9 @@ export {
   _e as formatDateToMSK,
   de as formatDatetime,
   ut as formatDatetimeTZ,
-  Oe as formatDatetimeTZSpecial,
+  Ae as formatDatetimeTZSpecial,
   Qt as generateUUID,
-  Te as getDateOnlyDiffFactor,
+  be as getDateOnlyDiffFactor,
   he as getDayOfWeek,
   ee as getKeyboardStateSnapshot,
   rt as getOnDeserializedMethod,
@@ -1674,16 +1698,16 @@ export {
   Ie as mergeTimeIntoDateTime,
   $t as onDeserialized,
   fe as parseDate,
-  Ae as parseDuration,
-  Ce as parseOffsetToTimezone,
+  Ce as parseDuration,
+  Oe as parseOffsetToTimezone,
   qt as profile,
   Xt as randomString,
-  L as removeTime,
+  N as removeTime,
   re as subscribeKeyboardState,
   j as timeToTimeInput,
   Gt as toInstance,
-  Se as toIsoZDate,
-  be as toIsoZDateTime,
+  Te as toIsoZDate,
+  Se as toIsoZDateTime,
   Jt as toPlain,
   Ee as toTimeHHMMSS
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@endge/utils",
   "type": "module",
-  "version": "0.25.6",
+  "version": "0.26.1",
   "private": false,
   "sideEffects": false,
   "exports": {
@@ -18,7 +18,8 @@
   "scripts": {
     "clean": "rimraf dist tsconfig.tsbuildinfo",
     "dev": "vite build --watch",
-    "build": "vite build",
+    "build": "pnpm typecheck && vite build",
+    "typecheck": "tsc -p tsconfig.app.json --noEmit",
     "test": "vitest",
     "lint-check": "eslint . --cache",
     "lint-fix": "eslint . --fix --cache"

package/dist/events/ChangeNotifier.d.ts

@@ -1,8 +0,0 @@
-/** Внутренний механизм уведомления generic utilities об изменениях. */
-export declare class ChangeNotifier {
-    private readonly _listeners;
-    /** Подписывает listener на изменения utility owner. */
-    subscribe(listener: () => void): () => void;
-    /** Уведомляет текущих listeners об изменении. */
-    notify(): void;
-}