@dxtmisha/wiki 0.39.6 → 0.39.8

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

@@ -4,84 +4,128 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Cookie Class
 
-A seamless, stateful wrapper for managing browser cookies. It automatically syncs between memory and the `document.cookie` DOM API, allowing you to reactively set, retrieve, and delete cookies while ensuring consistent fallback values.
+A seamless wrapper for managing browser cookies. Automatically syncs between memory and the `document.cookie` DOM API, allowing reactive setting, retrieval, and deletion of cookies while ensuring consistent fallback values.
+
+Includes tight integration with `CookieStorage` for low-level management and respects global blocking via `CookieBlock`.
 
 ## Key Features
 
-- **Memory Sync** — maintains an in-memory record of cookies to prevent unnecessary DOM traversals. Automatically parses `document.cookie` on startup.
-- **Environment Aware** — detects if it is running in a DOM environment. In SSR (Server-Side Rendering) or testing (non-DOM), it elegantly degrades to memory-only storage without throwing errors.
-- **Global Blocking Control** — integrates securely with `CookieBlock`. If cookie writing is globally disabled (e.g., due to user privacy consent), the `Cookie` class respects this and suspends all outgoing DOM changes.
-- **Default/Fallback Logic** — getting a value can lazily initialize it with a default standard if it doesn't already exist.
+- **Memory Sync** — maintains an in-memory record of cookies to prevent unnecessary DOM traversals
+- **Environment Aware** — detects if running in a DOM environment. In SSR or testing, elegantly degrades to memory-only storage
+- **Global Blocking Control** — integrates securely with `CookieBlock`. If cookie writing is globally disabled, the class respects this and suspends all DOM changes
+- **Default/Fallback Logic** — getting a value can lazily initialize it with a default if it doesn't already exist
 
-## Initialization
+## Constructor
 
-To initialize the object, call the `Cookie(name)` constructor.
+A `Cookie` instance can be created to manage a specific cookie. If an instance with the same name already exists, it will be returned.
 
 **Parameters:**
-- `name: string` — the name of the cookie you want to manage.
+- `name: string` — the cookie name to manage
 
-```typescript
-import { Cookie } from '@dxtmisha/functional'
+## Methods
 
-// 1. Initialize wrapper for the 'theme' cookie
-const themeCookie = new Cookie('theme')
-```
+### Action
+
+#### `get`
+
+Reads the cookie value. If the value doesn't exist and a default is provided, it will be saved and returned. Supports functions for lazy default value computation.
+
+**Parameters:**
+- `defaultValue?: T | string | (() => T | string)` — default value or function returning the value
+- `options?: CookieOptions` — cookie options (used when setting default value)
 
-## Data Management
+**Returns:** `T | string | undefined` — the cookie value or the assigned default
 
-### `get`
+#### `set`
 
-Use `get()` to read the cookie. If you pass a default value to `get()`, it will simultaneously save that default if the cookie was previously unset.
+Stores or updates a cookie value with specified options. Supports functions for dynamic value computation. If blocking is active via `CookieBlock`, the value is stored in memory only.
 
 **Parameters:**
-- `value?: T | string | (() => T | string)` — optional default value or a function returning it.
+- `value?: T | string | (() => T | string)` — the value to store or a function returning the value
+- `options?: CookieOptions` — cookie options (lifetime, SameSite, additional arguments)
 
-**Returns:** `T | string | undefined` — the value from the cookie, or the assigned default.
+**Returns:** `void`
 
-```javascript
-// Will read 'theme', OR set and return 'dark' if it doesn't exist
-const currentTheme = themeCookie.get('dark') 
-```
+#### `remove`
 
-### `set`
+Removes a cookie by overwriting it with an empty string and setting Max-Age to `-1`, instructing the browser to instantly delete the record.
 
-Use `set()` to override or create new data. Options allow you to control standard cookie attributes like `age` (Max-Age cache duration in seconds) or `sameSite` policy.
+**Returns:** `void`
 
