@dxtmisha/wiki 0.39.1 → 0.39.3

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

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

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

@@ -0,0 +1,87 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/Cookie - Quản lý chuẩn Browser Cookie'/>
+
+# Lớp Cookie
+
+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.
+
+## 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.
+
+## Khởi tạo
+
+Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `Cookie(name)`.
+
+**Tham số:**
+- `name: string` — tên của cookie bạn muốn quản lý.
+
+```typescript
+import { Cookie } from '@dxtmisha/functional'
+
+// 1. Mảng giao tiếp lấy biến 'theme' cookie
+const themeCookie = new Cookie('theme')
+```
+
+## Quản lý dữ liệu
+
+### `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.
+
+**Tham số:**
+- `value?: T | string | (() => T | string)` — cấu trúc dự phòng mặc định hoặc callback function.
+
+**Trả về:** `T | string | undefined` — biến lấy từ cookie hoặc dữ liệu phụ trợ.
+
+```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') 
+```
+
+### `set`
+
+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`.
+
+**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.
+
+```javascript
+const userPrefs = new Cookie('preferences')
+
+// Cấu trúc text / string đơn thuần
+userPrefs.set('{"compact": true}')
+
+// Trỏ cấu hình tuỳ chỉnh đa hệ
+userPrefs.set('{"compact": true}', {
+  age: 60 * 60 * 24 * 30, // Xử lý cache quy về 30 ngày vòng lặp
+  sameSite: 'lax'
+})
+```
+
+### `remove`
+
+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.
+
+```javascript
+userPrefs.remove()
+```
+
+## Đồng bộ hóa
+
+- `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.
+
+## CookieOptions
+
+`CookieOptions` là đố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'`).
+
+

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

@@ -0,0 +1,57 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/CookieBlock - Global Cookie Control'/>
+
+# 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`.
+
+## 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.
+
+
+Since all methods are `static`, you interact with the class directly.
+
+## Access Management
+
+### `get`
+
+Use the `get()` method to read the current blocking status. This returns a boolean.
+
+**Returns:** `boolean` — `true` if cookie writing is blocked.
+
+```javascript
+if (CookieBlock.get()) {
+  console.log('Cookie writes are currently blocked by user settings.')
+}
+```
+
+### `set`
+
+Use the `set()` method to enable or disable cookie writing capabilities.
+
+**Parameters:**
+- `value: boolean` — `true` to block cookie writes, `false` to allow them.
+
+```javascript
+import { CookieBlock } from '@dxtmisha/functional'
+
+// Block all future DOM cookie writes
+CookieBlock.set(true)
+
+// Allow DOM cookie writes (default behavior)
+CookieBlock.set(false)
+```
+
+## 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. 
+
+This guarantees your app doesn't break from undefined reads in memory while strictly honoring the browser's disk persistence settings.

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

