@dxtmisha/wiki 0.39.6 → 0.39.8

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

@@ -0,0 +1,78 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/MetaStatic - Управление мета-тегами (Static)'/>
+
+# Класс MetaStatic
+
+Класс `MetaStatic` является **статической точкой входа** для управления мета-тегами страницы, данными Open Graph (OG) и Twitter Card. Он представляет собой статическую обертку над глобально управляемым экземпляром `Meta`, предоставляя удобный синглтон-интерфейс для SEO и социальных сетей.
+
+## Ключевые особенности
+
+- **Статический интерфейс** — управление заголовками, описаниями и другими данными без необходимости ручного создания экземпляров.
+- **Единое управление** — автоматическая синхронизация заголовков и другой информации между стандартными мета-тегами, OG и Twitter.
+- **Изоляция в SSR** — использует `ServerStorage` для обеспечения изоляции данных между запросами во время рендеринга на стороне сервера.
+- **Fluent API** — поддержка цепочки вызовов (method chaining) в методах установки.
+
+## Методы
+
+### Доступ
+
+- `getItem(): Meta` — Возвращает базовый экземпляр класса `Meta`.
+- `getOg(): MetaOg` — Получает экземпляр `MetaOg` для расширенных операций с Open Graph.
+- `getTwitter(): MetaTwitter` — Получает экземпляр `MetaTwitter` для расширенных операций с Twitter Card.
+
+### Получение (Getters)
+
+- `getTitle(): string` — Возвращает текущий заголовок (без суффикса).
+- `getDescription(): string` — Возвращает содержимое мета-тега description.
+- `getKeywords(): string` — Возвращает список ключевых слов.
+- `getImage(): string` — Возвращает URL изображения (из настроек OG).
+- `getCanonical(): string` — Возвращает канонический URL.
+- `getRobots(): MetaRobots` — Возвращает текущую директиву robots.
+- `getAuthor(): string` — Возвращает имя автора.
+- `getSiteName(): string` — Возвращает название сайта (из настроек OG).
+- `getLocale(): string` — Возвращает локаль (из настроек OG).
+
+### Установка (Setters)
+
+Все методы установки возвращают `typeof MetaStatic` для поддержки цепочки вызовов.
+
+- `setTitle(title: string): typeof MetaStatic` — Устанавливает заголовок страницы и обновляет заголовки OG/Twitter.
+- `setDescription(description: string): typeof MetaStatic` — Устанавливает мета-тег description.
+- `setKeywords(keywords: string | string[]): typeof MetaStatic` — Устанавливает ключевые слова (строка или массив).
+- `setImage(image: string): typeof MetaStatic` — Устанавливает изображение для OG и Twitter.
+- `setCanonical(canonical: string): typeof MetaStatic` — Устанавливает канонический URL и обновляет URL для OG/Twitter.
+- `setRobots(robots: MetaRobots): typeof MetaStatic` — Устанавливает директиву robots.
+- `setAuthor(author: string): typeof MetaStatic` — Устанавливает мета-тег author.
+- `setSiteName(siteName: string): typeof MetaStatic` — Устанавливает название сайта для OG и Twitter.
+- `setLocale(locale: string): typeof MetaStatic` — Устанавливает локаль для Open Graph.
+- `setSuffix(suffix?: string): typeof MetaStatic` — Устанавливает суффикс (например, " | Мой Сайт"), добавляемый к заголовкам.
+
+### Вывод
+
+- `html(): string` — Генерирует полную строку HTML-тегов для всех управляемых свойств.
+
+## Архитектура
+
+`MetaStatic` работает как **статический прокси**. Все вызовы методов перенаправляются на внутренний экземпляр `Meta`, который управляется через `ServerStorage`.
+
+### Изоляция запросов (SSR)
+
+Благодаря использованию `ServerStorage`, `MetaStatic` гарантирует, что при рендеринге на стороне сервера (SSR) информация одного запроса не попадет в другой. Каждый запрос получает свой изолированный контекст.
+
+### Примеры
+
+```typescript
+import { MetaStatic } from '@dxtmisha/functional-basic';
+
+MetaStatic
+  .setSuffix('Мой Интернет Магазин')
+  .setTitle('Летняя коллекция')
+  .setDescription('Ознакомьтесь с нашими новинками.')
+  .setImage('https://example.com/cover.jpg')
+  .setLocale('ru_RU');
+
+console.log(MetaStatic.getTitle()); // "Летняя коллекция"
+document.title; // "Летняя коллекция - Мой Интернет Магазин"
+```
+

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

