@dxtmisha/wiki 0.39.7 → 0.56.0

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

@@ -4,45 +4,41 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # ApiDefault Class
 
-A class for managing default data for API requests. It allows setting base parameters that should be included in every request, supporting both standard objects and `FormData`.
+A class for managing default data for API requests. It allows setting base parameters that should be included in every request, supporting both standard objects and `FormData`. This is useful for centrally defining common fields such as tokens, application IDs, or localization settings.
 
-## Key Features
+> `ApiDefault` is an **auxiliary class**, designed for managing request defaults. In most cases, it is recommended to define these through the `requestDefault` parameter in the global `Api` configuration.
 
-- **Centralized Defaults** — define common parameters (like tokens or locale) once for all API calls.
-- **Support for Multiple Formats** — works seamlessly with both plain JavaScript objects and `FormData`.
-- **Intelligent Merging** — merges defaults with request-specific data, prioritizing the actual request data if keys overlap.
-- **Easy Checks** — simple methods to check if any default data is currently set.
+## Key Features
 
-## Initialization
+- **Centralized Defaults** — Define common parameters once for all API calls.
+- **Support for Multiple Formats** — Works seamlessly with both plain JavaScript objects and `FormData`.
+- **Intelligent Merging** — Merges defaults with request-specific data, prioritizing the actual request data if keys overlap.
+- **Chainable API** — Supports a fluent interface for setting parameters.
 
-To initialize the object, call the `ApiDefault()` constructor.
+## Methods
 
-```typescript
-import { ApiDefault } from '@dxtmisha/functional'
+### Action
 
-// 1. Simple initialization
-const apiDefault = new ApiDefault()
+#### `request`
 
-// 2. Setting default data
-apiDefault.set({ lang: 'en', version: 'v1' })
+Merges the stored default data into a provided request object or `FormData` instance. If the input is a plain object, it returns a new merged object. If the input is `FormData`, it adds missing keys directly to the instance.
 
-// 3. Example usage with a request object
-const requestData = { user_id: 5 }
-const mergedRequest = apiDefault.request(requestData)
-// Result: { lang: 'en', version: 'v1', user_id: 5 }
+**Parameters:**
+- `request: ApiFetch['request']` — The original request data (Object, FormData, or String).
 
-// 4. Example usage with FormData
-const fd = new FormData()
-fd.append('photo', fileBlob)
-apiDefault.request(fd)
-// Result: fd now contains 'lang' and 'version' if they were missing
-```
+**Returns:** `ApiFetch['request']` — The transformed request data.
 
-## Methods
+### Check
 
 - `is(): boolean` — Checks if any default data has been set.
-- `get(): ApiDefaultValue` — Returns the current default data.
-- `request(request: ApiFetch['request']): ApiFetch['request']` — Merges the stored default data into a provided request object or `FormData` instance.
-- `set(request: ApiDefaultValue)` — Sets the default data object for requests.
+- `get(): ApiDefaultValue | undefined` — Returns the current default data object.
+
+### Configuration
+
+- `set(request: ApiDefaultValue): this` — Sets the default data for all future requests.
 
+## Types
 
+#### `ApiDefaultValue`
+A plain object representing default parameters.
+- `[key: string]: any` — Key-value pairs to be used as defaults.

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

@@ -4,45 +4,41 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс ApiDefault
 
-Класс для управления данными по умолчанию для API-запросов. Он позволяет устанавливать базовые параметры, которые должны быть включены в каждый запрос, поддерживая как стандартные объекты, так и `FormData`.
+Класс для управления данными по умолчанию для API-запросов. Он позволяет устанавливать базовые параметры, которые должны быть включены в каждый запрос, поддерживая как стандартные объекты, так и `FormData`. Это полезно для централизованного определения общих полей, таких как токены, ID приложения или настройки локализации.
 
-## Ключевые особенности
+> `ApiDefault` является **вспомогательным классом**, предназначенным для управления значениями по умолчанию в запросах. В большинстве случаев рекомендуется определять их через параметр `requestDefault` в глобальной конфигурации `Api`.
 