@@ -0,0 +1,57 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/CookieBlock - Глобальный контроль Cookie'/>
+
+# Класс CookieBlock
+
+Статический служебный класс, который служит глобальным "аварийным выключателем" для изменений куки в DOM. Он предоставляет простое логическое состояние, которое другие классы, в частности `Cookie`, проверяют перед попыткой записи в `document.cookie`.
+
+## Ключевые особенности
+
+- **Глобальная истина** — единая точка конфигурации для остановки операций с куки в масштабах всего приложения.
+- **Соответствие конфиденциальности** — крайне полезно для реализации баннеров "Согласие на использование файлов cookie". Просто установите блокировку в `true`, пока пользователь явно не примет все куки.
+- **Поддержка DataStorage** — внутренне использует абстракцию `DataStorage` для надежного поддержания заблокированного состояния.
+
+
+Поскольку все методы `static`, вы взаимодействуете с классом напрямую.
+
+## Управление доступом
+
+### `get`
+
+Используйте метод `get()` для чтения текущего статуса блокировки. Возвращает логическое значение.
+
+**Возвращает:** `boolean` — `true`, если запись куки заблокирована.
+
+```javascript
+if (CookieBlock.get()) {
+  console.log('Запись куки в настоящее время заблокирована настройками пользователя.')
+}
+```
+
+### `set`
+
+Используйте метод `set()` для включения или отключения возможностей записи куки.
+
+**Параметры:**
+- `value: boolean` — `true` для блокировки записи куки, `false` для разрешения.
+
+```javascript
+import { CookieBlock } from '@dxtmisha/functional'
+
+// Заблокировать все будущие записи куки в DOM
+CookieBlock.set(true)
+
+// Разрешить записи куки в DOM (поведение по умолчанию)
+CookieBlock.set(false)
+```
+
+## Как это взаимодействует с `Cookie`
+
+Базовый класс `Cookie` строго следит за этой блокировкой. Если `CookieBlock.get()` возвращает `true`:
+
+1.  Логика вашего приложения технически все еще может вызывать `cookieInstance.set('value')`.
+2.  Экземпляр `Cookie` обновит свое *внутреннее хранилище в памяти* новым значением.
+3.  Экземпляр `Cookie` **молча откажется** от фактической записи в DOM `document.cookie = ...`. 
+
+Это гарантирует, что ваше приложение не сломается от неопределенных чтений в памяти, при этом строго соблюдая настройки браузера по сохранению на диск.

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

@@ -0,0 +1,57 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/CookieBlock - Quản lý Cấp Quyền Cookie'/>
+
+# Lớp CookieBlock
+
+Lớp tiện ích static dùng để định nghĩa quy luật truy cập ("kill switch" hoặc cầu dao tổng) nhắm thẳng vào quá trình hệ thống có cho phép chỉnh/sửa nội dung DOM cookie trên website hay không. Bằng cách thiết lập chuẩn khoá chặn (boolean logic), các node class lớn hơn (ví dụ Class gốc `Cookie`) sẽ liên tục móc và lắng nghe lệnh này trước khi tiến hành bước in/thực thi ghi data vào `document.cookie`.
+
+## Các tính năng chính
+
+- **Chấp Nhận Quy Trình Định Mức Chung (Global Truth)** — cổng tuỳ chỉnh/kiểm soát chung đối với quá trình lưu tạo/in cookie dọc toàn bộ mã lệnh ứng dụng.
+- **Chuẩn Cấu Hình Quyền Riêng Tư Đặc thù (Privacy Compliance)** — một mẫu logic tuyệt vời dùng lập trình những phần banner xác nhận "Cookie Consent" (Xin quyền nạp Tracking). Người code chỉ việc nối logic nút bật class thành giá trị `true` đến chừng nào user chốt chấp nhận quy tắc lấy thông tin ở nút 'Đồng Ý'.
+- **Class Truy Vấn Cải Biên (DataStorage Backed)** — vận hành chuẩn dữ liệu `DataStorage` qua cấp độ trừu tượng để việc chặn ghi được tối ưu thông lượng trong background, gia tăng tính tin cậy.
+
+
+Tất cả là lớp static nên bạn chạy lệnh trượt và trỏ trực tiếp bằng dấu chấm (`.`).
+
+## Quản lý quyền truy cập
+
+### `get`
+
+`get()` trả về 100% chuẩn cấu trúc kiểu nhị phân boolean.
+
+**Trả về:** `boolean` — `true` nếu trình kiểm duyệt khóa chức năng tạo cookie.
+
+```javascript
+if (CookieBlock.get()) {
+  console.log('Quá trình nạp DOM/ghi chép Cookie đang khoá do cài đặt phía user chưa cho quyền truy cập.')
+}
+```
+
+### `set`
+
+Truy vấn tham số boolean qua `set()` để class hiểu website/app được hay không thể được viết biến cache cookie nữa.
+
+**Tham số:**
+- `value: boolean` — `true` đồng nghĩa chặn toàn bộ biến muốn viết cookie ra ngoài trỏ lên web, `false` hệ thống lại bật tắt mượt mà bình thường.
+
+```javascript
+import { CookieBlock } from '@dxtmisha/functional'
+
+// Lệnh chặn khẩn cấp toàn bộ dữ liệu ghi DOM cookie
+CookieBlock.set(true)
+
+// Dỡ bỏ cảnh bảo / Cấp quyền DOM in cookie (Cấu hình chuẩn của object mới)
+CookieBlock.set(false)
+```
+
+## Phương Phức Logic Khi Mắc Nối Với Lớp `Cookie`
+
+Nhân/Bộ cấu trúc tổng của class `Cookie` được code giám sát nghiêm ngặt mọi lệnh do luồng chặn phát đi. Lúc biến nhị phân `CookieBlock.get()` bị chốt ở mode `true`:
+
+1.  Ở nội bộ luồng mã, quá trình chạy vẫn ngầm hiểu là hệ thống gọi app bằng node lưu biến `cookieInstance.set('value')`.
+2.  Tiến trình instance trực thuộc `Cookie` kích hoạt việc in giá trị cập nhật/ghi đè thay thế nằm vào hàng đợi của *cơ sở memory ảo* (internal memory).
+3.  Tuyệt nhiên tại chính node instance của `Cookie` **hệ thống tự phát sinh quyền bác bỏ im lặng (silently refuse)** đối với hàm ghi biến tĩnh `document.cookie = ...` tại nhánh DOM ảo lẫn DOM thật.
+
+Luồng giao thức 3 buớc phía trên đáp ứng hoàn hảo hai tiêu chí tối thượng trong quy chuẩn kỹ thuật: Giúp DOM website không bị bóp băng thông khi chạy lỗi code lấy lệnh từ hệ memory chưa cấp dữ liệu (ngăn văng bug), cũng như giữ thiết lập tôn trọng chính sách truy vấn riêng tư bảo mật đĩa cứng phía Browser theo chuẩn Âu/Mỹ.

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