-**Parameters:**
-- `value: T | string | (() => T | string)` — the value to store, or a function returning the value.
-- `options?: CookieOptions` — configuration for the cookie lifetime and security.
+### Static Methods
+
+- `getInstance<T>(name: string): Cookie<T>` — Returns an existing instance or creates a new one by name
+
+### Auxiliary
+
+- `CookieStorage.update()` — Updates data from `document.cookie`
+
+## Types
+
+### `CookieOptions`
 
-```javascript
-const userPrefs = new Cookie('preferences')
+Configuration object for cookie parameters:
 
-// Set a simple string
-userPrefs.set('{"compact": true}')
+- `age?: number` — lifetime in seconds (Max-Age attribute). Default: 7 days (604800 sec)
+- `sameSite?: 'strict' | 'lax'` — SameSite policy. Default: `'strict'`
+- `arguments?: string[]` — additional directives appended to the cookie string
 
-// Set with advanced options
-userPrefs.set('{"compact": true}', {
+## Examples
+
+### Basic Usage
+
+```typescript
+import { Cookie } from '@dxtmisha/functional'
+
+// Create instance to manage 'theme' cookie
+const themeCookie = new Cookie('theme')
+
+// Read with default value
+const currentTheme = themeCookie.get('dark')
+
+// Set value
+themeCookie.set('light')
+
+// Set with options
+themeCookie.set('dark', {
   age: 60 * 60 * 24 * 30, // 30 days
   sameSite: 'lax'
 })
+
+// Remove
+themeCookie.remove()
 ```
 
-### `remove`
+### Using getInstance
+
+```typescript
+import { Cookie } from '@dxtmisha/functional'
+
+// Get or create instance
+const cookie = Cookie.getInstance<string>('user')
 
-Removing a cookie overwrites it with an empty string and sets its Max-Age to `-1`, instructing the browser to instantly delete the record.
+// All getInstance calls with the same name return the same instance
+const sameCookie = Cookie.getInstance<string>('user')
 
-```javascript
-userPrefs.remove()
+console.log(cookie === sameCookie) // true
 ```
 
-## Synchronization
+### CookieBlock Integration
 
-- `updateData(): void` (static) — Updates data from `document.cookie`.
+```typescript
+import { Cookie, CookieBlock } from '@dxtmisha/functional'
 
-## CookieOptions
+// Block all write operations
+CookieBlock.set(true)
 
-`CookieOptions` is a configuration object for the `get` and `set` methods:
+const cookie = new Cookie('blocked')
 
-- `age?: number` — cookie lifetime in **seconds** (`Max-Age` attribute). Default: 7 days (604800 sec). Automatically set to `-1` when deleting via `remove()`.
-- `sameSite?: 'strict' | 'lax'` — the `SameSite` policy. Default: `'strict'` (cookie is only sent on same-site navigations). `'lax'` also allows sending on cross-site GET requests.
-- `arguments?: string[]` — additional directives appended to the cookie string (e.g. `'Secure'`, `'Path=/'`, `'Domain=.myapp.com'`).
+// Value is saved in memory, but not in DOM
+cookie.set('value')
 
+// Unblock
+CookieBlock.set(false)
 
+// Now writes work normally
+cookie.set('newValue')
+```

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

@@ -4,84 +4,128 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс Cookie
 
-Удобная обертка для управления браузерными куки. Она автоматически синхронизируется между памятью и API DOM `document.cookie`, позволяя вам реактивно устанавливать, извлекать и удалять куки, гарантируя при этом согласованные значения по умолчанию.
+Удобная обертка для управления браузерными куки. Автоматически синхронизируется между памятью и API DOM `document.cookie`, позволяя реактивно устанавливать, извлекать и удалять куки с гарантией согласованных значений по умолчанию.
+
+Включает тесную интеграцию с `CookieStorage` для низкоуровневого управления и уважает глобальную блокировку через `CookieBlock`.
 
 ## Ключевые особенности
 