-- **Централизованные значения** — определите общие параметры (например, токены или локаль) один раз для всех вызовов API.
-- **Поддержка различных форматов** — бесшовно работает как с обычными объектами JavaScript, так и с `FormData`.
-- **Интеллектуальное слияние** — объединяет значения по умолчанию с данными конкретного запроса, отдавая приоритет данным запроса при совпадении ключей.
-- **Простые проверки** — удобные методы для проверки наличия установленных данных по умолчанию.
+## Ключевые особенности
 
-## Инициализация
+- **Централизованные значения** — Определите общие параметры один раз для всех вызовов API.
+- **Поддержка различных форматов** — Бесшовно работает как с обычными объектами JavaScript, так и с `FormData`.
+- **Интеллектуальное слияние** — Объединяет значения по умолчанию с данными конкретного запроса, отдавая приоритет данным запроса при совпадении ключей.
+- **Chainable API** — Поддерживает цепочку вызовов при установке параметров.
 
-Для инициализации объекта вызовите конструктор `ApiDefault()`.
+## Методы
 
-```typescript
-import { ApiDefault } from '@dxtmisha/functional'
+### Действие
 
-// 1. Простая инициализация
-const apiDefault = new ApiDefault()
+#### `request`
 
-// 2. Установка данных по умолчанию
-apiDefault.set({ lang: 'ru', version: 'v1' })
+Объединяет сохраненные данные по умолчанию с предоставленным объектом запроса или экземпляром `FormData`. Если входные данные являются объектом, метод возвращает новый объединенный объект. Если входные данные — `FormData`, недостающие ключи добавляются напрямую в экземпляр.
 
-// 3. Пример использования с объектом запроса
-const requestData = { user_id: 5 }
-const mergedRequest = apiDefault.request(requestData)
-// Результат: { lang: 'ru', version: 'v1', user_id: 5 }
+**Параметры:**
+- `request: ApiFetch['request']` — Исходные данные запроса (Object, FormData или String).
 
-// 4. Пример использования с FormData
-const fd = new FormData()
-fd.append('photo', fileBlob)
-apiDefault.request(fd)
-// Результат: fd теперь содержит 'lang' и 'version', если они отсутствовали
-```
+**Возвращает:** `ApiFetch['request']` — Трансформированные данные запроса.
 
-## Методы
+### Проверка
 
 - `is(): boolean` — Проверяет, были ли установлены какие-либо данные по умолчанию.
-- `get(): ApiDefaultValue` — Возвращает текущие данные по умолчанию.
-- `request(request: ApiFetch['request']): ApiFetch['request']` — Объединяет сохраненные данные по умолчанию с предоставленным объектом запроса или экземпляром `FormData`.
-- `set(request: ApiDefaultValue)` — Устанавливает объект данных по умолчанию для всех запросов.
+- `get(): ApiDefaultValue | undefined` — Возвращает текущий объект данных по умолчанию.
+
+### Конфигурация
+
+- `set(request: ApiDefaultValue): this` — Устанавливает данные по умолчанию для всех будущих запросов.
 
+## Типы
 
+#### `ApiDefaultValue`
+Обычный объект, представляющий параметры по умолчанию.
+- `[key: string]: any` — Пары ключе-значение, используемые по умолчанию.

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

@@ -4,45 +4,41 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Lớp ApiDefault
 
-Một lớp để quản lý dữ liệu mặc định cho các yêu cầu API. Nó cho phép thiết lập các tham số cơ bản cần được bao gồm trong mọi yêu cầu, hỗ trợ cả đối tượng thông thường và `FormData`.
+Một lớp để quản lý dữ liệu mặc định cho các yêu cầu API. Nó cho phép thiết lập các tham số cơ bản cần được bao gồm trong mọi yêu cầu, hỗ trợ cả đối tượng thông thường và `FormData`. Điều này hữu ích để định nghĩa tập trung các trường chung như token, ID ứng dụng hoặc cài đặt ngôn ngữ.
 
-## Các tính năng chính
+> `ApiDefault` là một **lớp bổ trợ** (auxiliary class), được thiết kế để quản lý các giá trị mặc định của yêu cầu. Trong hầu hết các trường hợp, bạn nên định nghĩa chúng thông qua tham số `requestDefault` trong cấu hình `Api` toàn cục.
 
