@dxtmisha/wiki 0.39.7 → 0.56.0

package/src/media/functional/functional-basic/classes/GeoPhone/GeoPhone.ru.mdx

@@ -4,136 +4,87 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс GeoPhone
 
-Специализированный класс для хранения и обработки масок международных телефонных номеров. Обеспечивает мощный механизм идентификации географической информации о стране по строке номера, форматирование необработанных чисел в локализованные маски и управление комплексной картой телефонных кодов на базе префиксного дерева.
-
-Класс тесно интегрирован с гео-данными `Geo`, что позволяет автоматически определять маску на основе текущей локали пользователя или переданных кодов стран.
+Специализированный класс для хранения и обработки масок международных телефонных номеров. Обеспечивает механизм идентификации страны по строке номера, форматирование необработанных чисел в локализованные маски и управление комплексной картой телефонных кодов на базе префиксного дерева. Класс тесно интегрирован с гео-данными `Geo`, что позволяет автоматически определять маску на основе текущей локали пользователя или переданных кодов стран.
 
 ## Ключевые особенности
 
 - **Автоматическое сопоставление** — динамически определяет подходящую страну и паттерн маски через рекурсивный поиск по префиксному дереву.
-- **Оптимизация дерева префиксов** — использует специализированную структуру `map` (Trie/Prefix Tree) для высокопроизводительного поиска по международным планам нумерации.
-- **Интеллектуальная нормализация** — автоматически обрабатывает региональные вариации набора, такие как ведущие нули или национальные префиксы (например, российская «8»).
-- **Стандартизированное форматирование** — преобразует сырые числовые строки в читаемые форматы, соответствующие международным стандартам телефонии.
-
-## Методы поиска
-
-### `getByPhone`
-
-Основной метод идентификации, который анализирует строку номера телефона для извлечения географической информации и наиболее подходящей маски нумерации.
+- **Оптимизация дерева префиксов** — использует специализированную структуру `map` (Trie) для высокопроизводительного поиска.
+- **Интеллектуальная нормализация** — автоматически обрабатывает региональные вариации набора, такие как ведущие нули или национальные префиксы.
+- **Стандартизированное форматирование** — преобразует сырые числовые строки в читаемые форматы.
 
-**Параметры:**
-- `phone: string` — целевой номер телефона для анализа (принимает как сырые, так и частично отформатированные строки).
+## Базовое использование
 
-**Возвращает:** `GeoPhoneMapInfo` — структурированный объект, содержащий найденный элемент `GeoPhoneMap` и нормализованную числовую часть номера.
+Вы можете использовать статические методы класса для быстрой идентификации страны по номеру телефона или форматирования.
 
 ```javascript
 import { GeoPhone } from '@dxtmisha/functional-basic'
 
+// Идентификация страны по номеру
 const info = GeoPhone.getByPhone('79001234567')
-// возвращает:
-// { 
-//   item: { info: { phone: 7, ... }, mask: ['7 (***) ***-**-**'], ... },
-//   phone: '9001234567' 
-// }
-```
-
-### `get`
-
-Извлекает локализованные метаданные телефона, связанные с конкретным кодом страны.
-
-**Параметры:**
-- `code: string` — стандартный код страны ISO 3166 (например, `'RU'`, `'US'`, `'VN'`).
+console.log(info.item?.value) // 'RU'
 
-**Возвращает:** `GeoPhoneValue | undefined` — сырые метаданные для страны или `undefined`, если код не найден в базе.
-
-```javascript
-GeoPhone.get('RU') 
-// { phone: 7, within: 8, mask: ['* (***) ***-**-**'], value: 'RU' }
+// Форматирование по маске
+const formatted = GeoPhone.toMask('9001234567', ['+* (***) ***-**-**'])
+console.log(formatted) // '+7 (900) 123-45-67'
 ```
 
-### `getByCode`
-
-Расширенный метод получения данных, который возвращает полную информацию о маске, включая узел дерева поиска для заданного кода страны.
-
-**Параметры:**
-- `code: string` — строка целевого кода страны.
-
-**Возвращает:** `GeoPhoneMap | undefined` — объект узла карты для запрошенного кода.
-
-```javascript
-GeoPhone.getByCode('US')
-// { info: { phone: 1, ... }, mask: ['1 (***) ***-****'], ... }
-```
+## Методы
 
-## Методы доступа к данным
+### Информация
 
