@dxtmisha/wiki 0.39.8 → 0.56.0

package/src/media/functional/functional/functions/computedEternity/computedEternity.ru.mdx

@@ -8,6 +8,7 @@ import { Meta } from '@storybook/addon-docs/blocks'
 
 **Параметры:**
 - `getter: () => Promise<T> | T` — Функция, которая возвращает вычисляемое значение (может быть синхронной или асинхронной).
+- `initialState?: T` — Начальное значение результата.
 
 **Возвращает:**
 `CustomRef<T>` — Реактивное вычисляемое свойство с результатом выполнения геттера.
@@ -15,6 +16,13 @@ import { Meta } from '@storybook/addon-docs/blocks'
 ```typescript
 import { computedEternity } from '@dxtmisha/functional'
 
+// Начальное значение
+const status = computedEternity(async () => {
+  await new Promise(resolve => setTimeout(resolve, 1000))
+  return 'online'
+}, 'offline')
+// Status.value будет 'offline' до завершения выполнения геттера
+
 // Асинхронный геттер - будет вызван только при первом обращении к 'data.value'
 const data = computedEternity(async () => {
   const response = await fetch('/api/data')

package/src/media/functional/functional/functions/computedEternity/computedEternity.vi.mdx

@@ -8,6 +8,7 @@ Tạo một thuộc tính tính toán được tính toán theo yêu cầu và
 
 **Các tham số:**
 - `getter: () => Promise<T> | T` — Một hàm trả về giá trị cần tính toán (có thể là đồng bộ hoặc bất đồng bộ).
+- `initialState?: T` — Giá trị ban đầu của kết quả.
 
 **Trả về:**
 `CustomRef<T>` — Một ref tùy chỉnh phản ứng chứa kết quả đã giải quyết của getter.
@@ -15,6 +16,13 @@ Tạo một thuộc tính tính toán được tính toán theo yêu cầu và
 ```typescript
 import { computedEternity } from '@dxtmisha/functional'
 