-- **Mặc định hóa tập trung** — định nghĩa các tham số chung (như token hoặc ngôn ngữ) một lần cho tất cả các cuộc gọi API.
-- **Hỗ trợ nhiều định dạng** — hoạt động mượt mà với cả đối tượng JavaScript thuần túy và `FormData`.
-- **Gộp dữ liệu thông minh** — gộp các giá trị mặc định với dữ liệu cụ thể của yêu cầu, ưu tiên dữ liệu yêu cầu thực tế nếu có sự trùng lặp khóa.
-- **Kiểm tra dễ dàng** — các phương thức đơn giản để kiểm tra xem dữ liệu mặc định đã được thiết lập hay chưa.
+## Các tính năng chính
 
-## Khởi tạo
+- **Mặc định hóa tập trung** — Định nghĩa các tham số chung một lần cho tất cả các cuộc gọi API.
+- **Hỗ trợ nhiều định dạng** — Hoạt động mượt mà với cả đối tượng JavaScript thuần túy và `FormData`.
+- **Gộp dữ liệu thông minh** — Gộp các giá trị mặc định với dữ liệu cụ thể của yêu cầu, ưu tiên dữ liệu yêu cầu thực tế nếu có sự trùng lặp khóa.
+- **Chainable API** — Hỗ trợ giao diện linh hoạt (chaining) để thiết lập các tham số.
 
-Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `ApiDefault()`.
+## Các phương thức
 
-```typescript
-import { ApiDefault } from '@dxtmisha/functional'
+### Hành động
 
-// 1. Khởi tạo đơn giản
-const apiDefault = new ApiDefault()
+#### `request`
 
-// 2. Thiết lập dữ liệu mặc định
-apiDefault.set({ lang: 'vi', version: 'v1' })
+Gộp dữ liệu mặc định đã lưu vào một đối tượng yêu cầu hoặc thực thể `FormData` được cung cấp. Nếu đầu vào là một đối tượng thuần túy, nó sẽ trả về một đối tượng mới đã được gộp. Nếu đầu vào là `FormData`, nó sẽ thêm trực tiếp các khóa còn thiếu vào thực thể đó.
 
-// 3. Ví dụ sử dụng với một đối tượng yêu cầu
-const requestData = { user_id: 5 }
-const mergedRequest = apiDefault.request(requestData)
-// Kết quả: { lang: 'vi', version: 'v1', user_id: 5 }
+**Tham số:**
+- `request: ApiFetch['request']` — Dữ liệu yêu cầu gốc (Đối tượng, FormData hoặc Chuỗi).
 
-// 4. Ví dụ sử dụng với FormData
-const fd = new FormData()
-fd.append('photo', fileBlob)
-apiDefault.request(fd)
-// Kết quả: fd bây giờ chứa 'lang' và 'version' nếu chúng bị thiếu
-```
+**Trả về:** `ApiFetch['request']` — Dữ liệu yêu cầu đã được chuyển đổi.
 
-## Các phương thức
+### Kiểm tra
 
 - `is(): boolean` — Kiểm tra xem dữ liệu mặc định đã được thiết lập chưa.
-- `get(): ApiDefaultValue` — Trả về dữ liệu mặc định hiện tại.
-- `request(request: ApiFetch['request']): ApiFetch['request']` — Gộp dữ liệu mặc định đã lưu vào một đối tượng yêu cầu hoặc biến biểu mẫu `FormData` được cung cấp.
-- `set(request: ApiDefaultValue)` — Thiết lập dữ liệu mặc định cho các yêu cầu.
+- `get(): ApiDefaultValue | undefined` — Trả về đối tượng dữ liệu mặc định hiện tại.
+
+### Cấu hình
+
+- `set(request: ApiDefaultValue): this` — Thiết lập dữ liệu mặc định cho tất cả các yêu cầu trong tương lai.
 
+## Các kiểu dữ liệu
 