-- `getList(): GeoPhoneValue[]` — возвращает полный отсортированный плоский список всех зарегистрированных метаданных международных телефонов.
-- `getMap(): Record<string, GeoPhoneMap>` — возвращает корневой узел внутреннего префиксного дерева, используемого для высокоскоростной идентификации номеров.
+- `getList(): GeoPhoneValue[]` — Возвращает полный отсортированный плоский список всех зарегистрированных метаданных международных телефонов.
+- `getMap(): Record<string, GeoPhoneMap>` — Возвращает корневой узел внутреннего префиксного дерева для поиска.
 
-## Форматирование и утилиты
+### Выбор
 
-### `toMask`
+- `get(code: string): GeoPhoneValue | undefined` — Извлекает метаданные телефона, связанные с конкретным кодом страны.
+- `getByPhone(phone: string): GeoPhoneMapInfo` — Анализирует строку номера телефона для извлечения информации и подходящей маски.
+- `getByCode(code: string): GeoPhoneMap | undefined` — Возвращает полную информацию о маске, включая узел дерева поиска для заданного кода.
 
-Преобразует сырую числовую строку телефона в отформатированную версию на основе заданного набора масок.
+### Вспомогательные методы
 
-**Параметры:**
-- `phone: string` — необработанный числовой ввод.
-- `masks?: string[]` — массив строк допустимых масок для сопоставления.
+- `toMask(phone: string, masks?: string[]): string | undefined` — Преобразует сырую числовую строку телефона в отформатированную версию.
+- `removeZero(phone: string): string` — Стандартизирует внутреннее представление номера, удаляя ведущие нули или корректируя региональные префиксы.
 
-**Возвращает:** `string | undefined` — отформатированная строка или `undefined`, если длина ввода не соответствует ни одной маске.
-
-```javascript
-GeoPhone.toMask('9001234567', ['* (***) ***-**-**']) 
-// '7 (900) 123-45-67'
-```
-
-### `removeZero`
-
-Стандартизирует внутреннее представление номера, удаляя ведущие нули или корректируя региональные префиксы для обеспечения согласованной логики поиска.
-
-**Параметры:**
-- `phone: string` — строка входящего номера телефона.
-
-**Возвращает:** `string` — нормализованная числовая строка.
-
-```javascript
-GeoPhone.removeZero('0671234567')  // '671234567'
-GeoPhone.removeZero('89001234567') // '9001234567'
-```
-
-## Объекты GeoPhone
+## Типы данных
 
 ### `GeoPhoneValue`
 Базовая структура метаданных для конфигурации телефона каждой страны:
-- `phone: number` — телефонный код (например, `7`).
-- `within: number` — код внутреннего правила набора.
-- `mask: string[]` — массив паттернов масок.
-- `value: string` — идентификатор страны.
+- `phone: number` — Телефонный код страны (например, `7`).
+- `within: number` — Код внутреннего правила набора (используется для выбора спецсимвола в маске).
+- `mask: string[]` — Массив паттернов масок, закрепленных за страной.
+- `value: string` — Идентификатор страны (ISO 3166).
 
 ### `GeoPhoneMap`
-Узел внутреннего префиксного дерева:
-- `items: GeoPhoneValue[]` — список элементов в этой ветви.
-- `info: GeoPhoneValue | undefined` — найденное значение в данном конкретном числовом узле.
-- `next: Record<string, GeoPhoneMap>` — указатели на следующие цифры номера в дереве.
+Узел внутреннего префиксного дерева (Trie), используемый для поиска:
+- `items: GeoPhoneValue[]` — Список всех элементов, доступных в данной ветви дерева.
+- `info: GeoPhoneValue | undefined` — Метаданные телефона, если текущий узел является завершенным кодом.
+- `value: string | undefined` — Идентификатор страны для данного узла.
+- `mask: string[]` — Массив масок с подставленными спецсимволами (`~`, `=`, `$`).
+- `maskFull: string[]` — Полные маски, включая международный код.
+- `next: Record<string, GeoPhoneMap>` — Указатели на следующие цифры номера в дереве поиска.
+
+### `GeoPhoneMapInfo`
+Результат выполнения метода поиска `getByPhone`:
+- `item?: GeoPhoneMap` — Найденный узел дерева с информацией о стране и масках.
+- `phone?: string` — Оставшаяся часть номера после отделения кода страны.
 
 ## Примеры
 