@@ -0,0 +1,78 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/MetaStatic - Quản lý Meta Tags (Static)'/>
+
+# Class MetaStatic
+
+Lớp `MetaStatic` là **điểm truy cập tĩnh** để quản lý các thẻ meta của trang, dữ liệu Open Graph (OG) và Twitter Card. Nó hoạt động như một lớp vỏ bọc tĩnh (static wrapper) xung quanh một thực thể `Meta` được quản lý toàn cục, cung cấp một giao diện singleton sạch sẽ để quản lý SEO và chia sẻ mạng xã hội.
+
+## Các tính năng chính
+
+- **Giao diện tĩnh** — Quản lý tiêu đề trang, mô tả và nhiều thứ khác mà không cần khởi tạo thủ công.
+- **Quản lý thống nhất** — Tự động đồng bộ hóa tiêu đề và các thông tin khác trên các thẻ meta tiêu chuẩn, OG và Twitter.
+- **Cách ly trong SSR** — Sử dụng `ServerStorage` để xử lý cách ly thực thể trong quá trình render phía máy chủ (server-side rendering).
+- **Fluent API** — Hỗ trợ kỹ thuật method chaining cho các phương thức thiết lập (setter).
+
+## Các phương thức
+
+### Truy cập
+
+- `getItem(): Meta` — Trả về thực thể `Meta` cơ sở.
+- `getOg(): MetaOg` — Lấy thực thể `MetaOg` cho các thao tác Open Graph nâng cao.
+- `getTwitter(): MetaTwitter` — Lấy thực thể `MetaTwitter` cho các thao tác Twitter Card nâng cao.
+
+### Lấy dữ liệu (Getters)
+
+- `getTitle(): string` — Lấy tiêu đề trang hiện tại (không bao gồm hậu tố).
+- `getDescription(): string` — Lấy nội dung thẻ meta description.
+- `getKeywords(): string` — Lấy các từ khóa hiện tại.
+- `getImage(): string` — Lấy URL hình ảnh (từ cài đặt OG).
+- `getCanonical(): string` — Lấy URL chuẩn (canonical).
+- `getRobots(): MetaRobots` — Lấy chỉ thị robots hiện tại.
+- `getAuthor(): string` — Lấy tên tác giả.
+- `getSiteName(): string` — Lấy tên trang web (từ cài đặt OG).
+- `getLocale(): string` — Lấy mã ngôn ngữ/khu vực (từ cài đặt OG).
+
+### Thiết lập (Setters)
+
+Tất cả các phương thức thiết lập đều trả về `typeof MetaStatic` để hỗ trợ method chaining.
+
+- `setTitle(title: string): typeof MetaStatic` — Thiết lập tiêu đề trang và cập nhật tiêu đề OG/Twitter.
+- `setDescription(description: string): typeof MetaStatic` — Thiết lập thẻ meta description.
+- `setKeywords(keywords: string | string[]): typeof MetaStatic` — Thiết lập từ khóa (chuỗi hoặc mảng).
+- `setImage(image: string): typeof MetaStatic` — Thiết lập hình ảnh cho OG và Twitter.
+- `setCanonical(canonical: string): typeof MetaStatic` — Thiết lập URL chuẩn và cập nhật URL cho OG/Twitter.
+- `setRobots(robots: MetaRobots): typeof MetaStatic` — Thiết lập chỉ thị robots.
+- `setAuthor(author: string): typeof MetaStatic` — Thiết lập thẻ meta author.
+- `setSiteName(siteName: string): typeof MetaStatic` — Thiết lập tên trang web cho OG và Twitter.
+- `setLocale(locale: string): typeof MetaStatic` — Thiết lập mã ngôn ngữ cho Open Graph.
+- `setSuffix(suffix?: string): typeof MetaStatic` — Thiết lập hậu tố (ví dụ: " | My Site") được thêm vào cuối tiêu đề.
+
+### Đầu ra
+
+- `html(): string` — Tạo ra một chuỗi đầy đủ các thẻ HTML meta cho tất cả các thuộc tính được quản lý.
+
+## Kiến trúc
+
+`MetaStatic` hoạt động như một **proxy tĩnh**. Tất cả các cuộc gọi phương thức được chuyển tiếp đến một thực thể `Meta` nội bộ được quản lý thông qua `ServerStorage`.
+
+### Cách ly yêu cầu (SSR)
+
+Bằng cách sử dụng `ServerStorage`, `MetaStatic` đảm bảo rằng trong quá trình Render phía máy chủ (SSR), thông tin meta của một yêu cầu không bị rò rỉ sang yêu cầu khác. Mỗi yêu cầu có một bối cảnh cách ly riêng.
+
+### Ví dụ
+
+```typescript
+import { MetaStatic } from '@dxtmisha/functional-basic';
+
+MetaStatic
+  .setSuffix('Cửa hàng trực tuyến của tôi')
+  .setTitle('Bộ sưu tập mùa hè')
+  .setDescription('Khám phá các sản phẩm mới nhất của chúng tôi.')
+  .setImage('https://example.com/cover.jpg')
+  .setLocale('vi_VN');
+
+console.log(MetaStatic.getTitle()); // "Bộ sưu tập mùa hè"
+document.title; // "Bộ sưu tập mùa hè - Cửa hàng trực tuyến của tôi"
+```
+

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

