@dxtmisha/functional-basic 0.12.2 → 0.12.7

package/dist/library.d.ts

@@ -107,6 +107,20 @@ export declare class Api {
      * @param callback function for call/ функция для вызова
      */
     static setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): Api;
+    /**
+     * Change the timeout for the request in milliseconds.
+     *
+     * Изменить таймаут запроса в миллисекундах.
+     * @param timeout timeout in milliseconds/ таймаут в миллисекундах
+     */
+    static setTimeout(timeout: number): Api;
+    /**
+     * Set config for API.
+     *
+     * Установить конфигурацию для API.
+     * @param config config for API/ конфигурация для API
+     */
+    static setConfig(config?: ApiConfig): Api;
     /**
      * To execute a request.
      *
@@ -144,6 +158,24 @@ export declare class Api {
     static delete<T>(request: ApiFetch): Promise<T>;
 }
 
+/**
+ * API configuration/ Конфигурация API
+ */
+export declare type ApiConfig = {
+    /** Base URL for API requests/ Базовый URL для API-запросов */
+    urlRoot?: string;
+    /** Default headers for API requests/ Заголовки по умолчанию для API-запросов */
+    headers?: Record<string, string>;
+    /** Default request data for API requests/ Данные запроса по умолчанию для API-запросов */
+    requestDefault?: Record<string, any>;
+    /** Function to call before request/ Функция для вызова перед запросом */
+    preparation?: (apiFetch: ApiFetch) => Promise<void>;
+    /** Function to call after request/ Функция для вызова после запроса */
+    end: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>;
+    /** Timeout for the request in milliseconds/ Таймаут запроса в миллисекундах */
+    timeout?: number;
+};
+
 /**
  * Shape of API response data wrapper/ Структура обёртки данных ответа API
  */
@@ -241,6 +273,12 @@ export declare type ApiFetch = {
     devMode?: boolean;
     /** Suppress error logging/ Подавить логирование ошибок */
     hideError?: boolean;
+    /** Suppress loading/ Подавить загрузку */
+    hideLoading?: boolean;
+    /** Retry count/ Количество повторов */
+    retry?: number;
+    /** Retry delay in milliseconds/ Задержка повтора в миллисекундах */
+    retryDelay?: number;
     /** Custom response processor/ Пользовательский процессор ответа */
     queryReturn?: (query: Response) => Promise<any>;
     /** Run global preparation hooks/ Запускать глобальные хуки подготовки */
@@ -249,6 +287,8 @@ export declare type ApiFetch = {
     globalEnd?: boolean;
     /** Additional fetch() options/ Дополнительные опции fetch() */
     init?: RequestInit;
+    /** Timeout for the request in milliseconds/ Таймаут запроса в миллисекундах */
+    timeout?: number;
     /** AbortController for canceling the request/ AbortController для отмены запроса */
     controller?: AbortController;
 };
@@ -294,11 +334,18 @@ export declare class ApiInstance {
     protected response: ApiResponse;
     /** Request modification handler / Обработчик модификации запроса */
     protected preparation: ApiPreparation;
+    /** Loading handler / Обработчик загрузки */
+    protected loading: LoadingInstance;
+    /** Error handler / Обработчик ошибок */
+    protected errorCenter: ErrorCenterInstance;
+    /** Timeout for the request in milliseconds/ Таймаут запроса в миллисекундах */
+    protected timeout: number;
     /**
      * Constructor
      * @param url base path to the script/ базовый путь к скрипту
+     * @param options options for the API instance/ опции для экземпляра API
      */
-    constructor(url?: string);
+    constructor(url?: string, options?: ApiInstanceOptions);
     /**
      * Is the server local.
      *
@@ -375,6 +422,13 @@ export declare class ApiInstance {
      * @param callback function for call/ функция для вызова
      */
     setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): this;
+    /**
+     * Change the timeout for the request in milliseconds.
+     *
+     * Изменить таймаут запроса в миллисекундах.
+     * @param timeout timeout in milliseconds/ таймаут в миллисекундах
+     */
+    setTimeout(timeout: number): this;
     /**
      * To execute a request.
      *
@@ -410,13 +464,22 @@ export declare class ApiInstance {
      * @param request list of parameters/ список параметров
      */
     delete<T>(request: ApiFetch): Promise<T>;
+    /**
+     * Get retry delay.
+     *
+     * Получить задержку повтора.
+     * @param retryCount count of retries/ количество повторов
+     * @param retryDelay delay between retries/ задержка между повторами
+     */
+    protected getRetryDelay(retryCount: number, retryDelay: number): number;
     /**
      * To execute a request.
      *
      * Выполнить запрос.
      * @param apiFetch property of the request/ свойство запроса
+     * @param retryCount count of retries/ количество повторов
      */
-    protected fetch<T>(apiFetch: ApiFetch): Promise<T>;
+    protected fetch<T>(apiFetch: ApiFetch, retryCount?: number): Promise<T>;
     /**
      * Reading data from the response.
      *
@@ -432,7 +495,10 @@ export declare class ApiInstance {
      * Выполнение запроса.
      * @param apiFetch property of the request/ свойство запроса
      */
-    protected makeQuery(apiFetch: ApiFetch): Promise<Response>;
+    protected makeQuery(apiFetch: ApiFetch): Promise<{
+        query: Response;
+        timeoutId: any;
+    }>;
     /**
      * Transforms data if needed.
      *
@@ -449,8 +515,51 @@ export declare class ApiInstance {
      * @param status status object/ объект статуса
      */
     protected makeStatus<T>(data: ApiData<T>, status: ApiStatus): ApiData<T>;
+    /**
+     * Processing an error.
+     *
+     * Обработка ошибки.
+     * @param error error object/ объект ошибки
+     * @param group error group/ группа ошибки
+     */
+    protected makeError(error: Record<string, any> & {
+        name: string;
+    }, group?: string): void;
+    /**
+     * Processing an error query.
+     *
+     * Обработка ошибки запроса.
+     * @param query error query/ ошибка запроса
+     */
+    protected makeErrorQuery(query: Response): void;
+    /**
+     * Initialize controller for request.
+     *
+     * Инициализация контроллера для запроса.
+     * @param apiFetch request options/ опции запроса
+     * @param fetchInit request initialization/ инициализация запроса
+     */
+    protected initController(apiFetch: ApiFetch, fetchInit: RequestInit): any;
 }
 