+### Работа со спецсимволами (Within)
+Внутренняя логика класса заменяет первую "звездочку" в маске на спецсимвол в зависимости от региональных правил:
+- `~` — для России (код внутри страны 8).
+- `$` — для некоторых других регионов.
+
+```javascript
+const mapInfo = GeoPhone.getByCode('RU')
+console.log(mapInfo.mask[0]) // '~ (***) ***-**-**'
+```
+
+### Множественные маски
 ```javascript
-import { GeoPhone } from '@dxtmisha/functional'
-
-// 1. Идентификация страны по номеру телефона
-const lookup = GeoPhone.getByPhone('+79001234567')
-if (lookup.item) {
-    console.log('Страна:', lookup.item.value) // 'RU'
-    console.log('Основная маска:', lookup.item.mask[0])
-}
-
-// 2. Ручное форматирование
-const formatted = GeoPhone.toMask('442071234567', ['+** (**) **** ****'])
-console.log(formatted) // '+44 (20) 7123 4567'
-
-// 3. Нормализация ввода для поиска
-const rawInput = '0084901234567'
-const normalized = GeoPhone.removeZero(rawInput.replace(/^00/, ''))
-console.log(normalized) // '84901234567'
+const masks = ['+* (***) ***-**-**', '+* (***) ***-***']
+console.log(GeoPhone.toMask('79991234567', masks)) // 11 цифр -> '+7 (999) 123-45-67'
+console.log(GeoPhone.toMask('7999123456', masks))  // 10 цифр -> '+7 (999) 123-456'
 ```

package/src/media/functional/functional-basic/classes/GeoPhone/GeoPhone.vi.mdx

@@ -1,139 +1,89 @@
 import {Meta} from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/functional-basic/Classes/GeoPhone - Mặt nạ số điện thoại'/>
+<Meta title='@dxtmisha/vi/functional-basic/Classes/GeoPhone - Mặt nạ điện thoại'/>
 
 # Lớp GeoPhone
 
-Lớp chuyên biệt để lưu trữ và xử lý các mặt nạ số điện thoại quốc tế. Nó cung cấp một hệ thống mạnh mẽ để xác định thông tin vị trí địa lý của quốc gia từ các chuỗi số điện thoại, định dạng số thô thành các đặc tả mặt nạ địa phương và quản lý bản đồ mã điện thoại quốc tế dựa trên cấu trúc cây tiền tố (prefix-tree).
+Lớp chuyên biệt để lưu trữ và xử lý mặt nạ số điện thoại quốc tế. Cung cấp cơ chế xác định quốc gia theo chuỗi số điện thoại, định dạng số thô thành mặt nạ được bản địa hóa và quản lý bản đồ mã điện thoại phức tạp dựa trên cây tiền tố (Trie). Lớp này được tích hợp chặt chẽ với dữ liệu địa lý `Geo`, cho phép tự động xác định mặt nạ dựa trên ngôn ngữ hiện tại của người dùng hoặc mã quốc gia được cung cấp.
 
-Lớp này tích hợp sâu với dữ liệu địa lý `Geo` để cung cấp khả năng tự động phân giải mặt nạ dựa trên vùng locale hiện tại của người dùng hoặc các mã quốc gia cụ thể.
+## Tính năng chính
 
-## Các tính năng chính
+- **Khớp tự động** — Tự động xác định quốc gia và mẫu mặt nạ phù hợp thông qua tìm kiếm đệ quy trong cây tiền tố.
+- **Tối ưu hóa cây tiền tố** — Sử dụng cấu trúc `map` chuyên biệt (Trie) để tìm kiếm hiệu suất cao.
+- **Bình thường hóa thông minh** — Tự động xử lý các biến thể quay số khu vực như số 0 ở đầu hoặc tiền tố quốc gia.
+- **Định dạng tiêu chuẩn** — Chuyển đổi các chuỗi số thô thành định dạng dễ đọc.
 
-- **Tự động khớp (Auto Mapping)** — Tự động phân giải quốc gia và mẫu mặt nạ phù hợp một cách động thông qua tra cứu cây tiền tố đệ quy.
-- **Tối ưu hóa Cây Tiền tố (Prefix Tree)** — Sử dụng cấu trúc `map` chuyên biệt (Prefix Tree) để tìm kiếm hiệu quả và hiệu suất cao trên các kế hoạch đánh số quốc tế.
-- **Chuẩn hóa Thông minh** — Tự động xử lý các biến thể quay số theo vùng, chẳng hạn như số 0 ở đầu hoặc các tiền tố quốc gia (ví dụ: số '8' của Nga).
-- **Định dạng Chuẩn hóa** — Chuyển đổi các chuỗi số thô thành các định dạng điện thoại dễ đọc, phù hợp với các tiêu chuẩn viễn thông quốc tế.
+## Cách sử dụng cơ bản
 
