/**
 * Adds a tag to highlight the match in the string.
 *
 * Добавляет тег для выделения совпадения в строке.
 * @param value initial string / исходная строка
 * @param search search string or RegExp / строка поиска или регулярное выражение
 * @param className highlighting class / класс выделения
 * @param shouldEscape should escape the string / нужно ли экранировать строку
 * @returns string with highlighting / строка с выделением
 */
export declare function addTagHighlightMatch(value: string, search?: string | RegExp, className?: string, shouldEscape?: boolean): string;

/**
 * Conversion of a value to a string.
 *
 * Преобразование значения в строку.
 * @param value values for conversion / значения для преобразования
 * @param isArrayString if true, then arrays will be converted to strings / если true, то массивы будут преобразованы в строки
 * @param trim if true, then the resulting string will be trimmed / если true, то результирующая строка будет обрезана
 * @returns string representation of the passed value / строковое представление переданного значения
 */
export declare function anyToString<V>(value: V, isArrayString?: boolean, trim?: boolean): string;

/**
 * Class for working with HTTP requests.
 *
 * Класс для работы с HTTP-запросами.
 */
export declare class Api {
    /**
     * Checks if the server is running on localhost.
     *
     * Проверяет, работает ли сервер на localhost.
     * @returns true if server is localhost / true, если сервер является локальным
     */
    static isLocalhost(): boolean;
    /**
     * Returns the singleton instance of the ApiInstance class.
     *
     * Возвращает синглтон-экземпляр класса ApiInstance.
     * @returns ApiInstance singleton / синглтон ApiInstance
     */
    static getItem(): ApiInstance;
    /**
     * Returns the status of the last request.
     *
     * Возвращает статус последнего запроса.
     * @returns ApiStatus instance / экземпляр ApiStatus
     */
    static getStatus(): ApiStatus;
    /**
     * Gets the response handler.
     *
     * Получает обработчик ответа.
     * @returns ApiResponse instance / экземпляр ApiResponse
     */
    static getResponse(): ApiResponse;
    /**
     * Gets the hydration handler.
     *
     * Получает обработчик гидратации.
     * @returns ApiHydration instance / экземпляр ApiHydration
     */
    static getHydration(): ApiHydration;
    /**
     * Returns a string representation of the hydration data for the client.
     *
     * Возвращает строковое представление данных гидратации для клиента.
     * @returns HTML script element string / строка HTML элемента script
     */
    static getHydrationScript(): string;
    /**
     * Gets the base origin URL combined with the API path.
     *
     * Получает базовый URL источника, объединенный с путем API.
     * @returns final base URL string / итоговая строка базового URL
     */
    static getOrigin(): string;
    /**
     * Gets the full path to the request script.
     *
     * Получает полный путь к скрипту запроса.
     * @param path path to the script / путь к скрипту
     * @param api whether to prepend base API URL / нужно ли добавить базовый URL API
     * @returns full URL / полный URL
     */
    static getUrl(path: string, api?: boolean): string;
    /**
     * Gets data for the request body.
     *
     * Получает данные для тела запроса.
     * @param request request data / данные запроса
     * @param method HTTP method / HTTP метод
     * @returns body data for non-GET requests or FormData / данные тела для не-GET запросов или FormData
     */
    static getBody(request?: ApiFetch['request'], method?: ApiMethodItem): string | FormData | undefined;
    /**
     * Gets query string for GET method requests.
     *
     * Получает строку запроса для GET-методов.
     * @param request request data / данные запроса
     * @param path path to request / путь к запросу
     * @param method HTTP method / HTTP метод
     * @returns query string for GET requests / строка запроса для GET-запросов
     */
    static getBodyForGet(request: ApiFetch['request'], path?: string, method?: ApiMethodItem): string;
    /**
     * Modifies the default header data.
     *
     * Изменяет данные заголовка по умолчанию.
     * @param headers default headers / заголовки по умолчанию
     * @returns void / ничего не возвращает
     */
    static setHeaders(headers: ApiHeadersValue): void;
    /**
     * Modifies the default request data.
     *
     * Изменяет данные запроса по умолчанию.
     * @param request default request data / данные запроса по умолчанию
     * @returns void / ничего не возвращает
     */
    static setRequestDefault(request: ApiDefaultValue): void;
    /**
     * Changes the base path to the script.
     *
     * Изменяет базовый путь к скрипту.
     * @param url path to the script / путь к скрипту
     * @returns void / ничего не возвращает
     */
    static setUrl(url: string): void;
    /**
     * Modifies the function to be called before the request.
     *
     * Изменяет функцию для вызова перед запросом.
     * @param callback function to call before request / функция для вызова перед запросом
     * @returns void / ничего не возвращает
     */
    static setPreparation(callback: (apiFetch: ApiFetch) => Promise<void>): void;
    /**
     * Modifies the function to be called after the request.
     *
     * Изменяет функцию для вызова после запроса.
     * @param callback function to call after request / функция для вызова после запроса
     * @returns void / ничего не возвращает
     */
    static setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): void;
    /**
     * Changes the timeout for the request in milliseconds.
     *
     * Изменяет таймаут запроса в миллисекундах.
     * @param timeout timeout in milliseconds / таймаут в миллисекундах
     * @returns void / ничего не возвращает
     */
    static setTimeout(timeout: number): void;
    /**
     * Changes the origin (protocol and domain) for the base URL.
     *
     * Изменяет источник (протокол и домен) для базового URL.
     * @param origin protocol and domain / протокол и домен
     * @returns void / ничего не возвращает
     */
    static setOrigin(origin: string): void;
    /**
     * Sets the wrapper function for requests.
     *
     * Устанавливает функцию-обертку для запросов.
     * @param wrapper wrapper function / функция-обертка
     * @returns void / ничего не возвращает
     */
    static setWrapper(wrapper: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>): void;
    /**
     * Sets multiple API configuration options at once.
     *
     * Устанавливает несколько опций конфигурации API одновременно.
     * @param config configuration object / объект конфигурации
     * @returns void / ничего не возвращает
     */
    static setConfig(config?: ApiConfig): void;
    /**
     * Executes a request with the given path or configuration.
     *
     * Выполняет запрос с указанным путем или конфигурацией.
     * @param pathRequest path or configuration / путь или конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    static request<T>(pathRequest: string | ApiFetch): Promise<T>;
    /**
     * Sends a GET method request.
     *
     * Отправляет запрос метода GET.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    static get<T>(request: ApiFetch): Promise<T>;
    /**
     * Sends a POST method request.
     *
     * Отправляет запрос метода POST.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    static post<T>(request: ApiFetch): Promise<T>;
    /**
     * Sends a PUT method request.
     *
     * Отправляет запрос метода PUT.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    static put<T>(request: ApiFetch): Promise<T>;
    /**
     * Sends a PATCH method request.
     *
     * Отправляет запрос метода PATCH.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    static patch<T>(request: ApiFetch): Promise<T>;
    /**
     * Sends a DELETE method request.
     *
     * Отправляет запрос метода DELETE.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    static delete<T>(request: ApiFetch): Promise<T>;
}

/**
 * Class for caching API responses.
 *
 * Класс для кэширования ответов API.
 */
export declare class ApiCache {
    /** Cache storage / Кэш-хранилища */
    protected static items?: ApiCacheList;
    /** Storage mechanism for getting data / механизм хранения для получения данных */
    protected static getListener?: (key: string) => Promise<ApiCacheItem | undefined>;
    /** Storage mechanism for setting data / механизм хранения для сохранения данных */
    protected static setListener?: (key: string, value: ApiCacheItem) => Promise<boolean>;
    /** Storage mechanism for removing data / механизм хранения для удаления данных */
    protected static removeListener?: (key: string) => Promise<boolean>;
    /**
     * Number of data retrieval requests before starting the cleaning of old cache/
     * Количество запросов получения данных перед началом очистки старого кэша
     */
    protected static cacheStepAgeClearOld: number;
    /** Number of data retrieval requests before starting the cleaning of old cache / Количество запросов получения данных перед началом очистки старого кэша */
    protected static stepAgeClearOld: number;
    /**
     * Initializes the storage with listeners.
     *
     * Инициализирует хранилище слушателями.
     * @param getListener Storage mechanism for getting data / механизм хранения для получения данных
     * @param setListener Storage mechanism for setting data / механизм хранения для сохранения данных
     * @param removeListener Storage mechanism for removing data / механизм хранения для удаления данных
     * @param cacheStepAgeClearOld Number of data retrieval requests before starting the cleaning of old cache / количество запросов получения данных перед началом очистки старого кэша
     */
    static init(getListener: (key: string) => Promise<ApiCacheItem | undefined>, setListener: (key: string, value: ApiCacheItem) => Promise<boolean>, removeListener: (key: string) => Promise<boolean>, cacheStepAgeClearOld?: number): void;
    /**
     * Resets the cache by clearing all in-memory items and resetting listeners.
     *
     * Сбрасывает кэш, очищая все элементы в памяти и сбрасывая слушатели.
     * @returns void / ничего не возвращает
     */
    static reset(): void;
    /**
     * Gets data from cache.
     *
     * Получает данные из кэша.
     * @param key cache key / ключ кэша
     * @returns T | undefined / данные из кэша или undefined
     */
    static get<T>(key: string): Promise<T | undefined>;
    /**
     * Gets data from cache using fetch options.
     *
     * Получает данные из кэша с использованием опций fetch.
     * @param fetch fetch options / опции fetch
     * @returns T | undefined / данные из кэша или undefined
     */
    static getByFetch<T>(fetch: ApiFetch): Promise<T | undefined>;
    /**
     * Saves data to cache.
     *
     * Сохраняет данные в кэш.
     * @param key cache key / ключ кэша
     * @param value data to be stored / данные для хранения
     * @param age cache age in seconds / возраст кэша в секундах
     */
    static set<T>(key: string, value: T, age?: number): Promise<void>;
    /**
     * Saves data to cache using fetch options.
     *
     * Сохраняет данные в кэш с использованием опций fetch.
     * @param fetch fetch options / опции fetch
     * @param value data to be stored / данные для хранения
     * @returns Promise<void> / Promise без возвращаемого значения
     */
    static setByFetch<T>(fetch: ApiFetch, value: T): Promise<void>;
    /**
     * Removes data from cache.
     *
     * Удаляет данные из кэша.
     * @param key cache key / ключ кэша
     * @returns Promise<void> / Promise без возвращаемого значения
     */
    static remove(key: string): Promise<void>;
    /**
     * Checks if the cache is enabled.
     *
     * Проверяет, включен ли кэш.
     * @param fetch fetch options / опции fetch
     * @returns true if cache is enabled / true, если кэш включен
     */
    protected static isCache(fetch: ApiFetch): boolean;
    /**
     * Checks if cache item is still valid (not expired).
     *
     * Проверяет, действителен ли элемент кэша (не истек ли срок действия).
     * @param item cache item / элемент кэша
     */
    protected static isAge(item?: ApiCacheItem): boolean;
    /**
     * Checks if the key exists in the cache.
     *
     * Проверяет, существует ли ключ в кэше.
     * @param key cache key / ключ кэша
     * @returns true if key exists / true, если ключ существует
     */
    protected static isItem(key: string): boolean;
    /**
     * Generates cache key from fetch options.
     *
     * Генерирует ключ кэша из опций fetch.
     * @param fetch fetch options / опции fetch
     * @returns cache key string / строка ключа кэша (JSON.stringify)
     */
    protected static generateKey(fetch: ApiFetch): string;
    /**
     * Gets data from cache using listener.
     *
     * Получает данные из кэша с использованием слушателя.
     * @param key cache key / ключ кэша
     * @returns cache item or undefined / элемент кэша или undefined (если не существует или истек срок действия)
     */
    protected static getItemOrListener(key: string): Promise<ApiCacheItem | undefined>;
    /**
     * Gets list of cache items.
     *
     * Получает список элементов кэша.
     * @returns list of cache items / список элементов кэша
     */
    protected static getList(): ApiCacheList;
    /**
     * Saves data to cache using listener.
     *
     * Сохраняет данные в кэш с использованием слушателя.
     * @param key cache key / ключ кэша
     * @param value data to be stored / данные для хранения
     * @returns Promise<void> / ничего не возвращает
     */
    protected static setItemOrListener(key: string, value: ApiCacheItem): Promise<void>;
    /**
     * Removes data from cache using listener.
     *
     * Удаляет данные из кэша с использованием слушателя.
     * @param key cache key / ключ кэша
     * @returns Promise<void> / ничего не возвращает
     */
    protected static removeItemOrListener(key: string): Promise<void>;
    /**
     * Clears old in-memory cache data.
     *
     * Очищает старый кэш в памяти.
     * @returns Promise<void> / Promise без возвращаемого значения (удаляет устаревшие элементы из кэша)
     */
    protected static clearOld(): Promise<void>;
}

/**
 * Saved value in cache/ Сохраненное значение в кэше
 */
export declare type ApiCacheItem<T = any> = {
    /** Saved value / Сохраненное значение */
    value: T;
    /** Age of the cache / Возраст кэша */
    age?: number;
    /** Cache age in seconds / Возраст кэша в секундах */
    cacheAge: number;
};

/**
 * List of saved values in cache/ Список сохраненных значений в кэше
 */
export declare type ApiCacheList = Record<string, ApiCacheItem>;

/**
 * API configuration/ Конфигурация API
 */
export declare type ApiConfig = {
    /** Base URL for API requests/ Базовый URL для API-запросов */
    urlRoot?: string;
    /** Base origin for API requests (protocol and domain)/ Базовый источник для API-запросов (протокол и домен) */
    origin?: string;
    /** Default headers for API requests/ Заголовки по умолчанию для API-запросов */
    headers?: ApiHeadersValue;
    /** Default request data for API requests/ Данные запроса по умолчанию для API-запросов */
    requestDefault?: ApiDefaultValue;
    /** 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;
    /** Enable development logging/ Включить логирование разработки */
    devMode?: boolean;
    /** Wrapper function for requests / Функция-обертка для запросов */
    wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
};

/**
 * Shape of API response data wrapper/ Структура обёртки данных ответа API
 */
export declare type ApiData<T = any> = T extends any[] ? T : ApiDataItem<T>;

/**
 * Type of API response data item/ Тип элемента данных ответа API
 */
export declare type ApiDataItem<T = any> = T & ApiDataValidation & {
    /** Primary payload (optional)/ Основная полезная нагрузка (опционально) */
    data?: T;
    /** Success flag/ Флаг успешности */
    success?: boolean;
    /** Status object/ Объект статуса */
    statusObject?: ApiStatusItem;
    /** Error object/ Объект ошибки */
    errorObject?: ApiErrorItem;
};

/**
 * Class for handling and processing data returned from an API request.
 *
 * Класс для обработки и подготовки данных, полученных в результате запроса к API.
 */
export declare class ApiDataReturn<T = any> {
    protected readonly apiFetch: ApiFetch;
    protected readonly query: Response;
    protected readonly end: ApiPreparationEnd;
    protected readonly error?: ApiErrorItem | undefined;
    /**
     * Raw data received from the API/
     * Исходные данные, полученные от API
     */
    protected data?: ApiData<T>;
    /**
     * Processed data ready for use/
     * Обработанные данные, готовые к использованию
     */
    protected dataMod?: ApiData<T>;
    /**
     * Constructor for ApiDataReturn.
     *
     * Конструктор ApiDataReturn.
     * @param apiFetch API fetch configuration / конфигурация запроса API
     * @param query response object / объект ответа
     * @param end preparation end data / данные завершения подготовки
     * @param error error object / объект ошибки
     */
    constructor(apiFetch: ApiFetch, query: Response, end: ApiPreparationEnd, error?: ApiErrorItem | undefined);
    /**
     * Initializes the class by reading data from the response.
     *
     * Инициализирует класс, считывая данные из ответа.
     */
    init(): Promise<this>;
    /**
     * Returns processed data.
     *
     * Возвращает обработанные данные.
     */
    get(): ApiData<T>;
    /**
     * Returns processed data along with the status object.
     *
     * Возвращает обработанные данные вместе с объектом статуса.
     * @param status API status instance / экземпляр статуса API
     */
    getAndStatus(status: ApiStatus): ApiData<T>;
    /**
     * Returns raw data received from the API.
     *
     * Возвращает исходные данные, полученные от API.
     */
    getData(): ApiData<T> | undefined;
    /**
     * Reads and parses data from the response.
     *
     * Считывает и анализирует данные из ответа.
     */
    protected readData<T>(): Promise<ApiData<T>>;
    /**
     * Prepares and formats the raw data.
     *
     * Подготавливает и форматирует исходные данные.
     */
    protected initData(): ApiData<T>;
    /**
     * Initializes the result item and merges metadata (success, status, code, message) from raw data.
     *
     * Инициализирует результирующий объект и переносит метаданные (success, status, code, message) из исходных данных.
     * @param data raw response data / исходные данные ответа
     * @returns initialized data with metadata / инициализированные данные с метаданными
     */
    protected initItem(data: Record<string, any>): ApiData<T>;
}

/**
 * API response validation result/ Результат валидации ответа API
 */
export declare type ApiDataValidation = {
    /** Status/ Статус */
    status?: ApiStatusType;
    /** Code / Код */
    code?: string | number;
    /** Message/ Сообщение */
    message?: string;
    /** Error/ Ошибка */
    error?: {
        /** Code / Код */
        code?: string | number;
        /** Message/ Сообщение */
        message?: string;
    };
};

/**
 * Class for working with default API request data.
 *
 * Класс для работы с данными запроса API по умолчанию.
 */
export declare class ApiDefault {
    /** Default request data / Данные запроса по умолчанию */
    protected value?: ApiDefaultValue;
    /**
     * Checks if default request data exists.
     *
     * Проверяет, существуют ли данные запроса по умолчанию.
     * @returns true if default data exists / true, если данные по умолчанию существуют
     */
    is(): boolean;
    /**
     * Gets the default request data.
     *
     * Получает данные запроса по умолчанию.
     * @returns default request data or undefined / данные запроса по умолчанию или undefined
     */
    get(): Record<string, any> | undefined;
    /**
     * Adds default data to the request.
     *
     * Добавляет данные по умолчанию к запросу.
     * @param request request data / данные запроса
     * @returns merged request data / объединенные данные запроса
     */
    request(request: ApiFetch['request']): ApiFetch['request'];
    /**
     * Sets the default request data.
     *
     * Устанавливает данные запроса по умолчанию.
     * @param request default request data / данные запроса по умолчанию
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    set(request: ApiDefaultValue): this;
    /**
     * Adds default data to FormData request.
     *
     * Добавляет данные по умолчанию к запросу FormData.
     * @param request FormData request / запрос FormData
     * @param value default values / значения по умолчанию
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    protected addByFormData(request: FormData, value: ApiDefaultValue): this;
}

/**
 * Default API request data type/ Тип данных запроса API по умолчанию
 */
export declare type ApiDefaultValue = Record<string, any> | (() => Record<string, any>);

/**
 * Utility class for managing the API error storage and creating error items.
 * It provides a centralized way to access the error storage and wrap raw
 * responses into structured error items.
 *
 * Утилитарный класс для управления хранилищем ошибок API и создания элементов ошибок.
 * Обеспечивает централизованный способ доступа к хранилищу ошибок и оборачивания
 * сырых ответов в структурированные элементы ошибок.
 */
export declare class ApiError {
    /**
     * Retrieves the singleton instance of the API error storage.
     *
     * Возвращает синглтон-экземпляр хранилища ошибок API.
     * @returns error storage instance / экземпляр хранилища ошибок
     */
    static getStorage(): ApiErrorStorage;
    /**
     * Adds an error item or a list of error items to the storage.
     *
     * Добавляет элемент ошибки или список элементов ошибок в хранилище.
     * @param item error item or list of error items / элемент ошибки или список элементов ошибок
     * @param url URL pattern or RegExp / шаблон URL или регулярное выражение
     * @param method HTTP method of the request / HTTP-метод запроса
     */
    static add(item: Partial<ApiErrorStorageItem> | Partial<ApiErrorStorageItem>[], url?: string | RegExp, method?: ApiMethodItem): void;
    /**
     * Creates an ApiErrorItem by matching the response against stored error criteria.
     *
     * Создает ApiErrorItem путем сопоставления ответа с сохраненными критериями ошибок.
     * @param method HTTP method of the request / HTTP-метод запроса
     * @param response raw Fetch response / сырой ответ Fetch
     * @returns structured error item / структурированный элемент ошибки
     */
    static getItem(method: ApiMethodItem, response: Response): Promise<ApiErrorItem>;
}

/**
 * Class for managing and extracting data from an API error response.
 * It encapsulates the request method, raw response, and identified error criteria,
 * providing unified methods to retrieve error codes, messages, and status.
 *
 * Класс для управления и извлечения данных из ответа об ошибке API.
 * Инкапсулирует метод запроса, сырой ответ и идентифицированные критерии ошибки,
 * предоставляя единые методы для получения кодов ошибок, сообщений и статуса.
 */
export declare class ApiErrorItem {
    protected readonly method: ApiMethodItem;
    protected readonly response: Response;
    protected readonly error: ApiErrorStorageItem;
    /** Cached JSON response body / Кэшированное тело ответа JSON */
    protected jsonResponse: any | undefined;
    /**
     * Constructor for ApiErrorItem.
     *
     * Конструктор для ApiErrorItem.
     * @param method HTTP method used for the request / HTTP-метод, использованный для запроса
     * @param response raw Fetch response object / сырой объект ответа Fetch
     * @param error matched error item from storage (optional) / найденный элемент ошибки из хранилища (опционально)
     */
    constructor(method: ApiMethodItem, response: Response, error: ApiErrorStorageItem);
    /**
     * Returns the HTTP method used for the request.
     *
     * Возвращает HTTP-метод, использованный для запроса.
     * @returns HTTP method / HTTP-метод
     */
    getMethod(): ApiMethodItem;
    /**
     * Returns the raw Fetch response object.
     *
     * Возвращает сырой объект ответа Fetch.
     * @returns Fetch response / ответ Fetch
     */
    getResponse(): Response;
    /**
     * Returns the identified error item from storage if it exists.
     *
     * Возвращает идентифицированный элемент ошибки из хранилища, если он существует.
     * @returns error item or undefined / элемент ошибки или undefined
     */
    getError(): ApiErrorStorageItem;
    /**
     * Asynchronously retrieves the error code from storage or the response body.
     *
     * Асинхронно получает код ошибки из хранилища или тела ответа.
     * @returns error code or undefined / код ошибки или undefined
     */
    getCode(): string | undefined;
    /**
     * Asynchronously retrieves the error message.
     * Checks the identified error item, the response body, or falls back to status text.
     *
     * Асинхронно получает сообщение об ошибке.
     * Проверяет идентифицированный элемент ошибки, тело ответа или использует текст статуса.
     * @returns error message or undefined / сообщение об ошибке или undefined
     */
    getMessage(): string | undefined;
    /**
     * Returns the HTTP status code of the response.
     *
     * Возвращает код статуса HTTP ответа.
     * @returns status code / код статуса
     */
    getStatus(): number;
}

/**
 * Manager for handling and identifying API error states.
 *
 * This class provides a centralized storage for API error criteria. It allows the system
 * to identify specific errors by matching the response status, error code from the JSON body,
 * request method, and URL. It is used to transform raw network errors into structured
 * application-level error items for consistent processing.
 *
 * Менеджер для обработки и идентификации состояний ошибок API.
 *
 * Этот класс обеспечивает централизованное хранилище критериев ошибок API. Он позволяет
 * системе идентифицировать конкретные ошибки путем сопоставления статуса ответа,
 * кода ошибки из тела JSON, метода запроса и URL. Используется для преобразования
 * сырых сетевых ошибок в структурированные элементы ошибок прикладного уровня для
 * единообразной обработки.
 */
export declare class ApiErrorStorage {
    /** Error storage list / Список хранилища ошибок */
    protected storage: ApiErrorStorageList;
    /**
     * Finds a matching error item in the storage by analyzing the response.
     *
     * Ищет подходящий элемент ошибки в хранилище путем анализа ответа.
     * @param method API method / Метод API
     * @param response fetch response / Ответ fetch
     * @returns matched error item or undefined / найденный элемент ошибки или undefined
     */
    find(method: ApiMethodItem, response: Response): Promise<ApiErrorStorageItem>;
    /**
     * Adds one or more error items or lists to the internal storage.
     *
     * Добавляет один или несколько элементов или списков ошибок во внутреннее хранилище.
     * @param item error item or list of items / элемент ошибки или список элементов
     * @param url URL pattern or RegExp / шаблон URL или регулярное выражение
     * @param method HTTP method of the request / HTTP-метод запроса
     * @returns current instance / текущий экземпляр
     */
    add(item: Partial<ApiErrorStorageItem> | Partial<ApiErrorStorageItem>[], url?: string | RegExp, method?: ApiMethodItem): this;
    /**
     * Checks if the response matches the criteria of any stored error item.
     *
     * Проверяет, соответствует ли ответ критериям любого сохраненного элемента ошибки.
     * @param method API method / Метод API
     * @param response fetch response / Ответ fetch
     * @param code error code from response body / код ошибки из тела ответа
     * @returns matched error item or undefined if no match found / найденный элемент ошибки или undefined, если совпадений не найдено
     */
    protected findItem(method: ApiMethodItem, response: Response, code?: string): ApiErrorStorageItem | undefined;
    /**
     * Validates if the given URL matches the specified pattern.
     *
     * Проверяет, соответствует ли данный URL указанному шаблону.
     * @param url URL to check / URL для проверки
     * @param pattern URL pattern or RegExp / шаблон URL или регулярное выражение
     * @returns true if the URL matches the pattern / true, если URL соответствует шаблону
     */
    protected isUrl(url: string, pattern: string | RegExp): boolean;
    /**
     * Attempts to extract an error code from the response body in JSON format.
     *
     * Пытается извлечь код ошибки из тела ответа в формате JSON.
     * @param response fetch response / Ответ fetch
     * @returns extracted error code or undefined / извлеченный код ошибки или undefined
     */
    protected getBody(response: Response): Promise<any>;
    /**
     * Retrieves data from the response body by key.
     *
     * Получает данные из тела ответа по ключу.
     * @param body response body / тело ответа
     * @param key property key / ключ свойства
     * @returns extracted value or undefined / извлеченное значение или undefined
     */
    protected getDataByKey<R = string>(body: any, key: string): R | undefined;
    /**
     * Attempts to extract an error code from the response body in JSON format.
     *
     * Пытается извлечь код ошибки из тела ответа в формате JSON.
     * @param body response body / тело ответа
     * @returns extracted error code or undefined / извлеченный код ошибки или undefined
     */
    protected getCode(body: any): string | undefined;
    /**
     * Attempts to extract an error message from the response body in JSON format.
     *
     * Пытается извлечь сообщение об ошибке из тела ответа в формате JSON.
     * @param body response body / тело ответа
     * @returns extracted error message or undefined / извлеченное сообщение об ошибке или undefined
     */
    protected getMessage(body: any): string | undefined;
}

/**
 * Item for API error storage/ Элемент для хранилища ошибок API
 */
export declare type ApiErrorStorageItem = Record<string, any> & {
    /** URL string or RegExp to match request URL/ Строка URL или RegExp для сопоставления URL */
    url: string | RegExp;
    /** HTTP method/ HTTP метод */
    method: ApiMethodItem;
    /** Error code/ Код ошибки */
    code?: string;
    /** HTTP status code/ Код статуса HTTP */
    status?: number;
    /** Validation function/ Функция валидации */
    validation?: (response: Response) => boolean;
    /** Error message or function that returns message/ Сообщение об ошибке или функция, возвращающая сообщение */
    message?: string | ((response?: Response) => string);
};

/**
 * List of API error storage items/ Список элементов хранилища ошибок API
 */
export declare type ApiErrorStorageList = ApiErrorStorageItem[];

/**
 * Options for making API requests/ Опции для выполнения API-запросов
 */
export declare type ApiFetch = {
    /** Use base API URL/ Использовать базовый URL API */
    api?: boolean;
    /** Endpoint path relative to base URL/ Путь endpoint относительно базового URL */
    path?: string;
    /** Complete URL (overrides api + path)/ Полный URL (переопределяет api + path) */
    pathFull?: string;
    /** HTTP method/ HTTP метод */
    method?: ApiMethod;
    /** Request body data or query parameters/ Данные тела запроса или параметры запроса */
    request?: FormData | Record<string, any> | string;
    /** Include authentication headers/ Включить заголовки аутентификации */
    auth?: boolean;
    /** Custom headers (null = no headers)/ Пользовательские заголовки (null = без заголовков) */
    headers?: Record<string, string> | null;
    /** Content-Type header value/ Значение заголовка Content-Type */
    type?: string;
    /** Extract 'data' field from response/ Извлечь поле 'data' из ответа */
    toData?: boolean;
    /** Use global response cache/ Использовать глобальный кеш ответов */
    global?: boolean;
    /** Enable development logging/ Включить логирование разработки */
    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 | ApiDataValidation>;
    /** Run global preparation hooks/ Запускать глобальные хуки подготовки */
    globalPreparation?: boolean;
    /** Run global end hooks/ Запускать глобальные хуки завершения */
    globalEnd?: boolean;
    /** Additional fetch() options/ Дополнительные опции fetch() */
    init?: RequestInit;
    initError?: boolean;
    /** Timeout for the request in milliseconds/ Таймаут запроса в миллисекундах */
    timeout?: number;
    /** AbortController for canceling the request/ AbortController для отмены запроса */
    controller?: AbortController;
    /** Cache age in seconds/ Возраст кэша в секундах */
    cache?: number;
    enableClientCache?: boolean;
    /** Cache ID for grouping/ ID кэша для группировки */
    cacheId?: number | string;
    /** Limit of end reset/ Лимит сброса end */
    endResetLimit?: number;
    /** Wrapper function for requests / Функция-обертка для запросов */
    wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
};

/**
 * Class for managing HTTP request headers.
 *
 * Класс для управления заголовками HTTP-запросов.
 */
export declare class ApiHeaders {
    /** Default headers / Заголовки по умолчанию */
    protected headers: ApiHeadersValue;
    /**
     * Gets the headers for the request.
     *
     * Получает заголовки для запроса.
     * @param value list of headers / список заголовков
     * @param type Content-Type header value / значение заголовка Content-Type
     * @returns merged headers or undefined / объединенные заголовки или undefined
     */
    get(value?: Record<string, string> | null, type?: string | undefined | null): Record<string, string> | undefined;
    /**
     * Gets the headers for the request based on request type.
     *
     * Получает заголовки для запроса на основе типа запроса.
     * @param request request data / данные запроса
     * @param value list of headers / список заголовков
     * @param type Content-Type header value / значение заголовка Content-Type
     * @returns merged headers or undefined / объединенные заголовки или undefined
     */
    getByRequest(request: ApiFetch['request'], value?: Record<string, string> | null, type?: string): Record<string, string> | undefined;
    /**
     * Sets the default headers.
     *
     * Устанавливает заголовки по умолчанию.
     * @param headers list of default headers/ список заголовков по умолчанию
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    set(headers: ApiHeadersValue): this;
}

/**
 * Type for API request headers / Тип для заголовков запроса API
 */
export declare type ApiHeadersValue = Record<string, string> | (() => Record<string, string>);

/**
 * Class for collecting API data for hydration on the client side during SSR.
 *
 * Класс для сбора данных API для последующей гидратации на стороне клиента при SSR.
 */
export declare class ApiHydration {
    /** Hydration data list / Список данных гидратации */
    protected list: ApiHydrationList;
    /**
     * Initializes the response with hydration data.
     *
     * Инициализирует ответ данными гидратации.
     * @param response API response / ответ API
     * @returns void / ничего не возвращает
     */
    initResponse(response: ApiResponse): void;
    /**
     * Saves API response for client-side hydration.
     *
     * Сохраняет ответ API для гидратации на стороне клиента.
     * @param apiFetch API request configuration / конфигурация запроса API
     * @param response API response data / данные ответа API
     * @returns void / ничего не возвращает
     */
    toClient<T>(apiFetch: ApiFetch, response: T): void;
    /**
     * Returns a string representation of the hydration data for the client.
     *
     * Возвращает строковое представление данных гидратации для клиента.
     */
    toString(): string;
    /**
     * Returns the list of API responses for the client.
     *
     * Возвращает список ответов API для клиента.
     */
    protected getListByClient(): ApiHydrationList;
}

/**
 * Type of API hydration item/ Тип элемента гидратации API
 */
export declare type ApiHydrationItem = {
    /** Path string or RegExp to match request URL/ Путь или RegExp для сопоставления URL */
    path: string;
    /** Expected HTTP method/ Ожидаемый HTTP метод */
    method: ApiMethod;
    /** Expected request payload or special marker '*any'/ Ожидаемая нагрузка запроса или маркер '*any' */
    request?: ApiFetch['request'];
    /** Static response or factory function/ Статический ответ или функция, возвращающая ответ */
    response: any;
};

/**
 * List of API hydration items/ Список элементов гидратации API
 */
export declare type ApiHydrationList = ApiHydrationItem[];

/**
 * Core class for managing HTTP requests using the Fetch API.
 *
 * Основной класс для управления HTTP-запросами через Fetch API.
 */
export declare class ApiInstance {
    protected url: string;
    /** Geo class instance / Экземпляр класса Geo */
    protected geo: GeoInstance;
    /** Headers / Заголовки */
    protected headers: ApiHeaders;
    /** Default request parameters / Параметры запроса по умолчанию */
    protected requestDefault: ApiDefault;
    /** Status of the last request / Статус последнего запроса */
    protected status: ApiStatus;
    /** Response handler / Обработчик ответа */
    protected response: ApiResponse;
    /** Request modification handler / Обработчик модификации запроса */
    protected preparation: ApiPreparation;
    /** Loading handler / Обработчик загрузки */
    protected loading: LoadingInstance;
    /** Error handler / Обработчик ошибок */
    protected errorCenter: ErrorCenterInstance;
    /** Hydration handler / Обработчик гидратации */
    protected hydration: ApiHydration;
    /** Timeout for the request in milliseconds / Таймаут запроса в миллисекундах */
    protected timeout: number;
    /** Base URL origin / Базовый origin URL */
    protected origin?: string;
    /** Wrapper function for requests / Функция-обертка для запросов */
    protected wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
    /**
     * Constructor
     * @param url base path to the script / базовый путь к скрипту
     * @param options options for the API instance / опции для экземпляра API
     */
    constructor(url?: string, options?: ApiInstanceOptions);
    /**
     * Checks if the server is running on localhost.
     *
     * Проверяет, работает ли сервер на localhost.
     * @returns true if server is localhost / true, если сервер является локальным
     */
    isLocalhost(): boolean;
    /**
     * Returns the status of the last request.
     *
     * Возвращает статус последнего запроса.
     * @returns ApiStatus instance / экземпляр ApiStatus
     */
    getStatus(): ApiStatus;
    /**
     * Gets the response handler.
     *
     * Получает обработчик ответа.
     * @returns ApiResponse instance / экземпляр ApiResponse
     */
    getResponse(): ApiResponse;
    /**
     * Gets the hydration handler.
     *
     * Получает обработчик гидратации.
     * @returns ApiHydration instance / экземпляр ApiHydration
     */
    getHydration(): ApiHydration;
    /**
     * Gets the base origin URL combined with the API path.
     *
     * Получает базовый URL источника, объединенный с путем API.
     * @returns final base URL string / итоговая строка базового URL
     */
    getOrigin(): string;
    /**
     * Gets the full path to the request script.
     *
     * Получает полный путь к скрипту запроса.
     * @param path path to the script / путь к скрипту
     * @param api whether to prepend base API URL / нужно ли добавить базовый URL API
     * @returns full URL / полный URL
     */
    getUrl(path: string, api?: boolean): string;
    /**
     * Gets data for the request body.
     *
     * Получает данные для тела запроса.
     * @param request request data / данные запроса
     * @param method HTTP method / HTTP метод
     * @returns body data for non-GET requests or FormData / данные тела для не-GET запросов или FormData
     */
    getBody(request?: ApiFetch['request'], method?: ApiMethod): string | FormData | undefined;
    /**
     * Gets query string for GET method requests.
     *
     * Получает строку запроса для GET-методов.
     * @param request request data / данные запроса
     * @param path path to request / путь к запросу
     * @param method HTTP method / HTTP метод
     * @returns query string with prefix (? or &) / строка запроса с префиксом (? или &)
     */
    getBodyForGet(request: ApiFetch['request'], path?: string, method?: ApiMethod): string;
    /**
     * Returns a string representation of the hydration data for the client.
     *
     * Возвращает строковое представление данных гидратации для клиента.
     * @returns HTML script element string / строка HTML элемента script
     */
    getHydrationScript(): string;
    /**
     * Modifies the default header data.
     *
     * Изменяет данные заголовка по умолчанию.
     * @param headers default headers / заголовки по умолчанию
     */
    setHeaders(headers: ApiHeadersValue): this;
    /**
     * Modifies the default request data.
     *
     * Изменяет данные запроса по умолчанию.
     * @param request default request data / данные запроса по умолчанию
     */
    setRequestDefault(request: ApiDefaultValue): this;
    /**
     * Changes the base path to the script.
     *
     * Изменяет базовый путь к скрипту.
     * @param url path to the script / путь к скрипту
     */
    setUrl(url: string): this;
    /**
     * Modifies the function to be called before the request.
     *
     * Изменяет функцию для вызова перед запросом.
     * @param callback function to call before request / функция для вызова перед запросом
     */
    setPreparation(callback: (apiFetch: ApiFetch) => Promise<void>): this;
    /**
     * Modifies the function to be called after the request.
     *
     * Изменяет функцию для вызова после запроса.
     * @param callback function to call after request / функция для вызова после запроса
     */
    setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): this;
    /**
     * Changes the timeout for the request in milliseconds.
     *
     * Изменяет таймаут запроса в миллисекундах.
     * @param timeout timeout in milliseconds / таймаут в миллисекундах
     */
    setTimeout(timeout: number): this;
    /**
     * Changes the origin (protocol and domain) for the base URL.
     *
     * Изменяет источник (протокол и домен) для базового URL.
     * @param origin protocol and domain / протокол и домен
     */
    setOrigin(origin: string): this;
    /**
     * Sets the wrapper function for requests.
     *
     * Устанавливает функцию-обертку для запросов.
     * @param wrapper wrapper function / функция-обертка
     */
    setWrapper(wrapper: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>): this;
    /**
     * Executes a request with the given path or configuration.
     *
     * Выполняет запрос с указанным путем или конфигурацией.
     * @param pathRequest path or configuration / путь или конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    request<T>(pathRequest: string | ApiFetch): Promise<T>;
    /**
     * Sends a GET method request.
     *
     * Отправляет запрос метода GET.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    get<T>(request: ApiFetch): Promise<T>;
    /**
     * Sends a POST method request.
     *
     * Отправляет запрос метода POST.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    post<T>(request: ApiFetch): Promise<T>;
    /**
     * Sends a PUT method request.
     *
     * Отправляет запрос метода PUT.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    put<T>(request: ApiFetch): Promise<T>;
    /**
     * Sends a PATCH method request.
     *
     * Отправляет запрос метода PATCH.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    patch<T>(request: ApiFetch): Promise<T>;
    /**
     * Sends a DELETE method request.
     *
     * Отправляет запрос метода DELETE.
     * @param request fetch configuration / конфигурация запроса
     * @returns Promise with response data / Promise с данными ответа
     */
    delete<T>(request: ApiFetch): Promise<T>;
    /**
     * Gets retry delay with jitter.
     *
     * Получает задержку повтора с джиттером.
     * @param retryCount count of retries / количество повторов
     * @param retryDelay base delay between retries / базовая задержка между повторами
     * @returns delay in milliseconds / задержка в миллисекундах
     */
    protected getRetryDelay(retryCount: number, retryDelay: number): number;
    /**
     * Execute API request with retry support.
     *
     * Выполнить запрос API с поддержкой повторов.
     * @param apiFetch fetch configuration / конфигурация запроса
     * @param retryCount current retry count / текущий счетчик повторов
     */
    protected fetch<T>(apiFetch: ApiFetch, retryCount?: number): Promise<T>;
    /**
     * Executing the HTTP request.
     *
     * Выполнение HTTP-запроса.
     * @param apiFetch fetch configuration / конфигурация запроса
     * @param pathToApi base path to API / базовый путь к API
     * @returns object containing response and optional timeout ID / объект, содержащий ответ и опциональный ID таймера
     */
    protected makeQuery(apiFetch: ApiFetch, pathToApi: string): Promise<{
        query: Response;
        timeoutId: any;
    }>;
    /**
     * Processing an error.
     *
     * Обработка ошибки.
     * @param error error object / объект ошибки
     * @param group error group for error center (default: 'api') / группа ошибки для центра ошибок (по умолчанию: 'api')
     */
    protected makeError(error: Record<string, any> & {
        name: string;
    }, group?: string): void;
    /**
     * Processes an error response.
     *
     * Обрабатывает ошибку ответа.
     * @param error error details / данные ошибки
     */
    protected makeErrorQuery(error: ApiErrorItem | Response): void;
    /**
     * Initialize controller for request with timeout support.
     *
     * Инициализация контроллера для запроса с поддержкой таймаута.
     * @param apiFetch request options / опции запроса
     * @param fetchInit request initialization object / объект инициализации запроса
     * @returns timeout ID (from setTimeout) or undefined / ID таймера (от setTimeout) или undefined
     */
    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;
    /** Class for working with hydration / Класс для работы с гидратацией */
    hydrationClass?: typeof ApiHydration;
    /** Wrapper function for requests / Функция-обертка для запросов */
    wrapper?: <R>(callback: () => Promise<R>, apiFetch: ApiFetch) => Promise<R>;
};

/**
 * Supported HTTP methods type/ Тип HTTP-методов
 * (derived from ApiMethodItem enum)/ (получен из перечисления ApiMethodItem)
 */
export declare type ApiMethod = string | ApiMethodItem;

/**
 * Supported HTTP methods for API requests.
 * Поддерживаемые HTTP-методы для API-запросов.
 */
export declare enum ApiMethodItem {
    /**
     * HTTP DELETE — used to delete resources.
     * HTTP DELETE — используется для удаления ресурсов.
     */
    delete = "DELETE",
    /**
     * HTTP GET — used to retrieve resources (no request body).
     * HTTP GET — используется для получения ресурсов (без тела запроса).
     */
    get = "GET",
    /**
     * HTTP POST — used to create resources or send data.
     * HTTP POST — используется для создания ресурсов или отправки данных.
     */
    post = "POST",
    /**
     * HTTP PUT — used to update/replace resources.
     * HTTP PUT — используется для обновления/замены ресурсов.
     */
    put = "PUT",
    /**
     * HTTP PATCH — used to partially update resources.
     * HTTP PATCH — используется для частичного обновления ресурсов.
     */
    patch = "PATCH"
}

/**
 * Class for preparing requests.
 *
 * Класс для подготовки запросов.
 */
export declare class ApiPreparation {
    /** Function for call before the request / Функция для вызова перед запросом */
    protected callback?: (apiFetch: ApiFetch) => Promise<void>;
    /** Function for call after the request / Функция для вызова после запроса */
    protected callbackEnd?: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>;
    /** Is the preparation in progress / Идет ли подготовка */
    protected loading: boolean;
    /**
     * Executes preparation before the request.
     *
     * Выполняет подготовку перед выполнением запроса.
     * @param active is preparation active / активна ли подготовка
     * @param apiFetch request options / опции запроса
     * @returns Promise<void> / Promise без возвращаемого значения
     */
    make(active: boolean, apiFetch: ApiFetch): Promise<void>;
    /**
     * Analyzes the request after execution.
     *
     * Анализирует запрос после выполнения.
     * @param active is preparation active / активна ли подготовка
     * @param query data received in the request / данные, полученные в запросе
     * @param apiFetch request options / опции запроса
     * @returns preparation end data / данные завершения подготовки
     */
    makeEnd(active: boolean, query: Response, apiFetch: ApiFetch): Promise<ApiPreparationEnd>;
    /**
     * Modifies the function to be called before the request.
     *
     * Изменяет функцию для вызова перед запросом.
     * @param callback function to call before request / функция для вызова перед запросом
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    set(callback: (apiFetch: ApiFetch) => Promise<void>): this;
    /**
     * Modifies the function to be called after the request.
     *
     * Изменяет функцию для вызова после запроса.
     * @param callback function to call after request / функция для вызова после запроса
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): this;
    /**
     * To execute preparation.
     *
     * Выполнить подготовку.
     * @param apiFetch request options / опции запроса
     * @param limit limit of retry attempts / лимит попыток повтора
     * @returns Promise<void> / Promise без возвращаемого значения
     */
    protected go(apiFetch: ApiFetch, limit?: number): Promise<void>;
}

/**
 * Result of global preparation/end hooks/ Результат глобальных хуков
 */
export declare type ApiPreparationEnd = {
    /** Reset flag to indicate state reset/ Флаг сброса состояния */
    reset?: boolean;
    /** Arbitrary data returned by hook/ Произвольные данные, возвращаемые хуком */
    data?: any;
};

/**
 * Class for working with API responses.
 *
 * Класс для работы с ответами API.
 */
export declare class ApiResponse {
    protected readonly requestDefault: ApiDefault;
    /** List of first-time API requests / Список первичных API запросов */
    protected readonly first: ApiResponseItem[];
    /** Cached responses / Кешированные ответы */
    protected readonly response: ApiResponseItem[];
    /** Loading instance / Экземпляр загрузки */
    protected loading?: any;
    /** Developer mode flag / Флаг режима разработчика */
    protected devMode: boolean;
    /**
     * Constructor
     * @param requestDefault default request class/ класс запросов по умолчанию
     */
    constructor(requestDefault: ApiDefault);
    /**
     * Checks if there is a global cached request, if there is, returns it.
     *
     * Проверяет, есть ли глобальный кешированный запрос, если есть, возвращает его.
     * @param path link to the request / ссылка на запрос
     * @param method request method / метод запроса
     * @param request data for the request / данные для запроса
     * @param devMode optional developer mode flag / необязательный флаг режима разработчика
     * @returns cached response item or undefined / кешированный элемент ответа или undefined
     */
    get(path: string | undefined, method: ApiMethod, request?: ApiFetch['request'], devMode?: boolean): ApiResponseItem | undefined;
    /**
     * Returns a list of cached API responses (excluding global responses).
     *
     * Возвращает список кешированных ответов API (исключая глобальные ответы).
     */
    getList(): (ApiResponseItem & Record<string, any>)[];
    /**
     * Adds cached requests.
     *
     * Добавляет кешированные запросы.
     * @param response data for caching / данные для кеширования
     */
    add(response: ApiResponseItem | ApiResponseItem[]): this;
    /**
     * Sets developer mode.
     *
     * Устанавливает режим разработчика.
     * @param devMode is it developer mode / является ли режим разработчика
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    setDevMode(devMode: boolean): this;
    /**
     * Executes the emulator if available.
     *
     * Выполняет эмулятор, если доступно.
     * @param apiFetch fetch configuration / конфигурация запроса
     * @returns emulated response or undefined / эмулированный ответ или undefined
     */
    emulator<T>(apiFetch: ApiFetch): Promise<T | undefined>;
    /**
     * Executes the emulator synchronously if available.
     *
     * Выполняет эмулятор синхронно, если доступно.
     * @param apiFetch fetch configuration / конфигурация запроса
     * @returns emulated response or undefined / эмулированный ответ или undefined
     */
    emulatorAsync<T>(apiFetch: ApiFetch): T | undefined;
    /**
     * Checks if the cached item is disabled.
     *
     * Проверяет, отключен ли кешированный элемент.
     * @param item cached item / кешированный элемент
     * @returns true if item is disabled / true, если элемент отключен
     */
    protected isDisable(item: ApiResponseItem): boolean;
    /**
     * Checks if the path matches the cached one.
     *
     * Проверяет, совпадает ли путь с кешированным.
     * @param item cached item / кешированный элемент
     * @param path request path / путь запроса
     * @returns true if paths match / true, если пути совпадают
     */
    protected isPath(item: ApiResponseItem, path: string): boolean;
    /**
     * Checks if it is developer mode.
     *
     * Проверяет, является ли режимом разработчика.
     * @param devMode is it developer mode / является ли режим разработчика
     * @returns true if in dev mode / true, если в режиме разработчика
     */
    protected isDevMode(devMode?: boolean): boolean;
    /**
     * Checks if this is the first request.
     *
     * Проверяет, является ли это первым запросом.
     * @param item cached item / кешированный элемент
     * @param devMode is it developer mode / является ли режим разработчика
     * @returns true if this is the first request / true, если это первый запрос
     */
    protected isFirst(item: ApiResponseItem, devMode?: boolean): boolean;
    /**
     * Checks if the request matches the cached one.
     *
     * Проверяет, совпадает ли запрос с кешированным.
     * @param item cached item / кешированный элемент
     * @param request request data / данные запроса
     * @returns true if requests match / true, если запросы совпадают
     */
    protected isResponse(item: ApiResponseItem, request?: ApiFetch['request']): boolean;
    /**
     * Reads cached data configuration.
     *
     * Считывает конфигурацию кешированных данных.
     * @param apiFetch fetch configuration / конфигурация запроса
     * @returns object with response and request data or undefined / объект с данными ответа и запроса или undefined
     */
    protected readData(apiFetch: ApiFetch): {
        response: ApiResponseItem;
        request: string | Record<string, any> | FormData | undefined;
    } | undefined;
    /**
     * Emulates an execution request (internal fetch).
     *
     * Эмулирует запрос выполнения (внутренний fetch).
     * @param response response item for emulation / элемент ответа для эмуляции
     * @param request data for the request / данные для запроса
     * @returns Promise with emulated response data / Promise с эмулированными данными ответа
     */
    protected fetch<T>(response: ApiResponseItem, request?: ApiFetch['request']): Promise<T>;
    /**
     * Emulates an execution request synchronously (internal fetch).
     *
     * Эмулирует запрос выполнения синхронно (внутренний fetch).
     * @param response response item for emulation / элемент ответа для эмуляции
     * @returns emulated response data / эмулированные данные ответа
     */
    protected fetchAsync<T>(response: ApiResponseItem): T;
    /**
     * Enables loading for request emulation.
     *
     * Включает загрузку для эмуляции запроса.
     */
    protected startResponseLoading(): void;
    /**
     * Disables loading for request emulation.
     *
     * Отключает загрузку для эмуляции запроса.
     */
    protected stopResponseLoading(): void;
}

/**
 * Mock API response descriptor/ Описание мок-ответа API
 */
export declare type ApiResponseItem = {
    /** Path string or RegExp to match request URL/ Путь или RegExp для сопоставления URL */
    path: string | RegExp;
    /** Expected HTTP method/ Ожидаемый HTTP метод */
    method: ApiMethod;
    /** Expected request payload or special marker '*any'/ Ожидаемая нагрузка запроса или маркер '*any' */
    request?: ApiFetch['request'] | '*any';
    /** Static response or factory function/ Статический ответ или функция, возвращающая ответ */
    response: any | ((request?: ApiFetch['request']) => any);
    /** Disable this mock/ Отключить этот мок */
    disable?: any;
    /** Mark as global mock/ Мок для глобального использования */
    isForGlobal?: boolean;
    /** Simulate network lag/ Имитировать задержку */
    lag?: any;
};

/**
 * Class for managing API request status.
 *
 * Класс для управления статусом запросов API.
 */
export declare class ApiStatus {
    /** API status item data / Данные элемента статуса API */
    protected value?: ApiStatusItem;
    /**
     * Returns the last status item data.
     *
     * Возвращает данные последнего элемента статуса.
     * @returns status item or undefined / элемент статуса или undefined
     */
    get(): ApiStatusItem | undefined;
    /**
     * Returns the execution status code.
     *
     * Возвращает код статуса выполнения.
     * @returns HTTP status code or undefined / код статуса HTTP или undefined
     */
    getStatus(): number | undefined;
    /**
     * Returns the execution status text.
     *
     * Возвращает текст статуса выполнения.
     * @returns status text or undefined / текст статуса или undefined
     */
    getStatusText(): string | undefined;
    /**
     * Returns the last status type.
     *
     * Возвращает последний тип статуса.
     * @returns status type or undefined / тип статуса или undefined
     */
    getStatusType(): ApiStatusType | undefined;
    /**
     * Returns the execution status code (string or number from response).
     *
     * Возвращает код статуса выполнения (строка или число из ответа).
     * @returns status code or undefined / код статуса или undefined
     */
    getCode(): string | undefined;
    /**
     * Returns the script execution error.
     *
     * Возвращает ошибку выполнения скрипта.
     * @returns error message or undefined / сообщение об ошибке или undefined
     */
    getError(): string | undefined;
    /**
     * Returns the data of the last request.
     *
     * Возвращает данные последнего запроса.
     * @returns last response data or undefined / данные последнего ответа или undefined
     */
    getResponse<T>(): T | undefined;
    /**
     * Returns messages from the last request.
     *
     * Возвращает сообщения от последнего запроса.
     * @returns message string / строка сообщения
     */
    getMessage(): string;
    /**
     * Sets the status item data.
     *
     * Устанавливает данные элемента статуса.
     * @param data status item data/ данные элемента статуса
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    set(data: ApiStatusItem): this;
    /**
     * Sets the status code and optional status text.
     *
     * Устанавливает код статуса и необязательный текст статуса.
     * @param status status code / код статуса
     * @param statusText optional status text / необязательный текст статуса
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    setStatus(status?: number, statusText?: string): this;
    /**
     * Sets the error message.
     *
     * Устанавливает сообщение об ошибке.
     * @param error error message/ сообщение об ошибке
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    setError(error?: string): this;
    /**
     * Sets the data of the last response and automatically extracts status/message if it's an object.
     *
     * Устанавливает данные последнего ответа и автоматически извлекает статус / сообщение, если это объект.
     * @param response response data / данные ответа
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    setLastResponse(response?: any): this;
    /**
     * Sets the last status.
     *
     * Устанавливает последний статус.
     * @param status status/ статус
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    setLastStatus(status?: ApiStatusType): this;
    /**
     * Sets the last execution code.
     *
     * Устанавливает последний код выполнения.
     * @param code status code / код статуса
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    setLastCode(code?: string): this;
    /**
     * Sets messages from the last request.
     *
     * Устанавливает сообщения от последнего запроса.
     * @param message message text/ текст сообщения
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    setLastMessage(message?: string): this;
    /**
     * Sets a specific field in the status item.
     *
     * Устанавливает конкретное поле в элементе статуса.
     * @param name field name/ название поля
     * @param value field value/ значение поля
     */
    protected setValue<K extends keyof ApiStatusItem>(name: K, value?: ApiStatusItem[K]): void;
}

export declare type ApiStatusItem = {
    /** HTTP status code/ Код статуса HTTP */
    status?: number;
    /** HTTP status text/ Текст статуса HTTP */
    statusText?: string;
    /** Error message/ Сообщение об ошибке */
    error?: string;
    /** Last response/ Последний ответ */
    lastResponse?: any;
    /** Last status/ Последний статус */
    lastStatus?: ApiStatusType;
    /** Last code / Последний код */
    lastCode?: string;
    /** Last message/ Последнее сообщение */
    lastMessage?: string;
};

/** API status type/ Тип статуса API */
export declare type ApiStatusType = 'success' | 'error' | 'warning' | 'info';

/**
 * Applies a template to the text, replacing keys with values from the replacement object
 *
 * Применяет шаблон к тексту, заменяя ключи на значения из объекта замены
 * @param text text with a template containing keys in square or curly brackets, for example "[key]" or "{key}"/
 * текст с шаблоном, содержащим ключи в квадратных или фигурных скобках, например "[key]" или "{key}"
 * @param replacement an object containing key-value pairs for replacement/
 * объект, содержащий пары ключ-значение для замены
 */
export declare const applyTemplate: (text: string, replacement?: Record<string, string | number | boolean> | string[]) => string;

/**
 * Converts an array type to an item type (extracts the item type from an array)/
 * Преобразует тип массива в тип элемента (извлекает тип элемента из массива)
 */
export declare type ArrayToItem<T> = T extends any[] ? T[number] : T;

/**
 * The method creates an array of "count" elements with values equal to `value`.
 *
 * Метод создает массив из "count" элементов со значениями равными `value`.
 * @param value value to fill the array with / значение, заполняющее массив
 * @param count the number of elements in that array / число элементов этого массива
 * @returns created array / созданный массив
 */
export declare function arrFill<T>(value: T, count: number): T[];

/**
 * Convert a Blob to a Base64 string.
 *
 * Преобразует Blob в строку Base64.
 * @param blob The Blob to convert / Blob для преобразования
 * @param clean if true, removes the data URL prefix / если true, удаляет префикс data URL
 * @returns promise with the base64 string or undefined / промис со строкой base64 или undefined
 */
export declare function blobToBase64(blob: Blob, clean?: boolean): Promise<string | undefined>;

/**
 * Class for working with BroadcastChannel messages.
 *
 * Класс для работы с сообщениями BroadcastChannel.
 */
export declare class BroadcastMessage<Message = any> {
    protected callback?: ((event: MessageEvent<Message>) => void) | undefined;
    protected callbackError?: ((event: MessageEvent<Message>) => void) | undefined;
    /** BroadcastChannel instance / Экземпляр BroadcastChannel */
    protected channel?: BroadcastChannel;
    /**
     * Constructor that initializes the broadcast channel with event handlers.
     *
     * Конструктор, инициализирующий канал вещания с обработчиками событий.
     * @param name unique identifier for the broadcast channel / уникальный идентификатор для канала вещания
     * @param callback function called when a message is received / функция, вызываемая при получении сообщения
     * @param callbackError function called when a message error occurs / функция, вызываемая при возникновении ошибки сообщения
     * @param errorCenter ErrorCenter instance for error reporting / экземпляр ErrorCenter для отчета об ошибках
     */
    constructor(name: string, callback?: ((event: MessageEvent<Message>) => void) | undefined, callbackError?: ((event: MessageEvent<Message>) => void) | undefined, errorCenter?: ErrorCenterInstance);
    /**
     * Gets the BroadcastChannel instance if available.
     *
     * Получает экземпляр BroadcastChannel, если он доступен.
     * @returns BroadcastChannel instance or undefined if not in DOM runtime / экземпляр BroadcastChannel или undefined, если не в среде DOM
     */
    getChannel(): BroadcastChannel | undefined;
    /**
     * Sends a message through the broadcast channel.
     *
     * Отправляет сообщение через канал вещания.
     * @param message message data to send / данные сообщения для отправки
     * @returns this instance for chaining / этот экземпляр для цепочки вызовов
     */
    post(message: Message): this;
    /**
     * Sets the callback function to be executed when a message is received.
     *
     * Устанавливает функцию обратного вызова, выполняемую при получении сообщения.
     * @param callback function to execute on message received / функция для выполнения при получении сообщения
     * @returns this instance for chaining / этот экземпляр для цепочки вызовов
     */
    setCallback(callback: (event: MessageEvent<Message>) => void): this;
    /**
     * Sets the error callback function to be executed when a message error occurs.
     *
     * Устанавливает функцию обратного вызова для обработки ошибок сообщений.
     * @param callbackError function to execute on message error / функция для выполнения при ошибке сообщения
     * @returns this instance for chaining / этот экземпляр для цепочки вызовов
     */
    setCallbackError(callbackError: (event: MessageEvent<Message>) => void): this;
    /**
     * Closes the broadcast channel and stops listening for messages.
     *
     * Закрывает канал вещания и прекращает прослушивание сообщений.
     * @returns this instance for chaining / этот экземпляр для цепочки вызовов
     */
    destroy(): this;
    /**
     * Updates state when a message is received.
     *
     * Обновляет состояние при получении сообщения.
     * @param event message event object / объект события сообщения
     * @returns this instance for chaining / этот экземпляр для цепочки вызовов
     */
    protected readonly update: (event: MessageEvent<Message>) => this;
    /**
     * Updates error state when a message error occurs.
     *
     * Обновляет состояние ошибки при возникновении ошибки сообщения.
     * @param event message error event object / объект события ошибки сообщения
     * @returns this instance for chaining / этот экземпляр для цепочки вызовов
     */
    protected readonly updateError: (event: MessageEvent<Message>) => this;
}

/**
 * Simple in-memory cache class that stores computed values by key.
 *
 * Простой класс для in-memory кэширования, который хранит вычисленные значения по ключу.
 * @deprecated This class is obsolete and should not be used / Этот класс устарел и не рекомендуется к использованию
 */
declare class Cache_2 {
    /** Map of cached items / Карта кэшированных элементов */
    private cache;
    /**
     * Returns a cached value for the given name. If not cached, executes the callback and stores the result.
     *
     * Возвращает кэшированное значение для указанного имени. Если нет кэша, выполняет callback и сохраняет результат.
     * @param name Unique cache key / Уникальный ключ кэша
     * @param callback Function to compute the value if not cached / Функция для вычисления значения, если его нет в кэше
     * @param comparison Optional array for cache invalidation. If provided, the cache is invalidated when any element changes / Опциональный массив для инвалидации кэша. Если предоставлен, кэш сбрасывается при изменении любого элемента
     * @returns The cached or newly computed value / Кэшированное или новое вычисленное значение
     */
    get<T>(name: string, callback: () => T, comparison?: any[]): T;
    /**
     * Asynchronously returns a cached value for the given name. If not cached, executes the callback and stores the result.
     *
     * Асинхронно возвращает кэшированное значение для указанного имени. Если нет кэша, выполняет callback и сохраняет результат.
     * @param name Unique cache key / Уникальный ключ кэша
     * @param callback Async function to compute the value if not cached / Асинхронная или синхронная функция для вычисления значения, если его нет в кэше
     * @param comparison Optional array for cache invalidation. If provided, the cache is invalidated when any element changes / Опциональный массив для инвалидации кэша. Если предоставлен, кэш сбрасывается при изменении любого элемента
     * @returns Promise resolving to the cached or newly computed value / Promise, разрешающийся в кэшированное или новое вычисленное значение
     */
    getAsync<T>(name: string, callback: () => T, comparison?: any[]): Promise<T>;
    /**
     * Gets or creates a CacheItem instance for the given name.
     *
     * Получает или создает экземпляр CacheItem для указанного имени.
     * @param name - Unique cache key / Уникальный ключ кэша
     * @param callback - Function to compute the value / Функция для вычисления значения
     * @returns CacheItem instance for the cache key / Экземпляр CacheItem для ключа кэша
     */
    private getCacheItem;
}
export { Cache_2 as Cache }

/**
 * Class for managing a single cached value with dependency tracking.
 *
 * Класс для управления одним кэшированным значением с отслеживанием зависимостей.
 * @deprecated This class is obsolete and should not be used / Этот класс устарел и не рекомендуется к использованию
 */
export declare class CacheItem<T> {
    private readonly callback;
    /** Cached value / Кэшированное значение */
    private cache?;
    /** Previous cached value / Предыдущее кэшированное значение */
    private cacheOld?;
    /** Dependency comparison array / Массив сравнения зависимостей */
    private comparisons;
    /**
     * Creates a new CacheItem instance.
     *
     * Создает новый экземпляр CacheItem.
     * @param callback - Function to compute the cached value / Функция для вычисления кэшированного значения
     */
    constructor(callback: () => T);
    /**
     * Returns the cached value. Recomputes if the comparison array has changed.
     *
     * Возвращает кэшированное значение. Пересчитывает, если массив comparison изменился.
     * @param comparison - Array of values to track for cache invalidation / Массив значений для отслеживания инвалидации кэша
     * @returns The cached or newly computed value / Кэшированное или новое вычисленное значение
     */
    getCache(comparison: any[]): T;
    /**
     * Returns the previous cached value before the last recalculation.
     *
     * Возвращает предыдущее кэшированное значение до последнего пересчета.
     * @returns The previous cached value, or undefined if no recalculation has occurred / Предыдущее кэшированное значение, или undefined если пересчет не происходил
     */
    getCacheOld(): T | undefined;
    /**
     * Asynchronously returns the cached value. Recomputes if the comparison array has changed.
     *
     * Асинхронно возвращает кэшированное значение. Пересчитывает, если массив comparison изменился.
     * @param comparison - Array of values to track for cache invalidation / Массив значений для отслеживания инвалидации кэша
     * @returns Promise resolving to the cached or newly computed value / Promise, разрешающийся в кэшированное или новое вычисленное значение
     */
    getCacheAsync(comparison: any[]): Promise<T>;
    /**
     * Executes the callback and stores the result in cache.
     *
     * Выполняет callback и сохраняет результат в кэш.
     */
    private setCache;
    /**
     * Asynchronously executes the callback and stores the result in cache.
     *
     * Асинхронно выполняет callback и сохраняет результат в кэш.
     */
    private setCacheAsync;
    /**
     * Determines if the cache should be updated based on comparison array changes.
     *
     * Определяет, следует ли обновить кэш на основе изменений в массиве comparison.
     * @param comparison - New comparison array to compare against / Новый массив comparison для сравнения
     * @returns True if cache should be updated, false otherwise / True, если кэш нужно обновить, иначе false
     */
    private isUpdate;
}

/**
 * Static cache class that uses ServerStorage for persistent caching across the application.
 *
 * Статический класс кэша, использующий ServerStorage для постоянного кэширования в приложении.
 * @deprecated This class is obsolete and should not be used / Этот класс устарел и не рекомендуется к использованию
 */
export declare class CacheStatic {
    /**
     * Retrieves the Cache instance from ServerStorage.
     *
     * Получает экземпляр Cache из ServerStorage.
     * @returns Cache instance for static caching / Экземпляр Cache для статического кэширования
     */
    protected static getItem(): Cache_2;
    /**
     * Returns a cached value for the given name. If not cached, executes the callback and stores the result.
     *
     * Возвращает кэшированное значение для указанного имени. Если нет кэша, выполняет callback и сохраняет результат.
     * @param name - Unique cache key / Уникальный ключ кэша
     * @param callback - Function to compute the value if not cached / Функция для вычисления значения, если его нет в кэше
     * @param comparison - Optional array for cache invalidation / Опциональный массив для инвалидации кэша
     * @returns The cached or newly computed value / Кэшированное или новое вычисленное значение
     */
    static get<T>(name: string, callback: () => T, comparison?: any[]): T;
    /**
     * Asynchronously returns a cached value for the given name. If not cached, executes the callback and stores the result.
     *
     * Асинхронно возвращает кэшированное значение для указанного имени. Если нет кэша, выполняет callback и сохраняет результат.
     * @param name - Unique cache key / Уникальный ключ кэша
     * @param callback - Async function to compute the value if not cached / Асинхронная функция для вычисления значения
     * @param comparison - Optional array for cache invalidation / Опциональный массив для инвалидации кэша
     * @returns Promise resolving to the cached or newly computed value / Promise, разрешающийся в кэшированное или новое вычисленное значение
     */
    static getAsync<T>(name: string, callback: () => T, comparison?: any[]): Promise<T>;
}

/**
 * Capitalizes the first letter of a string.
 *
 * Делает первую букву строки заглавной.
 * @param value string to capitalize / строка для капитализации
 * @param isLocale use locale / использовать локаль
 * @returns capitalized string / капитализированная строка
 */
export declare function capitalize(value: string, isLocale?: boolean): string;

/**
 * Class for working with cookies.
 *
 * Класс для управления Cookie.
 */
export declare class Cookie<T> {
    private name;
    /**
     * Returns an instance of the class according to the specified cookie name.
     *
     * Возвращает экземпляр класса по указанному имени cookie.
     * @param name cookie name/ название cookie
     */
    static getInstance<T>(name: string): Cookie<T>;
    /** Cookie value / Значение cookie */
    private value?;
    /** Cookie options / Параметры cookie */
    private options;
    /**
     * Constructor
     * @param name cookie name/ название cookie
     */
    constructor(name: string);
    /**
     * Get data or update if none.
     *
     * Получает данные или обновляет, если их нет.
     * @param defaultValue value or function to change data / значение или функция для изменения данных
     * @param options additional parameters / дополнительные параметры
     * @returns cookie value / значение cookie
     */
    get(defaultValue?: T | string | (() => (T | string)), options?: CookieOptions): string | T | undefined;
    /**
     * Updates cookie data.
     *
     * Обновляет данные cookie.
     * @param value value or function to change data / значение или функция для изменения данных
     * @param options additional parameters / дополнительные параметры
     */
    set(value?: T | string | (() => (T | string)), options?: CookieOptions): void;
    /**
     * Delete cookie data.
     *
     * Удаление данных из cookie.
     */
    remove(): void;
    /**
     * Update cookie data.
     *
     * Обновление данных cookie.
     */
    private update;
}

/**
 * Class for changing cookie access status.
 *
 * Класс для изменения статуса доступа к куки.
 */
export declare class CookieBlock {
    /**
     * Returns a request-isolated instance of CookieBlockInstance.
     *
     * Возвращает изолированный в рамках запроса экземпляр CookieBlockInstance.
     * @returns CookieBlockInstance instance / экземпляр CookieBlockInstance
     */
    static getItem(): CookieBlockInstance;
    /**
     * Obtaining status.
     *
     * Получение статуса.
     * @returns boolean current block status/ текущий статус блокировки
     */
    static get(): boolean;
    /**
     * Changing status.
     *
     * Изменение статуса.
     * @param value value to be changed/ значение, на которое будет изменен
     * @returns void / ничего не возвращает
     */
    static set(value: boolean): void;
}

/**
 * Class for changing cookie access status.
 *
 * Класс для изменения статуса доступа к куки.
 */
export declare class CookieBlockInstance {
    /** Data storage for cookie block status / Хранилище данных для статуса блокировки куки */
    private storage;
    /**
     * Obtaining status.
     *
     * Получение статуса.
     * @returns boolean current block status/ текущий статус блокировки
     */
    get(): boolean;
    /**
     * Changing status.
     *
     * Изменение статуса.
     * @param value value to be changed/ значение, на которое будет изменен
     * @returns void / ничего не возвращает
     */
    set(value: boolean): void;
}

/**
 * Cookie options / Параметры cookie
 */
export declare type CookieOptions = {
    /** Cache age / Время кэширования */
    age?: number;
    /** SameSite attribute / Атрибут SameSite */
    sameSite?: CookieSameSite_2;
    /** Path / Путь */
    path?: string;
    /** Domain / Домен */
    domain?: string;
    /** Secure attribute / Атрибут Secure */
    secure?: boolean;
    /** HttpOnly attribute / Атрибут HttpOnly */
    httpOnly?: boolean;
    /** Partitioned attribute / Атрибут Partitioned */
    partitioned?: boolean;
    /** Additional arguments / Дополнительные аргументы */
    arguments?: string[] | Record<string, string | number | boolean>;
};

/**
 * Cookie sameSite attribute / Атрибут sameSite cookie
 */
declare type CookieSameSite_2 = 'strict' | 'lax';
export { CookieSameSite_2 as CookieSameSite }

/**
 * Class for managing cookie storage with support for custom listeners.
 * Useful for consistent cookie handling across different environments (DOM, SSR).
 *
 * Класс для управления хранением cookie с поддержкой пользовательских слушателей.
 * Полезен для консистентной работы с cookie в различных окружениях (DOM, SSR).
 */
export declare class CookieStorage {
    /** Storage mechanism for getting data / механизм хранения для получения данных */
    protected static getListener?: (key: string) => any | undefined;
    /** Storage mechanism for getting raw data / механизм хранения для получения сырых данных */
    protected static getListenerRaw?: () => string;
    /** Storage mechanism for setting data / механизм хранения для сохранения данных */
    protected static setListener?: (key: string, value: any, cookie: string, options?: CookieOptions) => void;
    /**
     * Initializes the storage with listeners.
     *
     * Инициализирует хранилище слушателями.
     * @param getListener Storage mechanism for getting data / механизм хранения для получения данных
     * @param getListenerRaw Storage mechanism for getting raw cookie string / механизм хранения для получения сырой строки cookie
     * @param setListener Storage mechanism for setting data / механизм хранения для сохранения данных
     */
    static init(getListener?: (key: string) => any | undefined, getListenerRaw?: () => string, setListener?: (key: string, value: any, cookie: string, options?: CookieOptions) => void): void;
    /**
     * Resets the storage by clearing all in-memory items and resetting listeners.
     *
     * Сбрасывает хранилище, очищая все элементы в памяти и сбрасывая слушатели.
     */
    static reset(): void;
    /**
     * Getting data from storage.
     *
     * Получение данных из хранилища.
     * @param name cookie name / имя cookie
     * @param defaultValue default value / значение по умолчанию
     * @returns T | undefined cookie value or default/ значение cookie или значение по умолчанию
     */
    static get<T>(name: string, defaultValue?: T | (() => T)): T | undefined;
    /**
     * Saving data to storage.
     *
     * Сохранение данных в хранилище.
     * @param name cookie name / имя cookie
     * @param value data to be stored / данные для хранения
     * @param options additional parameters / дополнительные параметры
     * @returns stored value / сохраненное значение
     */
    static set<T>(name: string, value: T | (() => T), options?: CookieOptions): T;
    /**
     * Removing data from storage.
     *
     * Удаление данных из хранилища.
     * @param name cookie name / имя cookie
     * @returns void / ничего не возвращает
     */
    static remove(name: string): void;
    /**
     * Update data from cookies.
     *
     * Обновляет данные из cookies.
     */
    static update(): void;
    /**
     * Formats the cookie string for storage.
     *
     * Форматирует строку cookie для хранения.
     * @param name cookie name / имя cookie
     * @param value cookie value / значение cookie
     * @param options additional parameters / дополнительные параметры
     */
    protected static format(name: string, value: string, options?: CookieOptions): string;
    /**
     * Check if the current environment is a DOM environment.
     *
     * Проверяет, является ли текущее окружение DOM-окружением.
     * @returns True if the current environment is a DOM environment, false otherwise / Возвращает true, если текущее окружение является DOM-окружением, иначе false
     */
    protected static hasDom(): boolean;
    /**
     * Parses the cookie string into a key-value pair object.
     *
     * Разбирает строку cookie в объект пар ключ-значение.
     * @param cookie cookie string / строка cookie
     * @returns Record<string, any> parsed items / разобранные элементы
     */
    protected static parse(cookie: string): Record<string, any>;
    /**
     * Initialize storage if not initialized.
     *
     * Инициализирует хранилище, если оно не инициализировано.
     */
    protected static initItems(): Record<string, any>;
    /**
     * Converts the value to a string for the max-age attribute.
     *
     * Преобразует значение в строку для атрибута max-age.
     * @param stringValue cookie value / значение cookie
     * @param age cache age (default: 7 days) / возраст кэша (по умолчанию: 7 дней)
     */
    protected static toMaxAge(stringValue: string, age?: CookieOptions['age']): string;
    /**
     * Converts the value to a string for the SameSite attribute.
     *
     * Преобразует значение в строку для атрибута SameSite.
     * @param sameSite SameSite attribute / атрибут SameSite
     */
    protected static toSameSite(sameSite?: CookieOptions['sameSite']): string;
    /**
     * Converts the value to a string for the path attribute.
     *
     * Преобразует значение в строку для атрибута path.
     * @param path Path / путь
     */
    protected static toPath(path?: CookieOptions['path']): string;
    /**
     * Converts the value to a string for the domain attribute.
     *
     * Преобразует значение в строку для атрибута domain.
     * @param domain Domain / домен
     */
    protected static toDomain(domain?: CookieOptions['domain']): string | undefined;
    /**
     * Converts the value to a string for the secure attribute.
     *
     * Преобразует значение в строку для атрибута secure.
     * @param secure Secure attribute / атрибут secure
     */
    protected static toSecure(secure?: CookieOptions['secure']): string | undefined;
    /**
     * Converts the value to a string for the HttpOnly attribute.
     *
     * Преобразует значение в строку для атрибута HttpOnly.
     * @param httpOnly HttpOnly attribute / атрибут HttpOnly
     */
    protected static toHttpOnly(httpOnly?: CookieOptions['httpOnly']): string | undefined;
    /**
     * Converts the value to a string for the partitioned attribute.
     *
     * Преобразует значение в строку для атрибута partitioned.
     * @param partitioned Partitioned attribute / атрибут partitioned
     */
    protected static toPartitioned(partitioned?: CookieOptions['partitioned']): string | undefined;
    /**
     * Converts additional arguments to an array of strings.
     *
     * Преобразует дополнительные аргументы в массив строк.
     * @param args additional arguments / дополнительные аргументы
     */
    protected static toArguments(args?: CookieOptions['arguments']): string[];
}

/**
 * Creates a deep copy of an object for independent data management.
 * The goal of the method is to get a completely new separate instance of the object to avoid unwanted mutations.
 *
 * Создает глубокую копию объекта для независимого управления данными.
 * Цель метода — получить полностью новый отдельный экземпляр объекта во избежание нежелательных мутаций.
 * @param value object for copying / объект для копирования
 * @returns returns a new copy of the object / возвращает новую копию объекта
 */
export declare function copyObject<T>(value: T): T;

/**
 * Copies a simple object.
 *
 * Копирует простой объект.
 * @param value object for copying / объект для копирования
 * @param source additional properties for copying / дополнительные свойства для копирования
 * @returns returns a new copy of the object / возвращает новую копию объекта
 */
export declare function copyObjectLite<T, R = T>(value: T, source?: any): R;

/**
 * In HTML documents, creates an element with the tag that is specified in the argument.
 *
 * В HTML-документах создаёт элемент с тегом, который указан в аргументе.
 *
 * @param parentElement the DOM node's parent Element / родитель для нового элемента
 * @param tagName a string that specifies the type of element to be created / строка, указывающая элемент какого типа должен быть создан
 * @param options an object with attributes or a function for processing an element / объект с атрибутами или функция для обработки элемента
 * @param referenceElement the node before which newNode is inserted / элемент, перед которым будет вставлен newElement
 * @returns created element, or undefined in SSR / созданный элемент или undefined при SSR
 *
 * @remarks
 * When running on the server, the function always returns `undefined`.
 * If you use it within a component's rendering logic, it may lead to hydration mismatches.
 * It is recommended to call this function only inside lifecycle hooks that run exclusively on the client (e.g., `onMounted` in Vue or `useEffect` in React).
 *
 * При выполнении на сервере функция всегда возвращает `undefined`.
 * Если вы используете её внутри логики рендеринга компонента, это может привести к ошибкам гидратации.
 * Рекомендуется вызывать эту функцию только в хуках жизненного цикла, которые выполняются на клиенте (например, `onMounted` в Vue или `useEffect` в React).
 */
export declare function createElement<T extends HTMLElement>(parentElement?: HTMLElement, tagName?: string, options?: Partial<T> | Record<keyof T, T[keyof T]> | ((element: T) => void), referenceElement?: HTMLElement): T | undefined;

/**
 * Class for working with localStorage and sessionStorage.
 * Includes support for prefixes, expiration time, and request isolation in SSR.
 *
 * Класс для работы с localStorage и sessionStorage.
 * Включает поддержку префиксов, времени жизни данных и изоляцию запросов в SSR.
 */
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.
     *
     * Изменение префикса в названиях ключей. Вызывать нужно в начале кода.
     * @param newPrefix new prefix/ новый префикс
     * @returns void / ничего не возвращает
     */
    static setPrefix(newPrefix: string): void;
    /**
     * The current value stored in memory/
     * Текущее значение, хранящееся в памяти
     */
    private value?;
    /**
     * The timestamp of when the value was last saved/
     * Временная метка последнего сохранения значения
     */
    private age?;
    /**
     * Constructor.
     *
     * Конструктор.
     * @param name value name / название значения
     * @param isSession should we use a session/ использовать ли сессию
     * @param errorCenter error center instance/ экземпляр центра ошибок
     */
    constructor(name: string, isSession?: boolean, errorCenter?: ErrorCenterInstance);
    /**
     * Getting data from storage.
     *
     * Получение данных из хранилища.
     * @param defaultValue default value / значение по умолчанию
     * @param cache cache time in seconds / время кэширования в секундах
     * @returns stored value or default value / сохраненное значение или значение по умолчанию
     */
    get(defaultValue?: T | (() => T), cache?: number): T | undefined;
    /**
     * Changing data in storage.
     *
     * Изменение данных в хранилище.
     * @param value new values / новые значения
     * @returns the set value / установленное значение
     */
    set(value?: T | (() => T)): T | undefined;
    /**
     * Removing data from storage.
     *
     * Удаление данных из хранилища.
     * @returns this instance for chaining / текущий экземпляр для цепочки вызовов
     */
    remove(): this;
    /**
     * Syncing data from storage.
     *
     * Синхронизация данных из хранилища.
     * @returns this instance / текущий экземпляр
     */
    update(): this;
    /**
     * Checks for storage time limit.
     *
     * Проверяет данные на истечение срока хранения (кэша).
     * @param cache cache time in seconds / время кэширования в секундах
     * @returns true if data is valid / true, если данные актуальны
     */
    private isCache;
    /**
     * Returns an object for working with storage (localStorage or sessionStorage).
     *
     * Возвращает объект для работы с хранилищем (localStorage или sessionStorage).
     * @returns Storage object or undefined / объект Storage или undefined
     */
    private getMethod;
    /**
     * Getting the storage key name with prefix.
     *
     * Получение имени ключа в хранилище с учетом префикса.
     * @returns key name / имя ключа
     */
    private getIndex;
    /**
     * Getting raw data from storage.
     *
     * Получение "сырых" данных из хранилища.
     * @returns parsed data or undefined / распарсенные данные или undefined
     */
    private getValue;
    /**
     * Filling in the data from storage into memory.
     *
     * Заполнение данных из хранилища в память.
     * @returns this instance / текущий экземпляр
     */
    private make;
}

/**
 * A class for working with dates.
 *
 * Класс для работы с датами.
 *
 * @remarks
 * Creating a `Datetime` instance without a specific date (using the current time)
 * for rendering in SSR may lead to hydration mismatches because the time or time zone
 * on the server may differ from the time on the client.
 *
 * Создание экземпляра `Datetime` без указания конкретной даты (использование текущего времени)
 * для отрисовки в SSR может привести к ошибкам гидратации, так как время или часовой пояс
 * сервера могут отличаться от времени на стороне клиента.
 */
export declare class Datetime {
    protected type: GeoDate;
    protected code: string;
    /** Date object / Объект даты */
    protected date: Date;
    /** Whether 24-hour format is used / Использовать ли 24-часовой формат */
    protected hour24: boolean;
    /** Callback on date update / Колбэк при изменении даты */
    protected watch?: (date: Date, type: GeoDate, hour24: boolean) => void;
    /**
     * Constructor
     * @param date date for processing/ дата для обработки
     * @param type type of date format for output/ тип формата даты вывода
     * @param code country and language code/ код страны и языка
     */
    constructor(date?: NumberOrStringOrDate, type?: GeoDate, code?: string);
    /**
     * Returns an object for working with formatting.
     *
     * Возвращает объект для работы с форматированием.
     * @returns GeoIntl formatting object/ объект форматирования
     */
    getIntl(): GeoIntl;
    /**
     * Returns a Date object.
     *
     * Возвращает объект Date.
     * @returns Date date object/ объект даты
     */
    getDate(): Date;
    /**
     * Returns the type of data output.
     *
     * Возвращает тип вывода данных.
     * @returns GeoDate output type/ тип вывода
     */
    getType(): GeoDate;
    /**
     * Returns the format of hours.
     *
     * Возвращает формат часов.
     * @returns GeoHours hour format/ формат часов
     */
    getHoursType(): GeoHours;
    /**
     * Whether to use 24-hour time format.
     *
     * Использовать ли 24-часовой формат времени.
     * @returns boolean 24-hour format flag/ флаг 24-часового формата
     */
    getHour24(): boolean;
    /**
     * The method returns the difference, in minutes, between
     * a date as evaluated in the UTC time zone, and the same date as evaluated
     * in the local time zone.
     *
     * Метод возвращает смещение часового пояса относительно часового пояса UTC
     * в минутах для текущей локали.
     * @returns number time zone offset in minutes/ смещение часового пояса в минутах
     */
    getTimeZoneOffset(): number;
    /**
     * Returns the time zone as a string.
     *
     * Возвращает временную зону в виде строки.
     * @param style the style of the returned data/ стиль возвращаемых данных
     * @returns string time zone string/ строка временной зоны
     */
    getTimeZone(style?: GeoTimeZoneStyle): string;
    /**
     * Returns the code of the first day of the week.
     *
     * Возвращает код первого дня недели.
     * @returns GeoFirstDay first day code/ код первого дня недели
     */
    getFirstDayCode(): GeoFirstDay;
    /**
     * The method returns the year of the specified date according to local time.
     *
     * Метод возвращает год указанной даты по местному времени.
     * @returns year / год
     */
    getYear(): number;
    /**
     * The method returns the month in the specified date according to local time,
     * as a one-based value (1-12).
     *
     * Метод возвращает месяц указанной даты по местному времени, нумерация
     * месяцев начинается с единицы (1-12).
     * @returns month (1-12) / месяц (1-12)
     */
    getMonth(): number;
    /**
     * The method returns the day of the month for the specified date according to local time.
     *
     * Метод возвращает день месяца указанной даты по местному времени
     * @returns day of month (1-31) / день месяца (1-31)
     */
    getDay(): number;
    /**
     * The method returns the hour for the specified date, according to local time.
     *
     * Метод возвращает часы указанной даты по местному времени.
     * @returns hours (0-23) / часы (0-23)
     */
    getHour(): number;
    /**
     * The method returns the minutes in the specified date according to local time.
     *
     * Метод возвращает минуты указанной даты по местному времени.
     * @returns minutes (0-59) / минуты (0-59)
     */
    getMinute(): number;
    /**
     * The method returns the seconds in the specified date according to local time.
     *
     * Метод возвращает секунды указанной даты по местному времени.
     * @returns seconds (0-59) / секунды (0-59)
     */
    getSecond(): number;
    /**
     * Returns the last day of the month as a number.
     *
     * Возвращает последний день месяца в виде числа.
     * @returns last day of month (28-31) / последний день месяца (28-31)
     */
    getMaxDay(): number;
    /**
     * Enables language-sensitive date and time formatting.
     *
     * Конструктором объектов, включающих языка-зависимое форматирование даты и времени.
     * @param type type of date format for output/ тип формата даты вывода
     * @param styleOptions the representation of the month/ представление месяца
     * @returns string formatted date string/ отформатированная строка даты
     */
    locale(type?: GeoDate, styleOptions?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions): string;
    /**
     * Returns the formatted year.
     *
     * Возвращает отформатированный год.
     * @param style the representation of the year/ представление года
     * @returns string formatted year/ отформатированный год
     */
    localeYear(style?: Intl.DateTimeFormatOptions['year']): string;
    /**
     * Returns the formatted month.
     *
     * Возвращает отформатированный месяц.
     * @param style the representation of the month/ представление месяца
     * @returns string formatted month/ отформатированный месяц
     */
    localeMonth(style?: Intl.DateTimeFormatOptions['month']): string;
    /**
     * Returns the formatted day.
     *
     * Возвращает отформатированный день.
     * @param style the representation of the day/ представление дня
     * @returns string formatted day/ отформатированный день
     */
    localeDay(style?: Intl.DateTimeFormatOptions['day']): string;
    /**
     * Returns the formatted hour.
     *
     * Возвращает отформатированный час.
     * @param style the representation of the hour/ представление часа
     * @returns string formatted hour/ отформатированный час
     */
    localeHour(style?: Intl.DateTimeFormatOptions['hour']): string;
    /**
     * Returns the formatted minute.
     *
     * Возвращает отформатированную минуту.
     * @param style the representation of the minute/ представление минуты
     * @returns string formatted minute/ отформатированная минута
     */
    localeMinute(style?: Intl.DateTimeFormatOptions['minute']): string;
    /**
     * Returns the formatted second.
     *
     * Возвращает отформатированную секунду.
     * @param style the representation of the second/ представление секунды
     * @returns string formatted second/ отформатированная секунда
     */
    localeSecond(style?: Intl.DateTimeFormatOptions['second']): string;
    /**
     * Output of standard data.
     *
     * Вывод стандартных данных.
     * @param timeZone add time zone (default: true) / добавить временную зону (по умолчанию: true)
     * @returns standard format string / строка в стандартном формате
     */
    standard(timeZone?: boolean): string;
    /**
     * Change the date completely.
     *
     * Изменять полностью дату.
     * @param value an integer value representing the number / целочисленное значение, представляющее число
     * @returns this instance / текущий экземпляр
     */
    setDate(value: NumberOrStringOrDate): this;
    /**
     * Change the type of data output.
     *
     * Изменить тип вывода данных.
     * @param value type of output / тип вывод
     * @returns this instance / текущий экземпляр
     */
    setType(value: GeoDate): this;
    /**
     * Whether to use a 24-hour time format.
     *
     * Использовать ли 24-часовой формат времени.
     * @param value If true, output the 24-hour time format / если true, выводить 24-часовой формат времени
     * @returns this instance / текущий экземпляр
     */
    setHour24(value: boolean): this;
    /**
     * To change the location.
     *
     * Изменить местоположение.
     * @param code country and language code / код страны и языка
     * @returns this instance / текущий экземпляр
     */
    setCode(code: string): this;
    /**
     * The function is called when the data is updated.
     *
     * Функция вызывается при обновлении данных.
     * @param watch the function calls / функция вызывает
     * @returns this instance / текущий экземпляр
     */
    setWatch(watch: (date: Date, type: GeoDate, hour24: boolean) => void): this;
    /**
     * The method sets the full year for a specified date according to local time.
     *
     * Метод устанавливает полный год указанной даты по местному времени.
     * @param value value / значения
     * @returns this instance / текущий экземпляр
     */
    setYear(value: number): this;
    /**
     * The method sets the month for a specified date according to the currently set year.
     *
     * Метод устанавливает месяц указанной даты по местному времени.
     * @param value month (1-12) / месяц (1-12)
     * @returns this instance / текущий экземпляр
     */
    setMonth(value: number): this;
    /**
     * The method changes the day of the month of a given Date instance, based on local time.
     *
     * Метод устанавливает день месяца указанной даты по местному времени.
     * @param value value / значения
     * @returns this instance / текущий экземпляр
     */
    setDay(value: number): this;
    /**
     * The method sets the hours for a specified date according to local time.
     *
     * Метод устанавливает часы указанной даты по местному времени.
     * @param value value / значения
     * @returns this instance / текущий экземпляр
     */
    setHour(value: number): this;
    /**
     * The method sets the minutes for a specified date according to local time
     *
     * Метод устанавливает минуты указанной даты по местному времени
     * @param value value / значения
     * @returns this instance / текущий экземпляр
     */
    setMinute(value: number): this;
    /**
     * The method sets the seconds for a specified date according to local time.
     *
     * Метод устанавливает секунды указанной даты по местному времени.
     * @param value value / значения
     * @returns this instance / текущий экземпляр
     */
    setSecond(value: number): this;
    /**
     * Shift the date by a given value in years.
     *
     * Сдвинуть дату на заданное значение в годах.
     * @param value values for moving / значения для перемещения
     * @returns this instance / текущий экземпляр
     */
    moveByYear(value: number): this;
    /**
     * Shift the date by a given value in months.
     *
     * Сдвинуть дату на заданное значение в месяцах.
     * @param value values for moving (in months) / значения для перемещения (в месяцах)
     * @returns this instance / текущий экземпляр
     */
    moveByMonth(value: number): this;
    /**
     * Shift the date by a given value in days.
     *
     * Сдвинуть дату на заданное значение в днях.
     * @param value values for moving / значения для перемещения
     * @returns this instance / текущий экземпляр
     */
    moveByDay(value: number): this;
    /**
     * Shift the date by a given value in hours.
     *
     * Сдвинуть дату на заданное значение в часах.
     * @param value values for moving / значения для перемещения
     * @returns this instance / текущий экземпляр
     */
    moveByHour(value: number): this;
    /**
     * Shift the date by a given value in minutes.
     *
     * Сдвинуть дату на заданное значение в минутах.
     * @param value values for moving / значения для перемещения
     * @returns this instance / текущий экземпляр
     */
    moveByMinute(value: number): this;
    /**
     * Shift the date by a given value in seconds.
     *
     * Сдвинуть дату на заданное значение в секундах.
     * @param value values for moving / значения для перемещения
     * @returns this instance / текущий экземпляр
     */
    moveBySecond(value: number): this;
    /**
     * Sets the date to January (first month).
     *
     * Устанавливает дату на январь (первый месяц).
     * @returns this instance / текущий экземпляр
     */
    moveMonthFirst(): this;
    /**
     * Sets the date to December (last month).
     *
     * Устанавливает дату на декабрь (последний месяц).
     * @returns this instance / текущий экземпляр
     */
    moveMonthLast(): this;
    /**
     * Translate to the first day of the next month.
     *
     * Переводить на первый день следующего месяца.
     * @returns this instance / текущий экземпляр
     */
    moveMonthNext(): this;
    /**
     * Translate to the first day of the previous month.
     *
     * Переводить на первый день предыдущего месяца.
     * @returns this instance / текущий экземпляр
     */
    moveMonthPrevious(): this;
    /**
     * Translate to the first day of the week.
     *
     * Переводить на первый день недели.
     * @returns this instance / текущий экземпляр
     */
    moveWeekdayFirst(): this;
    /**
     * Translate to the last day of the week.
     *
     * Переводить на последний день недели.
     * @returns this instance / текущий экземпляр
     */
    moveWeekdayLast(): this;
    /**
     * Translate to the first day of the first week of the month.
     *
     * Переводить на первый день первой недели месяца.
     * @returns this instance / текущий экземпляр
     */
    moveWeekdayFirstByMonth(): this;
    /**
     * Translate to the first day of the first full week of the following month.
     *
     * Переводить на первый день первой полной недели следующего месяца.
     * @returns this instance / текущий экземпляр
     */
    moveWeekdayLastByMonth(): this;
    /**
     * Translate to the next week.
     *
     * Переводить на следующую неделю.
     * @returns this instance / текущий экземпляр
     */
    moveWeekdayNext(): this;
    /**
     * Translate to the previous week.
     *
     * Переводить на предыдущую неделю.
     * @returns this instance / текущий экземпляр
     */
    moveWeekdayPrevious(): this;
    /**
     * Translate to the first day of the month.
     *
     * Переводить на первый день месяца.
     * @returns this instance / текущий экземпляр
     */
    moveDayFirst(): this;
    /**
     * Translate to the last day of the month.
     *
     * Переводить на последний день месяца.
     * @returns this instance / текущий экземпляр
     */
    moveDayLast(): this;
    /**
     * Translate to the next day.
     *
     * Переводить на следующий день.
     * @returns this instance / текущий экземпляр
     */
    moveDayNext(): this;
    /**
     * Translate to the previous day.
     *
     * Переводить на предыдущий день.
     * @returns this instance / текущий экземпляр
     */
    moveDayPrevious(): this;
    /**
     * Clone the Date object.
     *
     * Клонировать объект Date.
     * @returns Date cloned Date object/ клонированный объект Date
     */
    clone(): Date;
    /**
     * Clone the GeoDate object.
     *
     * Клонировать объект GeoDate.
     * @returns Datetime cloned Datetime object/ клонированный объект Datetime
     */
    cloneClass(): Datetime;
    /**
     * Clone the Datetime object and set the month to January.
     *
     * Клонировать объект Datetime и установить месяц на январь.
     * @returns Datetime cloned Datetime with January month/ клонированный Datetime с январем
     */
    cloneMonthFirst(): Datetime;
    /**
     * Clone the GeoDate object and move the month to the end of the year.
     *
     * Клонировать объект GeoDate и перевести месяц на конец года.
     * @returns Datetime cloned Datetime with December month/ клонированный Datetime с декабрем
     */
    cloneMonthLast(): Datetime;
    /**
     * Clone the GeoDate object and transfer it one month ahead.
     *
     * Клонировать объект GeoDate и перевести на 1 месяц вперед.
     * @returns Datetime cloned Datetime with next month/ клонированный Datetime со следующим месяцем
     */
    cloneMonthNext(): Datetime;
    /**
     * Clone the GeoDate object and transfer it one month back.
     *
     * Клонировать объект GeoDate и перевести на 1 месяц назад.
     * @returns Datetime cloned Datetime with previous month/ клонированный Datetime с предыдущим месяцем
     */
    cloneMonthPrevious(): Datetime;
    /**
     * Returns the first day of the week according to the current date.
     *
     * Возвращает первый день недели по текущей дате.
     * @returns Datetime cloned Datetime with first day of week/ клонированный Datetime с первым днем недели
     */
    cloneWeekdayFirst(): Datetime;
    /**
     * Returns the last day of the week according to the current date.
     *
     * Возвращает последний день недели по текущей дате.
     * @returns Datetime cloned Datetime with last day of week/ клонированный Datetime с последним днем недели
     */
    cloneWeekdayLast(): Datetime;
    /**
     * Returns the first day of the week according to the current month.
     *
     * Возвращает первый день недели по текущему месяцу.
     * @returns Datetime cloned Datetime with first day of week in month/ клонированный Datetime с первым днем недели в месяце
     */
    cloneWeekdayFirstByMonth(): Datetime;
    /**
     * Returns the last day of the week according to the current month.
     *
     * Возвращает последний день недели по текущему месяцу.
     * @returns Datetime cloned Datetime with last day of week in month/ клонированный Datetime с последним днем недели в месяце
     */
    cloneWeekdayLastByMonth(): Datetime;
    /**
     * Returns the next week according to the current date.
     *
     * Возвращает следующую неделю по текущей дате.
     * @returns Datetime cloned Datetime with next week/ клонированный Datetime со следующей неделей
     */
    cloneWeekdayNext(): Datetime;
    /**
     * Returns the previous week according to the current date.
     *
     * Возвращает предыдущую неделю по текущей дате.
     * @returns Datetime cloned Datetime with previous week/ клонированный Datetime с предыдущей неделей
     */
    cloneWeekdayPrevious(): Datetime;
    /**
     * Clone the GeoDate object and move the day to the beginning of the month.
     *
     * Клонировать объект GeoDate и перевести день на начало месяца.
     * @returns Datetime cloned Datetime with first day of month/ клонированный Datetime с первым днем месяца
     */
    cloneDayFirst(): Datetime;
    /**
     * Clone the GeoDate object and move the day to the end of the month.
     *
     * Клонировать объект GeoDate и перевести день на конец месяца.
     * @returns Datetime cloned Datetime with last day of month/ клонированный Datetime с последним днем месяца
     */
    cloneDayLast(): Datetime;
    /**
     * Clone the GeoDate object and move by 1 day.
     *
     * Клонировать объект GeoDate и перевести на 1 день.
     * @returns Datetime cloned Datetime with next day/ клонированный Datetime со следующим днем
     */
    cloneDayNext(): Datetime;
    /**
     * Clone the GeoDate object and go back by 1 day.
     *
     * Клонировать объект GeoDate и вернуться на 1 день.
     * @returns Datetime cloned Datetime with previous day/ клонированный Datetime с предыдущим днем
     */
    cloneDayPrevious(): Datetime;
    /**
     * Returns the time zone hour format.
     *
     * Возвращает часовой формат временной зоны.
     * @param hour hour/ час
     * @returns string formatted hour/ форматированный час
     */
    protected toTimeZoneHourFormat(hour: number): string;
    /**
     * Updating all values.
     *
     * Обновление всех значений.
     * @returns this instance/ текущий экземпляр
     */
    protected update(): this;
}

/**
 * Executes a callback function when the DOMContentLoaded event is fired.
 * If the DOM is already loaded (readyState is 'interactive' or 'complete') or if executing in a non-DOM environment,
 * the callback is executed immediately.
 *
 * Выполняет функцию обратного вызова при наступлении события DOMContentLoaded.
 * Если DOM уже загружен (readyState равен 'interactive' или 'complete') или код выполняется вне браузера,
 * функция обратного вызова выполняется немедленно.
 *
 * @param callback function to execute when DOM is loaded / функция для выполнения при загрузке DOM
 * @returns promise resolving to the callback result / промис, разрешающийся результатом выполнения функции
 */
export declare function domContentLoaded<T = void>(callback: () => T | Promise<T>): Promise<T>;

/**
 * Selects the first element that matches the specified selectors.
 *
 * Выбирает первый элемент, который соответствует указанным селекторам.
 * @param selectors selectors / селекторы
 * @returns first matched element or undefined / первый найденный элемент или undefined
 */
export declare function domQuerySelector<E extends Element = Element>(selectors: string): E | undefined;

/**
 * Selects all elements that match the specified selectors.
 *
 * Выбирает все элементы, которые соответствуют указанным селекторам.
 * @param selectors selectors / селекторы
 * @returns list of matched elements or undefined / список найденных элементов или undefined
 */
export declare function domQuerySelectorAll<E extends Element = Element>(selectors: string): NodeListOf<E> | undefined;

/**
 * Generic type that can be either an element or a string selector/
 * Дженерик тип для элемента или строкового селектора
 */
export declare type ElementOrString<E extends ElementOrWindow> = E | string;

/**
 * Union type for HTML elements and Window object/
 * Объединенный тип для HTML элементов и объекта Window
 */
export declare type ElementOrWindow = HTMLElement | Window;

/**
 * Union type for all "empty" values including falsy primitives and string representations/
 * Объединенный тип для всех "пустых" значений включая ложные примитивы и строковые представления
 */
export declare type EmptyValue = Undefined | 0 | false | '' | 'undefined' | 'null' | '0' | 'false' | '[]';

/**
 * Encodes special characters in a string for safe use in HTML attributes.
 *
 * Кодирует специальные символы в строке для безопасного использования в HTML-атрибутах.
 * @param text text to encode / текст для кодирования
 * @returns encoded text / закодированный текст
 */
export declare function encodeAttribute(text: string): string;

/**
 * Encodes special characters in a string for safe use in HTML attributes.
 *
 * Кодирует специальные символы в строке для безопасного использования в HTML-атрибутах.
 * @param text text to encode / текст для кодирования
 * @returns encoded text / закодированный текст
 */
export declare function encodeLiteAttribute(text: string): string;

/**
 * Ensures that an image does not exceed the maximum size by resizing it if needed.
 *
 * Гарантирует, что изображение не превышает максимальный размер, изменяя его размер при необходимости.
 * @param file image file as Uint8Array / файл изображения в виде Uint8Array
 * @param compress maximum size as a fraction of the original size / максимальный размер в виде доли от оригинального размера
 * @param type image type / тип изображения
 * @returns promise with the resized image data as base64 / промис с данными измененного изображения в формате base64
 */
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;
    /**
     * Returns a request-isolated instance of ErrorCenterInstance.
     *
     * Возвращает изолированный в рамках запроса экземпляр ErrorCenterInstance.
     * @returns ErrorCenterInstance instance / экземпляр ErrorCenterInstance
     */
    static getItem(): ErrorCenterInstance;
    /**
     * Checks if a cause with specific code exists.
     *
     * Проверяет наличие причины с конкретным кодом.
     * @param code error code / код ошибки
     * @param group error group / группа ошибки
     * @returns true if cause exists / true, если причина существует
     */
    static has(code: string, group?: string): boolean;
    /**
     * Gets a specific error cause by code and group.
     *
     * Получает конкретную причину ошибки по коду и группе.
     * @param code error code / код ошибки
     * @param group error group / группа ошибки
     * @returns error cause item or undefined / элемент причины ошибки или undefined
     */
    static get(code: string, group?: string): ErrorCenterCauseItem | undefined;
    /**
     * Adds an error cause to the storage.
     *
     * Добавляет причину ошибки в хранилище.
     * @param cause error cause item / элемент причины ошибки
     */
    static add(cause: ErrorCenterCauseItem): void;
    /**
     * Adds a list of error causes to the storage.
     *
     * Добавляет список причин ошибок в хранилище.
     * @param causes error causes list / список причин ошибок
     */
    static addList(causes: ErrorCenterCauseList): void;
    /**
     * Registers a new handler.
     *
     * Регистрирует новый обработчик.
     * @param group target group / целевая группа
     * @param handler handler callback / обратный вызов обработчика
     */
    static addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): void;
    /**
     * Registers a list of handlers.
     *
     * Регистрирует список обработчиков.
     * @param handlers handlers list / список обработчиков
     */
    static addHandlerList(handlers: ErrorCenterHandlerList): void;
    /**
     * Adds a callback to be executed on any error.
     *
     * Добавляет обратный вызов, который будет выполняться при любой ошибке.
     * @param callback callback function / функция обратного вызова
     */
    static addCallback(callback: ErrorCenterHandlerCallback): void;
    /**
     * Sets console output flag or filter function.
     *
     * Устанавливает флаг или функцию фильтрации вывода в консоль.
     * @param isConsole console output flag or filter function / флаг или функция вывода в консоль
     */
    static setIsConsole(isConsole: ErrorCenterHandlerIsConsole): void;
    /**
     * Triggers error handling for a group.
     *
     * Вызывает обработку ошибки для группы.
     * @param cause error cause details / детали причины ошибки
     */
    static on(cause: ErrorCenterCauseItem): void;
}

/**
 * Interface for an error item / Интерфейс для элемента ошибки
 */
export declare type ErrorCenterCauseItem<D = any> = {
    /** Error group / Группа ошибки */
    group?: ErrorCenterGroup;
    /** Error code / Код ошибки */
    code: string;
    /** Priority / Приоритет */
    priority?: number;
    /** Error label / Название ошибки */
    label?: string;
    /** Error message / Сообщение ошибки */
    message?: string;
    /** Additional details / Дополнительные детали */
    details?: D;
};

/**
 * 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;
    /** Callbacks executed on every error / Обратные вызовы, выполняемые при каждой ошибке */
    protected callbacks: ErrorCenterHandlerCallback[];
    /** Console output flag or filter function / Флаг или функция фильтрации вывода в консоль */
    protected isConsole: ErrorCenterHandlerIsConsole;
    /**
     * Constructor
     * @param handlers initial handlers list / начальный список обработчиков
     * @param isConsole console output flag or filter function / флаг или функция вывода в консоль
     */
    constructor(handlers?: ErrorCenterHandlerList, isConsole?: ErrorCenterHandlerIsConsole);
    /**
     * Checks if handlers exist for a group.
     *
     * Проверяет наличие обработчиков для группы.
     * @param group error group / группа ошибки
     * @returns true if handlers exist / true, если обработчики существуют
     */
    has(group: ErrorCenterGroup): boolean;
    /**
     * Gets handlers for a group.
     *
     * Получает обработчики для группы.
     * @param group error group / группа ошибки
     * @returns handler item or undefined / элемент обработчика или undefined
     */
    get(group: ErrorCenterGroup): ErrorCenterHandlerItem | undefined;
    /**
     * Adds a handler for a specific group.
     *
     * Добавляет обработчик для определенной группы.
     * @param group error group / группа ошибки
     * @param handler callback function / функция обратного вызова
     * @returns this instance / текущий экземпляр
     */
    add(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this;
    /**
     * Adds a list of group-based handlers.
     *
     * Добавляет список обработчиков по группам.
     * @param handlers handlers list / список обработчиков
     * @returns this instance / текущий экземпляр
     */
    addList(handlers: ErrorCenterHandlerList): this;
    /**
     * Adds a callback to be executed on any error.
     *
     * Добавляет обратный вызов, который будет выполняться при любой ошибке.
     * @param callback callback function / функция обратного вызова
     * @returns this instance / текущий экземпляр
     */
    addCallback(callback: ErrorCenterHandlerCallback): this;
    /**
     * Sets console output flag or filter function.
     *
     * Устанавливает флаг или функцию фильтрации вывода в консоль.
     * @param isConsole console output flag or filter function / флаг или функция вывода в консоль
     * @returns this instance / текущий экземпляр
     */
    setIsConsole(isConsole: ErrorCenterHandlerIsConsole): this;
    /**
     * Triggers handlers for a group and logs to console.
     *
     * Вызывает обработчики для группы и выводит ошибку в консоль.
     * @param cause error cause details / детали причины ошибки
     * @returns this instance / текущий экземпляр
     */
    on(cause: ErrorCenterCauseItem): this;
    /**
     * Logs error cause to the console.
     *
     * Выводит причину ошибки в консоль.
     * @param cause error details / детали ошибки
     * @returns this instance / текущий экземпляр
     */
    protected toConsole(cause: ErrorCenterCauseItem): this;
}

/**
 * Callback function for error handling / Функция обратного вызова для обработки ошибок
 */
export declare type ErrorCenterHandlerCallback = (cause: ErrorCenterCauseItem) => void;

/**
 * Type for console logging configuration / Тип для конфигурации вывода в консоль
 */
export declare type ErrorCenterHandlerIsConsole = boolean | ErrorCenterHandlerIsConsoleCallback;

/**
 * Callback function to check whether to log error to console / Функция обратного вызова для проверки вывода ошибки в консоль
 */
export declare type ErrorCenterHandlerIsConsoleCallback = (cause: ErrorCenterCauseItem) => boolean;

/**
 * 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 / группа ошибки
     * @returns true if cause exists / true, если причина существует
     */
    has(code: string, group?: string): boolean;
    /**
     * Gets a specific error cause by code and group.
     *
     * Получает конкретную причину ошибки по коду и группе.
     * @param code error code / код ошибки
     * @param group error group / группа ошибки
     * @returns error cause item or undefined / элемент причины ошибки или undefined
     */
    get(code: string, group?: string): ErrorCenterCauseItem | undefined;
    /**
     * Adds an error cause to the storage.
     *
     * Добавляет причину ошибки в хранилище.
     * @param cause error cause item / элемент причины ошибки
     * @returns this instance / текущий экземпляр
     */
    add(cause: ErrorCenterCauseItem): this;
    /**
     * Adds a list of error causes to the storage.
     *
     * Добавляет список причин ошибок в хранилище.
     * @param causes error causes list / список причин ошибок
     * @returns this instance / текущий экземпляр
     */
    addList(causes: ErrorCenterCauseList): this;
    /**
     * Registers a new handler.
     *
     * Регистрирует новый обработчик.
     * @param group target group / целевая группа
     * @param handler handler callback / обратный вызов обработчика
     * @returns this instance / текущий экземпляр
     */
    addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this;
    /**
     * Registers a list of handlers.
     *
     * Регистрирует список обработчиков.
     * @param handlers handlers list / список обработчиков
     * @returns this instance / текущий экземпляр
     */
    addHandlerList(handlers: ErrorCenterHandlerList): this;
    /**
     * Adds a callback to be executed on any error.
     *
     * Добавляет обратный вызов, который будет выполняться при любой ошибке.
     * @param callback callback function / функция обратного вызова
     * @returns this instance / текущий экземпляр
     */
    addCallback(callback: ErrorCenterHandlerCallback): this;
    /**
     * Sets console output flag or filter function for the handler.
     *
     * Устанавливает флаг или функцию фильтрации вывода в консоль для обработчика.
     * @param isConsole console output flag or filter function / флаг или функция вывода в консоль
     * @returns this instance / текущий экземпляр
     */
    setIsConsole(isConsole: ErrorCenterHandlerIsConsole): this;
    /**
     * Triggers error handling for a group.
     *
     * Вызывает обработку ошибки для группы.
     * @param cause error cause details / детали причины ошибки
     * @returns this instance / текущий экземпляр
     */
    on(cause: ErrorCenterCauseItem): this;
    /**
     * Merges provided cause with stored cause data.
     *
     * Объединяет предоставленную причину с сохраненными данными причины.
     * @param cause input cause / входная причина
     * @returns merged error cause / объединенная причина ошибки
     */
    protected assign(cause: ErrorCenterCauseItem): ErrorCenterCauseItem;
}

/**
 * Escapes special regex characters in a string so it can be used safely in a RegExp.
 *
 * Экранирует специальные символы регулярного выражения в строке, чтобы её можно было безопасно использовать в RegExp.
 * @param value string to escape / строка для экранирования
 */
export declare function escapeExp(value: string): string;

/**
 * Type for tracking active event listeners and observers/
 * Тип для отслеживания активных обработчиков событий и наблюдателей
 */
export declare type EventActivityItem<E extends ElementOrWindow> = {
    /** The target element for the event/ Целевой элемент для события */
    element: E | undefined;
    /** The event type name/ Название типа события */
    type: string;
    /** Optional custom event listener/ Опциональный пользовательский обработчик событий */
    listener?: (event: any | Event) => void;
    /** Optional ResizeObserver instance/ Опциональный экземпляр ResizeObserver */
    observer?: ResizeObserver;
};

/**
 * Advanced wrapper for managing event listeners on DOM elements or the `window` object.
 *
 * `EventItem` simplifies the entire event lifecycle (start, stop, toggle, reset), provides
 * built-in optimizations for high-frequency events, and ensures DOM safety by automatically
 * checking if elements are still in the document.
 *
 * ### Key Features:
 * - **Lifecycle Control**: Easily `start`, `stop`, `toggle`, or `reset` event listeners.
 * - **DOM Safety**: Automatically halts the event if the target element is removed from the DOM.
 * - **Specialized Optimizations**:
 *   - `resize`: Uses `ResizeObserver` for any HTML element (not limited to `window`).
 *   - `scroll-sync`: High-performance scroll tracking using `requestAnimationFrame`.
 * - **Dynamic Configuration**: Chained setters for target element, event type, listener, and options.
 * - **Custom Event Dispatching**: Built-in support for triggering events with custom data via `dispatch`.
 * - **Strict Typing**: Generic support for elements, event objects, and custom detail data.
 *
 * ---
 *
 * Продвинутая обертка для управления слушателями событий на DOM-элементах или объекте `window`.
 *
 * `EventItem` упрощает весь жизненный цикл событий (запуск, остановка, переключение, сброс),
 * предоставляет встроенную оптимизацию для тяжелых событий и гарантирует безопасность работы с DOM,
 * автоматически проверяя наличие элементов в документе.
 *
 * ### Ключевые особенности:
 * - **Управление циклом**: Простой контроль через методы `start`, `stop`, `toggle` и `reset`.
 * - **Безопасность DOM**: Автоматическая остановка события, если целевой элемент удален из DOM.
 * - **Специальные оптимизации**:
 *   - `resize`: Использует `ResizeObserver` для любых HTML-элементов (не только для `window`).
 *   - `scroll-sync`: Высокопроизводительный трекинг скролла через `requestAnimationFrame`.
 * - **Динамическая настройка**: Чейнинг сеттеров для смены цели, типа события, метода или опций.
 * - **Диспетчеризация**: Встроенная поддержка вызова событий с передачей пользовательских данных через `dispatch`.
 * - **Строгая типизация**: Поддержка дженериков для типа элемента, объекта события и структуры данных.
 *
 * ---
 *
 * ### Usage Examples / Примеры использования:
 *
 * #### 1. Basic Listener / Базовый слушатель
 * ```typescript
 * const clickEvent = new EventItem('.btn', 'click', (e) => console.log('Clicked!'));
 * clickEvent.start();
 * ```
 *
 * #### 2. Specialized 'resize' and 'scroll-sync' / Оптимизированные 'resize' и 'scroll-sync'
 * ```typescript
 * // Tracks any element's size / Отслеживает размер любого элемента
 * const resizeEvent = new EventItem('.box', 'resize', (entry) => console.log('New size:', entry));
 *
 * // Performance-optimized scroll / Оптимизированный скролл
 * const scrollEvent = new EventItem(window, 'scroll-sync', () => console.log('Scrolling...'));
 *
 * resizeEvent.start();
 * scrollEvent.start();
 * ```
 *
 * #### 3. Custom Data and Dispatching / Пользовательские данные и диспетчеризация
 * ```typescript
 * interface UserData { id: number }
 * const emitter = new EventItem<Window, CustomEvent, UserData>(window, 'user-update');
 *
 * emitter.setListener((e, detail) => {
 *   console.log('Update received for ID:', detail?.id);
 * });
 *
 * emitter.start();
 *
 * // Trigger manually with data / Вызов вручную с данными
 * emitter.dispatch({ id: 456 });
 * ```
 *
 * #### 4. Chaining and Dynamic Updates / Чейнинг и динамическое обновление
 * ```typescript
 * const tracker = new EventItem('.item-1', 'mousemove', (e) => console.log(e.clientX));
 *
 * // Switch element on the fly / Переключение элемента "на лету"
 * tracker.start().setElement('.item-2');
 * ```
 */
export declare class EventItem<E extends ElementOrWindow, O extends Event, D extends Record<string, any> = Record<string, any>> {
    protected listener?: EventListenerDetail<O, D> | undefined;
    protected options?: EventOptions;
    protected detail?: D | undefined;
    /** Target element / Целевой элемент */
    protected element?: E;
    /** Element for checking control / Элемент для проверки контроля */
    protected elementControl?: ElementOrWindow;
    /** Flag whether control element was explicitly set / Флаг явной установки управляющего элемента */
    protected elementControlEdit?: boolean;
    /** Event types array / Массив типов событий */
    protected type: string[];
    /** Event listener callback wrapper / Обертка колбэка слушателя событий */
    protected listenerRecent: (event?: O | ResizeObserverEntry) => void;
    /** Active state flag / Флаг активности */
    protected activity: boolean;
    /** Active listener items list / Список активных элементов слушателя */
    protected activityItems: EventActivityItem<E>[];
    /**
     * Constructor for EventItem.
     *
     * Конструктор для EventItem.
     * @param elementSelector target element or selector where the listener should be attached / целевой элемент или селектор, к которому должен быть прикреплен слушатель
     * @param type event type (e.g., 'click'), array of types, or special optimization types ('resize', 'scroll-sync') / тип события (например, 'click'), массив типов или специальные типы оптимизации ('resize', 'scroll-sync')
     * @param listener the handler function to be executed when the event occurs / функция-обработчик, которая будет выполнена при возникновении события
     * @param options standard EventListenerOptions or boolean for useCapture / стандартные EventListenerOptions или логическое значение для useCapture
     * @param detail additional data provided to the listener via the custom Event interaction / дополнительные данные, предоставляемые слушателю через кастомное взаимодействие с событием
     */
    constructor(elementSelector?: ElementOrString<E>, type?: string | string[], listener?: EventListenerDetail<O, D> | undefined, options?: EventOptions, detail?: D | undefined);
    /**
     * Checks whether event listening is currently enabled.
     *
     * Проверяет, включено ли сейчас прослушивание события.
     * @returns true if active / true, если активно
     */
    isActive(): boolean;
    /**
     * Returns the target element.
     *
     * Возвращает целевой элемент.
     * @returns target element / целевой элемент
     */
    getElement(): E | undefined;
    /**
     * Change of an element for tracking.
     *
     * Изменение элемента для прослеживания.
     * @param elementSelector target element or selector / целевой элемент или селектор
     * @returns this instance / текущий экземпляр
     */
    setElement(elementSelector?: ElementOrString<E>): this;
    /**
     * Modifies the control element for DOM safety checks.
     *
     * Модифицирует контрольный элемент для проверки безопасности DOM.
     * @param elementSelector control element or selector / контрольный элемент или селектор
     * @returns this instance / текущий экземпляр
     */
    setElementControl<EC extends HTMLElement>(elementSelector?: ElementOrString<EC>): this;
    /**
     * Changes the type of the handled event.
     *
     * Изменяет тип обрабатываемого события.
     * @param type event type or array of types / тип события или массив типов
     * @returns this instance / текущий экземпляр
     */
    setType(type: string | string[]): this;
    /**
     * Modifies the listener function.
     *
     * Модифицирует функцию-слушатель.
     * @param listener new listener function / новая функция-слушатель
     * @returns this instance / текущий экземпляр
     */
    setListener(listener: EventListenerDetail<O, D>): this;
    /**
     * Modifying the options object that defines the characteristics of the event listener.
     *
     * Изменение объекта options, который определяет характеристики слушателя событий.
     * @param options event listener options / опции слушателя событий
     * @returns this instance / текущий экземпляр
     */
    setOptions(options?: EventOptions): this;
    /**
     * Modifying the additional data provided to the listener.
     *
     * Изменение дополнительных данных, передаваемых слушателю.
     * @param detail custom data / пользовательские данные
     * @returns this instance / текущий экземпляр
     */
    setDetail(detail?: D): this;
    /**
     * Triggers the events on the target element, optionally with a new detail value.
     * This method manually initiates a `CustomEvent` dispatch for all specified types.
     *
     * Инициирует события на целевом элементе, опционально с новым значением detail.
     * Этот метод вручную запускает диспетчеризацию `CustomEvent` для всех указанных типов.
     * @param detail the value to be passed as the event detail / значение, которое будет передано как detail события
     * @returns this instance / текущий экземпляр
     */
    dispatch(detail?: D | undefined): this;
    /**
     * Starts event listening.
     *
     * Запуск прослушивания события.
     * @returns this instance / текущий экземпляр
     */
    start(): this;
    /**
     * Stops event listening.
     *
     * Остановка прослушивания события.
     * @returns this instance / текущий экземпляр
     */
    stop(): this;
    /**
     * Toggling event handler state.
     *
     * Переключение состояния работы события.
     * @param activity event activation/ активация события
     * @returns this instance / текущий экземпляр
     */
    toggle(activity: boolean): this;
    /**
     * Overloads the listening events (stops and starts again if active).
     *
     * Перегружает события прослушивания (останавливает и запускает заново, если активно).
     * @returns this instance / текущий экземпляр
     */
    reset(): this;
    /**
     * Checks if the ResizeObserver object exists.
     *
     * Проверяет, существует ли объект ResizeObserver.
     */
    protected isObserver(): boolean;
    /**
     * The implementation of the resize event for an element.
     *
     * Реализация события изменения размера для элемента.
     */
    protected makeResize(): boolean;
    /**
     * Implementation of the scroll event for an element.
     *
     * Реализация события изменения положения скролла для элемента.
     */
    protected makeScroll(): boolean;
}

/**
 * Generic event listener function type with additional detail parameter/
 * Дженерик тип функции обработчика событий с дополнительным параметром detail
 */
export declare type EventListenerDetail<O extends Event, D extends Record<string, any>> = (event: O, detail?: D) => void;

/** Type for event listener options/ Тип для опций обработчика событий */
export declare type EventOptions = AddEventListenerOptions | boolean | undefined;

/**
 * Stop listening to events in depth.
 *
 * Остановить прослушивания события в глубину.
 * @param event event instance/ экземпляр события
 */
export declare function eventStopPropagation(event: Event): void;

/**
 * Flexible utility that executes the provided argument if it is a function, otherwise returns it as is.
 * Supports passing arbitrary arguments to the callback.
 *
 * Универсальная утилита, которая выполняет переданный аргумент, если он является функцией, иначе возвращает его без изменений.
 * Поддерживает передачу произвольных аргументов в функцию обратного вызова.
 * @param callback function or any value / функция или любое значение
 * @param args arguments of the function / аргументы функции
 * @returns result of the execution or the value itself / результат выполнения или само значение
 */
export declare function executeFunction<T>(callback: T | FunctionArgs<any, T>, ...args: any[]): T;

/**
 * Safely executes a function and awaits its result if it returns a Promise.
 * If the provided value is a static value or a synchronous function, it returns the result immediately wrapped in a Promise.
 *
 * Безопасно выполняет функцию и ожидает её результат, если она возвращает Promise.
 * Если переданное значение является статическим или синхронной функцией, возвращает результат немедленно, обернутым в Promise.
 * @param callback function, Promise or any value / функция, Promise или любое значение
 * @param args arguments of the function / аргументы функции
 * @returns promise resolving to the execution result / промис, разрешающийся результатом выполнения
 */
export declare function executePromise<T>(callback: ((...args: any[]) => Promise<T>) | ((...args: any[]) => T) | T, ...args: any[]): Promise<T>;

/**
 * The function performs the specified function once for each element in the object
 * and returns an array with the results of executing the function.
 *
 * Функция выполняет указанную функцию один раз для каждого элемента в объекте
 * и возвращает массив с результатами выполнения функции.
 * @param data object for iteration / объект для перебора
 * @param callback a function to execute for each element in the array /
 * функция, которая будет вызвана для каждого элемента
 * @param saveUndefined if true, the function will return an array with undefined values /
 * если true, функция вернет массив с undefined значениями
 * @returns returns an array with the results of executing the function / возвращает массив с результатами выполнения функции
 */
export declare function forEach<T, R, D extends T[] | Record<string, T> | Map<string, T> | Set<T> = T[] | Record<string, T> | Map<string, T> | Set<T>, K = D extends T[] ? number : string>(data: D & (T[] | Record<string, T> | Map<string, T> | Set<T>), callback: (item: T, key: K, dataMain: typeof data) => R, saveUndefined?: boolean): R[];

/**
 * Class for formatting a list of data based on provided options.
 *
 * Класс для форматирования списка данных на основе предоставленных параметров.
 * @template Options type of formatting options / тип параметров форматирования.
 * @template List type of the list of items (can be an array or a single item) / тип списка элементов (может быть массивом или одним элементом).
 * @template Item type of a single item in the list / тип одного элемента в списке.
 */
export declare class Formatters<Options extends FormattersOptionsList = FormattersOptionsList, List extends FormattersListProp = FormattersListProp, Item extends FormattersItemProp<List> = FormattersItemProp<List>> {
    protected options: Options;
    protected list?: List | undefined;
    /**
     * Constructor
     *
     * Конструктор
     * @param options formatting options for each column/property / параметры форматирования для каждого столбца/свойства
     * @param list initial list of data to format / начальный список данных для форматирования
     */
    constructor(options: Options, list?: List | undefined);
    /**
     * Checks if the list is set.
     *
     * Проверяет, установлен ли список.
     * @returns true if the list is set / true, если список установлен
     */
    is(): boolean;
    /**
     * Checks if the list is an array.
     *
     * Проверяет, является ли список массивом.
     * @returns true if the list is an array / true, если список является массивом
     */
    isArray(): this is this & {
        list: FormattersList<Item>;
    };
    /**
     * Returns the count of records in the list.
     *
     * Возвращает количество записей в списке.
     * @returns count of records / количество записей
     */
    length(): number;
    /**
     * Returns the current list of data as an array.
     *
     * Возвращает текущий список данных в виде массива.
     * @returns the list of data / список данных
     */
    getList(): FormattersList<Item>;
    /**
     * Returns the current formatting options.
     *
     * Возвращает текущие параметры форматирования.
     * @returns formatting options / параметры форматирования
     */
    getOptions(): Options;
    /**
     * Sets the list of data to be formatted.
     *
     * Устанавливает список данных для форматирования.
     * @param list list of data / список данных
     * @returns this instance / текущий экземпляр
     */
    setList(list?: List): this;
    /**
     * Formats the entire list or a single item based on the provided options.
     * Adds formatted values with the suffix 'Format' to each item.
     *
     * Форматирует весь список или один элемент на основе предоставленных параметров.
     * Добавляет отформатированные значения с суффиксом 'Format' к каждому элементу.
     * @returns FormattersReturn<List, Options> formatted data (list or single item) / отформатированные данные (список или один элемент)
     */
    to(): FormattersReturn<List, Options>;
    /**
     * Generates formatted data for a single item based on options.
     *
     * Генерирует отформатированные данные для одного элемента на основе параметров.
     * @param item item to format / элемент для форматирования
     * @returns object with formatted fields / объект с отформатированными полями
     * @protected
     */
    protected getFormatData(item: Item): Record<string, string>;
    /**
     * Router-like method to delegate formatting to specific type formatters.
     *
     * Метод-маршрутизатор для делегирования форматирования конкретным типам форматировщиков.
     * @param valueOriginal original value to format/ исходное значение для форматирования
     * @param item entire item context/ весь контекст элемента
     * @param type type of formatter to use/ тип используемого форматировщика
     * @param options additional options for the specific formatter / дополнительные параметры для конкретного форматировщика
     * @protected
     * @returns Formatted string / отформатированная строка
     */
    protected transformation<Type extends FormattersType>(valueOriginal: any, item: any, type?: Type, options?: FormattersOptionsInformation<Type>): string;
    /**
     * Formats a value as currency.
     *
     * Форматирует значение как валюту.
     * @param value value to format/ значение для форматирования
     * @param item item context/ контекст элемента
     * @param options currency formatting options/ параметры форматирования валюты
     * @protected
     * @returns Formatted currency string/ отформатированная строка валюты
     */
    protected formatCurrency(value: any, item: Item, options?: FormattersOptionsCurrency): string;
    /**
     * Formats a value as a date.
     *
     * Форматирует значение как дату.
     * @param value value to format/ значение для форматирования
     * @param options date formatting options/ параметры форматирования даты
     * @protected
     * @returns Formatted date string/ отформатированная строка даты
     */
    protected formatDate(value: any, options?: FormattersOptionsDate): string;
    /**
     * Formats full name from multiple property names.
     *
     * Форматирует полное имя из нескольких имен свойств.
     * @param item item context containing name components/ контекст элемента, содержащий компоненты имени
     * @param options name formatting options (prop names for first, last, surname) / параметры форматирования имени (имена свойств для имени, фамилии, отчества)
     * @protected
     * @returns Formatted name string or empty string if components are missing / отформатированная строка имени или пустая строка, если компоненты отсутствуют
     */
    protected formatName(item: Item, options?: FormattersOptionsName): string;
    /**
     * Formats a value as a number.
     *
     * Форматирует значение как число.
     * @param value value to format/ значение для форматирования
     * @param options number formatting options/ параметры форматирования числа
     * @protected
     * @returns Formatted number string/ отформатированная строка числа
     */
    protected formatNumber(value: any, options?: FormattersOptionsNumber): string;
    /**
     * Formats a value based on plural rules.
     *
     * Форматирует значение на основе правил множественного числа.
     * @param value numeric value for pluralization/ числовое значение для плюрализации
     * @param options plural formatting options (words and rules) / параметры форматирования множественного числа (слова и правила)
     * @protected
     * @returns Formatted plural string / отформатированная строка множественного числа
     */
    protected formatPlural(value: any, options?: FormattersOptionsPlural): string;
    /**
     * Formats a value with a specific unit.
     *
     * Форматирует значение с определенной единицей измерения.
     * @param value value to format/ значение для форматирования
     * @param options unit formatting options/ параметры форматирования единиц измерения
     * @protected
     * @returns Formatted unit string/ отформатированная строка единицы измерения
     */
    protected formatUnit(value: any, options?: FormattersOptionsUnit): string;
}

/**
 * Utility type to capitalize a camelCase or dot-notated string.
 *
 * Вспомогательный тип для капитализации строки.
 *
 * @template K - The string to capitalize / Строка для капитализации.
 */
export declare type FormattersCapitalize<K extends string> = K extends `${infer First}.${infer Rest}` ? `${First}${Capitalize<FormattersCapitalize<Rest>>}` : K;

/**
 * Utility type to extract column keys from formatting options.
 *
 * Вспомогательный тип для извлечения ключей столбцов.
 *
 * @template T - The formatting options list type / Тип списка параметров форматирования.
 */
export declare type FormattersColumns<T extends FormattersOptionsList> = (keyof T & string)[];

/**
 * Represents a data item with additional formatted properties.
 *
 * Представляет элемент данных с доп. отформатированными свойствами.
 *
 * @template T - The original item type / Исходный тип элемента.
 * @template KT - Array of property keys / Массив ключей свойств.
 */
export declare type FormattersDataItem<T extends FormattersListItem, KT extends string[]> = {
    [K in keyof T | FormattersKey<KT[number]>]: K extends keyof T ? T[K] : string;
};

/**
 * Extracts the single item type from a single item or a list of items.
 *
 * Извлекает тип одного элемента из одного элемента или из списка элементов.
 *
 * @template List - The type of the input data / Тип входных данных.
 */
export declare type FormattersItemProp<List extends FormattersListProp> = ArrayToItem<List>;

/**
 * Utility type to generate a formatted property key.
 *
 * Вспомогательный тип для генерации ключа отформатированного свойства.
 *
 * @template K - The original property key / Ключ исходного свойства.
 * @template A - The suffix to add / Суффикс.
 */
export declare type FormattersKey<K, A extends string = 'Format'> = K extends string ? `${FormattersCapitalize<K>}${A}` : never;

/**
 * An array of data items to be formatted.
 *
 * Массив элементов данных для форматирования.
 *
 * @template Item - The type of data items / Тип элементов данных.
 */
export declare type FormattersList<Item extends FormattersListItem> = Item[];

/**
 * A single data item formatted based on the provided options list.
 *
 * Один элемент данных, отформатированный на основе параметров.
 *
 * @template T - The original item type / Исходный тип элемента.
 * @template O - The formatting options / Параметры форматирования.
 */
export declare type FormattersListColumnItem<T extends FormattersListItem, O extends FormattersOptionsList> = FormattersDataItem<T, FormattersColumns<O>>;

/**
 * A list of data items formatted based on the provided options list.
 *
 * Список элементов данных, отформатированных на основе параметров.
 *
 * @template T - The original item type / Исходный тип элемента.
 * @template O - The formatting options / Параметры форматирования.
 */
export declare type FormattersListColumns<T extends FormattersListItem, O extends FormattersOptionsList> = FormattersListFormat<T, FormattersColumns<O>>;

/**
 * An array of data items with additional formatted properties.
 *
 * Массив элементов данных с доп. отформатированными свойствами.
 *
 * @template T - The original item type / Исходный тип элемента.
 * @template K - Array of property keys / Массив ключей свойств.
 */
export declare type FormattersListFormat<T extends FormattersListItem, K extends string[]> = FormattersDataItem<T, K>[];

/**
 * Represents a single data item as a key-value record.
 *
 * Представляет один элемент данных как запись "ключ-значение".
 */
export declare type FormattersListItem = Record<string, any>;

/**
 * Possible formats for input data: either a single item or a list of items.
 *
 * Возможные форматы входных данных: либо один элемент, либо список элементов.
 */
export declare type FormattersListProp = FormattersList<FormattersListItem> | FormattersListItem;

/**
 * Options for currency formatting.
 *
 * Параметры для форматирования валюты.
 */
export declare type FormattersOptionsCurrency = {
    /** The name of the property in the data item that contains the currency code / Имя свойства в элементе данных, которое содержит код валюты. */
    currencyPropName?: string;
    /** Currency code or international number format options / Код валюты или международные параметры форматирования чисел. */
    options?: string | Intl.NumberFormatOptions;
    /** If true, only the numeric value will be returned / Если true, будет возвращено только числовое значение. */
    numberOnly?: boolean;
};

/**
 * Options for date formatting.
 *
 * Параметры для форматирования даты.
 */
export declare type FormattersOptionsDate = {
    /** The type of date representation / Тип представления даты. */
    type?: GeoDate;
    /** International date-time format options / Междунар. параметры форматирования даты и времени. */
    options?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions;
    /** Use 24-hour format if true / Использовать 24-часовой формат, если true. */
    hour24?: boolean;
};

/**
 * Mapping of formatter types to their respective option types.
 *
 * Соответствие типов форматировщиков их типам параметров.
 *
 * @template Type - The formatter type / Тип форматировщика.
 */
export declare type FormattersOptionsInformation<Type extends FormattersType> = Type extends FormattersType.currency ? FormattersOptionsCurrency : Type extends FormattersType.date ? FormattersOptionsDate : Type extends FormattersType.name ? FormattersOptionsName : Type extends FormattersType.number ? FormattersOptionsNumber : Type extends FormattersType.plural ? FormattersOptionsPlural : Type extends FormattersType.unit ? FormattersOptionsUnit : Record<string, any>;

/**
 * Configuration for a single property formatter.
 *
 * Конфигурация для форматировщика одного свойства.
 *
 * @template Type - The type of formatter / Тип форматировщика.
 * @template R - The return type / Возвращаемый тип.
 */
export declare type FormattersOptionsItem<Type extends FormattersType = FormattersType, R = string> = {
    /** The type of formatter / Тип форматировщика. */
    type?: Type;
    /** Custom transformation function / Пользовательская функция преобразования. */
    transformation?: (valueOriginal: any, item: any, options?: FormattersOptionsInformation<Type>) => R;
    /** Options for the specified formatter type / Параметры для указанного типа форматировщика. */
    options?: FormattersOptionsInformation<Type>;
};

/**
 * A dictionary mapping property paths to their formatting configurations.
 *
 * Словарь, сопоставляющий пути к свойствам с их конфигурациями форматирования.
 */
export declare type FormattersOptionsList = Record<string, FormattersOptionsItem>;

/**
 * Options for name formatting.
 *
 * Параметры для форматирования имени.
 */
export declare type FormattersOptionsName = {
    /** Property name for the last name / Имя свойства для фамилии. */
    lastPropName?: string;
    /** Property name for the first name / Имя свойства для имени. */
    firstPropName?: string;
    /** Property name for the middle name / Имя свойства для отчества. */
    surname?: string;
    /** If true, returns a short version of the name / Если true, возвращает сокращенную версию имени. */
    short?: boolean;
};

/**
 * Options for number formatting.
 *
 * Параметры для форматирования чисел.
 */
export declare type FormattersOptionsNumber = {
    /** International number format options / Междунар. параметры форматирования чисел. */
    options?: Intl.NumberFormatOptions;
};

/**
 * Options for plural forms formatting.
 *
 * Параметры для форматирования форм множественного числа.
 */
export declare type FormattersOptionsPlural = {
    /** A string containing plural forms / Строка, содержащая формы множественного числа. */
    words: string;
    /** International plural rules options / Междунар. параметры правил множественного числа. */
    options?: Intl.PluralRulesOptions;
    /** International number format options for the numeric part / Междунар. параметры форматирования чисел для числовой части. */
    optionsNumber?: Intl.NumberFormatOptions;
};

/**
 * Options for unit formatting.
 *
 * Параметры для форматирования единиц измерения.
 */
export declare type FormattersOptionsUnit = {
    /** The unit to format or international number format options / Ед. изм. для форматирования или междунар. параметры форматирования чисел. */
    unit: string | Intl.NumberFormatOptions;
};

/**
 * The return type of the formatter, matching the structure of the input data.
 *
 * Возвращаемый тип форматировщика, соответствующий структуре входных данных.
 *
 * @template List - The input data type / Тип входных данных.
 * @template Options - The formatting options / Параметры форматирования.
 * @template Item - The type of a single item / Тип одного элемента.
 */
export declare type FormattersReturn<List extends FormattersListProp, Options extends FormattersOptionsList = FormattersOptionsList, Item extends FormattersItemProp<List> = FormattersItemProp<List>> = List extends any[] ? FormattersListColumns<Item, Options> : (FormattersListColumnItem<Item, Options> | undefined);

/**
 * Enumeration of available formatter types.
 *
 * Перечисление доступных типов форматировщиков.
 */
export declare enum FormattersType {
    /** Currency formatting / Форматирование валюты. */
    currency = "currency",
    /** Date formatting / Форматирование даты. */
    date = "date",
    /** Name formatting / Форматирование имени. */
    name = "name",
    /** Number formatting / Форматирование чисел. */
    number = "number",
    /** Plural forms formatting / Форматирование форм множественного числа. */
    plural = "plural",
    /** Unit formatting (e.g., meters, kilograms) / Форматирование единиц измерения (например, метры, килограммы). */
    unit = "unit"
}

/**
 * Cyclically calls requestAnimationFrame until next returns true.
 *
 * Циклически вызывает requestAnimationFrame, пока next возвращает true.
 * @param callback the function to call when it's time to update your animation / функция, которая будет вызвана, когда придёт время обновить вашу анимацию
 * @param next function that determines repetition / функция, которая определяет повторность
 * @param end function that is executed if the animation stops / функция, которая выполняется, если останавливается анимация
 * @returns animation ID or undefined / ID анимации или undefined
 */
export declare function frame(callback: () => void, next?: () => boolean, end?: () => void): void;

/**
 * Most generic function type that accepts any arguments and returns any value/
 * Наиболее общий тип функции
 */
export declare type FunctionAnyType<T = any, R = any> = (...args: T[]) => R;

/**
 * Function type that accepts multiple arguments of type T and returns type R/
 * Тип функции с переменными аргументами
 */
export declare type FunctionArgs<T, R> = (...args: T[]) => R;

/**
 * Generic type that can be either a direct value or a function returning that value/
 * Дженерик тип для прямого значения или функции, возвращающей это значение
 */
export declare type FunctionOr<T = any> = T | FunctionReturn<T>;

/**
 * Function type that returns a value of type R/
 * Тип функции, возвращающей значение типа R
 */
export declare type FunctionReturn<R = any> = () => R;

/** Function type that returns void/ Тип функции, возвращающей void */
export declare type FunctionVoid = () => void;

/**
 * Static class for working with geographical data.
 * Provides a centralized interface for managing locale, country, and time zone.
 *
 * Статический класс для работы с географическими данными.
 * Предоставляет централизованный интерфейс для управления локалью, страной и часовым поясом.
 */
export declare class Geo {
    /**
     * Returns a request-isolated instance of GeoInstance.
     *
     * Возвращает изолированный в рамках запроса экземпляр GeoInstance.
     * @returns GeoInstance instance / экземпляр GeoInstance
     */
    static getObject(): GeoInstance;
    /**
     * Returns information about the current country and language.
     *
     * Возвращает информацию о текущей стране и языке.
     * @returns current geo item / данные о текущей гео-позиции
     */
    static get(): GeoItemFull;
    /**
     * Returns the 2-letter code of the current country.
     *
     * Возвращает 2-буквенный код текущей страны.
     * @returns country code / код страны
     */
    static getCountry(): string;
    /**
     * Returns the 2-letter code of the current language.
     *
     * Возвращает 2-буквенный код текущего языка.
     * @returns language code / код языка
     */
    static getLanguage(): string;
    /**
     * Returns the combined locale string in the standard format (e.g., 'en-US').
     *
     * Возвращает комбинированную строку локали в стандартном формате (например, 'ru-RU').
     * @returns standard locale string / стандартная строка локали
     */
    static getStandard(): string;
    /**
     * Returns the code for the first day of the week for the current locale.
     *
     * Возвращает код первого дня недели для текущей локали.
     * @returns first day of the week / первый день недели
     */
    static getFirstDay(): string;
    /**
     * Returns the current location string.
     *
     * Возвращает текущую строку местоположения.
     * @returns location string / строка местоположения
     */
    static getLocation(): string;
    /**
     * Returns the country code extracted from the location string.
     *
     * Возвращает код страны, извлеченный из строки местоположения.
     * @returns country code / код страны
     */
    static getLocationCountry(): string;
    /**
     * Returns the language code extracted from the location string.
     *
     * Возвращает код языка, извлеченный из строки местоположения.
     * @returns language code / код языка
     */
    static getLocationLanguage(): string;
    /**
     * Returns fully processed geo data updated with the current language.
     *
     * Возвращает полностью обработанные гео-данные с учетом текущего языка.
     * @returns full geo item data / полные данные гео-объекта
     */
    static getItem(): GeoItemFull;
    /**
     * Returns the complete list of available countries and regions.
     *
     * Возвращает полный список доступных стран и регионов.
     * @returns list of geo items / список гео-объектов
     */
    static getList(): GeoItem[];
    /**
     * Returns geo data by country or language code from the global database.
     *
     * Возвращает гео-данные по коду страны или языка из глобальной базы данных.
     * @param code country or language code / код страны или языка
     * @returns full geo data / полные гео-данные
     */
    static getByCode(code?: string): GeoItemFull;
    /**
     * Returns exact geo data by searching for the full locale match (e.g., 'en-US').
     *
     * Возвращает точные гео-данные по поиску полного совпадения локали (например, 'ru-RU').
     * @param code full locale string / полная строка локали
     * @returns geo item or undefined / гео-объект или undefined
     */
    static getByCodeFull(code: string): GeoItem | undefined;
    /**
     * Returns geo data for a specific country by its code.
     *
     * Возвращает гео-данные для конкретной страны по её коду.
     * @param country country code / код страны
     * @returns geo item or undefined / гео-объект или undefined
     */
    static getByCountry(country: string): GeoItem | undefined;
    /**
     * Returns geo data for a specific language by its code.
     *
     * Возвращает гео-данные для конкретного языка по его коду.
     * @param language language code / код языка
     * @returns geo item or undefined / гео-объект или undefined
     */
    static getByLanguage(language: string): GeoItem | undefined;
    /**
     * Returns the time zone offset in minutes for the current context.
     *
     * Возвращает смещение часового пояса в минутах для текущего контекста.
     * @returns timezone offset / смещение часового пояса
     */
    static getTimezone(): number;
    /**
     * Returns the formatted time zone string (e.g., '+00:00') for the current context.
     *
     * Возвращает отформатированную строку часового пояса (например, '+03:00') для текущего контекста.
     * @returns formatted timezone / отформатированная временная зона
     */
    static getTimezoneFormat(): string;
    /**
     * Finds or determines the geo data for a given code. Alias for getByCode.
     *
     * Находит или определяет гео-данные для заданного кода. Алиас для getByCode.
     * @param code country or language code / код страны или языка
     * @returns full geo data / полные гео-данные
     */
    static find(code: string): GeoItemFull;
    /**
     * Returns a standard concatenated string for a geo item (e.g., 'en-US').
     *
     * Возвращает стандартную объединенную строку для гео-объекта (например, 'ru-RU').
     * @param item geo item data / данные гео-объекта
     * @returns standard string / стандартная строка
     */
    static toStandard(item: GeoItem): string;
    /**
     * Sets the current geographical location. Updates the instance state.
     *
     * Устанавливает текущее географическое положение. Обновляет состояние инстанса.
     * @param code location code / код локации
     * @param save whether to persist the change in storage / сохранять ли изменения в хранилище
     */
    static set(code: string, save?: boolean): void;
    /**
     * Sets a custom time zone offset for the current context.
     *
     * Устанавливает кастомное смещение часового пояса для текущего контекста.
     * @param timezone timezone offset in minutes / смещение часового пояса в минутах
     */
    static setTimezone(timezone: number): void;
    /**
     * Sets the default value for the country code.
     *
     * Устанавливает значение по умолчанию для кода страны.
     * @param code default code value / значение кода по умолчанию
     */
    static setValueDefault(code?: string | (() => string)): void;
    /**
     * Adds or updates country geo data.
     * Merges with existing country data if found, or creates a new entry.
     *
     * Добавляет или обновляет гео-данные страны.
     * Объединяет с существующими данными страны, если она найдена, или создает новую запись.
     * @param country country code (e.g., 'US', 'VN') / код страны (например, 'US', 'VN')
     * @param item partial or full geo item data / частичные или полные гео-данные
     * @returns GeoInstance instance / экземпляр GeoInstance
     */
    static add(country: string, item: Partial<GeoItem>): GeoInstance;
    /**
     * Adds or updates multiple countries in the geo list.
     *
     * Добавляет или обновляет несколько стран в гео-списке.
     * @param list map of country codes to geo items / карта кодов стран к гео-объектам
     * @returns GeoInstance instance / экземпляр GeoInstance
     */
    static addList(list: Record<string, Partial<GeoItem>>): GeoInstance;
}

export declare const GEO_FLAG_ICON_NAME = "f";

/**
 * Union type for date format options in geographic context /
 * Объединенный тип для опций формата даты в географическом контексте
 */
export declare type GeoDate = 'full' | 'datetime' | 'date' | 'year-month' | 'year' | 'month' | 'day' | 'day-month' | 'time' | 'hour-minute' | 'hour' | 'minute' | 'second';

/** First day of week code (0 = Sunday, 1 = Monday, 6 = Saturday) / Код первого дня недели (0 = воскресенье, 1 = понедельник, 6 = суббота) */
export declare type GeoFirstDay = 1 | 6 | 0;

/**
 * Class for working with flags and geographic information.
 * Provides methods for retrieving country names, languages, and flag icons.
 *
 * Класс для работы с флагами и географической информацией.
 * Предоставляет методы для получения названий стран, языков и иконок флагов.
 */
export declare class GeoFlag {
    protected code: string;
    /**
     * Mapping of country codes to flag icon names/
     * Словарь соответствия кодов стран названиям иконок флагов
     */
    static flags: Record<string, string>;
    /**
     * Constructor
     *
     * Конструктор
     * @param code country and language code / код страны и языка
     */
    constructor(code?: string);
    /**
     * Returns information about the country and its flag.
     *
     * Возвращает информацию о стране и её флаге.
     * @param code country code / код страны
     * @returns country information / информация о стране
     */
    get(code?: string): GeoFlagItem | undefined;
    /**
     * Returns information about the language and its flag.
     *
     * Возвращает информацию о языке и его флаге.
     * @param code country code / код страны
     * @returns language information / информация о языке
     */
    getLanguage(code?: string): GeoFlagItem | undefined;
    /**
     * Returns the country code.
     *
     * Возвращает код страны.
     * @returns country code / код страны
     */
    getCode(): string;
    /**
     * Returns the identifier of the flag icon.
     *
     * Возвращает идентификатор иконки флага.
     * @param code country code / код страны
     * @returns flag icon identifier / идентификатор иконки флага
     */
    getFlag(code?: string): string | undefined;
    /**
     * Returns a list of countries based on the provided codes.
     * If no codes are provided, returns all available countries.
     *
     * Возвращает список стран на основе предоставленных кодов.
     * Если коды не переданы, возвращает все доступные страны.
     * @param codes array of country codes / массив кодов стран
     * @param sort whether to sort the list / сортировать ли список
     * @returns list of countries / список стран
     */
    getList(codes?: string[], sort?: boolean): GeoFlagItem[];
    /**
     * Returns a list of languages based on the provided codes.
     * If no codes are provided, returns all available languages.
     *
     * Возвращает список языков на основе предоставленных кодов.
     * Если коды не переданы, возвращает все доступные языки.
     * @param codes array of country codes / массив кодов стран
     * @param sort whether to sort the list / сортировать ли список
     * @returns list of languages / список языков
     */
    getListLanguage(codes?: string[], sort?: boolean): GeoFlagItem[];
    /**
     * Returns a list of countries in their national languages.
     *
     * Возвращает список стран на их национальных языках.
     * @param codes array of country codes / массив кодов стран
     * @param sort whether to sort the list / сортировать ли список
     * @returns list of countries with national names / список стран с национальными названиями
     */
    getNational(codes?: string[], sort?: boolean): GeoFlagNational[];
    /**
     * Returns a list of languages in their national names.
     *
     * Возвращает список языков на их национальных названиях.
     * @param codes array of country codes / массив кодов стран
     * @param sort whether to sort the list / сортировать ли список
     * @returns list of languages with national names / список языков с национальными названиями
     */
    getNationalLanguage(codes?: string[], sort?: boolean): GeoFlagNational[];
    /**
     * Changes the current locale/location.
     *
     * Изменяет текущую локаль/местоположение.
     * @param code country and language code / код страны и языка
     * @returns this / текущий экземпляр
     */
    setCode(code: string): this;
    /**
     * Returns a special object for formatting and translations.
     *
     * Возвращает специальный объект для работы с форматированием и переводами.
     * @protected
     * @returns GeoIntl instance / экземпляр GeoIntl
     */
    protected getLocation(): GeoIntl;
    /**
     * Returns a list of country codes to retrieve data from.
     *
     * Возвращает список кодов стран для получения данных.
     * @param codes optional array of codes / опциональный массив кодов
     * @protected
     * @returns array of codes / массив кодов
     */
    protected getCodes(codes?: string[]): string[];
    /**
     * Getting the name of the language.
     *
     * Получение названия языка.
     * @param data object with information of data/ объект с информацией данных
     */
    protected getLanguageName(data: GeoItemFull): string;
    /**
     * Getting the name of the country.
     *
     * Получение названия страны.
     * @param data object with information of data/ объект с информацией данных
     */
    protected getCountry(data: GeoItemFull): string;
}

/** Geographic flag item for country flag display / Элемент географического флага для отображения флага страны */
export declare interface GeoFlagItem {
    /** Language name / Название языка */
    language: string;
    /** Language code / Код языка */
    languageCode: string;
    /** Country name / Название страны */
    country: string;
    /** Country code / Код страны */
    countryCode: string;
    /** Standard locale code / Стандартный код локали */
    standard: string;
    /** Flag icon identifier / Идентификатор иконки флага */
    icon?: string;
    /** Display label / Отображаемая метка */
    label: string;
    /** Value for selection / Значение для выбора */
    value: string;
    /** Phone country code / Телефонный код страны */
    phoneCode?: string;
}

/**
 * Extended geographic flag item with national language information /
 * Расширенный элемент географического флага с информацией о национальном языке
 */
export declare interface GeoFlagNational extends GeoFlagItem {
    /** Description in national language / Описание на национальном языке */
    description: string;
    /** Language name in national language / Название языка на национальном языке */
    nationalLanguage: string;
    /** Country name in national language / Название страны на национальном языке */
    nationalCountry: string;
}

/** Hour format type (12-hour or 24-hour) / Тип формата часов (12-часовой или 24-часовой) */
export declare type GeoHours = '12' | '24';

/**
 * Base class for working with geographic data.
 * Includes methods for determining location, language, and time zone.
 *
 * Базовый класс для работы с географическими данными.
 * Включает методы для определения местоположения, языка и часового пояса.
 */
export declare class GeoInstance {
    /**
     * List of available countries/
     * Список доступных стран
     */
    private list;
    /**
     * Data storage instance for geo code/
     * Экземпляр хранилища данных для гео-кода
     */
    private storage;
    /**
     * Current location code (e.g., 'en-GB')/
     * Текущий код локации (например, 'en-GB')
     */
    private location;
    /**
     * Value by default for the country code/
     * Значение по умолчанию для кода страны
     */
    private valueDefault?;
    /**
     * Detailed data about the current country/
     * Детальные данные о текущей стране
     */
    private item;
    /**
     * Current language code/
     * Текущий код языка
     */
    private language;
    /**
     * Current time zone offset in minutes/
     * Текущее смещение часового пояса в минутах
     */
    private timezone;
    /**
     * Constructor.
     * Initializes the location and related data.
     *
     * Конструктор.
     * Инициализирует местоположение и связанные с ним данные.
     */
    constructor();
    /**
     * Getting information about the current country.
     *
     * Получение информации о текущей стране.
     * @returns object with geo data / объект с гео-данными
     */
    get(): GeoItemFull;
    /**
     * Getting the current country code.
     *
     * Получение текущего кода страны.
     * @returns country code / код страны
     */
    getCountry(): string;
    /**
     * Getting the current language code.
     *
     * Получение текущего кода языка.
     * @returns language code / код языка
     */
    getLanguage(): string;
    /**
     * Getting the full format according to the standard (language-country).
     *
     * Получение полного формата согласно стандарту (язык-страна).
     * @returns standard string / строка стандарта
     */
    getStandard(): string;
    /**
     * Getting the first day of the week for the current country.
     *
     * Получение первого дня недели для текущей страны.
     * @returns first day of the week / первый день недели
     */
    getFirstDay(): string;
    /**
     * Getting the current location string.
     *
     * Получение строки текущего местоположения.
     * @returns location string / строка местоположения
     */
    getLocation(): string;
    /**
     * Getting the country code from the location.
     *
     * Получение кода страны из местоположения.
     * @returns country code / код страны
     */
    getLocationCountry(): string;
    /**
     * Getting the language code from the location.
     *
     * Получение кода языка из местоположения.
     * @returns language code / код языка
     */
    getLocationLanguage(): string;
    /**
     * Getting processed data including the current language.
     *
     * Получение обработанных данных, включая текущий язык.
     * @returns full geo item data / полные данные гео-объекта
     */
    getItem(): GeoItemFull;
    /**
     * Returns the full list of available countries.
     *
     * Возвращает полный список доступных стран.
     * @returns list of geo items / список гео-объектов
     */
    getList(): GeoItem[];
    /**
     * Returns data about the country by its code.
     *
     * Возвращает данные о стране по ее коду.
     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
     * @returns full geo data / полные гео-данные
     */
    getByCode(code?: string): GeoItemFull;
    /**
     * Returns full data by language and country combination.
     *
     * Возвращает полные данные по комбинации языка и страны.
     * @param code string in the form of language-country / строка в виде язык-страна
     * @returns geo item or undefined / гео-объект или undefined
     */
    getByCodeFull(code: string): GeoItem | undefined;
    /**
     * Returns full data by country code.
     *
     * Возвращает полные данные по коду страны.
     * @param country country code / код страны
     * @returns geo item or undefined / гео-объект или undefined
     */
    getByCountry(country: string): GeoItem | undefined;
    /**
     * Returns full data by language code.
     *
     * Возвращает полные данные по коду языка.
     * @param language language code / код языка
     * @returns geo item or undefined / гео-объект или undefined
     */
    getByLanguage(language: string): GeoItem | undefined;
    /**
     * Returns the current time zone offset in minutes.
     *
     * Возвращает текущее смещение часового пояса в минутах.
     * @returns timezone offset / смещение часового пояса
     */
    getTimezone(): number;
    /**
     * Returns the current time zone offset in a formatted string (e.g., '+03:00').
     *
     * Возвращает текущее смещение часового пояса в виде отформатированной строки (например, '+03:00').
     * @returns formatted timezone string / отформатированная строка часового пояса
     */
    getTimezoneFormat(): string;
    /**
     * Finds the country data by its code or name.
     *
     * Ищет данные о стране по ее коду или названию.
     * @param code country code / код страны
     * @returns full geo data / полные гео-данные
     */
    find(code: string): GeoItemFull;
    /**
     * Converts a geo item to its standard string representation (language-country).
     *
     * Преобразует гео-объект в его стандартное строковое представление (язык-страна).
     * @param item geo item data / данные гео-объекта
     * @param language optional language override / опциональное переопределение языка
     * @returns standard code string / строка стандартного кода
     */
    toStandard(item: GeoItem, language?: string): string;
    /**
     * Updates the current location and related data.
     *
     * Обновляет текущее местоположение и связанные с ним данные.
     * @param code location code (e.g., 'en-GB') / код локации (например, 'en-GB')
     * @param save whether to save the location in storage / нужно ли сохранять местоположение в хранилище
     */
    set(code: string, save?: boolean): void;
    /**
     * Updates the default time zone offset.
     *
     * Обновляет смещение часового пояса по умолчанию.
     * @param timezone new time zone offset / новое смещение часового пояса
     */
    setTimezone(timezone: number): void;
    /**
     * Sets the default value for the country code.
     *
     * Устанавливает значение по умолчанию для кода страны.
     * @param code default code value / значение кода по умолчанию
     */
    setValueDefault(code?: string | (() => string)): void;
    /**
     * Adds or updates country geo data.
     * Merges with existing country data if found, or creates a new entry.
     *
     * Добавляет или обновляет гео-данные страны.
     * Объединяет с существующими данными страны, если она найдена, или создает новую запись.
     * @param country country code (e.g., 'US', 'VN') / код страны (например, 'US', 'VN')
     * @param item partial or full geo item data / частичные или полные гео-данные
     * @returns current instance / текущий экземпляр
     */
    add(country: string, item: Partial<GeoItem>): this;
    /**
     * Adds or updates multiple countries in the geo list.
     *
     * Добавляет или обновляет несколько стран в гео-списке.
     * @param list map of country codes to geo items / карта кодов стран к гео-объектам
     * @returns current instance / текущий экземпляр
     */
    addList(list: Record<string, Partial<GeoItem>>): this;
    /**
     * Internal method to get the geo cookie instance.
     *
     * Внутренний метод для получения экземпляра гео-куки.
     * @returns Cookie instance for geo code / экземпляр куки для гео-кода
     */
    private getCookie;
    /**
     * Internal method to determine the initial location.
     *
     * Внутренний метод для определения начального местоположения.
     * @returns initial location code / начальный код локации
     */
    private findLocation;
    /**
     * Internal method to determine the location from DOM-specific sources.
     * Returns an empty string (falsy) when not in a DOM runtime.
     *
     * Внутренний метод для определения местоположения из DOM-источников.
     * Возвращает пустую строку (falsy) вне DOM-окружения.
     * @returns location code from DOM or empty string / код локации из DOM или пустая строка
     */
    private findLocationDom;
    /**
     * Internal method to determine the language from the provided code.
     *
     * Внутренний метод для определения языка по предоставленному коду.
     * @param code location or language code / код локации или языка
     * @returns language code / код языка
     */
    private findLanguage;
    /**
     * Internal method to extract country code from a location string.
     *
     * Внутренний метод для извлечения кода страны из строки локации.
     * @param code combined string / комбинированная строка
     * @returns country code / код страны
     */
    private toCountry;
    /**
     * Internal method to extract language code from a location string.
     *
     * Внутренний метод для извлечения кода языка из строки локации.
     * @param code combined string / комбинированная строка
     * @returns language code / код языка
     */
    private toLanguage;
    /**
     * Internal method to fill missing fields in a geo item.
     *
     * Внутренний метод для заполнения отсутствующих полей в гео-объекте.
     * @param item basic geo item / базовый гео-объект
     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
     * @returns full geo item data / полные данные гео-объекта
     */
    private toFull;
}

/**
 * The Intl namespace object contains several constructors as well as functionality common
 * to the internationalization constructors and other language sensitive functions. Collectively,
 * they comprise the ECMAScript Internationalization API, which provides language sensitive
 * string comparison, number formatting, date and time formatting, and more
 *
 * Объект Intl является пространством имён для API интернационализации ECMАСcript, предоставляющим
 * языка-зависимое сравнение строк, форматирование чисел и дат со временем. Конструкторы объектов
 * Collator, NumberFormat и DateTimeFormat являются свойствами объекта Intl. На этой странице
 * описаны эти свойства, а также общая функциональность конструкторов интернационализации и других
 * языка-зависимых функций
 */
export declare class GeoIntl {
    private errorCenter;
    /**
     * Checks if an instance of the class exists for the specified country code.
     *
     * Проверяет, существует ли экземпляр класса для указанного кода страны.
     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
     */
    static isItem(code?: string): boolean;
    /**
     * Returns the standard location code.
     *
     * Возвращает стандартный код местоположения.
     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
     */
    static getLocation(code?: string): string;
    /**
     * Returns an instance of the class according to the specified country code.
     *
     * Возвращает экземпляр класса по указанному коду страны.
     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
     */
    static getInstance(code?: string): GeoIntl;
    /** Full geo item data / Полные данные гео-объекта */
    private readonly geo;
    /**
     * Constructor
     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
     * @param errorCenter error center instance/ экземпляр центра ошибок
     */
    constructor(code?: string, errorCenter?: ErrorCenterInstance);
    /**
     * Returns country code and language.
     *
     * Возвращает код страны и языка.
     */
    getLocation(): string;
    /**
     * Returns the first day of the week.
     *
     * Возвращает первый день недели.
     */
    getFirstDay(): string;
    /**
     * The consistent translation of language, region and script display names.
     *
     * Последовательный перевод отображаемых названий языка, региона и скрипта.
     * @param value the code to provide depends on the type / предоставляемый код зависит от типа
     * @param typeOptions an object with some or all of the following properties / объект с некоторыми или всеми из следующих свойств
     */
    display(value?: string, typeOptions?: Intl.DisplayNamesOptions['type'] | Intl.DisplayNamesOptions): string;
    /**
     * Get display names of language.
     *
     * Получить отображаемые имена языка.
     * @param value the code to provide depends on the type/ предоставляемый код зависит от типа
     * @param style the formatting style to display names/ используемый стиль отображения имен
     * @returns display name of language/ отображаемое имя языка
     */
    languageName(value?: string, style?: Intl.RelativeTimeFormatStyle): string;
    /**
     * Get display names of region.
     *
     * Получить отображаемые имена региона.
     * @param value the code to provide depends on the type/ предоставляемый код зависит от типа
     * @param style the formatting style to display names/ используемый стиль отображения имен
     * @returns display name of region/ отображаемое имя региона
     */
    countryName(value?: string, style?: Intl.RelativeTimeFormatStyle): string;
    /**
     * The method returns a string containing the full name in a specific format.
     *
     * Метод возвращает строку, содержащую полное имя в определённом формате.
     * @param last last name/ фамилию
     * @param first first name/ имя
     * @param surname surname middle name (optional)/ отчество
     * @param short shorten the names/ сократить названия
     */
    fullName(last: string, first: string, surname?: string, short?: boolean): string;
    /**
     * In basic use without specifying a locale, a formatted string.
     *
     * При обычном использовании без указания локали форматированная строка.
     * @param value a number, bigint, or string, to format/ число для форматирования
     * @param options an object with some or all properties/ объект с некоторыми
     * или всеми свойствами
     */
    number(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Decimal point symbol.
     *
     * Символ десятичной точки.
     */
    decimal(): string;
    /**
     * Currency formatting.
     *
     * Форматирование валюты.
     * @param value a number, bigint, or string, to format / число для форматирования
     * @param currencyOptions the currency to use in currency formatting / валюта для использования в форматировании валюты
     * @param numberOnly do not display the currency symbol / не выводить значок валюты
     */
    currency(value: NumberOrString, currencyOptions?: string | Intl.NumberFormatOptions, numberOnly?: boolean): string;
    /**
     * Returns the currency symbol if it exists, otherwise the currency code.
     *
     * Возвращает символ для валюты, если он есть, или сам код валюты.
     * @param currency the currency to use in currency formatting / валюта для использования в форматировании валюты
     * @param currencyDisplay how to display the currency in currency formatting / как отобразить валюту в формате валюты
     */
    currencySymbol(currency: string, currencyDisplay?: keyof Intl.NumberFormatOptionsCurrencyDisplayRegistry): string;
    /**
     * Unit formatting.
     * If the style is 'unit', a unit property must be provided.
     *
     * Форматирование юнитов.
     * @param value a number, bigint, or string, to format/ число для форматирования
     * @param unitOptions the unit to use in unit formatting/ блок для использования
     * в форматировании блока
     */
    unit(value: NumberOrString, unitOptions?: string | Intl.NumberFormatOptions): string;
    /**
     * Возвращает отформатированный размер файла
     * @param value a number, bigint, or string, to format /<br>число для форматирования
     * @param unitOptions the unit to use in unit formatting /<br>блок для использования
     * в форматировании блока
     */
    sizeFile(value: NumberOrString, unitOptions?: 'byte' | 'kilobyte' | 'megabyte' | 'gigabyte' | 'terabyte' | 'petabyte' | Intl.NumberFormatOptions): string;
    /**
     * Number as a percentage.
     *
     * Число в виде процента.
     * @param value a number, bigint, or string, to format/ число для форматирования
     * @param options an object with some or all properties/ объект с некоторыми или всеми свойствами
     */
    percent(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Number as a percentage (unit).
     *
     * Число в виде процента (единица).
     * @param value a number, bigint, or string, to format / число для форматирования
     * @param options an object with some or all properties / объект с некоторыми или всеми свойствами
     */
    percentBy100(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Применять форматирование, учитывающее множественное число, и языковые правила, связанные с множественным числом
     * @param value a number, bigint, or string, to format / число для форматирования
     * @param words list of words for formatting (in the format one|two|few|many|other|zero) / список слов для форматирования (в формате `one|two|few|many|other|zero`)
     * @param options Property for PluralRules/ свойство для PluralRules
     * @param optionsNumber an object with some or all properties/ объект с некоторыми или всеми свойствами
     */
    plural(value: NumberOrString, words: string, options?: Intl.PluralRulesOptions, optionsNumber?: Intl.NumberFormatOptions): string;
    /**
     * Enables language-sensitive date and time formatting.
     *
     * Конструктором объектов, включающих языка-зависимое форматирование даты и времени.
     * @param value the date to format/ дата для форматирования
     * @param type type of data format/ тип формата data
     * @param styleOptions the representation of the month/ представление месяца
     * @param hour24 whether to use 12-hour time/ использовать ли 12-часовое время
     * @returns formatted date and time/ отформатированная дата и время
     */
    date(value: NumberOrStringOrDate, type?: GeoDate, styleOptions?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions, hour24?: boolean): string;
    /**
     * Enables language-sensitive relative time formatting.
     *
     * Включает форматирование относительного времени с учетом языка.
     * @param value a number, bigint, or string, to format / число для форматирования
     * @param styleOptions the length of the internationalized message / длина интернационализированного сообщения
     * @param todayValue current day/ текущий день
     * @returns formatted relative time/ отформатированное относительное время
     */
    relative(value: NumberOrStringOrDate, styleOptions?: Intl.RelativeTimeFormatStyle | Intl.RelativeTimeFormatOptions, todayValue?: Date): string;
    /**
     * Enables language-sensitive relative time formatting
     * Including the ability to add a limit to output the standard time format if the value
     * exceeds the allowable limit.
     *
     * Включает форматирование относительного времени с учетом языка.
     * Включая возможность добавления лимита, чтобы выводить уже стандартный формат времени,
     * если значение вышло за пределы допустимого.
     * @param value a number, bigint, or string, to format / число для форматирования
     * @param limit values that determine the output limit (values per day) / значения, по которым определяем предел вывода (значения в день)
     * @param todayValue current day / текущий день
     * @param relativeOptions the length of the internationalized message / длина интернационализированного сообщения
     * @param dateOptions the representation of the month/ представление месяца
     * @param type type of data format/ тип формата data
     * @param hour24 whether to use 12-hour time/ использовать ли 12-часовое время
     */
    relativeLimit(value: NumberOrStringOrDate, limit: number, todayValue?: Date, relativeOptions?: Intl.RelativeTimeFormatStyle | Intl.RelativeTimeFormatOptions, dateOptions?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions, type?: GeoDate, hour24?: boolean): string;
    /**
     * Возвращает отформатированное значение времени, прошедшего с момента события
     * @param value a number, bigint, or string, to format/ число для форматирования
     * @param unit time unit/ единица времени
     * @param styleOptions additional option or formatting style/ дополнительная опция или стиль форматирования
     */
    relativeByValue(value: NumberOrString, unit: Intl.RelativeTimeFormatUnit, styleOptions?: Intl.RelativeTimeFormatStyle | Intl.RelativeTimeFormatOptions): string;
    /**
     * Names of months.
     *
     * Названия месяцев.
     * @param value the date to format/ дата для форматирования
     * @param style the representation of the month/ представление месяца
     * @returns month name/ название месяца
     */
    month(value?: NumberOrStringOrDate, style?: Intl.DateTimeFormatOptions['month']): string;
    /**
     * Array to list of months.
     *
     * Массив в список месяцев.
     * @param style the representation of the month/ представление месяца
     * @returns list of months (1-12)/ список месяцев (1-12)
     */
    months(style?: Intl.DateTimeFormatOptions['month']): ItemValue<number | undefined>[];
    /**
     * Returns names of days of the week.
     *
     * Возвращает названия дней недели.
     * @param value the date to format/ дата для форматирования
     * @param style the representation of the weekday/ представление о дне недели
     * @returns weekday name/ название дня недели
     */
    weekday(value?: NumberOrStringOrDate, style?: Intl.DateTimeFormatOptions['weekday']): string;
    /**
     * Array of the list of names of the days of the week.
     *
     * Массив из списка названий дней недели.
     * @param style the representation of the weekday/ представление о дне недели
     * @returns list of weekdays (0-6)/ список дней недели (0-6)
     */
    weekdays(style?: Intl.DateTimeFormatOptions['weekday']): ItemValue<number | undefined>[];
    /**
     * Time.
     *
     * Время.
     * @param value the date to format/ дата для форматирования
     * @returns formatted time/ отформатированное время
     */
    time(value: NumberOrStringOrDate): string;
    /**
     * Sorts strings taking into account the characteristics of countries.
     *
     * Сортирует строки с учетом особенностей стран.
     * @param data an array with data/ массив с данными
     * @param compareFn a function for sorting/ функция для сортировки
     * @returns sorted array/ отсортированный массив
     */
    sort<T>(data: T[], compareFn?: (a: T, b: T) => [string, string]): T[];
    /**
     * Checks if the Intl object is available.
     *
     * Проверяет доступность объекта Intl.
     */
    private hasIntl;
    /**
     * Checks if the Intl.DateTimeFormat object is available.
     *
     * Проверяет доступность объекта Intl.DateTimeFormat.
     */
    private hasIntlDateTimeFormat;
    /**
     * The object enables language-sensitive number formatting.
     *
     * Объект включает форматирование чисел с учетом языка.
     * @param options an object with some or all properties / объект с некоторыми или всеми свойствами
     */
    private numberObject;
    /**
     * Returns options for data according to its type.
     *
     * Возвращает options для data по его типу.
     * @param type type of data format/ тип формата data
     * @param display the representation of the month/ представление месяца
     */
    private dateOptions;
}

/** Geographic item interface for country and language data / Интерфейс географического элемента для данных страны и языка */
export declare interface GeoItem {
    /** Country code / Код страны */
    country: string;
    /** Alternative country codes / Альтернативные коды стран */
    countryAlternative?: string[];
    /** Language code / Код языка */
    language: string;
    /** Alternative language codes / Альтернативные коды языков */
    languageAlternative?: string[];
    /** First day of week / Первый день недели */
    firstDay?: string | null;
    /** Timezone / Часовой пояс */
    zone?: string | null;
    /** Phone country code / Телефонный код страны */
    phoneCode?: string;
    /** Phone code for domestic calls / Телефонный код для внутренних звонков */
    phoneWithin?: string;
    /** Phone number mask / Маска телефонного номера */
    phoneMask?: string | string[];
    /** Name format pattern / Шаблон формата имени */
    nameFormat?: 'fl' | 'fsl' | 'lf' | 'lsf' | string;
    /** Units of measurement configuration / Конфигурация единиц измерения */
    unit?: {
        /** Millimeter unit format or symbol / Формат или символ единицы измерения миллиметра */
        'millimeter'?: string;
        /** Centimeter unit format or symbol / Формат или символ единицы измерения сантиметра */
        'centimeter'?: string;
        /** Meter unit format or symbol / Формат или символ единицы измерения метра */
        'meter'?: string;
        /** Kilometer unit format or symbol / Формат или символ единицы измерения километра */
        'kilometer'?: string;
        /** Square meter unit format or symbol / Формат или символ единицы измерения квадратного метра */
        'square-meter'?: string;
        /** Hectare unit format or symbol / Формат или символ единицы измерения гектара */
        'hectare'?: string;
        /** Gram unit format or symbol / Формат или символ единицы измерения грамма */
        'gram'?: string;
        /** Kilogram unit format or symbol / Формат или символ единицы измерения килограмма */
        'kilogram'?: string;
        /** Tonne unit format or symbol / Формат или символ единицы измерения тонны */
        'tonne'?: string;
        /** Milliliter unit format or symbol / Формат или символ единицы измерения миллилитра */
        'milliliter'?: string;
        /** Liter unit format or symbol / Формат или символ единицы измерения литра */
        'liter'?: string;
        /** Celsius unit format or symbol / Формат или символ единицы измерения градуса Цельсия */
        'celsius'?: string;
        /** Kilometer per hour unit format or symbol / Формат или символ единицы измерения километра в час */
        'kilometer-per-hour'?: string;
    };
}

/** Extended geographic item with required fields / Расширенный географический элемент с обязательными полями */
export declare interface GeoItemFull extends Omit<GeoItem, 'firstDay'> {
    /** Standard locale code / Стандартный код локали */
    standard: string;
    /** First day of week (required) / Первый день недели (обязательный) */
    firstDay: string;
    /** Current location string / Строка текущего местоположения */
    location: string;
    /** Current country code from location / Текущий код страны из местоположения */
    locationCountry: string;
    /** Current language code from location / Текущий код языка из местоположения */
    locationLanguage: string;
}

/**
 * A class for storing and processing phone number masks.
 *
 * Класс для хранения и обработка маски телефона.
 */
export declare class GeoPhone {
    /** Phone masks list / Список масок телефонов */
    protected static list?: GeoPhoneValue[];
    /** Phone codes map / Карта телефонных кодов */
    protected static map?: Record<string, GeoPhoneMap>;
    /**
     * Getting an object with information about the phone code and country.
     *
     * Получение объекта с информацией о телефонном коде и стране.
     * @param code country and language code/ код страны и языка
     */
    static get(code: string): GeoPhoneValue | undefined;
    /**
     * Getting information by phone.
     *
     * Получение информации по телефону.
     * @param phone phone number/ номер телефон
     */
    static getByPhone(phone: string): GeoPhoneMapInfo;
    /**
     * Retrieves complete mask data by country code.
     *
     * Получает полные данные о маске по коду страны.
     * @param code country and language code/ код страны и языка
     */
    static getByCode(code: string): GeoPhoneMap | undefined;
    /**
     * We get an array from a list of all phone numbers.
     *
     * Получаем массив из списка всех телефонных кодов.
     */
    static getList(): GeoPhoneValue[];
    /**
     * We get a map of a tree, sorted by its code.
     *
     * Получаем карту дерева, отсортированную по его коду.
     */
    static getMap(): Record<string, GeoPhoneMap>;
    /**
     * Convert to phone mask.
     *
     * Преобразовать в маску телефона.
     * @param phone phone number/ номер телефон
     * @param masks a mask to transform a phone number/ маска для преобразования номер телефон
     */
    static toMask(phone: string, masks?: string[]): string | undefined;
    /**
     * Deletes the country code from the input number.
     *
     * Удаляет код страны по входному номеру.
     * @param phone phone number/ номер телефон
     */
    static removeZero(phone: string): string;
    /**
     * Returns the symbol by the internal country code.
     *
     * Возвращает символ по коду внутри страны.
     * @param within internal country code/ код внутри страны
     */
    protected static getWithinSymbol(within: number | string): string;
    /**
     * Deletes all characters that do not belong to the mask.
     *
     * Удаляет все символы, не относящиеся к маске.
     * @param mask A mask to transform a phone number/ маска для преобразования номер телефон
     */
    protected static getUnnecessaryLength(mask: string): number;
    /**
     * Creating a list for the map.
     *
     * Формирование списка данных.
     */
    protected static makeList(): void;
    /**
     * Creating a map for search.
     *
     * Создание карты для поиска.
     */
    protected static makeMap(): void;
    /**
     * The method parses a string argument and returns an array of numbers as strings.
     *
     * Метод принимает строку в качестве аргумента и возвращает массив цифр в виде строк.
     * @param value the value to parse/ текстовая строка
     * @returns array of numbers/ массив цифр
     */
    protected static toNumber(value: string): string[];
    /**
     * Converts the phone to a standard.
     *
     * Преобразовывает телефон в стандарт.
     * @param phone phone number/ номер телефон
     * @param mask a mask to transform a phone number/ маска для преобразования номер телефон
     */
    protected static toStandard(phone: string, mask: string): string;
    /**
     * Replaces the first character with the internal country code
     *
     * Заменяет первый символ на код внутри страны.
     * @param mask a mask to transform a phone number/ маска для преобразования номер телефон
     * @param within internal country code/ код внутри страны
     */
    protected static toWithin(mask: string, within: number | string): string;
}

/** Node in the internal phone prefix tree (Trie) / Узел внутреннего префиксного дерева телефонов (Trie) */
export declare interface GeoPhoneMap {
    /** List of all items available in this branch of the tree / Список всех элементов, доступных в данной ветви дерева */
    items: GeoPhoneValue[];
    /** Phone metadata if the current node is a complete code / Метаданные телефона, если текущий узел является завершенным кодом */
    info: GeoPhoneValue | undefined;
    /** Country identifier for this node / Идентификатор страны для данного узла */
    value: string | undefined;
    /** Array of masks with substituted internal symbols / Массив масок с подставленными спецсимволами */
    mask: string[];
    /** Full masks including the international code / Полные маски, включая международный код */
    maskFull: string[];
    /** Pointers to the next digits in the search tree / Указатели на следующие цифры номера в дереве поиска */
    next: Record<string, GeoPhoneMap>;
}

/** Result of searching a country by phone number / Результат поиска страны по номеру телефона */
export declare interface GeoPhoneMapInfo {
    /** The found tree node with country and mask information / Найденный узел дерева с информацией о стране и масках */
    item?: GeoPhoneMap;
    /** The remaining part of the number after separating the country code / Оставшаяся часть номера после отделения кода страны */
    phone?: string;
}

/** Phone configuration metadata for a country / Структура метаданных для конфигурации телефона страны */
export declare interface GeoPhoneValue {
    /** Phone country code (e.g., 7) / Телефонный код страны (например, 7) */
    phone: number;
    /** Internal dialing rule code / Код внутреннего правила набора */
    within: number;
    /** Array of mask patterns assigned to the country / Массив паттернов масок, закрепленных за страной */
    mask: string[];
    /** Country identifier (ISO 3166) / Идентификатор страны (ISO 3166) */
    value: string;
}

/** Timezone display style options / Опции стиля отображения часового пояса */
export declare type GeoTimeZoneStyle = 'minute' | 'hour' | 'ISO8601' | 'RFC';

/**
 * Class for localized unit formatting and automatic conversions.
 * Automatically translates metric units (like gram, meter) to local equivalents
 * (like ounce, foot) for non-metric regions (US, MM, LR) and formats them.
 *
 * Класс для локализованного форматирования единиц измерения и автоматической конвертации.
 * Автоматически преобразует метрические единицы (такие как грамм, метр) в локальные аналоги
 * (такие как унция, фут) для неметрических регионов (США, Мьянма, Либерия) и форматирует их.
 */
export declare class GeoUnit {
    /** Detailed data about the current country / Детальные данные о текущей стране */
    protected readonly geo: GeoItemFull;
    /**
     * Returns a request-isolated instance of GeoUnit or cached instance.
     *
     * Возвращает изолированный в рамках запроса экземпляр GeoUnit или кэшированный экземпляр.
     * @param code country or language code / код страны или языка
     * @returns GeoUnit instance / экземпляр GeoUnit
     */
    static getInstance(code?: string): GeoUnit;
    /**
     * Constructor.
     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
     */
    constructor(code?: string);
    /**
     * Returns the standard location code.
     *
     * Возвращает стандартный код местоположения.
     * @returns standard location code / стандартный код местоположения
     */
    getLocation(): string;
    /**
     * Formats millimeter value, converting to inches if overridden by locale unit settings.
     *
     * Форматирует значение в миллиметрах, конвертируя в дюймы, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    millimeter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats centimeter value, converting to inches if overridden by locale unit settings.
     *
     * Форматирует значение в сантиметрах, конвертируя в дюймы, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    centimeter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats meter value, converting to feet if overridden by locale unit settings.
     *
     * Форматирует значение в метрах, конвертируя в футы, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    meter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats kilometer value, converting to miles if overridden by locale unit settings.
     *
     * Форматирует значение в километрах, конвертируя в мили, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    kilometer(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats square meter value, converting to square feet if overridden by locale unit settings.
     *
     * Форматирует значение в квадратных метрах, конвертируя в квадратные футы, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    squareMeter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats hectare value, converting to acres if overridden by locale unit settings.
     *
     * Форматирует значение в гектарах, конвертируя в акры, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    hectare(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats gram value, converting to ounces if overridden by locale unit settings.
     *
     * Форматирует значение в граммах, конвертируя в унции, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    gram(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats kilogram value, converting to pounds if overridden by locale unit settings.
     *
     * Форматирует значение в килограммах, конвертируя в фунты, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    kilogram(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats tonne value, converting to short tons if overridden by locale unit settings.
     *
     * Форматирует значение в тоннах, конвертируя в короткие тонны, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    tonne(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats milliliter value, converting to fluid ounces if overridden by locale unit settings.
     *
     * Форматирует значение в миллилитрах, конвертируя в жидкие унции, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    milliliter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats liter value, converting to gallons if overridden by locale unit settings.
     *
     * Форматирует значение в литрах, конвертируя в галлоны, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    liter(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats celsius value, converting to fahrenheit if overridden by locale unit settings.
     *
     * Форматирует значение в градусах Цельсия, конвертируя в градусы Фаренгейта, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    celsius(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats kilometer per hour value, converting to miles per hour if overridden by locale unit settings.
     *
     * Форматирует значение в километрах в час, конвертируя в мили в час, если это переопределено настройками локали.
     * @param value numeric value to format / числовое значение для форматирования
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    kilometerPerHour(value: NumberOrString, options?: Intl.NumberFormatOptions): string;
    /**
     * Formats the value for the specified unit, converting and formatting it according to the locale.
     *
     * Форматирует значение для указанной единицы измерения, преобразуя и форматируя его в соответствии с локалью.
     * @param value numeric value to format / числовое значение для форматирования
     * @param unit unit of measurement / единица измерения
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string or original value / отформатированная строка или исходное значение
     */
    format(value: NumberOrString, unit: string, options?: Intl.NumberFormatOptions): string;
    /**
     * Checks if the conversion is from Celsius to Fahrenheit.
     *
     * Проверяет, является ли конвертация переходом из градусов Цельсия в градусы Фаренгейта.
     * @param from source unit identifier / исходный идентификатор единицы измерения
     * @param to target unit identifier / целевой идентификатор единицы измерения
     * @returns true if conversion is Celsius to Fahrenheit / true, если конвертация из Цельсия в Фаренгейт
     */
    protected isCelsiusToFahrenheit(from: string, to: string): boolean;
    /**
     * Retrieves the target unit configured for the given source unit.
     *
     * Получает целевую единицу измерения, настроенную для заданной исходной единицы измерения.
     * @param sourceUnit metric unit identifier / метрический идентификатор единицы измерения
     * @returns target unit identifier / целевой идентификатор единицы измерения
     */
    protected getTargetUnit(sourceUnit: string): string;
    /**
     * Internal helper method to perform unit conversion and formatting.
     *
     * Внутренний вспомогательный метод для выполнения конвертации и форматирования единиц измерения.
     * @param value value to format / значение для форматирования
     * @param sourceUnit metric unit identifier / метрический идентификатор единицы измерения
     * @param options formatting options / параметры форматирования
     * @returns formatted unit string / отформатированная строка единицы измерения
     */
    protected formatUnit(value: NumberOrString, sourceUnit: string, options?: Intl.NumberFormatOptions): string;
    /**
     * Performs conversion between units.
     *
     * Выполняет конвертацию между единицами измерения.
     * @param value value to convert / значение для конвертации
     * @param from source unit identifier / исходный идентификатор единицы измерения
     * @param to target unit identifier / целевой идентификатор единицы измерения
     * @returns converted value / сконвертированное значение
     */
    protected convert(value: number, from: string, to: string): number;
    /**
     * Converts temperature value from Celsius to Fahrenheit.
     *
     * Конвертирует значение температуры из градусов Цельсия в градусы Фаренгейта.
     * @param value temperature value in Celsius / значение температуры в градусах Цельсия
     * @returns temperature value in Fahrenheit / значение температуры в градусах Фаренгейта
     */
    protected celsiusToFahrenheit(value: number): number;
}

/**
 * Split a string into an array of objects to highlight matches.
 *
 * Разделяет строку на массив объектов для выделения совпадений.
 * @param value initial string / исходная строка
 * @param search search string / строка поиска
 * @returns array of objects with text and match flag / массив объектов с текстом и флагом совпадения
 */
export declare function getArrayHighlightMatch(value: string, search?: string | RegExp): HighlightMatchItem[];

/**
 * Gets a list of attributes of an element.
 *
 * Получает список атрибутов у элемента.
 * @param element selectors for matching or an Element / селекторов для сопоставления или Element
 * @returns list of attributes / список атрибутов
 */
export declare function getAttributes<E extends ElementOrWindow>(element?: ElementOrString<E>): Record<string, string | undefined>;

/**
 * The method retrieves drag data (as a string) for the specified type.
 * If the drag operation does not include data, this method returns an empty string.
 *
 * Метод извлекает данные перетаскивания (в виде строки) для указанного типа.
 * @param event the ClipboardEvent interface / интерфейс ClipboardEvent
 * @returns data from the clipboard / данные из буфера обмена
 */
export declare function getClipboardData(event?: ClipboardEvent): Promise<string>;

/**
 * Returns an array of values for a specific column in the input array.
 *
 * Возвращает массив значений для определенного столбца входного массива.
 * @param array a multi-dimensional array or an array of objects / многомерный массив или массив объектов
 * @param column the column of values to return / ключ столбца, значения которого нужно вернуть
 * @returns list of values for the column / список значений для столбца
 */
export declare function getColumn<T, K extends keyof T>(array: ObjectOrArray<T>, column: K): (T[K] | undefined)[];

/**
 * Returns the current date in the specified format.
 *
 * Возвращает текущую дату в указанном формате.
 *
 * @remarks
 * Using this function for rendering in SSR may lead to hydration mismatches
 * because the time or time zone on the server may differ from the time on the client.
 * It is recommended to use this function inside client-side hooks only (e.g., `onMounted` in Vue or `useEffect` in React).
 *
 * Использование этой функции для отрисовки в SSR может привести к ошибкам гидратации,
 * так как время или часовой пояс сервера могут отличаться от времени на стороне клиента.
 * Рекомендуется использовать эту функцию только внутри хуков, выполняющихся на клиенте (например, `onMounted` в Vue или `useEffect` in React).
 *
 * @param format type of date format for output / тип формата даты вывода
 * @returns formatted current date / текущая дата в указанном формате
 */
export declare function getCurrentDate(format?: GeoDate): string;

/**
 * Returns the current time in milliseconds.
 *
 * Возвращает текущее время в миллисекундах.
 *
 * @remarks
 * **Warning (SSR):** Using this function for rendering in SSR will almost certainly lead to hydration mismatches
 * because the timestamp on the server will differ from the timestamp on the client.
 *
 * **Внимание (SSR):** Использование этой функции для отрисовки в SSR практически наверняка приведет к ошибкам гидратации,
 * так как временная метка (timestamp) сервера будет отличаться от метки на стороне клиента.
 *
 * @returns current time in milliseconds / текущее время в миллисекундах
 */
export declare function getCurrentTime(): number;

/**
 * Returns the first Element in the document that matches the specified selector or the element.
 *
 * Возвращает первый Element документа, который соответствует указанному селектору или сам элемент.
 * @param element selectors for matching or an Element / селектор для сопоставления или Element
 * @returns found element or undefined / найденный элемент или undefined
 */
export declare function getElement<E extends ElementOrWindow, R extends Exclude<E, Window>>(element?: ElementOrString<E>): R | undefined;

/**
 * Returns the identifier (ID) of the element or creates it if the element has no ID.
 *
 * Возвращает идентификатор (ID) элемента или создает его, если у элемента нет ID.
 * @param element element from which you obtain an ID / элемент, с которого получаете ID
 * @param selector selectors for matching / селекторов для сопоставления
 * @returns element ID / идентификатор элемента
 */
export declare function getElementId<E extends ElementOrWindow>(element?: ElementOrString<E>, selector?: string): string;

/**
 * Get image element from HTMLImageElement or string source.
 *
 * Получить элемент изображения из HTMLImageElement или строкового источника.
 * @param image image element or string source/ элемент изображения или строковый источник
 * @returns HTMLImageElement or undefined / HTMLImageElement или undefined
 */
export declare function getElementImage(image: HTMLImageElement | string): HTMLImageElement | undefined;

/**
 * Returns the value of an element by its key.
 *
 * Возвращает значение элемента по его ключу.
 * @param element checked element/ проверяемый элемент
 * @param index index at which we retrieve values/ индекс, по которому получаем значения
 * @param defaultValue returns this parameter if the value is missing/ возвращает этот параметр,
 * если значение отсутствует
 * @returns element value or default value / значение элемента или значение по умолчанию
 */
export declare function getElementItem<T extends ElementOrWindow, K extends keyof T, D>(element: ElementOrString<T>, index: K | string, defaultValue?: D): T[K] | D | undefined;

/**
 * Returns window or element.
 *
 * Возвращает окно или элемент.
 * @param element selectors for matching or an Element/ селекторов для сопоставления или Element
 */
export declare function getElementOrWindow<E extends ElementOrWindow>(element?: ElementOrString<E>): E | undefined;

/**
 * Generates a safe script tag for data hydration.
 *
 * Генерирует безопасный тег скрипта для гидратации данных.
 * @param id script tag ID / ID тега скрипта
 * @param data data to be stored / данные для хранения
 * @returns generated script tag string / сгенерированная строка тега скрипта
 */
export declare function getElementSafeScript(id: string, data: any): string;

/**
 * Creates a case-insensitive regular expression for an exact match of a phrase (without anchors).
 *
 * Создает регистронезависимое регулярное выражение для точного совпадения фразы (без якорей).
 * @param search search string / строка поиска
 * @returns regular expression for exact search / регулярное выражение для точного поиска
 */
export declare function getExactSearchExp(search: string): RegExp;

/**
 * The object is used for matching text with a pattern.
 *
 * Конструктор создаёт объект регулярного выражения для сопоставления текста с шаблоном.
 * @param value test for replacement/ тест для замены
 * @param flags если определён, может принимать любую комбинацию нижеследующих значений:
 * g - глобальное сопоставление,
 * i - игнорирование регистра при сопоставлении
 * m - сопоставление по нескольким строкам.
 * @param pattern Regular expression text in which the value :value will be replaced with the optimized value of value/
 * Текст регулярного выражения, в котором значение :value заменится на оптимизированное значение value
 * @returns regular expression / регулярное выражение
 */
export declare function getExp(value: string, flags?: string, pattern?: string): RegExp;

/**
 * Возвращает первый элемент массива или объекта
 *
 * Returns the first element of an array or object
 * @param value Входное значение
 * @returns Первый элемент массива или объекта
 */
export declare function getFirst<T>(value: T | T[] | Record<string, T>): T | undefined;

/**
 * Retrieves and parses JSON data from a script tag in the DOM.
 *
 * Извлекает и парсит JSON данные из тега скрипта в DOM.
 * @param id script tag ID / ID тега скрипта
 * @param defaultValue default value if not found or invalid / значение по умолчанию, если не найдено или невалидно
 * @param remove remove script after reading / удалить скрипт после чтения
 * @returns parsed data or default value / распарсенные данные или значение по умолчанию
 */
export declare function getHydrationData<T>(id: string, defaultValue: T, remove?: boolean): T;

/**
 * Returns the source string from an HTMLImageElement or string source.
 *
 * Возвращает строку источника из HTMLImageElement или строкового источника.
 * @param image image element or string source / элемент изображения или строковый источник
 * @returns image source string / строка источника изображения
 */
export declare function getImageSrc(image?: HTMLImageElement | string): string;

/**
 * Returns data by their path.
 *
 * Возвращает данные по их пути.
 * @param item object for work/ объект для работы
 * @param path data path/ путь к данным
 * @returns data by path or undefined / данные по пути или undefined
 */
export declare function getItemByPath<T extends Record<string, any>, R = string>(item: T, path: string): R | undefined;

/**
 * Returns the pressed key.
 *
 * Возвращает нажатую клавишу.
 * @param event event object/ объект события
 * @returns pressed key / нажатая клавиша
 */
export declare function getKey(event: KeyboardEvent): string | number | undefined;

/**
 * Returns the last element of an array or object.
 *
 * Возвращает последний элемент массива или объекта.
 * @param value input value / входное значение
 * @returns last element of the array or object / последний элемент массива или объекта
 */
export declare function getLast<T>(value: T | T[] | Record<string, T>): T | undefined;

/**
 * Returns the length or size of various data types including Arrays, Objects, Maps, Sets, and Strings.
 * If the value is null, undefined, or an unsupported type (e.g. number, boolean), it returns 0.
 *
 * Возвращает длину или размер различных типов данных, включая массивы, объекты, Map, Set и строки.
 * Если значение равно null, undefined или имеет неподдерживаемый тип (например, число, булево), возвращает 0.
 * @param value input value to measure / входное значение для измерения
 * @returns the length or size of the value / длина или размер значения
 */
export declare function getLength(value: any): number;

/**
 * Returns the length of all elements in an array.
 *
 * Возвращает длину всех элементов в виде массива.
 * @param value input value/ входное значение
 */
export declare function getLengthOfAllArray(value: ObjectOrArray<string>): number[];

/**
 * Searches for the longest string in the array and returns its length.
 *
 * Ищет самую длинную строку в массиве и возвращает её длину.
 * @param data array with data/ массив с данными
 * @returns length of the longest string/ длина самой длинной строки
 */
export declare function getMaxLengthAllArray(data: ObjectOrArray<string>): number;

/**
 * Searches for the shortest string in the array and returns its length.
 *
 * Ищет самую короткую строку в массиве и возвращает её длину.
 * @param data array with data/ массив с данными
 */
export declare function getMinLengthAllArray(data: ObjectOrArray<string>): number;

/**
 * Returns the position of the mouse cursor or the location of the click.
 *
 * Возвращает позицию курсора мыши или место нажатия.
 * @param event event object/ объект события
 * @returns coordinates of the mouse cursor / координаты курсора мыши
 */
export declare function getMouseClient(event: MouseEvent | TouchEvent): ImageCoordinator;

/**
 * Returns the position of the mouse cursor or the location of the click (X).
 *
 * Возвращает позицию курсора мыши или место нажатия (X).
 * @param event event object/ объект события
 * @returns X coordinate / координата X
 */
export declare function getMouseClientX(event: MouseEvent | TouchEvent): number;

/**
 * Returns the position of the mouse cursor or the location of the click (Y).
 *
 * Возвращает позицию курсора мыши или место нажатия (Y).
 * @param event event object/ объект события
 * @returns Y coordinate / координата Y
 */
export declare function getMouseClientY(event: MouseEvent | TouchEvent): number;

/**
 * Returns a new object with keys from the keys list.
 *
 * Возвращает новый объект с ключами из списка keys.
 * @param data object with data/ объект с данными
 * @param keys list of keys/ список ключей
 */
export declare function getObjectByKeys<T extends Record<string, any>, K extends keyof T>(data: T, keys: K[]): Pick<T, K>;

/**
 * Removes from the object all properties belonging to the exception type.
 *
 * Удаляет из объекта все свойства, принадлежащие к типу исключения.
 * @param data object for processing/ объект для обработки
 * @param exception exception value/ значение для исключения
 * @returns object without exception values/ объект без исключенных значений
 */
export declare function getObjectNoUndefined<T extends Record<string | number, any>>(data: T, exception?: any): T;

/**
 * Returns the object if the object’s values are set.
 *
 * Возвращает объект, если заданы значения объекта.
 * @param value let’s assume that this is an object/ предположим, что это объект
 * @returns object or empty object/ объект или пустой объект
 */
export declare function getObjectOrNone<T>(value: T): T & Record<string, any>;

/**
 * Returns only letters, numbers, and spaces from a string.
 *
 * Возвращает из строки только буквы, цифры и пробелы.
 * @param text text for processing / текст для обработки
 * @returns cleaned text without special characters / очищенный текст без специальных символов
 */
export declare function getOnlyText(text: any): string;

/**
 * Returns a random element from an array, object, or value.
 * If the input is empty or invalid, returns undefined.
 *
 * Возвращает случайный элемент из массива, объекта или значения.
 * Если массив/объект пуст или значение отсутствует, возвращает undefined.
 * @param value input array, object, or value / входной массив, объект или значение
 * @returns random element or undefined if empty / случайный элемент или undefined, если пусто
 */
export declare function getRandomItem<T>(value?: T | T[] | Record<string, T>): T | undefined;

/**
 * Generates text.
 *
 * Генерирует текст.
 * @param min minimum word/ минимальное слово
 * @param max maximum word/ максимальное слово
 * @param symbol symbol for replacing a letter/ символ для замены буквы
 * @param lengthMin minimum word length/ минимальная длина слова
 * @param lengthMax maximum word length/ максимальная длина слова
 * @returns generated text/ сгенерированный текст
 */
export declare function getRandomText(min: number, max: number, symbol?: string, lengthMin?: number, lengthMax?: number): string;

/**
 * Returns a string in the form of key-value.
 *
 * Возвращает строку в виде ключ-значение.
 * @param request data for conversion/ данные для преобразования
 * @param sign delimiter sign of key and value/ знак разделения ключа и значения
 * @param separator variable delimiter sign/ знак разделения переменных
 * @param subKey nested key for array elements/ вложенный ключ для элементов массива
 * @returns formatted request string/ форматированная строка запроса
 */
export declare function getRequestString(request: Record<string, any> | any[], sign?: string, separator?: string, subKey?: string): string;

/**
 * Builds a case-insensitive global `RegExp` for multi-word "contains all words" search.
 * Each word in the search string is escaped and wrapped in a lookahead `(?=.*?word)`,
 * so the result matches a string only if it contains every word (in any order).
 *
 * Строит регистро-независимое глобальное `RegExp` для поиска "содержит все слова".
 * Каждое слово из строки поиска экранируется и оборачивается в lookahead `(?=.*?слово)`,
 * поэтому результат совпадает только если строка содержит все слова (в любом порядке).
 * @param search search string with one or more space-separated words / строка поиска с одним или несколькими словами через пробел
 * @param limit maximum search string length / максимальная длина строки поиска
 */
export declare function getSearchExp(search: string, limit?: number): RegExp;

/**
 * Creates a case-insensitive regular expression for a search by words (separating by space).
 *
 * Создает регистронезависимое регулярное выражение для поиска по словам (разделение пробелом).
 * @param search search string or RegExp / строка поиска или регулярное выражение
 * @param limit maximum search string length / максимальная длина строки поиска
 * @returns `RegExp` for search / регулярное выражение для поиска
 */
export declare function getSeparatingSearchExp(search: string | RegExp, limit?: number): RegExp;

/**
 * Returns the unit of measurement for 1 step
 *
 * Возвращает единицу измерения для 1 шага
 * @param min minimum value/ минимальное значение
 * @param max maximum value/ максимальное значение
 * @returns step value in percent/ значение шага в процентах
 */
export declare function getStepPercent(min: number | undefined, max: number): number;

/**
 * Returns the unit of measurement for a single step relative to the given value
 *
 * Возвращает единицу измерения одного шага относительно заданного значения
 * @param min minimum value/ минимальное значение
 * @param max maximum value/ максимальное значение
 * @returns step value / значение шага
 */
export declare function getStepValue(min: number | undefined, max: number): number;

/**
 * Static utility class for storing and retrieving application-wide global data.
 *
 * Статический служебный класс для хранения и получения глобальных данных приложения.
 */
export declare class Global {
    /**
     * Returns the instance of the class.
     *
     * Возвращает инстанс класса.
     * @returns global data storage / хранилище глобальных данных
     */
    static getItem(): Record<string, any>;
    /**
     * Returns the value by its name.
     *
     * Возвращает значение по его имени.
     * @param name property name/ название свойства
     */
    static get<R = any>(name: string): R;
    /**
     * Adds data, this method works only once.
     *
     * Добавляет данные, этот метод работает только 1 раз.
     * @param data global data/ глобальные данные
     * @returns void / ничего не возвращает
     */
    static add(data: Record<string, any>): void;
}

/**
 * Quick change of scroll at the element to the required element.
 *
 * Быстрое изменение скролла у элемента к нужному элементу.
 * @param selector the selected an element, the scroll position of which needs to be changed/
 * выбранный элемент, положение скролла которого надо изменить
 * @param elementTo the element to which you need to scroll/ элемент, до которого надо проскроллить
 * @param elementCenter the element that needs to be centered/ элемент, который надо центрировать
 */
export declare function goScroll(selector: string, elementTo: HTMLElement | undefined, elementCenter?: HTMLElement): void;

/**
 * Smooth scrolling to the element.
 *
 * Плавная прокрутка до элемента.
 * @param element target element / целевой элемент
 * @param options scroll options / параметры прокрутки
 * @param shift shift from the top / смещение сверху
 * @returns void / ничего не возвращает
 */
export declare function goScrollSmooth<E extends HTMLElement>(element: E, options?: ScrollIntoViewOptions, shift?: number): void;

/**
 * Scrolls the container to make the target element visible.
 *
 * Прокручивает контейнер, чтобы целевой элемент стал видимым.
 * @param element container element/ элемент контейнера
 * @param elementTo target element/ целевой элемент
 * @param behavior scroll behavior/ режим прокрутки
 * @returns void / ничего не возвращает
 */
export declare function goScrollTo(element?: HTMLElement, elementTo?: HTMLElement, behavior?: ScrollBehavior): void;

/**
 * The method invokes the native sharing mechanism of the device as part of the Web Share API.
 * If the Web Share API is not supported by the browser or the data cannot be shared, the method returns false.
 *
 * Метод вызывает встроенный механизм обмена данными мобильного устройства или операционной системы.
 * Если Web Share API не поддерживается браузером или данные не могут быть переданы, метод возвращает false.
 * @param data an object containing data to share/ объект, содержащий данные для обмена
 * @returns true if the data was shared successfully/ true, если данные были успешно переданы
 */
export declare function handleShare(data: ShareData): Promise<boolean>;

/**
 * Static class for working with data stored in the URL hash.
 * Provides a centralized interface delegating to HashInstance.
 *
 * Статический класс для работы с данными, сохранёнными в хеше URL.
 * Предоставляет централизованный интерфейс, делегируя вызовы HashInstance.
 */
export declare class Hash {
    /**
     * Returns a request-isolated instance of HashInstance.
     *
     * Возвращает изолированный в рамках запроса экземпляр HashInstance.
     * @returns HashInstance instance / экземпляр HashInstance
     */
    static getItem(): HashInstance;
    /**
     * Get data from hash.
     *
     * Получение данных из хэша.
     * @param name variable name / название переменной
     * @param defaultValue value or function to change data / значение или функция для изменения данных
     * @returns stored value / сохранённое значение
     */
    static get<T>(name: string, defaultValue?: T | (() => T)): T;
    /**
     * Change data in hash.
     *
     * Изменение данных в хэше.
     * @param name variable name / название переменной
     * @param callback value or function to change data / значение или функция для изменения данных
     */
    static set<T>(name: string, callback: T | (() => T)): void;
    /**
     * Adding an event when data is changed.
     *
     * Добавление события при изменении данных.
     * @param name variable name / название переменной
     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
     */
    static addWatch<T>(name: string, callback: (value: T) => void): void;
    /**
     * Removing an event when data is changed.
     *
     * Удаление события при изменении данных.
     * @param name variable name / название переменной
     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
     */
    static removeWatch<T>(name: string, callback: (value: T) => void): void;
    /**
     * Update hash variable from URL string.
     *
     * Обновление переменной хэша из строки URL.
     * @returns void / ничего не возвращает
     */
    static reload(): void;
}

/**
 * Class for working with data stored in the URL hash.
 *
 * Класс для работы с данными, сохранёнными в хеше URL.
 */
export declare class HashInstance extends UrlInstanceAbstract {
    /**
     * Initializes hash data and registers the hashchange listener.
     *
     * Инициализирует данные хэша и регистрирует слушатель hashchange.
     * @returns this instance / текущий экземпляр
     */
    protected init(): this;
    /**
     * Obtaining data from the URL string.
     *
     * Получение данных из строки URL.
     * @returns Record<string, any> hash data / данные хэша
     */
    protected getLocation(): Record<string, any>;
    /**
     * Update hash string in URL.
     *
     * Обновление строки хэша в URL.
     * @returns this instance / текущий экземпляр
     */
    protected update(): this;
}

/** Highlight match item type / Тип элемента подсветки совпадения */
export declare type HighlightMatchItem = {
    /** Text segment / Текстовый сегмент */
    text: string;
    /** Whether the segment matches the search query / Соответствует ли сегмент поисковому запросу */
    isMatch: boolean;
};

/**
 * Class for managing icons.
 *
 * Класс для управления иконками.
 */
export declare class Icons {
    /** Registered icons map / Карта зарегистрированных иконок */
    protected static icons: Record<string, IconsItem>;
    /** Base icons storage URL / Базовый URL хранилища иконок */
    protected static url: string;
    /**
     * Checks if the given icon is in the list of connected icons.
     *
     * Проверяет, есть ли данная иконка в списке подключенных иконок.
     * @param index icon name/ название иконки
     */
    static is(index: string): boolean;
    /**
     * Returns the icon by the name.
     *
     * Возвращает иконку по названию.
     * @param index icon name/ название иконки
     * @param url path to the storage location of the icon, if the icon does not exist / путь к месту хранения иконки, если иконка не существует
     * @param wait waiting time for picture loading (ms) / время ожидания загрузки картинки (мс)
     * @returns icon path or content/ путь к иконке или контент
     */
    static get(index: string, url?: string, wait?: number): Promise<string>;
    /**
     * Returns the icon if it is already loaded or is a string.
     *
     * Возвращает иконку, если она уже загружена или является строкой.
     * @param index icon name/ название иконки
     * @param url path to the storage location of the icon, if the icon does not exist / путь к месту хранения иконки, если иконка не существует
     * @returns icon path or content/ путь к иконке или контент
     */
    static getAsync(index: string, url?: string): string;
    /**
     * Returns a list of names of all registered icons.
     *
     * Возвращает список названий всех зарегистрированных иконок.
     * @returns list of icon names/ список названий иконок
     */
    static getNameList(): string[];
    /**
     * Returns a global link.
     *
     * Возвращает глобальную ссылку.
     * @returns string global link/ глобальная ссылка
     */
    static getUrlGlobal(): string;
    /**
     * Adding custom icons.
     *
     * Добавление пользовательских иконок.
     * @param index icon name/ название иконки
     * @param file path to the file/ путь к файлу
     */
    static add(index: string, file: IconsItem): void;
    /**
     * Adding custom icons in loading mode.
     *
     * Добавление пользовательских иконок в режиме загрузки.
     * @param index icon name/ название иконки
     */
    static addLoad(index: string): void;
    /**
     * Adding custom global icons.
     *
     * Добавление пользовательских глобальных иконок.
     * @param index icon name/ название иконки
     * @param file path to the file/ путь к файлу
     */
    static addGlobal(index: string, file: string): void;
    /**
     * Adding an icon by the list.
     *
     * Добавление иконки по списку.
     * @param list list of icons/ список иконки
     */
    static addByList(list: Record<string, IconsItem>): void;
    /**
     * Changes the file path.
     *
     * Изменяет путь к файлу.
     * @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 with the prefix.
     *
     * Возвращает название иконки с префиксом.
     * @param index icon name/ название иконки
     * @returns icon name with prefix/ название иконки с префиксом
     */
    protected static getName(index: string): string;
    /**
     * Returns the raw icon data by the name.
     *
     * Возвращает исходные данные иконки по названию.
     * @param index icon name/ название иконки
     * @param url path to the storage location of the icon, if the icon does not exist / путь к месту хранения иконки, если иконка не существует
     * @returns icon path or content/ путь к иконке или контент
     */
    protected static getRaw(index: string, url?: string): IconsItem;
    /**
     * Script execution delay.
     *
     * Задержка выполнения скрипта.
     * @returns Promise<void> Promise for delay/ Promise для задержки
     */
    protected static wait(): Promise<void>;
}

/** Icon configuration object / Объект конфигурации иконок */
export declare type IconsConfig = {
    /** URL to the icons storage / URL к хранилищу иконок */
    url?: string;
    /** List of custom icons / Список пользовательских иконок */
    list?: Record<string, IconsItem>;
};

/** Icon item type definition / Определение типа элемента иконки */
export declare type IconsItem = string | Promise<string | any> | (() => Promise<string | any>);

/** Type for 2D coordinates/ Тип для 2D координат */
export declare type ImageCoordinator = {
    /** X-axis coordinate/ Координата по оси X */
    x: number;
    /** Y-axis coordinate/ Координата по оси Y */
    y: number;
};

/**
 * Checks if the value is in the current array.
 *
 * Проверяет, есть ли значение в текущем массиве.
 * @param array array for checking/ массив для проверки
 * @param value value to be checked/ проверяемое значение
 * @returns true if in array / true, если в массиве
 */
export declare function inArray<T>(array: T[], value: T): boolean;

/**
 * Initializes the getElementId function with a listener.
 *
 * Инициализирует функцию getElementId слушателем.
 * @param newListener listener that returns the current request context / слушатель, возвращающий контекст текущего запроса
 * @warning Initialization is mandatory for correct functioning of SSR on both server and client sides./
 * Инициализация обязательна для корректной работы SSR как на стороне сервера, так и на стороне клиента.
 * @example
 * ```typescript
 * import { useId } from 'vue'
 * import { initGetElementId } from '@dxtmisha/functional-basic'
 *
 * initGetElementId(() => useId())
 * ```
 */
export declare function initGetElementId(newListener: () => string | number): void;

/**
 * Initialization of data for scroll control.
 *
 * Инициализация данных для управления скроллом.
 * @returns promise without return value / промис без возвращаемого значения
 */
export declare function initScrollbarOffset(): Promise<void>;

/**
 * Computes the intersection of arrays using keys for comparison.
 *
 * Вычислить пересечение массивов, сравнивая ключи.
 * @param data the array with master keys to check/ основной проверяемый массив
 * @param comparison arrays to compare keys against/ массивы, с которыми идёт сравнение
 * @returns object with intersected keys/ объект с пересекающимися ключами
 */
export declare function intersectKey<T, KT extends keyof T, C, KC extends keyof C>(data?: T, comparison?: C): Record<KT & KC, T[KT]>;

/**
 * Checks if the API response is successful.
 *
 * Проверяет, является ли ответ API успешным.
 * @param data API response data/ данные ответа API
 * @returns true if successful / true, если успешно
 */
export declare const isApiSuccess: <T>(data: ApiData<T>) => boolean;

/**
 * Checks if the values are arrays.
 *
 * Проверяет, являются ли значения массивами.
 * @param value input value/ входное значение
 * @returns true if array / true, если массив
 */
export declare function isArray<T, R>(value: T): value is Extract<T, R[]>;

/**
 * Checks if the values of two objects are different.
 *
 * Проверяет, различаются ли значения двух объектов.
 * @param value current values/ текущие значения
 * @param old old values/ старые значения
 * @returns true if different / true, если отличаются
 */
export declare function isDifferent<T>(value: ObjectItem<T>, old: ObjectItem<T>): boolean;

/**
 * Checks if the current environment is a data URL.
 *
 * Проверяет, является ли текущая среда URL-адресом данных.
 * @returns true if in data URL / true, если в data URL
 */
export declare function isDomData(): boolean;

/**
 * Проверяет, выполняется ли код в браузере, где доступен объект `window`.
 * Возвращает `true`, если `window` доступен, что означает, что код выполняется в браузере.
 *
 * Checks if the code is running in a browser where the `window` object is available.
 * Returns `true` if `window` is defined, indicating the code is running in a browser.
 *
 * @returns `true`, если выполняется в браузере, иначе `false`/ `true` if running in a browser, otherwise `false`
 */
export declare function isDomRuntime(): boolean;

/**
 * Checks if an element is visible (not hidden by CSS and is in the DOM).
 * An element can be off-screen and still be considered visible.
 *
 * Проверяет, является ли элемент видимым (не скрыт через CSS и находится в DOM).
 * Элемент может находиться за пределами экрана и при этом считаться видимым.
 * @param elementSelectors selectors for matching or an Element/ селекторов для сопоставления или Element
 * @returns true if the element is visible, otherwise false/ true, если элемент является видимым, иначе false
 */
export declare function isElementVisible<E extends ElementOrWindow>(elementSelectors?: ElementOrString<E>): boolean;

/**
 * Checks if the pressed key is Enter or Space.
 *
 * Проверяет, является ли нажатая клавиша Enter или Space.
 * @param event event object/ объект события
 * @param isInputElement whether the element is an input element/ является ли элемент полем ввода
 * @returns true if enter pressed / true, если нажат enter
 */
export declare const isEnter: (event: KeyboardEvent, isInputElement?: boolean) => boolean;

/**
 * Checks if the field is filled.
 *
 * Проверяет, заполнено ли поле.
 * @param value input value/ входное значение
 * @param zeroTrue if true, '0' is considered filled/ если true, то '0' считается заполненным
 * @returns true if filled / true, если заполнено
 */
export declare function isFilled<T>(value: T, zeroTrue?: boolean): value is Exclude<T, EmptyValue>;

/**
 * Checks if the value is an integer or a floating-point number.
 *
 * Проверяет, является ли значение числом или дробным числом.
 * @param value values for checking/ значения для проверки
 * @returns true if number/ true, если число
 */
export declare function isFloat(value: any): boolean;

/**
 * Checks if the function is a callback function.
 *
 * Проверяет, является ли функция обратного вызова.
 * @param callback the value being checked/ проверяемое значение
 * @returns true if function / true, если функция
 */
export declare function isFunction<T>(callback: T): callback is Extract<T, FunctionArgs<any, any>>;

/**
 * Checks if an element is still in the DOM tree.
 *
 * Проверяет, находится ли еще элемент в дереве DOM.
 * @param element selectors for matching or an Element/ селекторов для сопоставления или Element
 * @returns true if in DOM / true, если в DOM
 */
export declare function isInDom<E extends ElementOrWindow>(element?: ElementOrString<E>): boolean;

/**
 * Checks if the element is an input field or editable.
 *
 * Проверяет, является ли элемент полем ввода или редактируемым.
 * @param element element to check/ проверяемый элемент
 * @returns true if input element / true, если элемент ввода
 */
export declare const isInput: (element: HTMLElement | EventTarget | null) => boolean;

/**
 * Checks if the value is between integers.
 *
 * Проверяет, лежит ли значение между целыми числами.
 * @param value input value/ входное значение
 * @param between value for rounding/ значение для округления
 * @returns true if between integers / true, если между целыми числами
 */
export declare function isIntegerBetween(value: number, between: number): boolean;

/**
 * Checks if a key event contains active modifier/meta keys.
 *
 * Проверяет, содержит ли событие клавиши активные клавиши-модификаторы.
 * @param event event object / объект события
 * @returns true if modifier key pressed / true, если нажата клавиша-модификатор
 */
export declare const isMetaKey: (event: KeyboardEvent) => boolean;

/**
 * Is the variable equal to null or undefined.
 *
 * Является ли переменная равной null или undefined.
 * @param value input value/ входное значение
 * @returns true if null or undefined / true, если null или undefined
 */
export declare function isNull<T>(value: T): value is Extract<T, Undefined>;

/**
 * Checks if the value is a number.
 *
 * Проверяет, является ли значение числом.
 * @param value values for checking/ значения для проверки
 * @returns true if number / true, если число
 */
export declare function isNumber(value: any): boolean;

/**
 * Checks if a value is an object.
 *
 * Проверяет, является ли значение объектом.
 * @param value input value/ входное значение
 * @returns true if object/ true, если объект
 */
export declare function isObject<T>(value: T): value is Extract<T, Record<any, any>>;

/**
 * Checks if the value is an object or not an array.
 *
 * Проверяет, является ли значение объектом и не является массивом.
 * @param value input value/ входное значение
 * @returns true if object and not array/ true, если объект и не массив
 */
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.
 *
 * Проверяет, есть ли value в массиве selected или равен ли value selected, если selected - строка.
 * @param value input value/ входное значение
 * @param selected array or string for comparison/ массив или строка для сравнения
 * @returns true if selected / true, если выбрано
 */
export declare function isSelected<T, S>(value: T, selected: T | T[] | S): boolean;

/**
 * Testing isSelected property for the entire list of values.
 *
 * Проверка свойства isSelected для всех значений списка.
 * @param values list of values for comparison/ список значений для сравнения
 * @param selected array or string for comparison/ массив или строка для сравнения
 * @returns true if all selected / true, если все выбраны
 */
export declare function isSelectedByList<T>(values: T | T[], selected: T | T[]): boolean;

/**
 * Checks if the Web Share API is supported in the current environment.
 *
 * Проверяет, поддерживается ли Web Share API в текущей среде.
 * @returns true if the Web Share API is supported/ true, если Web Share API поддерживается
 */
export declare function isShare(): boolean;

/**
 * Checks if the value is of type string.
 *
 * Проверяет, является ли значение типом строки.
 * @param value input value/ входное значение
 * @returns true if string / true, если строка
 */
export declare function isString<T>(value: T): value is Extract<T, string>;

/**
 * Checks if the pressed key is Tab.
 *
 * Проверяет, является ли нажатая клавиша Tab.
 * @param event - event object / объект события
 * @returns true if tab pressed / true, если нажат tab
 */
export declare const isTab: (event: KeyboardEvent) => boolean;

/**
 * Checks if object is Window.
 *
 * Проверяет, является ли объект Window.
 * @param element selectors for matching or an Element/ селекторов для сопоставления или Element
 */
export declare function isWindow<E>(element: E): element is Extract<E, Window>;

/**
 * Generic item type with index and value properties/
 * Дженерик тип элемента со свойствами index и value
 */
export declare type Item<V> = {
    /** Unique string identifier for the item/ Уникальный строковый идентификатор элемента */
    index: string;
    /** The actual value of the item/ Фактическое значение элемента */
    value: V;
};

/**
 * Generic record type for lists with string keys/
 * Дженерик тип записи для списков со строковыми ключами
 */
export declare type ItemList<T = any> = Record<string, T>;

/**
 * Generic item type with name and value properties/
 * Дженерик тип элемента со свойствами name и value
 */
export declare type ItemName<V> = {
    /** Name identifier (string or number)/ Идентификатор имени (строка или число) */
    name: string | number;
    /** The actual value of the item/ Фактическое значение элемента */
    value: V;
};

/**
 * Generic item type with label and value properties/
 * Дженерик тип элемента со свойствами label и value
 */
export declare type ItemValue<V> = {
    /** Display text for the item/ Отображаемый текст для элемента */
    label: string;
    /** The actual value of the item/ Фактическое значение элемента */
    value: V;
};

/**
 * Class for working with global loading.
 *
 * Класс для работы с глобальной загрузкой.
 */
export declare class Loading {
    /**
     * Check if the loader is active now.
     *
     * Проверить, активен ли сейчас загрузчик.
     * @returns boolean/ логическое значение
     */
    static is(): boolean;
    /**
     * Get current loading value.
     *
     * Получить текущее значение загрузки.
     * @returns current loading value/ текущее значение загрузки
     */
    static get(): number;
    /**
     * Returns a request-isolated instance of LoadingInstance.
     *
     * Возвращает изолированный в рамках запроса экземпляр LoadingInstance.
     * @returns LoadingInstance instance / экземпляр LoadingInstance
     */
    static getItem(): LoadingInstance;
    /**
     * Shows the loader.
     *
     * Показывает загрузчик.
     * @returns void / ничего не возвращает
     */
    static show(): void;
    /**
     * Hides the loader.
     *
     * Скрывает загрузчик.
     * @returns void / ничего не возвращает
     */
    static hide(): void;
    /**
     * Event registration to listen for data changes.
     *
     * Регистрация события для прослушивания изменений данных.
     * @param listener the object that receives a notification when an event occurs / объект, который принимает уведомление, когда событие указанного типа произошло
     * @param element element / элемент
     * @returns void / ничего не возвращает
     */
    static registrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
    /**
     * Unregistration of an event.
     *
     * Отмена регистрации события.
     * @param listener the object that receives a notification when an event occurs / объект, который принимает уведомление, когда событие указанного типа произошло
     * @param element element / элемент
     * @returns void / ничего не возвращает
     */
    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.
     *
     * Показывает загрузчик.
     * @returns void / ничего не возвращает
     */
    show(): void;
    /**
     * Hides the loader.
     *
     * Скрывает загрузчик.
     * @returns void / ничего не возвращает
     */
    hide(): void;
    /**
     * Event registration to listen for data changes.
     *
     * Регистрация события для прослушивания изменений данных.
     * @param listener the object that receives a notification when an event occurs / объект, который принимает уведомление, когда событие указанного типа произошло
     * @param element element / элемент
     * @returns void / ничего не возвращает
     */
    registrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
    /**
     * Unregistration of an event.
     *
     * Отмена регистрации события.
     * @param listener the object that receives a notification when an event occurs / объект, который принимает уведомление, когда событие указанного типа произошло
     * @param element element / элемент
     * @returns void / ничего не возвращает
     */
    unregistrationEvent(listener: EventListenerDetail<CustomEvent, LoadingDetail>, element?: ElementOrString<HTMLElement>): void;
    /**
     * Calls the event listener.
     *
     * Вызывает слушателя событий.
     */
    protected dispatch(): void;
}

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

/**
 * Unified class for managing all types of meta tags (standard HTML, Open Graph, Twitter Card).
 *
 * Унифицированный класс для управления всеми типами мета-тегов (стандартные HTML, Open Graph, Twitter Card).
 */
export declare class Meta extends MetaManager<MetaTag[]> {
    /** Page title suffix / Суффикс заголовка страницы */
    protected suffix?: string;
    /** Open Graph meta instance / Экземпляр мета-тегов Open Graph */
    protected og: MetaOg;
    /** Twitter Card meta instance / Экземпляр мета-тегов Twitter Card */
    protected twitter: MetaTwitter;
    /**
     * Creates an instance of Meta with integrated Open Graph and Twitter Card support.
     *
     * Создает экземпляр Meta с интегрированной поддержкой Open Graph и Twitter Card.
     */
    constructor();
    /**
     * Gets the MetaOg instance for advanced Open Graph operations.
     *
     * Получает экземпляр MetaOg для расширенных операций с Open Graph.
     */
    getOg(): MetaOg;
    /**
     * Gets the MetaTwitter instance for advanced Twitter Card operations.
     *
     * Получает экземпляр MetaTwitter для расширенных операций с Twitter Card.
     */
    getTwitter(): MetaTwitter;
    /**
     * Gets the page title without suffix.
     *
     * Получает заголовок страницы без суффикса.
     * @returns title without suffix/ заголовок без суффикса
     */
    getTitle(): string;
    /**
     * Gets the keywords meta tag.
     *
     * Получает мета-тег keywords.
     * @returns keywords content/ содержимое keywords
     */
    getKeywords(): string;
    /**
     * Gets the description meta tag.
     *
     * Получает мета-тег description.
     * @returns description content / содержимое description
     */
    getDescription(): string;
    /**
     * Gets the Open Graph image URL.
     *
     * Получает URL изображения Open Graph.
     * @returns image URL / URL изображения
     */
    getImage(): string;
    /**
     * Gets the canonical URL.
     *
     * Получает канонический URL.
     * @returns canonical URL / канонический URL
     */
    getCanonical(): string;
    /**
     * Gets the robots meta tag value.
     *
     * Получает значение мета-тега robots.
     * @returns robots directive/ директива robots
     */
    getRobots(): MetaRobots;
    /**
     * Gets the author meta tag.
     *
     * Получает мета-тег author.
     * @returns author name / имя автора
     */
    getAuthor(): string;
    /**
     * Gets the Open Graph site name.
     *
     * Получает название сайта Open Graph.
     * @returns site name / название сайта
     */
    getSiteName(): string;
    /**
     * Gets the Open Graph locale.
     *
     * Получает локаль Open Graph.
     * @returns locale / локаль
     */
    getLocale(): string;
    /**
     * Sets the page title (with suffix) and updates Open Graph and Twitter Card titles.
     *
     * Устанавливает заголовок страницы (с суффиксом) и обновляет заголовки Open Graph и Twitter Card.
     * @param title page title / заголовок страницы
     */
    setTitle(title: string): this;
    /**
     * Sets the keywords meta tag.
     *
     * Устанавливает мета-тег keywords.
     * @param keywords keywords as string or array / ключевые слова в виде строки или массива
     */
    setKeywords(keywords: string | string[]): this;
    /**
     * Sets the description meta tag.
     *
     * Устанавливает мета-тег description.
     * @param description page description / описание страницы
     */
    setDescription(description: string): this;
    /**
     * Sets the image for Open Graph and Twitter Card.
     *
     * Устанавливает изображение для Open Graph и Twitter Card.
     * @param image image URL / URL изображения
     */
    setImage(image: string): this;
    /**
     * Sets the canonical URL and updates Open Graph and Twitter Card URLs.
     *
     * Устанавливает канонический URL и обновляет URL для Open Graph и Twitter Card.
     * @param canonical canonical URL / канонический URL
     */
    setCanonical(canonical: string): this;
    /**
     * Sets the robots meta tag.
     *
     * Устанавливает мета-тег robots.
     * @param robots robots directive / директива robots
     */
    setRobots(robots: MetaRobots): this;
    /**
     * Sets the author meta tag.
     *
     * Устанавливает мета-тег author.
     * @param author author name / имя автора
     */
    setAuthor(author: string): this;
    /**
     * Sets the site name for Open Graph and Twitter Card.
     *
     * Устанавливает название сайта для Open Graph и Twitter Card.
     * @param siteName site name / название сайта
     */
    setSiteName(siteName: string): this;
    /**
     * Sets the locale for Open Graph.
     *
     * Устанавливает локаль для Open Graph.
     * @param locale locale (e.g. 'en_US', 'ru_RU') / локаль (например, 'en_US', 'ru_RU')
     */
    setLocale(locale: string): this;
    /**
     * Sets the suffix to append to page title.
     *
     * Устанавливает суффикс для добавления к заголовку страницы.
     * @param suffix title suffix (e.g. 'My Site') / суффикс заголовка (например, 'Мой Сайт')
     * @returns void / ничего не возвращает
     */
    setSuffix(suffix?: string): void;
    /**
     * Generates the complete HTML for all meta-tags including Open Graph and Twitter Card.
     *
     * Генерирует полный HTML для всех мета-тегов, включая Open Graph и Twitter Card.
     * @returns complete HTML string/ полная HTML-строка
     */
    html(): string;
    /**
     * Generates the title as an HTML-safe string.
     *
     * Генерирует заголовок в виде HTML-безопасной строки.
     * @returns title HTML-safe string / HTML-безопасная строка заголовка
     */
    htmlTitle(): string;
    /**
     * Gets the formatted suffix with separator.
     *
     * Получает отформатированный суффикс с разделителем.
     */
    protected getSuffix(): string;
}

/** Meta-tags dictionary structure / Структура словаря мета-тегов */
declare type MetaList<T extends readonly string[]> = {
    [K in T[number]]?: string;
};

/**
 * Class for working with meta tags.
 *
 * Класс для управления мета-тегами.
 */
export declare class MetaManager<T extends readonly string[], Key extends keyof MetaList<T> = keyof MetaList<T>> {
    protected readonly listMeta: T;
    protected readonly isProperty: boolean;
    /** Meta tags map / Карта мета-тегов */
    protected readonly items: MetaList<T>;
    /**
     * Creates an instance of MetaManager.
     *
     * Создает экземпляр MetaManager.
     * @param listMeta list of meta-tag names to manage / список имен мета-тегов для управления
     * @param isProperty use 'property' attribute instead of 'name' / использовать атрибут 'property' вместо 'name'
     */
    constructor(listMeta: T, isProperty?: boolean);
    /**
     * Returns the list of meta tag names.
     *
     * Возвращает список имен мета-тегов.
     * @returns list of meta tag names/ список имен мета-тегов
     */
    getListMeta(): T;
    /**
     * Get the content of a meta tag by name.
     *
     * Получает содержимое мета-тега по имени.
     * @param name meta tag name / имя мета-тега
     * @returns meta tag content/ содержимое мета-тега
     */
    get(name: Key): string;
    /**
     * Returns all meta tags.
     *
     * Возвращает все мета-теги.
     * @returns object with all meta tags/ объект со всеми мета-тегами
     */
    getItems(): MetaList<T>;
    /**
     * Returns all meta tags as HTML string.
     *
     * Возвращает все мета-теги в виде HTML-строки.
     * @returns HTML string/ HTML-строка
     */
    html(): string;
    /**
     * Sets the content of a meta tag.
     *
     * Устанавливает содержимое мета-тега.
     * @param name meta tag name / имя мета-тега
     * @param content meta tag content / содержимое мета-тега
     */
    set(name: Key, content: string): this;
    /**
     * Sets multiple meta tags from an object.
     *
     * Устанавливает несколько мета-тегов из объекта.
     * @param metaList object with meta tag names and content / объект с именами и содержимым мета-тегов
     */
    setByList(metaList: MetaList<T>): this;
    /**
     * Returns the attribute name for meta tags.
     *
     * Возвращает имя атрибута для мета-тегов.
     * @returns attribute name / имя атрибута
     */
    protected getAttributeName(): string;
    /**
     * Finds a meta element in the DOM.
     *
     * Находит мета-элемент в DOM.
     * @param name meta tag name / имя мета-тега
     * @returns meta element if found, or undefined / мета-элемент, если найден, иначе undefined
     */
    protected findMetaElement(name: string): HTMLMetaElement | undefined;
    /**
     * Sets the content of a meta tag in internal storage.
     *
     * Устанавливает содержимое мета-тега во внутреннем хранилище.
     * @param name meta tag name / имя мета-тега
     * @param content meta tag content / содержимое мета-тега
     * @returns current instance / текущий экземпляр
     */
    protected setItem(name: Key, content: string): this;
    /**
     * Sets or creates a meta tag in the DOM.
     *
     * Устанавливает или создает мета-тег в DOM.
     * @param name meta tag name / имя мета-тега
     * @returns current instance / текущий экземпляр
     */
    protected setMeta(name: Key): this;
    /**
     * Converts meta tag to HTML string.
     *
     * Преобразует мета-тег в HTML-строку.
     * @param name meta tag name / имя мета-тега
     * @returns HTML string / HTML-строка
     */
    protected toHtmlString(name: Key): string;
    /**
     * Converts the title to an HTML-safe string.
     *
     * Преобразует заголовок в HTML-безопасную строку.
     * @param title page title / заголовок страницы
     * @returns encoded title string / закодированная строка заголовка
     */
    protected toHtmlTitle(title: string): string;
    /**
     * Updates meta tags data from the DOM.
     *
     * Обновляет данные мета-тегов из DOM.
     * @returns current instance / текущий экземпляр
     */
    protected update(): this;
}

/**
 * Class for working with Open Graph meta tags.
 *
 * Класс для управления мета-тегами Open Graph.
 */
export declare class MetaOg extends MetaManager<MetaOpenGraphTag[]> {
    /**
     * Constructor for MetaOg.
     *
     * Конструктор для MetaOg.
     */
    constructor();
    /**
     * Gets the Open Graph title.
     *
     * Получает заголовок Open Graph.
     * @returns title / заголовок
     */
    getTitle(): string;
    /**
     * Gets the Open Graph type.
     *
     * Получает тип Open Graph.
     * @returns type / тип
     */
    getType(): MetaOpenGraphType;
    /**
     * Gets the Open Graph URL.
     *
     * Получает URL Open Graph.
     * @returns URL / URL адрес
     */
    getUrl(): string;
    /**
     * Gets the Open Graph image URL.
     *
     * Получает URL изображения Open Graph.
     * @returns image URL / URL изображения
     */
    getImage(): string;
    /**
     * Gets the Open Graph description.
     *
     * Получает описание Open Graph.
     * @returns description / описание
     */
    getDescription(): string;
    /**
     * Gets the Open Graph locale.
     *
     * Получает локаль Open Graph.
     * @returns locale / локаль
     */
    getLocale(): string;
    /**
     * Gets the Open Graph site name.
     *
     * Получает название сайта Open Graph.
     * @returns site name / название сайта
     */
    getSiteName(): string;
    /**
     * Sets the Open Graph title.
     *
     * Устанавливает заголовок Open Graph.
     * @param title title / заголовок
     * @returns current instance / текущий экземпляр
     */
    setTitle(title: string): this;
    /**
     * Sets the Open Graph type.
     *
     * Устанавливает тип Open Graph.
     * @param type type / тип
     * @returns current instance / текущий экземпляр
     */
    setType(type: MetaOpenGraphType): this;
    /**
     * Sets the Open Graph URL.
     *
     * Устанавливает URL Open Graph.
     * @param url URL / URL адрес
     * @returns current instance / текущий экземпляр
     */
    setUrl(url: string): this;
    /**
     * Sets the Open Graph image URL.
     *
     * Устанавливает URL изображения Open Graph.
     * @param url image URL / URL изображения
     * @returns current instance / текущий экземпляр
     */
    setImage(url: string): this;
    /**
     * Sets the Open Graph description.
     *
     * Устанавливает описание Open Graph.
     * @param description description / описание
     * @returns current instance / текущий экземпляр
     */
    setDescription(description: string): this;
    /**
     * Sets the Open Graph locale.
     *
     * Устанавливает локаль Open Graph.
     * @param locale locale (e.g. 'en_US', 'ru_RU') / локаль (например, 'en_US', 'ru_RU')
     * @returns current instance / текущий экземпляр
     */
    setLocale(locale: string): this;
    /**
     * Sets the Open Graph site name.
     *
     * Устанавливает название сайта Open Graph.
     * @param siteName site name / название сайта
     * @returns current instance / текущий экземпляр
     */
    setSiteName(siteName: string): this;
}

/**
 * Age groups for products/
 * Возрастные группы для товаров
 */
export declare enum MetaOpenGraphAge {
    /** For newborns (0–12 months)/ Для новорожденных (0–12 месяцев) */
    newborn = "newborn",
    /** For infants (0–24 months)/ Для младенцев (0–24 месяцев) */
    infant = "infant",
    /** For toddlers (approximately 2–4 years)/ Для малышей (примерно 2–4 года) */
    toddler = "toddler",
    /** For kids (approximately 4–12 years)/ Для детей (примерно 4–12 лет) */
    kids = "kids",
    /** For adults/ Для взрослых */
    adult = "adult"
}

/**
 * Product availability states/
 * Состояния доступности товара
 */
export declare enum MetaOpenGraphAvailability {
    /** In stock, available for purchase/ В наличии, доступен для покупки */
    inStock = "in stock",
    /** Out of stock, currently unavailable/ Нет в наличии, в настоящее время недоступен */
    outOfStock = "out of stock",
    /** Available for pre-order/ Доступен для предзаказа */
    preorder = "preorder",
    /**
     * Backordered, temporarily out of stock/
     * В ожидании поставки, временно отсутствует на складе
     */
    backorder = "backorder",
    /** Discontinued, no longer available/ Снят с производства, больше не доступен */
    discontinued = "discontinued",
    /**
     * Pending availability status/
     * Ожидается информация о доступности
     */
    pending = "pending"
}

/**
 * Product condition states/
 * Состояния товара
 */
export declare enum MetaOpenGraphCondition {
    /** Brand new product, never used/ Новый товар, не использовался */
    new = "new",
    /** Used product, previously owned/ Подержанный, бывший в употреблении */
    used = "used",
    /**
     * Refurbished / restored product/
     * Восстановленный (ремонтированный, refurbished)
     */
    refurbished = "refurbished"
}

/**
 * Gender categories for products/
 * Гендерные категории для товаров
 */
export declare enum MetaOpenGraphGender {
    /** For women/ Для женщин */
    female = "female",
    /** For men/ Для мужчин */
    male = "male",
    /** Universal / suitable for everyone/ Универсальное / подходит всем */
    unisex = "unisex"
}

/**
 * Enumeration of Open Graph tags for metadata/
 * Перечисление Open Graph тegов для мета-данных
 * @enum {string}
 */
export declare enum MetaOpenGraphTag {
    /** Page title/ Заголовок страницы */
    title = "og:title",
    /**
     * Content type (website, article, product, video, profile, etc.)/
     * Тип контента (website, article, product, video, profile и т.д.)
     */
    type = "og:type",
    /** Canonical URL of the page/ Канонический URL страницы */
    url = "og:url",
    /** Preview image URL/ Ссылка на изображение для предпросмотра */
    image = "og:image",
    /**
     * Brief page description (up to ~200 characters)/
     * Краткое описание страницы (до ~200 символов)
     */
    description = "og:description",
    /**
     * Page language (e.g., ru_RU, en_US)/
     * Язык страницы (например: ru_RU, en_US)
     */
    locale = "og:locale",
    /** Site name/ Название сайта */
    siteName = "og:site_name",
    /**
     * Alternative language versions (for multilingual sites)/
     * Альтернативные языковые версии (для мультиязычных сайтов)
     */
    localeAlternate = "og:locale:alternate",
    /**
     * Alternative form of og:image/
     * Альтернативная форма записи og:image
     */
    imageUrl = "og:image:url",
    /** HTTPS version of the image/ HTTPS-версия изображения */
    imageSecureUrl = "og:image:secure_url",
    /**
     * Image MIME type (image/jpeg, image/png)/
     * MIME-тип изображения (image/jpeg, image/png)
     */
    imageType = "og:image:type",
    /** Image width in pixels/ Ширина изображения в пикселях */
    imageWidth = "og:image:width",
    /** Image height in pixels/ Высота изображения в пикселях */
    imageHeight = "og:image:height",
    /**
     * Alternative image text (for accessibility)/
     * Альтернативный текст изображения (для доступности)
     */
    imageAlt = "og:image:alt",
    /** Video URL/ Ссылка на видео */
    video = "og:video",
    /** Alternative video URL/ Альтернативная ссылка на видео */
    videoUrl = "og:video:url",
    /** HTTPS version of video/ HTTPS-версия видео */
    videoSecureUrl = "og:video:secure_url",
    /**
     * Video MIME type (video/mp4, video/webm)/
     * MIME-тип видео (video/mp4, video/webm)
     */
    videoType = "og:video:type",
    /** Video width/ Ширина видео */
    videoWidth = "og:video:width",
    /** Video height/ Высота видео */
    videoHeight = "og:video:height",
    /** Audio file URL/ Ссылка на аудиофайл */
    audio = "og:audio",
    /** HTTPS version of audio/ HTTPS-версия аудио */
    audioSecureUrl = "og:audio:secure_url",
    /** Audio MIME type (audio/mpeg)/ MIME-тип аудио (audio/mpeg) */
    audioType = "og:audio:type",
    /** Publication date/ Дата публикации */
    articlePublishedTime = "article:published_time",
    /** Last update date/ Дата последнего обновления */
    articleModifiedTime = "article:modified_time",
    /** Expiration date (if any)/ Дата устаревания (если есть) */
    articleExpirationTime = "article:expiration_time",
    /** Author (URL or name)/ Автор (URL или имя) */
    articleAuthor = "article:author",
    /** Article category/ Категория статьи */
    articleSection = "article:section",
    /** Tags / keywords/ Теги / ключевые слова */
    articleTag = "article:tag",
    /** Book author/ Автор книги */
    bookAuthor = "book:author",
    /** Book ISBN/ ISBN книги */
    bookIsbn = "book:isbn",
    /** Book publication date/ Дата публикации книги */
    bookReleaseDate = "book:release_date",
    /** Topics / tags/ Темы / теги */
    bookTag = "book:tag",
    /**
     * Track duration (in seconds)/
     * Длительность трека (в секундах)
     */
    musicDuration = "music:duration",
    /** Album URL/ Ссылка на альбом */
    musicAlbum = "music:album",
    /** Disc number/ Номер диска */
    musicAlbumDisc = "music:album:disc",
    /** Track number in album/ Номер трека в альбоме */
    musicAlbumTrack = "music:album:track",
    /** Musician/ Исполнитель */
    musicMusician = "music:musician",
    /** Song URL/ Ссылка на песню */
    musicSong = "music:song",
    /**
     * Disc number where the song is/
     * Номер диска, на котором песня
     */
    musicSongDisc = "music:song:disc",
    /** Track number in song/ Номер трека в песне */
    musicSongTrack = "music:song:track",
    /** Release date/ Дата релиза */
    musicReleaseDate = "music:release_date",
    /** Content creator/ Создатель контента */
    musicCreator = "music:creator",
    /** Actor/ Актёр */
    videoActor = "video:actor",
    /** Actor's role/ Роль актёра */
    videoActorRole = "video:actor:role",
    /** Director/ Режиссёр */
    videoDirector = "video:director",
    /** Screenwriter/ Сценарист */
    videoWriter = "video:writer",
    /**
     * Video duration (in seconds)/
     * Длительность видео (в секундах)
     */
    videoDuration = "video:duration",
    /** Video release date/ Дата выхода видео */
    videoReleaseDate = "video:release_date",
    /** Tags / topics/ Теги / темы видео */
    videoTag = "video:tag",
    /**
     * Series to which the episode belongs/
     * Сериал, к которому относится эпизод
     */
    videoSeries = "video:series",
    /** First name/ Имя */
    profileFirstName = "profile:first_name",
    /** Last name/ Фамилия */
    profileLastName = "profile:last_name",
    /** Username / login/ Имя пользователя / логин */
    profileUsername = "profile:username",
    /** Gender (male / female)/ Пол (male / female) */
    profileGender = "profile:gender",
    /** Brand name/ Название бренда */
    productBrand = "product:brand",
    /**
     * Product availability (in stock / out of stock / preorder)/
     * Наличие товара (in stock / out of stock / preorder)
     */
    productAvailability = "product:availability",
    /**
     * Product condition (new / used / refurbished)/
     * Состояние товара (new / used / refurbished)
     */
    productCondition = "product:condition",
    /** Price/ Цена */
    productPriceAmount = "product:price:amount",
    /**
     * Currency (USD, RUB, EUR, etc.)/
     * Валюта (USD, RUB, EUR и т.д.)
     */
    productPriceCurrency = "product:price:currency",
    /** Internal product ID/ Внутренний ID товара */
    productRetailerItemId = "product:retailer_item_id",
    /** Product category/ Категория товара */
    productCategory = "product:category",
    /** EAN code/ EAN код */
    productEan = "product:ean",
    /** ISBN (if product is a book)/ ISBN (если товар — книга) */
    productIsbn = "product:isbn",
    /** Manufacturer part number/ Номер производителя */
    productMfrPartNo = "product:mfr_part_no",
    /** UPC code/ UPC код */
    productUpc = "product:upc",
    /** Weight (value)/ Вес (значение) */
    productWeightValue = "product:weight:value",
    /**
     * Weight (units, e.g., kg)/
     * Вес (единицы измерения, например: kg)
     */
    productWeightUnits = "product:weight:units",
    /** Product color/ Цвет товара */
    productColor = "product:color",
    /** Product material/ Материал товара */
    productMaterial = "product:material",
    /** Pattern / design/ Узор / дизайн */
    productPattern = "product:pattern",
    /**
     * Age group (adult, kids, baby)/
     * Возрастная группа (adult, kids, baby)
     */
    productAgeGroup = "product:age_group",
    /**
     * Gender (for whom — male, female, unisex)/
     * Пол (для кого — male, female, unisex)
     */
    productGender = "product:gender"
}

/**
 * Possible content types for Open Graph (og:type)/
 * Возможные типы контента для Open Graph (og:type)
 */
export declare enum MetaOpenGraphType {
    /**
     * Regular web page or article/
     * Обычная веб-страница или статья
     */
    website = "website",
    /**
     * News article, blog post, or other text material/
     * Новостная статья, блог-пост или другой текстовый материал
     */
    article = "article",
    /**
     * Video (e.g., clip, film, series, music video)/
     * Видео (например, ролик, фильм, сериал, клип)
     */
    video = "video.other",
    /** Entire TV series/ Сериал целиком */
    videoTvShow = "video.tv_show",
    /**
     * Specific TV series episode/
     * Конкретный эпизод сериала
     */
    videoEpisode = "video.episode",
    /** Movie/ Фильм */
    videoMovie = "video.movie",
    /** Music album/ Музыкальный альбом */
    musicAlbum = "music.album",
    /** Music playlist/ Музыкальный плейлист */
    musicPlaylist = "music.playlist",
    /** Individual track (song)/ Отдельный трек (песня) */
    musicSong = "music.song",
    /**
     * Radio station or audio stream/
     * Радиостанция или стрим аудио
     */
    musicRadioStation = "music.radio_station",
    /**
     * Application (web, mobile, or desktop)/
     * Приложение (веб-, мобильное или десктопное)
     */
    app = "app",
    /**
     * Product or item (e.g., in a store)/
     * Продукт или товар (например, в магазине)
     */
    product = "product",
    /**
     * Brand, company, organization/
     * Бренд, компания, организация
     */
    business = "business.business",
    /**
     * Place (geolocation, point on a map)/
     * Место (геолокация, точка на карте)
     */
    place = "place",
    /**
     * Event (event, meeting, concert, etc.)/
     * Событие (ивент, встреча, концерт и т.п.)
     */
    event = "event",
    /**
     * User profile (personal page, author, etc.)/
     * Профиль пользователя (личная страница, автор и т.д.)
     */
    profile = "profile",
    /** Book page/ Страница книги */
    book = "book"
}

export declare enum MetaRobots {
    /**
     * Allow indexing and following links (default)/
     * Разрешает индексировать страницу и переходить по ссылкам (по умолчанию)
     */
    indexFollow = "index, follow",
    /**
     * Do not index the page, but follow its links/
     * Не индексировать страницу, но переходить по ссылкам
     */
    noIndexFollow = "noindex, follow",
    /**
     * Index the page, but do not follow its links/
     * Индексировать страницу, но не переходить по ссылкам
     */
    indexNoFollow = "index, nofollow",
    /**
     * Do not index the page and do not follow its links/
     * Не индексировать страницу и не переходить по ссылкам
     */
    noIndexNoFollow = "noindex, nofollow",
    /** Prevent caching of the page/ Запрещает кэширование страницы */
    noArchive = "noarchive",
    /**
     * Do not show a snippet or description in search results/
     * Не показывать сниппет (описание) в результатах поиска
     */
    noSnippet = "nosnippet",
    /**
     * Do not display image preview in search results/
     * Не показывать превью изображений в результатах поиска
     */
    noImageIndex = "noimageindex",
    /** Allow indexing images only/ Разрешить индексировать только изображения */
    images = "images",
    /**
     * Do not show cached version or translation link/
     * Не показывать кэш и ссылку "Перевести" в результатах
     */
    noTranslate = "notranslate",
    /**
     * Prevent page being shown in "Preview" (Instant Preview)/
     * Не показывать страницу в предпросмотре (Instant Preview)
     */
    noPreview = "nopreview",
    /**
     * Allow only text content indexing (no media)/
     * Разрешить индексировать только текст, без медиа
     */
    textOnly = "textonly",
    /**
     * Do not index subpages or parameters/
     * Не индексировать подстраницы или страницы с параметрами
     */
    noIndexSubpages = "noindex, noarchive",
    /**
     * Use meta directives from HTTP headers (advanced)/
     * Использовать директивы из HTTP-заголовков (расширенная настройка)
     */
    none = "none"
}

/**
 * Static class for managing meta tags.
 *
 * Статичный класс для управления мета-тегами.
 */
export declare class MetaStatic {
    /**
     * Returns the singleton instance of the Meta class.
     *
     * Возвращает синглтон-экземпляр класса Meta.
     * @returns Meta singleton / синглтон Meta
     */
    static getItem(): Meta;
    /**
     * Gets the MetaOg instance for advanced Open Graph operations.
     *
     * Получает экземпляр MetaOg для расширенных операций с Open Graph.
     * @returns MetaOg instance / экземпляр MetaOg
     */
    static getOg(): MetaOg;
    /**
     * Gets the MetaTwitter instance for advanced Twitter Card operations.
     *
     * Получает экземпляр MetaTwitter для расширенных операций с Twitter Card.
     * @returns MetaTwitter instance / экземпляр MetaTwitter
     */
    static getTwitter(): MetaTwitter;
    /**
     * Gets the page title without suffix.
     *
     * Получает заголовок страницы без суффикса.
     * @returns title without suffix / заголовок без суффикса
     */
    static getTitle(): string;
    /**
     * Gets the keywords meta tag.
     *
     * Получает мета-тег keywords.
     * @returns keywords content / содержимое keywords
     */
    static getKeywords(): string;
    /**
     * Gets the description meta tag.
     *
     * Получает мета-тег description.
     * @returns description content / содержимое description
     */
    static getDescription(): string;
    /**
     * Gets the Open Graph image URL.
     *
     * Получает URL изображения Open Graph.
     * @returns image URL / URL изображения
     */
    static getImage(): string;
    /**
     * Gets the canonical URL.
     *
     * Получает канонический URL.
     * @returns canonical URL / канонический URL
     */
    static getCanonical(): string;
    /**
     * Gets the robots meta tag value.
     *
     * Получает значение мета-тега robots.
     * @returns robots directive / директива robots
     */
    static getRobots(): MetaRobots;
    /**
     * Gets the author meta tag.
     *
     * Получает мета-тег author.
     * @returns author name / имя автора
     */
    static getAuthor(): string;
    /**
     * Gets the Open Graph site name.
     *
     * Получает название сайта Open Graph.
     * @returns site name / название сайта
     */
    static getSiteName(): string;
    /**
     * Gets the Open Graph locale.
     *
     * Получает локаль Open Graph.
     * @returns locale / локаль
     */
    static getLocale(): string;
    /**
     * Sets the page title (with suffix) and updates Open Graph and Twitter Card titles.
     *
     * Устанавливает заголовок страницы (с суффиксом) и обновляет заголовки Open Graph и Twitter Card.
     * @param title page title / заголовок страницы
     */
    static setTitle(title: string): typeof MetaStatic;
    /**
     * Sets the keywords meta tag.
     *
     * Устанавливает мета-тег keywords.
     * @param keywords keywords as string or array / ключевые слова в виде строки или массива
     */
    static setKeywords(keywords: string | string[]): typeof MetaStatic;
    /**
     * Sets the description meta tag.
     *
     * Устанавливает мета-тег description.
     * @param description page description / описание страницы
     */
    static setDescription(description: string): typeof MetaStatic;
    /**
     * Sets the image for Open Graph and Twitter Card.
     *
     * Устанавливает изображение для Open Graph и Twitter Card.
     * @param image image URL / URL изображения
     */
    static setImage(image: string): typeof MetaStatic;
    /**
     * Sets the canonical URL and updates Open Graph and Twitter Card URLs.
     *
     * Устанавливает канонический URL и обновляет URL для Open Graph и Twitter Card.
     * @param canonical canonical URL / канонический URL
     */
    static setCanonical(canonical: string): typeof MetaStatic;
    /**
     * Sets the robots meta tag.
     *
     * Устанавливает мета-тег robots.
     * @param robots robots directive / директива robots
     */
    static setRobots(robots: MetaRobots): typeof MetaStatic;
    /**
     * Sets the author meta tag.
     *
     * Устанавливает мета-тег author.
     * @param author author name / имя автора
     */
    static setAuthor(author: string): typeof MetaStatic;
    /**
     * Sets the site name for Open Graph and Twitter Card.
     *
     * Устанавливает название сайта для Open Graph и Twitter Card.
     * @param siteName site name / название сайта
     */
    static setSiteName(siteName: string): typeof MetaStatic;
    /**
     * Sets the locale for Open Graph.
     *
     * Устанавливает локаль для Open Graph.
     * @param locale locale (e.g. 'en_US', 'ru_RU') / локаль (например, 'en_US', 'ru_RU')
     */
    static setLocale(locale: string): typeof MetaStatic;
    /**
     * Sets the suffix to append to page title.
     *
     * Устанавливает суффикс для добавления к заголовку страницы.
     * @param suffix title suffix (e.g. 'My Site') / суффикс заголовка (например, 'Мой Сайт')
     */
    static setSuffix(suffix?: string): typeof MetaStatic;
    /**
     * Generates the complete HTML for all meta-tags including Open Graph and Twitter Card.
     *
     * Генерирует полный HTML для всех мета-тегов, включая Open Graph и Twitter Card.
     * @returns complete HTML string / полная HTML-строка
     */
    static html(): string;
    /**
     * Generates the title as an HTML-safe string.
     *
     * Генерирует заголовок в виде HTML-безопасной строки.
     * @returns title HTML-safe string / HTML-безопасная строка заголовка
     */
    static htmlTitle(): string;
}

/**
 * Standard HTML meta tags/
 * Стандартные HTML мета-теги
 * @enum {string}
 */
export declare enum MetaTag {
    /** Page title/ Заголовок страницы */
    title = "title",
    /** Page description/ Описание страницы */
    description = "description",
    /** Keywords/ Ключевые слова */
    keywords = "keywords",
    /** Canonical URL/ Канонический URL */
    canonical = "canonical",
    /** Search engine instructions/ Инструкции для поисковиков */
    robots = "robots",
    /** Content author/ Автор контента */
    author = "author"
}

/**
 * Class for working with Twitter Card meta tags.
 *
 * Класс для управления мета-тегами Twitter Card.
 */
export declare class MetaTwitter extends MetaManager<MetaTwitterTag[]> {
    /**
     * Constructor for MetaTwitter.
     *
     * Конструктор для MetaTwitter.
     */
    constructor();
    /**
     * Gets the Twitter Card type.
     *
     * Получает тип Twitter Card.
     * @returns card type / тип карточки
     */
    getCard(): MetaTwitterCard;
    /**
     * Gets the website or brand @username.
     *
     * Получает аккаунт сайта или бренда (@username).
     * @returns @username / аккаунт
     */
    getSite(): string;
    /**
     * Gets the content creator @username.
     *
     * Получает автора контента (@username).
     * @returns @username / аккаунт автора
     */
    getCreator(): string;
    /**
     * Gets the page URL.
     *
     * Получает URL страницы.
     * @returns URL / URL адрес
     */
    getUrl(): string;
    /**
     * Gets the card title.
     *
     * Получает заголовок карточки.
     * @returns title / заголовок
     */
    getTitle(): string;
    /**
     * Gets the card description.
     *
     * Получает описание карточки.
     * @returns description / описание
     */
    getDescription(): string;
    /**
     * Gets the card image URL.
     *
     * Получает URL изображения карточки.
     * @returns image URL / URL изображения
     */
    getImage(): string;
    /**
     * Sets the Twitter Card type.
     *
     * Устанавливает тип Twitter Card.
     * @param card card type / тип карточки
     * @returns current instance / текущий экземпляр
     */
    setCard(card: MetaTwitterCard): this;
    /**
     * Sets the website or brand @username.
     *
     * Устанавливает аккаунт сайта или бренда (@username).
     * @param site @username / аккаунт
     * @returns current instance / текущий экземпляр
     */
    setSite(site: string): this;
    /**
     * Sets the content creator @username.
     *
     * Устанавливает автора контента (@username).
     * @param creator @username / аккаунт автора
     * @returns current instance / текущий экземпляр
     */
    setCreator(creator: string): this;
    /**
     * Sets the page URL.
     *
     * Устанавливает URL страницы.
     * @param url URL / URL адрес
     * @returns current instance / текущий экземпляр
     */
    setUrl(url: string): this;
    /**
     * Sets the card title.
     *
     * Устанавливает заголовок карточки.
     * @param title title / заголовок
     * @returns current instance / текущий экземпляр
     */
    setTitle(title: string): this;
    /**
     * Sets the card description.
     *
     * Устанавливает описание карточки.
     * @param description description / описание
     * @returns current instance / текущий экземпляр
     */
    setDescription(description: string): this;
    /**
     * Sets the card image URL.
     *
     * Устанавливает URL изображения карточки.
     * @param image image URL / URL изображения
     * @returns current instance / текущий экземпляр
     */
    setImage(image: string): this;
}

/**
 * Twitter Card types/
 * Возможные значения для `twitter:card`
 */
export declare enum MetaTwitterCard {
    /**
     * Summary card — small image, short title and description/
     * Карточка-сводка — небольшое изображение, короткий заголовок и описание
     */
    summary = "summary",
    /**
     * Summary card with large image — most popular card type/
     * Карточка с большим изображением — самый распространённый тип
     */
    summaryLargeImage = "summary_large_image",
    /**
     * App card — used for promoting mobile applications (iOS / Android)/
     * Карточка приложения — используется для продвижения мобильных приложений (iOS / Android)
     */
    app = "app",
    /**
     * Player card — for embedding video, audio, or other rich media/
     * Карточка плеера — для встроенного видео, аудио или интерактивного контента
     */
    player = "player",
    /**
     * Product card (deprecated) — used for e-commerce products/
     * Карточка товара (устаревшая) — использовалась для отображения товаров в Twitter
     */
    product = "product",
    /**
     * Gallery card (deprecated) — used for displaying multiple images/
     * Галерея (устаревшая) — использовалась для показа нескольких изображений
     */
    gallery = "gallery",
    /**
     * Photo card (deprecated) — single image card, replaced by summary_large_image/
     * Фото-карточка (устаревшая) — карточка с одним изображением, заменена на summary_large_image
     */
    photo = "photo",
    /**
     * Lead generation card (deprecated) — for collecting user data (via CTA)/
     * Карточка для лидогенерации (устаревшая) — использовалась для сбора данных пользователей через кнопку
     */
    leadGeneration = "lead_generation",
    /**
     * Audio card (experimental) — similar to player, but focused on audio players/
     * Аудио-карточка (экспериментальная) — аналог player, ориентирована на аудио
     */
    audio = "audio",
    /**
     * Poll card (internal/experimental) — used for Twitter polls/
     * Карточка опроса (внутренняя/экспериментальная) — используется для твитов-опросов
     */
    poll = "poll"
}

/**
 * Twitter Card meta-properties/
 * Мета теги Twitter Card
 */
export declare enum MetaTwitterTag {
    /**
     * Type of card (summary, summary_large_image, app, player, product)/
     * Тип карточки (summary, summary_large_image, app, player, product)
     */
    card = "twitter:card",
    /** Website or brand @username/ Аккаунт сайта или бренда (@username) */
    site = "twitter:site",
    /** Content creator @username/ Автор контента (@username) */
    creator = "twitter:creator",
    /** Page URL/ URL страницы */
    url = "twitter:url",
    /** Title of the card/ Заголовок карточки */
    title = "twitter:title",
    /** Short description of the card/ Краткое описание карточки */
    description = "twitter:description",
    /** Main image for the card/ Основное изображение карточки */
    image = "twitter:image",
    /**
     * Alternative text for the image (for accessibility)/
     * Альтернативный текст изображения (для доступности)
     */
    imageAlt = "twitter:image:alt",
    /**
     * Alternative way to define image source/
     * Альтернативный способ указания изображения
     */
    imageSrc = "twitter:image:src",
    /** Image width (optional)/ Ширина изображения (опционально) */
    imageWidth = "twitter:image:width",
    /** Image height (optional)/ Высота изображения (опционально) */
    imageHeight = "twitter:image:height",
    /**
     * Custom label 1 (used in summary/product cards)/
     * Пользовательская метка 1 (используется в summary/product карточках)
     */
    label1 = "twitter:label1",
    /**
     * Custom value 1 (used with label1)/
     * Пользовательское значение 1 (используется с label1)
     */
    data1 = "twitter:data1",
    /**
     * Custom label 2 (used in summary/product cards)/
     * Пользовательская метка 2 (используется в summary/product карточках)
     */
    label2 = "twitter:label2",
    /**
     * Custom value 2 (used with label2)/
     * Пользовательское значение 2 (используется с label2)
     */
    data2 = "twitter:data2",
    /** iPhone app name/ Название приложения для iPhone */
    appNameIphone = "twitter:app:name:iphone",
    /**
     * iPhone app ID (App Store ID)/
     * Идентификатор приложения в App Store (iPhone)
     */
    appIdIphone = "twitter:app:id:iphone",
    /** iPhone app URL (deep link)/ Ссылка на приложение iPhone (deep link) */
    appUrlIphone = "twitter:app:url:iphone",
    /** iPad app name/ Название приложения для iPad */
    appNameIpad = "twitter:app:name:ipad",
    /**
     * iPad app ID (App Store ID)/
     * Идентификатор приложения в App Store (iPad)
     */
    appIdIpad = "twitter:app:id:ipad",
    /** iPad app URL (deep link)/ Ссылка на приложение iPad (deep link) */
    appUrlIpad = "twitter:app:url:ipad",
    /** Google Play app name/ Название приложения в Google Play */
    appNameGooglePlay = "twitter:app:name:googleplay",
    /**
     * Google Play app ID (package name)/
     * Идентификатор приложения в Google Play (package name)
     */
    appIdGooglePlay = "twitter:app:id:googleplay",
    /**
     * Google Play app URL (deep link)/
     * Ссылка на приложение в Google Play (deep link)
     */
    appUrlGooglePlay = "twitter:app:url:googleplay",
    /** Player iframe URL/ URL iframe плеера */
    player = "twitter:player",
    /** Player width/ Ширина плеера */
    playerWidth = "twitter:player:width",
    /** Player height/ Высота плеера */
    playerHeight = "twitter:player:height",
    /**
     * Direct media stream URL (video/audio)/
     * Прямая ссылка на видео- или аудио поток
     */
    playerStream = "twitter:player:stream",
    /**
     * MIME type of the media stream/
     * MIME-тип потока (например, video/mp4)
     */
    playerStreamContentType = "twitter:player:stream:content_type"
}

/**
 * Generic type that can be either a single value or an array of values/
 * Дженерик тип для одиночного значения или массива значений
 */
export declare type NormalOrArray<T = NumberOrString> = T | T[];

/**
 * Generic type that can be either a direct value or a Promise resolving to that value/
 * Дженерик тип для прямого значения или Promise
 */
export declare type NormalOrPromise<T> = T | Promise<T>;

/** Union type for numeric and string values/ Объединенный тип для числовых и строковых значений */
export declare type NumberOrString = number | string;

/**
 * Union type for numeric, string, and boolean values/
 * Объединенный тип для числовых, строковых и булевых значений
 */
export declare type NumberOrStringOrBoolean = number | string | boolean;

/**
 * Union type for numeric, string, and Date values/
 * Объединенный тип для числовых, строковых значений и Date
 */
export declare type NumberOrStringOrDate = NumberOrString | Date;

/**
 * Generic record/object type with string keys/
 * Дженерик тип записи/объекта со строковыми ключами
 */
export declare type ObjectItem<T = any> = Record<string, T>;

/** Generic type that can be either an array or an object/ Дженерик тип для массива или объекта */
export declare type ObjectOrArray<T = any> = T[] | ObjectItem<T>;

/**
 * Static class for working with data stored in the URL query parameters.
 * Provides a centralized interface delegating to QueryInstance.
 *
 * Статический класс для работы с данными, сохранёнными в query-параметрах URL.
 * Предоставляет централизованный интерфейс, делегируя вызовы QueryInstance.
 */
export declare class Query {
    /**
     * Returns a request-isolated instance of QueryInstance.
     *
     * Возвращает изолированный в рамках запроса экземпляр QueryInstance.
     * @returns QueryInstance instance / экземпляр QueryInstance
     */
    static getItem(): QueryInstance;
    /**
     * Get data from query.
     *
     * Получение данных из query-параметров.
     * @param name variable name / название переменной
     * @param defaultValue value or function to change data / значение или функция для изменения данных
     * @returns stored value / сохранённое значение
     */
    static get<T>(name: string, defaultValue?: T | (() => T)): T;
    /**
     * Change data in query.
     *
     * Изменение данных в query-параметрах.
     * @param name variable name / название переменной
     * @param callback value or function to change data / значение или функция для изменения данных
     */
    static set<T>(name: string, callback: T | (() => T)): void;
    /**
     * Adding an event when data is changed.
     *
     * Добавление события при изменении данных.
     * @param name variable name / название переменной
     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
     */
    static addWatch<T>(name: string, callback: (value: T) => void): void;
    /**
     * Removing an event when data is changed.
     *
     * Удаление события при изменении данных.
     * @param name variable name / название переменной
     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
     */
    static removeWatch<T>(name: string, callback: (value: T) => void): void;
    /**
     * Update query variables from URL string.
     *
     * Обновление переменных query-параметров из строки URL.
     * @returns void / ничего не возвращает
     */
    static reload(): void;
}

/**
 * Class for working with data stored in the URL query parameters.
 *
 * Класс для работы с данными, сохранёнными в query-параметрах URL.
 */
export declare class QueryInstance extends UrlInstanceAbstract {
    /**
     * Initializes query data and registers the popstate listener.
     *
     * Инициализирует данные query-параметров и регистрирует слушатель popstate.
     * @returns this instance / текущий экземпляр
     */
    protected init(): this;
    /**
     * Obtaining data from the URL string.
     *
     * Получение данных из строки URL.
     * @returns Record<string, any> query data / данные query-параметров
     */
    protected getLocation(): Record<string, any>;
    /**
     * Update query string in URL.
     *
     * Обновление строки query-параметров в URL.
     * @returns this instance / текущий экземпляр
     */
    protected update(): this;
}

/**
 * Generate a random integer.
 *
 * Генерирует случайное число.
 * @param min the lowest value to return/ наименьшее значение
 * @param max the highest value to return/ наибольшее значение
 * @returns random number/ случайное число
 */
export declare function random(min: number, max: number): number;

/**
 * Removes the common prefix from the main string.
 *
 * Убирает общий префикс из основной строки.
 * @param mainStr - The main string / Основная строка
 * @param prefix - The prefix string to remove / Строка префикса для удаления
 * @returns string without prefix / строка без префикса
 */
export declare function removeCommonPrefix(mainStr: string, prefix: string): string;

/**
 * Replaces the component name in the text.
 *
 * Заменяет имя компонента в тексте.
 * @param text text/ текст
 * @param name component name/ имя компонента
 * @param componentName new component name/ новое имя компонента
 */
export declare const replaceComponentName: (text: string | undefined, name: string, componentName: string) => string | undefined;

/**
 * Merge one or more arrays recursively.
 *
 * Рекурсивное слияние одного или более массивов.
 * @param array the array in which elements are replaced/ массив, элементы которого будут заменены
 * @param replacement arrays from which elements will be extracted/ массивы, из которых будут браться элементы для замены
 * @param isMerge merge one or more arrays/ сливает один или большее количество массивов
 * @returns merged object/ объединенный объект
 */
export declare function replaceRecursive<I>(array: ObjectItem<I>, replacement?: ObjectOrArray<I>, isMerge?: boolean): ObjectItem<I>;

/**
 * Replacing the value from replaces in value.
 *
 * Замена значения из replaces в value.
 * @param value template string/ строка шаблона
 * @param replaces object with data for replacement/ объект с данными для замены
 * @returns replaced string/ замененная строка
 */
export declare function replaceTemplate(value: string, replaces: Record<string, string | FunctionReturn<string>>): string;

/**
 * Asynchronously resizes an image to fit within maximum size constraints.
 *
 * Асинхронно изменяет размер изображения в соответствии с ограничением максимального размера.
 * @param image image source string (URL or base64) or HTMLImageElement / строка источника изображения (URL или base64) или HTMLImageElement
 * @param maxSize maximum width or height in pixels / максимальная ширина или высота в пикселях
 * @param typeData optional MIME type for the resulting image / необязательный MIME-тип для результирующего изображения
 * @returns promise with resized image data as base64 or original source / промис с данными измененного изображения в формате base64 или исходным источником
 */
export declare function resizeImage(image: HTMLImageElement | string, maxSize?: number, typeData?: string): Promise<string>;

/**
 * Resizes an image to fit within a maximum size constraint.
 *
 * Изменяет размер изображения в соответствии с ограничением максимального размера.
 * @param image image element or URL / элемент изображения или URL
 * @param maxSize maximum size for width or height / максимальный размер ширины или высоты
 * @param type resize type (auto, width, height) / тип изменения размера (auto, width, height)
 * @param typeData optional data type for the resulting image /
 * необязательный тип данных для результирующего изображения
 * @returns base64 image string or undefined / строка base64 изображения или undefined
 */
export declare function resizeImageByMax(image: HTMLImageElement | string, maxSize: number, type?: ResizeImageByMaxType, typeData?: string): string | undefined;

/**
 * Resize type for image scaling.
 *
 * Тип изменения размера для масштабирования изображения.
 */
declare type ResizeImageByMaxType = 'auto' | 'width' | 'height';

/**
 * Class for creating a timer that can be paused and resumed.
 *
 * Класс для создания таймера, который можно приостанавливать и возобновлять.
 */
export declare class ResumableTimer {
    protected callback: FunctionVoid;
    protected delay: number;
    /** setTimeout identifier / Идентификатор setTimeout */
    protected timerId?: ReturnType<typeof setTimeout>;
    /** Timestamp when timer started / Метка времени старта таймера */
    protected startTime?: number;
    /** Remaining milliseconds / Оставшиеся миллисекунды */
    protected remaining?: number;
    /** Completion flag / Флаг завершения */
    protected completed: boolean;
    /**
     * Constructor
     * @param callback function to be called after the delay / функция, которая будет вызвана после задержки
     * @param delay delay in milliseconds / задержка в миллисекундах
     * @param blockStart if true, the timer will not start immediately / если true, таймер не запустится сразу
     */
    constructor(callback: FunctionVoid, delay?: number, blockStart?: boolean);
    /**
     * Resumes the timer if it was paused or starts it for the first time.
     *
     * Возобновляет таймер, если он был приостановлен, или запускает его впервые.
     */
    resume(): this;
    /**
     * Pauses the timer and calculates the remaining time.
     *
     * Приостанавливает таймер и вычисляет оставшееся время.
     */
    pause(): this;
    /**
     * Resets and restarts the timer with the original delay.
     *
     * Сбрасывает и перезапускает таймер с исходной задержкой.
     */
    reset(): this;
    /**
     * Completely clears the timer and resets its state.
     *
     * Полностью очищает таймер и сбрасывает его состояние.
     */
    clear(): this;
    /**
     * Returns the remaining time or the initial delay.
     *
     * Возвращает оставшееся время или начальную задержку.
     */
    protected getRemaining(): number;
    /**
     * Returns the time when the timer was started or the current time.
     *
     * Возвращает время запуска таймера или текущее время.
     */
    protected getStartTime(): number;
    /**
     * Executes the callback and marks the timer as completed.
     *
     * Выполняет колбэк и отмечает таймер как завершенный.
     */
    protected go(): this;
    /**
     * Updates the remaining time based on the elapsed time.
     *
     * Обновляет оставшееся время на основе прошедшего времени.
     */
    protected updateRemaining(): this;
    /**
     * Sets the current time as the start time.
     *
     * Устанавливает текущее время как время начала.
     */
    protected updateStartTime(): this;
    /**
     * Stops the timer and clears the timeout ID.
     *
     * Останавливает таймер и очищает идентификатор таймаута.
     */
    protected stop(): this;
}

/**
 * Class for getting the scroll width.
 *
 * Класс для получения ширины скролла.
 */
export declare class ScrollbarWidth {
    /** Calculation state flag / Флаг состояния вычисления */
    private static calculate;
    /**
     * Checks whether to enable scroll hiding.
     *
     * Проверяет, надо ли включить скрытие скролла.
     * @returns boolean indicating if scroll hiding is enabled/ логическое значение, указывающее, включено ли скрытие скролла
     */
    static is(): Promise<boolean>;
    /**
     * Returns the width of the scroll.
     *
     * Возвращает ширину скролла.
     * @returns scrollbar width in pixels/ ширина скролла в пикселях
     */
    static get(): Promise<number>;
    /**
     * Returns the storage for scroll width.
     *
     * Возвращает хранилище для ширины скролла.
     * @returns DataStorage instance/ экземпляр DataStorage
     */
    static getStorage(): DataStorage<number>;
    /**
     * Returns the calculate flag, indicating if width calculation is in progress.
     *
     * Возвращает флаг вычисления, указывающий, идет ли расчет ширины.
     * @returns calculation flag/ флаг вычисления
     */
    static getCalculate(): boolean;
    /**
     * Creates elements to check the width of the scroll.
     *
     * Создает элементы для проверки ширины скролла.
     * @returns created element / созданный элемент
     */
    private static createElement;
    /**
     * Initialization of data to check the width of the scroll.
     *
     * Инициализация данных для проверки ширины скролла.
     * @returns a promise that resolves with the scrollbar width / промис, который разрешается шириной скролла
     */
    private static init;
}

/** Search cache list / Список кэша поиска */
export declare type SearchCache<T extends SearchItem> = SearchCacheItem<T>[];

/** Search cache item / Элемент кэша поиска */
export declare type SearchCacheItem<T extends SearchItem> = {
    /** Original item / Исходный элемент */
    item: T;
    /** Search string value / Строковое значение для поиска */
    value: string;
};

/** Type for getting a column / Тип для получения колонки */
export declare type SearchColumn<T extends SearchItem> = {
    [K in keyof T]-?: NonNullable<T[K]> extends object ? K | SearchColumnPath<K, keyof NonNullable<T[K]>> : K;
}[keyof T];

/** Type for generating a column path / Тип для генерации пути к колонке */
export declare type SearchColumnPath<K, P> = K extends string ? P extends string ? `${K}.${P}` : never : never;

/** Type for a list of columns / Тип для списка колонок */
export declare type SearchColumns<T extends SearchItem> = (SearchColumn<T> & string)[];

/** Type for formatting the key / Тип для форматирования ключа */
export declare type SearchFormatCapitalize<K extends string> = K extends `${infer First}.${infer Rest}` ? `${First}${Capitalize<SearchFormatCapitalize<Rest>>}` : K;

/** Type for a formatted search item / Тип для отформатированного элемента поиска */
export declare type SearchFormatItem<T extends SearchItem, KT extends string[]> = {
    [K in keyof T | SearchFormatKey<KT[number]>]: K extends keyof T ? T[K] : string;
} & {
    searchActive?: boolean;
};

/** Type for generating a search key / Тип для генерации ключа поиска */
export declare type SearchFormatKey<K> = K extends string ? `${SearchFormatCapitalize<K>}Search` : never;

/** Type for a list of formatted search items / Тип для списка отформатированных элементов поиска */
export declare type SearchFormatList<T extends SearchItem, K extends string[]> = SearchFormatItem<T, K>[];

/** Search item type/ Тип элемента поиска */
export declare type SearchItem = Record<string, any>;

/**
 * Main class for managing a searchable list.
 * Coordinates between options, item state, matching logic, and data storage.
 *
 * Основной класс для управления списком с возможностью поиска.
 * Координирует работу опций, состояния элементов, логики сопоставления и хранения данных.
 */
export declare class SearchList<T extends SearchItem, K extends SearchColumns<T>> {
    /** Search options instance / Экземпляр опций поиска */
    protected options: SearchListOptions;
    /** Search list item state / Состояние элемента списка поиска */
    protected item: SearchListItem;
    /** Search matcher instance / Экземпляр сопоставителя поиска */
    protected matcher: SearchListMatcher;
    /** Search data storage instance / Экземпляр хранилища данных поиска */
    protected data: SearchListData<T, K>;
    /**
     * Constructor for SearchList.
     *
     * Конструктор для SearchList.
     * @param list initial list of items/ исходный список элементов
     * @param columns columns to perform search on/ столбцы для выполнения поиска
     * @param value initial search value/ начальное значение поиска
     * @param options search options/ опции поиска
     */
    constructor(list: SearchListValue<T>, columns?: K, value?: string, options?: SearchOptions);
    /**
     * Returns the search data management instance.
     *
     * Возвращает экземпляр управления данными поиска.
     * @returns SearchListData instance/ экземпляр SearchListData
     */
    getData(): SearchListData<T, K>;
    /**
     * Returns the current list of items.
     *
     * Возвращает текущий список элементов.
     * @returns list of items/ список элементов
     */
    getList(): SearchListValue<T>;
    /**
     * Returns the current search columns.
     *
     * Возвращает текущие столбцы поиска.
     * @returns columns or undefined/ столбцы или undefined
     */
    getColumns(): K | undefined;
    /**
     * Returns the search item instance.
     *
     * Возвращает экземпляр элемента поиска.
     * @returns SearchListItem instance/ экземпляр SearchListItem
     */
    getItem(): SearchListItem;
    /**
     * Returns the current search value.
     *
     * Возвращает текущее значение поиска.
     * @returns search value string or undefined/ строка значения поиска или undefined
     */
    getValue(): string | undefined;
    /**
     * Returns the search options instance.
     *
     * Возвращает экземпляр опций поиска.
     * @returns SearchListOptions instance/ экземпляр SearchListOptions
     */
    getOptions(): SearchListOptions;
    /**
     * Sets a new list of items and resets the cache.
     *
     * Устанавливает новый список элементов и сбрасывает кэш.
     * @param list new list/ новый список
     * @returns this instance/ данный экземпляр
     */
    setList(list: SearchListValue<T>): this;
    /**
     * Sets new search columns and resets the cache.
     *
     * Устанавливает новые столбцы поиска и сбрасывает кэш.
     * @param columns new columns/ новые столбцы
     * @returns this instance/ данный экземпляр
     */
    setColumns(columns?: K): this;
    /**
     * Sets a new search value and updates the matcher.
     *
     * Устанавливает новое значение поиска и обновляет сопоставитель.
     * @param value new search value/ новое значение поиска
     * @returns this instance/ данный экземпляр
     */
    setValue(value?: string): this;
    /**
     * Sets new search options and updates the matcher.
     *
     * Устанавливает новые опции поиска и обновляет сопоставитель.
     * @param options new options/ новые опции
     * @returns this instance/ данный экземпляр
     */
    setOptions(options: SearchOptions): this;
    /**
     * Processes the list and returns a formatted list of items based on the current search state.
     *
     * Обрабатывает список и возвращает отформатированный список элементов на основе текущего состояния поиска.
     * @returns formatted list of items/ отформатированный список элементов
     */
    to(): SearchFormatList<T, K>;
    /**
     * Callback for processing items when a search is active.
     * Checks for selection and handles "return everything" option.
     *
     * Обратный вызов для обработки элементов при активном поиске.
     * Проверяет выбор и обрабатывает опцию "возвращать всё".
     * @param item item / элемент
     * @param value search value / значение поиска
     * @returns formatted item or undefined / отформатированный элемент или undefined
     */
    protected readonly callbackToSelection: (item: SearchCacheItem<T>["item"], value: SearchCacheItem<T>["value"]) => SearchFormatItem<T, K> | undefined;
    /**
     * Callback for processing items when no search is active.
     *
     * Обратный вызов для обработки элементов, когда поиск не активен.
     * @param item item / элемент
     * @returns formatted item / отформатированный элемент
     */
    protected readonly callbackToNone: (item: SearchCacheItem<T>["item"]) => SearchFormatItem<T, K>;
}

/**
 * Class for managing and formatting the search data list and its cache.
 *
 * Класс для управления и форматирования списка данных поиска и его кэша.
 */
export declare class SearchListData<T extends SearchItem, K extends SearchColumns<T>> {
    protected list: SearchListValue<T>;
    protected columns: K | undefined;
    protected item: SearchListItem;
    protected options: SearchListOptions;
    /** Search items cache / Кэш элементов поиска */
    protected listCache?: SearchCache<T>;
    /**
     * Constructor for SearchListData.
     *
     * Конструктор для SearchListData.
     * @param list original list of items/ исходный список элементов
     * @param columns columns to search in/ столбцы для поиска
     * @param item current search item state/ текущее состояние элемента поиска
     * @param options search options/ опции поиска
     */
    constructor(list: SearchListValue<T>, columns: K | undefined, item: SearchListItem, options: SearchListOptions);
    /**
     * Checks if both list and columns are provided.
     *
     * Проверяет, предоставлены ли и список, и столбцы.
     * @returns boolean indicating if ready for column-based search/ логическое значение, указывающее на готовность к поиску по столбцам
     */
    is(): this is this & {
        list: T[];
        columns: string[];
    };
    /**
     * Checks if the list is provided.
     *
     * Проверяет, предоставлен ли список.
     * @returns boolean/ логическое значение
     */
    isList(): this is this & {
        list: T[];
    };
    /**
     * Returns the original list.
     *
     * Возвращает исходный список.
     * @returns list value/ значение списка
     */
    getList(): SearchListValue<T>;
    /**
     * Returns the search columns.
     *
     * Возвращает столбцы поиска.
     * @returns columns or undefined/ столбцы или undefined
     */
    getColumns(): K | undefined;
    /**
     * Gets the search cache, initializing it if necessary.
     *
     * Получает кэш поиска, инициализируя его при необходимости.
     * @returns search cache/ кэш поиска
     */
    protected getCache(): SearchCache<T>;
    /**
     * Sets a new list and regenerates the cache.
     *
     * Устанавливает новый список и регенерирует кэш.
     * @param list new list/ новый список
     * @returns this instance/ данный экземпляр
     */
    setList(list: SearchListValue<T>): this;
    /**
     * Sets new search columns and regenerates the cache.
     *
     * Устанавливает новые столбцы поиска и регенерирует кэш.
     * @param columns new columns/ новые столбцы
     * @returns this instance/ данный экземпляр
     */
    setColumns(columns?: SearchColumns<T>): this;
    /**
     * Finds a cached item corresponding to the given original item.
     *
     * Находит кэшированный элемент, соответствующий данному исходному элементу.
     * @param item original item/ исходный элемент
     * @returns cache item or undefined/ кэшированный элемент или undefined
     */
    findCacheItem(item: T): SearchCacheItem<T> | undefined;
    /**
     * Iterates over the cached list and executes a callback for each item.
     *
     * Перебирает кэшированный список и выполняет обратный вызов для каждого элемента.
     * @param callback function to execute for each item/ функция для выполнения для каждого элемента
     * @returns formatted list/ отформатированный список
     */
    forEach(callback: (item: SearchCacheItem<T>['item'], value: SearchCacheItem<T>['value']) => SearchFormatItem<T, K> | undefined): SearchFormatList<T, K>;
    /**
     * Converts a single item to a formatted item with highlighted matches if selected.
     *
     * Преобразует один элемент в отформатированный элемент с выделенными совпадениями, если он выбран.
     * @param item original item/ исходный элемент
     * @param selection whether the item matches the search and should be highlighted/ совпадает ли элемент с поиском и должен ли он быть выделен
     * @returns formatted item/ отформатированный элемент
     */
    toFormatItem(item: T, selection: boolean): SearchFormatItem<T, K>;
    /**
     * Formats a column path to a camelCase property name with a 'Search' suffix.
     *
     * Форматирует путь к столбцу в имя свойства camelCase с суффиксом 'Search'.
     * @param column column path/ путь к столбцу
     * @returns property name/ имя свойства
     */
    protected getColumnName(column: string): string;
    /**
     * Adds highlight tags to the given value based on the current search value.
     *
     * Добавляет теги выделения к данному значению на основе текущего значения поиска.
     * @param value value to highlight/ значение для выделения
     * @returns highlighted string/ выделенная строка
     */
    protected addTag(value: any): string;
    /**
     * Generates a search cache for the current list and columns.
     *
     * Генерирует кэш поиска для текущего списка и столбцов.
     * @returns search cache/ кэш поиска
     */
    protected generateCache(): SearchCache<T>;
    /**
     * Initializes the search cache.
     *
     * Инициализирует кэш поиска.
     * @returns void / ничего не возвращает
     */
    protected initCache(): void;
    /**
     * Resets the search cache.
     *
     * Сбрасывает кэш поиска.
     * @returns void / ничего не возвращает
     */
    protected resetCache(): void;
}

/**
 * Class representing a single search item's value and its search-related state.
 *
 * Класс, представляющий значение одного элемента поиска и его состояние, связанное с поиском.
 */
export declare class SearchListItem {
    protected value: string | undefined;
    protected options: SearchListOptions;
    /**
     * Constructor for SearchListItem.
     *
     * Конструктор для SearchListItem.
     * @param value current search value/ текущее значение поиска
     * @param options search options/ опции поиска
     */
    constructor(value: string | undefined, options: SearchListOptions);
    /**
     * Checks if the value is filled.
     *
     * Проверяет, заполнено ли значение.
     * @returns boolean indicating if value exists/ логическое значение, указывающее на наличие значения
     */
    is(): this is this & {
        value: string;
    };
    /**
     * Checks if the value is filled and the length is greater than or equal to the limit.
     *
     * Проверяет, заполнено ли значение и длина больше или равна лимиту.
     * @returns boolean/ логическое значение
     */
    isSearch(): boolean;
    /**
     * Returns the current search value as a string.
     *
     * Возвращает текущее значение поиска в виде строки.
     * @returns search value/ значение поиска
     */
    get(): string;
    /**
     * Sets a new search value.
     *
     * Устанавливает новое значение поиска.
     * @param value new search value/ новое значение поиска
     * @returns this instance/ данный экземпляр
     */
    set(value?: string): this;
}

/**
 * Class responsible for matching search values against the search list data using regular expressions.
 *
 * Класс, отвечающий за сопоставление значений поиска с данными списка поиска с использованием регулярных выражений.
 */
export declare class SearchListMatcher {
    protected item: SearchListItem;
    protected options: SearchListOptions;
    /** Regular expression matcher instance / Экземпляр регулярного выражения сопоставителя */
    protected matcher: RegExp | undefined;
    /**
     * Constructor for SearchListMatcher.
     *
     * Конструктор для SearchListMatcher.
     * @param item search item containing the current value/ элемент поиска, содержащий текущее значение
     * @param options search options/ опции поиска
     */
    constructor(item: SearchListItem, options: SearchListOptions);
    /**
     * Checks if the matcher is initialized.
     *
     * Проверяет, инициализирован ли сопоставитель.
     * @returns boolean/ логическое значение
     */
    is(): boolean;
    /**
     * Checks if the given value matches the current search expression.
     *
     * Проверяет, соответствует ли данное значение текущему поисковому выражению.
     * @param value value to check/ проверяемое значение
     * @returns boolean indicating a match/ логическое значение, указывающее на совпадение
     */
    isSelection(value: SearchCacheItem<any>['value']): boolean;
    /**
     * Returns the current regular expression matcher.
     *
     * Возвращает текущий сопоставитель регулярных выражений.
     * @returns RegExp or undefined/ RegExp или undefined
     */
    get(): RegExp | undefined;
    /**
     * Updates the matcher based on the current item value and options.
     *
     * Обновляет сопоставитель на основе текущего значения элемента и опций.
     * @returns void / ничего не возвращает
     */
    update(): void;
    /**
     * Initializes or resets the regular expression matcher.
     *
     * Инициализирует или сбрасывает сопоставитель регулярных выражений.
     * @returns void / ничего не возвращает
     */
    protected initMatcher(): void;
}

/**
 * Class for managing search list options.
 *
 * Класс для управления опциями списка поиска.
 */
export declare class SearchListOptions {
    protected options?: SearchOptions | undefined;
    /**
     * Constructor for SearchListOptions.
     *
     * Конструктор для SearchListOptions.
     * @param options search options/ опции поиска
     */
    constructor(options?: SearchOptions | undefined);
    /**
     * Returns the current search options.
     *
     * Возвращает текущие опции поиска.
     * @returns search options/ опции поиска
     */
    getOptions(): SearchOptions;
    /**
     * Returns the minimum number of characters required to trigger a search.
     *
     * Возвращает минимальное количество символов, необходимых для запуска поиска.
     * @returns limit value/ значение лимита
     */
    getLimit(): number;
    /**
     * Returns whether to return all items even if they don't match the search query.
     *
     * Возвращает, следует ли возвращать все элементы, даже если они не соответствуют поисковому запросу.
     * @returns boolean value/ логическое значение
     */
    getReturnEverything(): boolean;
    /**
     * Returns the search delay in milliseconds.
     *
     * Возвращает задержку поиска в миллисекундах.
     * @returns delay value/ значение задержки
     */
    getDelay(): number;
    /**
     * Returns whether to perform an exact match search.
     *
     * Возвращает, следует ли выполнять поиск с точным совпадением.
     * @returns boolean value/ логическое значение
     */
    getFindExactMatch(): boolean;
    /**
     * Returns the CSS class name used for highlighting matches.
     *
     * Возвращает имя класса CSS, используемое для выделения совпадений.
     * @returns class name/ имя класса
     */
    getClassName(): string;
    /**
     * Sets new search options.
     *
     * Устанавливает новые опции поиска.
     * @param options search options/ опции поиска
     * @returns this instance/ данный экземпляр
     */
    setOptions(options: SearchOptions): this;
}

/** Search list value / Значение списка поиска */
export declare type SearchListValue<T extends SearchItem> = T[] | undefined;

/** Search options / Опции поиска */
export declare type SearchOptions = {
    /** Limit of output values / Лимит выводимых значений */
    limit?: number;
    /** Whether to return all items even if no match / Возвращать ли все элементы, даже если совпадений нет */
    returnEverything?: boolean;
    /** Delay before searching / Задержка перед поиском */
    delay?: number;
    /** Find exact match / Найти точное совпадение */
    findExactMatch?: boolean;
    /** CSS class for matches / CSS класс для совпадений */
    classSearchName?: string;
};

/**
 * Converts seconds into a time string.
 *
 * Преобразовывает секунды в строку с временем.
 * @param second specified seconds/ указанные секунды
 * @param hasHour whether to include hours/ нужно ли указывать часы
 * @returns string formatted time/ форматированная строка с временем
 */
export declare function secondToTime(second: number | string | undefined, hasHour?: boolean): string;

/**
 * Class for managing data storage during server-side rendering (SSR).
 * Handles data isolation between parallel requests by using a request-specific context.
 *
 * Класс для управления хранением данных при серверном рендеринге (SSR).
 * Обеспечивает изоляцию данных между параллельными запросами, используя контекст конкретного запроса.
 */
export declare class ServerStorage {
    /** In-memory storage fallback / Резервное хранилище в памяти */
    protected static storage?: ServerStorageList;
    /** Request context listener / Слушатель контекста запроса */
    protected static listener?: () => Record<string, any> | undefined;
    /** Flag to hide missing storage error / Флаг скрытия ошибки отсутствия хранилища */
    protected static hideError?: boolean;
    /**
     * Initializes the storage with a context listener.
     *
     * Инициализирует хранилище слушателем контекста.
     * @param listener function that returns the current request context / функция, возвращающая контекст текущего запроса
     * @returns this instance / текущий класс
     */
    static init(listener: () => Record<string, any> | undefined): typeof ServerStorage;
    /**
     * Resets the storage.
     *
     * Сбрасывает хранилище.
     */
    static reset(): void;
    /**
     * Checks if a value exists in storage.
     *
     * Проверяет наличие значения в хранилище.
     * @param key unique storage key / уникальный ключ хранилища
     * @returns boolean / логическое значение
     */
    static has(key: string): boolean;
    /**
     * Retrieves a value from storage. If it doesn't exist, creates it using the default value factory.
     *
     * Извлекает значение из хранилища. Если оно не существует, создает его с помощью фабрики значений по умолчанию.
     * @param key unique storage key / уникальный ключ хранилища
     * @param defaultValue function that returns the default value if not found / функция, возвращающая значение по умолчанию, если оно не найдено
     * @param hydration whether the value should be included in hydration / должно ли значение быть включено в гидратацию
     * @returns stored value / сохраненное значение
     */
    static get<T = any>(key: string, defaultValue?: () => T, hydration?: boolean): T;
    /**
     * Saves a value to storage.
     *
     * Сохраняет значение в хранилище.
     * @param key unique storage key / уникальный ключ хранилища
     * @param value function that returns the value to save / функция, возвращающая значение для сохранения
     * @param hydration whether the value should be included in hydration / должно ли значение быть включено в гидратацию
     * @param storageList optional storage list / необязательный список хранилища
     * @returns saved value / сохраненное значение
     */
    static set<T = any>(key: string, value: () => T, hydration?: boolean, storageList?: ServerStorageList): T;
    /**
     * Sets the visibility of error messages.
     *
     * Устанавливает видимость сообщений об ошибках.
     * @param hide boolean value to hide or show errors / логическое значение для скрытия или отображения ошибок
     */
    static setErrorStatus(hide: boolean): void;
    /**
     * Removes a value from storage.
     *
     * Удаляет значение из хранилища.
     * @param key unique storage key / уникальный ключ хранилища
     */
    static remove(key: string): void;
    /**
     * Returns a string representation of the storage for hydration.
     *
     * Возвращает строковое представление хранилища для гидратации.
     * @returns script tag string / строка тега скрипта
     */
    static toString(): string;
    /**
     * Returns storage.
     *
     * Возвращает хранилище.
     * @param isInit whether to initialize the storage if it does not exist / инициализировать ли хранилище, если оно не существует
     * @param status optional status for error reporting / необязательный статус для отчета об ошибках
     * @returns storage list / список хранилища
     */
    protected static getStorage(isInit?: boolean, status?: string): ServerStorageList;
    /**
     * Returns storage from DOM.
     *
     * Возвращает хранилище из DOM.
     * @returns storage list from DOM / список хранилища из DOM
     */
    protected static getStorageDom(): ServerStorageList;
    /**
     * Returns data for hydration.
     *
     * Возвращает данные для гидратации.
     * @returns record of hydration data / запись данных гидратации
     */
    protected static getDataForHydration(): Record<string, any>;
}

/** Item stored in the server storage/ Элемент, хранящийся в серверном хранилище */
declare type ServerStorageItem = {
    value: any;
    hydration: boolean;
};

/** Map of server storage items / Карта элементов серверного хранилища */
declare type ServerStorageList = Record<string, ServerStorageItem>;

/**
 * Modifies the value of an element identified by its key.
 *
 * Изменяет значение элемента, определенного ключом.
 * @param element checked element/ проверяемый элемент
 * @param index index at which we retrieve values/ индекс, по которому получаем значения
 * @param value new value/ новое значение
 * @returns modified element/ измененный элемент
 */
export declare function setElementItem<E extends ElementOrWindow, K extends keyof E, V extends E[K] = E[K]>(element: ElementOrString<E>, index: K, value: V | Record<string, V>): E | undefined;

/**
 * Modifies data according to its type and settings.
 *
 * Изменяет данные в соответствии с их типом и настройками.
 * @param selected base values/ базовые значения
 * @param value new values/ новые значения
 * @param multiple support for multiple values/ поддержка нескольких значений
 * @param maxlength maximum values/ максимальные значения
 * @param alwaysChange updating values in any case/ обновление значений при любом случае
 * @param notEmpty do not make the values empty/ не делать значения пустыми
 * @returns modified values/ измененные значения
 */
export declare function setValues<T>(selected: T | T[] | undefined, value: any, { multiple, maxlength, alwaysChange, notEmpty }: {
    multiple?: boolean | undefined;
    maxlength?: number | undefined;
    alwaysChange?: boolean | undefined;
    notEmpty?: boolean | undefined;
}): T | T[] | undefined;

/**
 * Pause execution for a specified number of milliseconds.
 *
 * Приостановить выполнение на указанное количество миллисекунд.
 * @param ms milliseconds/ миллисекунды
 * @returns promise that resolves after delay/ промис, который разрешается после задержки
 */
export declare function sleep(ms: number): Promise<void>;

/**
 * Single column sorting specification item. /
 * Элемент спецификации сортировки по отдельной колонке.
 */
export declare type SortColumnItem = {
    /** Column or property key for sorting / Колонка или ключ свойства для сортировки */
    column?: string;
    /** Sorting direction ('asc' or 'desc') / Направление сортировки ('asc' или 'desc') */
    dir?: SortDir;
};

/**
 * Sorting direction. /
 * Направление сортировки.
 */
export declare type SortDir = 'asc' | 'desc';

/**
 * Custom sort function signature. /
 * Сигнатура пользовательской функции сортировки.
 */
export declare type SortFunction<T = any> = (a: T, b: T, column?: string, dir?: SortDir) => number;

/**
 * Sorts an array of items by one or more column paths, directions, or a custom comparison function.
 *
 * Сортирует массив элементов по одному или нескольким путям колонок, направлениям или пользовательской функции сравнения.
 * @param list input list array of items / входной список элементов
 * @param sortColumns list of column sorting specifications / список спецификаций сортировки колонок
 * @param customSort optional custom comparison function / необязательная пользовательская функция сравнения
 * @returns new sorted array of items / новый отсортированный массив элементов
 */
export declare function sortList<T = any>(list: T[], sortColumns: SortColumnItem[], customSort?: SortFunction<T>): T[];

/**
 * 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.
 *
 * Метод используется для копирования значений всех перечисляемых свойств одного объекта в другой.
 * В приоритете по списку обработки.
 * @param array the target object/ целевой объект
 * @param replacement the source object/ исходные объекты
 * @param indexStart index at which to start changing the array/ индекс, по которому начинает изменять массив
 * @returns modified array/ измененный массив
 */
export declare function splice<I>(array: ObjectItem<I>, replacement?: ObjectItem<I> | I, indexStart?: string): ObjectItem<I>;

/**
 * A class for working with callback lists for storage.
 *
 * Класс для работы со списками обратных вызовов для хранилища.
 */
export declare class StorageCallback<T = any, Callback = (value: T) => void | Promise<void>> {
    protected name: string;
    protected group: string;
    /**
     * Returns an instance of the class by name.
     *
     * Возвращает экземпляр класса по названию.
     * @param name storage name/ название хранилища
     * @param group storage group/ группа хранилища
     * @returns StorageCallback instance / экземпляр StorageCallback
     */
    static getInstance<T>(name: string, group?: string): StorageCallback<T, (value: T) => void | Promise<void>>;
    /** List of registered callbacks / Список зарегистрированных колбэков */
    protected callbacks: {
        callback: Callback;
        isOnce?: boolean;
    }[];
    /** Loading state / Состояние загрузки */
    protected loading: boolean;
    /**
     * Constructor for initialization.
     *
     * Конструктор для инициализации.
     * @param name storage name/ название хранилища
     * @param group storage group/ группа хранилища
     */
    constructor(name: string, group?: string);
    /**
     * Returns the loading state.
     *
     * Возвращает состояние загрузки.
     * @returns loading state / состояние загрузки
     */
    isLoading(): boolean;
    /**
     * Returns the storage name.
     *
     * Возвращает название хранилища.
     * @returns storage name / название хранилища
     */
    getName(): string;
    /**
     * Returns the loading state.
     *
     * Возвращает состояние загрузки.
     * @returns loading state / состояние загрузки
     */
    getLoading(): boolean;
    /**
     * Adds a callback to the list.
     *
     * Добавляет обратный вызов в список.
     * @param callback function for callbacks/ функция для обратных вызовов
     * @param isOnce whether the callback should only be called once/ является ли колбэк одноразовым
     * @returns this instance / текущий экземпляр
     */
    addCallback(callback: Callback, isOnce?: boolean): this;
    /**
     * Removes a callback from the list.
     *
     * Удаляет обратный вызов из списка.
     * @param callback function for callbacks/ функция для обратных вызовов
     * @returns this instance / текущий экземпляр
     */
    removeCallback(callback: Callback): this;
    /**
     * Preparation of data before launch.
     *
     * Подготовка данных перед запуском.
     * @returns this instance / текущий экземпляр
     */
    preparation(): this;
    /**
     * Execution of all callbacks.
     *
     * Выполнение всех обратных вызовов.
     * @param value storage data/ данные хранилища
     * @returns this instance / текущий экземпляр
     */
    run(value: T): Promise<this>;
}

/**
 * The method creates a string of length count, consisting of the characters value.
 *
 * Метод создает строку длиной count, состоящую из символов value.
 * @param value character for filling/ символ для заполнения
 * @param count length of the string/ длина строки
 * @returns filled string/ заполненная строка
 */
export declare function strFill(value: string, count: number): string;

/**
 * Splits a string by a separator, limited to a certain number of elements.
 * If a limit is specified, the last element will contain the remainder of the string.
 *
 * Разделяет строку по разделителю, ограничивая количество элементов.
 * Если указан лимит, последний элемент будет содержать остаток строки.
 * @param value input value/ входное значение
 * @param separator separator/ разделитель
 * @param limit limit/ лимит
 * @returns split array/ разделенный массив
 */
export declare function strSplit(value: number | string, separator: string, limit?: number): string[];

/**
 * Преобразует значение в массив.
 * Если переданное значение уже является массивом, возвращается оно само.
 * В противном случае значение оборачивается в массив.
 *
 * Converts a value to an array.
 * If the value is already an array, it returns it as is.
 * Otherwise, it wraps the value in an array.
 *
 * @param value - Значение, которое необходимо преобразовать в массив.
 *
 * The value to be converted into an array.
 * @returns Массив, содержащий переданное значение.
 *
 * An array containing the provided value.
 */
export declare function toArray<T>(value: T): T extends any[] ? T : [T];

/**
 * Convert a String to Camel Case (upper).
 *
 * Преобразование строки в Camel Case (upper).
 * @param value input value/ входное значение
 * @returns camel case string/ строка в camel case
 */
export declare function toCamelCase(value: string): string;

/**
 * Convert a String to Camel Case (+ first letter).
 *
 * Преобразование строки в Camel Case (+ первая буква).
 * @param value input value/ входное значение
 * @returns camel case string with first letter uppercase / строка в camel case с первой заглавной буквой
 */
export declare function toCamelCaseFirst(value: string): string;

/**
 * Conversion to Date object.
 *
 * Преобразование в объект Date.
 * @param value input value/ входное значение
 * @returns date object/ объект даты
 */
export declare function toDate<T extends Date | number | string>(value?: T): (T & Date) | Date;

/**
 * Преобразует строку в формат kebab-case.
 * Преобразует все заглавные буквы в строчные, заменяет пробелы и другие символы на дефисы.
 *
 * Converts a string to kebab-case.
 * It converts uppercase letters to lowercase, replaces spaces and other characters with dashes.
 *
 * @param value - Строка, которую необходимо преобразовать.
 *
 * The string to be converted.
 * @returns Строка в формате kebab-case.
 *
 * The string in kebab-case format.
 */
export declare function toKebabCase(value: string): string;

/**
 * Converts a string or number to a finite floating-point number.
 * Handles various separators (spaces, commas, dots) and strips non-numeric characters.
 * Safe for use in SSR (Server-Side Rendering) environments.
 *
 * Преобразует строку или число в конечное число с плавающей точкой.
 * Обрабатывает различные разделители (пробелы, запятые, точки) и удаляет нечисловые символы.
 * Безопасно для использования в SSR (Server-Side Rendering) средах.
 *
 * @param value - The input value to convert / Входное значение для преобразования
 * @returns The parsed number or 0 if conversion fails / Распарсенное число или 0, если конвертация не удалась
 *
 * @example
 * toNumber("1 234,56") // 1234.56
 * toNumber("1,234.56") // 1234.56
 * toNumber("1,234")    // 1.234
 */
export declare function toNumber(value?: NumberOrString): number;

/**
 * Converts the data into a number, taking into account the maximum permissible value.
 *
 * Преобразует данные в число с учетом максимально допустимого значения.
 * @param value input value / входное значение
 * @param max maximum achievable value / максимально достижимое значение
 * @param formatting format the number / форматировать число
 * @param language formatting language / язык форматирования
 * @returns formatted number string or number/ форматированная строка числа или число
 */
export declare function toNumberByMax(value: string | number, max?: string | number, formatting?: boolean, language?: string): string | number;

/**
 * Converts a value to a positive finite number (> 0), or returns default value (0) if invalid.
 *
 * Преобразует значение в конечное положительное число (> 0) или возвращает значение по умолчанию (0), если невалидно.
 * @param value input value / входное значение
 * @param defaultValue default fallback value if invalid / значение по умолчанию, если невалидно
 * @returns parsed positive number or defaultValue / распарсенное положительное число или defaultValue
 */
export declare function toNumberPositive(value?: number | string | null, defaultValue?: number): number;

/**
 * Converts values to percentages
 *
 * Преобразует значения в проценты
 * @param maxValue maximum value/ максимальное значение
 * @param value current value/ текущее значение
 * @returns percentage value / значение в процентах
 */
export declare function toPercent(maxValue: number, value: number): number;

/**
 * Converts values to percentages (three-digit)
 *
 * Преобразует значения в проценты (трёхзначный)
 * @param maxValue maximum value/ максимальное значение
 * @param value current value/ текущее значение
 * @returns percentage value * 100 / значение в процентах * 100
 */
export declare function toPercentBy100(maxValue: number, value: number): number;

/**
 * Converts the given value to a string. Returns an empty string if the value is null or undefined.
 *
 * Преобразование значения в строку. Возвращает пустую строку, если значение равно null или undefined.
 * @param value value for conversion / значение для преобразования
 * @returns string representation of the value / строковое представление значения
 */
declare function toString_2<T>(value: T): string;
export { toString_2 as toString }

/**
 * Преобразует строку в соответствующий тип данных.
 * В зависимости от содержания строки, она может быть преобразована в
 * `undefined`, `null`, `true`, `false`, объект, число или функцию.
 *
 * Transforms a string into the corresponding data type.
 * Based on the string content, it may be transformed into `undefined`,
 * `null`, `true`, `false`, object, number, or function.
 *
 * @param value - Значение, которое необходимо преобразовать
 *
 * The value to be transformed
 * @param isFunction - Флаг, который указывает, необходимо ли проверять функцию
 * в глобальном объекте window
 *
 * A flag that indicates whether to check for a function in the global window object
 * @returns Преобразованное значение
 *
 * The transformed value
 */
export declare function transformation(value: any, isFunction?: boolean): any;

/**
 * Class for getting the translated text.
 *
 * Класс для получения переведенного текста.
 */
export declare class Translate {
    /** TranslateInstance singleton item / Экземпляр синглтона TranslateInstance */
    protected static item?: TranslateInstance;
    /**
     * Getting the translation text by its code.
     *
     * Получение текста перевода по его коду.
     * @param name code name/ название кода
     * @param replacement If set, replaces the text with the specified values/ если установлено, заменяет текст на указанные значения
     * @returns translation text / текст перевода
     */
    static get(name: string, replacement?: string[] | Record<string, string | number>): Promise<string>;
    /**
     * Returns a request-isolated instance of TranslateInstance.
     *
     * Возвращает изолированный в рамках запроса экземпляр TranslateInstance.
     * @returns TranslateInstance instance / экземпляр TranslateInstance
     */
    static getItem(): TranslateInstance;
    /**
     * 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 / если установлено, заменяет текст на указанные значения
     * @returns translation text / текст перевода
     */
    static 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/ список кодов для получения переводов
     * @returns object with translations / объект с переводами
     */
    static 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, возвращает пустую строку, если нет текста
     * @returns object with translations / объект с переводами
     */
    static getListSync<T extends TranslateCode[]>(names: T, first?: boolean): TranslateList<T>;
    /**
     * Added a list of translated texts.
     *
     * Добавлен список переведенных текстов.
     * @param names list of codes to get translations/ список кодов для получения переводов
     */
    static add(names: string | string[]): Promise<void>;
    /**
     * Adds texts in sync mode.
     *
     * Добавляет тексты в режиме синхронизации.
     * @param data list of texts in the form of key-value/ список текстов в виде ключ-значение
     */
    static 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/ список текстов в виде ключ-значение
     */
    static addNormalOrSync(data: Record<string, string>): Promise<void>;
    /**
     * Adds texts synchronously by location.
     *
     * Добавляет тексты синхронно по местоположению.
     * @param data list of texts by location/ список текстов по местоположению
     */
    static addSyncByLocation(data: Record<string, Record<string, string>>): void;
    /**
     * Adds texts synchronously from the file.
     *
     * Добавляет тексты синхронно из файла.
     * @param data file with translations/ файл с переводами
     */
    static addSyncByFile(data: TranslateDataFile): void;
    /**
     * Change the path to the script for obtaining the translation.
     *
     * Изменить путь к скрипту для получения перевода.
     * @param url path to the script/ путь к скрипту
     */
    static setUrl(url: string): void;
    /**
     * Change the name of the property to get the translation.
     *
     * Изменить имя свойства для получения перевода.
     * @param name property name/ имя свойства
     */
    static setPropsName(name: string): void;
    /**
     * Change the read mode from the API.
     *
     * Изменить режим чтения из API.
     * @param value read mode/ режим чтения
     */
    static setReadApi(value: boolean): void;
    /**
     * Set the configuration for the translation.
     *
     * Установить конфигурацию для перевода.
     * @param config configuration/ конфигурация
     */
    static setConfig(config: TranslateConfig): void;
}

/**
 * Prefix for global translations/
 * Префикс для глобальных переводов
 */
export declare const TRANSLATE_GLOBAL_PREFIX = "global";

/**
 * Request timeout for batch loading (ms)/
 * Таймаут запроса для пакетной загрузки (мс)
 */
export declare const TRANSLATE_TIME_OUT = 160;

/**
 * Translation code or a list of translation codes for template replacement/
 * Код перевода или список кодов для замены шаблона
 */
export declare type TranslateCode = string | string[];

/**
 * 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/
 * Асинхронная функция-загрузчик для файла перевода
 */
export declare type TranslateDataFileItem = () => Promise<TranslateDataFileList>;

/**
 * A simple key-value record of translations from a file/
 * Простой рекорд «ключ-значение» с переводами из файла
 */
export declare type TranslateDataFileList = Record<string, string>;

/**
 * Class for working with translation files.
 *
 * Класс для работы с файлами перевода.
 */
export declare class TranslateFile {
    protected language: string | (() => string);
    protected location: string | (() => string);
    /** List of files with translations/ Список файлов с переводами */
    protected files: TranslateDataFile;
    /** Data from files/ Данные из файлов */
    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 or language.
     *
     * Проверяет, есть ли файлы для текущего местоположения или языка.
     * @returns boolean / логическое значение
     */
    isFile(): boolean;
    /**
     * Returns the location.
     *
     * Возвращает местоположение.
     * @returns location / местоположение
     */
    getLocation(): string;
    /**
     * Returns the language.
     *
     * Возвращает язык.
     * @returns language / язык
     */
    getLanguage(): string;
    /**
     * Returns a list of translations from the file for the current location.
     *
     * Возвращает список переводов из файла для текущего местоположения.
     * @returns promise with list of translations / промис со списком переводов
     */
    getList(): Promise<TranslateDataFileList | undefined>;
    /**
     * Adds a list of files with translations.
     *
     * Добавляет список файлов с переводами.
     * @param data list of files/ список файлов
     */
    add(data: TranslateDataFile): void;
    /**
     * Returns the key for the current location from the list of files.
     *
     * Возвращает ключ для текущего местоположения из списка файлов.
     * @returns file key or undefined / ключ файла или undefined
     */
    protected getIndex(): string | undefined;
    /**
     * Returns a list of translations from the cache.
     *
     * Возвращает список переводов из кэша.
     * @param index file key/ ключ файла
     * @returns list of translations or undefined / список переводов или undefined
     */
    protected getByData(index: string): TranslateDataFileList | undefined;
    /**
     * Returns a list of translations from the file and caches the result.
     *
     * Возвращает список переводов из файла и кэширует результат.
     * @param index file key/ ключ файла
     * @returns promise with list of translations or undefined / промис со списком переводов или 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/ если установлено, заменяет текст на указанные значения
     * @returns translation text / текст перевода
     */
    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 / если установлено, заменяет текст на указанные значения
     * @returns translation text / текст перевода
     */
    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/ список кодов для получения переводов
     * @returns object with 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, возвращает пустую строку, если нет текста
     * @returns object with translations / объект с переводами
     */
    getListSync<T extends TranslateCode[]>(names: T, first?: boolean): TranslateList<T>;
    /**
     * Added a list of translated texts.
     *
     * Добавлен список переведенных текстов.
     * @param names list of codes to get translations/ список кодов для получения переводов
     * @returns promise resolving when translations are added / промис, разрешающийся после добавления переводов
     */
    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/ список текстов в виде ключ-значение
     * @returns promise / промис
     */
    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/ название кода
     * @returns boolean / логическое значение
     */
    protected hasName(name: string): boolean;
    /**
     * Retrieves translation text by code, returning the first matching fallback.
     *
     * Получает текст перевода по коду, возвращая первое совпадение из запасных вариантов.
     * @param name code name/ название кода
     * @returns translation text or undefined / текст перевода или undefined
     */
    protected getText(name: string): string | undefined;
    /**
     * Getting the full title for translation.
     *
     * Получение полного названия для перевода.
     * @param name code name/ название кода
     * @returns full title / полное название
     */
    protected getName(name: string): string;
    /**
     * Getting the title for translation by language.
     *
     * Получение названия для перевода по языку.
     * @param name code name/ название кода
     * @returns title by language / название по языку
     */
    protected getNameByLanguage(name: string): string;
    /**
     * Getting the title for translation globally.
     *
     * Получение названия для перевода глобально.
     * @param name code name/ название кода
     * @returns global title / глобальное название
     */
    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/ список кодов для получения переводов
     * @returns list of missing names / список отсутствующих имен
     */
    protected getNamesNone(names: string | string[]): string[];
    /**
     * Getting the list of translations from the server.
     *
     * Получение списка переводов с сервера.
     * @returns promise with record of translations / промис с записью переводов
     */
    protected getResponse(): Promise<Record<string, string>>;
    /**
     * Replaces the text with the specified values.
     *
     * Заменяет текст на указанные значения.
     * @param text text to replace/ текст для замены
     * @param replacement values for replacement/ значения для замены
     * @returns replaced text / замененный текст
     */
    protected replacement(text: string, replacement?: string[] | Record<string, string | number>): any;
    /**
     * Adding translation data from the server.
     *
     * Добавление данных по переводу с сервера.
     * @returns promise / промис
     */
    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/
 * Тип возвращаемого значения для получения перевода: объект, если был запрошен список, или строка для одного ключа
 */
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/
 * Объект с переведенными строками, где ключи — имена кодов переводов
 */
export declare type TranslateList<T extends TranslateCode[]> = {
    [K in T[number] as K extends readonly string[] ? K[0] : K]: string;
};

/**
 * Cookie key for storing the geo code/
 * Ключ куки для хранения кода гео
 */
export declare const UI_GEO_COOKIE_KEY = "ui-geo-code";

/**
 * Converts a Uint8Array to a base64 encoded string.
 *
 * Преобразует Uint8Array в строку, закодированную в base64.
 * @param bytes binary data as Uint8Array / бинарные данные в виде Uint8Array
 * @returns base64 encoded string / строка, закодированная в base64
 */
export declare function uint8ArrayToBase64(bytes: Uint8Array): string;

/** Union type for undefined and null values/ Объединенный тип для undefined и null значений */
export declare type Undefined = undefined | null;

/**
 * Removes duplicate entries in an array.
 *
 * Удаляет повторяющиеся записи в массиве.
 * @param value input value/ входное значение
 * @returns array without duplicates / массив без дубликатов
 */
export declare function uniqueArray<T>(value: T[]): T[];

/**
 * Base abstract class for working with URL-based states (Hash, Query).
 *
 * Базовый абстрактный класс для работы с состояниями на основе URL (Hash, Query).
 */
export declare abstract class UrlInstanceAbstract {
    /** URL state data record / Запись данных состояния URL */
    protected data?: Record<string, any>;
    /** Watchers map for URL state variables / Карта слушателей для переменных состояния URL */
    protected watch: Record<string, ((value: any) => void)[]>;
    /** Update block flag / Флаг блокировки обновления */
    protected block: boolean;
    /** Debounce timer instance / Экземпляр таймера задержки */
    protected time?: any;
    /**
     * Get data.
     *
     * Получение данных.
     * @param name variable name / название переменной
     * @param defaultValue value or function to change data / значение или функция для изменения данных
     * @returns stored value / сохранённое значение
     */
    get<T>(name: string, defaultValue?: T | (() => T)): T;
    /**
     * Change data.
     *
     * Изменение данных.
     * @param name variable name / название переменной
     * @param callback value or function to change data / значение или функция для изменения данных
     * @returns this instance / текущий экземпляр
     */
    set<T>(name: string, callback: T | (() => T)): this;
    /**
     * Adding an event when data is changed.
     *
     * Добавление события при изменении данных.
     * @param name variable name / название переменной
     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
     * @returns this instance / текущий экземпляр
     */
    addWatch<T>(name: string, callback: (value: T) => void): this;
    /**
     * Removing an event when data is changed.
     *
     * Удаление события при изменении данных.
     * @param name variable name / название переменной
     * @param callback the function is called when the data is changed / функция вызывается при изменении данных
     * @returns this instance / текущий экземпляр
     */
    removeWatch<T>(name: string, callback: (value: T) => void): this;
    /**
     * Update variables from URL string.
     *
     * Обновление переменных из строки URL.
     * @returns this instance / текущий экземпляр
     */
    reload(): this;
    /**
     * Returns the query/hash data object, initializing if needed.
     *
     * Возвращает объект данных, инициализируя при необходимости.
     * @returns Record<string, any> data object / объект данных
     */
    protected getData(): Record<string, any>;
    /**
     * Reads data from the URL and triggers watchers.
     *
     * Считывает данные из URL и вызывает наблюдателей.
     * @returns this instance / текущий экземпляр
     */
    protected initData(): this;
    /**
     * Calling all functions whose data has changed.
     *
     * Вызов всех функций, у которых были изменены данные.
     * @param location fresh data / свежие данные
     * @returns this instance / текущий экземпляр
     */
    protected makeWatch(location: Record<string, any>): this;
    /**
     * Initializes data and event listeners.
     *
     * Инициализирует данные и слушатели событий.
     */
    protected abstract init(): this;
    /**
     * Obtaining data from the URL string.
     *
     * Получение данных из строки URL.
     */
    protected abstract getLocation(): Record<string, any>;
    /**
     * Update string in URL.
     *
     * Обновление строки в URL.
     */
    protected abstract update(): this;
}

/**
 * Isomorphic utility class for working with URLs.
 * Provides read-only getters and a single 'set' method for modifying the URL.
 *
 * Изоморфный утилитарный класс для работы с URL.
 * Предоставляет геттеры только для чтения и единственный метод «set» для изменения URL.
 */
export declare class UrlItem {
    /** Underlying standard URL object / Лежащий в основе стандартный объект URL */
    private url;
    /**
     * Returns a request-isolated instance of UrlItem.
     *
     * Возвращает изолированный в рамках запроса экземпляр UrlItem.
     * @returns UrlItem instance / экземпляр UrlItem
     */
    static getInstance(): UrlItem;
    /**
     * Constructs a new Url instance.
     *
     * Создает новый экземпляр Url.
     * @param url URL string or standard URL object / строка URL или стандартный объект URL
     */
    constructor(url?: string | URL);
    /** Full URL string / Полная строка URL */
    get href(): string;
    /** Protocol including trailing colon / Протокол, включая ведущее двоеточие */
    get protocol(): string;
    /** Username / Имя пользователя */
    get username(): string;
    /** Password / Пароль */
    get password(): string;
    /** Host (hostname and port) / Хост (имя хоста и порт) */
    get host(): string;
    /** Hostname (excluding port) / Имя хоста (без порта) */
    get hostname(): string;
    /** Port / Порт */
    get port(): string;
    /** Path name / Путь к ресурсу */
    get pathname(): string;
    /** Search string including leading question mark / Строка запроса, включая ведущий вопросительный знак */
    get search(): string;
    /** Readonly search params object / Объекты параметров поиска только для чтения */
    get searchParams(): URLSearchParams;
    /** Hash string including leading hash sign / Хеш-строка, включая ведущий знак решетки */
    get hash(): string;
    /** Origin of the URL (readonly) / Источник URL (только для чтения) */
    get origin(): string;
    /**
     * Checks if the specified query parameter exists.
     *
     * Проверяет, существует ли указанный параметр запроса.
     * @param name parameter name / имя параметра
     * @returns check result / результат проверки
     */
    hasParam(name: string): boolean;
    /**
     * Returns the value of a query parameter.
     *
     * Возвращает значение параметра запроса.
     * @param name parameter name / имя параметра
     * @returns parameter value or undefined if not found / значение параметра или undefined, если не найдено
     */
    getParam(name: string): string | undefined;
    /**
     * Returns all query parameters as an object with transformed types.
     *
     * Возвращает все параметры запроса в виде объекта с преобразованными типами.
     * @returns Record<string, any> object of parameters / объект параметров
     */
    getParams(): Record<string, any>;
    /**
     * Updates the URL value.
     *
     * Обновляет значение URL.
     * @param url URL string or standard URL object / строка URL или стандартный объект URL
     * @returns this Url instance / текущий экземпляр Url
     */
    set(url?: string | URL): this;
    /**
     * Sets the value of a query parameter.
     *
     * Устанавливает значение параметра запроса.
     * @param name parameter name / имя параметра
     * @param value parameter value / значение параметра
     * @returns this UrlItem instance / текущий экземпляр UrlItem
     */
    setParam(name: string, value: string): this;
    /**
     * Replaces all query parameters with the specified object.
     *
     * Заменяет все параметры запроса на указанный объект.
     * @param params parameters to set / параметры для установки
     * @returns this UrlItem instance / текущий экземпляр UrlItem
     */
    setParams(params: Record<string, any>): this;
    /**
     * Deletes a query parameter.
     *
     * Удаляет параметр запроса.
     * @param name parameter name / имя параметра
     * @returns this UrlItem instance / текущий экземпляр UrlItem
     */
    deleteParam(name: string): this;
    /**
     * Converts the Url instance to its string representation.
     *
     * Преобразует экземпляр Url в его строковое представление.
     * @returns full URL string / полная строка URL
     */
    toString(): string;
    /**
     * Converts the Url instance to JSON string representation.
     *
     * Преобразует экземпляр Url в строковое представление JSON.
     * @returns full URL string / полная строка URL
     */
    toJSON(): string;
}

/**
 * Writes data to the buffer.
 *
 * Записывает данные в буфер.
 * @param text text for recording/ текст для записи
 * @returns promise without return value / промис без возвращаемого значения
 */
export declare function writeClipboardData(text: string): Promise<void>;

export { }