@@ -0,0 +1,50 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ResumableTimer - Pausable Timer'/>
+
+# ResumableTimer Class
+
+A class for creating a timer that can be paused, resumed, reset, and cleared. It is useful for UI elements that need to track elapsed time even when interrupted, such as progress bars, auto-closing notifications, or slides.
+
+## Key Features
+
+- **Pause & Resume** — stop the countdown and continue later from the exact millisecond where it left off.
+- **Completion Tracking** — explicitly tracks if the timer has finished its execution.
+- **Robust Logic** — handles edge cases like resuming when time has already elapsed.
+- **Fluent Interface** — methods return `this`, allowing for method chaining.
+
+## Initialization
+
+To initialize the object, call the constructor `ResumableTimer(callback, delay, blockStart)`.
+
+**Parameters:**
+- `callback: FunctionVoid` — the function to be called after the delay.
+- `delay: number = 320` — delay in milliseconds.
+- `blockStart: boolean = false` — if true, the timer will not start immediately.
+
+```typescript
+import { ResumableTimer } from '@dxtmisha/functional-basic'
+
+// 1. Basic initialization (starts immediately)
+const timer = new ResumableTimer(() => {
+  console.log('Timer finished!')
+}, 5000)
+
+// 2. Initialization without starting
+const delayedTimer = new ResumableTimer(
+  () => console.log('Task started!'),
+  3000,
+  true
+)
+
+delayedTimer.resume() // Start it manually
+```
+
+## Methods
+
+### Management
+
+- `resume(): this` — Starts or resumes the timer.
+- `pause(): this` — Pauses the timer and calculates the remaining time.
+- `reset(): this` — Completely clears the current state and restarts the timer with the original delay.
+- `clear(): this` — Completely stops the timer and resets all internal states.

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

@@ -0,0 +1,50 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ResumableTimer - Таймер с паузой'/>
+
+# Класс ResumableTimer
+
+Класс для создания таймера, который можно приостанавливать, возобновлять, сбрасывать и очищать. Он полезен для элементов интерфейса, которым необходимо отслеживать прошедшее время даже при прерывании, таких как прогресс-бары, автоматически закрывающиеся уведомления или слайды.
+
+## Ключевые особенности
+
+- **Пауза и возобновление** — останавливает обратный отсчет и продолжает его позже с точностью до миллисекунды.
+- **Отслеживание завершения** — явно отслеживает, закончил ли таймер свое выполнение.
+- **Надежная логика** — обрабатывает крайние случаи, такие как возобновление, когда время уже истекло.
+- **Fluent Interface** — методы возвращают `this`, что позволяет использовать цепочки вызовов.
+
+## Инициализация
+
+Для инициализации объекта вызовите конструктор `ResumableTimer(callback, delay, blockStart)`.
+
+**Параметры:**
+- `callback: FunctionVoid` — функция, которая будет вызвана после задержки.
+- `delay: number = 320` — задержка в миллисекундах.
+- `blockStart: boolean = false` — если true, таймер не запустится сразу.
+
+```typescript
+import { ResumableTimer } from '@dxtmisha/functional-basic'
+
+// 1. Базовая инициализация (запускается сразу)
+const timer = new ResumableTimer(() => {
+  console.log('Таймер завершен!')
+}, 5000)
+
+// 2. Инициализация без немедленного запуска
+const delayedTimer = new ResumableTimer(
+  () => console.log('Задача запущена!'),
+  3000,
+  true
+)
+
+delayedTimer.resume() // Запуск вручную
+```
+
+## Методы
+
+### Управление
+
+- `resume(): this` — Запускает или возобновляет таймер.
+- `pause(): this` — Приостанавливает таймер и вычисляет оставшееся время.
+- `reset(): this` — Полностью сбрасывает текущее состояние и перезапускает таймер с исходной задержкой.
+- `clear(): this` — Полностью останавливает таймер и сбрасывает все внутренние состояния.

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