-## Các phương thức Tìm kiếm
-
-### `getByPhone`
-
-Phương thức định danh chính phân tích một chuỗi số điện thoại để trích xuất thông tin địa lý và mặt nạ đánh số phù hợp nhất.
-
-**Tham số:**
-- `phone: string` — Số điện thoại mục tiêu cần phân tích (chấp nhận các chuỗi thô hoặc đã được định dạng một phần).
-
-**Trả về:** `GeoPhoneMapInfo` — Một đối tượng cấu trúc chứa mục `GeoPhoneMap` khớp được và phần số đã được chuẩn hóa của điện thoại.
+Bạn có thể sử dụng các phương thức tĩnh của lớp để xác định nhanh quốc gia theo số điện thoại hoặc định dạng.
 
 ```javascript
 import { GeoPhone } from '@dxtmisha/functional-basic'
 
+// Xác định quốc gia theo số điện thoại
 const info = GeoPhone.getByPhone('84901234567')
-// trả về:
-// { 
-//   item: { info: { phone: 84, ... }, mask: ['+84 ** **** ****'], ... },
-//   phone: '901234567' 
-// }
-```
-
-### `get`
-
-Truy xuất siêu dữ liệu điện thoại đã địa phương hóa được liên kết với một mã quốc gia cụ thể.
-
-**Tham số:**
-- `code: string` — Mã quốc gia tiêu chuẩn ISO 3166 (ví dụ: `'VN'`, `'RU'`, `'US'`).
+console.log(info.item?.value) // 'VN'
 
-**Trả về:** `GeoPhoneValue | undefined` — Siêu dữ liệu thô của quốc gia, hoặc `undefined` nếu không tìm thấy trong bộ dữ liệu.
-
-```javascript
-GeoPhone.get('VN') 
-// { phone: 84, within: 0, mask: ['+** ** **** ****'], value: 'VN' }
+// Định dạng theo mặt nạ
+const formatted = GeoPhone.toMask('901234567', ['+** (***) ***-***'])
+console.log(formatted) // '+84 (901) 234-567'
 ```
 
-### `getByCode`
-
-Phương thức truy xuất mở rộng trả về dữ liệu mặt nạ đầy đủ bao gồm cả nút cây tìm kiếm cho một mã quốc gia nhất định.
-
-**Tham số:**
-- `code: string` — Chuỗi mã quốc gia mục tiêu.
-
-**Trả về:** `GeoPhoneMap | undefined` — Đối tượng nút bản đồ đầy đủ cho mã được yêu cầu.
-
-```javascript
-GeoPhone.getByCode('US')
-// { info: { phone: 1, ... }, mask: ['1 (***) ***-****'], ... }
-```
+## Các phương thức
 
-## Các phương thức Truy cập Dữ liệu
+### Thông tin
 
-- `getList(): GeoPhoneValue[]` — Trả về danh sách phẳng đầy đủ, đã được sắp xếp của tất cả siêu dữ liệu điện thoại quốc tế đã đăng ký.
-- `getMap(): Record<string, GeoPhoneMap>` — Trả về nút gốc của cây tiền tố nội bộ được sử dụng để định danh số điện thoại tốc độ cao.
+- `getList(): GeoPhoneValue[]` — Trả về danh sách phẳng đầy đủ, đã được sắp xếp của tất cả dữ liệu meta điện thoại quốc tế.
+- `getMap(): Record<string, GeoPhoneMap>` — Trả về nút gốc của cây tiền tố nội bộ được sử dụng để tìm kiếm.
 
-## Các phương thức Định dạng & Tiện ích
+### Lựa chọn
 
-### `toMask`
+- `get(code: string): GeoPhoneValue | undefined` — Lấy dữ liệu meta điện thoại liên kết với một mã quốc gia cụ thể.
+- `getByPhone(phone: string): GeoPhoneMapInfo` — Phân tích chuỗi số điện thoại để trích xuất thông tin và mặt nạ phù hợp.
+- `getByCode(code: string): GeoPhoneMap | undefined` — Trả về thông tin mặt nạ đầy đủ cho một mã nhất định.
 
