@dxtmisha/functional-basic 1.14.0 → 2.0.1

package/dist/library.d.ts

@@ -2,26 +2,74 @@
  * Adds a tag to highlight the match in the string.
  *
  * Добавляет тег для выделения совпадения в строке.
- * @param value initial string / исходная строка
+ * @param value initial value / исходное значение
  * @param search search string or RegExp / строка поиска или регулярное выражение
- * @param className highlighting class / класс выделения
- * @param shouldEscape should escape the string / нужно ли экранировать строку
+ * @param options configuration options / объект опций
  * @returns string with highlighting / строка с выделением
  */
-export declare function addTagHighlightMatch(value: string, search?: string | RegExp, className?: string, shouldEscape?: boolean): string;
+export declare function addTagHighlightMatch(value?: string | number | null, search?: string | RegExp, options?: AddTagHighlightMatchOptions): string;
 
 /**
- * Conversion of a value to a string.
- * Flat arrays without objects are joined with commas if `isArrayString` is true, otherwise serialized as JSON.
- *
- * Преобразование значения в строку.
- * Плоские массивы без объектов при `isArrayString=true` склеиваются через запятую, иначе сериализуются в JSON.
- * @param value values for conversion / значения для преобразования
- * @param isArrayString if true, arrays without objects are joined with commas; if false, serialized as JSON string / если true, массивы без объектов склеиваются через запятую; если false, сериализуются в JSON-строку
- * @param trim if true, then the resulting string will be trimmed / если true, то результирующая строка будет обрезана
+ * Options for configuring match highlighting in addTagHighlightMatch /
+ * Опции для настройки выделения совпадений в addTagHighlightMatch
+ */
+export declare interface AddTagHighlightMatchOptions {
+    /** Highlighting CSS class / CSS-класс выделения */
+    className?: string;
+    /** Should escape the string / Нужно ли экранировать строку */
+    shouldEscape?: boolean;
+    /** Should remove existing HTML tags / Нужно ли удалять существующие HTML-теги */
+    shouldRemoveTag?: boolean;
+}
+
+/**
+ * Safely converts any value to a string according to specific conversion rules:
+ * - **Strings**: Returned as is (trimmed if `trim = true`).
+ * - **Nullish values**: `null` and `undefined` return an empty string `''`.
+ * - **Arrays**: If `isArrayString = true` and the array contains no objects, elements are joined with commas. Otherwise serialized as JSON.
+ * - **Objects**: Converted to JSON via `JSON.stringify`. In case of circular references or serialization errors, falls back to `String()` or `Object.prototype.toString`.
+ * - **Booleans**: By default (`isBooleanString = false`), `true` converts to `'1'` and `false` converts to `'0'`. If `isBooleanString = true`, returns `'true'` or `'false'`.
+ * - **Other types**: Numbers, BigInt, Symbol, functions, etc. are converted via `.toString()`.
+ *
+ * Безопасно преобразует любое значение в строку в соответствии с правилами преобразования:
+ * - **Строки**: Возвращаются как есть (с обрезкой пробелов, если `trim = true`).
+ * - **Пустые значения**: `null` и `undefined` возвращают пустую строку `''`.
+ * - **Массивы**: Если `isArrayString = true` и массив не содержит объектов, элементы объединяются через запятую. В остальных случаях сериализуются в JSON.
+ * - **Объекты**: Преобразуются в JSON через `JSON.stringify`. При циклических ссылках или ошибках сериализации возвращается `String()` или `Object.prototype.toString`.
+ * - **Логические значения**: По умолчанию (`isBooleanString = false`) `true` преобразуется в `'1'`, `false` — в `'0'`. Если `isBooleanString = true`, возвращается `'true'` или `'false'`.
+ * - **Прочие типы**: Числа, BigInt, Symbol, функции и др. преобразуются через `.toString()`.
+ * @param value value for conversion / значение для преобразования
+ * @param options configuration options / объект опций
  * @returns string representation of the passed value / строковое представление переданного значения
+ *
+ * @example
+ * ```ts
+ * anyToString('  Hello  ') // => 'Hello'
+ * anyToString('  Hello  ', { trim: false }) // => '  Hello  '
+ * anyToString([1, 2, 3]) // => '1,2,3'
+ * anyToString([1, 2, 3], { isArrayString: false }) // => '[1,2,3]'
+ * anyToString({ a: 1 }) // => '{"a":1}'
+ * anyToString(true) // => '1'
+ * anyToString(false) // => '0'
+ * anyToString(true, { isBooleanString: true }) // => 'true'
+ * anyToString(false, { isBooleanString: true }) // => 'false'
+ * anyToString(null) // => ''
+ * ```
+ */
+export declare function anyToString<V = unknown>(value?: V, options?: AnyToStringOptions): string;
+
+/**
+ * Options for configuring string conversion in anyToString /
+ * Опции для настройки преобразования в строку в anyToString
  */
-export declare function anyToString<V>(value: V, isArrayString?: boolean, trim?: boolean): string;
+export declare interface AnyToStringOptions {
+    /** If true, flat arrays without objects are joined with commas; if false, serialized as JSON string / Если true, массивы без объектов склеиваются через запятую; если false, сериализуются в JSON-строку */
+    isArrayString?: boolean;
+    /** If true, boolean values are converted to 'true' or 'false'; if false, to '1' or '0' / Если true, логические значения преобразуются в 'true' или 'false'; если false — в '1' или '0' */
+    isBooleanString?: boolean;
+    /** If true, then the resulting string will be trimmed / Если true, то результирующая строка будет обрезана */
+    trim?: boolean;
+}
 
 /**
  * Class for working with HTTP requests.
@@ -1754,7 +1802,7 @@ export declare type ApiStatusType = 'success' | 'error' | 'warning' | 'info';
  * @returns formatted string with applied template replacements /
  * отформатированная строка с примененными заменами шаблона
  */
-export declare function applyTemplate(text: string, replacement?: Record<string, unknown> | readonly unknown[]): string;
+export declare function applyTemplate(text: unknown, replacement?: Record<string, unknown> | readonly unknown[]): string;
 
 /**
  * Converts an array type to an item type (extracts the item type from an array)/
@@ -1782,7 +1830,7 @@ export declare function arrFill<T>(value: T, count: number): T[];
  * @param clean If true, removes the data URL prefix / Если true, удаляет префикс data URL
  * @returns Promise with the base64 string or undefined if empty / Промис со строкой base64 или undefined, если Blob пустой
  */
-export declare function blobToBase64(blob: Blob, clean?: boolean): Promise<string | undefined>;
+export declare function blobToBase64(blob?: Blob | null, clean?: boolean): Promise<string | undefined>;
 
 /**
  * Class for working with BroadcastChannel messages.
@@ -2011,21 +2059,23 @@ export declare class CacheStatic {
  * @param locale use locale or explicit locale tag / использовать локаль или явный код локали
  * @returns capitalized string / капитализированная строка
  */
-export declare function capitalize<T extends string = string>(value?: T, locale?: boolean | string): Capitalize<T>;
+export declare function capitalize<T = string>(value?: T, locale?: boolean | string): T extends string ? Capitalize<T> : string;
 
 /**
  * Class for working with cookies.
  *
  * Класс для управления Cookie.
  */