@@ -0,0 +1,50 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ResumableTimer - Bộ hẹn giờ có thể tạm dừng'/>
+
+# Lớp ResumableTimer
+
+Lớp chuyên dùng để tạo bộ hẹn giờ có thể tạm dừng, tiếp tục, thiết lập lại và xóa bỏ. Nó hữu ích cho các thành phần giao diện người dùng cần theo dõi thời gian đã trôi qua ngay cả khi bị gián đoạn, chẳng hạn như thanh tiến trình, thông báo tự động đóng hoặc các slide.
+
+## Các tính năng chính
+
+- **Tạm dừng & Tiếp tục** — dừng đếm ngược và tiếp tục sau đó từ chính xác mili giây đã dừng lại.
+- **Theo dõi hoàn thành** — theo dõi rõ ràng xem bộ hẹn giờ đã kết thúc thực thi hay chưa.
+- **Logic mạnh mẽ** — xử lý các trường hợp biên như tiếp tục khi thời gian đã trôi qua hết.
+- **Giao diện mượt mà (Fluent Interface)** — các phương thức trả về `this`, cho phép gọi chuỗi phương thức.
+
+## Khởi tạo
+
+Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `ResumableTimer(callback, delay, blockStart)`.
+
+**Tham số:**
+- `callback: FunctionVoid` — hàm sẽ được gọi sau khoảng thời gian trễ.
+- `delay: number = 320` — thời gian trễ tính bằng mili giây.
+- `blockStart: boolean = false` — nếu là true, bộ hẹn giờ sẽ không bắt đầu ngay lập tức.
+
+```typescript
+import { ResumableTimer } from '@dxtmisha/functional-basic'
+
+// 1. Khởi tạo cơ bản (bắt đầu ngay lập tức)
+const timer = new ResumableTimer(() => {
+  console.log('Hết giờ!')
+}, 5000)
+
+// 2. Khởi tạo không bắt đầu ngay
+const delayedTimer = new ResumableTimer(
+  () => console.log('Nhiệm vụ bắt đầu!'),
+  3000,
+  true
+)
+
+delayedTimer.resume() // Bắt đầu thủ công
+```
+
+## Các phương thức
+
+### Quản lý
+
+- `resume(): this` — Bắt đầu hoặc tiếp tục bộ hẹn giờ.
+- `pause(): this` — Tạm dừng bộ hẹn giờ và tính toán thời gian còn lại.
+- `reset(): this` — Xóa hoàn toàn trạng thái hiện tại và khởi động lại với độ trễ ban đầu.
+- `clear(): this` — Dừng hoàn toàn bộ hẹn giờ và thiết lập lại tất cả các trạng thái nội bộ.

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