-Chuyển đổi một chuỗi số điện thoại thô thành phiên bản đã được định dạng dựa trên một tập hợp các mặt nạ cụ thể.
+### Phụ trợ
 
-**Tham số:**
-- `phone: string` — Đầu vào số thô.
-- `masks?: string[]` — Một mảng các chuỗi mặt nạ hợp lệ để lặp qua nhằm tìm kiếm sự phù hợp.
+- `toMask(phone: string, masks?: string[]): string | undefined` — Chuyển đổi chuỗi số điện thoại thô thành phiên bản đã định dạng.
+- `removeZero(phone: string): string` — Bình thường hóa biểu diễn nội bộ của số bằng cách loại bỏ các số 0 ở đầu hoặc điều chỉnh tiền tố khu vực.
 
-**Trả về:** `string | undefined` — Chuỗi đã được định dạng cho người dùng, hoặc `undefined` nếu không có độ dài mặt nạ nào khớp với đầu vào.
-
-```javascript
-GeoPhone.toMask('901234567', ['+** ** **** ****']) 
-// '+84 90 1234 567'
-```
-
-### `removeZero`
-
-Chuẩn hóa biểu diễn số nội bộ bằng cách loại bỏ các số 0 ở đầu hoặc sửa các tiền tố quay số vùng để đảm bảo logic tìm kiếm nhất quán.
-
-**Tham số:**
-- `phone: string` — Chuỗi số điện thoại đầu vào.
-
-**Trả về:** `string` — Chuỗi số đã được chuẩn hóa.
-
-```javascript
-GeoPhone.removeZero('0901234567')  // '901234567'
-GeoPhone.removeZero('89001234567') // '9001234567'
-```
-
-## Các đối tượng GeoPhone
+## Kiểu dữ liệu
 
 ### `GeoPhoneValue`
 Cấu trúc siêu dữ liệu cơ bản cho cấu hình điện thoại của mỗi quốc gia:
-- `phone: number` — Mã quay số (ví dụ: `84`).
-- `within: number` — Mã quy tắc quay số nội bộ.
-- `mask: string[]` — Mảng các mẫu mặt nạ.
-- `value: string` — Định danh quốc gia.
+- `phone: number` — Mã điện thoại quốc gia (ví dụ: `84`).
+- `within: number` — Mã quy tắc gọi nội bộ (dùng để chọn ký tự đặc biệt trong mặt nạ).
+- `mask: string[]` — Mảng các mẫu mặt nạ được gán cho quốc gia.
+- `value: string` — Mã định danh quốc gia (ISO 3166).
 
 ### `GeoPhoneMap`
-Một nút trong cây tiền tố nội bộ:
-- `items: GeoPhoneValue[]` — Danh sách các mục thuộc nhánh này.
-- `info: GeoPhoneValue | undefined` — Giá trị khớp tại nút số cụ thể này.
-- `next: Record<string, GeoPhoneMap>` — Con trỏ đến các chữ số tiếp theo trong cây.
+Một nút trong cây tiền tố nội bộ (Trie) được sử dụng để tìm kiếm:
+- `items: GeoPhoneValue[]` — Danh sách tất cả các mục có sẵn trong nhánh này của cây.
+- `info: GeoPhoneValue | undefined` — Dữ liệu meta điện thoại nếu nút hiện tại là một mã đầy đủ.
+- `value: string | undefined` — Mã định danh quốc gia cho nút này.
+- `mask: string[]` — Mảng các mặt nạ với các ký tự nội bộ đã được thay thế (`~`, `=`, `$`).
+- `maskFull: string[]` — Mặt nạ đầy đủ bao gồm cả mã quốc tế.
+- `next: Record<string, GeoPhoneMap>` — Con trỏ đến các chữ số tiếp theo trong cây tìm kiếm.
+
+### `GeoPhoneMapInfo`
+Kết quả của phương thức tìm kiếm `getByPhone`:
+- `item?: GeoPhoneMap` — Nút cây tìm thấy với thông tin quốc gia và mặt nạ.
+- `phone?: string` — Phần còn lại của số sau khi tách mã quốc gia.
 
 ## Ví dụ
 