+#### `ApiDefaultValue`
+Một đối tượng thuần túy đại diện cho các tham số mặc định.
+- `[key: string]: any` — Các cặp khóa-giá trị được sử dụng làm mặc định.

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

@@ -6,6 +6,8 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 A class for managing and merging HTTP request headers. It handles default application-wide headers, custom headers for specific requests, and default `Content-Type` assignment.
 
+> `ApiHeaders` is an **auxiliary class**, designed for managing HTTP headers. In most cases, it is recommended to define global headers through the `headers` parameter in the global `Api` configuration.
+
 ## Key Features
 
 - **Default Headers** — set global headers like `Authorization` or `X-App-Version` once.
@@ -13,25 +15,37 @@ A class for managing and merging HTTP request headers. It handles default applic
 - **Safe Merging** — merges multiple header sources without mutating the original objects.
 - **Validation** — ensures only valid objects are processed as headers.
 
-## Initialization
+## Methods
 
-To initialize the object, call the `ApiHeaders()` constructor.
+### Action
 
-```typescript
-import { ApiHeaders } from '@dxtmisha/functional'
+#### `get`
 
-// 1. Simple initialization
-const apiHeaders = new ApiHeaders()
+Intersects default headers with custom ones and injects `Content-Type`. If the `value` parameter is `null`, headers are disabled.
 
-// 2. Setting default headers
-apiHeaders.set({ 'X-App-Platform': 'web' })
+**Parameters:**
+- `value?: Record<string, string> | null` — Custom headers to merge with defaults.
+- `type: string | undefined | null` — The `Content-Type` to set (defaults to `application/json;charset=UTF-8`).
 
-// 3. Getting headers for a request
-const headers = apiHeaders.get({ 'Authorization': 'Bearer token123' })
-// Result: { 'X-App-Platform': 'web', 'Authorization': 'Bearer token123', 'Content-Type': 'application/json;charset=UTF-8' }
-```
+**Returns:** `Record<string, string> | undefined` — The merged headers object.
 
-## Methods
+#### `getByRequest`
+
+A specialized version of `get` that adjusts headers based on the request type. Specifically, it ensures `Content-Type` is not manually set for `FormData` to allow correct boundary generation.
+
+**Parameters:**
+- `request: ApiFetch['request']` — The request payload (Object, FormData, or String).
+- `value?: Record<string, string> | null` — Custom headers.
+- `type: string` — The desired `Content-Type`.
+
+**Returns:** `Record<string, string> | undefined` — The processed headers object.
+
+### Configuration
 
-- `get(value?: Record<string, string> | null, type = 'application/json;charset=UTF-8'): Record<string, string> | undefined` — Intersects default headers with custom ones and injects `Content-Type`.
 - `set(headers: Record<string, string>): this` — Sets or updates the default headers object.
+
+## Types
+
+#### `ApiHeadersValue`
+A plain object representing HTTP headers.
+- `[key: string]: string` — Key-value pairs where key is the header name and value is the header content.

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

@@ -4,34 +4,48 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс ApiHeaders
 
-Класс для управления и слияния заголовков HTTP-запросов. Он обрабатывает заголовки по умолчанию, пользовательские заголовки для конкретных запросов и автоматическое назначение `Content-Type`.
+Класс для управления и слияния заголовков HTTP-запросов. Он обрабатывает заголовки по умолчанию для всего приложения, пользовательские заголовки для конкретных запросов и автоматическое назначение `Content-Type`.
+
+> `ApiHeaders` является **вспомогательным классом**, предназначенным для управления HTTP-заголовками. В большинстве случаев рекомендуется определять глобальные заголовки через параметр `headers` в глобальной конфигурации `Api`.
 
 ## Ключевые особенности
 
-- **Заголовки по умолчанию** — установите глобальные заголовки, такие как `Authorization` или `X-App-Version`, один раз.
-- **Динамический Content-Type** — автоматически управляет заголовком `Content-Type` (по умолчанию `application/json;charset=UTF-8`).
-- **Безопасное слияние** — объединяет несколько источников заголовков без изменения исходных объектов.
-- **Валидация ввода** — гарантирует, что для заголовков используются только допустимые объекты.
+- **Заголовки по умолчанию** — Установите глобальные заголовки, такие как `Authorization` или `X-App-Version`, один раз.
+- **Динамический Content-Type** — Автоматически управляет заголовком `Content-Type` (по умолчанию `application/json;charset=UTF-8`).
+- **Безопасное слияние** — Объединяет несколько источников заголовков без изменения исходных объектов.
+- **Валидация** — Гарантирует, что для заголовков используются только допустимые объекты.
 