@@ -0,0 +1,131 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ServerStorage - Data Isolation in SSR'/>
+
+# ServerStorage Class
+
+`ServerStorage` is a mechanism for managing **isolated global state** in applications with SSR (Server-Side Rendering) support.
+
+The class allows you to work with data as easily as with static variables, but ensures that user data on the server does not intermingle between parallel requests.
+
+## Key Features
+
+- **Request Isolation** — data on the server is bound to the context of the current human or machine request.
+- **Hydration** — ability to automatically transfer state from the server to the client via JSON.
+- **Security** — automatic XSS escaping during data transfer.
+
+```typescript
+import { ServerStorage } from '@dxtmisha/functional-basic'
+
+// Save data with a hydration flag (will be available on the client)
+ServerStorage.set('theme', () => 'dark', true)
+
+// Retrieve data
+const theme = ServerStorage.get('theme') // 'dark'
+```
+
+## Data Access Methods
+
+### `get`
+
+Retrieves a value by key. If it doesn't exist, creates it using the default value factory.
+
+**Parameters:**
+- `key: string` — unique storage key.
+- `defaultValue?: () => T` — function that returns the default value if not found.
+- `hydration: boolean` — if `true`, the value will be included in the JSON for the client (default: `false`).
+
+**Returns:** `T`
+
+### `set`
+
+Saves a value to the storage.
+
+**Parameters:**
+- `key: string` — unique storage key.
+- `value: () => T` — function that returns the value to save.
+- `hydration: boolean` — if `true`, the value will be included in the JSON for the client (default: `false`).
+
+**Returns:** `T`
+
+## Utility & Lifecycle Methods
+
+- `init(listener: () => Record<string, any>): typeof ServerStorage` — Initializes the storage with a context listener. On the server, this listener should return an object unique to each request.
+- `has(key: string): boolean` — Checks for the existence of a key in the current context.
+- `reset(): void` — Resets the storage, clearing all stored data and the listener. Useful for performing cleanup.
+- `toString(): string` — Generates an HTML `<script type="application/json">` tag containing all data marked for hydration.
+
+## Isolation in SSR
+
+In standard client-side applications, global state belongs to a single user. However, in an SSR environment, one Node.js process handles many concurrent requests simultaneously. To prevent user data from "leaking" between these requests (State Pollution), `ServerStorage` must be correctly isolated.
+
+To achieve this, you must initialize `ServerStorage` with the `init` method. This method accepts a listener function that returns a data object unique to the current request context.
+
+> Important: Correct isolation is critical for security. If not configured, data from one user could be served to another.
+
+### Node.js (AsyncLocalStorage)
+
+The recommended way for Node.js is to use `AsyncLocalStorage` to store context throughout an asynchronous request.
+
+```typescript
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { ServerStorage } from '@dxtmisha/functional-basic'
+
+const als = new AsyncLocalStorage<Record<string, any>>()
+
+// Initialization
+ServerStorage.init(() => als.getStore() || {})
+
+// Usage in server
+http.createServer((req, res) => {
+  als.run({}, () => {
+    // All calls to ServerStorage inside this block will be isolated
+    ServerStorage.set('requestId', () => req.id)
+  })
+})
+```
+
+### Nuxt / Nitro
+
+In Nuxt/Nitro, isolation is managed via the `h3` event context using `useEvent()` within a server plugin.
+
+```typescript
+// server/plugins/server-storage.ts
+import { ServerStorage } from '@dxtmisha/functional-basic'
+
+export default defineNitroPlugin(() => {
+  ServerStorage.init(() => {
+    try {
+      return useEvent().context
+    } catch {
+      return {}
+    }
+  })
+})
+```
+
+## Hydration (Transferring Data to Client)
+
+Hydration is the process of transferring the application state set on the server to the client. This allows the browser to pick up where the server left off, ensuring consistency and preventing redundant data fetching or "flickering" during page load.
+
+### 1. Identify Data for Hydration
+
+When using `set()` or `get()`, pass `true` as the third parameter (`hydration`). Only values marked this way will be transferred to the client.
+
+```typescript
+// Set on server
+ServerStorage.set('userSettings', () => ({ fontSize: 16 }), true)
+```
+
+### 2. Injecting State into HTML
+
+On the server, you must call `ServerStorage.toString()` and insert its result into your page template (usually at the very end of the `<body>` tag, before your application scripts).
+
+This method generates a special script tag:
+```html
+<script id="__ui:server:storage:id__" type="application/json">
+  {"userSettings":{"fontSize":16}}
+</script>
+```
+
+

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