+### Logic ký tự nội bộ (Within)
+Logic nội bộ của lớp sẽ thay thế dấu "sao" đầu tiên trong mặt nạ bằng một ký tự đặc biệt tùy thuộc vào quy tắc khu vực:
+- `~` — cho Nga (mã nội bộ 8).
+- `=` — cho các khu vực mặc định/khác (ví dụ: Việt Nam, Hoa Kỳ).
+
+```javascript
+const mapInfo = GeoPhone.getByCode('RU')
+console.log(mapInfo.mask[0]) // '~ (***) ***-**-**'
+```
+
+### Nhiều mặt nạ
 ```javascript
-import { GeoPhone } from '@dxtmisha/functional'
-
-// 1. Định danh quốc gia bằng số điện thoại
-const lookup = GeoPhone.getByPhone('+84901234567')
-if (lookup.item) {
-    console.log('Quốc gia:', lookup.item.value) // 'VN'
-    console.log('Mặt nạ chính:', lookup.item.mask[0])
-}
-
-// 2. Định dạng thủ công
-const formatted = GeoPhone.toMask('442071234567', ['+** (**) **** ****'])
-console.log(formatted) // '+44 (20) 7123 4567'
-
-// 3. Chuẩn hóa đầu vào để tìm kiếm
-const rawInput = '0084901234567'
-const normalized = GeoPhone.removeZero(rawInput.replace(/^00/, ''))
-console.log(normalized) // '84901234567'
+const masks = ['+** (***) ***-***', '+** (***) ***-**-**']
+console.log(GeoPhone.toMask('84901234567', masks)) // 11 số -> '+84 (901) 234-567'
 ```

package/src/media/functional/functional-basic/classes/Hash/Hash.en.mdx

@@ -4,7 +4,9 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Hash Class
 
-A static class for managing data stored in the URL hash (`#`). It automatically synchronizes application state with the URL — every `set` call updates the browser's hash string, while the `hashchange` event refreshes the internal state.
+A static facade class for managing data stored in the URL hash (`#`). It delegates execution to the `HashInstance` class, providing centralized access and state isolation (e.g., for SSR).
+
+It automatically synchronizes application state with the URL — every `set` call updates the browser's hash string, while the `hashchange` event refreshes the internal state.
 
 ## Key Features
 
@@ -12,10 +14,11 @@ A static class for managing data stored in the URL hash (`#`). It automatically
 - **Reactivity via Watchers** — The `addWatch` method allows subscribing to changes on a specific variable.
 - **Auto-initialization** — When the page loads, data is automatically read from the URL.
 - **Smart Typing** — Values are deserialized from a string: numbers, booleans, and objects are restored to their original types.
+- **SSR Isolation** — `ServerStorage` ensures a unique data instance for each request on the server.
 
 ## Initialization
 
-The class is static and initializes automatically on page load — reading the current URL hash string.
+The class is static and initializes automatically upon the first access.
 
 ```javascript
 // URL: https://myapp.com/#page=2;filter=active
@@ -28,11 +31,19 @@ const filter = Hash.get('filter') // 'active' (string)
 
 ## Methods
 
-- `get<T>(name: string, defaultValue?: T | (() => T)): T` — Returns the value of a hash variable. If the value doesn't exist, it is set using `defaultValue` (which can be a function).
-- `set<T>(name: string, callback: T | (() => T)): void` — Sets a variable's value and updates the URL hash. If the value hasn't changed, no update occurs.
-- `addWatch<T>(name: string, callback: (value: T) => void): void` — Subscribes to changes for a specific hash variable.
-- `removeWatch<T>(name: string, callback: (value: T) => void): void` — Unsubscribes from changes for a specific variable.
-- `reload(): void` — Reads the current URL hash and synchronizes it with the internal state.
+### Instance
+- `static getItem(): HashInstance` — Returns the current `HashInstance` (isolated for the current request).
+
+### Reading and Writing
+- `static get<T>(name: string, defaultValue?: T | (() => T)): T` — Returns the value of a hash variable.
+- `static set<T>(name: string, callback: T | (() => T)): void` — Sets a variable's value and updates the URL hash.
+
+### Watchers
+- `static addWatch<T>(name: string, callback: (value: T) => void): void` — Subscribes to changes for a specific hash variable.
+- `static removeWatch<T>(name: string, callback: (value: T) => void): void` — Unsubscribes from changes for a specific variable.
+
+### Management
+- `static reload(): void` — Forces synchronization of the state with the current URL hash.
 
 ## Examples
 

package/src/media/functional/functional-basic/classes/Hash/Hash.ru.mdx

@@ -4,7 +4,9 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс Hash
 
-Статический класс для управления данными, которые хранятся в URL-хэше (`#`). Автоматически синхронизирует состояние приложения с URL — каждый вызов `set` обновляет строку хэша в браузере, а событие `hashchange` обновляет внутреннее состояние.
+Статический класс-фасад для управления данными, которые хранятся в URL-хэше (`#`). Он делегирует выполнение классу `HashInstance`, обеспечивая централизованный доступ и изоляцию состояния (например, при SSR).
+
+Автоматически синхронизирует состояние приложения с URL — каждый вызов `set` обновляет строку хэша в браузере, а событие `hashchange` обновляет внутреннее состояние.
 
 ## Ключевые особенности
 