-- **Синхронизация с памятью** — поддерживает запись куки в памяти для предотвращения ненужных обращений к DOM. Автоматически парсит `document.cookie` при запуске.
-- **Понимание окружения** — определяет, выполняется ли код в среде DOM. В SSR (Server-Side Rendering) или при тестировании (без DOM) она элегантно переходит на хранение только в памяти без выброса ошибок.
-- **Глобальный контроль блокировки** — безопасно интегрируется с `CookieBlock`. Если запись куки глобально отключена (например, из-за согласия пользователя на конфиденциальность), класс `Cookie` уважает это и приостанавливает все исходящие изменения в DOM.
-- **Логика по умолчанию** — получение значения может лениво инициализировать его стандартом по умолчанию, если оно еще не существует.
+- **Синхронизация с памятью** — поддерживает запись куки в памяти для предотвращения ненужных обращений к DOM
+- **Понимание окружения** — определяет, выполняется ли код в среде DOM. В SSR или при тестировании элегантно переходит на хранение только в памяти
+- **Глобальный контроль блокировки** — безопасно интегрируется с `CookieBlock`. Если запись куки глобально отключена, класс уважает это и приостанавливает все изменения в DOM
+- **Логика по умолчанию** — получение значения может лениво инициализировать его стандартом по умолчанию, если оно еще не существует
 
-## Инициализация
+## Конструктор
 
-Для инициализации объекта вызовите конструктор `Cookie(name)`.
+Экземпляр `Cookie` может быть создан для управления конкретным cookie. Если экземпляр с таким именем уже существует, будет возвращен существующий.
 
 **Параметры:**
-- `name: string` — имя куки, которым вы хотите управлять.
+- `name: string` — имя cookie для управления
 
-```typescript
-import { Cookie } from '@dxtmisha/functional'
+## Методы
 
-// 1. Инициализация обертки для куки 'theme'
-const themeCookie = new Cookie('theme')
-```
+### Действие
+
+#### `get`
+
+Читает значение cookie. Если значение не существует и передано значение по умолчанию, оно будет сохранено и возвращено. Поддерживает функции для ленивого вычисления значения по умолчанию.
+
+**Параметры:**
+- `defaultValue?: T | string | (() => T | string)` — значение по умолчанию или функция, возвращающая значение
+- `options?: CookieOptions` — параметры cookie (используются при установке значения по умолчанию)
 
-## Управление данными
+**Возвращает:** `T | string | undefined` — значение из куки или заданное по умолчанию
 
-### `get`
+#### `set`
 
-Используйте `get()` для его чтения. Если вы передадите значение по умолчанию в `get()`, оно одновременно сохранит это значение по умолчанию, если куки ранее не было установлено.
+Сохраняет или обновляет значение cookie с указанными параметрами. Поддерживает функции для динамического вычисления значения. Если активна блокировка через `CookieBlock`, значение сохраняется только в памяти.
 
 **Параметры:**
-- `value?: T | string | (() => T | string)` — опциональное значение по умолчанию или функция.
+- `value?: T | string | (() => T | string)` — значение для хранения или функция, возвращающая значение
+- `options?: CookieOptions` — параметры cookie (время жизни, SameSite, дополнительные аргументы)
 
-**Возвращает:** `T | string | undefined` — значение из куки или заданное по умолчанию.
+**Возвращает:** `void`
 
-```javascript
-// Прочитает 'theme', ИЛИ установит и вернет 'dark', если его не существует
-const currentTheme = themeCookie.get('dark') 
-```
+#### `remove`
 
-### `set`
+Удаляет cookie, устанавливая пустое значение и Max-Age в `-1`, что заставляет браузер немедленно удалить запись.
 
-Используйте `set()` для переопределения или создания новых данных. Опции позволяют управлять стандартными атрибутами куки, такими как `age` (продолжительность кэширования Max-Age в секундах) или политика `sameSite`.
+**Возвращает:** `void`
 
