@endge/utils 0.24.12 → 0.24.14

package/dist/index.d.ts

@@ -1,1320 +1,42 @@
-import { ClassConstructor } from 'class-transformer';
-import { DateTime } from 'ts-luxon';
-import { ExposeOptions } from 'class-transformer';
-import { Ref } from 'vue';
-import { StoreDefinition } from 'pinia';
-import { ValidationOptions } from 'class-validator';
-import { Zone } from 'ts-luxon';
-
-/**
- * Тип для активного состояния с вычисляемым значением.
- */
-export declare type ActiveState<T> = {
-    value: T;
-    computed: T;
-};
-
-export declare function AfterDeserialize(target: any, propertyKey: string, _descriptor: PropertyDescriptor): void;
-
-/**
- * Backward-compatible loose object record.
- */
-export declare type AnyRecord = Record<string, any>;
-
-export declare const AppBus: EventBus<GlobalEvents, Record<string, any>>;
-
-/**
- * Тип для асинхронной функции.
- */
-export declare type AsyncFn<Args extends Array<any> = Array<any>, R = any> = (...args: Args) => Promise<R>;
-
-/**
- * Тип, представляющий значение или промис значения.
- */
-export declare type Awaitable<T> = T | Promise<T>;
-
-export declare function BeforeSerialize(): (target: any, propertyKey: string, _descriptor: PropertyDescriptor) => void;
-
-/**
- * Тип, обозначающий функцию обратного вызова (callback).
- */
-export declare type Callback<T = void> = (arg: T) => void;
-
-export declare function capitalize(val: unknown): string;
-
-/**
- * Описывает ответственность Collection в архитектуре проекта.
- */
-export declare class Collection<T extends CollectionEntity> extends Subscribable {
-    private items;
-    private indices;
-    private rootIds;
-    private bus;
-    /**
-     * Создает экземпляр Collection и подготавливает базовое состояние.
-     */
-    constructor(initialItems?: Array<T>);
-    /**
-     * Выполняет действие add в рамках ответственности Collection.
-     */
-    add(items: T | Array<T>): void;
-    /**
-     * Удаляет сущность из runtime-коллекции Collection.
-     */
-    remove(arg: string | T | Array<string | T>): void;
-    /**
-     * Обновляет runtime-состояние Collection.
-     */
-    update(itemOrItems: T | Array<T>): void;
-    /**
-     * Возвращает значение состояния Collection.
-     */
-    get(arg: string | Partial<T>): T | undefined;
-    /**
-     * Создает runtime-сущность Collection.
-     */
-    private createIndex;
-    /**
-     * Возвращает реактивный массив всех элементов.
-     */
-    get all(): Array<T>;
-    /**
-     * Возвращает массив корневых элементов (без parentId).
-     */
-    get allRoot(): Array<T>;
-    /**
-     * Обрабатывает входящее событие Collection.
-     */
-    on<K extends keyof CollectionEvents<T>>(event: K, cb: (payload: CollectionEvents<T>[K]) => void): void;
-    /**
-     * Выполняет действие off в рамках ответственности Collection.
-     */
-    off<K extends keyof CollectionEvents<T>>(event: K, cb: (payload: CollectionEvents<T>[K]) => void): void;
-}
-
-export declare interface CollectionEntity {
-    id: string;
-    parentId?: string | null;
-}
-
-export declare type CollectionEvents<T extends CollectionEntity> = {
-    [Events.Add]: Array<T>;
-    [Events.Remove]: Array<T>;
-    [Events.Update]: Array<T>;
-    [Events.IndexCreate]: keyof T;
-};
-
-export declare type CollectionOptions<T extends IndexCollectionEntity<ID>, ID = string | null> = {
-    sortFn: (a: T, b: T) => number;
-    filterFn: (item: T) => boolean;
-    indexEnabled: boolean;
-    filterIndexEnabled: boolean;
-};
-
-export declare function compareNumber(a: any, b: any): number;
-
-/** Returns Error metadata as text without forwarding the Error object to Console. */
-export declare function consoleErrorSummary(error: unknown): string;
-
-/** Returns a bounded string without traversing or retaining the supplied value. */
-export declare function consoleValueSummary(value: unknown): string;
-
-/**
- * Тип конструктора для класса.
- * Используется, например, в DI-контейнерах или фабриках.
- */
-export declare type Constructor<T = any> = new (...args: Array<any>) => T;
-
-/**
- * Утилитарный тип: или конструктор, или фабрика.
- */
-export declare type ConstructorOrFactory<T, Args extends Array<any> = Array<any>> = (new (...args: Args) => T) | ((...args: Args) => T);
-
-/**
- * Универсальный вызов: конструктор или фабрика.
- */
-export declare function createInstance<T, Args extends Array<any>>(source: ConstructorOrFactory<T, Args>, ...args: Args): T;
-
-export declare interface DataPoint {
-    x: number;
-    y: number;
-}
-
-export declare interface DataRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-
-export declare interface DataSize {
-    width: number;
-    height: number;
-}
-
-export declare interface DateRange {
-    start: Date;
-    end: Date;
-}
-
-/**
- * Частичный рекурсивный тип.
- * Делает все поля и вложенные поля необязательными.
- */
-export declare type DeepPartial<T> = {
-    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
-};
-
-/**
- * Описывает ответственность DelayedExecutor в архитектуре проекта.
- */
-export declare class DelayedExecutor<T extends Array<any> = []> {
-    private readonly fn;
-    private readonly firstExecuteImmediately;
-    private delayTimer;
-    private maxTimer;
-    private hasExecutedOnce;
-    private lastArgs;
-    /**
-     * Создает экземпляр DelayedExecutor и подготавливает базовое состояние.
-     */
-    constructor(fn: (...args: T) => void, firstExecuteImmediately?: boolean);
-    /**
-     * Выполняет действие run в рамках ответственности DelayedExecutor.
-     */
-    run(args: T, delayMs?: number, maxWaitMs?: number): void;
-    /**
-     * Принудительно завершает накопленные изменения DelayedExecutor.
-     */
-    flush(): void;
-    /**
-     * Выполняет действие cancel в рамках ответственности DelayedExecutor.
-     */
-    cancel(): void;
-    /**
-     * Очищает накопленное состояние DelayedExecutor.
-     */
-    private clear;
-}
-
-export declare function DeserializeArrayField(field: string): PropertyDecorator;
-
-export declare function DeserializeId(): PropertyDecorator;
-
-/**
- * Тип, обозначающий словарь значений.
- */
-export declare type Dictionary<T = any> = Record<string, T>;
-
-export declare function diffDuration(d1: Date, d2: Date): string;
-
-export declare function diffDurationTable(d1: Date, d2: Date): string;
-
-export declare const dt: (date: Date) => DateTime;
-
-/**
- * EventBus реализует паттерн подписки на события.
- *
- * Поддерживает:
- * - Типизированные события через дженерик StaticEvents;
- * - Кастомные (непредопределённые) события;
- * - Подписку `on`, одноразовую подписку `once`, отписку `off`;
- * - Эмит `emit`, проверку `hasListeners` и список активных событий `eventNames`.
- *
- * Пример использования:
- *
- * ```ts
- * type Events = {
- *   userLogin: { id: string }
- *   error: { message: string }
- * }
- *
- * const bus = new EventBus<Events>(['userLogin', 'error'])
- *
- * bus.on('userLogin', ({ id }) => console.logFrame(`Login: ${id}`))
- * bus.once('error', ({ message }) => console.warn('One-time error:', message))
- *
- * bus.emit('userLogin', { id: 'u42' })         // Login: u42
- * bus.emit('error', { message: 'fail' })       // One-time error: fail
- * bus.emit('error', { message: 'fail again' }) // уже не сработает
- *
- * console.logFrame(bus.hasListeners('userLogin')) // true
- * console.logFrame(bus.eventNames())              // ['userLogin']
- * ```
- */
-export declare class EventBus<StaticEvents extends Record<string, any>, CustomEventMap extends Record<string, any> = Record<string, any>> {
-    private listeners;
-    /**
-     * Создает экземпляр EventBus и подготавливает базовое состояние.
-     */
-    constructor(predefinedEvents?: Array<keyof StaticEvents>);
-    /**
-     * Обрабатывает входящее событие EventBus.
-     */
-    on<K extends keyof StaticEvents>(events: OneOrMany<K>, callback: EventCallback<StaticEvents[K]>): void;
-    /**
-     * Обрабатывает входящее событие EventBus.
-     */
-    once<K extends keyof StaticEvents>(events: OneOrMany<K>, callback: EventCallback<StaticEvents[K]>): void;
-    /**
-     * Выполняет действие off в рамках ответственности EventBus.
-     */
-    off<K extends keyof StaticEvents>(events: OneOrMany<K>, callback: EventCallback<StaticEvents[K]>): void;
-    /**
-     * Выполняет действие offAll в рамках ответственности EventBus.
-     */
-    offAll(): void;
-    /**
-     * Публикует событие во внутренний event bus EventBus.
-     */
-    emit<K extends keyof StaticEvents>(event: K, payload: StaticEvents[K]): void;
-    /**
-     * Обрабатывает входящее событие EventBus.
-     */
-    onCustom<K extends keyof CustomEventMap>(events: OneOrMany<K>, callback: EventCallback<CustomEventMap[K]>): void;
-    /**
-     * Обрабатывает входящее событие EventBus.
-     */
-    onceCustom<K extends keyof CustomEventMap>(events: OneOrMany<K>, callback: EventCallback<CustomEventMap[K]>): void;
-    /**
-     * Выполняет действие offCustom в рамках ответственности EventBus.
-     */
-    offCustom<K extends keyof CustomEventMap>(events: OneOrMany<K>, callback: EventCallback<CustomEventMap[K]>): void;
-    /**
-     * Публикует событие во внутренний event bus EventBus.
-     */
-    emitCustom<K extends keyof CustomEventMap>(event: K, payload: CustomEventMap[K]): void;
-    /**
-     * Обрабатывает входящее событие EventBus.
-     */
-    private _on;
-    /**
-     * Обрабатывает входящее событие EventBus.
-     */
-    private _once;
-    /**
-     * Выполняет внутренний шаг _off для EventBus.
-     */
-    private _off;
-    /**
-     * Публикует событие во внутренний event bus EventBus.
-     */
-    private _emit;
-    /**
-     * Выполняет действие hasListeners в рамках ответственности EventBus.
-     */
-    hasListeners(event: string): boolean;
-    /**
-     * Выполняет действие eventNames в рамках ответственности EventBus.
-     */
-    eventNames(): Array<string>;
-    /**
-     * Очищает накопленное состояние EventBus.
-     */
-    clear(event?: string): void;
-}
-
-/**
- * Тип колбэка для события.
- * @template T Тип данных, передаваемых в событие.
- */
-export declare type EventCallback<T = any> = (payload: T) => void;
-
-export declare type EventList = Record<string, any>;
-
-export declare enum Events {
-    Add = "add",
-    Remove = "remove",
-    Update = "update",
-    IndexCreate = "indexCreate"
-}
-
-export declare function extractTime(date: Date | string | object, isLocalTime?: boolean): string;
-
-/**
- * Тип с возможностью `null`, `undefined` или любого значения.
- */
-export declare type Falsy = false | '' | 0 | null | undefined;
-
-export declare function findMinMaxDates(dates: Set<Date>): {
-    minDate: Date;
-    maxDate: 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 formatDatetimeTZSpecial(date?: Date | string | object | null, formatString?: string, options?: {}): string;
-
-export declare function formatDateToMSK(date: any): string;
-
-export declare const generateUUID: () => string;
-
-export declare function GenericExpose(options: ExposeOptions): (target: object, propertyKey: string | symbol) => void;
-
-export declare function getDateOnlyDiffFactor(d1: Date, d2: Date): {
-    variant: 'red' | 'blue';
-    value: string;
-} | null;
-
-export declare function getDayOfWeek(date: any): string;
-
-/** Returns the shared document-scoped keyboard snapshot, installing one tracker lazily. */
-export declare function getKeyboardStateSnapshot(target: Document): KeyboardStateSnapshot;
-
-export declare function getOnDeserializedMethod<T>(instance: T): (() => void) | null;
-
-export declare function getTimezoneOffsetMs(timezone: string): number;
-
-export declare type GlobalEvents = {
-    notify: {
-        severity: 'success' | 'error' | 'info' | 'warn';
-        summary: string;
-        detail?: string;
-        life?: number;
-    };
-};
-
-export declare function globalState<T>(factory: () => T): () => T;
-
-declare type HotkeyHandler = (event: KeyboardEvent) => void;
-
-/**
- * Управляет ресурсами и состоянием HotkeyManager.
- */
-export declare class HotkeyManager {
-    private bindings;
-    private enabled;
-    private readonly target;
-    private readonly ignoreInput;
-    private readonly handleBound;
-    /**
-     * Создает экземпляр HotkeyManager и подготавливает базовое состояние.
-     */
-    constructor(options?: HotkeyManagerOptions);
-    /**
-     * Выполняет внутренний шаг isIgnoredTarget для HotkeyManager.
-     */
-    private isIgnoredTarget;
-    /**
-     * Нормализует входные данные HotkeyManager.
-     */
-    private normalizeKey;
-    /**
-     * Обрабатывает runtime-событие HotkeyManager.
-     */
-    private handle;
-    /**
-     * Обрабатывает входящее событие HotkeyManager.
-     */
-    on(keys: string | Array<string>, handler: HotkeyHandler): void;
-    /**
-     * Выполняет действие off в рамках ответственности HotkeyManager.
-     */
-    off(keys: string | Array<string>, handler: HotkeyHandler): void;
-    /**
-     * Очищает накопленное состояние HotkeyManager.
-     */
-    clear(key?: string): void;
-    /**
-     * Выполняет действие enable в рамках ответственности HotkeyManager.
-     */
-    enable(): void;
-    /**
-     * Выполняет действие disable в рамках ответственности HotkeyManager.
-     */
-    disable(): void;
-    /**
-     * Освобождает runtime-ресурсы и подписки HotkeyManager.
-     */
-    destroy(): void;
-}
-
-declare interface HotkeyManagerOptions {
-    ignoreInput?: boolean;
-    target?: EventTarget;
-}
-
-/**
- * Тип, помечающий, что значение может быть `never` или `void`, и его можно проигнорировать.
- */
-export declare type Ignored = never | void;
-
-export declare function IgnoreToPlain(): PropertyDecorator;
-
-export declare interface IndexCollectionEntity<ID = string | null> {
-    id: ID;
-    index: number;
-    filteredIndex: number;
-}
-
-/**
- * Высокопроизводительная IndexedCollection
- *
- * Цели:
- * - O(1) добавление, удаление и доступ по id
- * - O(1) обновление membership фильтра (dense массив + swap-remove)
- * - Ленивый sort, полный пересчет только по запросу
- * - Инкрементальная поддержка filteredList (swap-remove) при включенном filterIndexEnabled
- *
- * Важно:
- * - При sort list меняется порядок -> filteredList должен быть пересобран (иначе он останется в старом порядке).
- * - При изменении 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;
-    /**
-     * Создает экземпляр IndexedCollection и подготавливает базовое состояние.
-     */
-    constructor(opts?: Partial<CollectionOptions<T, ID>> | null);
-    /**
-     * Выполняет действие options в рамках ответственности IndexedCollection.
-     */
-    options(opts: Partial<CollectionOptions<T, ID>>): this;
-    /**
-     * Выполняет действие markDirty в рамках ответственности IndexedCollection.
-     */
-    markDirty(opts: {
-        filter?: boolean;
-        sort?: boolean;
-    }): void;
-    /**
-     * Выполняет действие ensure в рамках ответственности IndexedCollection.
-     */
-    ensure(): void;
-    /**
-     * Выполняет действие ensureSorted в рамках ответственности IndexedCollection.
-     */
-    ensureSorted(): void;
-    /**
-     * Выполняет действие ensureFiltered в рамках ответственности IndexedCollection.
-     */
-    ensureFiltered(): void;
-    /**
-     * Выполняет действие add в рамках ответственности IndexedCollection.
-     */
-    add(items: OneOrMany<T>): void;
-    /**
-     * Удаляет сущность из runtime-коллекции IndexedCollection.
-     */
-    remove(ids: OneOrMany<ID>): void;
-    /**
-     * Вызывать после изменения полей элемента
-     * mayAffectFilter если изменились поля фильтра
-     * mayAffectSort если изменились поля сортировки
-     */
-    touch(id: ID, opts?: {
-        mayAffectFilter?: boolean;
-        mayAffectSort?: boolean;
-    }): void;
-    /**
-     * Выполняет действие forEach в рамках ответственности IndexedCollection.
-     */
-    forEach(callback: (item: T, index: number) => void): void;
-    /**
-     * Отсортированный и/или отфильтрованный список (в зависимости от включенных функций).
-     */
-    all(): Array<T>;
-    /**
-     * Отсортированный полный список (без фильтра), если есть sortFn.
-     */
-    unfiltered(): Array<T>;
-    /**
-     * Отсортированный и отфильтрованный список (если есть filterFn).
-     * Если filterFn нет — возвращается list.
-     */
-    filtered(): Array<T>;
-    /**
-     * Выполняет действие pos в рамках ответственности IndexedCollection.
-     */
-    pos(index: number): T | null;
-    /**
-     * Выполняет действие first в рамках ответственности IndexedCollection.
-     */
-    first(): T | null;
-    /**
-     * Выполняет действие last в рамках ответственности IndexedCollection.
-     */
-    last(): T | null;
-    /**
-     * Выполняет действие has в рамках ответственности IndexedCollection.
-     */
-    has(id: ID): boolean;
-    /**
-     * Возвращает значение состояния IndexedCollection.
-     */
-    get(id: ID): T | undefined;
-    /**
-     * Выполняет действие size в рамках ответственности IndexedCollection.
-     */
-    size(): number;
-    /**
-     * Очищает накопленное состояние IndexedCollection.
-     */
-    clear(): void;
-    /**
-     * Выполняет внутренний шаг rebuildFilteredFromScratch для IndexedCollection.
-     */
-    private rebuildFilteredFromScratch;
-    /**
-     * Выполняет внутренний шаг addToFilteredIfPasses для IndexedCollection.
-     */
-    private addToFilteredIfPasses;
-    /**
-     * Добавляет сущность в runtime-коллекцию IndexedCollection.
-     */
-    private appendToFiltered;
-    /**
-     * Выполняет внутренний шаг refilterOneO1 для IndexedCollection.
-     */
-    private refilterOneO1;
-    /**
-     * Удаляет сущность из runtime-коллекции IndexedCollection.
-     */
-    private removeFromFilteredO1;
-    /**
-     * Удаляет сущность из runtime-коллекции IndexedCollection.
-     */
-    private removeFromListO1;
-}
-
-export declare const IS_DEBUG: boolean;
-
-export declare function isAfterOrEqual(dateA: Date, dateB: Date): boolean;
-
-export declare function isAnyKeyComboActive(combos: KeyComboArray, event: KeyboardEvent): boolean;
-
-/**
- * Проверяет, является ли переданная функция конструктором.
- */
-export declare function isConstructor<T extends new (...args: Array<any>) => any>(fn: any): fn is T;
-
-export declare function isDateInRange(date: Date, validFrom: Date, validTo: Date): boolean;
-
-export declare function isDateRangeOverlap(s1: Date, s2: Date, validFrom: Date, validTo: Date): boolean;
-
-export declare interface ISerializable {
-    toPlain(): any;
-    toJson(): string;
-}
-
-export declare function isNullOrUndefined<T>(value: T | null | undefined): value is null | undefined;
-
-/** Formats a DateTime as `HH:mm` in the configured IANA timezone or browser-local timezone. */
-export declare function isoDateTimeToTimeInput(value: unknown, timezone?: unknown): string;
-
-export declare function IsOptionalTransformed(validationOptions?: ValidationOptions): (object: object, propertyName: string) => void;
-
-export declare function isoToDateInput(value: unknown): string;
-
-export declare function isoToDateTimeLocalInput(value: unknown): string;
-
-/**
- * Декоратор для преобразования JSON-поля:
- * - сериализует объект - строку
- * - десериализует строку - объект
- *
- * Пример:
- * @Json()
- * collection: Record<string, any> = {}
- */
-export declare function Json(): PropertyDecorator;
-
-export declare function JsonString(): PropertyDecorator;
-
-export declare type KeyboardStatePlatform = 'macos' | 'windows' | 'linux' | 'unknown';
-
-export declare interface KeyboardStateSnapshot {
-    platform: KeyboardStatePlatform;
-    modifiers: {
-        ctrl: boolean;
-        shift: boolean;
-        alt: boolean;
-        meta: boolean;
-        mod: boolean;
-        altGraph: boolean;
-    };
-    held: {
-        key: string[];
-        code: string[];
-    };
-}
-
-export declare interface KeyCombo {
-    ctrl?: boolean;
-    alt?: boolean;
-    shift?: boolean;
-    meta?: boolean;
-    key: string;
-}
-
-export declare type KeyComboArray = Array<KeyCombo>;
-
-/**
- * Тип, возвращающий все ключи объекта, значения которых равны заданному типу.
- */
-export declare type KeysWithType<T, U> = {
-    [K in keyof T]: T[K] extends U ? K : never;
-}[keyof T];
-
-/**
- * Тип, обозначающий возможное отсутствие значения.
- * Аналог Maybe<P> из функционального программирования.
- */
-export declare type Maybe<T> = T | null | undefined;
-
-/**
- * Тип, объединяющий `P` или массив `P`.
- */
-export declare type MaybeArray<T> = T | Array<T>;
-
-/** Replaces only hours and minutes while preserving the DateTime calendar date in the selected timezone. */
-export declare function mergeTimeIntoDateTime(value: unknown, time: unknown, timezone?: unknown): string | null;
-
-/**
- * Описывает ответственность NamedExecutor в архитектуре проекта.
- */
-export declare class NamedExecutor {
-    private readonly config;
-    private delayTimers;
-    private maxTimers;
-    private callbacks;
-    private firstCallTime;
-    /**
-     * Создает экземпляр NamedExecutor и подготавливает базовое состояние.
-     */
-    constructor(config: NamedExecutorConfig);
-    /**
-     * Выполняет действие run в рамках ответственности NamedExecutor.
-     */
-    run(id: string, callback: () => void): void;
-    /**
-     * Принудительно завершает накопленные изменения NamedExecutor.
-     */
-    flush(id: string): void;
-    /**
-     * Выполняет действие cancel в рамках ответственности NamedExecutor.
-     */
-    cancel(id: string): void;
-    /**
-     * Принудительно завершает накопленные изменения NamedExecutor.
-     */
-    flushAll(): void;
-    /**
-     * Очищает накопленное состояние NamedExecutor.
-     */
-    private clear;
-}
-
-declare type NamedExecutorConfig = {
-    delayMs: number;
-    maxMs: number;
-};
-
-/**
- * Тип, исключающий null и undefined.
- */
-export declare type NonNullableStrict<T> = T extends null | undefined ? never : T;
-
-/**
- * Тип, обозначающий возможное значение null.
- */
-export declare type Nullable<T> = T | null;
-
-export declare function onDeserialized(): MethodDecorator;
-
-/**
- * Универсальный тип для одного или нескольких объектов.
- */
-export declare type OneOrMany<T> = T | Array<T>;
-
-/**
- * Тип, позволяющий переопределить свойства в типе.
- * Аналог расширения типов с заменой полей.
- */
-export declare type Override<Base, Overrides> = Omit<Base, keyof Overrides> & Overrides;
-
-export declare const parseDate: (isoString: string) => "" | Date;
-
-export declare function parseDuration(duration: string): string;
-
-/**
- * Возвращает первую найденную IANA-таймзону с данным смещением (например, "+03:00").
- */
-export declare function parseOffsetToTimezone(offsetStr: string): string | null;
-
-/**
- * Тип для глубокой частичной рекурсии.
- */
-export declare type PartialDeep<T> = T extends (...args: Array<any>) => any ? T : T extends Array<infer U> ? Array<PartialDeep<U>> : T extends object ? {
-    [K in keyof T]?: PartialDeep<T[K]>;
-} : T;
-
-export declare interface PayloadClientOptions {
-    baseUrl: string;
-}
-
-export declare class PayloadHttpClient {
-    private readonly baseUrl;
-    constructor(opts: PayloadClientOptions);
-    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>;
-    delete<T>(path: string, extraHeaders?: HeadersInit): Promise<T>;
-}
-
-export declare function profile<T>(label: string, fn: () => T): T;
-
-export declare function randomString(length: number): string;
-
-export declare interface ReadonlyIndexCollection<T extends IndexCollectionEntity<ID>, ID = string | null> {
-    get(id: ID): T | undefined;
-    all(): ReadonlyArray<T>;
-    size(): number;
-    unfiltered(): ReadonlyArray<T>;
-    has(id: ID): boolean;
-    forEach(callback: (item: T) => void): void;
-}
-
-export declare function removeTime(date?: Date): Date;
-
-export declare class RingBuffer<T> {
-    private readonly _cap;
-    private readonly _buf;
-    private _head;
-    private _len;
-    constructor(capacity: number);
-    get capacity(): number;
-    get length(): number;
-    push(value: T): void;
-    clear(): void;
-    toArray(): Array<T>;
-}
-
-/**
- * Декоратор для хранения текста скрипта:
- * - сериализует как обычную строку
- * - десериализует строку, очищая лишние пробелы
- *
- * Пример:
- * @Script()
- * code: string = ''
- */
-export declare function Script(): PropertyDecorator;
-
-/**
- * Описывает ответственность Serialize в архитектуре проекта.
- */
-export declare class Serialize {
-    /**
-     * Выполняет действие toPlain в рамках ответственности Serialize.
-     */
-    static toPlain<T>(instance: T): any;
-    /**
-     * Выполняет действие fromJSON в рамках ответственности Serialize.
-     */
-    static fromJSON<T>(cls: ClassConstructor<T>, json: any): T;
-}
-
-export declare function SerializeId(): PropertyDecorator;
-
-export declare function SerializeIds(): PropertyDecorator;
-
-export declare type SharedMaybe<T> = T | null | undefined;
-
-export declare type Side = 'left' | 'right' | 'top' | 'bottom';
-
-export declare class SSEManager {
-    private readonly _url;
-    private readonly _retryInterval;
-    private _abortController;
-    private _isConnected;
-    private _reconnectTimeout;
-    private readonly _options;
-    constructor(options: SSEManagerOptions);
-    start(): void;
-    stop(): void;
-    private _scheduleReconnect;
-    private _clearReconnect;
-    private _buildHeaders;
-    private _connect;
-    get isConnected(): boolean;
-}
-
-export declare interface SSEManagerOptions {
-    url: string;
-    retryInterval?: number;
-    headers?: Record<string, string>;
-    getToken?: () => string | undefined | Promise<string | undefined>;
-    onEvent: (data: any) => void;
-    onError?: (error: Error) => void;
-    onOpen?: () => void;
-    onClose?: () => void;
-}
-
-/**
- * Структурированная запись лога.
- *
- * @example
- * {
- *   timestamp: 1692826342203,
- *   level: 'info',
- *   message: 'Компонент успешно собран',
- *   context: ['components', 'DriverCard'],
- *   actions: [
- *     {
- *       icon: 'ti ti-eye',
- *       tooltip: 'Посмотреть компонент',
- *       handler: () => alert('Открываю DriverCard'),
- *     },
- *   ],
- * }
- */
-export declare interface StructuredLogEntry {
-    /** Время создания лога (timestamp в ms) */
-    timestamp: number;
-    /** Уровень лога: _debug, info, warn или error */
-    level: 'debug' | 'info' | 'warn' | 'error' | 'success';
-    /** Сообщение лога */
-    message: string;
-    /** Контекст (иерархия вложенности) */
-    context: Array<string>;
-    /** Дополнительные действия (например, кнопки для лога) */
-    actions?: Array<{
-        icon: string;
-        tooltip?: string;
-        handler: () => void;
-    }>;
-}
-
-/**
- * Логгер с поддержкой:
- * - Иерархического контекста (`context`, `start`, `end`).
- * - Разных уровней (`_debug`, `info`, `warn`, `error`).
- * - Action-кнопок для каждого лога.
- * - Подписки на обновления (через `Subscribable`).
- *
- * @example
- * const logger = new StructuredLogger()
- *
- * // Устанавливаем контекст
- * logger.context('components', 'DriverCard')
- *
- * // Логируем сообщение
- * logger.info('Компонент успешно собран')
- *
- * // Добавляем действие
- * logger.warn('Предупреждение', [
- *   { icon: 'ti ti-alert', tooltip: 'Подробнее', handler: () => alert('Подробнее!') },
- * ])
- *
- * // Используем вложенные уровни
- * logger.start('attributes').info('Загрузка атрибутов')
- * logger.end()
- *
- * // Получаем все логи
- * const logs = logger.getLogs()
- */
-export declare class StructuredLogger extends Subscribable {
-    /** Массив всех логов */
-    private logs;
-    /** Текущий контекст (иерархия) */
-    private currentContext;
-    private currentActions;
-    /**
-     * Устанавливает текущий контекст.
-     * Сбрасывает предыдущий контекст.
-     *
-     * @param context Массив строк или несколько строк с уровнями контекста.
-     * @returns _surface (для цепочки вызовов)
-     * @example
-     * logger.context('components', 'DriverCard')
-     */
-    context(...context: Array<string>): this;
-    /**
-     * Добавляет дополнительный уровень контекста.
-     *
-     * @param context Новый уровень (например, 'attributes').
-     * @returns _surface (для цепочки вызовов)
-     * @example
-     * logger.start('attributes')
-     */
-    start(context: string): this;
-    /**
-     * Убирает последний уровень контекста.
-     * При этом может сразу добавить финальный лог, связанный с этим контекстом.
-     *
-     * @param level Уровень лога (по умолчанию 'info')
-     * @param message Сообщение лога (опционально)
-     * @param actions Дополнительные действия (опционально)
-     * @example
-     * logger.end('info', 'Компиляция завершена', [...])
-     */
-    end(level?: 'debug' | 'info' | 'warn' | 'error' | 'success', message?: string, actions?: StructuredLogEntry['actions']): this;
-    /**
-     * Добавляет экшены в текущий контекст (для следующего `end`)
-     * @param icon Иконка (например, "ti ti-check text-xl")
-     * @param tooltip Подсказка (опционально)
-     * @param handler Функция при клике (опционально)
-     * @example
-     * logger.action('ti ti-check', 'Все успешно', () => console.logFrame('Успешно!'))
-     */
-    action(icon: string, tooltip?: string, handler?: () => void): this;
-    /**
-     * Внутренний метод для создания лога.
-     *
-     * @param level Уровень (_debug, info, warn, error)
-     * @param message Сообщение
-     * @param actions Дополнительные действия (иконки с обработчиками)
-     */
-    private log;
-    /**
-     * Лог уровня _debug.
-     *
-     * @param message Сообщение
-     * @param actions Дополнительные действия (опционально)
-     * @example
-     * logger._debug('Загрузка данных')
-     */
-    debug(message: string, actions?: StructuredLogEntry['actions']): void;
-    /**
-     * Лог уровня info.
-     *
-     * @param message Сообщение
-     * @param actions Дополнительные действия (опционально)
-     * @example
-     * logger.info('Загрузка завершена')
-     */
-    info(message: string, actions?: StructuredLogEntry['actions']): void;
-    /**
-     * Лог уровня warn.
-     *
-     * @param message Сообщение
-     * @param actions Дополнительные действия (опционально)
-     * @example
-     * logger.warn('Низкий заряд батареи')
-     */
-    warn(message: string, actions?: StructuredLogEntry['actions']): void;
-    /**
-     * Лог уровня error.
-     *
-     * @param message Сообщение
-     * @param actions Дополнительные действия (опционально)
-     * @example
-     * logger.error('Ошибка загрузки', [
-     *   { icon: 'ti ti-refresh', tooltip: 'Повторить', handler: () => retry() },
-     * ])
-     */
-    error(message: string, actions?: StructuredLogEntry['actions']): void;
-    /**
-     * Лог уровня success.
-     *
-     * @param message Сообщение
-     * @param actions Дополнительные действия (опционально)
-     * @example
-     * logger.success('Успешно', [
-     *   { icon: 'ti ti-refresh', tooltip: 'Повторить', handler: () => retry() },
-     * ])
-     */
-    success(message: string, actions?: StructuredLogEntry['actions']): void;
-    /**
-     * Получить все логи.
-     *
-     * @returns Массив логов
-     */
-    getLogs(): Array<StructuredLogEntry>;
-    /**
-     * Очистить все логи (полностью).
-     */
-    clear(): void;
-}
-
-/**
- * Subscribable – базовый класс для реализации паттерна наблюдателя.
- * Предоставляет методы для подписки, отписки и уведомления слушателей.
- * Пример:
- * ```ts
- *  { refObj: domain } = useSubscribableRef(BuildX.domain)
- *  // domain будет реактивной переменной, которая тригерится при каждом внутреннем обновлении.
- *  ```
- */
-export declare class Subscribable {
-    private subscribers;
-    /**
-     * Подписывается на обновления.
-     * @param listener Функция, вызываемая при уведомлении.
-     * @returns Функция для отписки.
-     */
-    subscribe(listener: () => void): () => void;
-    /**
-     * Уведомляет всех подписчиков.
-     */
-    notify(): void;
-}
-
-/** Subscribes to the shared document-scoped keyboard state and immediately emits its snapshot. */
-export declare function subscribeKeyboardState(target: Document, listener: (snapshot: KeyboardStateSnapshot) => void): () => void;
-
-export declare const SystemClock: {
-    DateTime: typeof DateTime;
-    toDateTime(jsDate: Date): DateTime;
-    fromFormat(text: string, format: string, opts: any): DateTime;
-    fromISO(text: string, opts?: any): DateTime | null;
-    getNow(): DateTime;
-    getNowUTC(): DateTime;
-    getToday(): DateTime;
-    getTime(format?: string): string;
-    getUTCTime(format?: string): string;
-    getZone(): Zone;
-};
-
-export declare function timeToTimeInput(value: unknown): string;
-
-export declare function toInstance<T>(ctor: ClassConstructor<T>, json: object): T;
-
-export declare function toIsoZDate(value: string): string | null;
-
-export declare function toIsoZDateTime(value: string): string | null;
-
-export declare const TooltipAttribute = "x-collection-tooltip-id";
-
-export declare interface TooltipInstance {
-    id: string;
-    content: string | (() => any);
-    activator: string;
-    visible: boolean;
-    active?: boolean;
-    position?: 'top' | 'bottom' | 'left' | 'right';
-    maxWidth?: string | number;
-}
-
-export declare function TooltipRegistrator(h: TooltipRenderFunction, props: TooltipRegistratorProps): any;
-
-export declare interface TooltipRegistratorProps {
-    id?: string;
-    data?: unknown;
-    template?: unknown;
-    location?: unknown;
-    disabled?: boolean;
-    maxWidth?: string;
-    customClass?: string;
-    justifyClass?: string;
-    slots?: {
-        default?: () => any;
-    };
-}
-
-export declare type TooltipRenderFunction = (tag: string, props?: Record<string, unknown>, children?: any) => any;
-
-export declare function toPlain<T>(obj: T): object;
-
-export declare function toTimeHHMMSS(value: unknown): string | null;
-
-export declare interface TreeViewNode {
-    id: string;
-    label: string;
-    icon?: string;
-    expanded?: boolean;
-    children?: Array<TreeViewNode>;
-}
-
-/**
- * Тип, исключающий falsy-значения.
- */
-export declare type Truthy<T> = T extends Falsy ? never : T;
-
-/**
- * Декоратор @TypeMap для автоматической сериализации и десериализации `Map<K, V>`.
- * Поддерживает два формата JSON:
- * 1. **Объект - `Map<K, V>`** (если `keyField` не указан)
- * 2. **Массив - `Map<K, V>`** (если указан `keyField`)
- *
- * @param valueType - Класс значений в `Map<K, V>`.
- * @param keyField - (необязательно) Поле, используемое как ключ (`name`, `id`, и т. д.).
- *
- * ## Пример использования (объект - `Map`)
- * ```typescript
- * export class ReflectDomain {
- *   @TypeMap(RType) // JSON-объект { key: value } - Map<string, RType>
- *   private types: Map<string, RType> = new Map()
- * }
- * ```
- * **JSON**
- * ```json
- * {
- *   "types": {
- *     "User": { "name": "User", "fields": {} },
- *     "Company": { "name": "Company", "fields": {} }
- *   }
- * }
- * ```
- * **Результат**
- * ```typescript
- * ReflectDomain.types // Map<string, RType>
- * ReflectDomain.getType('User') // RType('User')
- * ```
- *
- * ## Пример использования (массив - `Map`)
- * ```typescript
- * export class ReflectDomain {
- *   @TypeMap(RType, 'name') // JSON-массив [{ name: value }, ...] - Map<string, RType>
- *   private types: Map<string, RType> = new Map()
- * }
- * ```
- * **JSON**
- * ```json
- * {
- *   "types": [
- *     { "name": "User", "fields": {} },
- *     { "name": "Company", "fields": {} }
- *   ]
- * }
- * ```
- * **Результат**
- * ```typescript
- * ReflectDomain.types // Map<string, RType>
- * ReflectDomain.getType('User') // RType('User')
- * ```
- */
-export declare function TypeMap<V>(valueType: ClassConstructor<V>, keyField?: keyof V): PropertyDecorator;
-
-/**
- * Декоратор `@TypeRecord` для автоматической (де)сериализации полей типа `Record<string, V>`.
- * Работает аналогично `@Type(() => V)`, но для структур, где ключами являются строки (как у обычного объекта),
- * а значениями — экземпляры определённого класса.
- *
- * Используется с библиотекой `class-transformer`.
- *
- * @param valueType - Класс значений, содержащихся в `Record<string, V>`.
- *
- * @example
- * ```ts
- * import { Expose } from 'class-transformer'
- *
- * class RField {
- *   @Expose()
- *   name!: string
- * }
- *
- * class Component {
- *   @Expose()
- *   @TypeRecord(RField)
- *   inputFields!: Record<string, RField>
- * }
- * ```
- *
- * ## Пример JSON:
- * ```json
- * {
- *   "inputFields": {
- *     "user": { "name": "user" },
- *     "email": { "name": "email" }
- *   }
- * }
- * ```
- * После `plainToInstance(Component, json)`:
- * ```ts
- * component.inputFields // Record<string, RField>
- * component.inputFields.user instanceof RField // true
- * ```
- *
- * ## Пример сериализации:
- * ```ts
- * const component = new Component()
- * component.inputFields = {
- *   user: new RField("user"),
- *   email: new RField("email"),
- * }
- *
- * const json = instanceToPlain(component)
- * // json = {
- * //   inputFields: {
- * //     user: { name: "user" },
- * //     email: { name: "email" }
- * //   }
- * // }
- * ```
- */
-export declare function TypeRecord<V>(valueType: ClassConstructor<V>): PropertyDecorator;
-
-/**
- * Тип, обозначающий возможное значение undefined.
- */
-export declare type Undefinable<T> = T | undefined;
-
-export declare class UPSMeter_Service {
-    private _currentCount;
-    private _lastResetTime;
-    private _lastEventsPerSecond;
-    count(): void;
-    get rate(): number;
-    reset(): void;
-}
-
-export declare const useCookie: (name: any, _opts?: any) => Ref<string, string>;
-
-export declare function useStorageDebounced<T>(key: string, initial: T, fromJSON?: (data: any) => T, toJSON?: (data: T) => any, delay?: number): Ref<T>;
-
-/**
- * Ref – обёртка для значения, поддерживающая подписку на изменения.
- */
-export declare const useSubscribableRef: <T extends Subscribable>(obj: T) => {
-    refObj: Ref<T>;
-    unsubscribe: () => void;
-};
-
-export declare const useSubscribableRefAuto: <T extends Subscribable>(obj: T) => Ref<T>;
-
-export declare const useTooltipStore: StoreDefinition<"tooltip", Pick<{
-tooltips: Record<string, TooltipInstance>;
-activeId: Ref<string | null, string | null>;
-registerTooltip: (tt: Omit<TooltipInstance, "visible">) => void;
-unregisterTooltip: (id: string) => void;
-showTooltip: (id: string) => void;
-hideTooltip: (id: string) => void;
-setActiveTooltipId: (id: string) => void;
-clearActiveTooltipId: () => void;
-}, "tooltips" | "activeId">, Pick<{
-tooltips: Record<string, TooltipInstance>;
-activeId: Ref<string | null, string | null>;
-registerTooltip: (tt: Omit<TooltipInstance, "visible">) => void;
-unregisterTooltip: (id: string) => void;
-showTooltip: (id: string) => void;
-hideTooltip: (id: string) => void;
-setActiveTooltipId: (id: string) => void;
-clearActiveTooltipId: () => void;
-}, never>, Pick<{
-tooltips: Record<string, TooltipInstance>;
-activeId: Ref<string | null, string | null>;
-registerTooltip: (tt: Omit<TooltipInstance, "visible">) => void;
-unregisterTooltip: (id: string) => void;
-showTooltip: (id: string) => void;
-hideTooltip: (id: string) => void;
-setActiveTooltipId: (id: string) => void;
-clearActiveTooltipId: () => void;
-}, "registerTooltip" | "unregisterTooltip" | "showTooltip" | "hideTooltip" | "setActiveTooltipId" | "clearActiveTooltipId">>;
-
-/**
- * Тип, представляющий функцию без аргументов и без возвращаемого значения.
- */
-export declare type VoidFn = () => void;
-
-/**
- * Backward-compatible alias used by legacy packages.
- */
-declare type VoidFunction_2 = VoidFn;
-export { VoidFunction_2 as VoidFunction }
-
-export { }
+export { useCookie } from './composable/useCookie';
+export * from './collection/collection';
+export * from './collection/indexed-collection';
+export * from './collection/collection.types';
+export * from './collection/RingBuffer';
+export * from './events/EventBus';
+export * from './events/Subscribable';
+export * from './database/PayloadHttpClient';
+export * from './execute/delay-executor';
+export * from './execute/NamedExecutor';
+export { toInstance, toPlain } from './shared/serialize/parse';
+export * from './shared/serialize/decorator';
+export { isNullOrUndefined } from './shared/types/maybe';
+export type { Maybe as SharedMaybe } from './shared/types/maybe';
+export * from './serialize/Serialize';
+export * from './serialize/decorators/json';
+export * from './serialize/decorators/jsonString';
+export * from './serialize/decorators/onDeserialized';
+export * from './serialize/decorators/script';
+export * from './serialize/decorators/typeMap';
+export * from './serialize/decorators/typeRecord';
+export * from './serialize/useStorageDebounced';
+export * from './tools/compare';
+export * from './tools/console';
+export * from './tools/debug';
+export * from './tools/generate';
+export * from './tools/geometry';
+export * from './tools/hotkeys';
+export * from './tools/keyboard';
+export * from './tools/logs';
+export * from './tools/reflect';
+export * from './tools/state';
+export * from './tools/system-clock';
+export * from './tools/text';
+export * from './tools/time';
+export * from './tools/tools.types';
+export * from './updates/SSEManager';
+export * from './updates/UPSMeter_Service';
+export * from './tooltip/store';
+export * from './tooltip/TooltipRegistrator';
+export * from './tooltip/tooltip.types';
+export * from './ui/tree.types';