+/** Options for the API instance/ Опции для экземпляра API */
+export declare type ApiInstanceOptions = {
+    /** Class for working with headers/ Класс для работы с заголовками */
+    headersClass?: typeof ApiHeaders;
+    /** Class for working with default request parameters/ Класс для работы с параметрами запроса по умолчанию */
+    requestDefaultClass?: typeof ApiDefault;
+    /** Class for working with status/ Класс для работы со статусом */
+    statusClass?: typeof ApiStatus;
+    /** Class for working with response/ Класс для работы с ответом */
+    responseClass?: typeof ApiResponse;
+    /** Class for working with preparation/ Класс для работы с модификацией запроса */
+    preparationClass?: typeof ApiPreparation;
+    /** Instance of loading handler/ Экземпляр обработчика загрузки */
+    loadingClass?: LoadingInstance;
+    /** Instance of error handler/ Экземпляр обработчика ошибок */
+    errorCenterClass?: ErrorCenterInstance;
+};
+
 /**
  * Supported HTTP methods type/ Тип HTTP-методов
  * (derived from ApiMethodItem enum)/ (получен из перечисления ApiMethodItem)
@@ -857,8 +966,9 @@ export declare class BroadcastMessage<Message = any> {
      * @param name channel name/ название канала
      * @param callback callback on message received/ колбэк на получение сообщения
      * @param callbackError callback on message error/ колбэк на ошибку сообщения
+     * @param errorCenter error center instance/ экземпляр центра ошибок
      */
-    constructor(name: string, callback?: ((event: MessageEvent<Message>) => void) | undefined, callbackError?: ((event: MessageEvent<Message>) => void) | undefined);
+    constructor(name: string, callback?: ((event: MessageEvent<Message>) => void) | undefined, callbackError?: ((event: MessageEvent<Message>) => void) | undefined, errorCenter?: ErrorCenterInstance);
     /**
      * Get the channel.
      *
@@ -1013,6 +1123,14 @@ export declare class CacheStatic {
     static get<T>(name: string, callback: () => T, comparison?: any[]): T;
 }
 
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * Делает первую букву строки заглавной.
+ * @param value string to capitalize / строка для капитализации
+ */
+export declare function capitalize(value: string): string;
+
 /**
  * Class for working with cookies.
  *
@@ -1136,6 +1254,7 @@ export declare function createElement<T extends HTMLElement>(parentElement?: HTM
 export declare class DataStorage<T> {
     private name;
     private isSession;
+    private errorCenter;
     /**
      * Changing the prefix in key names. Should be called at the beginning of the code.
      *
@@ -1149,8 +1268,9 @@ export declare class DataStorage<T> {
      * Constructor
      * @param name value name/ название значения
      * @param isSession should we use a session/ использовать ли сессию
+     * @param errorCenter error center instance/ экземпляр центра ошибок
      */
-    constructor(name: string, isSession?: boolean);
+    constructor(name: string, isSession?: boolean, errorCenter?: ErrorCenterInstance);
     /**
      * Getting data from local storage.
      *
@@ -1751,6 +1871,254 @@ export declare function encodeAttribute(text: string): string;
  */
 export declare function ensureMaxSize(file: Uint8Array, compress?: number, type?: string): Promise<string>;
 