@@ -0,0 +1,74 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/DataStorage - Local and Session Storage Wrapper'/>
+
+# DataStorage Class
+
+A versatile class for interacting with the browser's `localStorage` and `sessionStorage`. It features built-in prefixes, cache expiration, memory caching for active instances, and automatic JSON serialization.
+
+## Key Features
+
+- **Automatic Serialization** — seamlessly handles JSON parsing and stringifying for stored configurations and objects.
+- **Time-based Caching** — allows saving objects with timestamps and respects age constraints during data retrieval.
+- **Prefix Management** — supports global and instance-specific prefixes to isolate and group keys within `localStorage`.
+- **Memory Efficiency** — creates singletons for identical keys, avoiding duplicate reads from disk.
+
+## Initialization
+
+To initialize the object, call the `DataStorage(name, isSession)` constructor.
+
+**Parameters:**
+- `name: string` — the name of the storage key.
+- `isSession: boolean = false` — whether to use `sessionStorage` (defaults to `localStorage`).
+
+```typescript
+import { DataStorage } from '@dxtmisha/functional'
+
+// 1. Create an instance for localStorage
+const settings = new DataStorage('settings')
+
+// 2. Create an instance for sessionStorage
+const session = new DataStorage('user_session', true)
+```
+
+## Global Settings
+
+- `setPrefix(newPrefix: string): void` (static) — Changes the global prefix applied to new instances attempting to use `localStorage`. The default prefix is `ui-storage`.
+
+## Data Management
+
+### `get`
+
+Retrieves the currently saved structured configuration.
+
+**Parameters:**
+- `defaultValue?: T | (() => T)` — a fallback value to return if the storage is empty.
+- `cache?: number` — maximum allowed age (in seconds). If the data is older, it behaves as if nothing was stored.
+
+**Returns:** `T | undefined` — the stored value or `undefined`.
+
+```javascript
+// Get data, falling back to an empty object if not found
+const currentSettings = settings.get({})
+
+// Get data only if it was saved within the last 60 seconds
+const cachedItem = settings.get(undefined, 60)
+```
+
+### `set`
+
+Sets or updates the value in the storage mechanism.
+
+**Parameters:**
+- `value?: T | (() => T)` — the value to save. Passing `undefined` will delete the item from storage.
+
+**Returns:** `T | undefined` — the stored value.
+
+```javascript
+settings.set({ theme: 'dark', notifications: true })
+```
+
+## Additional Methods
+
+- `remove(): this` — Clears the corresponding key actively from the `localStorage` or `sessionStorage` environments, and immediately unsets the existing memory instance.
+- `update(): this` — Forces the memory instance to synchronize tightly with the current raw data inside the physical Storage APIs.

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