-## Инициализация
+## Методы
 
-Для инициализации объекта вызовите конструктор `ApiHeaders()`.
+### Действие
 
-```typescript
-import { ApiHeaders } from '@dxtmisha/functional'
+#### `get`
 
-// 1. Простая инициализация
-const apiHeaders = new ApiHeaders()
+Объединяет заголовки по умолчанию с пользовательскими и добавляет `Content-Type`. Если параметр `value` равен `null`, заголовки отключаются.
 
-// 2. Установка заголовков по умолчанию
-apiHeaders.set({ 'X-App-Platform': 'web' })
+**Параметры:**
+- `value?: Record<string, string> | null` — Пользовательские заголовки для слияния.
+- `type: string | undefined | null` — Значение `Content-Type` (по умолчанию `application/json;charset=UTF-8`).
 
-// 3. Получение заголовков для запроса
-const headers = apiHeaders.get({ 'Authorization': 'Bearer token123' })
-// Результат: { 'X-App-Platform': 'web', 'Authorization': 'Bearer token123', 'Content-Type': 'application/json;charset=UTF-8' }
-```
+**Возвращает:** `Record<string, string> | undefined` — Объект объединенных заголовков.
 
-## Методы
+#### `getByRequest`
+
+Специализированная версия метода `get`, которая корректирует заголовки в зависимости от типа запроса. В частности, она гарантирует, что `Content-Type` не устанавливается вручную для `FormData`, чтобы обеспечить корректную генерацию `boundary`.
+
+**Параметры:**
+- `request: ApiFetch['request']` — Данные запроса (Объект, FormData или Строка).
+- `value?: Record<string, string> | null` — Пользовательские заголовки.
+- `type: string` — Желаемый `Content-Type`.
+
+**Возвращает:** `Record<string, string> | undefined` — Обработанный объект заголовков.
+
+### Конфигурация
 
-- `get(value?: Record<string, string> | null, type = 'application/json;charset=UTF-8'): Record<string, string> | undefined` — Объединяет заголовки по умолчанию с пользовательскими и добавляет `Content-Type`.
 - `set(headers: Record<string, string>): this` — Устанавливает или обновляет заголовки по умолчанию.
+
+## Типы
+
+#### `ApiHeadersValue`
+Обычный объект, представляющий HTTP-заголовки.
+- `[key: string]: string` — Пары ключ-значение, где ключ — имя заголовка, а значение — содержимое заголовка.

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

@@ -6,32 +6,46 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 Một lớp để quản lý và gộp các tiêu đề (headers) yêu cầu HTTP. Nó xử lý các tiêu đề mặc định cho toàn bộ ứng dụng, tiêu đề tùy chỉnh cho các yêu cầu cụ thể và việc tự động gán `Content-Type`.
 
+> `ApiHeaders` là một **lớp bổ trợ** (auxiliary class), được thiết kế để quản lý các tiêu đề HTTP. Trong hầu hết các trường hợp, bạn nên định nghĩa các tiêu đề toàn cục thông qua tham số `headers` trong cấu hình `Api` toàn cục.
+
 ## Các tính năng chính
 
-- **Tiêu đề mặc định** — thiết lập các tiêu đề chung một lần duy nhất, ví dụ như `Authorization` hoặc `X-App-Version`.
-- **Content-Type Động** — tự động quản lý tiêu đề `Content-Type` (mặc định là `application/json;charset=UTF-8`).
-- **Gộp an toàn** — gộp nhiều nguồn tiêu đề khác nhau mà không làm thay đổi các đối tượng gốc.
-- **Xác thực đầu vào** — đảm bảo chỉ các đối tượng hợp lệ mới được xử lý dưới dạng tiêu đề.
+- **Tiêu đề mặc định** — Thiết lập các tiêu đề chung một lần duy nhất, ví dụ như `Authorization` hoặc `X-App-Version`.
+- **Content-Type động** — Tự động quản lý tiêu đề `Content-Type` (mặc định là `application/json;charset=UTF-8`).
+- **Gộp an toàn** — Gộp nhiều nguồn tiêu đề khác nhau mà không làm thay đổi các đối tượng gốc.
+- **Xác thực** — Đảm bảo chỉ các đối tượng hợp lệ mới được xử lý dưới dạng tiêu đề.
 