+// Trạng thái ban đầu
+const status = computedEternity(async () => {
+  await new Promise(resolve => setTimeout(resolve, 1000))
+  return 'online'
+}, 'offline')
+// Status.value là 'offline' cho đến khi getter được giải quyết
+
 // Getter bất đồng bộ - sẽ chỉ được gọi khi 'data.value' được truy cập lần đầu tiên
 const data = computedEternity(async () => {
   const response = await fetch('/api/data')

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

@@ -38,6 +38,7 @@ Methods for performing physical network requests.
 - `setPreparation(callback): void` — Registers a hook to run before every enabled request.
 - `setEnd(callback): void` — Registers a hook to run after every enabled response.
 - `setTimeout(timeout: number): void` — Changes the global request timeout.
+- `setOrigin(origin: string): void` — Changes the origin (protocol and domain) for the base URL.
 - `setConfig(config?: ApiConfig): void` — Applies a complete configuration object.
 
 ### Auxiliary
@@ -46,6 +47,7 @@ Methods for performing physical network requests.
 - `getResponse(): ApiResponse` — Accesses the response/emulation manager.
 - `getHydration(): ApiHydration` — Accesses the hydration manager.
 - `getHydrationScript(): string` — Returns the script block for SSR-to-client hydration.
+- `getOrigin(): string` — Returns the base origin URL combined with the API path.
 - `getUrl(path: string, api?: boolean): string` — Returns the fully resolved URL with `{locale}`, `{country}`, `{language}` placeholder substitution.
 - `getBody(request, method?): string | FormData | undefined` — Prepares the request body.
 - `getBodyForGet(request, path?, method?): string` — Prepares the query string.
@@ -56,6 +58,7 @@ Methods for performing physical network requests.
 ### ApiConfig
 
 - `urlRoot: string` — the base URL for the API.
+- `origin: string` — protocol and domain for the base URL.
 - `headers: Record<string, string>` — default request headers.
 - `requestDefault: Record<string, any>` — default request data.
 - `preparation: (apiFetch: ApiFetch) => Promise<void>` — entry hook.

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

@@ -38,6 +38,7 @@ import {Meta} from '@storybook/addon-docs/blocks'
 - `setPreparation(callback): void` — Регистрирует хук, запускаемый перед каждым включенным запросом.
 - `setEnd(callback): void` — Регистрирует хук, запускаемый после каждого включенного ответа.
 - `setTimeout(timeout: number): void` — Изменяет глобальный таймаут запроса.
+- `setOrigin(origin: string): void` — Изменяет источник (протокол и домен) для базового URL.
 - `setConfig(config?: ApiConfig): void` — Применяет полный объект конфигурации.
 
 ### Вспомогательные
@@ -46,6 +47,7 @@ import {Meta} from '@storybook/addon-docs/blocks'
 - `getResponse(): ApiResponse` — Доступ к менеджеру ответов/эмуляции.
 - `getHydration(): ApiHydration` — Доступ к менеджеру гидратации.
 - `getHydrationScript(): string` — Возвращает блок скрипта для гидратации SSR-клиент.
+- `getOrigin(): string` — Возвращает базовый URL источника, объединенный с путем API.
 - `getUrl(path: string, api?: boolean): string` — Возвращает полностью разрешенный URL с подстановкой плейсхолдеров `{locale}`, `{country}`, `{language}`.
 - `getBody(request?, method?): string | FormData | undefined` — Подготавливает тело запроса.
 - `getBodyForGet(request, path?, method?): string` — Подготавливает строку запроса.
@@ -56,6 +58,7 @@ import {Meta} from '@storybook/addon-docs/blocks'
 ### ApiConfig
 
 - `urlRoot: string` — базовый URL для API.
+- `origin: string` — протокол и домен для формирования базового URL.
 - `headers: Record<string, string>` — заголовки запроса по умолчанию.
 - `requestDefault: Record<string, any>` — данные запроса по умолчанию.
 - `preparation: (apiFetch: ApiFetch) => Promise<void>` — входной хук.

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

@@ -38,6 +38,7 @@ Các phương thức để thực hiện các yêu cầu mạng vật lý.
 - `setPreparation(callback): void` — Đăng ký một hook để chạy trước mỗi yêu cầu được bật.
 - `setEnd(callback): void` — Đăng ký một hook để chạy sau mỗi phản hồi được bật.
 - `setTimeout(timeout: number): void` — Thay đổi timeout yêu cầu toàn cục.
+- `setOrigin(origin: string): void` — Thay đổi nguồn (giao thức và tên miền) cho URL base.
 - `setConfig(config?: ApiConfig): void` — Áp dụng một đối tượng cấu hình đầy đủ.
 
 ### Phụ trợ
@@ -46,6 +47,7 @@ Các phương thức để thực hiện các yêu cầu mạng vật lý.
 - `getResponse(): ApiResponse` — Truy cập trình quản lý phản hồi/mô phỏng.
 - `getHydration(): ApiHydration` — Truy cập trình quản lý hydration.
 - `getHydrationScript(): string` — Trả về khối script để hydration từ SSR sang client.
+- `getOrigin(): string` — Trả về URL base đã kết hợp với đường dẫn API.
 - `getUrl(path: string, api?: boolean): string` — Trả về URL đã được phân giải đầy đủ với các token bản địa hóa.
 - `getBody(request?, method?): string | FormData | undefined` — Chuẩn bị body yêu cầu.
 - `getBodyForGet(request, path?, method?): string` — Chuẩn bị chuỗi truy vấn (query string).
@@ -56,6 +58,7 @@ Các phương thức để thực hiện các yêu cầu mạng vật lý.
 ### ApiConfig
 
 - `urlRoot: string` — URL base cho API.
+- `origin: string` — giao thức và tên miền cho URL base.
 - `headers: Record<string, string>` — các header yêu cầu mặc định.
 - `requestDefault: Record<string, any>` — dữ liệu yêu cầu mặc định.
 - `preparation: (apiFetch: ApiFetch) => Promise<void>` — hook đầu vào (entry hook).

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

@@ -75,10 +75,12 @@ Methods to configure the API (support chaining, returning the `ApiInstance` obje
 - `setUrl(url: string): this` — Overwrites generic target URL configurations prefix points.
 - `setPreparation(callback: (apiFetch: ApiFetch) => Promise<void>): this` — Connects a custom hook function actively running just _before_ execution trigger occurs.
 - `setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): this` — Sets the hook triggered exactly _after_ network response returns.
+- `setOrigin(origin: string): this` — Sets the origin (protocol and domain) for the base URL.
 
 ### Auxiliary
 
 - `getUrl(path: string, api?: boolean): string` — Generates the full target URL referencing the script, handling `{locale}`, `{country}`, `{language}` placeholder substitution.
+- `getOrigin(): string` — Returns the base origin URL combined with the API path.
 - `getBody(request?: ApiFetch['request'], method?: string): string | FormData | undefined` — Creates data to be passed into the request physical body.
 - `getBodyForGet(request: ApiFetch['request'], path?: string, method?: string): string` — Forms query parameters specifically for HTTP arguments assigned into the URL directly used when sending `GET` queries.
 - `getHydration(): ApiHydration` — Returns the hydration manager.
@@ -107,7 +109,8 @@ Methods to configure the API (support chaining, returning the `ApiInstance` obje
 - `timeout?: number` — request timeout in milliseconds. Default: `16000`ms (only used if `controller` is not provided).
 - `controller?: AbortController` — controller for canceling the request. If provided, timeout is ignored.
 - `retry?: number` — number of retries on failure.
-- `retryDelay?: number` — base delay between retries in milliseconds. Default: `64`ms.
+- `retryDelay?: number` — base delay between retries in milliseconds. Default: `64`ms. Jitter is used to prevent thundering herd problems.
+- `endResetLimit?: number` — limit for recursive retries via `setEnd` with `reset: true`. Default: `8`.
 
 ## Response Data Structure
 
@@ -194,7 +197,7 @@ The `setEnd` method sets a callback function that is called after receiving a re
 - `apiFetch: ApiFetch` — the parameters object with which the request was performed.
 
 **Returns:** `Promise<ApiPreparationEnd>`. The result object can contain the following fields:
-- `reset?: boolean` — if set to `true`, the library will abort the current chain and **execute the request again** (recursively) after a jittered delay (see `retryDelay`). The entire process of preparation and execution will be restarted. This is used for automatic handling of refreshed access rights.
+- `reset?: boolean` — if set to `true`, the library will abort the current chain and **execute the request again** (recursively) after a jittered delay (see `retryDelay`). The entire process of preparation and execution will be restarted. This is used for automatic handling of refreshed access rights. This recursion is limited by `endResetLimit` (default: 8).
 - `data?: any` — allows you to override the data returned by the API method. If this field is specified, the standard response reading mechanism (JSON/text) will be ignored.
 
 ```javascript

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

@@ -75,10 +75,12 @@ import {Meta} from '@storybook/addon-docs/blocks'
 - `setUrl(url: string): this` — Изменяет базовый URL путь для API скриптов.
 - `setPreparation(callback: (apiFetch: ApiFetch) => Promise<void>): this` — Устанавливает хук, выполняемый перед каждым сетевым запросом.
 - `setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): this` — Устанавливает хук, выполняемый после получения ответа.
+- `setOrigin(origin: string): this` — Устанавливает источник (протокол и домен) для формирования базового URL.
 
 ### Вспомогательные
 
 - `getUrl(path: string, api?: boolean): string` — Формирует полный адрес к скрипту запроса с подстановкой плейсхолдеров `{locale}`, `{country}`, `{language}`.
+- `getOrigin(): string` — Возвращает базовый URL источника, объединенный с путем API.
 - `getBody(request?: ApiFetch['request'], method?: string): string | FormData | undefined` — Формирует данные для тела запроса.
 - `getBodyForGet(request: ApiFetch['request'], path?: string, method?: string): string` — Формирует строку query-параметров для GET-запроса.
 - `getHydration(): ApiHydration` — Возвращает менеджер гидратации.
@@ -107,7 +109,8 @@ import {Meta} from '@storybook/addon-docs/blocks'
 - `timeout?: number` — таймаут запроса в миллисекундах. По умолчанию: `16000`мс (используется только если не передан `controller`).
 - `controller?: AbortController` — контроллер для отмены запроса. Если передан, таймаут игнорируется.
 - `retry?: number` — количество повторов при сбое.
-- `retryDelay?: number` — базовая задержка между повторами в миллисекундах. По умолчанию: `64`мс.
+- `retryDelay?: number` — базовая задержка между повторами в миллисекундах. По умолчанию: `64`мс. Используется алгоритм с джиттером для предотвращения лавинообразных запросов.
+- `endResetLimit?: number` — лимит рекурсивных повторов через `setEnd` с `reset: true`. По умолчанию: `8`.
 
 ## Структура данных ответа
 
@@ -166,7 +169,7 @@ controller.abort()
 Метод `setPreparation` устанавливает callback-функцию, которая вызывается непосредственно перед отправкой запроса на сервер (до выполнения нативного `fetch`).
 
 **Особенности работы:**
-- **Очередность исполнения**: Если одновременно запускается несколько запросов, класс гарантирует, что хук подготовки будет выполнен **последовательно**. Все последующие запросы будут ждать завершения текущего хука в режиме ожидания (с интервалом опроса 160мс). Это предотвращает конфликты, например, при одновременном обновлении токена несколькими запросами.
+- **Очередность исполнения**: Если одновременно запускается несколько запросов, класс гарантирует, что хук подготовки будет выполнен **последовательно**. Все последующие запросы будут ждать завершения текущего хука в режиме ожидания (с интервалом опроса 16мс). Это предотвращает конфликты, например, при одновременном обновлении токена несколькими запросами.
 - **Параметры**: Получает объект `apiFetch`, содержащий все текущие настройки запроса. Вы можете изменять этот объект (например, добавляя заголовки или модифицируя тело запроса).
 - **Возвращает**: `Promise<void>`.
 
@@ -194,7 +197,7 @@ api.setPreparation(async (apiFetch) => {
 - `apiFetch: ApiFetch` — объект параметров, с которыми был выполнен запрос.
 
 **Возвращает:** `Promise<ApiPreparationEnd>`. Объект результата может содержать следующие поля:
-- `reset?: boolean` — если установлено в `true`, библиотека прервет текущую цепочку и **выполнит запрос заново** (рекурсивно) через рандомизированную задержку (см. `retryDelay`). Весь процесс подготовки и выполнения будет запущен повторно. Используется для автоматической обработки обновленных прав доступа.
+- `reset?: boolean` — если установлено в `true`, библиотека прервет текущую цепочку и **выполнит запрос заново** (рекурсивно) через рандомизированную задержку (см. `retryDelay`). Весь процесс подготовки и выполнения будет запущен повторно. Используется для автоматической обработки обновленных прав доступа. Лимит таких повторов ограничен параметром `endResetLimit` (по умолчанию 8).
 - `data?: any` — позволяет переопределить данные, которые вернет метод API. Если это поле указано, стандартный механизм чтения ответа (JSON/текст) будет проигнорирован.
 
 ```javascript

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

@@ -74,10 +74,12 @@ Hỗ trợ phương pháp nối chuỗi (chaining methods) trả về đối tư
 - `setUrl(url: string): this` — Ghi đè định danh URL mặc định nhánh server API.
 - `setPreparation(callback: (apiFetch: ApiFetch) => Promise<void>): this` — Thiết lập vòng lặp hook _ngay trước_ thời khắc thao tác diễn ra.
 - `setEnd(callback: (query: Response, apiFetch: ApiFetch) => Promise<ApiPreparationEnd>): this` — Thiết lập vòng lặp hook _sau_ khi tín hiệu mạng phản hồi trả về.
+- `setOrigin(origin: string): this` — Thiết lập nguồn (giao thức và tên miền) cho URL base.
 
 ### Phụ trợ
 
 - `getUrl(path: string, api?: boolean): string` — Tạo ra đường dẫn API đầy đủ, tự thay thế thẻ định danh quốc gia `{locale}`, `{country}` v.v...
+- `getOrigin(): string` — Trả về URL base đã kết hợp với đường dẫn API.
 - `getBody(request?: ApiFetch['request'], method?: string): string | FormData | undefined` — Hoán đổi tài liệu để form nạp JSON hoặc `FormData`.
 - `getBodyForGet(request: ApiFetch['request'], path?: string, method?: string): string` — Hoàn trả dữ liệu params cấu hình chuẩn cho thanh Search URL `GET`.
 
@@ -104,7 +106,8 @@ Hỗ trợ phương pháp nối chuỗi (chaining methods) trả về đối tư
 - `timeout?: number` — thời gian chờ yêu cầu tính bằng mili giây. Mặc định: `16000`ms.
 - `controller?: AbortController` — bộ điều khiển để hủy yêu cầu.
 - `retry?: number` — số lần thử lại khi thất bại.
-- `retryDelay?: number` — độ trễ cơ bản giữa các lần thử lại tính bằng mili giây. Mặc định: `64`ms.
+- `retryDelay?: number` — độ trễ cơ bản giữa các lần thử lại tính bằng mili giây. Mặc định: `64`ms. Jitter được sử dụng để ngăn chặn vấn đề thundering herd.
+- `endResetLimit?: number` — giới hạn đệ quy thử lại thông qua `setEnd` với `reset: true`. Mặc định: `8`.
 
 ## Cấu trúc dữ liệu phản hồi
 
@@ -191,7 +194,7 @@ Phương thức `setEnd` thiết lập một hàm callback được gọi sau kh
 - `apiFetch: ApiFetch` — đối tượng tham số đã dùng để thực hiện yêu cầu.
 
 **Trả về:** `Promise<ApiPreparationEnd>`. Đối tượng kết quả có thể chứa các trường sau:
-- `reset?: boolean` — nếu được đặt thành `true`, thư viện sẽ hủy chuỗi hiện tại và **thực hiện lại yêu cầu** (đệ quy) sau một khoảng trễ ngẫu nhiên (xem `retryDelay`). Toàn bộ quá trình chuẩn bị và thực thi sẽ được khởi động lại. Việc này được dùng để tự động xử lý quyền truy cập đã được làm mới.
+- `reset?: boolean` — nếu được đặt thành `true`, thư viện sẽ hủy chuỗi hiện tại và **thực hiện lại yêu cầu** (đệ quy) sau một khoảng trễ ngẫu nhiên (xem `retryDelay`). Toàn bộ quá trình chuẩn bị và thực thi sẽ được khởi động lại. Việc này được dùng để tự động xử lý quyền truy cập đã được làm mới. Quá trình đệ quy này được giới hạn bởi `endResetLimit` (mặc định: 8).
 - `data?: any` — cho phép bạn ghi đè dữ liệu mà phương thức API trả về. Nếu trường này được chỉ định, cơ chế đọc phản hồi tiêu chuẩn (JSON/văn bản) sẽ bị bỏ qua.
 
 ```javascript

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

@@ -41,6 +41,15 @@ Core engine loop that validates request configurations and executes matched rout
 
 **Returns:** `Promise<T | undefined>` — The emulated response data.
 
+#### `emulatorAsync`
+
+Synchronous version of the emulator. It returns the mock response immediately without any delay or loading state. This method only runs in DOM environments.
+
+**Parameters:**
+- `apiFetch: ApiFetch` — The properties of the request to emulate.
+
+**Returns:** `T | undefined` — The emulated response data.
+
 ### Check
 
 - `get(path: string, method: ApiMethod, request?: ApiFetch['request'], devMode?: boolean): ApiResponseItem | undefined` — Synchronously checks for a matching cached mock request.

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

@@ -41,6 +41,15 @@ const apiResponse = new ApiResponse(myApiDefault)
 
 **Возвращает:** `Promise<T | undefined>` — Данные эмулированного ответа.
 
+#### `emulatorAsync`
+
+Синхронная версия эмулятора. Возвращает мок-ответ немедленно, без задержек и состояния загрузки. Этот метод работает только в среде DOM.
+
+**Параметры:**
+- `apiFetch: ApiFetch` — Свойства запроса для эмуляции.
+
+**Возвращает:** `T | undefined` — Данные эмулированного ответа.
+
 ### Проверка
 
 - `get(path: string, method: ApiMethod, request?: ApiFetch['request'], devMode?: boolean): ApiResponseItem | undefined` — Синхронно проверяет наличие подходящего мок-запроса в кэше.

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

@@ -41,6 +41,15 @@ Vòng lặp công cụ chính để xác thực các cấu hình yêu cầu và
 
 **Trả về:** `Promise<T | undefined>` — Dữ liệu phản hồi đã giả lập.
 
+#### `emulatorAsync`
+
+Phiên bản đồng bộ của trình giả lập. Nó trả về phản hồi mock ngay lập tức mà không có bất kỳ độ trễ hoặc trạng thái tải nào. Phương thức này chỉ chạy trong môi trường DOM.
+
+**Tham số:**
+- `apiFetch: ApiFetch` — Các thuộc tính của yêu cầu cần giả lập.
+
+**Trả về:** `T | undefined` — Dữ liệu phản hồi đã giả lập.
+
 ### Kiểm tra
 
 - `get(path: string, method: ApiMethod, request?: ApiFetch['request'], devMode?: boolean): ApiResponseItem | undefined` — Kiểm tra đồng bộ một yêu cầu mock đã lưu khớp với các tham số.

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

@@ -50,7 +50,7 @@ Removes a cookie by setting an empty value and negative expiration. Equivalent t
 
 ### Configuration
 
-- `init(getListener, setListener)` — Initializes the storage with custom listeners for reading and writing data
+- `init(getListener?, getListenerRaw?, setListener?)` — Initializes the storage with custom listeners for reading and writing data. The `setListener` takes 4 arguments: `(key, value, cookie, options)`.
 - `reset()` — Resets the storage by clearing all in-memory items and removing listeners
 
 ### Auxiliary
@@ -63,9 +63,14 @@ Removes a cookie by setting an empty value and negative expiration. Equivalent t
 
 Configuration object for cookie parameters:
 
-- `age?: number` — lifetime in seconds (Max-Age attribute)
+- `age?: number` — lifetime in seconds (max-age attribute)
 - `sameSite?: 'strict' | 'lax'` — SameSite policy
-- `arguments?: string[]` — additional directives for the cookie string
+- `path?: string` — cookie path (defaults to `/`)
+- `domain?: string` — cookie domain
+- `secure?: boolean` — if true, adds the Secure attribute
+- `httpOnly?: boolean` — if true, adds the HttpOnly attribute (only for server-side listeners)
+- `partitioned?: boolean` — if true, adds the Partitioned attribute (CHIPS)
+- `arguments?: string[] | Record<string, any>` — additional directives for the cookie string
 
 ## Built-in Type Conversion
 
@@ -105,7 +110,23 @@ import { CookieStorage } from '@dxtmisha/functional-basic'
 
 CookieStorage.init(
   (key) => myStorage.get(key),
-  (key, value, options) => myStorage.set(key, value, options)
+  undefined,
+  (key, value, cookie, options) => {
+    // cookie is already formatted string like "key=value; max-age=..."
+    myStorage.set(key, value, cookie, options)
+  }
+)
+```
+
+### Initialize for SSR (Raw)
+
+```typescript
+import { CookieStorage } from '@dxtmisha/functional-basic'
+
+// For SSR, get all cookies as a raw string
+CookieStorage.init(
+  undefined,
+  () => request.headers.cookie
 )
 ```
 
@@ -131,14 +152,18 @@ import { CookieStorage } from '@dxtmisha/functional-basic'
 // Initialize with custom storage
 CookieStorage.init(
   (key) => redis.get(key),
-  (key, value, options) => redis.set(key, value, options)
+  undefined,
+  (key, value, cookie, options) => redis.set(key, value, cookie, options)
 )
 
 // Set value with options
 CookieStorage.set('user', 'john', {
   age: 3600,           // 1 hour
   sameSite: 'lax',     // SameSite policy
-  arguments: ['Secure', 'Path=/'] // Additional directives
+  path: '/',           // Path
+  secure: true,        // HTTPS only
+  httpOnly: true,      // XSS protection (for SSR)
+  arguments: ['Priority=High'] // Additional directives
 })
 
 // Get with type conversion

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

@@ -50,7 +50,7 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 ### Конфигурация
 
-- `init(getListener, setListener)` — Инициализирует хранилище с пользовательскими слушателями для чтения и записи данных
+- `init(getListener?, getListenerRaw?, setListener?)` — Инициализирует хранилище с пользовательскими слушателями для чтения и записи данных. Слушатель записи `setListener` принимает 4 аргумента: `(key, value, cookie, options)`.
 - `reset()` — Сбрасывает хранилище, очищая все элементы в памяти и удаляя слушатели
 
 ### Вспомогательные
@@ -63,9 +63,14 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 Объект конфигурации для параметров cookie:
 
-- `age?: number` — время жизни в секундах (атрибут Max-Age)
+- `age?: number` — время жизни в секундах (атрибут max-age)
 - `sameSite?: 'strict' | 'lax'` — политика SameSite
-- `arguments?: string[]` — дополнительные директивы для строки cookie
+- `path?: string` — путь для cookie (по умолчанию `/`)
+- `domain?: string` — домен для cookie
+- `secure?: boolean` — если true, добавляет атрибут Secure
+- `httpOnly?: boolean` — если true, добавляет атрибут HttpOnly (только для серверных слушателей)
+- `partitioned?: boolean` — если true, добавляет атрибут Partitioned (CHIPS)
+- `arguments?: string[] | Record<string, any>` — дополнительные директивы для строки cookie
 
 ## Встроенное преобразование типов
 
@@ -105,7 +110,23 @@ import { CookieStorage } from '@dxtmisha/functional-basic'
 
 CookieStorage.init(
   (key) => myStorage.get(key),
-  (key, value, options) => myStorage.set(key, value, options)
+  undefined,
+  (key, value, cookie, options) => {
+    // cookie - это уже отформатированная строка типа "key=value; max-age=..."
+    myStorage.set(key, value, cookie, options)
+  }
+)
+```
+
+### Инициализация для SSR (Raw)
+
+```typescript
+import { CookieStorage } from '@dxtmisha/functional-basic'
+
+// Для SSR получаем все куки в виде сырой строки
+CookieStorage.init(
+  undefined,
+  () => request.headers.cookie
 )
 ```
 
@@ -131,14 +152,18 @@ import { CookieStorage } from '@dxtmisha/functional-basic'
 // Инициализация с пользовательским хранилищем
 CookieStorage.init(
   (key) => redis.get(key),
-  (key, value, options) => redis.set(key, value, options)
+  undefined,
+  (key, value, cookie, options) => redis.set(key, value, cookie, options)
 )
 
 // Установка значения с параметрами
 CookieStorage.set('user', 'john', {
   age: 3600,           // 1 час
   sameSite: 'lax',     // Политика SameSite
-  arguments: ['Secure', 'Path=/'] // Дополнительные директивы
+  path: '/',           // Путь
+  secure: true,        // Только HTTPS
+  httpOnly: true,      // Защита от XSS (для SSR)
+  arguments: ['Priority=High'] // Дополнительные директивы
 })
 
 // Получение значения с преобразованием типа

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

@@ -50,7 +50,7 @@ Xóa cookie bằng cách đặt giá trị rỗng và thời hạn hết hạn
 
 ### Cấu hình
 
-- `init(getListener, setListener)` — Khởi tạo lưu trữ với người nghe tùy chỉnh để đọc và ghi dữ liệu
+- `init(getListener?, getListenerRaw?, setListener?)` — Khởi tạo bộ nhớ với các trình lắng nghe tùy chỉnh để đọc và ghi dữ liệu. Trình lắng nghe ghi `setListener` chấp nhận 4 đối số: `(key, value, cookie, options)`.
 - `reset()` — Đặt lại lưu trữ bằng cách xóa tất cả phần tử trong bộ nhớ và xóa người nghe
 
 ### Hỗ trợ
@@ -63,9 +63,14 @@ Xóa cookie bằng cách đặt giá trị rỗng và thời hạn hết hạn
 
 Đối tượng cấu hình cho tham số cookie:
 
-- `age?: number` — thời gian tồn tại tính bằng giây (thuộc tính Max-Age)
+- `age?: number` — thời gian tồn tại tính bằng giây (thuộc tính max-age)
 - `sameSite?: 'strict' | 'lax'` — chính sách SameSite
-- `arguments?: string[]` — các chỉ thị bổ sung cho chuỗi cookie
+- `path?: string` — đường dẫn cho cookie (mặc định là `/`)
+- `domain?: string` — tên miền cho cookie
+- `secure?: boolean` — nếu đúng, thêm thuộc tính Secure
+- `httpOnly?: boolean` — nếu đúng, thêm thuộc tính HttpOnly (chỉ dành cho trình lắng nghe phía máy chủ)
+- `partitioned?: boolean` — nếu đúng, thêm thuộc tính Partitioned (CHIPS)
+- `arguments?: string[] | Record<string, any>` — các chỉ thị bổ sung cho chuỗi cookie
 
 ## Chuyển đổi loại tích hợp
 
@@ -105,7 +110,23 @@ import { CookieStorage } from '@dxtmisha/functional-basic'
 
 CookieStorage.init(
   (key) => myStorage.get(key),
-  (key, value, options) => myStorage.set(key, value, options)
+  undefined,
+  (key, value, cookie, options) => {
+    // cookie là chuỗi đã được định dạng như "key=value; max-age=..."
+    myStorage.set(key, value, cookie, options)
+  }
+)
+```
+
+### Khởi tạo cho SSR (Raw)
+
+```typescript
+import { CookieStorage } from '@dxtmisha/functional-basic'
+
+// Đối với SSR, lấy tất cả cookie dưới dạng chuỗi thô
+CookieStorage.init(
+  undefined,
+  () => request.headers.cookie
 )
 ```
 
@@ -131,14 +152,18 @@ import { CookieStorage } from '@dxtmisha/functional-basic'
 // Khởi tạo với lưu trữ tùy chỉnh
 CookieStorage.init(
   (key) => redis.get(key),
-  (key, value, options) => redis.set(key, value, options)
+  undefined,
+  (key, value, cookie, options) => redis.set(key, value, cookie, options)
 )
 
 // Đặt giá trị với các tùy chọn
 CookieStorage.set('user', 'john', {
   age: 3600,           // 1 giờ
   sameSite: 'lax',     // Chính sách SameSite
-  arguments: ['Secure', 'Path=/'] // Các chỉ thị bổ sung
+  path: '/',           // Đường dẫn
+  secure: true,        // Chỉ HTTPS
+  httpOnly: true,      // Bảo vệ XSS (cho SSR)
+  arguments: ['Priority=High'] // Các chỉ thị bổ sung
 })
 
 // Nhận giá trị với chuyển đổi loại

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

@@ -41,6 +41,11 @@ const meta = new Meta()
 - `getOg(): MetaOg` — direct access to the `MetaOg` instance.
 - `getTwitter(): MetaTwitter` — direct access to the `MetaTwitter` instance.
 
+## Methods for Generating HTML
+
+- `html(): string` — generates the full HTML string of all meta tags: standard + Open Graph + Twitter Card. Used for SSR.
+- `htmlTitle(): string` — generates the page title.
+
 ## Setters
 
 All setters return `this` for method chaining.
@@ -74,6 +79,17 @@ const html = meta.html()
 // ...
 ```
 
+### `htmlTitle(): string`
+
+Generates the current title (including suffix).
+
+```javascript
+const meta = new Meta()
+meta.setSuffix('My Site').setTitle('Home')
+
+meta.htmlTitle() // "Home - My Site"
+```
+
 ## Example
 
 ```javascript

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

@@ -41,6 +41,11 @@ const meta = new Meta()
 - `getOg(): MetaOg` — прямой доступ к экземпляру `MetaOg`.
 - `getTwitter(): MetaTwitter` — прямой доступ к экземпляру `MetaTwitter`.
 
+## Методы для генерации HTML
+
+- `html(): string` — генерирует полную HTML-строку всех мета-тегов: стандартных + Open Graph + Twitter Card. Используется для SSR.
+- `htmlTitle(): string` — генерирует заголовок страницы.
+
 ## Сеттеры
 
 Все сеттеры возвращают `this` для цепочки вызовов.
@@ -74,6 +79,17 @@ const html = meta.html()
 // ...
 ```
 
+### `htmlTitle(): string`
+
+Генерирует текущий заголовок (включая суффикс).
+
+```javascript
+const meta = new Meta()
+meta.setSuffix('Мой Сайт').setTitle('Главная')
+
+meta.htmlTitle() // "Главная - Мой Сайт"
+```
+
 ## Пример
 
 ```javascript

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

@@ -41,9 +41,14 @@ const meta = new Meta()
 - `getOg(): MetaOg` — truy cập trực tiếp instance `MetaOg`.
 - `getTwitter(): MetaTwitter` — truy cập trực tiếp instance `MetaTwitter`.
 
+## Phương thức tạo HTML
+
+- `html(): string` — tạo chuỗi HTML đầy đủ của tất cả thẻ meta: tiêu chuẩn + Open Graph + Twitter Card. Dùng cho SSR.
+- `htmlTitle(): string` — tạo tiêu đề trang.
+
 ## Setter
 
-Tất cả setter trả về `this` để chuỗi phương thức.
+All setter trả về `this` để chuỗi phương thức.
 
 - `setTitle(title: string)` — đặt `document.title` (có hậu tố), `og:title` và `twitter:title` đồng thời.
 - `setKeywords(keywords: string | string[])` — nhận chuỗi hoặc mảng; mảng tự động nối bằng dấu phẩy.
@@ -74,6 +79,17 @@ const html = meta.html()
 // ...
 ```
 
+### `htmlTitle(): string`
+
+Tạo tiêu đề hiện tại (bao gồm cả hậu tố).
+
+```javascript
+const meta = new Meta()
+meta.setSuffix('Trang web của tôi').setTitle('Trang chủ')
+
+meta.htmlTitle() // "Trang chủ - Trang web của tôi"
+```
+
 ## Ví dụ
 
 ```javascript

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

@@ -49,3 +49,12 @@ manager.set('description', 'My description').set('keywords', 'vue, typescript')
 manager.html()
 // '<meta name="description" content="My description"><meta name="keywords" content="vue, typescript">'
 ```
+
+### `htmlTitle(title: string): string`
+
+Converts a title string into an HTML `<title>` tag.
+
+```javascript
+manager.htmlTitle('My Page Title')
+// '<title>My Page Title</title>'
+```

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

@@ -49,3 +49,12 @@ manager.set('description', 'Моё описание').set('keywords', 'vue, type
 manager.html()
 // '<meta name="description" content="Моё описание"><meta name="keywords" content="vue, typescript">'
 ```
+
+### `htmlTitle(title: string): string`
+
+Преобразует строку заголовка в HTML-тег `<title>`.
+
+```javascript
+manager.htmlTitle('Заголовок страницы')
+// '<title>Заголовок страницы</title>'
+```

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

@@ -49,3 +49,12 @@ manager.set('description', 'Mô tả của tôi').set('keywords', 'vue, typescri
 manager.html()
 // '<meta name="description" content="Mô tả của tôi"><meta name="keywords" content="vue, typescript">'
 ```
+
+### `htmlTitle(title: string): string`
+
+Chuyển đổi chuỗi tiêu đề thành thẻ HTML `<title>`.
+
+```javascript
+manager.htmlTitle('Tiêu đề trang')
+// '<title>Tiêu đề trang</title>'
+```