+/**
+ * Class for managing error storage and handling.
+ *
+ * Класс для управления хранилищем ошибок и их обработкой.
+ */
+export declare class ErrorCenter {
+    /** Instance of the error center / Экземпляр центра ошибок */
+    protected static item: ErrorCenterInstance;
+    /**
+     * Checks if a cause with specific code exists.
+     *
+     * Проверяет наличие причины с конкретным кодом.
+     * @param code error code / код ошибки
+     * @param group error group / группа ошибки
+     */
+    static has(code: string, group?: string): boolean;
+    /**
+     * Gets a specific error cause by code and group.
+     *
+     * Получает конкретную причину ошибки по коду и группе.
+     * @param code error code / код ошибки
+     * @param group error group / группа ошибки
+     */
+    static get(code: string, group?: string): ErrorCenterCauseItem | undefined;
+    /**
+     * Returns the instance of the class.
+     *
+     * Возвращает инстанс класса.
+     */
+    static getItem(): ErrorCenterInstance;
+    /**
+     * Adds an error cause to the storage.
+     *
+     * Добавляет причину ошибки в хранилище.
+     * @param cause error cause item / элемент причины ошибки
+     */
+    static add(cause: ErrorCenterCauseItem): ErrorCenter;
+    /**
+     * Adds a list of error causes to the storage.
+     *
+     * Добавляет список причин ошибок в хранилище.
+     * @param causes error causes list / список причин ошибок
+     */
+    static addList(causes: ErrorCenterCauseList): ErrorCenter;
+    /**
+     * Registers a new handler.
+     *
+     * Регистрирует новый обработчик.
+     * @param group target group / целевая группа
+     * @param handler handler callback / обратный вызов обработчика
+     */
+    static addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): ErrorCenter;
+    /**
+     * Registers a list of handlers.
+     *
+     * Регистрирует список обработчиков.
+     * @param handlers handlers list / список обработчиков
+     */
+    static addHandlerList(handlers: ErrorCenterHandlerList): ErrorCenter;
+    /**
+     * Triggers error handling for a group.
+     *
+     * Вызывает обработку ошибки для группы.
+     * @param cause error cause details / детали причины ошибки
+     */
+    static on(cause: ErrorCenterCauseItem): ErrorCenter;
+}
+
+/**
+ * Interface for an error item / Интерфейс для элемента ошибки
+ */
+export declare type ErrorCenterCauseItem = {
+    /** Error group / Группа ошибки */
+    group?: ErrorCenterGroup;
+    /** Error code / Код ошибки */
+    code: string;
+    /** Error label / Название ошибки */
+    label?: string;
+    /** Error message / Сообщение ошибки */
+    message?: string;
+    /** Additional details / Дополнительные детали */
+    details?: any;
+};
+
+/**
+ * List of error items / Список элементов ошибок
+ */
+export declare type ErrorCenterCauseList = ErrorCenterCauseItem[];
+
+/**
+ * Error group identifier / Идентификатор группы ошибок
+ */
+export declare type ErrorCenterGroup = string | undefined;
+
+/**
+ * Class for managing and triggering error handlers.
+ *
+ * Класс для управления и вызова обработчиков ошибок.
+ */
+export declare class ErrorCenterHandler {
+    /** Registered handlers list / Список зарегистрированных обработчиков */
+    protected handlers: ErrorCenterHandlerList;
+    /**
+     * Constructor
+     * @param handlers initial handlers list / начальный список обработчиков
+     */
+    constructor(handlers?: ErrorCenterHandlerList);
+    /**
+     * Checks if handlers exist for a group.
+     *
+     * Проверяет наличие обработчиков для группы.
+     * @param group error group / группа ошибки
+     */
+    has(group: ErrorCenterGroup): boolean;
+    /**
+     * Gets handlers for a group.
+     *
+     * Получает обработчики для группы.
+     * @param group error group / группа ошибки
+     */
+    get(group: ErrorCenterGroup): ErrorCenterHandlerItem | undefined;
+    /**
+     * Adds a handler for a specific group.
+     *
+     * Добавляет обработчик для определенной группы.
+     * @param group error group / группа ошибки
+     * @param handler callback function / функция обратного вызова
+     */
+    add(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this;
+    /**
+     * Adds a list of group-based handlers.
+     *
+     * Добавляет список обработчиков по группам.
+     * @param handlers handlers list / список обработчиков
+     */
+    addList(handlers: ErrorCenterHandlerList): this;
+    /**
+     * Triggers handlers for a group and logs to console.
+     *
+     * Вызывает обработчики для группы и выводит ошибку в консоль.
+     * @param cause error cause details / детали причины ошибки
+     */
+    on(cause: ErrorCenterCauseItem): this;
+    /**
+     * Logs error cause to the console.
+     *
+     * Выводит причину ошибки в консоль.
+     * @param cause error details / детали ошибки
+     */
+    protected toConsole(cause: ErrorCenterCauseItem): this;
+}
+
+/**
+ * Callback function for error handling / Функция обратного вызова для обработки ошибок
+ */
+export declare type ErrorCenterHandlerCallback = (cause: ErrorCenterCauseItem) => void;
+
+/**
+ * Interface for error handler storage / Интерфейс для хранения обработчика ошибок
+ */
+export declare type ErrorCenterHandlerItem = {
+    /** Targeted error group / Целевая группа ошибок */
+    group?: ErrorCenterGroup;
+    /** List of handlers / Список обработчиков */
+    handlers: ErrorCenterHandlerCallback[];
+};
+
+/**
+ * List of error handlers / Список обработчиков ошибок
+ */
+export declare type ErrorCenterHandlerList = ErrorCenterHandlerItem[];
+
+/**
+ * Class for managing error storage and handling within an instance.
+ *
+ * Класс для управления хранилищем ошибок и их обработкой внутри экземпляра.
+ */
+export declare class ErrorCenterInstance {
+    protected handler: ErrorCenterHandler;
+    /** List of stored error causes / Список сохраненных причин ошибок */
+    protected causes: ErrorCenterCauseList;
+    /**
+     * Constructor
+     * @param causes initial list of error causes / начальный список причин ошибок
+     * @param handler handler instance / экземпляр обработчика
+     */
+    constructor(causes?: ErrorCenterCauseList, handler?: ErrorCenterHandler);
+    /**
+     * Checks if a cause with specific code exists.
+     *
+     * Проверяет наличие причины с конкретным кодом.
+     * @param code error code / код ошибки
+     * @param group error group / группа ошибки
+     */
+    has(code: string, group?: string): boolean;
+    /**
+     * Gets a specific error cause by code and group.
+     *
+     * Получает конкретную причину ошибки по коду и группе.
+     * @param code error code / код ошибки
+     * @param group error group / группа ошибки
+     */
+    get(code: string, group?: string): ErrorCenterCauseItem | undefined;
+    /**
+     * Adds an error cause to the storage.
+     *
+     * Добавляет причину ошибки в хранилище.
+     * @param cause error cause item / элемент причины ошибки
+     */
+    add(cause: ErrorCenterCauseItem): this;
+    /**
+     * Adds a list of error causes to the storage.
+     *
+     * Добавляет список причин ошибок в хранилище.
+     * @param causes error causes list / список причин ошибок
+     */
+    addList(causes: ErrorCenterCauseList): this;
+    /**
+     * Registers a new handler.
+     *
+     * Регистрирует новый обработчик.
+     * @param group target group / целевая группа
+     * @param handler handler callback / обратный вызов обработчика
+     */
+    addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this;
+    /**
+     * Registers a list of handlers.
+     *
+     * Регистрирует список обработчиков.
+     * @param handlers handlers list / список обработчиков
+     */
+    addHandlerList(handlers: ErrorCenterHandlerList): this;
+    /**
+     * Triggers error handling for a group.
+     *
+     * Вызывает обработку ошибки для группы.
+     * @param cause error cause details / детали причины ошибки
+     */
+    on(cause: ErrorCenterCauseItem): this;
+    /**
+     * Merges provided cause with stored cause data.
+     *
+     * Объединяет предоставленную причину с сохраненными данными причины.
+     * @param cause input cause / входная причина
+     */
+    protected assign(cause: ErrorCenterCauseItem): ErrorCenterCauseItem;
+}
+
 /**
  * Escapes special regex characters in a string so it can be used safely in a RegExp.
  *
@@ -2726,6 +3094,7 @@ export declare type GeoHours = '12' | '24';
  * языка-зависимых функций
  */
 export declare class GeoIntl {
+    private errorCenter;
     /**
      * Returns an instance of the class according to the specified country code.
      *
@@ -2739,8 +3108,9 @@ export declare class GeoIntl {
      * Constructor
      * @param code country code, full form language-country or one of them/
      * код страны, полный вид язык-страна или один из них
+     * @param errorCenter error center instance/ экземпляр центра ошибок
      */
-    constructor(code?: string);
+    constructor(code?: string, errorCenter?: ErrorCenterInstance);
     /**
      * Returns country code and language.
      *
@@ -3024,8 +3394,8 @@ export declare interface GeoItemFull extends Omit<GeoItem, 'firstDay'> {
  * Класс для хранения и обработка маски телефона.
  */
 export declare class GeoPhone {
-    protected static list: GeoPhoneValue[];
-    protected static map: Record<string, GeoPhoneMap>;
+    protected static list?: GeoPhoneValue[];
+    protected static map?: Record<string, GeoPhoneMap>;
     /**
      * Getting an object with information about the phone code and country.
      *
@@ -3611,6 +3981,13 @@ export declare class Icons {
      * @param url new file path/ новый путь к файлу
      */
     static setUrl(url: string): void;
+    /**
+     * Changes the configuration.
+     *
+     * Изменяет конфигурацию.
+     * @param config new configuration/ новая конфигурация
+     */
+    static setConfig(config: IconsConfig): void;
     /**
      * Returns the icon name.
      *
@@ -3626,6 +4003,13 @@ export declare class Icons {
     protected static wait(): Promise<void>;
 }
 
+export declare type IconsConfig = {
+    /** URL to the icons storage / URL к хранилищу иконок */
+    url?: string;
+    /** List of custom icons / Список пользовательских иконок */
+    list?: Record<string, IconsItem>;
+};
+
 export declare type IconsItem = string | Promise<string | any> | (() => Promise<string | any>);
 
 /** Type for 2D coordinates/ Тип для 2D координат */
@@ -3806,6 +4190,14 @@ export declare function isObject<T>(value: T): value is Extract<T, Record<any, a
  */
 export declare function isObjectNotArray<T>(value: T): value is Exclude<Extract<T, Record<any, any>>, any[] | undefined | null>;
 
+/**
+ * Check if the device is online.
+ *
+ * Проверка, находится ли устройство в сети.
+ * @returns true if the device is online, false otherwise/true, если устройство в сети, иначе false
+ */
+export declare function isOnLine(): boolean;
+
 /**
  * Checks if value is in the array selected or if value equals selected, if selected is a string.
  *
@@ -3893,9 +4285,8 @@ export declare type ItemValue<V> = {
  * Класс для работы с глобальной загрузкой.
  */
 export declare class Loading {
-    protected static value: number;
-    protected static event?: EventItem<Window, CustomEvent>;
-    protected static registrationList: LoadingRegistrationItem[];
+    /** Instance of the loading class / Экземпляр класса загрузки */
+    protected static item: LoadingInstance;
     /**
      * Check if the loader is active now.
      *
@@ -3908,6 +4299,12 @@ export declare class Loading {
      * Получить текущее значение загрузки.
      */
     static get(): number;
+    /**
+     * Get instance of the loading class.
+     *
+     * Получить экземпляр класса загрузки.
+     */
+    static getItem(): LoadingInstance;
     /**
      * Shows the loader.
      *
@@ -3940,21 +4337,101 @@ export declare class Loading {
      * @param element element/ элемент
      */
     static unregistrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
+}
+
+/**
+ * Data for the loading event.
+ *
+ * Данные для события загрузки.
+ */
+export declare type LoadingDetail = {
+    /** Loading status / Статус загрузки */
+    loading: boolean;
+};
+
+/**
+ * Class for working with global loading.
+ *
+ * Класс для работы с глобальной загрузкой.
+ */
+export declare class LoadingInstance {
+    protected eventName: string;
+    /** Current loading value / Текущее значение загрузки */
+    protected value: number;
+    /** Event item / Элемент события */
+    protected event?: EventItem<Window, CustomEvent>;
+    /** Registration list / Список регистрации */
+    protected registrationList: LoadingRegistrationItem[];
+    /**
+     * Constructor
+     * @param eventName name of the event for tracking loading/ название события для отслеживания загрузки
+     */
+    constructor(eventName?: string);
+    /**
+     * Check if the loader is active now.
+     *
+     * Проверить, активен ли сейчас загрузчик.
+     * @returns returns true if the loader is active/ возвращает true, если загрузчик активен
+     */
+    is(): boolean;
+    /**
+     * Get current loading value.
+     *
+     * Получить текущее значение загрузки.
+     * @returns returns the current loading value/ возвращает текущее значение загрузки
+     */
+    get(): number;
+    /**
+     * Shows the loader.
+     *
+     * Показывает загрузчик.
+     */
+    show(): void;
+    /**
+     * Hides the loader.
+     *
+     * Скрывает загрузчик.
+     */
+    hide(): void;
+    /**
+     * Event registration to listen for data changes.
+     *
+     * Регистрация события для прослушивания изменений данных.
+     * @param listener the object that receives a notification (an object that implements the
+     * Event interface) when an event of the specified type occurs/ объект, который принимает
+     * уведомление, когда событие указанного типа произошло
+     * @param element element/ элемент
+     */
+    registrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
+    /**
+     * Unregistration of an event.
+     *
+     * Отмена регистрации события.
+     * @param listener the object that receives a notification (an object that implements the
+     * Event interface) when an event of the specified type occurs/ объект, который принимает
+     * уведомление, когда событие указанного типа произошло
+     * @param element element/ элемент
+     */
+    unregistrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
     /**
      * Calls the event listener.
      *
      * Вызывает слушателя событий.
      */
-    protected static dispatch(): void;
+    protected dispatch(): void;
 }
 
-declare type LoadingDetail = {
-    loading: boolean;
-};
-
-declare type LoadingRegistrationItem = {
+/**
+ * Registration item for the loading event.
+ *
+ * Элемент регистрации для события загрузки.
+ */
+export declare type LoadingRegistrationItem = {
+    /** Event item / Элемент события */
     item: EventItem<Window, CustomEvent, LoadingDetail>;
+    /** Event listener / Слушатель события */
     listener: EventListenerDetail<CustomEvent, LoadingDetail>;
+    /** Element / Элемент */
     element?: ElementOrString<HTMLElement>;
 };
 
@@ -5689,6 +6166,14 @@ export declare function setValues<T>(selected: T | T[] | undefined, value: any,
     notEmpty?: boolean | undefined;
 }): T | T[] | undefined;
 
+/**
+ * Pause execution for a specified number of milliseconds.
+ *
+ * Приостановить выполнение на указанное количество миллисекунд.
+ * @param ms milliseconds/ миллисекунды
+ */
+export declare function sleep(ms: number): Promise<void>;
+
 /**
  * This method is used to copy the values of all enumerable own properties from one source object to a target object.
  * In priority according to the processing list.
@@ -5844,13 +6329,7 @@ export declare function transformation(value: any, isFunction?: boolean): any;
  * Класс для получения переведенного текста.
  */
 export declare class Translate {
-    protected static url: string;
-    protected static propsName: string;
-    protected static readonly data: Record<string, string>;
-    protected static cache: string[];
-    protected static resolveList: (() => void)[];
-    protected static timeout?: any;
-    protected static isReadApi: boolean;
+    protected static item: TranslateInstance;
     /**
      * Getting the translation text by its code.
      *
@@ -5859,6 +6338,12 @@ export declare class Translate {
      * @param replacement If set, replaces the text with the specified values/ если установлено, заменяет текст на указанные значения
      */
     static get(name: string, replacement?: string[] | Record<string, string | number>): Promise<string>;
+    /**
+     * Returns an instance of the class.
+     *
+     * Возвращает экземпляр класса.
+     */
+    static getItem(): TranslateInstance;
     /**
      * Getting the translation text by its code (Sync).
      *
@@ -5943,109 +6428,60 @@ export declare class Translate {
      */
     static setReadApi(value: boolean): Translate;
     /**
-     * Checks for translation by code, taking into account fallback options.
-     *
-     * Проверяет наличие перевода по коду с учетом запасных вариантов.
-     * @param name code name/ название кода
-     */
-    protected static hasName(name: string): boolean;
-    /**
-     * Retrieves translation text by code, returning the first matching fallback.
-     *
-     * Получает текст перевода по коду, возвращая первое совпадение из запасных вариантов.
-     * @param name code name/ название кода
-     */
-    protected static getText(name: string): string | undefined;
-    /**
-     * Getting the full title for translation.
-     *
-     * Получение полного названия для перевода.
-     * @param name code name/ название кода
-     */
-    protected static getName(name: string): string;
-    /**
-     * Getting the title for translation by language.
-     *
-     * Получение названия для перевода по языку.
-     * @param name code name/ название кода
-     */
-    protected static getNameByLanguage(name: string): string;
-    /**
-     * Getting the title for translation globally.
-     *
-     * Получение названия для перевода глобально.
-     * @param name code name/ название кода
-     */
-    protected static getNameByGlobal(name: string): string;
-    /**
-     * Returns a list of names that are not yet in the list.
-     *
-     * Возвращает список имен, которых еще нет в списке.
-     * @param names list of codes to get translations/ список кодов для получения переводов
-     */
-    protected static getNamesNone(names: string | string[]): string[];
-    /**
-     * Getting the list of translations from the server.
-     *
-     * Получение списка переводов с сервера.
-     */
-    protected static getResponse(): Promise<Record<string, string>>;
-    /**
-     * Replaces the text with the specified values.
-     *
-     * Заменяет текст на указанные значения.
-     * @param text text to replace/ текст для замены
-     * @param replacement values for replacement/ значения для замены
-     */
-    protected static replacement(text: string, replacement?: string[] | Record<string, string | number>): any;
-    /**
-     * Adding translation data from the server.
+     * Set the configuration for the translation.
      *
-     * Добавление данных по переводу с сервера.
+     * Установить конфигурацию для перевода.
+     * @param config configuration/ конфигурация
      */
-    protected static make(): Promise<void>;
-    /**
-     * Adding translation data from the list.
-     *
-     * Добавление данных по переводу из списка.
-     * @param list list of translations/ список переводов
-     */
-    protected static makeList(list: Record<string, string>): void;
+    static setConfig(config: TranslateConfig): Translate;
 }
 
 /**
- * Prefix for global translations.
- * Префикс для глобальных переводов.
+ * Prefix for global translations/
+ * Префикс для глобальных переводов
  */
 export declare const TRANSLATE_GLOBAL_PREFIX = "global";
 
 /**
- * Request timeout for batch loading (ms).
- * Таймаут запроса для пакетной загрузки (мс).
+ * Request timeout for batch loading (ms)/
+ * Таймаут запроса для пакетной загрузки (мс)
  */
 export declare const TRANSLATE_TIME_OUT = 160;
 
 /**
- * Translation code or a list of translation codes for template replacement.
- * Код перевода или список кодов для замены шаблона.
+ * Translation code or a list of translation codes for template replacement/
+ * Код перевода или список кодов для замены шаблона
  */
 export declare type TranslateCode = string | string[];
 
 /**
- * A mapping of locale strings to their respective translation file loaders.
- * Сопоставление строк локалей и соответствующих им загрузчиков файлов перевода.
+ * Interface for the functional plugin options /
+ * Интерфейс для опций функционального плагина
+ */
+export declare type TranslateConfig = {
+    /** URL to the translations script / URL к скрипту переводов */
+    url?: string;
+    /** Property name for translations / Имя свойства для переводов */
+    propsName?: string;
+    /** Read translations from API / Читать переводы из API */
+    readApi?: boolean;
+};
+
+/**
+ * A mapping of locale strings to their respective translation file loaders/
+ * Сопоставление строк локалей и соответствующих им загрузчиков файлов перевода
  */
 export declare type TranslateDataFile = Record<string, TranslateDataFileItem>;
 
 /**
- * Asynchronous loader function for a translation file.
- * Асинхронная функция-загрузчик для файла перевода.
+ * Asynchronous loader function for a translation file/
+ * Асинхронная функция-загрузчик для файла перевода
  */
 export declare type TranslateDataFileItem = () => Promise<TranslateDataFileList>;
 
 /**
- * A simple key-value record of translations from a file.
- * Простой рекорд «ключ-значение» с переводами из файла.
+ * A simple key-value record of translations from a file/
+ * Простой рекорд «ключ-значение» с переводами из файла
  */
 export declare type TranslateDataFileList = Record<string, string>;
 
@@ -6055,60 +6491,273 @@ export declare type TranslateDataFileList = Record<string, string>;
  * Класс для работы с файлами перевода.
  */
 export declare class TranslateFile {
+    protected language: string | (() => string);
+    protected location: string | (() => string);
     /** List of files with translations/ Список файлов с переводами */
-    protected static files: TranslateDataFile;
+    protected files: TranslateDataFile;
     /** Data from files/ Данные из файлов */
-    protected static data: Record<string, TranslateDataFileList>;
+    protected data: Record<string, TranslateDataFileList>;
+    /**
+     * Creates an instance of the class.
+     *
+     * Создает экземпляр класса.
+     * @param data list of files/ список файлов
+     * @param language language/ язык
+     * @param location location/ местоположение
+     */
+    constructor(data?: TranslateDataFile, language?: string | (() => string), location?: string | (() => string));
     /**
      * Checks if there are files for the current location.
      *
      * Проверяет, есть ли файлы для текущего местоположения.
      */
-    static isFile(): boolean;
+    isFile(): boolean;
+    /**
+     * Returns the location.
+     *
+     * Возвращает местоположение.
+     */
+    getLocation(): string;
+    /**
+     * Returns the language.
+     *
+     * Возвращает язык.
+     */
+    getLanguage(): string;
     /**
      * Returns a list of translations from the file for the current location.
      *
      * Возвращает список переводов из файла для текущего местоположения.
      */
-    static getList(): Promise<TranslateDataFileList | undefined>;
+    getList(): Promise<TranslateDataFileList | undefined>;
     /**
      * Adds a list of files with translations.
      *
      * Добавляет список файлов с переводами.
      * @param data list of files/ список файлов
      */
-    static add(data: TranslateDataFile): void;
+    add(data: TranslateDataFile): void;
     /**
      * Returns the key for the current location from the list of files.
      *
      * Возвращает ключ для текущего местоположения из списка файлов.
      */
-    protected static getIndex(): string | undefined;
+    protected getIndex(): string | undefined;
     /**
      * Returns a list of translations from the cache.
      *
      * Возвращает список переводов из кэша.
      * @param index file key/ ключ файла
      */
-    protected static getByData(index: string): TranslateDataFileList | undefined;
+    protected getByData(index: string): TranslateDataFileList | undefined;
     /**
      * Returns a list of translations from the file and caches the result.
      *
      * Возвращает список переводов из файла и кэширует результат.
      * @param index file key/ ключ файла
      */
-    protected static getByFile(index: string): Promise<TranslateDataFileList | undefined>;
+    protected getByFile(index: string): Promise<TranslateDataFileList | undefined>;
+}
+
+/**
+ * Class for getting the translated text.
+ *
+ * Класс для получения переведенного текста.
+ */
+export declare class TranslateInstance {
+    protected url: string;
+    protected propsName: string;
+    protected readonly files: TranslateFile;
+    /** List of translations/ Список переводов */
+    protected readonly data: Record<string, string>;
+    /** Cache of codes to get/ Кэш кодов для получения */
+    protected cache: string[];
+    /** List of resolves for promises/ Список разрешений для промисов */
+    protected resolveList: (() => void)[];
+    /** Timeout for getting translations/ Таймаут для получения переводов */
+    protected timeout?: any;
+    /** Flag indicating whether to read from the API/ Флаг, указывающий, нужно ли читать из API */
+    protected isReadApi: boolean;
+    /**
+     * Creates an instance of the class.
+     *
+     * Создает экземпляр класса.
+     * @param url URL for getting translations/ URL для получения переводов
+     * @param propsName Property name for getting translations/ Имя свойства для получения переводов
+     * @param files List of files with translations/ Список файлов с переводами
+     */
+    constructor(url?: string, propsName?: string, files?: TranslateFile);
+    /**
+     * Getting the translation text by its code.
+     *
+     * Получение текста перевода по его коду.
+     * @param name code name/ название кода
+     * @param replacement If set, replaces the text with the specified values/ если установлено, заменяет текст на указанные значения
+     */
+    get(name: string, replacement?: string[] | Record<string, string | number>): Promise<string>;
+    /**
+     * Getting the translation text by its code (Sync).
+     *
+     * Получение текста перевода по его коду (Sync).
+     * @param name code name/ название кода
+     * @param first If set to false, returns an empty string if there is no text/
+     * если установлено false, возвращает пустую строку, если нет текста
+     * @param replacement If set, replaces the text with the specified values/
+     * если установлено, заменяет текст на указанные значения
+     */
+    getSync(name: string, first?: boolean, replacement?: string[] | Record<string, string | number>): string;
+    /**
+     * Getting a list of translations by an array of text codes.
+     *
+     * Получение списка переводов по массиву кодов текста.
+     * @param names list of codes to get translations/ список кодов для получения переводов
+     */
+    getList<T extends TranslateCode[]>(names: T): Promise<TranslateList<T>>;
+    /**
+     * Getting a list of translations by an array of text codes.
+     *
+     * Получение списка переводов по массиву кодов текста.
+     * @param names list of codes to get translations/ список кодов для получения переводов
+     * @param first If set to false, returns an empty string if there is no text/
+     * если установлено false, возвращает пустую строку, если нет текста
+     */
+    getListSync<T extends TranslateCode[]>(names: T, first?: boolean): TranslateList<T>;
+    /**
+     * Added a list of translated texts.
+     *
+     * Добавлен список переведенных текстов.
+     * @param names list of codes to get translations/ список кодов для получения переводов
+     */
+    add(names: string | string[]): Promise<void>;
+    /**
+     * Adds texts in sync mode.
+     *
+     * Добавляет тексты в режиме синхронизации.
+     * @param data list of texts in the form of key-value/ список текстов в виде ключ-значение
+     */
+    addSync(data: Record<string, string>): void;
+    /**
+     * Adding data in the form of a query or directly, depending on the execution environment.
+     *
+     * Добавление данных в виде запроса или напрямую, в зависимости от среды выполнения.
+     * @param data list of texts in the form of key-value/ список текстов в виде ключ-значение
+     */
+    addNormalOrSync(data: Record<string, string>): Promise<void>;
+    /**
+     * Adds texts synchronously by location.
+     *
+     * Добавляет тексты синхронно по местоположению.
+     * @param data list of texts by location/ список текстов по местоположению
+     */
+    addSyncByLocation(data: Record<string, Record<string, string>>): void;
+    /**
+     * Adds texts synchronously from the file.
+     *
+     * Добавляет тексты синхронно из файла.
+     * @param data file with translations/ файл с переводами
+     */
+    addSyncByFile(data: TranslateDataFile): void;
+    /**
+     * Change the path to the script for obtaining the translation.
+     *
+     * Изменить путь к скрипту для получения перевода.
+     * @param url path to the script/ путь к скрипту
+     */
+    setUrl(url: string): this;
+    /**
+     * Change the name of the property to get the translation.
+     *
+     * Изменить имя свойства для получения перевода.
+     * @param name property name/ имя свойства
+     */
+    setPropsName(name: string): this;
+    /**
+     * Change the read mode from the API.
+     *
+     * Изменить режим чтения из API.
+     * @param value read mode/ режим чтения
+     */
+    setReadApi(value: boolean): this;
+    /**
+     * Checks for translation by code, taking into account fallback options.
+     *
+     * Проверяет наличие перевода по коду с учетом запасных вариантов.
+     * @param name code name/ название кода
+     */
+    protected hasName(name: string): boolean;
+    /**
+     * Retrieves translation text by code, returning the first matching fallback.
+     *
+     * Получает текст перевода по коду, возвращая первое совпадение из запасных вариантов.
+     * @param name code name/ название кода
+     */
+    protected getText(name: string): string | undefined;
+    /**
+     * Getting the full title for translation.
+     *
+     * Получение полного названия для перевода.
+     * @param name code name/ название кода
+     */
+    protected getName(name: string): string;
+    /**
+     * Getting the title for translation by language.
+     *
+     * Получение названия для перевода по языку.
+     * @param name code name/ название кода
+     */
+    protected getNameByLanguage(name: string): string;
+    /**
+     * Getting the title for translation globally.
+     *
+     * Получение названия для перевода глобально.
+     * @param name code name/ название кода
+     */
+    protected getNameByGlobal(name: string): string;
+    /**
+     * Returns a list of names that are not yet in the list.
+     *
+     * Возвращает список имен, которых еще нет в списке.
+     * @param names list of codes to get translations/ список кодов для получения переводов
+     */
+    protected getNamesNone(names: string | string[]): string[];
+    /**
+     * Getting the list of translations from the server.
+     *
+     * Получение списка переводов с сервера.
+     */
+    protected getResponse(): Promise<Record<string, string>>;
+    /**
+     * Replaces the text with the specified values.
+     *
+     * Заменяет текст на указанные значения.
+     * @param text text to replace/ текст для замены
+     * @param replacement values for replacement/ значения для замены
+     */
+    protected replacement(text: string, replacement?: string[] | Record<string, string | number>): any;
+    /**
+     * Adding translation data from the server.
+     *
+     * Добавление данных по переводу с сервера.
+     */
+    protected make(): Promise<void>;
+    /**
+     * Adding translation data from the list.
+     *
+     * Добавление данных по переводу из списка.
+     * @param list list of translations/ список переводов
+     */
+    protected makeList(list: Record<string, string>): void;
 }
 
 /**
- * Return type for translation retrieval: an object if a list was requested, or a string for a single key.
- * Тип возвращаемого значения для получения перевода: объект, если был запрошен список, или строка для одного ключа.
+ * Return type for translation retrieval: an object if a list was requested, or a string for a single key/
+ * Тип возвращаемого значения для получения перевода: объект, если был запрошен список, или строка для одного ключа
  */
 export declare type TranslateItemOrList<T extends TranslateCode> = T extends string[] ? TranslateList<T> : string;
 
 /**
- * Object with translated strings, where the keys are the names of the translation codes.
- * Объект с переведенными строками, где ключи — имена кодов переводов.
+ * Object with translated strings, where the keys are the names of the translation codes/
+ * Объект с переведенными строками, где ключи — имена кодов переводов
  */
 export declare type TranslateList<T extends TranslateCode[]> = {
     [K in T[number] as K extends readonly string[] ? K[0] : K]: string;