-## Khởi tạo
+## Các phương thức
 
-Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `ApiHeaders()`.
+### Hành động
 
-```typescript
-import { ApiHeaders } from '@dxtmisha/functional'
+#### `get`
 
-// 1. Khởi tạo đơn giản
-const apiHeaders = new ApiHeaders()
+Giao thoa tiêu đề mặc định với những tiêu đề tùy chỉnh và tiêm `Content-Type`. Nếu tham số `value` là `null`, các tiêu đề sẽ bị tắt.
 
-// 2. Thiết lập các tiêu đề mặc định
-apiHeaders.set({ 'X-App-Platform': 'web' })
+**Tham số:**
+- `value?: Record<string, string> | null` — Các tiêu đề tùy chỉnh để gộp với mặc định.
+- `type: string | undefined | null` — Giá trị `Content-Type` (mặc định là `application/json;charset=UTF-8`).
 
-// 3. Lấy các tiêu đề cho yêu cầu
-const headers = apiHeaders.get({ 'Authorization': 'Bearer token123' })
-// Kết quả: { 'X-App-Platform': 'web', 'Authorization': 'Bearer token123', 'Content-Type': 'application/json;charset=UTF-8' }
-```
+**Trả về:** `Record<string, string> | undefined` — Đối tượng tiêu đề đã được gộp.
 
-## Các phương thức
+#### `getByRequest`
+
+Một phiên bản chuyên biệt của `get` để điều chỉnh tiêu đề dựa trên loại yêu cầu. Cụ thể, nó đảm bảo `Content-Type` không được thiết lập thủ công cho `FormData` để cho phép tạo boundary chính xác.
+
+**Tham số:**
+- `request: ApiFetch['request']` — Dữ liệu yêu cầu (Đối tượng, FormData hoặc Chuỗi).
+- `value?: Record<string, string> | null` — Các tiêu đề tùy chỉnh.
+- `type: string` — `Content-Type` mong muốn.
+
+**Trả về:** `Record<string, string> | undefined` — Đối tượng tiêu đề đã được xử lý.
+
+### Cấu hình
+
+- `set(headers: Record<string, string>): this` — Thiết lập hoặc cập nhật đối tượng tiêu đề mặc định.
+
+## Các kiểu dữ liệu
 
-- `get(value?: Record<string, string> | null, type = 'application/json;charset=UTF-8'): Record<string, string> | undefined` — Giao thoa tiêu đề mặc định với những tiêu đề tùy chỉnh được truyền vào và tiêm `Content-Type`.
-- `set(headers: Record<string, string>): this` — Thiết lập hoặc cập nhật mảng đối tượng tiêu đề mặc định.
+#### `ApiHeadersValue`
+Một đối tượng thuần túy đại diện cho các tiêu đề HTTP.
+- `[key: string]: string` — Các cặp khóa-giá trị trong đó khóa là tên tiêu đề và giá trị là nội dung tiêu đề.

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