@@ -0,0 +1,74 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/DataStorage - Обёртка Local и Session Storage'/>
+
+# Класс DataStorage
+
+Универсальный класс для взаимодействия с `localStorage` и `sessionStorage` браузера. Включает в себя автоматическое создание префиксов, ограничение срока действия кэша (возраст), кэширование в памяти для активных экземпляров и автоматическую сериализацию JSON.
+
+## Основные возможности
+
+- **Автоматическая сериализация** — легко справляется с разбором и преобразованием в JSON-строку при хранении конфигураций и объектов.
+- **Хранение с учётом времени** — позволяет сохранять объекты с временными метками и учитывать ограничения по возрасту значения во время его извлечения.
+- **Управление префиксами** — поддерживает глобальные и специфичные для каждого экземпляра префиксы, позволяющие изолировать и группировать ключи в рамках `localStorage`.
+- **Эффективная память** — создает паттерн singleton для идентичных ключей, чтобы избежать одновременного чтения непосредственно с диска.
+
+## Инициализация
+
+Для инициализации объекта вызовите конструктор `DataStorage(name, isSession)`.
+
+**Параметры:**
+- `name: string` — название ключа в хранилище.
+- `isSession: boolean = false` — нужно ли использовать `sessionStorage` (по умолчанию `localStorage`).
+
+```typescript
+import { DataStorage } from '@dxtmisha/functional'
+
+// 1. Создание экземпляра для localStorage
+const settings = new DataStorage('settings')
+
+// 2. Создание экземпляра для sessionStorage
+const session = new DataStorage('user_session', true)
+```
+
+## Глобальная настройка
+
+- `setPrefix(newPrefix: string): void` (static) — Изменяет глобальный префикс, применяемый ко всем новым экземплярам. Префикс по умолчанию — `ui-storage`.
+
+## Управление данными
+
+### `get`
+
+Получает текущую сохранённую структурированную конфигурацию.
+
+**Параметры:**
+- `defaultValue?: T | (() => T)` — запасное значение, которое будет возвращено, если хранилище пусто.
+- `cache?: number` — максимально допустимый возраст (в секундах). Если данные старше, они считаются не существующими.
+
+**Возвращает:** `T | undefined` — сохраненное значение или `undefined`.
+
+```javascript
+// Получение данных с откатом к пустому объекту, если они не найдены
+const currentSettings = settings.get({})
+
+// Получение данных, только если они были сохранены в течение последних 60 секунд
+const cachedItem = settings.get(undefined, 60)
+```
+
+### `set`
+
+Устанавливает или обновляет значение в механизме хранения.
+
+**Параметры:**
+- `value?: T | (() => T)` — значение для сохранения. Передача `undefined` удалит элемент из хранилища.
+
+**Возвращает:** `T | undefined` — сохраненное значение.
+
+```javascript
+settings.set({ theme: 'dark', notifications: true })
+```
+
+## Дополнительные методы
+
+- `remove(): this` — Активно удаляет соответствующий ключ из среды `localStorage` или `sessionStorage`, а также немедленно очищает существующее значение в памяти.
+- `update(): this` — Принудительно синхронизирует экземпляр памяти с текущими данными (raw) внутри физических API Storage.

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

