@endge/utils 0.25.3 → 0.26.0

package/dist/collection/collection.d.ts

@@ -1,13 +1,13 @@
 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 {
-    private items;
-    private indices;
-    private rootIds;
-    private bus;
+export declare class Collection<T extends CollectionEntity> extends Subscribable {
+    private _items;
+    private _indices;
+    private _rootIds;
+    private _bus;
     /**
      * Создает экземпляр Collection и подготавливает базовое состояние.
      */
@@ -31,7 +31,7 @@ export declare class Collection<T extends CollectionEntity> extends ChangeNotifi
     /**
      * Создает runtime-сущность Collection.
      */
-    private createIndex;
+    private _createIndex;
     /**
      * Возвращает реактивный массив всех элементов.
      */

package/dist/collection/indexed-collection.d.ts

@@ -14,16 +14,16 @@ import { OneOrMany } from '../tools/tools.types';
  * - При изменении filterFn можно пересобрать filteredList без пересортировки list.
  */
 export declare class IndexedCollection<T extends IndexCollectionEntity<ID>, ID = string | null> {
-    private list;
-    private filteredList;
-    private map;
-    private indexById;
-    private dirtySort;
-    private dirtyFilter;
-    private sortFn?;
-    private filterFn?;
-    private indexEnabled;
-    private filterIndexEnabled;
+    private _list;
+    private _filteredList;
+    private _map;
+    private _indexById;
+    private _dirtySort;
+    private _dirtyFilter;
+    private _sortFn?;
+    private _filterFn?;
+    private _indexEnabled;
+    private _filterIndexEnabled;
     /**
      * Создает экземпляр IndexedCollection и подготавливает базовое состояние.
      */
@@ -116,25 +116,25 @@ export declare class IndexedCollection<T extends IndexCollectionEntity<ID>, ID =
     /**
      * Выполняет внутренний шаг rebuildFilteredFromScratch для IndexedCollection.
      */
-    private rebuildFilteredFromScratch;
+    private _rebuildFilteredFromScratch;
     /**
      * Выполняет внутренний шаг addToFilteredIfPasses для IndexedCollection.
      */
-    private addToFilteredIfPasses;
+    private _addToFilteredIfPasses;
     /**
      * Добавляет сущность в runtime-коллекцию IndexedCollection.
      */
-    private appendToFiltered;
+    private _appendToFiltered;
     /**
      * Выполняет внутренний шаг refilterOneO1 для IndexedCollection.
      */
-    private refilterOneO1;
+    private _refilterOneO1;
     /**
      * Удаляет сущность из runtime-коллекции IndexedCollection.
      */
-    private removeFromFilteredO1;
+    private _removeFromFilteredO1;
     /**
      * Удаляет сущность из runtime-коллекции IndexedCollection.
      */
-    private removeFromListO1;
+    private _removeFromListO1;
 }

package/dist/database/PayloadHttpClient.d.ts

@@ -2,10 +2,10 @@ export interface PayloadClientOptions {
     baseUrl: string;
 }
 export declare class PayloadHttpClient {
-    private readonly baseUrl;
+    private readonly _baseUrl;
     constructor(opts: PayloadClientOptions);
-    private buildUrl;
-    private buildHeaders;
+    private _buildUrl;
+    private _buildHeaders;
     get<T>(path: string, query?: Record<string, unknown>, extraHeaders?: HeadersInit): Promise<T>;
     post<T>(path: string, body?: unknown, extraHeaders?: HeadersInit): Promise<T>;
     patch<T>(path: string, body?: unknown, extraHeaders?: HeadersInit): Promise<T>;

package/dist/events/EventBus.d.ts

@@ -36,7 +36,7 @@ export type EventList = Record<string, any>;
  * ```
  */
 export declare class EventBus<StaticEvents extends Record<string, any>, CustomEventMap extends Record<string, any> = Record<string, any>> {
-    private listeners;
+    private _listeners;
     /**
      * Создает экземпляр EventBus и подготавливает базовое состояние.
      */

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/execute/NamedExecutor.d.ts

@@ -6,15 +6,15 @@ interface NamedExecutorConfig {
  * Описывает ответственность NamedExecutor в архитектуре проекта.
  */
 export declare class NamedExecutor {
-    private readonly config;
-    private delayTimers;
-    private maxTimers;
-    private callbacks;
-    private firstCallTime;
+    private readonly _config;
+    private _delayTimers;
+    private _maxTimers;
+    private _callbacks;
+    private _firstCallTime;
     /**
      * Создает экземпляр NamedExecutor и подготавливает базовое состояние.
      */
-    constructor(config: NamedExecutorConfig);
+    constructor(_config: NamedExecutorConfig);
     /**
      * Выполняет действие run в рамках ответственности NamedExecutor.
      */
@@ -34,6 +34,6 @@ export declare class NamedExecutor {
     /**
      * Очищает накопленное состояние NamedExecutor.
      */
-    private clear;
+    private _clear;
 }
 export {};

package/dist/execute/delay-executor.d.ts

@@ -2,16 +2,16 @@
  * Описывает ответственность DelayedExecutor в архитектуре проекта.
  */
 export declare class DelayedExecutor<T extends Array<any> = []> {
-    private readonly fn;
-    private readonly firstExecuteImmediately;
-    private delayTimer;
-    private maxTimer;
-    private hasExecutedOnce;
-    private lastArgs;
+    private readonly _fn;
+    private readonly _firstExecuteImmediately;
+    private _delayTimer;
+    private _maxTimer;
+    private _hasExecutedOnce;
+    private _lastArgs;
     /**
      * Создает экземпляр DelayedExecutor и подготавливает базовое состояние.
      */
-    constructor(fn: (...args: T) => void, firstExecuteImmediately?: boolean);
+    constructor(_fn: (...args: T) => void, _firstExecuteImmediately?: boolean);
     /**
      * Выполняет действие run в рамках ответственности DelayedExecutor.
      */
@@ -27,5 +27,5 @@ export declare class DelayedExecutor<T extends Array<any> = []> {
     /**
      * Очищает накопленное состояние DelayedExecutor.
      */
-    private clear;
+    private _clear;
 }

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/hotkeys.d.ts

@@ -7,11 +7,11 @@ interface HotkeyManagerOptions {
  * Управляет ресурсами и состоянием HotkeyManager.
  */
 export declare class HotkeyManager {
-    private bindings;
-    private enabled;
-    private readonly target;
-    private readonly ignoreInput;
-    private readonly handleBound;
+    private _bindings;
+    private _enabled;
+    private readonly _target;
+    private readonly _ignoreInput;
+    private readonly _handleBound;
     /**
      * Создает экземпляр HotkeyManager и подготавливает базовое состояние.
      */
@@ -19,15 +19,15 @@ export declare class HotkeyManager {
     /**
      * Выполняет внутренний шаг isIgnoredTarget для HotkeyManager.
      */
-    private isIgnoredTarget;
+    private _isIgnoredTarget;
     /**
      * Нормализует входные данные HotkeyManager.
      */
-    private normalizeKey;
+    private _normalizeKey;
     /**
      * Обрабатывает runtime-событие HotkeyManager.
      */
-    private handle;
+    private _handle;
     /**
      * Обрабатывает входящее событие HotkeyManager.
      */

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,12 +61,12 @@ export interface StructuredLogEntry {
  * // Получаем все логи
  * const logs = logger.getLogs()
  */
-export declare class StructuredLogger extends ChangeNotifier {
+export declare class StructuredLogger extends Subscribable {
     /** Массив всех логов */
-    private logs;
+    private _logs;
     /** Текущий контекст (иерархия) */
-    private currentContext;
-    private currentActions;
+    private _currentContext;
+    private _currentActions;
     /**
      * Устанавливает текущий контекст.
      * Сбрасывает предыдущий контекст.
@@ -113,7 +113,7 @@ export declare class StructuredLogger extends ChangeNotifier {
      * @param message Сообщение
      * @param actions Дополнительные действия (иконки с обработчиками)
      */
-    private log;
+    private _log;
     /**
      * Лог уровня _debug.
      *

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>;
 /**