-**Параметры:**
-- `value: T | string | (() => T | string)` — значение для хранения, или функция, возвращающая значение.
-- `options?: CookieOptions` — конфигурация срока жизни и безопасности куки.
+### Статические методы
+
+- `getInstance<T>(name: string): Cookie<T>` — Возвращает существующий экземпляр или создает новый по имени
+
+### Вспомогательные
+
+- `CookieStorage.update()` — Обновляет данные из `document.cookie`
+
+## Типы
+
+### `CookieOptions`
 
-```javascript
-const userPrefs = new Cookie('preferences')
+Объект конфигурации для параметров cookie:
 
-// Установка простой строки
-userPrefs.set('{"compact": true}')
+- `age?: number` — время жизни в секундах (атрибут Max-Age). По умолчанию: 7 дней (604800 сек)
+- `sameSite?: 'strict' | 'lax'` — политика SameSite. По умолчанию: `'strict'`
+- `arguments?: string[]` — дополнительные директивы для строки cookie
 
-// Установка с расширенными опциями
-userPrefs.set('{"compact": true}', {
+## Примеры
+
+### Базовое использование
+
+```typescript
+import { Cookie } from '@dxtmisha/functional'
+
+// Создание экземпляра для управления cookie 'theme'
+const themeCookie = new Cookie('theme')
+
+// Чтение с дефолтным значением
+const currentTheme = themeCookie.get('dark')
+
+// Установка значения
+themeCookie.set('light')
+
+// Установка с параметрами
+themeCookie.set('dark', {
   age: 60 * 60 * 24 * 30, // 30 дней
   sameSite: 'lax'
 })
+
+// Удаление
+themeCookie.remove()
 ```
 
-### `remove`
+### Использование getInstance
+
+```typescript
+import { Cookie } from '@dxtmisha/functional'
+
+// Получение или создание экземпляра
+const cookie = Cookie.getInstance<string>('user')
 
-Удаление куки перезаписывает его пустой строкой и устанавливает его Max-Age в `-1`, давая браузеру команду немедленно удалить запись.
+// Все вызовы getInstance с одним именем возвращают один и тот же экземпляр
+const sameCookie = Cookie.getInstance<string>('user')
 
-```javascript
-userPrefs.remove()
+console.log(cookie === sameCookie) // true
 ```
 
-## Синхронизация
+### Интеграция с CookieBlock
 
-- `updateData(): void` (static) — Обновляет данные из `document.cookie`.
+```typescript
+import { Cookie, CookieBlock } from '@dxtmisha/functional'
 
-## Параметры CookieOptions
+// Блокировка всех операций записи
+CookieBlock.set(true)
 
-`CookieOptions` — объект конфигурации для методов `get` и `set`:
+const cookie = new Cookie('blocked')
 
-- `age?: number` — время жизни куки в **секундах** (атрибут `Max-Age`). По умолчанию: 7 дней (604800 сек). При удалении (`remove()`) автоматически становится `-1`.
-- `sameSite?: 'strict' | 'lax'` — политика `SameSite`. По умолчанию: `'strict'` (куки отправляется только при переходах внутри сайта). `'lax'` — также разрешает отправку при переходах с внешних ссылок (GET-запросы).
-- `arguments?: string[]` — массив дополнительных директив, которые добавляются в строку куки (например: `'Secure'`, `'Path=/'`, `'Domain=.myapp.com'`).
+// Значение сохраняется в памяти, но не в DOM
+cookie.set('value')
 
+// Разблокировка
+CookieBlock.set(false)
 
+// Теперь запись работает нормально
+cookie.set('newValue')
+```

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

@@ -6,82 +6,126 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 Lớp bao đóng cho phép các developer quản trị trực tiếp vùng Browser Cookie. Hệ thống `Cookie` tự cấu hình tính đồng bộ xuyên suốt từ bộ đệm của website (memory record) sang môi trường DOM API `document.cookie`, giúp cho tiến trình thao tác và tạo lập biến theo chuẩn reactive được đáp ứng đầy đủ với các chức năng dự phòng linh hoạt.
 