@@ -0,0 +1,76 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/DataStorage - Trình Bao bọc Local và Session Storage'/>
+
+# Lớp DataStorage
+
+Một lớp linh hoạt để tương tác với `localStorage` và `sessionStorage` của trình duyệt. Nó bao gồm các tiền tố được tích hợp sẵn, thời gian hết hạn bộ đệm (cache), lưu vào bộ nhớ đệm (memory caching) cho các bản sao hoạt động và chuyển đổi JSON tự động.
+
+## Tính năng chính
+
+- **Chuyển đổi Tự động** — tự động xử lý phân tích và chuyển đổi chuỗi JSON cho các cấu hình và đối tượng được lưu trữ.
+- **Bộ nhớ đệm Dựa trên Thời gian** — cho phép lưu các đối tượng cùng với mốc thời gian và tôn trọng các ràng buộc về tuổi đời (age) của dữ liệu trong quá trình truy xuất.
+- **Quản lý Tiền tố** — hỗ trợ cả tiền tố toàn cục và riêng biệt để cách ly cũng như gom nhóm các khóa trong `localStorage`.
+- **Tối ưu Bô nhớ** — tạo ra các singleton cho những khóa giống nhau nhằm tránh các thao tác đọc đĩa bị lặp lại.
+
+## Khởi tạo
+
+Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `DataStorage(name, isSession)`.
+
+**Tham số:**
+- `name: string` — tên của khóa lưu trữ.
+- `isSession: boolean = false` — có sử dụng `sessionStorage` hay không (mặc định là `localStorage`).
+
+```typescript
+import { DataStorage } from '@dxtmisha/functional'
+
+// 1. Tạo một thực thể cho localStorage
+const settings = new DataStorage('settings')
+
+// 2. Tạo một thực thể cho sessionStorage
+const session = new DataStorage('user_session', true)
+```
+
+## Cách sử dụng Cơ bản
+
+## Cấu hình toàn cục
+
+- `setPrefix(newPrefix: string): void` (static) — Thay đổi tên tiền tố toàn cục áp dụng cho những instance mới đang định dùng môi trường `localStorage`. Giá trị tiền tố mặc định là `ui-storage`.
+
+## Quản lý dữ liệu
+
+### `get`
+
+Truy xuất cấu hình đã phân tích hiện tại được lưu lại từ trước.
+
+**Tham số:**
+- `defaultValue?: T | (() => T)` — giá trị dự phòng được trả về nếu bên trong bộ lưu trữ trống rỗng.
+- `cache?: number` — độ tuổi tối đa cho phép (tính bằng giây). Nếu dữ liệu đã cũ hơn mức này, nó sẽ cư xử như thể không có gì được lưu trữ.
+
+**Trả về:** `T | undefined` — giá trị được lưu trữ hoặc `undefined`.
+
+```javascript
+// Lấy dữ liệu, trả về object rỗng nếu không tìm thấy
+const currentSettings = settings.get({})
+
+// Chỉ lấy dữ liệu nếu nó được lưu lại trong vòng 60 giây gần nhất
+const cachedItem = settings.get(undefined, 60)
+```
+
+### `set`
+
+Thiết lập hoặc cập nhật một giá trị trong cơ chế lưu trữ.
+
+**Tham số:**
+- `value?: T | (() => T)` — giá trị muốn lưu. Việc truyền `undefined` sẽ loại bỏ mục đó khỏi kho lưu trữ.
+
+**Trả về:** `T | undefined` — giá trị được lưu trữ.
+
+```javascript
+settings.set({ theme: 'dark', notifications: true })
+```
+
+## Các phương thức bổ sung
+
+- `remove(): this` — Xóa bỏ chính xác khóa lưu trữ tương ứng từ phần môi trường phần mềm `localStorage` hoặc `sessionStorage`, đồng thời lập tức dọn sạch dữ liệu khối nhớ hiện tại.
+- `update(): this` — Buộc bộ đệm đối tượng trong bộ nhớ tự đồng bộ lại thật khít so với dữ liệu rỗng hiện hành bên trong các hàm Storage API vật lý.