@@ -12,10 +14,11 @@ import {Meta} from '@storybook/addon-docs/blocks'
 - **Реактивность через watchers** — Метод `addWatch` позволяет подписаться на изменение конкретной переменной.
 - **Авто-инициализация** — При загрузке страницы данные автоматически считываются из URL.
 - **Умный тип** — Значения десериализуются из строки: числа, булевые значения и объекты восстанавливаются.
+- **SSR-изоляция** — Через `ServerStorage` обеспечивается уникальный экземпляр данных для каждого запроса на сервере.
 
 ## Инициализация
 
-Класс является статическим и инициализируется автоматически при загрузке страницы — считывает текущую строку хэша URL.
+Класс является статическим и инициализируется автоматически при первом обращении.
 
 ```javascript
 // URL: https://myapp.com/#page=2;filter=active
@@ -28,11 +31,19 @@ const filter = Hash.get('filter') // 'active' (string)
 
 ## Методы
 
-- `get<T>(name: string, defaultValue?: T | (() => T)): T` — Возвращает значение переменной из хэша. Если значения нет, устанавливает его через `defaultValue` (может быть функцией).
-- `set<T>(name: string, callback: T | (() => T)): void` — Устанавливает значение переменной и обновляет URL-хэш. Если значение не изменилось, обновление не происходит.
-- `addWatch<T>(name: string, callback: (value: T) => void): void` — Подписывается на изменение конкретной переменной в хэше.
-- `removeWatch<T>(name: string, callback: (value: T) => void): void` — Отписывается от изменений конкретной переменной.
-- `reload(): void` — Считывает текущий URL-хэш и синхронизирует с ним внутреннее состояние.
+### Экземпляр
+- `static getItem(): HashInstance` — Возвращает текущий экземпляр `HashInstance` (изолированный для текущего запроса).
+
+### Чтение и запись
+- `static get<T>(name: string, defaultValue?: T | (() => T)): T` — Возвращает значение переменной из хэша.
+- `static set<T>(name: string, callback: T | (() => T)): void` — Устанавливает значение переменной и обновляет URL-хэш.
+
+### Наблюдение (Watchers)
+- `static addWatch<T>(name: string, callback: (value: T) => void): void` — Подписывается на изменение переменной.
+- `static removeWatch<T>(name: string, callback: (value: T) => void): void` — Отписывается от изменений.
+
+### Управление
+- `static reload(): void` — Принудительно синхронизирует состояние с текущим URL-хэшем.
 
 ## Примеры
 

package/src/media/functional/functional-basic/classes/Hash/Hash.vi.mdx

@@ -4,7 +4,9 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Lớp Hash
 
-Một lớp tĩnh để quản lý dữ liệu được lưu trữ trong URL hash (`#`). Tự động đồng bộ hóa trạng thái ứng dụng với URL — mỗi lần gọi `set` sẽ cập nhật chuỗi hash trên trình duyệt, và sự kiện `hashchange` sẽ làm mới trạng thái nội bộ.
+Một lớp facade tĩnh để quản lý dữ liệu được lưu trữ trong URL hash (`#`). Nó ủy quyền thực thi cho lớp `HashInstance`, cung cấp khả năng truy cập tập trung и cách ly trạng thái (ví dụ: cho SSR).
+
+Nó tự động đồng bộ hóa trạng thái ứng dụng với URL — mỗi lần gọi `set` sẽ cập nhật chuỗi hash trên trình duyệt, và sự kiện `hashchange` sẽ làm mới trạng thái nội bộ.
 
 ## Tính năng chính
 
@@ -12,10 +14,11 @@ Một lớp tĩnh để quản lý dữ liệu được lưu trữ trong URL has
 - **Phản hồi qua Watcher** — Phương thức `addWatch` cho phép đăng ký theo dõi thay đổi của một biến cụ thể.
 - **Tự động khởi tạo** — Khi tải trang, dữ liệu được tự động đọc từ URL.
 - **Phân tích kiểu thông minh** — Giá trị được giải mã từ chuỗi: số, boolean và đối tượng được khôi phục về kiểu gốc.