+Bao gồm tích hợp chặt chẽ với `CookieStorage` để quản lý cấp thấp và tôn trọng chặn toàn cầu qua `CookieBlock`.
+
 ## Các tính năng chính
 
-- **Đồng bộ hóa Không Gian Bộ Nhớ (Memory Sync)** — lưu giữ cấu trúc ảo cho trình quản lý trạng thái tại server cache, tránh tạo quá nhiều truy vấn lên cấu trúc DOM của cookie. Khi khởi tạo tiến trình nó lập tức bắt/nắm bắt vòng dữ liệu đầu tư của mã node `document.cookie`.
-- **Thiết Lập Theo Vùng Môi Trường (Environment Aware)** — có khả năng định vị khu sinh thái DOM. Với vùng Render SSR (Server-Side Rendering) hoặc Unit Test, tính năng bắt cookie vẫn giả lập môi trường ảo dựa trên biến cache để tránh phát sinh bug văng lỗi gián đoạn do không truy vấn được DOM window.
-- **Tính Năng Chặn Toàn Quyền (Global Cookie Blocking)** — kế nối bảo mật theo bộ thư viện của quy chế `CookieBlock`. Nếu website đánh mã dừng cấp quyền hoạt động cookie theo chính sách riêng tư bảo vệ người dùng, Class Cookie sẽ dừng tất cả chức năng sinh tác dữ liệu lên DOM theo đúng giao thức.
-- **Hỗ Trợ Luồng Code Default (Fallback/Default)** — cho phép nạp biến đệm vào làm dữ liệu phụ và sinh cấu trúc từ giá trị phụ đó khi giá trị thật vẫn đang bị mất/rỗng.
+- **Đồng bộ hóa Không Gian Bộ Nhớ (Memory Sync)** — lưu giữ cấu trúc ảo cho trình quản lý trạng thái tại server cache, tránh tạo quá nhiều truy vấn lên cấu trúc DOM của cookie. Khi khởi tạo tiến trình nó lập tức bắt/nắm bắt vòng dữ liệu đầu tư của mã node `document.cookie`
+- **Thiết Lập Theo Vùng Môi Trường (Environment Aware)** — có khả năng định vị khu sinh thái DOM. Với vùng Render SSR (Server-Side Rendering) hoặc Unit Test, tính năng bắt cookie vẫn giả lập môi trường ảo dựa trên biến cache để tránh phát sinh bug văng lỗi gián đoạn do không truy vấn được DOM window
+- **Tính Năng Chặn Toàn Quyền (Global Cookie Blocking)** — kế nối bảo mật theo bộ thư viện của quy chế `CookieBlock`. Nếu website đánh mã dừng cấp quyền hoạt động cookie theo chính sách riêng tư bảo vệ người dùng, Class Cookie sẽ dừng tất cả chức năng sinh tác dữ liệu lên DOM theo đúng giao thức
+- **Hỗ Trợ Luồng Code Default (Fallback/Default)** — cho phép nạp biến đệm vào làm dữ liệu phụ và sinh cấu trúc từ giá trị phụ đó khi giá trị thật vẫn đang bị mất/rỗng
 
-## Khởi tạo
+## Constructor
 
-Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `Cookie(name)`.
+Phiên bản `Cookie` có thể được tạo để quản lý cookie cụ thể. Nếu phiên bản với cùng tên đã tồn tại, phiên bản hiện có sẽ được trả về.
 
 **Tham số:**
-- `name: string` — tên của cookie bạn muốn quản lý.
+- `name: string` — tên cookie để quản lý
 