-export declare class Cookie<T> {
-    private name;
+export declare class Cookie<T = unknown> {
+    private readonly name;
     /** Cookie value / Значение cookie */
     private value?;
     /** Cookie options / Параметры cookie */
     private options;
     /**
-     * Constructor
+     * Constructor.
+     *
+     * Конструктор.
      * @param name cookie name / название cookie
      */
     constructor(name: string);
@@ -2036,7 +2086,7 @@ export declare class Cookie<T> {
      * @param name cookie name / название cookie
      * @returns Cookie instance / экземпляр Cookie
      */
-    static getInstance<T>(name: string): Cookie<T>;
+    static getInstance<T = unknown>(name: string): Cookie<T>;
     /**
      * Get data or update if none.
      *
@@ -2045,7 +2095,7 @@ export declare class Cookie<T> {
      * @param options additional parameters / дополнительные параметры
      * @returns cookie value / значение cookie
      */
-    get(defaultValue?: T | string | (() => (T | string)), options?: CookieOptions): T | string | undefined;
+    get<D extends T | string | (() => (T | string)) | undefined = undefined>(defaultValue?: D, options?: CookieOptions): CookieGet<T, D>;
     /**
      * Updates cookie data.
      *
@@ -2102,18 +2152,18 @@ export declare class CookieBlock {
 }
 
 /**
- * Class for changing cookie access status.
+ * Class for managing cookie access and blocking status at the instance level.
  *
- * Класс для изменения статуса доступа к куки.
+ * Класс для управления доступом и статусом блокировки cookie на уровне экземпляра.
  */
 export declare class CookieBlockInstance {
     /** Data storage for cookie block status / Хранилище данных для статуса блокировки куки */
-    private storage;
+    private readonly storage;
     /**
      * Obtaining status.
      *
      * Получение статуса.
-     * @returns boolean current block status / текущий статус блокировки
+     * @returns current block status / текущий статус блокировки
      */
     get(): boolean;
     /**
@@ -2123,12 +2173,13 @@ export declare class CookieBlockInstance {
      * @param value value to be changed / значение, на которое будет изменен
      * @returns void / ничего не возвращает
      */
-    set(value: boolean): void;
+    set(value?: boolean): void;
 }
 
-/**
- * Cookie options / Параметры cookie
- */
+/** Return type of the Cookie.get method / Тип возвращаемого значения метода Cookie.get */
+export declare type CookieGet<T, D = undefined> = [D] extends [undefined] ? (T | undefined) : unknown extends T ? (D extends () => infer R ? R : D) : (T | (D extends () => infer R ? R : D));
+
+/** Cookie options / Параметры cookie */
 export declare type CookieOptions = {
     /** Cache age / Время кэширования */
     age?: number;
@@ -2145,13 +2196,11 @@ export declare type CookieOptions = {
     /** Partitioned attribute / Атрибут Partitioned */
     partitioned?: boolean;
     /** Additional arguments / Дополнительные аргументы */
-    arguments?: string[] | Record<string, string | number | boolean>;
+    arguments?: string[] | Record<string, unknown>;
 };
 
-/**
- * Cookie sameSite attribute / Атрибут sameSite cookie
- */
-declare type CookieSameSite_2 = 'strict' | 'lax';
+/** Cookie sameSite attribute / Атрибут sameSite cookie */
+declare type CookieSameSite_2 = 'strict' | 'lax' | 'none';
 export { CookieSameSite_2 as CookieSameSite }
 
 /**
@@ -2162,11 +2211,11 @@ export { CookieSameSite_2 as CookieSameSite }
  * Полезен для консистентной работы с cookie в различных окружениях (DOM, SSR).
  */
 export declare class CookieStorage {
-    /** Storage mechanism for getting data / механизм хранения для получения данных */
+    /** Storage mechanism for getting data / Механизм хранения для получения данных */
     protected static getListener?: (key: string) => unknown;
-    /** Storage mechanism for getting raw data / механизм хранения для получения сырых данных */
+    /** Storage mechanism for getting raw data / Механизм хранения для получения сырых данных */
     protected static getListenerRaw?: () => string;
-    /** Storage mechanism for setting data / механизм хранения для сохранения данных */
+    /** Storage mechanism for setting data / Механизм хранения для сохранения данных */
     protected static setListener?: (key: string, value: string, cookie: string, options?: CookieOptions) => void;
     /**
      * Getting data from storage.
@@ -2174,9 +2223,10 @@ export declare class CookieStorage {
      * Получение данных из хранилища.
      * @param name cookie name / имя cookie
      * @param defaultValue default value / значение по умолчанию
-     * @returns T | undefined cookie value or default / значение cookie или значение по умолчанию
+     * @param options additional parameters / дополнительные параметры
+     * @returns cookie value or default / значение cookie или значение по умолчанию
      */
-    static get<T>(name: string, defaultValue?: T | (() => T)): T | undefined;
+    static get<T = unknown, D extends T | (() => T) | undefined = undefined>(name: string, defaultValue?: D, options?: CookieOptions): CookieStorageGet<T, D>;
     /**
      * Saving data to storage.
      *
@@ -2186,15 +2236,16 @@ export declare class CookieStorage {
      * @param options additional parameters / дополнительные параметры
      * @returns stored value / сохраненное значение
      */
-    static set<T>(name: string, value: T | (() => T), options?: CookieOptions): T;
+    static set<T = unknown>(name: string, value: T | (() => T), options?: CookieOptions): T;
     /**
      * Removing data from storage.
      *
      * Удаление данных из хранилища.
      * @param name cookie name / имя cookie
+     * @param options additional parameters / дополнительные параметры
      * @returns void / ничего не возвращает
      */
-    static remove(name: string): void;
+    static remove(name: string, options?: CookieOptions): void;
     /**
      * Update data from cookies.
      *
@@ -2210,12 +2261,22 @@ export declare class CookieStorage {
      */
     static reset(): void;
     /**
-     * Initializes the storage with listeners.
+     * Initializes the storage with optional listeners and hooks.
      *
-     * Инициализирует хранилище слушателями.
-     * @param getListener Storage mechanism for getting data / механизм хранения для получения данных
-     * @param getListenerRaw Storage mechanism for getting raw cookie string / механизм хранения для получения сырой строки cookie
-     * @param setListener Storage mechanism for setting data / механизм хранения для сохранения данных
+     * Features when omitting parameters:
+     * - `getListener`: If omitted (`undefined`), reads directly from internal parsed cookie items (`initItems()`). If provided, takes precedence over internal cache.
+     * - `getListenerRaw`: If omitted in a non-DOM/SSR environment (`!isDomRuntime()`), the initial cookie dictionary starts empty (`Object.create(null)`). In browser/DOM runtime, `document.cookie` is used instead. If provided in SSR, parses the returned raw cookie string.
+     * - `setListener`: If omitted in the browser/DOM runtime, changes are written directly to `document.cookie`. In a non-DOM/SSR environment without `setListener`, mutations are stored solely in memory for the duration of the current request without external persistence.
+     *
+     * Инициализирует хранилище опциональными слушателями и хуками.
+     *
+     * Особенности работы при неполной передаче параметров:
+     * - `getListener`: Если не передан (`undefined`), чтение происходит напрямую из внутреннего кэша разобранных cookie (`initItems()`). Если передан, имеет приоритет над внутренним кэшем.
+     * - `getListenerRaw`: Если не передан в non-DOM/SSR окружении (`!isDomRuntime()`), начальное хранилище cookie создаётся пустым (`Object.create(null)`). В браузере (DOM) вместо него используется `document.cookie`. Если передан в SSR, разбирает возвращённую сырую строку cookie.
+     * - `setListener`: Если не передан в браузере (DOM), запись выполняется напрямую в `document.cookie`. В non-DOM/SSR окружении без `setListener` изменения сохраняются исключительно в оперативной памяти в рамках текущего запроса без внешней фиксации.
+     * @param getListener storage mechanism for getting data / механизм хранения для получения данных
+     * @param getListenerRaw storage mechanism for getting raw cookie string / механизм хранения для получения сырой строки cookie
+     * @param setListener storage mechanism for setting data / механизм хранения для сохранения данных
      * @returns void / ничего не возвращает
      */
     static init(getListener?: (key: string) => unknown, getListenerRaw?: () => string, setListener?: (key: string, value: string, cookie: string, options?: CookieOptions) => void): void;
@@ -2223,9 +2284,28 @@ export declare class CookieStorage {
      * 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
+     * @returns true if the current environment is a DOM environment, false otherwise / true, если текущее окружение является DOM-окружением, иначе false
      */
     protected static hasDom(): boolean;
+    /**
+     * Sets an item in storage and notifies listeners or DOM.
+     *
+     * Устанавливает элемент в хранилище и уведомляет слушателей или DOM.
+     * @param name cookie name / имя cookie
+     * @param value data to be stored / данные для хранения
+     * @param options additional parameters / дополнительные параметры
+     * @param isWriteEmpty whether to write and update storage if value is empty / записывать ли и обновлять хранилище, если значение пустое
+     * @returns stored value / сохраненное значение
+     */
+    protected static setItem<T = unknown>(name: string, value: T, options?: CookieOptions, isWriteEmpty?: boolean): T;
+    /**
+     * Safely decodes a URI-encoded cookie component.
+     *
+     * Безопасно декодирует URI-кодированный компонент cookie.
+     * @param value string to decode / строка для декодирования
+     * @returns decoded string or original value on error / декодированная строка или исходное значение при ошибке
+     */
+    protected static decode(value: string): string;
     /**
      * Formats the cookie string for storage.
      *
@@ -2248,7 +2328,7 @@ export declare class CookieStorage {
      *
      * Разбирает строку cookie в объект пар ключ-значение.
      * @param cookie cookie string / строка cookie
-     * @returns Record<string, unknown> parsed items / разобранные элементы
+     * @returns parsed items / разобранные элементы
      */
     protected static parse(cookie: string): Record<string, unknown>;
     /**
@@ -2263,7 +2343,7 @@ export declare class CookieStorage {
      * Converts the value to a string for the domain attribute.
      *
      * Преобразует значение в строку для атрибута domain.
-     * @param domain Domain / домен
+     * @param domain domain / домен
      * @returns formatted domain string or undefined / отформатированная строка domain или undefined
      */
     protected static toDomain(domain?: CookieOptions['domain']): string | undefined;
@@ -2288,7 +2368,7 @@ export declare class CookieStorage {
      * Converts the value to a string for the partitioned attribute.
      *
      * Преобразует значение в строку для атрибута partitioned.
-     * @param partitioned Partitioned attribute / атрибут partitioned
+     * @param partitioned partitioned attribute / атрибут partitioned
      * @returns formatted Partitioned string or undefined / отформатированная строка Partitioned или undefined
      */
     protected static toPartitioned(partitioned?: CookieOptions['partitioned']): string | undefined;
@@ -2296,7 +2376,7 @@ export declare class CookieStorage {
      * Converts the value to a string for the path attribute.
      *
      * Преобразует значение в строку для атрибута path.
-     * @param path Path / путь
+     * @param path path / путь
      * @returns formatted Path string / отформатированная строка Path
      */
     protected static toPath(path?: CookieOptions['path']): string;
@@ -2310,20 +2390,28 @@ export declare class CookieStorage {
     protected static toSameSite(sameSite?: CookieOptions['sameSite']): string;
     /**
      * Converts the value to a string for the secure attribute.
+     * Automatically enables Secure when SameSite is 'none' or partitioned is true per RFC 6265bis.
      *
      * Преобразует значение в строку для атрибута secure.
-     * @param secure Secure attribute / атрибут secure
+     * Автоматически включает Secure при SameSite 'none' или partitioned true согласно RFC 6265bis.
+     * @param secure secure attribute / атрибут secure
+     * @param sameSite SameSite attribute / атрибут SameSite
+     * @param partitioned partitioned attribute / атрибут partitioned
      * @returns formatted Secure string or undefined / отформатированная строка Secure или undefined
      */
-    protected static toSecure(secure?: CookieOptions['secure']): string | undefined;
+    protected static toSecure(secure?: CookieOptions['secure'], sameSite?: CookieOptions['sameSite'], partitioned?: CookieOptions['partitioned']): string | undefined;
 }
 
+/** Return type of the CookieStorage.get method / Тип возвращаемого значения метода CookieStorage.get */
+export declare type CookieStorageGet<T, D = undefined> = [D] extends [undefined] ? (T | undefined) : unknown extends T ? (D extends () => infer R ? R : D) : T;
+
 /**
  * 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.
  *
  * Создает глубокую копию объекта для независимого управления данными.
  * Цель метода — получить полностью новый отдельный экземпляр объекта во избежание нежелательных мутаций.
+ * @template T type of the object / тип объекта
  * @param value object for copying / объект для копирования
  * @returns returns a new copy of the object / возвращает новую копию объекта
  */
@@ -2333,18 +2421,21 @@ export declare function copyObject<T>(value: T): T;
  * Copies a simple object.
  *
  * Копирует простой объект.
+ * @template T type of the original object / тип исходного объекта
+ * @template R return type of the copied 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?: Record<PropertyKey, unknown> | null): R;
+export declare function copyObjectLite<T = Record<PropertyKey, unknown>, R = T>(value?: T | null, source?: Record<PropertyKey, unknown> | null): R;
 
 /**
  * In HTML documents, creates an element with the tag that is specified in the argument.
  *
  * В HTML-документах создаёт элемент с тегом, который указан в аргументе.
  *
- * @param parentElement the DOM parent node (Element or DocumentFragment) / родительский узел DOM (Element или DocumentFragment)
+ * @template T element type / тип элемента
+ * @param parentElement the DOM parent node (Element, DocumentFragment, or null/undefined) / родительский узел DOM (Element, DocumentFragment или null/undefined)
  * @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 new element is inserted / узел, перед которым будет вставлен новый элемент
@@ -2357,6 +2448,7 @@ export declare function copyObjectLite<T, R = T>(value: T, source?: Record<Prope
  * 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).
+ * When passing `innerHTML` through `options`, make sure the markup is trusted or properly sanitized to prevent XSS vulnerabilities.
  *
  * Функция предназначена для стандартных HTML-элементов через `document.createElement`.
  * Для элементов SVG или MathML, требующих пространства имён, используйте `document.createElementNS`.
@@ -2364,8 +2456,9 @@ export declare function copyObjectLite<T, R = T>(value: T, source?: Record<Prope
  * При выполнении на сервере функция всегда возвращает `undefined`.
  * Если вы используете её внутри логики рендеринга компонента, это может привести к ошибкам гидратации.
  * Рекомендуется вызывать эту функцию только в хуках жизненного цикла, которые выполняются на клиенте (например, `onMounted` в Vue или `useEffect` в React).
+ * При передаче `innerHTML` через `options` убедитесь, что разметка доверенная или надлежащим образом санитизирована во избежание XSS-уязвимостей.
  */
-export declare function createElement<T extends HTMLElement>(parentElement?: Element | DocumentFragment, tagName?: string, options?: Partial<T> | Record<string, unknown> | ((element: T) => void), referenceElement?: Node | null): T | undefined;
+export declare function createElement<T extends HTMLElement = HTMLDivElement>(parentElement?: Element | DocumentFragment | null, tagName?: string, options?: Partial<T> | Record<string, unknown> | ((element: T) => void) | null, referenceElement?: Node | null): T | undefined;
 
 /**
  * Class for working with localStorage and sessionStorage.
@@ -2374,10 +2467,10 @@ export declare function createElement<T extends HTMLElement>(parentElement?: Ele
  * Класс для работы с localStorage и sessionStorage.
  * Включает поддержку префиксов, времени жизни данных и изоляцию запросов в SSR.
  */
-export declare class DataStorage<T> {
-    private name;
-    private isSession;
-    private errorCenter;
+export declare class DataStorage<T = unknown> {
+    private readonly name;
+    private readonly isSession;
+    private readonly errorCenter;
     /**
      * The current value stored in memory /
      * Текущее значение, хранящееся в памяти
@@ -2405,7 +2498,7 @@ export declare class DataStorage<T> {
      * @param cache cache time in seconds / время кэширования в секундах
      * @returns stored value or default value / сохраненное значение или значение по умолчанию
      */
-    get(defaultValue?: T | (() => T), cache?: number): T | undefined;
+    get<D extends T | (() => T) | undefined = undefined>(defaultValue?: D, cache?: number): DataStorageGet<T, D>;
     /**
      * Changing data in storage.
      *
@@ -2415,9 +2508,20 @@ export declare class DataStorage<T> {
      */
     set(value?: T | (() => T)): T | undefined;
     /**
-     * Changing the prefix in key names. Should be called at the beginning of the code.
+     * Getting the storage key name with prefix.
      *
-     * Изменение префикса в названиях ключей. Вызывать нужно в начале кода.
+     * Получение имени ключа в хранилище с учетом префикса.
+     * @returns key name / имя ключа
+     */
+    getIndex(): string;
+    /**
+     * Changing the prefix in key names. Should be called once during application bootstrap.
+     * Note: The prefix is intentionally stored at module scope as a shared process-wide setting,
+     * so in SSR environments it applies globally to the entire runtime process rather than per-request.
+     *
+     * Изменение префикса в названиях ключей. Вызывать нужно один раз при инициализации приложения.
+     * Примечание: Префикс намеренно хранится на уровне модуля как общая настройка для всего процесса,
+     * поэтому в SSR-окружении он применяется глобально ко всему процессу рантайма, а не изолированно для каждого запроса.
      * @param newPrefix new prefix / новый префикс
      */
     static setPrefix(newPrefix: string): void;
@@ -2443,13 +2547,6 @@ export declare class DataStorage<T> {
      * @returns true if data is valid / true, если данные актуальны
      */
     private isCache;
-    /**
-     * Getting the storage key name with prefix.
-     *
-     * Получение имени ключа в хранилище с учетом префикса.
-     * @returns key name / имя ключа
-     */
-    private getIndex;
     /**
      * Returns an object for working with storage (localStorage or sessionStorage).
      *
@@ -2473,6 +2570,9 @@ export declare class DataStorage<T> {
     private make;
 }
 
+/** Return type of the get method / Тип возвращаемого значения метода get */
+export declare type DataStorageGet<T, D = undefined> = [D] extends [undefined] ? (T | undefined) : unknown extends T ? (D extends () => infer R ? R : D) : T;
+
 /**
  * A class for working with dates.
  *
@@ -2496,8 +2596,12 @@ export declare class Datetime {
     protected hour24: boolean;
     /** Callback on date update / Колбэк при изменении даты */
     protected watch?: (date: Date, type: GeoDate, hour24: boolean) => void;
+    /** Flag for blocking watch callback execution / Флаг блокировки вызова функции обратного вызова watch */
+    protected block: boolean;
     /**
-     * Constructor
+     * Constructor.
+     *
+     * Конструктор.
      * @param date date for processing / дата для обработки
      * @param type type of date format for output / тип формата даты вывода
      * @param code country and language code / код страны и языка
@@ -2538,6 +2642,13 @@ export declare class Datetime {
      * @returns boolean 24-hour format flag / флаг 24-часового формата
      */
     getHour24(): boolean;
+    /**
+     * Returns the country and language code.
+     *
+     * Возвращает код страны и языка.
+     * @returns string country and language code / код страны и языка
+     */
+    getCode(): string;
     /**
      * The method returns the difference, in minutes, between
      * a date as evaluated in the UTC time zone, and the same date as evaluated
@@ -2582,10 +2693,17 @@ export declare class Datetime {
     /**
      * 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 day of the week for the specified date according to local time.
+     *
+     * Метод возвращает день недели указанной даты по местному времени.
+     * @returns day of week (0-6) / день недели (0-6)
+     */
+    getWeekday(): number;
     /**
      * The method returns the hour for the specified date, according to local time.
      *
@@ -2615,18 +2733,18 @@ export declare class Datetime {
      */
     getMaxDay(): number;
     /**
-     * Change the date completely.
+     * Changes the date completely.
      *
-     * Изменять полностью дату.
-     * @param value an integer value representing the number / целочисленное значение, представляющее число
+     * Полностью изменяет дату.
+     * @param value date for processing / дата для обработки
      * @returns this instance / текущий экземпляр
      */
-    setDate(value: NumberOrStringOrDate): this;
+    setDate(value?: NumberOrStringOrDate): this;
     /**
      * Change the type of data output.
      *
      * Изменить тип вывода данных.
-     * @param value type of output / тип вывод
+     * @param value type of output / тип вывода
      * @returns this instance / текущий экземпляр
      */
     setType(value: GeoDate): this;
@@ -2639,33 +2757,37 @@ export declare class Datetime {
      */
     setHour24(value: boolean): this;
     /**
-     * To change the location.
+     * Changes the location and notifies the watcher.
      *
-     * Изменить местоположение.
+     * Изменяет местоположение и уведомляет наблюдателя.
      * @param code country and language code / код страны и языка
      * @returns this instance / текущий экземпляр
      */
-    setCode(code: string): this;
+    setCode(code?: string): this;
     /**
      * The function is called when the data is updated.
      *
      * Функция вызывается при обновлении данных.
-     * @param watch the function calls / функция вызывает
+     * @param watch callback function on date update / функция обратного вызова при обновлении даты
      * @returns this instance / текущий экземпляр
      */
-    setWatch(watch: (date: Date, type: GeoDate, hour24: boolean) => void): this;
+    setWatch(watch?: (date: Date, type: GeoDate, hour24: boolean) => void): this;
     /**
      * The method sets the full year for a specified date according to local time.
+     * Clamps the day to the maximum number of days in the current month of the target year to prevent overflow.
      *
      * Метод устанавливает полный год указанной даты по местному времени.
-     * @param value value / значения
+     * Ограничивает день максимальным количеством дней в текущем месяце целевого года для предотвращения переполнения.
+     * @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.
+     * Clamps the day to the maximum number of days in the target month to prevent overflow.
      *
      * Метод устанавливает месяц указанной даты по местному времени.
+     * Ограничивает день максимальным количеством дней в целевом месяце для предотвращения переполнения.
      * @param value month (1-12) / месяц (1-12)
      * @returns this instance / текущий экземпляр
      */
@@ -2674,7 +2796,7 @@ export declare class Datetime {
      * The method changes the day of the month of a given Date instance, based on local time.
      *
      * Метод устанавливает день месяца указанной даты по местному времени.
-     * @param value value / значения
+     * @param value value / значение
      * @returns this instance / текущий экземпляр
      */
     setDay(value: number): this;
@@ -2682,15 +2804,15 @@ export declare class Datetime {
      * The method sets the hours for a specified date according to local time.
      *
      * Метод устанавливает часы указанной даты по местному времени.
-     * @param value value / значения
+     * @param value value / значение
      * @returns this instance / текущий экземпляр
      */
     setHour(value: number): this;
     /**
-     * The method sets the minutes for a specified date according to local time
+     * The method sets the minutes for a specified date according to local time.
      *
-     * Метод устанавливает минуты указанной даты по местному времени
-     * @param value value / значения
+     * Метод устанавливает минуты указанной даты по местному времени.
+     * @param value value / значение
      * @returns this instance / текущий экземпляр
      */
     setMinute(value: number): this;
@@ -2698,16 +2820,16 @@ export declare class Datetime {
      * The method sets the seconds for a specified date according to local time.
      *
      * Метод устанавливает секунды указанной даты по местному времени.
-     * @param value value / значения
+     * @param value value / значение
      * @returns this instance / текущий экземпляр
      */
     setSecond(value: number): this;
     /**
      * Enables language-sensitive date and time formatting.
      *
-     * Конструктором объектов, включающих языка-зависимое форматирование даты и времени.
+     * Включает форматирование даты и времени с учетом языка.
      * @param type type of date format for output / тип формата даты вывода
-     * @param styleOptions the representation of the month / представление месяца
+     * @param styleOptions month representation or Intl formatting options / представление месяца или опции форматирования Intl
      * @returns string formatted date string / отформатированная строка даты
      */
     locale(type?: GeoDate, styleOptions?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions): string;
@@ -2830,86 +2952,86 @@ export declare class Datetime {
      */
     moveMonthLast(): this;
     /**
-     * Translate to the first day of the next month.
+     * Moves to the first day of the next month.
      *
-     * Переводить на первый день следующего месяца.
+     * Переводит на первый день следующего месяца.
      * @returns this instance / текущий экземпляр
      */
     moveMonthNext(): this;
     /**
-     * Translate to the first day of the previous month.
+     * Moves to the first day of the previous month.
      *
-     * Переводить на первый день предыдущего месяца.
+     * Переводит на первый день предыдущего месяца.
      * @returns this instance / текущий экземпляр
      */
     moveMonthPrevious(): this;
     /**
-     * Translate to the first day of the week.
+     * Moves to the first day of the week.
      *
-     * Переводить на первый день недели.
+     * Переводит на первый день недели.
      * @returns this instance / текущий экземпляр
      */
     moveWeekdayFirst(): this;
     /**
-     * Translate to the last day of the week.
+     * Moves to the last day of the week.
      *
-     * Переводить на последний день недели.
+     * Переводит на последний день недели.
      * @returns this instance / текущий экземпляр
      */
     moveWeekdayLast(): this;
     /**
-     * Translate to the first day of the first week of the month.
+     * Moves 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.
+     * Moves to the last day of the last week of the month.
      *
-     * Переводить на первый день первой полной недели следующего месяца.
+     * Переводит на последний день последней недели месяца.
      * @returns this instance / текущий экземпляр
      */
     moveWeekdayLastByMonth(): this;
     /**
-     * Translate to the next week.
+     * Moves to the next week.
      *
-     * Переводить на следующую неделю.
+     * Переводит на следующую неделю.
      * @returns this instance / текущий экземпляр
      */
     moveWeekdayNext(): this;
     /**
-     * Translate to the previous week.
+     * Moves to the previous week.
      *
-     * Переводить на предыдущую неделю.
+     * Переводит на предыдущую неделю.
      * @returns this instance / текущий экземпляр
      */
     moveWeekdayPrevious(): this;
     /**
-     * Translate to the first day of the month.
+     * Moves to the first day of the month.
      *
-     * Переводить на первый день месяца.
+     * Переводит на первый день месяца.
      * @returns this instance / текущий экземпляр
      */
     moveDayFirst(): this;
     /**
-     * Translate to the last day of the month.
+     * Moves to the last day of the month.
      *
-     * Переводить на последний день месяца.
+     * Переводит на последний день месяца.
      * @returns this instance / текущий экземпляр
      */
     moveDayLast(): this;
     /**
-     * Translate to the next day.
+     * Moves to the next day.
      *
-     * Переводить на следующий день.
+     * Переводит на следующий день.
      * @returns this instance / текущий экземпляр
      */
     moveDayNext(): this;
     /**
-     * Translate to the previous day.
+     * Moves to the previous day.
      *
-     * Переводить на предыдущий день.
+     * Переводит на предыдущий день.
      * @returns this instance / текущий экземпляр
      */
     moveDayPrevious(): this;
@@ -2921,9 +3043,9 @@ export declare class Datetime {
      */
     clone(): Date;
     /**
-     * Clone the GeoDate object.
+     * Clone the Datetime object.
      *
-     * Клонировать объект GeoDate.
+     * Клонировать объект Datetime.
      * @returns Datetime cloned Datetime object / клонированный объект Datetime
      */
     cloneClass(): Datetime;
@@ -2935,23 +3057,23 @@ export declare class Datetime {
      */
     cloneMonthFirst(): Datetime;
     /**
-     * Clone the GeoDate object and move the month to the end of the year.
+     * Clone the Datetime object and move the month to the end of the year.
      *
-     * Клонировать объект GeoDate и перевести месяц на конец года.
+     * Клонировать объект Datetime и перевести месяц на конец года.
      * @returns Datetime cloned Datetime with December month / клонированный Datetime с декабрем
      */
     cloneMonthLast(): Datetime;
     /**
-     * Clone the GeoDate object and transfer it one month ahead.
+     * Clone the Datetime object and transfer it one month ahead.
      *
-     * Клонировать объект GeoDate и перевести на 1 месяц вперед.
+     * Клонировать объект Datetime и перевести на 1 месяц вперед.
      * @returns Datetime cloned Datetime with next month / клонированный Datetime со следующим месяцем
      */
     cloneMonthNext(): Datetime;
     /**
-     * Clone the GeoDate object and transfer it one month back.
+     * Clone the Datetime object and transfer it one month back.
      *
-     * Клонировать объект GeoDate и перевести на 1 месяц назад.
+     * Клонировать объект Datetime и перевести на 1 месяц назад.
      * @returns Datetime cloned Datetime with previous month / клонированный Datetime с предыдущим месяцем
      */
     cloneMonthPrevious(): Datetime;
@@ -2998,30 +3120,30 @@ export declare class Datetime {
      */
     cloneWeekdayPrevious(): Datetime;
     /**
-     * Clone the GeoDate object and move the day to the beginning of the month.
+     * Clone the Datetime object and move the day to the beginning of the month.
      *
-     * Клонировать объект GeoDate и перевести день на начало месяца.
+     * Клонировать объект Datetime и перевести день на начало месяца.
      * @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.
+     * Clone the Datetime object and move the day to the end of the month.
      *
-     * Клонировать объект GeoDate и перевести день на конец месяца.
+     * Клонировать объект Datetime и перевести день на конец месяца.
      * @returns Datetime cloned Datetime with last day of month / клонированный Datetime с последним днем месяца
      */
     cloneDayLast(): Datetime;
     /**
-     * Clone the GeoDate object and move by 1 day.
+     * Clone the Datetime object and move by 1 day.
      *
-     * Клонировать объект GeoDate и перевести на 1 день.
+     * Клонировать объект Datetime и перевести на 1 день.
      * @returns Datetime cloned Datetime with next day / клонированный Datetime со следующим днем
      */
     cloneDayNext(): Datetime;
     /**
-     * Clone the GeoDate object and go back by 1 day.
+     * Clone the Datetime object and go back by 1 day.
      *
-     * Клонировать объект GeoDate и вернуться на 1 день.
+     * Клонировать объект Datetime и вернуться на 1 день.
      * @returns Datetime cloned Datetime with previous day / клонированный Datetime с предыдущим днем
      */
     cloneDayPrevious(): Datetime;
@@ -3051,6 +3173,7 @@ export declare class Datetime {
  * Если DOM уже загружен (readyState равен 'interactive' или 'complete') или код выполняется вне браузера,
  * функция обратного вызова выполняется немедленно. Может вызываться без аргументов для простого ожидания готовности DOM.
  *
+ * @template T return value type / тип возвращаемого значения
  * @param callback optional function to execute when DOM is loaded / опциональная функция для выполнения при загрузке DOM
  * @param isServer whether to execute the callback in non-DOM/SSR environments (defaults to true) / выполнять ли функцию обратного вызова в среде без DOM/SSR (по умолчанию true)
  * @returns promise resolving to the callback result / промис, разрешающийся результатом выполнения функции
@@ -3060,12 +3183,29 @@ export declare class Datetime {
  *
  * В среде без DOM (SSR) выполнение можно отключить, передав `isServer: false`.
  */
-export declare function domContentLoaded<T = void>(callback?: () => T | Promise<T>, isServer?: boolean): Promise<T>;
+export declare function domContentLoaded<T = void>(callback?: (() => T | Promise<T>) | null, isServer?: boolean): Promise<T>;
+
+/**
+ * Returns an array of all elements at the specified coordinates.
+ *
+ * Возвращает массив всех элементов по указанным координатам.
+ * @param coordinator coordinates object / объект координат
+ * @returns array of elements / массив элементов
+ *
+ * @remarks
+ * In non-DOM (SSR) environments or when `document.elementsFromPoint` is unsupported,
+ * the function returns an empty array `[]`. Coordinates are evaluated relative to the viewport.
+ *
+ * В среде без DOM (SSR) или при отсутствии поддержки `document.elementsFromPoint`
+ * функция возвращает пустой массив `[]`. Координаты вычисляются относительно области просмотра (viewport).
+ */
+export declare function domElementsFromPoint(coordinator?: ImageCoordinator | null): Element[];
 
 /**
  * Selects the first element that matches the specified selectors.
  *
  * Выбирает первый элемент, который соответствует указанным селекторам.
+ * @template E type of the target element / тип целевого элемента
  * @param selectors selectors / селекторы
  * @returns first matched element or undefined / первый найденный элемент или undefined
  */
@@ -3075,6 +3215,7 @@ export declare function domQuerySelector<E extends Element = Element>(selectors:
  * Selects all elements that match the specified selectors.
  *
  * Выбирает все элементы, которые соответствуют указанным селекторам.
+ * @template E type of the elements / тип элементов
  * @param selectors selectors / селекторы
  * @returns list of matched elements or undefined / список найденных элементов или undefined
  */
@@ -3087,10 +3228,16 @@ export declare function domQuerySelectorAll<E extends Element = Element>(selecto
 export declare type ElementOrString<E extends ElementOrWindow> = E | string;
 
 /**
- * Union type for HTML elements and Window object/
- * Объединенный тип для HTML элементов и объекта Window
+ * Union type for HTML, SVG elements, Element and Window object/
+ * Объединенный тип для HTML, SVG элементов, Element и объекта Window
  */
-export declare type ElementOrWindow = HTMLElement | Window;
+export declare type ElementOrWindow = HTMLElement | SVGElement | Element | Window;
+
+/**
+ * Generic type resolving ElementOrWindow to an Element (Window resolves to HTMLElement)/
+ * Дженерик тип, разрешающий ElementOrWindow в Element (Window разрешается в HTMLElement)
+ */
+export declare type ElementResolved<E extends ElementOrWindow = HTMLElement> = E extends Window ? HTMLElement : Exclude<E, Window>;
 
 /**
  * Union type for all "empty" values including falsy primitives and string representations/
@@ -3104,8 +3251,14 @@ export declare type EmptyValue = Undefined | 0 | false | '' | 'undefined' | 'nul
  * Кодирует специальные символы в строке для безопасного использования в HTML-атрибутах.
  * @param text text to encode / текст для кодирования
  * @returns encoded text / закодированный текст
+ *
+ * @example
+ * ```ts
+ * encodeAttribute('<div class="box">') // => '&lt;div class=&quot;box&quot;&gt;'
+ * encodeAttribute(undefined) // => ''
+ * ```
  */
-export declare function encodeAttribute(text: string): string;
+export declare function encodeAttribute(text?: string | number | null): string;
 
 /**
  * Encodes basic HTML special characters (<, >, &) in a string while preserving quotes.
@@ -3117,6 +3270,13 @@ export declare function encodeAttribute(text: string): string;
  * @param text text to encode / текст для кодирования
  * @returns encoded text / закодированный текст
  *
+ * @example
+ * ```ts
+ * encodeLiteAttribute('Tom & Jerry') // => 'Tom &amp; Jerry'
+ * encodeLiteAttribute('<title> "Hello" </title>') // => '&lt;title&gt; "Hello" &lt;/title&gt;'
+ * encodeLiteAttribute(undefined) // => ''
+ * ```
+ *
  * @remarks
  * This function intentionally does NOT encode quotes (" and '). For encoding untrusted user input
  * inside HTML attributes, use `encodeAttribute` instead to prevent attribute injection vulnerabilities.
@@ -3124,7 +3284,7 @@ export declare function encodeAttribute(text: string): string;
  * Эта функция намеренно НЕ экранирует кавычки (" и '). Для экранирования пользовательского ввода
  * внутри HTML-атрибутов используйте `encodeAttribute` во избежание уязвимостей инъекции атрибутов.
  */
-export declare function encodeLiteAttribute(text: string): string;
+export declare function encodeLiteAttribute(text?: string | number | null): string;
 
 /**
  * Ensures that an image does not exceed the maximum size by resizing it if needed.
@@ -3155,7 +3315,14 @@ export declare class ErrorCenter {
      * @param group error group / группа ошибки
      * @returns error cause item or undefined / элемент причины ошибки или undefined
      */
-    static get(code: string, group?: string): ErrorCenterCauseItem | undefined;
+    static get(code: string, group?: ErrorCenterGroup): ErrorCenterCauseItem | undefined;
+    /**
+     * Returns the handler instance.
+     *
+     * Возвращает экземпляр обработчика.
+     * @returns handler instance / экземпляр обработчика
+     */
+    static getHandler(): ErrorCenterHandler;
     /**
      * Checks if a cause with specific code exists.
      *
@@ -3164,7 +3331,7 @@ export declare class ErrorCenter {
      * @param group error group / группа ошибки
      * @returns true if cause exists / true, если причина существует
      */
-    static has(code: string, group?: string): boolean;
+    static has(code: string, group?: ErrorCenterGroup): boolean;
     /**
      * Returns the global singleton instance of ErrorCenterInstance.
      *
@@ -3215,6 +3382,35 @@ export declare class ErrorCenter {
      * @param causes error causes list / список причин ошибок
      */
     static addList(causes: ErrorCenterCauseList): void;
+    /**
+     * Removes a cause from the storage by code and group.
+     *
+     * Удаляет причину ошибки из хранилища по коду и группе.
+     * @param code error code / код ошибки
+     * @param group error group / группа ошибки
+     */
+    static remove(code: string, group?: ErrorCenterGroup): void;
+    /**
+     * Removes a handler or all handlers for a group.
+     *
+     * Удаляет обработчик или все обработчики для группы.
+     * @param group target group / целевая группа
+     * @param handler handler callback / обратный вызов обработчика
+     */
+    static removeHandler(group?: ErrorCenterGroup, handler?: ErrorCenterHandlerCallback): void;
+    /**
+     * Removes a global callback.
+     *
+     * Удаляет глобальный обратный вызов.
+     * @param callback callback function to remove / функция обратного вызова для удаления
+     */
+    static removeCallback(callback: ErrorCenterHandlerCallback): void;
+    /**
+     * Resets registered handlers and callbacks.
+     *
+     * Сбрасывает зарегистрированные обработчики и обратные вызовы.
+     */
+    static reset(): void;
     /**
      * Triggers error handling for a group.
      *
@@ -3265,7 +3461,9 @@ export declare class ErrorCenterHandler {
     /** Console output flag or filter function / Флаг или функция фильтрации вывода в консоль */
     protected isConsole: ErrorCenterHandlerIsConsole;
     /**
-     * Constructor
+     * Constructor for ErrorCenterHandler.
+     *
+     * Конструктор ErrorCenterHandler.
      * @param handlers initial handlers list / начальный список обработчиков
      * @param isConsole console output flag or filter function / флаг или функция вывода в консоль
      */
@@ -3277,7 +3475,7 @@ export declare class ErrorCenterHandler {
      * @param group error group / группа ошибки
      * @returns handler item or undefined / элемент обработчика или undefined
      */
-    get(group: ErrorCenterGroup): ErrorCenterHandlerItem | undefined;
+    get(group?: ErrorCenterGroup): ErrorCenterHandlerItem | undefined;
     /**
      * Checks if handlers exist for a group.
      *
@@ -3285,7 +3483,7 @@ export declare class ErrorCenterHandler {
      * @param group error group / группа ошибки
      * @returns true if handlers exist / true, если обработчики существуют
      */
-    has(group: ErrorCenterGroup): boolean;
+    has(group?: ErrorCenterGroup): boolean;
     /**
      * Sets console output flag or filter function.
      *
@@ -3319,6 +3517,30 @@ export declare class ErrorCenterHandler {
      * @returns this instance / текущий экземпляр
      */
     addList(handlers: ErrorCenterHandlerList): this;
+    /**
+     * Removes a handler or all handlers for a group.
+     *
+     * Удаляет обработчик или все обработчики для группы.
+     * @param group error group / группа ошибки
+     * @param handler callback function to remove / функция обратного вызова для удаления
+     * @returns this instance / текущий экземпляр
+     */
+    remove(group?: ErrorCenterGroup, handler?: ErrorCenterHandlerCallback): this;
+    /**
+     * Removes a global callback.
+     *
+     * Удаляет глобальный обратный вызов.
+     * @param callback callback function to remove / функция обратного вызова для удаления
+     * @returns this instance / текущий экземпляр
+     */
+    removeCallback(callback: ErrorCenterHandlerCallback): this;
+    /**
+     * Resets all registered handlers and callbacks.
+     *
+     * Сбрасывает все зарегистрированные обработчики и обратные вызовы.
+     * @returns this instance / текущий экземпляр
+     */
+    reset(): this;
     /**
      * Triggers handlers for a group and logs to console.
      *
@@ -3377,7 +3599,9 @@ export declare class ErrorCenterInstance {
     /** List of stored error causes / Список сохраненных причин ошибок */
     protected causes: ErrorCenterCauseList;
     /**
-     * Constructor
+     * Constructor for ErrorCenterInstance.
+     *
+     * Конструктор ErrorCenterInstance.
      * @param causes initial list of error causes / начальный список причин ошибок
      * @param handler handler instance / экземпляр обработчика
      */
@@ -3390,7 +3614,14 @@ export declare class ErrorCenterInstance {
      * @param group error group / группа ошибки
      * @returns error cause item or undefined / элемент причины ошибки или undefined
      */
-    get(code: string, group?: string): ErrorCenterCauseItem | undefined;
+    get(code: string, group?: ErrorCenterGroup): ErrorCenterCauseItem | undefined;
+    /**
+     * Returns the handler instance.
+     *
+     * Возвращает экземпляр обработчика.
+     * @returns handler instance / экземпляр обработчика
+     */
+    getHandler(): ErrorCenterHandler;
     /**
      * Checks if a cause with specific code exists.
      *
@@ -3399,7 +3630,7 @@ export declare class ErrorCenterInstance {
      * @param group error group / группа ошибки
      * @returns true if cause exists / true, если причина существует
      */
-    has(code: string, group?: string): boolean;
+    has(code: string, group?: ErrorCenterGroup): boolean;
     /**
      * Sets console output flag or filter function for the handler.
      *
@@ -3449,6 +3680,39 @@ export declare class ErrorCenterInstance {
      * @returns this instance / текущий экземпляр
      */
     addList(causes: ErrorCenterCauseList): this;
+    /**
+     * Removes a cause from the storage by code and group.
+     *
+     * Удаляет причину ошибки из хранилища по коду и группе.
+     * @param code error code / код ошибки
+     * @param group error group / группа ошибки
+     * @returns this instance / текущий экземпляр
+     */
+    remove(code: string, group?: ErrorCenterGroup): this;
+    /**
+     * Removes a handler or all handlers for a group.
+     *
+     * Удаляет обработчик или все обработчики для группы.
+     * @param group target group / целевая группа
+     * @param handler handler callback / обратный вызов обработчика
+     * @returns this instance / текущий экземпляр
+     */
+    removeHandler(group?: ErrorCenterGroup, handler?: ErrorCenterHandlerCallback): this;
+    /**
+     * Removes a global callback.
+     *
+     * Удаляет глобальный обратный вызов.
+     * @param callback callback function to remove / функция обратного вызова для удаления
+     * @returns this instance / текущий экземпляр
+     */
+    removeCallback(callback: ErrorCenterHandlerCallback): this;
+    /**
+     * Resets registered handlers and callbacks.
+     *
+     * Сбрасывает зарегистрированные обработчики и обратные вызовы.
+     * @returns this instance / текущий экземпляр
+     */
+    reset(): this;
     /**
      * Triggers error handling for a group.
      *
@@ -3471,10 +3735,10 @@ export declare class ErrorCenterInstance {
  * Escapes special regex characters in a string so it can be used safely in a RegExp.
  *
  * Экранирует специальные символы регулярного выражения в строке, чтобы её можно было безопасно использовать в RegExp.
- * @param value string to escape / строка для экранирования
+ * @param value string or number to escape / строка или число для экранирования
  * @returns escaped string / экранированная строка
  */
-export declare function escapeExp(value: string): string;
+export declare function escapeExp(value?: string | number | null): string;
 
 /**
  * Type for tracking active event listeners and observers/
@@ -3766,22 +4030,31 @@ export declare function executeFunction<T, Args extends unknown[] = unknown[]>(c
  */
 export declare function executePromise<T, Args extends unknown[] = unknown[]>(callback: ((...args: Args) => PromiseLike<T> | T) | PromiseLike<T> | T, ...args: Args): Promise<Awaited<T>>;
 
-export declare function forEach<T, R>(data: readonly T[], callback: (item: T, index: number, collection: readonly T[]) => R, saveUndefined?: boolean): R[];
-
-export declare function forEach<T, R>(data: Set<T>, callback: (item: T, key: T, collection: Set<T>) => R, saveUndefined?: boolean): R[];
-
-export declare function forEach<K, V, R>(data: Map<K, V>, callback: (item: V, key: K, collection: Map<K, V>) => R, saveUndefined?: boolean): R[];
-
-export declare function forEach<T, R, D extends Record<string, unknown> = Record<string, T>>(data: D & Record<string, T>, callback: (item: T, key: string, collection: D) => R, saveUndefined?: boolean): R[];
-
-export declare function forEach<T, R, D extends ForEachData<T> = ForEachData<T>, K = ForEachKey<D>>(data: D & ForEachData<T>, callback: (item: T, key: K, collection: D) => R, saveUndefined?: boolean): R[];
+/**
+ * The function performs the specified function once for each element in the collection (Array, Object, Map, Set)
+ * and returns an array with the results of executing the function (omitting undefined values unless saveUndefined is true).
+ *
+ * Функция выполняет указанную функцию один раз для каждого элемента в коллекции (Array, Object, Map, Set)
+ * и возвращает массив с результатами выполнения функции (пропуская значения undefined, если saveUndefined не равен true).
+ * @param data object or collection for iteration / объект или коллекция для перебора
+ * @param callback a function to execute for each element / функция, которая будет вызвана для каждого элемента
+ * @param saveUndefined if true, the function will preserve undefined return values / если true, функция сохранит значения undefined
+ * @returns an array with the results of executing the function / массив с результатами выполнения функции
+ */
+export declare function forEach<T = any, R = any, D extends ForEachData<T> = ForEachData<T>, K = ForEachKey<D>, S extends boolean = false>(data: D, callback: (item: D extends object ? ForEachItem<D> : T, key: K, collection: D) => R, saveUndefined?: S): ForEachReturn<R, S>;
 
 /** Type of collection supported for iteration / Тип коллекции, поддерживаемой для перебора */
-export declare type ForEachData<T> = readonly T[] | Record<string, T> | Map<unknown, T> | Set<T>;
+export declare type ForEachData<T = any> = readonly T[] | Record<PropertyKey, T> | Map<unknown, T> | Set<T> | object;
+
+/** Type of item based on collection structure / Тип элемента в зависимости от структуры коллекции */
+export declare type ForEachItem<D> = D extends readonly (infer T)[] ? T : D extends Set<infer S> ? S : D extends Map<unknown, infer V> ? V : D extends object ? D[keyof D] : unknown;
 
 /** Type of key based on the collection structure / Тип ключа в зависимости от структуры коллекции */
 export declare type ForEachKey<D> = D extends readonly unknown[] ? number : D extends Set<infer S> ? S : D extends Map<infer K, unknown> ? K : string;
 
+/** Return array type based on saveUndefined / Тип возвращаемого массива в зависимости от saveUndefined */
+export declare type ForEachReturn<R, S extends boolean = false> = (S extends true ? R : Exclude<R, undefined>)[];
+
 /**
  * Class for formatting a list of data based on provided options.
  *
@@ -4183,6 +4456,17 @@ export declare enum FormattersType {
     unit = "unit"
 }
 
+/**
+ * Iterates over own enumerable properties of an object, safely skipping prototype pollution keys (__proto__, constructor, prototype).
+ * Supports early termination when the callback returns false.
+ *
+ * Перебирает собственные перечисляемые свойства объекта, безопасно пропуская ключи загрязнения прототипа (__proto__, constructor, prototype).
+ * Поддерживает досрочное прерывание, если функция обратного вызова возвращает false.
+ * @param data object for iteration / объект для перебора
+ * @param callback a function executed for each property / функция, выполняемая для каждого свойства
+ */
+export declare function forOwn<T extends object = Record<string, unknown>, K extends Extract<keyof T, string> = Extract<keyof T, string>>(data?: T, callback?: (value: T[K], key: K, collection: T) => void | boolean): void;
+
 /**
  * Cyclically calls requestAnimationFrame while next returns true.
  *
@@ -4229,6 +4513,11 @@ export declare type FunctionVoid = () => void;
  * Предоставляет централизованный интерфейс для управления локалью, страной и часовым поясом.
  */
 export declare class Geo {
+    /**
+     * Protected constructor for static utility class /
+     * Защищенный конструктор для статического утилитного класса
+     */
+    protected constructor();
     /**
      * Returns information about the current country and language.
      *
@@ -4243,7 +4532,7 @@ export declare class Geo {
      * @param code location code / код локации
      * @param save whether to persist the change in storage / сохранять ли изменения в хранилище
      */
-    static set(code: string, save?: boolean): void;
+    static set(code?: string, save?: boolean): void;
     /**
      * Returns geo data by country or language code from the global database.
      *
@@ -4259,7 +4548,7 @@ export declare class Geo {
      * @param code full locale string / полная строка локали
      * @returns geo item or undefined / гео-объект или undefined
      */
-    static getByCodeFull(code: string): GeoItem | undefined;
+    static getByCodeFull(code?: string): GeoItem | undefined;
     /**
      * Returns geo data for a specific country by its code.
      *
@@ -4267,7 +4556,7 @@ export declare class Geo {
      * @param country country code / код страны
      * @returns geo item or undefined / гео-объект или undefined
      */
-    static getByCountry(country: string): GeoItem | undefined;
+    static getByCountry(country?: string): GeoItem | undefined;
     /**
      * Returns geo data for a specific language by its code.
      *
@@ -4275,7 +4564,7 @@ export declare class Geo {
      * @param language language code / код языка
      * @returns geo item or undefined / гео-объект или undefined
      */
-    static getByLanguage(language: string): GeoItem | undefined;
+    static getByLanguage(language?: string): GeoItem | undefined;
     /**
      * Returns the 2-letter code of the current country.
      *
@@ -4295,6 +4584,7 @@ export declare class Geo {
      *
      * Возвращает полностью обработанные гео-данные с учетом текущего языка.
      * @returns full geo item data / полные данные гео-объекта
+     * @deprecated Use get() / Используйте get()
      */
     static getItem(): GeoItemFull;
     /**
@@ -4373,7 +4663,7 @@ export declare class Geo {
      * Устанавливает значение по умолчанию для кода страны.
      * @param code default code value / значение кода по умолчанию
      */
-    static setValueDefault(code?: string | (() => string)): void;
+    static setValueDefault(code?: string | (() => string | undefined)): void;
     /**
      * Adds or updates country geo data.
      * Merges with existing country data if found, or creates a new entry.
@@ -4384,7 +4674,7 @@ export declare class Geo {
      * @param item partial or full geo item data / частичные или полные гео-данные
      * @returns GeoInstance instance / экземпляр GeoInstance
      */
-    static add(country: string, item: Partial<GeoItem>): GeoInstance;
+    static add(country: string, item?: Partial<GeoItem>): GeoInstance;
     /**
      * Adds or updates multiple countries in the geo list.
      *
@@ -4392,25 +4682,31 @@ export declare class Geo {
      * @param list map of country codes to geo items / карта кодов стран к гео-объектам
      * @returns GeoInstance instance / экземпляр GeoInstance
      */
-    static addList(list: Record<string, Partial<GeoItem>>): GeoInstance;
+    static addList(list?: Record<string, Partial<GeoItem>>): GeoInstance;
     /**
      * Finds or determines the geo data for a given code. Alias for getByCode.
      *
      * Находит или определяет гео-данные для заданного кода. Алиас для getByCode.
      * @param code country or language code / код страны или языка
      * @returns full geo data / полные гео-данные
+     * @deprecated Use getByCode() / Используйте getByCode()
      */
-    static find(code: string): GeoItemFull;
+    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 / данные гео-объекта
+     * @param language optional language override / опциональное переопределение языка
+     * @param raw whether to skip language processing / не обрабатывать ли язык
      * @returns standard string / стандартная строка
      */
-    static toStandard(item: GeoItem): string;
+    static toStandard(item?: GeoItem, language?: string, raw?: boolean): string;
 }
 
+/** Default first day of the week ('Mo' = Monday) / Первый день недели по умолчанию ('Mo' = понедельник) */
+export declare const GEO_DEFAULT_FIRST_DAY = "Mo";
+
 export declare const GEO_FLAG_ICON_NAME = "f";
 
 /**
@@ -4604,40 +4900,20 @@ export declare type GeoHours = '12' | '24';
  */
 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')
+     * Location manager instance /
+     * Экземпляр менеджера локации
      */
-    private location;
+    protected readonly location: GeoLocation;
     /**
-     * Value by default for the country code /
-     * Значение по умолчанию для кода страны
+     * Time zone manager instance /
+     * Экземпляр менеджера часового пояса
      */
-    private valueDefault?;
+    protected timezone?: GeoTimezone;
     /**
      * Detailed data about the current country /
      * Детальные данные о текущей стране
      */
-    private item;
-    /**
-     * Current language code /
-     * Текущий код языка
-     */
-    private language;
-    /**
-     * Current time zone offset in minutes /
-     * Текущее смещение часового пояса в минутах
-     */
-    private timezone;
+    protected item: GeoItemFull;
     /**
      * Constructor.
      * Initializes the location and related data.
@@ -4659,8 +4935,9 @@ export declare class GeoInstance {
      * Обновляет текущее местоположение и связанные с ним данные.
      * @param code location code (e.g., 'en-GB') / код локации (например, 'en-GB')
      * @param save whether to save the location in storage / нужно ли сохранять местоположение в хранилище
+     * @returns current instance / текущий экземпляр
      */
-    set(code: string, save?: boolean): void;
+    set(code?: string, save?: boolean): this;
     /**
      * Returns data about the country by its code.
      *
@@ -4670,29 +4947,29 @@ export declare class GeoInstance {
      */
     getByCode(code?: string): GeoItemFull;
     /**
-     * Returns full data by language and country combination.
+     * Returns geo item 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;
+    getByCodeFull(code?: string): GeoItem | undefined;
     /**
-     * Returns full data by country code.
+     * Returns geo item data by country code.
      *
-     * Возвращает полные данные по коду страны.
+     * Возвращает гео-данные по коду страны.
      * @param country country code / код страны
      * @returns geo item or undefined / гео-объект или undefined
      */
-    getByCountry(country: string): GeoItem | undefined;
+    getByCountry(country?: string): GeoItem | undefined;
     /**
-     * Returns full data by language code.
+     * Returns geo item data by language code.
      *
-     * Возвращает полные данные по коду языка.
+     * Возвращает гео-данные по коду языка.
      * @param language language code / код языка
      * @returns geo item or undefined / гео-объект или undefined
      */
-    getByLanguage(language: string): GeoItem | undefined;
+    getByLanguage(language?: string): GeoItem | undefined;
     /**
      * Getting the current country code.
      *
@@ -4712,6 +4989,7 @@ export declare class GeoInstance {
      *
      * Получение обработанных данных, включая текущий язык.
      * @returns full geo item data / полные данные гео-объекта
+     * @deprecated Use get() / Используйте get()
      */
     getItem(): GeoItemFull;
     /**
@@ -4779,12 +5057,13 @@ export declare class GeoInstance {
      */
     setTimezone(timezone: number): this;
     /**
-     * Sets the default value for the country code.
+     * Sets the default value or resolver for the location code.
      *
-     * Устанавливает значение по умолчанию для кода страны.
-     * @param code default code value / значение кода по умолчанию
+     * Устанавливает значение по умолчанию или функцию его вычисления для кода локации.
+     * @param code default code value or provider / значение кода по умолчанию или провайдер
+     * @returns current instance / текущий экземпляр
      */
-    setValueDefault(code?: string | (() => string)): void;
+    setValueDefault(code?: string | (() => string | undefined)): this;
     /**
      * Adds or updates country geo data.
      * Merges with existing country data if found, or creates a new entry.
@@ -4795,7 +5074,7 @@ export declare class GeoInstance {
      * @param item partial or full geo item data / частичные или полные гео-данные
      * @returns current instance / текущий экземпляр
      */
-    add(country: string, item: Partial<GeoItem>): this;
+    add(country: string, item?: Partial<GeoItem>): this;
     /**
      * Adds or updates multiple countries in the geo list.
      *
@@ -4803,80 +5082,40 @@ export declare class GeoInstance {
      * @param list map of country codes to geo items / карта кодов стран к гео-объектам
      * @returns current instance / текущий экземпляр
      */
-    addList(list: Record<string, Partial<GeoItem>>): this;
+    addList(list?: Record<string, Partial<GeoItem>>): this;
     /**
-     * Finds the country data by its code or name.
+     * Finds the country data by its code.
      *
-     * Ищет данные о стране по ее коду или названию.
+     * Ищет данные о стране по ее коду.
      * @param code country code / код страны
      * @returns full geo data / полные гео-данные
+     * @deprecated Use getByCode() / Используйте getByCode()
      */
-    find(code: string): GeoItemFull;
+    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 / опциональное переопределение языка
+     * @param raw whether to skip language processing / не обрабатывать ли язык
      * @returns standard code string / строка стандартного кода
      */
-    toStandard(item: GeoItem, language?: string): string;
-    /**
-     * 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;
+    toStandard(item?: GeoItem, language?: string, raw?: boolean): string;
     /**
-     * Internal method to extract language code from a location string.
+     * Internal method to get or initialize the time zone manager instance.
      *
-     * Внутренний метод для извлечения кода языка из строки локации.
-     * @param code combined string / комбинированная строка
-     * @returns language code / код языка
+     * Внутренний метод для получения или инициализации экземпляра менеджера часового пояса.
+     * @returns time zone manager instance / экземпляр менеджера часового пояса
      */
-    private toLanguage;
+    protected getTimezoneObject(): GeoTimezone;
     /**
-     * Internal method to fill missing fields in a geo item.
+     * Internal method to update current geo item.
      *
-     * Внутренний метод для заполнения отсутствующих полей в гео-объекте.
-     * @param item basic geo item / базовый гео-объект
-     * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
-     * @returns full geo item data / полные данные гео-объекта
+     * Внутренний метод для обновления текущего гео-объекта.
+     * @returns void / ничего не возвращает
      */
-    private toFull;
+    protected updateItem(): void;
 }
 
 /**
@@ -5260,6 +5499,211 @@ export declare interface GeoItemFull extends Omit<GeoItem, 'firstDay'> {
     locationLanguage: string;
 }
 
+/**
+ * Class for managing and querying the global list of geographical countries and locales.
+ * Maintains an absolute deep copy of the media geo database shared across SSR requests.
+ *
+ * Класс для управления и запроса глобального списка географических стран и локалей.
+ * Поддерживает абсолютную глубокую копию гео-базы данных media, общую для запросов в SSR.
+ */
+export declare class GeoList {
+    /**
+     * Cached deep copy of the global country list /
+     * Кэшированная глубокая копия глобального списка стран
+     */
+    protected static list?: GeoItem[];
+    /**
+     * Protected constructor for static utility class /
+     * Защищенный конструктор для статического утилитного класса
+     */
+    protected constructor();
+    /**
+     * Returns the list of countries, creating an absolute deep copy on first access.
+     * Shared globally across the application and SSR requests.
+     *
+     * Возвращает список стран, создавая абсолютную глубокую копию при первом обращении.
+     * Является общим глобально для всего приложения и SSR-запросов.
+     * @returns list of geo items / список гео-объектов
+     */
+    static get(): GeoItem[];
+    /**
+     * Returns full country data by language and country combination (e.g. 'en-US' or 'RU-ru').
+     *
+     * Возвращает полные данные по комбинации языка и страны (например, 'en-US' или 'RU-ru').
+     * @param [code] string in the form of language-country / строка в виде язык-страна
+     * @returns geo item or undefined / гео-объект или undefined
+     */
+    static getByCodeFull(code?: string): GeoItem | undefined;
+    /**
+     * Returns country data by its primary country code or alternative codes.
+     *
+     * Возвращает данные страны по ее основному коду страны или альтернативным кодам.
+     * @param [country] country code / код страны
+     * @returns geo item or undefined / гео-объект или undefined
+     */
+    static getByCountry(country?: string): GeoItem | undefined;
+    /**
+     * Returns country data by language code or alternative language codes.
+     *
+     * Возвращает данные страны по коду языка или альтернативным кодам языка.
+     * @param [language] language code / код языка
+     * @returns geo item or undefined / гео-объект или undefined
+     */
+    static getByLanguage(language?: string): GeoItem | undefined;
+    /**
+     * Adds or updates country geo data in the list.
+     * 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 added or updated geo item / добавленный или обновленный гео-объект
+     */
+    static add(country: string, item?: Partial<GeoItem>): GeoItem;
+    /**
+     * Adds or updates multiple countries in the geo list.
+     *
+     * Добавляет или обновляет несколько стран в гео-списке.
+     * @param [list] map of country codes to geo items / карта кодов стран к гео-объектам
+     */
+    static addList(list?: Record<string, Partial<GeoItem>>): void;
+    /**
+     * Resets the cached list to undefined, forcing a fresh deep copy on next access.
+     * Useful for testing and environment resets.
+     *
+     * Сбрасывает кэшированный список в undefined, вызывая создание новой глубокой копии при следующем доступе.
+     * Полезно для тестов и сброса окружения.
+     */
+    static reset(): void;
+    /**
+     * Finds the index of a country in the list by its country code.
+     *
+     * Находит индекс страны в списке по ее коду страны.
+     * @param [country] country code / код страны
+     * @returns index of the country in the list, or -1 if not found / индекс страны в списке или -1, если не найдена
+     */
+    protected static getIndex(country?: string): number;
+    /**
+     * Merges and returns the unit configuration object for a country item.
+     *
+     * Объединяет и возвращает объект конфигурации единиц измерения для элемента страны.
+     * @param current current unit configuration / текущая конфигурация единиц измерения
+     * @param override unit configuration overrides / переопределения конфигурации единиц измерения
+     * @returns object containing the merged unit property or an empty object / объект, содержащий объединенное свойство unit, или пустой объект
+     */
+    protected static getUnit(current?: GeoItem['unit'], override?: GeoItem['unit']): {
+        unit?: GeoItem['unit'];
+    };
+}
+
+/**
+ * Class for managing and resolving the current location code within Geo.
+ * Handles persistence in DataStorage and Cookie, DOM fallback detection, and default fallbacks.
+ *
+ * Класс для управления и определения текущего кода локации внутри Geo.
+ * Обрабатывает сохранение в DataStorage и Cookie, определение по DOM и значения по умолчанию.
+ */
+export declare class GeoLocation {
+    protected valueDefault?: string | (() => string | undefined) | undefined;
+    /**
+     * Data storage instance for geo code /
+     * Экземпляр хранилища данных для гео-кода
+     */
+    protected readonly storage: DataStorage<string>;
+    /**
+     * Current location code (e.g., 'en-GB') /
+     * Текущий код локации (например, 'en-GB')
+     */
+    protected location: string;
+    /**
+     * Constructor for GeoLocation.
+     * Initializes the location from storage, cookies, DOM, or default fallback.
+     *
+     * Конструктор для GeoLocation.
+     * Инициализирует местоположение из хранилища, куки, DOM или значения по умолчанию.
+     * @param valueDefault optional default value or provider / опциональное значение по умолчанию или провайдер
+     */
+    constructor(valueDefault?: string | (() => string | undefined) | undefined);
+    /**
+     * Returns the current location code string.
+     *
+     * Возвращает строку текущего кода локации.
+     * @returns current location code / текущий код локации
+     */
+    get(): string;
+    /**
+     * Updates the current location code and optionally persists it in storage and cookie.
+     *
+     * Обновляет текущий код локации и опционально сохраняет его в хранилище и куки.
+     * @param code optional location code (e.g., 'en-GB') / опциональный код локации (например, 'en-GB')
+     * @param save whether to save the location in storage and cookie / нужно ли сохранять местоположение в хранилище и куки
+     * @returns current instance / текущий экземпляр
+     */
+    set(code?: string, save?: boolean): this;
+    /**
+     * Returns the raw country code extracted from the current location.
+     *
+     * Возвращает сырой код страны, извлеченный из текущей локации.
+     * @returns country code / код страны
+     */
+    getCountry(): string;
+    /**
+     * Returns the raw language code extracted from the current location.
+     *
+     * Возвращает сырой код языка, извлеченный из текущей локации.
+     * @returns language code / код языка
+     */
+    getLanguage(): string;
+    /**
+     * Sets the default value or resolver for the location code.
+     *
+     * Устанавливает значение по умолчанию или функцию его вычисления для кода локации.
+     * @param code default code value / значение кода по умолчанию
+     * @returns current instance / текущий экземпляр
+     */
+    setValueDefault(code?: string | (() => string | undefined)): this;
+    /**
+     * Internal method to get the geo cookie instance.
+     *
+     * Внутренний метод для получения экземпляра куки гео.
+     * @returns cookie instance / экземпляр куки
+     */
+    protected getCookie(): Cookie<string>;
+    /**
+     * Internal method to determine the initial location.
+     * Resolves in order: Cookie -> DOM sources -> default provider -> DEFAULT_LOCATION.
+     *
+     * Внутренний метод для определения начального местоположения.
+     * Определяет по порядку: Cookie -> источники DOM -> провайдер по умолчанию -> DEFAULT_LOCATION.
+     * @returns initial location code / начальный код локации
+     */
+    protected findLocation(): string;
+    /**
+     * Internal method to determine the location from document attributes (html lang).
+     *
+     * Внутренний метод для определения местоположения из атрибутов документа (html lang).
+     * @returns location code from document or undefined / код локации из документа или undefined
+     */
+    protected findLocationDocument(): string | undefined;
+    /**
+     * Internal method to determine the location from DOM-specific sources.
+     * Returns undefined when not in a DOM runtime or when no DOM locale is available.
+     *
+     * Внутренний метод для определения местоположения из DOM-источников.
+     * Возвращает undefined вне DOM-окружения или при отсутствии локали в DOM.
+     * @returns location code from DOM or undefined / код локации из DOM или undefined
+     */
+    protected findLocationDom(): string | undefined;
+    /**
+     * Internal method to determine the location from navigator properties.
+     *
+     * Внутренний метод для определения местоположения из свойств navigator.
+     * @returns location code from navigator or undefined / код локации из navigator или undefined
+     */
+    protected findLocationNavigator(): string | undefined;
+}
+
 /**
  * A class for storing and processing phone number masks.
  *
@@ -5419,6 +5863,62 @@ export declare interface GeoPhoneValue {
     value: string;
 }
 
+/**
+ * Class for managing and formatting time zone offsets within a GeoInstance.
+ * Stores the offset in minutes following Date.prototype.getTimezoneOffset() semantics
+ * (negative for zones east of UTC, positive for zones west of UTC).
+ *
+ * Класс для управления и форматирования смещения часового пояса внутри GeoInstance.
+ * Хранит смещение в минутах по семантике Date.prototype.getTimezoneOffset()
+ * (отрицательное для зон восточнее UTC, положительное для зон западнее UTC).
+ */
+export declare class GeoTimezone {
+    /**
+     * Current time zone offset in minutes /
+     * Текущее смещение часового пояса в минутах
+     */
+    protected value: number;
+    /**
+     * Constructor for GeoTimezone.
+     * Initializes the time zone offset in minutes.
+     *
+     * Конструктор для GeoTimezone.
+     * Инициализирует смещение часового пояса в минутах.
+     * @param timezone initial time zone offset in minutes / начальное смещение часового пояса в минутах
+     */
+    constructor(timezone?: number);
+    /**
+     * Returns the current time zone offset in minutes.
+     *
+     * Возвращает текущее смещение часового пояса в минутах.
+     * @returns time zone offset in minutes / смещение часового пояса в минутах
+     */
+    get(): number;
+    /**
+     * Updates the current time zone offset in minutes.
+     *
+     * Обновляет текущее смещение часового пояса в минутах.
+     * @param timezone new time zone offset in minutes / новое смещение часового пояса в минутах
+     * @returns current instance / текущий экземпляр
+     */
+    set(timezone: number): this;
+    /**
+     * Returns the current time zone offset as an ISO 8601 formatted string (e.g., '+03:00', '-05:00').
+     *
+     * Возвращает текущее смещение часового пояса в виде отформатированной строки ISO 8601 (например, '+03:00', '-05:00').
+     * @returns formatted time zone string / отформатированная строка часового пояса
+     */
+    getFormat(): string;
+    /**
+     * Normalizes a raw time zone offset to a finite integer number of minutes.
+     *
+     * Нормализует исходное смещение часового пояса до конечного целого числа минут.
+     * @param timezone raw time zone offset / исходное смещение часового пояса
+     * @returns normalized integer offset / нормализованное целочисленное смещение
+     */
+    protected normalize(timezone: number): number;
+}
+
 /** Timezone display style options / Опции стиля отображения часового пояса */
 export declare type GeoTimeZoneStyle = 'minute' | 'hour' | 'ISO8601' | 'RFC';
 
@@ -5683,9 +6183,10 @@ export declare function getColumn<T, K extends keyof T>(array: ObjectOrArray<T>,
  * Рекомендуется использовать эту функцию только внутри хуков, выполняющихся на клиенте (например, `onMounted` в Vue или `useEffect` in React).
  *
  * @param format type of date format for output / тип формата даты вывода
+ * @param timeZone add time zone (default: true) / добавить временную зону (по умолчанию: true)
  * @returns formatted current date / текущая дата в указанном формате
  */
-export declare function getCurrentDate(format?: GeoDate): string;
+export declare function getCurrentDate(format?: GeoDate, timeZone?: boolean): string;
 
 /**
  * Returns the current time in milliseconds.
@@ -5704,13 +6205,21 @@ export declare function getCurrentDate(format?: GeoDate): string;
 export declare function getCurrentTime(): number;
 
 /**
- * Returns the first Element in the document that matches the specified selector or the element.
+ * Returns the first Element in the document that matches the specified selector or the element itself.
+ * If Window is passed, returns document.body in DOM runtime.
+ * In non-DOM environments (SSR), returns undefined for selector strings, or returns the provided element reference as-is.
+ * Returns undefined if the element is not found, or if null/undefined is provided.
  *
  * Возвращает первый Element документа, который соответствует указанному селектору или сам элемент.
- * @param element selectors for matching or an Element / селектор для сопоставления или Element
+ * При передаче Window возвращает document.body в DOM-окружении.
+ * В средах без DOM (SSR) возвращает undefined для строковых селекторов или сам переданный элемент без изменений.
+ * Возвращает undefined, если элемент не найден или передан null/undefined.
+ * @template E element or Window type / тип элемента или Window
+ * @template R resolved element type / тип разрешённого элемента
+ * @param element selector for matching, Element, Window, or null / селектор для сопоставления, Element, Window или null
  * @returns found element or undefined / найденный элемент или undefined
  */
-export declare function getElement<E extends ElementOrWindow, R extends Exclude<E, Window>>(element?: ElementOrString<E>): R | undefined;
+export declare function getElement<E extends ElementOrWindow = HTMLElement, R extends ElementResolved<E> = ElementResolved<E>>(element?: ElementOrString<E> | null): R | undefined;
 
 /**
  * Returns the identifier (ID) of the element or creates it if the element has no ID.
@@ -5732,12 +6241,32 @@ export declare function getElementId<E extends ElementOrWindow>(element?: Elemen
  * @param onload load callback / колбэк успешной загрузки
  * @param onerror error callback / колбэк ошибки загрузки
  * @returns HTMLImageElement or undefined / HTMLImageElement или undefined
+ *
+ * @remarks
+ * If `image` is a string, this function creates a new in-memory `HTMLImageElement` via `createElement`.
+ * The `onload` and `onerror` event listeners are attached before assigning the `src` attribute.
+ * If `image` is already an `HTMLImageElement`, it is returned directly without modifying its existing listeners.
+ * If `image` is null, undefined, or an invalid non-element value, the function safely returns `undefined`.
+ *
+ * When running in a server-side (SSR / non-DOM) environment, this function always returns `undefined` for string sources.
+ *
+ * The created element is not automatically attached to the DOM tree. If using dynamic Blob URLs (`URL.createObjectURL`),
+ * remember to revoke them in `onload`/`onerror` to prevent memory leaks.
+ *
+ * Если `image` является строкой, функция создаёт новый элемент `HTMLImageElement` в памяти через `createElement`.
+ * Обработчики событий `onload` и `onerror` назначаются до присвоения атрибута `src`.
+ * Если `image` уже является экземпляром `HTMLImageElement`, он возвращается напрямую без изменения существующих обработчиков.
+ * Если `image` равен null, undefined или является недопустимым не-элементом, функция безопасно возвращает `undefined`.
+ *
+ * При выполнении на сервере (в среде SSR / non-DOM) функция всегда возвращает `undefined` для строковых источников.
+ *
+ * Созданный элемент не добавляется в DOM-дерево автоматически. При использовании динамических Blob URL (`URL.createObjectURL`)
+ * не забудьте освободить их в `onload`/`onerror` во избежание утечек памяти.
  */
-export declare function getElementImage(image?: HTMLImageElement | string, onload?: GetElementImageCallback, onerror?: GetElementImageCallback): HTMLImageElement | undefined;
+export declare function getElementImage(image?: HTMLImageElement | string | null, onload?: GetElementImageCallback, onerror?: GetElementImageCallback): HTMLImageElement | undefined;
 
 /**
- * Callback function for image events.
- *
+ * Callback function for image events /
  * Функция обратного вызова для событий изображения.
  * @param image image element / элемент изображения
  * @param event DOM event or error description / событие DOM или описание ошибки
@@ -5746,34 +6275,42 @@ export declare type GetElementImageCallback = (image: HTMLImageElement, event?:
 
 /**
  * Returns the value of an element property by its key.
+ * If Window is passed, retrieves the property from document.body in DOM runtime.
  *
  * Возвращает значение свойства элемента по его ключу.
+ * При передаче Window возвращает значение свойства из document.body в DOM-окружении.
+ * @template E element or Window type / тип элемента или Window
+ * @template K property key type / тип ключа свойства
+ * @template D default value type / тип значения по умолчанию
  * @param element checked element / проверяемый элемент
  * @param property property key to retrieve / ключ свойства для получения значения
  * @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>, property: K | string, defaultValue?: D): T[K] | D | undefined;
+export declare function getElementItem<E extends ElementOrWindow = HTMLElement, K extends keyof ElementResolved<E> = keyof ElementResolved<E>, D = undefined>(element?: ElementOrString<E> | null, property?: K | string | number, defaultValue?: D): ElementResolved<E>[K] | D;
 
 /**
- * Returns window or element.
+ * Returns the Window object if window is passed, or the first Element matching the specified selector or element itself.
+ * Unlike getElement, it preserves and returns the Window object directly without resolving it to document.body.
  *
- * Возвращает окно или элемент.
- * @param element selectors for matching or an Element / селектор для сопоставления или Element
+ * Возвращает объект Window при передаче window, либо первый Element, соответствующий селектору или переданному элементу.
+ * В отличие от getElement, сохраняет и возвращает объект Window напрямую, не разрешая его в document.body.
+ * @template E element or Window type / тип элемента или Window
+ * @param element selector for matching, Element, Window, or null / селектор для сопоставления, Element, Window или null
  * @returns window or DOM element, or undefined / окно или DOM-элемент, либо undefined
  */
-export declare function getElementOrWindow<E extends ElementOrWindow>(element?: ElementOrString<E>): E | undefined;
+export declare function getElementOrWindow<E extends ElementOrWindow = HTMLElement>(element?: ElementOrString<E> | null): E | undefined;
 
 /**
  * Generates a safe script tag for data hydration.
  *
  * Генерирует безопасный тег скрипта для гидратации данных.
- * @param id script tag ID / ID тега скрипта
+ * @param id script tag ID / идентификатор тега скрипта
  * @param data data to be stored / данные для хранения
- * @returns generated script tag string / сгенерированная строка тега скрипта
+ * @returns generated script tag string / сгенерированная HTML-строка тега скрипта
  */
-export declare function getElementSafeScript<T = unknown>(id: string, data: T): string;
+export declare function getElementSafeScript<T = unknown>(id: string | number, data?: T): string;
 
 /**
  * Creates a case-insensitive regular expression for an exact match of a phrase (without anchors).
@@ -5804,27 +6341,27 @@ export declare function getExp(value: string, flags?: string, pattern?: string):
  * @param value input value / входное значение
  * @returns first element of an array or object / первый элемент массива или объекта
  */
-export declare function getFirst<T>(value: T | T[] | Record<string, T>): T | undefined;
+export declare function getFirst<T = undefined>(value?: T | readonly T[] | Record<PropertyKey, T>): T;
 
 /**
  * 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 / удалить скрипт после чтения
+ * Извлекает и парсит JSON-данные из тега скрипта в DOM.
+ * @param id script tag ID / идентификатор тега скрипта
+ * @param defaultValue default value if not found or invalid / значение по умолчанию при отсутствии или невалидности
+ * @param remove remove script element from DOM after reading / удалить ли элемент скрипта из DOM после чтения
  * @returns parsed data or default value / распарсенные данные или значение по умолчанию
  */
-export declare function getHydrationData<T>(id: string, defaultValue: T, remove?: boolean): T;
+export declare function getHydrationData<T>(id: string | number, defaultValue: T, remove?: boolean): T;
 
 /**
- * Returns the source string from an HTMLImageElement or string source.
+ * Returns the source string from an HTMLImageElement, object with src, or string source.
  *
- * Возвращает строку источника из HTMLImageElement или строкового источника.
- * @param image image element or string source / элемент изображения или строковый источник
+ * Возвращает строку источника из HTMLImageElement, объекта с src или строкового источника.
+ * @param image image element, object with src, or string source / элемент изображения, объект с src или строковый источник
  * @returns image source string / строка источника изображения
  */
-export declare function getImageSrc(image?: HTMLImageElement | string): string;
+export declare function getImageSrc(image?: HTMLImageElement | Record<string, unknown> | string | null): string;
 
 /**
  * Returns data by their path.
@@ -5852,7 +6389,7 @@ export declare function getKey(event: KeyboardEvent): string | number | undefine
  * @param value input value / входное значение
  * @returns last element of the array or object / последний элемент массива или объекта
  */
-export declare function getLast<T>(value: T | readonly T[] | Record<string, T>): T | undefined;
+export declare function getLast<T = undefined>(value?: T | readonly T[] | Record<PropertyKey, T>): T;
 
 /**
  * Returns the length or size of various data types including Arrays, Objects, Maps, Sets, and Strings.
@@ -5949,6 +6486,17 @@ export declare function getObjectNoUndefined<V>(data: readonly V[], exception?:
  */
 export declare function getObjectNoUndefined<T extends Record<PropertyKey, unknown>>(data: T, exception?: unknown): T;
 
+/**
+ * Creates an object without a prototype (Object.create(null)).
+ * Optionally copies properties from the provided data object into the new prototype-less object.
+ *
+ * Создает объект без прототипа (Object.create(null)).
+ * При необходимости копирует свойства из переданного объекта данных в новый объект без прототипа.
+ * @param data optional initial object data / необязательные начальные данные объекта
+ * @returns prototype-less object / объект без прототипа
+ */
+export declare function getObjectNull<T = unknown>(data?: Record<string, T>): Record<string, T>;
+
 /**
  * Returns the object if the object’s values are set.
  *
@@ -6011,11 +6559,11 @@ export declare function getRequestString(request: Record<string, unknown> | read
  * Строит регистро-независимое `RegExp` для поиска "содержит все слова".
  * Каждое слово из строки поиска экранируется и оборачивается в lookahead `(?=.*?слово)`,
  * поэтому результат совпадает только если строка содержит все слова (в любом порядке).
- * @param search search string with one or more space-separated words / строка поиска с одним или несколькими словами через пробел
+ * @param search search string with one or more space-separated words or query value / строка поиска с одним или несколькими словами через пробел или значение запроса
  * @param limit maximum search string length / максимальная длина строки поиска
  * @returns regular expression for multi-word search / регулярное выражение для поиска по всем словам
  */
-export declare function getSearchExp(search: string, limit?: number): RegExp;
+export declare function getSearchExp(search?: unknown, limit?: number): RegExp;
 
 /**
  * Creates a regular expression for a search by words (separating by space).
@@ -6023,11 +6571,11 @@ export declare function getSearchExp(search: string, limit?: number): RegExp;
  *
  * Создает регулярное выражение для поиска по словам (разделение пробелом).
  * Возвращает регистронезависимое и глобальное `RegExp` для строковых запросов или клонирует переданный `RegExp` с сохранением его шаблона и флагов.
- * @param search search string or RegExp / строка поиска или регулярное выражение
+ * @param search search string, RegExp, or query value / строка поиска, регулярное выражение или значение запроса
  * @param limit maximum search string length / максимальная длина строки поиска
  * @returns `RegExp` for search / регулярное выражение для поиска
  */
-export declare function getSeparatingSearchExp(search: string | RegExp, limit?: number): RegExp;
+export declare function getSeparatingSearchExp(search?: unknown, limit?: number): RegExp;
 
 /**
  * Returns the unit of measurement for 1 step
@@ -6236,7 +6784,16 @@ export declare class HashInstance extends UrlInstanceAbstract {
  * @param key property key / ключ свойства
  * @returns true if the object has the own property / true, если у объекта есть собственное свойство
  */
-export declare function hasKey<K extends PropertyKey, T extends object = Record<K, unknown>>(object: unknown, key: K): object is T & Record<K, unknown>;
+export declare function hasKey<K extends PropertyKey = PropertyKey, T extends object = Record<K, unknown>>(object: unknown, key: K): object is T & Record<K, unknown>;
+
+/**
+ * Checks if the object has any own properties.
+ *
+ * Проверяет, есть ли у объекта хотя бы одно собственное свойство.
+ * @param object object to check / объект для проверки
+ * @returns true if the object has own properties / true, если у объекта есть собственные свойства
+ */
+export declare function hasKeys<T extends object = Record<PropertyKey, unknown>>(object: unknown): object is T;
 
 /** Highlight match item type / Тип элемента подсветки совпадения */
 export declare type HighlightMatchItem = {
@@ -6450,7 +7007,7 @@ export declare function isApiSuccess<T>(data?: ApiData<T>): boolean;
  * Checks if the values are arrays.
  *
  * Проверяет, являются ли значения массивами.
- * @param value input value/ входное значение
+ * @param value input value / входное значение
  * @returns true if array / true, если массив
  */
 export declare function isArray<T = unknown>(value: unknown): value is T[];
@@ -6489,10 +7046,11 @@ export declare function isDomRuntime(): boolean;
  *
  * Проверяет, является ли элемент видимым (не скрыт через CSS и находится в DOM).
  * Элемент может находиться за пределами экрана и при этом считаться видимым.
- * @param elementSelectors selectors for matching or an Element / селекторы для сопоставления или Element
+ * @template E element or Window type / тип элемента или Window
+ * @param elementSelectors selectors for matching, an Element, or null / селекторы для сопоставления, Element или null
  * @returns true if the element is visible, otherwise false / true, если элемент является видимым, иначе false
  */
-export declare function isElementVisible<E extends ElementOrWindow>(elementSelectors?: ElementOrString<E>): boolean;
+export declare function isElementVisible<E extends ElementOrWindow = HTMLElement>(elementSelectors?: ElementOrString<E> | null): boolean;
 
 /**
  * Checks if the pressed key is Enter or Space (WAI-ARIA action key) outside of text inputs.
@@ -6512,7 +7070,7 @@ export declare function isEnter(event: KeyboardEvent, isInputElement?: boolean):
  * @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>;
+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.
@@ -6527,7 +7085,7 @@ export declare function isFloat(value: unknown): boolean;
  * Checks if the function is a callback function.
  *
  * Проверяет, является ли функция обратного вызова.
- * @param callback the value being checked/ проверяемое значение
+ * @param callback the value being checked / проверяемое значение
  * @returns true if function / true, если функция
  */
 export declare function isFunction<T>(callback: T): callback is Extract<T, FunctionAnyType>;
@@ -6574,31 +7132,31 @@ export declare function isMetaKey(event: KeyboardEvent): boolean;
  * Is the variable equal to null or undefined.
  *
  * Является ли переменная равной null или undefined.
- * @param value input value/ входное значение
+ * @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.
+ * Checks if the value is a number, numeric string, or bigint.
  *
- * Проверяет, является ли значение числом.
- * @param value values for checking / значения для проверки
- * @returns true if number / true, если число
+ * Проверяет, является ли значение числом, числовой строкой или bigint.
+ * @param value value to check / проверяемое значение
+ * @returns true if number, numeric string, or bigint / true, если число, числовая строка или bigint
  */
-export declare function isNumber(value: unknown): value is number | string;
+export declare function isNumber(value?: unknown): value is number | string | bigint;
 
 /**
  * Checks if a value is an object.
  *
  * Проверяет, является ли значение объектом.
- * @param value input value/ входное значение
- * @returns true if object/ true, если объект
+ * @param value input value / входное значение
+ * @returns true if object / true, если объект
  */
-export declare function isObject<T>(value: T): value is Extract<T, ObjectItem>;
+export declare function isObject<T = unknown>(value: unknown): value is ObjectItem<T>;
 
 /**
- * Checks if the value is an object or not an array.
+ * Checks if the value is an object and not an array.
  *
  * Проверяет, является ли значение объектом и не является массивом.
  * @param value input value / входное значение
@@ -6623,6 +7181,15 @@ export declare function isOnLine(): boolean;
  */
 export declare function isPrototypeKey(key: unknown): boolean;
 
+/**
+ * Checks if the value is a regular expression (including cross-realm instances).
+ *
+ * Проверяет, является ли значение регулярным выражением (включая межконтекстные экземпляры).
+ * @param value value to check / проверяемое значение
+ * @returns true if value is a regular expression / true, если значение является регулярным выражением
+ */
+export declare function isRegExp(value: unknown): value is RegExp;
+
 /**
  * Checks if a value is selected, comparing against a single target or an array of selected items.
  * Supports intelligent numeric equivalence for numbers and numeric strings.
@@ -6634,7 +7201,7 @@ export declare function isPrototypeKey(key: unknown): boolean;
  * @param selected target value or array of selected values / целевое значение или массив выбранных значений
  * @returns true if selected / true, если выбрано
  */
-export declare function isSelected<T>(value: T, selected?: unknown): boolean;
+export declare function isSelected<T = unknown>(value?: T, selected?: unknown): boolean;
 
 /**
  * Testing isSelected property for the entire list of values.
@@ -6658,10 +7225,10 @@ export declare function isShare(): boolean;
  * Checks if the value is of type string.
  *
  * Проверяет, является ли значение типом строки.
- * @param value input value/ входное значение
+ * @param value input value / входное значение
  * @returns true if string / true, если строка
  */
-export declare function isString(value: unknown): value is string;
+export declare function isString(value?: unknown): value is string;
 
 /**
  * Checks if the pressed key is Tab.
@@ -8356,12 +8923,12 @@ export declare class QueryInstance extends UrlInstanceAbstract {
 }
 
 /**
- * Generate a random integer.
+ * Generates a random integer within the specified range (inclusive).
  *
- * Генерирует случайное число.
- * @param min the lowest value to return/ наименьшее значение
- * @param max the highest value to return/ наибольшее значение
- * @returns random number/ случайное число
+ * Генерирует случайное целое число в указанном диапазоне (включительно).
+ * @param min the lowest value to return / наименьшее возвращаемое значение
+ * @param max the highest value to return / наибольшее возвращаемое значение
+ * @returns random integer within [min, max] / случайное целое число в диапазоне [min, max]
  */
 export declare function random(min: number, max: number): number;
 
@@ -8376,6 +8943,53 @@ export declare function random(min: number, max: number): number;
  */
 export declare function removeCommonPrefix(mainString: string, prefix: string, trim?: boolean): string;
 
+/**
+ * Removes all HTML/XML tags or specified tags from a string.
+ *
+ * Удаляет все HTML/XML теги или указанные теги из строки.
+ * @param value initial string / исходная строка
+ * @param options configuration options / объект опций
+ * @returns cleaned string without tags / очищенная строка без тегов
+ *
+ * @remarks
+ * When `removeContent` is true (or a list of tags is provided),
+ * executable and styling tags (`<script>`, `<style>`, `<noscript>`) or specified content tags
+ * are silently removed along with their inner content without applying `replacement`.
+ * Other formatting and layout tags preserve their text content, and their tag syntax
+ * is replaced with `replacement`.
+ *
+ * Если `removeContent = true` (или передан список тегов),
+ * исполняемые теги и стили (`<script>`, `<style>`, `<noscript>`) или указанные теги
+ * удаляются молча вместе со своим содержимым без подстановки `replacement`.
+ * Остальные теги форматирования и разметки сохраняют текстовое содержимое, а синтаксис
+ * их тегов заменяется на `replacement`.
+ *
+ * @example
+ * ```ts
+ * removeTag('<p>Hello <b>world</b>!</p>') // => 'Hello world!'
+ * removeTag('<b>Hello</b> <p>world</p>', { tag: 'b' }) // => 'Hello <p>world</p>'
+ * removeTag('<b>Hello</b> <p>world</p>', { tag: ['b', 'p'] }) // => 'Hello world'
+ * removeTag('<p>Hello</p><p>world</p>', { replacement: ' ' }) // => ' Hello  world '
+ * removeTag('<p>Hello</p><script>alert(1)</script>') // => 'Hello'
+ * removeTag('<p>Hello</p><script>alert(1)</script>', { removeContent: false }) // => 'Helloalert(1)'
+ * removeTag('<div>Text</div><script>alert(1)</script>', { tag: 'script', removeContent: false }) // => '<div>Text</div>alert(1)'
+ * ```
+ */
+export declare function removeTag(value?: string | number | null, options?: RemoveTagOptions): string;
+
+/**
+ * Options for configuring tag removal in removeTag /
+ * Опции для настройки удаления тегов в removeTag
+ */
+export declare interface RemoveTagOptions {
+    /** Tag or list of tags to remove (if omitted, removes all tags) / Тег или список тегов для удаления (если опущен, удаляет все теги) */
+    tag?: string | string[];
+    /** String to replace tags with (not applied to silently removed content blocks) / Строка для замены тегов (не применяется к молча удаляемым блокам содержимого) */
+    replacement?: string;
+    /** Whether to remove content of script, style, and noscript tags, or list of tags / Нужно ли удалять содержимое тегов script, style и noscript, или список тегов */
+    removeContent?: boolean | string | string[];
+}
+
 /**
  * Replaces the component name in the text.
  *
@@ -8388,15 +9002,19 @@ export declare function removeCommonPrefix(mainString: string, prefix: string, t
 export declare function replaceComponentName(text: string | undefined, name: string, componentName: string): string | undefined;
 
 /**
- * Merge one or more arrays or objects recursively.
+ * Recursively merges a target object with elements from a replacement object or array without mutating the source data.
  *
- * Рекурсивное слияние одного или более массивов или объектов.
- * @param target the object in which elements are replaced / объект, элементы которого будут заменены
- * @param replacement object or array from which elements will be extracted / объект или массив, из которого будут браться элементы для замены
- * @param isMerge merge arrays or overwrite them / сливать массивы или перезаписывать их
- * @returns merged object / объединенный объект
+ * Рекурсивно объединяет целевой объект с элементами из объекта или массива замены без мутации исходных данных.
+ * @template [I=unknown] item value type / тип значения элементов
+ * @param target the object in which elements are replaced / целевой объект, элементы которого будут заменены
+ * @param replacement object or array from which elements will be extracted / объект или массив, из которого извлекаются элементы для замены
+ * @param [isMerge=true] merge arrays without duplicates or overwrite them / объединять массивы без дубликатов или перезаписывать их
+ * @param [disableCopy=false] disables deep cloning of target (used internally during recursion or for mutable accumulators) / запрещает глубокое копирование target (используется внутри рекурсии или для мутабельных аккумуляторов)
+ * @returns new merged object / новый объединенный объект
+ * @warning This method is intended exclusively for processing plain JSON-like objects and arrays (such as data received via API or configurations); built-in class instances (`Date`, `RegExp`, `Map`, `Set`) and functions are not supported. /
+ * Этот метод предназначен исключительно для обработки простых JSON-подобных объектов и массивов (таких как данные, полученные через API или файлы конфигураций); экземпляры встроенных классов (`Date`, `RegExp`, `Map`, `Set`) и функции не поддерживаются.
  */
-export declare function replaceRecursive<I>(target: ObjectItem<I>, replacement?: ObjectOrArray<I>, isMerge?: boolean): ObjectItem<I>;
+export declare function replaceRecursive<I = unknown>(target?: ObjectItem<I> | null, replacement?: ObjectOrArray<I> | readonly I[] | null, isMerge?: boolean, disableCopy?: boolean): ObjectItem<I>;
 
 /**
  * A simplified template replacement function for substituting values or function results into `[key]` placeholders.
@@ -8461,11 +9079,7 @@ export declare function resizeImage(image: HTMLImageElement | string, maxSize?:
  */
 export declare function resizeImageByMax(image: HTMLImageElement | string, maxSize: number, type?: ResizeImageByMaxType, typeData?: string, quality?: number): string | undefined;
 
-/**
- * Resize type for image scaling.
- *
- * Тип изменения размера для масштабирования изображения.
- */
+/** Resize type for image scaling / Тип изменения размера для масштабирования изображения */
 export declare type ResizeImageByMaxType = 'auto' | 'width' | 'height';
 
 /**
@@ -8563,6 +9177,17 @@ export declare class ResumableTimer {
     protected stop(): this;
 }
 
+/**
+ * Validates and normalizes an external locale code string.
+ * Ensures URL safety and ECMA-402 BCP-47 compatibility.
+ *
+ * Валидирует и нормализует внешнюю строку кода локали.
+ * Обеспечивает безопасность для URL и совместимость со стандартом ECMA-402 BCP-47.
+ * @param code candidate locale code / проверяемый код локали
+ * @returns valid locale code or undefined / валидный код локали или undefined
+ */
+export declare function sanitizeLocation(code?: unknown): string | undefined;
+
 /**
  * Class for getting the scroll width.
  *
@@ -9149,34 +9774,34 @@ export declare class ServerStorage {
     /** Flag to hide missing storage error / Флаг скрытия ошибки отсутствия хранилища */
     protected static hideError?: boolean;
     /**
-     * Retrieves a value from storage. If it doesn't exist, creates it using the default value factory.
+     * Checks if a value exists in storage.
      *
-     * Извлекает значение из хранилища. Если оно не существует, создает его с помощью фабрики значений по умолчанию.
+     * Проверяет наличие значения в хранилище.
      * @param key unique storage key / уникальный ключ хранилища
-     * @param defaultValue function that returns the default value if not found / функция, возвращающая значение по умолчанию, если оно не найдено
+     * @returns true if key exists, false otherwise / true, если ключ существует, иначе false
+     */
+    static has(key: string): boolean;
+    /**
+     * Retrieves a value from storage. If it doesn't exist, creates it using the default value factory or value.
+     *
+     * Извлекает значение из хранилища. Если оно не существует, создает его с помощью фабрики значений по умолчанию или значения.
+     * @param key unique storage key / уникальный ключ хранилища
+     * @param defaultValue default value or 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 = unknown>(key: string, defaultValue?: () => T, hydration?: boolean): T;
+    static get<T = unknown>(key: string, defaultValue?: (() => T) | T, hydration?: boolean): T;
     /**
      * Saves a value to storage.
      *
      * Сохраняет значение в хранилище.
      * @param key unique storage key / уникальный ключ хранилища
-     * @param value function that returns the value to save / функция, возвращающая значение для сохранения
+     * @param value value or 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 = unknown>(key: string, value: () => T, hydration?: boolean, storageList?: ServerStorageList): T;
-    /**
-     * Checks if a value exists in storage.
-     *
-     * Проверяет наличие значения в хранилище.
-     * @param key unique storage key / уникальный ключ хранилища
-     * @returns boolean / логическое значение
-     */
-    static has(key: string): boolean;
+    static set<T = unknown>(key: string, value: (() => T) | T, hydration?: boolean, storageList?: ServerStorageList): T;
     /**
      * Sets the visibility of error messages.
      *
@@ -9202,7 +9827,7 @@ export declare class ServerStorage {
      *
      * Инициализирует хранилище слушателем контекста.
      * @param listener function that returns the current request context / функция, возвращающая контекст текущего запроса
-     * @returns this instance / текущий класс
+     * @returns ServerStorage class / класс ServerStorage
      */
     static init(listener: () => Record<string, unknown> | undefined): typeof ServerStorage;
     /**
@@ -9238,24 +9863,63 @@ export declare class ServerStorage {
 }
 
 /** Item stored in the server storage / Элемент, хранящийся в серверном хранилище */
-declare type ServerStorageItem = {
+export declare type ServerStorageItem = {
+    /** Stored value / Сохраненное значение */
     value: unknown;
+    /** Whether the value is included in client hydration / Включено ли значение в клиентскую гидратацию */
     hydration: boolean;
 };
 
 /** Map of server storage items / Карта элементов серверного хранилища */
-declare type ServerStorageList = Record<string, ServerStorageItem>;
+export declare type ServerStorageList = Record<string, ServerStorageItem>;
 
 /**
  * Modifies the value of an element identified by its key.
  *
  * Изменяет значение элемента, определенного ключом.
- * @param element checked element / проверяемый элемент
+ * @template E element or Window type / тип элемента или Window
+ * @template K property key type / тип ключа свойства
+ * @template V value type / тип значения
+ * @param element target element or selector / целевой элемент или селектор
  * @param index property name, attribute, or style key / имя свойства, атрибута или ключа стилей
  * @param value new value / новое значение
- * @returns modified element / измененный элемент
+ * @returns true if the item was modified, false otherwise / true, если элемент был изменен, иначе false
+ */
+export declare function setElementItem<E extends ElementOrWindow = HTMLElement, K extends keyof E = keyof E, V extends E[K] = E[K]>(element?: ElementOrString<E> | null, index?: K | string, value?: V | Record<string, V> | unknown): boolean;
+
+/**
+ * Sets or removes an HTML or ARIA attribute on an element.
+ *
+ * Устанавливает или удаляет HTML- или ARIA-атрибут на элементе.
+ * @param element target element or selector / целевой элемент или селектор
+ * @param attribute attribute name / имя атрибута
+ * @param value attribute value or factory function / значение атрибута или функция-фабрика
+ * @returns true if the attribute was processed, false otherwise / true, если атрибут был обработан, иначе false
+ */
+export declare function setElementItemAttribute<E extends ElementOrWindow = HTMLElement>(element?: ElementOrString<E> | null, attribute?: string, value?: unknown): boolean;
+
+/**
+ * Sets a property or merges nested object properties on an element with prototype pollution protection.
+ *
+ * Устанавливает свойство или объединяет свойства вложенного объекта на элементе с защитой от загрязнения прототипа.
+ * @template E element or Window type / тип элемента или Window
+ * @param element target element or selector / целевой элемент или селектор
+ * @param index property name or symbol / имя свойства или символ
+ * @param value property value or factory function / значение свойства или функция-фабрика
+ * @returns true if property was set, false otherwise / true, если свойство было установлено, иначе false
+ */
+export declare function setElementItemProperty<E extends ElementOrWindow = HTMLElement>(element?: ElementOrString<E> | null, index?: PropertyKey, value?: unknown): boolean;
+
+/**
+ * Sets style properties, CSS custom properties, or cssText on an element.
+ *
+ * Устанавливает свойства стиля, переменные CSS или cssText на элементе.
+ * @template E element or Window type / тип элемента или Window
+ * @param element target element, selector, or null / целевой элемент, селектор или null
+ * @param styles style string, styles object, or factory function / строка стилей, объект стилей или функция-фабрика
+ * @returns true if styles were applied, false otherwise / true, если стили были применены, иначе false
  */
-export declare function setElementItem<E extends ElementOrWindow, K extends keyof E = keyof E, V extends E[K] = E[K]>(element: ElementOrString<E>, index: K | string, value: V | Record<string, V> | unknown): E | undefined;
+export declare function setElementItemStyle<E extends ElementOrWindow = HTMLElement>(element?: ElementOrString<E> | null, styles?: unknown): boolean;
 
 /**
  * Modifies data according to its type and settings.
@@ -9340,17 +10004,20 @@ export declare type SortFunction<T = Record<string, unknown>> = (a: T, b: T, col
 export declare function sortList<T = Record<string, unknown>>(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.
+ * Copies and recursively merges own enumerable properties from a replacement object into a target object,
+ * optionally replacing a specific entry matched by key or value (`indexStart`) in place while preserving key order and cascade priority.
  *
- * Метод используется для копирования значений всех перечисляемых свойств одного объекта в другой.
- * В приоритете по списку обработки.
- * @param array the target object / целевой объект
- * @param replacement the source object / исходные объекты
- * @param indexStart index at which to start changing the array / индекс, по которому начинает изменять массив
- * @returns modified array / измененный массив
+ * Копирует и рекурсивно объединяет собственные перечисляемые свойства из объекта замены в целевой объект,
+ * опционально заменяя найденную по ключу или значению запись (`indexStart`) на месте с сохранением порядка ключей и приоритета по списку обработки.
+ * @template [I=unknown] item value type / тип значения элементов
+ * @param array target object / целевой объект
+ * @param replacement source object with replacement properties / исходный объект с новыми свойствами
+ * @param indexStart property key or value at which to inject replacement / ключ или значение свойства, начиная с которого выполняется замена
+ * @returns new merged object / новый объединенный объект
+ * @warning This method is intended exclusively for processing plain JSON-like objects (such as data received via API or configurations); built-in class instances (`Date`, `RegExp`, `Map`, `Set`) and functions are not supported. /
+ * Этот метод предназначен исключительно для обработки простых JSON-подобных объектов (таких как данные, полученные через API или файлы конфигураций); экземпляры встроенных классов (`Date`, `RegExp`, `Map`, `Set`) и функции не поддерживаются.
  */
-export declare function splice<I>(array: ObjectItem<I>, replacement?: ObjectItem<I> | I, indexStart?: string): ObjectItem<I>;
+export declare function splice<I = unknown>(array?: ObjectItem<I> | null, replacement?: ObjectItem<I> | I | null, indexStart?: string | null): ObjectItem<I>;
 
 /**
  * A class for working with callback lists for storage.
@@ -9493,6 +10160,20 @@ export declare function toCamelCase(value?: string): string;
  */
 export declare function toCamelCaseFirst(value?: string): string;
 
+/**
+ * Extracts and validates a country code from a location or country string via GeoList.
+ * Supports BCP-47 subtags (e.g., 'zh-Hans-CN'), case-insensitive tags ('en-gb'),
+ * reversed tags ('RU-ru'), underscore separators ('en_US'), and alternative country codes ('UK', 'BY_BY').
+ *
+ * Извлекает и валидирует код страны из строки локации или страны через GeoList.
+ * Поддерживает BCP-47 субтеги (например, 'zh-Hans-CN'), регистронезависимые теги ('en-gb'),
+ * обратные теги ('RU-ru'), разделители подчеркивания ('en_US') и альтернативные коды стран ('UK', 'BY_BY').
+ * @param code candidate location or country string / строка локации или код страны
+ * @param raw whether to skip GeoList lookup and return raw extracted code / пропускать ли проверку в GeoList и возвращать сырой извлеченный код
+ * @returns 2-letter country code or empty string / двухбуквенный код страны или пустая строка
+ */
+export declare function toCountry(code?: unknown, raw?: boolean): string;
+
 /**
  * Conversion to Date object.
  *
@@ -9502,6 +10183,36 @@ export declare function toCamelCaseFirst(value?: string): string;
  */
 export declare function toDate<T extends Date | number | string>(value?: T): (T & Date) | Date;
 
+/**
+ * Finds geographical country and locale data by a language-country code, country code, or language code.
+ *
+ * Находит географические данные страны и локали по коду язык-страна, коду страны или коду языка.
+ * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
+ * @returns geo item or undefined / гео-объект или undefined
+ */
+export declare function toGeoItem(code?: unknown): GeoItem | undefined;
+
+/**
+ * Transforms a basic geo item into a full geo item with resolved location data and defaults.
+ *
+ * Преобразует базовый гео-объект в полный гео-объект с разрешенными данными локации и значениями по умолчанию.
+ * @param item basic geo item / базовый гео-объект
+ * @param code country code, full form language-country or one of them / код страны, полный вид язык-страна или один из них
+ * @returns full geo item data / полные данные гео-объекта
+ */
+export declare function toGeoItemFull(item: GeoItem, code?: string): GeoItemFull;
+
+/**
+ * Converts a geo item to its standard string representation (language-country).
+ *
+ * Преобразует гео-объект в его стандартное строковое представление (язык-страна).
+ * @param item geo item data / данные гео-объекта
+ * @param language optional language override / опциональное переопределение языка
+ * @param raw whether to skip language processing / не обрабатывать ли язык
+ * @returns standard code string or empty string / строка стандартного кода или пустая строка
+ */
+export declare function toGeoStandard(item?: GeoItem, language?: string, raw?: boolean): string;
+
 /**
  * Converts a string to kebab-case format.
  * It converts uppercase letters to lowercase, replaces spaces and other characters with dashes.
@@ -9514,11 +10225,36 @@ export declare function toDate<T extends Date | number | string>(value?: T): (T
 export declare function toKebabCase(value?: string): string;
 
 /**
- * Converts a string or number to a finite floating-point number.
+ * Extracts and validates a language code from a location or language string via GeoList.
+ * Supports BCP-47 subtags (e.g., 'zh-Hans-CN'), case-insensitive tags ('ru-ru', 'EN-GB'),
+ * 3-letter ISO 639-3 codes ('cmn-SG'), reversed tags ('RU-ru'), and alternative language codes ('ua', 'cz').
+ *
+ * Извлекает и валидирует код языка из строки локации или языка через GeoList.
+ * Поддерживает BCP-47 субтеги (например, 'zh-Hans-CN'), регистронезависимые теги ('ru-ru', 'EN-GB'),
+ * трехбуквенные коды ISO 639-3 ('cmn-SG'), обратные теги ('RU-ru') и альтернативные коды языков ('ua', 'cz').
+ * @param code candidate location or language string / строка локации или код языка
+ * @param raw whether to skip GeoList lookup and return raw extracted code / пропускать ли проверку в GeoList и возвращать сырой извлеченный код
+ * @returns canonical language code or empty string / канонический код языка или пустая строка
+ */
+export declare function toLanguage(code?: unknown, raw?: boolean): string;
+
+/**
+ * Converts a full locale string into a canonical standard locale (aa-AA) format.
+ * Returns an empty string if the input is not a full locale format (missing country or language).
+ *
+ * Преобразует полную строку локали в канонический формат локали (aa-AA).
+ * Возвращает пустую строку, если формат не полный (отсутствует страна или язык).
+ * @param code candidate locale string / строка локали
+ * @returns canonical locale code in 'aa-AA' format or empty string / канонический код локали в формате 'aa-AA' или пустая строка
+ */
+export declare function toLocale(code?: unknown): string;
+
+/**
+ * Converts a value 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) средах.
  *
@@ -9530,7 +10266,7 @@ export declare function toKebabCase(value?: string): string;
  * toNumber("1,234.56") // 1234.56
  * toNumber("1,234")    // 1.234
  */
-export declare function toNumber(value?: NumberOrString): number;
+export declare function toNumber(value?: unknown): number;
 
 /**
  * Converts the data into a number, taking into account the maximum permissible value.
@@ -9615,7 +10351,7 @@ export { toString_2 as toString }
  * transformation('{"a":1}') // { a: 1 }
  * transformation('null') // null
  */
-export declare function transformation<T = unknown>(value: unknown, isFunctionCheck?: boolean): T;
+export declare function transformation<T = unknown>(value?: unknown, isFunctionCheck?: boolean): T;
 
 /**
  * Class for getting the translated text.
@@ -9745,6 +10481,20 @@ export declare const TRANSLATE_GLOBAL_PREFIX = "global";
  */
 export declare const TRANSLATE_TIME_OUT = 160;
 
+/** Translation batch bound to its original locale / Партия переводов, привязанная к исходной локали */
+export declare interface TranslateBatch {
+    /** Requested location / Запрошенный регион */
+    readonly location: string;
+    /** Requested language / Запрошенный язык */
+    readonly language: string;
+    /** API path resolved when queued / API-путь, вычисленный при добавлении в очередь */
+    readonly path: string;
+    /** Unique requested codes / Уникальные запрошенные коды */
+    readonly codes: string[];
+    /** Callbacks waiting for this batch / Колбэки, ожидающие завершения партии */
+    readonly resolves: (() => void)[];
+}
+
 /**
  * Translation code or a list of translation codes for template replacement/
  * Код перевода или список кодов для замены шаблона
@@ -9783,33 +10533,41 @@ export declare type TranslateDataFileItem = () => Promise<TranslateDataFileList>
 export declare type TranslateDataFileList = Record<string, string>;
 
 /**
- * Class for working with translation files.
+ * Class for managing and loading translation files with hierarchical locale resolution and caching.
+ * Resolves translation files using the fallback chain: location -> language -> global prefix.
  *
- * Класс для работы с файлами перевода.
+ * Класс для управления и загрузки файлов перевода с иерархическим разрешением локалей и кэшированием.
+ * Разрешает файлы перевода по цепочке отката: регион (location) -> язык (language) -> глобальный префикс (global).
  */
 export declare class TranslateFile {
-    protected language: string | (() => string);
     protected location: string | (() => string);
+    protected language: string | (() => string);
     /** List of files with translations / Список файлов с переводами */
     protected files: TranslateDataFile;
     /** Data from files / Данные из файлов */
     protected data: Record<string, TranslateDataFileList>;
+    /** Active loading promises for deduplication / Активные промисы загрузки для дедупликации */
+    protected promises: Record<string, TranslatePromiseItem>;
+    /** Counter for generating unique request identifiers / Счетчик для генерации уникальных идентификаторов запросов */
+    protected id: number;
     /**
      * Creates an instance of the class.
      *
      * Создает экземпляр класса.
      * @param data list of files / список файлов
-     * @param language language / язык
      * @param location location / местоположение
+     * @param language language / язык
      */
-    constructor(data?: TranslateDataFile, language?: string | (() => string), location?: string | (() => string));
+    constructor(data?: TranslateDataFile, location?: string | (() => string), language?: string | (() => string));
     /**
-     * Checks if there are files for the current location or language.
+     * Checks if there are files for the specified location or language.
      *
-     * Проверяет, есть ли файлы для текущего местоположения или языка.
-     * @returns boolean / логическое значение
+     * Проверяет, есть ли файлы для указанного местоположения или языка.
+     * @param location location, current by default / регион, по умолчанию текущий
+     * @param language language, current by default / язык, по умолчанию текущий
+     * @returns true if matching file exists / true, если подходящий файл существует
      */
-    isFile(): boolean;
+    isFile(location?: string, language?: string): boolean;
     /**
      * Returns the language.
      *
@@ -9825,19 +10583,28 @@ export declare class TranslateFile {
      */
     getLocation(): string;
     /**
-     * Returns a list of translations from the file for the current location.
+     * Returns translations for a fixed location and language, preserving them across asynchronous loading.
      *
-     * Возвращает список переводов из файла для текущего местоположения.
+     * Возвращает переводы для заданных региона и языка, сохраняя их при асинхронной загрузке.
+     * @param location location, current by default / регион, по умолчанию текущий
+     * @param language language, current by default / язык, по умолчанию текущий
      * @returns promise with list of translations / промис со списком переводов
      */
-    getList(): Promise<TranslateDataFileList | undefined>;
+    getList(location?: string, language?: string): Promise<TranslateDataFileList | undefined>;
     /**
-     * Adds a list of files with translations.
+     * Adds a list of files with translations and clears stale cache for updated keys.
      *
-     * Добавляет список файлов с переводами.
+     * Добавляет список файлов с переводами и очищает устаревший кэш для обновляемых ключей.
      * @param data list of files / список файлов
      */
     add(data: TranslateDataFile): void;
+    /**
+     * Resets the cache of loaded translation data and active promises.
+     *
+     * Сбрасывает кэш загруженных данных переводов и активные промисы.
+     * @returns current instance / текущий экземпляр
+     */
+    reset(): this;
     /**
      * Returns a list of translations from the cache.
      *
@@ -9847,26 +10614,30 @@ export declare class TranslateFile {
      */
     protected getByData(index: string): TranslateDataFileList | undefined;
     /**
-     * Returns a list of translations from the file and caches the result.
+     * Returns a list of translations from the file, deduplicating concurrent loads and caching the result.
      *
-     * Возвращает список переводов из файла и кэширует результат.
+     * Возвращает список переводов из файла, дедуплицируя параллельные загрузки и кэшируя результат.
      * @param index file key / ключ файла
      * @returns promise with list of translations or undefined / промис со списком переводов или undefined
      */
     protected getByFile(index: string): Promise<TranslateDataFileList | undefined>;
     /**
-     * Returns the key for the current location from the list of files.
+     * Returns the file key for the specified location and language.
      *
-     * Возвращает ключ для текущего местоположения из списка файлов.
+     * Возвращает ключ файла для указанных региона и языка.
+     * @param location location, current by default / регион, по умолчанию текущий
+     * @param language language, current by default / язык, по умолчанию текущий
      * @returns file key or undefined / ключ файла или undefined
      */
-    protected getIndex(): string | undefined;
+    protected getIndex(location?: string, language?: string): string | undefined;
 }
 
 /**
  * Class for getting the translated text.
+ * Queued requests and their cache writes retain the language and location of the original call.
  *
  * Класс для получения переведенного текста.
+ * Запросы в очереди и запись их результатов в кеш сохраняют язык и регион исходного вызова.
  */
 export declare class TranslateInstance {
     protected url: string;
@@ -9874,10 +10645,8 @@ export declare class TranslateInstance {
     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)[];
+    /** Pending batches grouped by language and location / Ожидающие партии, сгруппированные по языку и региону */
+    protected batches: TranslateBatch[];
     /** Timeout for getting translations / Таймаут для получения переводов */
     protected timeout?: ReturnType<typeof setTimeout>;
     /** Flag indicating whether to read from the API / Флаг, указывающий, нужно ли читать из API */
@@ -9998,25 +10767,29 @@ export declare class TranslateInstance {
      *
      * Получает текст перевода по коду, возвращая первое совпадение из запасных вариантов.
      * @param name code name / название кода
+     * @param location requested location / запрошенный регион
+     * @param language requested language / запрошенный язык
      * @returns translation text or undefined / текст перевода или undefined
      */
-    protected getText(name: string): string | undefined;
+    protected getText(name: string, location?: string, language?: string): string | undefined;
     /**
      * Getting the full title for translation.
      *
      * Получение полного названия для перевода.
      * @param name code name / название кода
+     * @param location requested location / запрошенный регион
      * @returns full title / полное название
      */
-    protected getName(name: string): string;
+    protected getName(name: string, location?: string): string;
     /**
      * Getting the title for translation by language.
      *
      * Получение названия для перевода по языку.
      * @param name code name / название кода
+     * @param language requested language / запрошенный язык
      * @returns title by language / название по языку
      */
-    protected getNameByLanguage(name: string): string;
+    protected getNameByLanguage(name: string, language?: string): string;
     /**
      * Getting the title for translation globally.
      *
@@ -10037,9 +10810,11 @@ export declare class TranslateInstance {
      * Getting the list of translations from the server.
      *
      * Получение списка переводов с сервера.
+     * @param cache list of requested codes / список запрошенных кодов
+     * @param path API path resolved for the original locale / API-путь, вычисленный для исходной локали
      * @returns promise with record of translations / промис с записью переводов
      */
-    protected getResponse(cache?: string[]): Promise<Record<string, string>>;
+    protected getResponse(cache: string[], path: string): Promise<Record<string, string>>;
     /**
      * Replaces the text with the specified values.
      *
@@ -10054,17 +10829,21 @@ export declare class TranslateInstance {
      *
      * Добавление данных по переводу с сервера.
      * @param cache list of codes to fetch / список кодов для загрузки
+     * @param location original batch location / исходный регион партии
+     * @param language original batch language / исходный язык партии
+     * @param path API path resolved for the original locale / API-путь, вычисленный для исходной локали
      * @returns promise / промис
      */
-    protected make(cache?: string[]): Promise<void>;
+    protected make(cache: string[], location: string, language: string, path: string): Promise<void>;
     /**
      * Adding translation data from the list.
      *
      * Добавление данных по переводу из списка.
      * @param list list of translations / список переводов
      * @param cache list of requested codes / список запрошенных кодов
+     * @param location original batch location / исходный регион партии
      */
-    protected makeList(list: Record<string, string>, cache?: string[]): void;
+    protected makeList(list: Record<string, string>, cache: string[], location: string): void;
 }
 
 /**
@@ -10081,6 +10860,17 @@ export declare type TranslateList<T extends TranslateCode[]> = {
     [K in T[number] as K extends readonly string[] ? K[0] : K]: string;
 };
 
+/**
+ * Item for tracking active translation loading promises /
+ * Элемент для отслеживания активных промисов загрузки переводов
+ */
+export declare type TranslatePromiseItem = {
+    /** Unique request identifier / Уникальный идентификатор запроса */
+    id: number;
+    /** Loading promise / Промис загрузки */
+    promise: Promise<TranslateDataFileList | undefined>;
+};
+
 /**
  * Cookie key for storing the geo code /
  * Ключ куки для хранения кода гео
@@ -10108,10 +10898,11 @@ export declare type Undefined = undefined | null;
  * Removes duplicate entries in an array.
  *
  * Удаляет повторяющиеся записи в массиве.
- * @param value input value/ входное значение
+ * @template [T=unknown] element type / тип элементов массива
+ * @param value input array / входной массив
  * @returns array without duplicates / массив без дубликатов
  */
-export declare function uniqueArray<T>(value: T[]): T[];
+export declare function uniqueArray<T = unknown>(value?: readonly T[] | null): T[];
 
 /**
  * Base abstract class for working with URL-based states (Hash, Query).