+- **Cách ly SSR** — `ServerStorage` đảm bảo mỗi yêu cầu trên máy chủ có một phiên bản dữ liệu riêng.
 
 ## Khởi tạo
 
-Lớp này là tĩnh và khởi tạo tự động khi tải trang — đọc chuỗi hash URL hiện tại.
+Lớp này là tĩnh và khởi tạo tự động khi truy cập lần đầu.
 
 ```javascript
 // URL: https://myapp.com/#page=2;filter=active
@@ -28,11 +31,19 @@ const filter = Hash.get('filter') // 'active' (string)
 
 ## Phương thức
 
-- `get<T>(name: string, defaultValue?: T | (() => T)): T` — Trả về giá trị của biến hash. Nếu không có giá trị, nó được thiết lập qua `defaultValue` (có thể là hàm).
-- `set<T>(name: string, callback: T | (() => T)): void` — Thiết lập giá trị của biến và cập nhật URL hash. Nếu giá trị không thay đổi, không có cập nhật nào xảy ra.
-- `addWatch<T>(name: string, callback: (value: T) => void): void` — Đăng ký theo dõi thay đổi của một biến hash cụ thể.
-- `removeWatch<T>(name: string, callback: (value: T) => void): void` — Hủy đăng ký theo dõi thay đổi của một biến.
-- `reload(): void` — Đọc URL hash hiện tại và đồng bộ hóa với trạng thái nội bộ.
+### Phiên bản
+- `static getItem(): HashInstance` — Trả về phiên bản `HashInstance` hiện tại (được cách ly cho yêu cầu hiện tại).
+
+### Đọc и Ghi
+- `static get<T>(name: string, defaultValue?: T | (() => T)): T` — Trả về giá trị của biến hash.
+- `static set<T>(name: string, callback: T | (() => T)): void` — Thiết lập giá trị của biến и cập nhật URL hash.
+
+### Theo dõi (Watchers)
+- `static addWatch<T>(name: string, callback: (value: T) => void): void` — Đăng ký theo dõi thay đổi của một biến hash cụ thể.
+- `static removeWatch<T>(name: string, callback: (value: T) => void): void` — Hủy đăng ký theo dõi thay đổi của một biến.
+
+### Quản lý
+- `static reload(): void` — Ép buộc đồng bộ hóa trạng thái với URL hash hiện tại.
 
 ## Ví dụ
 

package/src/media/functional/functional-basic/classes/HashInstance/HashInstance.en.mdx

@@ -0,0 +1,54 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/HashInstance - URL Hash Instance'/>
+
+# HashInstance Class
+
+`HashInstance` is the core class that implements the logic for managing data in the URL hash. It provides state storage, mechanisms for subscribing to changes, and synchronization with the browser API.
+
+You can use this class directly if you need isolated hash management separate from the global `Hash` state.
+
+## Key Features
+
+- **Isolated State** — Stores its own set of hash variables.
+- **Chainable API** — Most methods return `this`, allowing for concise code.
+- **Automatic Synchronization** — Upon initialization, it reads data from the URL and subscribes to the `hashchange` event.
+- **SSR Compatibility** — Works safely in server-side environments using stubs for DOM APIs.
+
+## Initialization
+
+To create an instance, use the `HashInstance()` constructor.
+
+```typescript
+import { HashInstance } from '@dxtmisha/functional-basic'
+
+const myHash = new HashInstance()
+```
+
+## Methods
+
+### Reading and Writing
+- `get<T>(name: string, defaultValue?: T | (() => T)): T` — Returns the value of a variable. If it doesn't exist, sets `defaultValue` and returns it.
+- `set<T>(name: string, callback: T | (() => T)): this` — Updates the variable's value and synchronizes the URL.
+
+### Watchers
+- `addWatch<T>(name: string, callback: (value: T) => void): this` — Adds a handler for variable changes.
+- `removeWatch<T>(name: string, callback: (value: T) => void): this` — Removes a handler.
+
+### Management
+- `reload(): this` — Refreshes the internal state from the current URL hash.
+
+## Examples
+
+### Using an Isolated Instance
+```typescript
+const searchHash = new HashInstance()
+
+// Subscribe
+searchHash.addWatch('query', (q) => {
+  console.log('Search:', q)
+})
+
+// Set value (will update URL)
+searchHash.set('query', 'smartphones')
+```