-```typescript
-import { Cookie } from '@dxtmisha/functional'
+## Phương thức
 
-// 1. Mảng giao tiếp lấy biến 'theme' cookie
-const themeCookie = new Cookie('theme')
-```
+### Hành động
+
+#### `get`
+
+Khi chạy `get()`, nếu cung cấp một đoạn code tĩnh phụ, class sẽ so khớp. Trường hợp lúc này không thấy thông số cookie trên hệ điều hành, đoạn code tĩnh lập tức ghi vào cấu trúc và lưu lại lên trình duyệt. Hỗ trợ các hàm để tính toán giá trị mặc định một cách lười.
+
+**Tham số:**
+- `defaultValue?: T | string | (() => T | string)` — cấu trúc dự phòng mặc định hoặc callback function
+- `options?: CookieOptions` — tham số cookie (sử dụng khi đặt giá trị mặc định)
 
-## Quản lý dữ liệu
+**Trả về:** `T | string | undefined` — biến lấy từ cookie hoặc dữ liệu phụ trợ
 
-### `get`
+#### `set`
 
-Khi chạy `get()`, nếu cung cấp một đoạn code tĩnh phụ, class sẽ so khớp. Trường hợp lúc này không thấy thông số cookie trên hệ điều hành, đoạn code tĩnh lập tức ghi vào cấu trúc và lưu lại lên trình duyệt.
+Sử dụng `set()` để nạp hoặc làm đệm chèn đè lên biến trước. Những chuẩn tham số bổ sung còn quản lý cả chuẩn cookie thông dụng là `age` (Max-Age cache thiết đặt quy đổi theo giây) và trạng thái của các `sameSite`. Nếu chặn đang hoạt động qua `CookieBlock`, giá trị chỉ được lưu trong bộ nhớ.
 
 **Tham số:**
-- `value?: T | string | (() => T | string)` — cấu trúc dự phòng mặc định hoặc callback function.
+- `value?: T | string | (() => T | string)` — tham chiếu dùng đăng ký tạo vào cookie, hoặc trỏ lên một mảng rỗng để tính function tạo cấu trúc thay vì nhập chay string
+- `options?: CookieOptions` — phần tham số hỗ trợ định tuổi tồn tại và cấu hình thông số cấp quyền mở rộng của cookie
 
-**Trả về:** `T | string | undefined` — biến lấy từ cookie hoặc dữ liệu phụ trợ.
+**Trả về:** `void`
 
-```javascript
-// Tìm hệ thống node 'theme', HOẶC gán/đóng gói 'dark' trả lại cho giá trị nếu web rỗng
-const currentTheme = themeCookie.get('dark') 
-```
+#### `remove`
 
-### `set`
+Tập lệnh thực thi việc đẩy một mảng thông số rỗng bằng string trắng vào vùng cookie, sau đó cập nhật vòng đời thuộc tính Max-Age thành `-1`. Lúc này máy khách sẽ hiểu trình truy xuất cần dừng hoạt động, đẩy lùi chu kỳ hết hạn và loại cookie ngay rực khắc.
 
-Sử dụng `set()` để nạp hoặc làm đệm chèn đè lên biến trước. Những chuẩn tham số bổ sung còn quản lý cả chuẩn cookie thông dụng là `age` (Max-Age cache thiết đặt quy đổi theo giây) và trạng thái của các `sameSite`.
+**Trả về:** `void`
 
-**Tham số:**
-- `value: T | string | (() => T | string)` — tham chiếu dùng đăng ký tạo vào cookie, hoặc trỏ lên một mảng rỗng để tính function tạo cấu trúc thay vì nhập chay string.
-- `options?: CookieOptions` — phần tham số hỗ trợ định tuổi tồn tại và cấu hình thông số cấp quyền mở rộng của cookie.
+### Phương thức tĩnh
+
+- `getInstance<T>(name: string): Cookie<T>` — Trả về phiên bản hiện có hoặc tạo mới theo tên
+
+### Hỗ trợ
+
+- `CookieStorage.update()` — Cập nhật dữ liệu từ thư mục `document.cookie` nằm trên browser
+
+## Các loại
+
+### `CookieOptions`
 