@@ -0,0 +1,56 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ApiHydration - API Data Hydration'/>
+
+# ApiHydration Class
+
+A class for collecting API data for hydration on the client side during SSR (Server-Side Rendering). It allows the server to capture API responses during the initial render and pass them to the client, preventing redundant network requests when the application initializes in the browser.
+
+> `ApiHydration` is an **auxiliary class**, designed for SSR data management. In most cases, it is recommended to interact with hydration through the global `Api` object using methods like `Api.getHydrationScript()`.
+
+## Key Features
+
+- **SSR Optimization** — reduces the number of requests after the page loads by reusing server-side data.
+- **Data Capture** — automatically collects successful API responses marked for global use.
+- **HTML Embedding** — generates a safe `<script>` tag with JSON-serialized data for embedding in the document.
+- **Client Synchronization** — allows `ApiResponse` to load hydrated data automatically on the client side.
+
+## Methods
+
+### Action
+
+#### `toClient`
+
+Saves the API response for client-side hydration. This method only executes on the server and only for requests where `global` is set to true.
+
+**Parameters:**
+- `apiFetch: ApiFetch` — The API request configuration.
+- `response: T` — The data payload to be hydrated on the client.
+
+#### `toString`
+
+Returns a string representation of the captured hydration data, wrapped in a safe `<script>` tag with a unique ID.
+
+**Returns:** `string` — The formatted HTML script tag.
+
+### Configuration
+
+- `initResponse(response: ApiResponse): void` — Initializes the `ApiResponse` instance with hydration data if running in a DOM environment.
+
+## Types
+
+#### `ApiHydrationList`
+A list of captured API responses for hydration.
+- `path: string` — The API endpoint path.
+- `method: ApiMethodItem` — The HTTP method used.
+- `request: any` — The request payload.
+- `response: any` — The server response data.
+- `global?: boolean` — Global usage flag.
+
+## Guide: Hydration Mechanics
+
+The following rules and conditions define how the hydration system captures and transfers data between the server and the browser:
+
+- **Global Flag** — only requests where the `global` property is set to `true` in the configuration are captured for hydration.
+- **Automatic Handling** — the `global` flag is automatically set to `true` for all `GET` requests. Other methods require explicit manual enabling.
+- **Server Execution** — data capture occurs exclusively on the server side (where `isDomRuntime()` is false).

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

@@ -0,0 +1,56 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ApiHydration - Гидратация данных API'/>
+
+# Класс ApiHydration
+
+Класс для сбора данных API для гидратации на стороне клиента во время SSR (Server-Side Rendering). Он позволяет серверу захватывать ответы API во время начальной отрисовки и передавать их клиенту, предотвращая избыточные сетевые запросы при инициализации приложения в браузере.
+
+> `ApiHydration` является **вспомогательным классом**, предназначенным для управления данными SSR. В большинстве случаев рекомендуется взаимодействовать с гидратацией через глобальный объект `Api`, используя такие методы, как `Api.getHydrationScript()`.
+
+## Ключевые особенности
+
+- **Оптимизация SSR** — сокращает количество запросов после загрузки страницы за счет повторного использования серверных данных.
+- **Захват данных** — автоматически собирает успешные ответы API, помеченные для глобального использования.
+- **Внедрение в HTML** — генерирует безопасный тег `<script>` с JSON-сериализованными данными для вставки в документ.
+- **Синхронизация с клиентом** — позволяет `ApiResponse` автоматически загружать гидрированные данные на стороне клиента.
+
+## Методы
+
+### Действие
+
+#### `toClient`
+
+Сохраняет ответ API для гидратации на стороне клиента. Этот метод выполняется только на сервере и только для запросов, где `global` установлен в true.
+
+**Параметры:**
+- `apiFetch: ApiFetch` — Конфигурация запроса API.
+- `response: T` — Данные ответа, которые будут переданы клиенту.
+
+#### `toString`
+
+Возвращает строковое представление захваченных данных гидратации, обернутое в безопасный тег `<script>` с уникальным ID.
+
+**Возвращает:** `string` — Отформатированный HTML-тег скрипта.
+
+### Конфигурация
+
+- `initResponse(response: ApiResponse): void` — Инициализирует экземпляр `ApiResponse` данными гидратации, если код выполняется в среде DOM.
+
+## Типы
+
+#### `ApiHydrationList`
+Список захваченных ответов API для гидратации.
+- `path: string` — Путь эндпоинта API.
+- `method: ApiMethodItem` — Используемый HTTP-метод.
+- `request: any` — Данные запроса.
+- `response: any` — Данные ответа сервера.
+- `global?: boolean` — Флаг глобального использования.
+
+## Руководство: Механика гидратации
+
+Следующие правила и условия определяют, как система гидратации захватывает и передает данные между сервером и браузером:
+
+- **Флаг global** — захватываются только те запросы, у которых свойство `global` в конфигурации установлено в `true`.
+- **Автоматическая обработка** — флаг `global` автоматически устанавливается в `true` для всех `GET`-запросов. Другие методы требуют явного включения вручную.
+- **Серверное выполнение** — захват данных происходит исключительно на стороне сервера (где `isDomRuntime()` возвращает false).

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