@@ -0,0 +1,131 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ServerStorage - Изоляция данных в SSR'/>
+
+# Класс ServerStorage
+
+`ServerStorage` — это механизм для управления **изолированным глобальным состоянием** в приложениях с поддержкой SSR (Server-Side Rendering).
+
+Класс позволяет работать с данными так же просто, как со статическими переменными, но гарантирует, что на сервере данные разных пользователей не будут смешиваться.
+
+## Основные возможности
+
+- **Изоляция запросов** — на сервере данные привязываются к контексту текущего HTTP-запроса.
+- **Гидратация** — возможность автоматически передавать состояние с сервера на клиент через JSON.
+- **Безопасность** — автоматическое экранирование XSS при передаче данных.
+
+```typescript
+import { ServerStorage } from '@dxtmisha/functional-basic'
+
+// Сохранение данных с флагом гидратации (будут доступны на клиенте)
+ServerStorage.set('theme', () => 'dark', true)
+
+// Получение данных
+const theme = ServerStorage.get('theme') // 'dark'
+```
+
+## Методы доступа к данным
+
+### `get`
+
+Извлекает значение по ключу. Если оно не существует, создает его с помощью фабрики значений по умолчанию.
+
+**Параметры:**
+- `key: string` — уникальный ключ хранилища.
+- `defaultValue?: () => T` — функция, возвращающая значение по умолчанию, если оно не найдено.
+- `hydration: boolean` — если `true`, значение будет включено в JSON для передачи на клиент (по умолчанию: `false`).
+
+**Возвращает:** `T`
+
+### `set`
+
+Записывает значение в хранилище.
+
+**Параметры:**
+- `key: string` — уникальный ключ хранилища.
+- `value: () => T` — функция, возвращающая значение для сохранения.
+- `hydration: boolean` — если `true`, значение будет включено в JSON для передачи на клиент (по умолчанию: `false`).
+
+**Возвращает:** `T`
+
+## Вспомогательные методы и жизненный цикл
+
+- `init(listener: () => Record<string, any>): typeof ServerStorage` — Инициализирует хранилище слушателем контекста. На сервере этот слушатель должен возвращать объект, уникальный для каждого запроса.
+- `has(key: string): boolean` — Проверяет наличие ключа в текущем контексте.
+- `reset(): void` — Сбрасывает хранилище, очищая все сохраненные данные и слушателя. Полезно для выполнения очистки.
+- `toString(): string` — Генерирует HTML-тег `<script type="application/json">` со всеми данными, помеченными для гидратации.
+
+## Изоляция в SSR
+
+В обычных клиентских приложениях глобальное состояние принадлежит одному пользователю. Однако в среде SSR один процесс Node.js обрабатывает множество одновременных запросов. Чтобы данные пользователей не смешивались между собой (Загрязнение состояния), `ServerStorage` должен быть правильно изолирован.
+
+Для этого необходимо инициализировать `ServerStorage` с помощью метода `init`. Он принимает функцию-слушатель, которая возвращает объект данных, уникальный для контекста текущего запроса.
+
+> Важно: Правильная изоляция критична для безопасности. Без нее данные одного пользователя могут быть по ошибке переданы другому.
+
+### Node.js (AsyncLocalStorage)
+
+Рекомендуемый способ для Node.js — использование `AsyncLocalStorage` для сохранения контекста на протяжении асинхронного запроса.
+
+```typescript
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { ServerStorage } from '@dxtmisha/functional-basic'
+
+const als = new AsyncLocalStorage<Record<string, any>>()
+
+// Инициализация
+ServerStorage.init(() => als.getStore() || {})
+
+// Использование на сервере
+http.createServer((req, res) => {
+  als.run({}, () => {
+    // Внутри этого блока все вызовы ServerStorage будут изолированы
+    ServerStorage.set('requestId', () => req.id)
+  })
+})
+```
+
+### Nuxt / Nitro
+
+В Nuxt/Nitro изоляция управляется через контекст события `h3` с помощью `useEvent()` внутри серверного плагина.
+
+```typescript
+// server/plugins/server-storage.ts
+import { ServerStorage } from '@dxtmisha/functional-basic'
+
+export default defineNitroPlugin(() => {
+  ServerStorage.init(() => {
+    try {
+      return useEvent().context
+    } catch {
+      return {}
+    }
+  })
+})
+```
+
+## Гидратация (Передача данных клиенту)
+
+Гидратация — это процесс передачи состояния приложения, установленного на сервере, клиенту. Это позволяет браузеру «подхватить» данные там, где закончил сервер, обеспечивая согласованность и предотвращая повторные запросы данных или «мерцание» страницы при загрузке.
+
+### 1. Пометка данных для гидратации
+
+При использовании `set()` или `get()` передайте `true` третьим параметром (`hydration`). Только значения, помеченные таким образом, будут переданы на клиент.
+
+```typescript
+// Установка на сервере
+ServerStorage.set('userSettings', () => ({ fontSize: 16 }), true)
+```
+
+### 2. Вставка состояния в HTML
+
+На сервере необходимо вызвать `ServerStorage.toString()` и вставить результат в шаблон страницы (обычно в самый конец тега `<body>`, перед скриптами приложения).
+
+Этот метод генерирует специальный тег script:
+```html
+<script id="__ui:server:storage:id__" type="application/json">
+  {"userSettings":{"fontSize":16}}
+</script>
+```
+
+