-```javascript
-const userPrefs = new Cookie('preferences')
+Đối tượng cấu hình cho các phương thức `get` và `set`:
+
+- `age?: number` — thời gian sống của cookie tính bằng **giây** (thuộc tính `Max-Age`). Mặc định: 7 ngày (604800 giây). Tự động đặt thành `-1` khi xóa qua `remove()`
+- `sameSite?: 'strict' | 'lax'` — chính sách `SameSite`. Mặc định: `'strict'` (cookie chỉ được gửi khi điều hướng trong cùng trang web). `'lax'` cũng cho phép gửi khi điều hướng từ liên kết ngoài (GET request)
+- `arguments?: string[]` — các chỉ thị bổ sung được nối vào chuỗi cookie (ví dụ: `'Secure'`, `'Path=/'`, `'Domain=.myapp.com'`)
+
+## Ví dụ
+
+### Sử dụng cơ bản
+
+```typescript
+import { Cookie } from '@dxtmisha/functional'
+
+// Mảng giao tiếp lấy biến 'theme' cookie
+const themeCookie = new Cookie('theme')
+
+// Tìm hệ thống node 'theme', HOẶC gán/đóng gói 'dark' trả lại cho giá trị nếu web rỗng
+const currentTheme = themeCookie.get('dark')
 
 // Cấu trúc text / string đơn thuần
-userPrefs.set('{"compact": true}')
+themeCookie.set('light')
 
 // Trỏ cấu hình tuỳ chỉnh đa hệ