@@ -0,0 +1,55 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ApiHydration - Giảm tải dữ liệu API'/>
+
+# Lớp ApiHydration
+
+Một lớp để thu thập dữ liệu API cho việc "hydrat hóa" (hydration) phía máy khách trong quá trình SSR (Server-Side Rendering). Nó cho phép máy chủ ghi lại các phản hồi API trong lần render đầu tiên và chuyển chúng đến máy khách, ngăn chặn các yêu cầu mạng dư thừa khi ứng dụng khởi tạo trong trình duyệt.
+
+> `ApiHydration` là một **lớp bổ trợ** (auxiliary class), được thiết kế để quản lý dữ liệu SSR. Trong hầu hết các trường hợp, bạn nên tương tác với việc hydrat hóa thông qua đối tượng `Api` toàn cục bằng các phương thức như `Api.getHydrationScript()`.
+
+## Các tính năng chính
+
+- **Tối ưu hóa SSR** — giảm số lượng yêu cầu sau khi tải trang bằng cách sử dụng lại dữ liệu từ phía máy chủ.
+- **Thu thập dữ liệu** — tự động thu thập các phản hồi API thành công được đánh dấu để sử dụng toàn cục.
+- **Nhúng HTML** — tạo một thẻ `<script>` an toàn với dữ liệu đã được JSON-serial hóa để nhúng vào tài liệu.
+- **Đồng bộ hóa máy khách** — cho phép `ApiResponse` tự động tải dữ liệu đã hydrat hóa ở phía máy khách.
+
+## Các phương thức
+
+### Hành động
+
+#### `toClient`
+
+Lưu phản hồi API để hydrat hóa phía máy khách. Phương thức này chỉ thực thi trên máy chủ và chỉ dành cho các yêu cầu đã đặt `global` là true.
+
+**Tham số:**
+- `apiFetch: ApiFetch` — Cấu hình yêu cầu API.
+- `response: T` — Dữ liệu phản hồi sẽ được chuyển đến máy khách.
+
+#### `toString`
+
+Trả về chuỗi đại diện cho dữ liệu hydrat hóa đã thu thập, được bọc trong một thẻ `<script>` an toàn với ID duy nhất.
+
+**Trả về:** `string` — Thẻ script HTML đã được định dạng.
+
+### Cấu hình
+
+- `initResponse(response: ApiResponse): void` — Khởi tạo thực thể `ApiResponse` với dữ liệu hydrat hóa nếu đang chạy trong môi trường DOM.
+
+## Các kiểu dữ liệu
+
+#### `ApiHydrationList`
+Danh sách các phản hồi API đã thu thập để hydrat hóa.
+- `path: string` — Đường dẫn endpoint API.
+- `method: ApiMethodItem` — Phương thức HTTP đã sử dụng.
+- `request: any` — Dữ liệu yêu cầu.
+- `response: any` — Dữ liệu phản hồi từ máy chủ.
+
+## Hướng dẫn: Cơ chế Hydrat hóa
+
+Các quy tắc và điều kiện sau đây xác định cách hệ thống hydrat hóa thu thập và chuyển dữ liệu giữa máy chủ và trình duyệt:
+
+- **Cờ toàn cục** — chỉ các yêu cầu có thuộc tính `global` được đặt thành `true` mới được ghi lại để hydrat hóa.
+- **Xử lý tự động** — cờ `global` được tự động đặt thành `true` cho tất cả các yêu cầu `GET`. Các phương thức khác yêu cầu bật thủ công.
+- **Thực thi phía máy chủ** — việc thu thập dữ liệu chỉ xảy ra ở phía máy chủ (nơi `isDomRuntime()` trả về false).