-userPrefs.set('{"compact": true}', {
+themeCookie.set('dark', {
   age: 60 * 60 * 24 * 30, // Xử lý cache quy về 30 ngày vòng lặp
   sameSite: 'lax'
 })
+
+// Xóa
+themeCookie.remove()
 ```
 
-### `remove`
+### Sử dụng getInstance
+
+```typescript
+import { Cookie } from '@dxtmisha/functional'
+
+// Lấy hoặc tạo phiên bản
+const cookie = Cookie.getInstance<string>('user')
 
-Tập lệnh thực thi việc đẩy một mảng thông số rỗng bằng string trắng vào vùng cookie, sau đó cập nhật vòng đời thuộc tính Max-Age thành `-1`. Lúc này máy khách sẽ hiểu trình truy xuất cần dừng hoạt động, đẩy lùi chu kỳ hết hạn và loại cookie ngay rức khắc.
+// Tất cả các cuộc gọi getInstance với cùng một tên trả về cùng một phiên bản
+const sameCookie = Cookie.getInstance<string>('user')
 
-```javascript
-userPrefs.remove()
+console.log(cookie === sameCookie) // true
 ```
 
-## Đồng bộ hóa
+### Tích hợp với CookieBlock
 
-- `updateData(): void` (static) — Lệnh tĩnh giúp cập nhật dữ liệu từ thư mục `document.cookie` nằm trên browser.
+```typescript
+import { Cookie, CookieBlock } from '@dxtmisha/functional'
 
-## CookieOptions
+// Chặn tất cả hoạt động ghi
+CookieBlock.set(true)
 
-`CookieOptions` là đối tượng cấu hình cho các phương thức `get` và `set`:
+const cookie = new Cookie('blocked')
 
-- `age?: number` — thời gian sống của cookie tính bằng **giây** (thuộc tính `Max-Age`). Mặc định: 7 ngày (604800 giây). Tự động đặt thành `-1` khi xóa qua `remove()`.
-- `sameSite?: 'strict' | 'lax'` — chính sách `SameSite`. Mặc định: `'strict'` (cookie chỉ được gửi khi điều hướng trong cùng trang web). `'lax'` cũng cho phép gửi khi điều hướng từ liên kết ngoài (GET request).
-- `arguments?: string[]` — các chỉ thị bổ sung được nối vào chuỗi cookie (ví dụ: `'Secure'`, `'Path=/'`, `'Domain=.myapp.com'`).
+// Giá trị được lưu trong bộ nhớ, nhưng không phải DOM
+cookie.set('value')
 
+// Mở chặn
+CookieBlock.set(false)
 
+// Bây giờ ghi hoạt động bình thường
+cookie.set('newValue')
+```

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

@@ -4,54 +4,75 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # CookieBlock Class
 
-A static utility class that serves as a global "kill switch" for DOM cookie modifications. It provides a simple boolean state that other classes, specifically `Cookie`, check before attempting to write to `document.cookie`.
+A static utility class that serves as a global "kill switch" for DOM cookie modifications. Provides a simple boolean state that other classes, specifically `Cookie`, check before attempting to write to `document.cookie`.
+
+Includes tight integration with `ServerStorage` for request-level state isolation in SSR environments.
 
 ## Key Features
 
-- **Global Truth** — a single configuration point to halt cookie operations application-wide.
-- **Privacy Compliance** — extremely useful for implementing "Cookie Consent" banners. Simply set the block to `true` until the user explicitly accepts all cookies.
-- **DataStorage Backed** — uses the `DataStorage` abstraction internally to maintain the blocked state reliably.
+- **Global Truth** — a single configuration point to halt cookie operations application-wide
+- **Privacy Compliance** — extremely useful for implementing "Cookie Consent" banners
+- **SSR Compatible** — uses `ServerStorage` to reliably maintain the blocked state in isolated request contexts
 
+## Static Methods
 
-Since all methods are `static`, you interact with the class directly.
+### Action
 
-## Access Management
+#### `set`
 
-### `get`
+Enables or disables cookie writing capabilities. When set to `true`, all write operations will only save data in memory without touching `document.cookie`.
 
-Use the `get()` method to read the current blocking status. This returns a boolean.
+**Parameters:**
+- `value: boolean` — `true` to block cookie writes, `false` to allow them
 
-**Returns:** `boolean` — `true` if cookie writing is blocked.
+**Returns:** `void`
 
-```javascript
-if (CookieBlock.get()) {
-  console.log('Cookie writes are currently blocked by user settings.')
-}
-```
+### Check
 
-### `set`
+- `get(): boolean` — Returns the current blocking status. `true` if cookie writing is blocked
 
-Use the `set()` method to enable or disable cookie writing capabilities.
+## Examples
 
-**Parameters:**
-- `value: boolean` — `true` to block cookie writes, `false` to allow them.
+### Basic Usage
 
-```javascript
+```typescript
 import { CookieBlock } from '@dxtmisha/functional'
 
 // Block all future DOM cookie writes
 CookieBlock.set(true)
 
+if (CookieBlock.get()) {
+  console.log('Cookie writes are currently blocked')
+}
+
 // Allow DOM cookie writes (default behavior)
 CookieBlock.set(false)
 ```
 
+### Cookie Consent Banner Implementation
+
+```typescript
+import { CookieBlock, Cookie } from '@dxtmisha/functional'
+
+// Block cookies on app load
+CookieBlock.set(true)
+
+// After user accepts cookies
+function onCookieConsentAccepted() {
+  CookieBlock.set(false)
+  
+  // Now we can set cookies
+  const theme = new Cookie('theme')
+  theme.set('dark')
+}
+```
+
 ## How It Interacts With `Cookie`
 
 The core `Cookie` class strictly monitors this block. If `CookieBlock.get()` returns `true`:
 
-1.  Your application logic can still technically call `cookieInstance.set('value')`.
-2.  The `Cookie` instance will update its *internal memory storage* to the new value.
-3.  The `Cookie` instance **will silently refuse** to execute the actual `document.cookie = ...` DOM write. 
+1. Your application logic can still technically call `cookieInstance.set('value')`
+2. The `Cookie` instance will update its *internal memory storage* to the new value
+3. The `Cookie` instance **will silently refuse** to execute the actual `document.cookie = ...` DOM write
 
 This guarantees your app doesn't break from undefined reads in memory while strictly honoring the browser's disk persistence settings.