@dxtmisha/wiki 0.39.7 → 0.56.0

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

@@ -4,102 +4,83 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # BroadcastMessage Class
 
-A class for handling cross-tab or cross-window messaging using the `BroadcastChannel` API. It provides a simple interface to send and receive messages with optional callback support, error handling, and environment-aware initialization.
+A class for handling messaging between different browser contexts (tabs, windows, iframes) using the `BroadcastChannel` API. It provides a convenient interface for sending and receiving data with automatic channel lifecycle management and error handling.
+
+Features automatic prefix naming to prevent conflicts and integrates with `ErrorCenter` for monitoring initialization failures.
 
 ## Key Features
 
-- **Cross-context Communication** — easily send messages between different browser tabs, windows, or iframes on the same origin.
-- **Callback Based** — register callbacks to handle incoming messages and errors automatically.
-- **Environment Aware** — automatically checks for DOM runtime before initializing, preventing errors in non-browser environments.
-- **Prefixed Names** — automatically adds a unique prefix to channel names to avoid collisions with other applications.
-- **Type Safety** — supports TypeScript generics for message payload typing.
-- **ErrorCenter Integration** — centralized error reporting when the `BroadcastChannel` fails to initialize.
-- **Direct Access** — provide access to the underlying `BroadcastChannel` instance when needed.
+- **Cross-Context Communication** — simple data synchronization between all windows of the same origin.
+- **Callback-Based** — automatic processing of incoming messages and errors through registered callback functions.
+- **Runtime Safety** — built-in DOM environment checking prevents errors during Server-Side Rendering (SSR).
+- **Channel Isolation** — automatic unique prefixing for channel names via `DataStorage`.
+- **Strong Typing** — full TypeScript generics support to ensure message data integrity.
 
 ## Initialization
 
-To initialize the object, call the `BroadcastMessage(name, callback, callbackError, errorCenter)` constructor.
+To initialize the object, call the constructor `BroadcastMessage(name, callback, callbackError, errorCenter)`.
 
 ### Generic Constraints
 
 - `Message = any` — the type of the message payload.
 
 **Parameters:**
-- `name: string` — unique name of the communication channel.
+- `name: string` — unique channel name.
 - `callback?: (event: MessageEvent<Message>) => void` — callback function executed when a message is received.
 - `callbackError?: (event: MessageEvent<Message>) => void` — callback function executed when a message error occurs.
-- `errorCenter: ErrorCenterInstance` — instance of the error center for triggering events (defaults to `ErrorCenter.getItem()`).
+- `errorCenter: ErrorCenterInstance` — error center instance (defaults to: `ErrorCenter.getItem()`).
 
 ```typescript
-import { BroadcastMessage } from '@dxtmisha/functional'
+import { BroadcastMessage } from '@dxtmisha/functional-basic'
 
-// 1. Initialization with incoming data handling
-const messenger = new BroadcastMessage(
+const messenger = new BroadcastMessage<string>(
   'my-channel',
-  (event) => console.log('Received:', event.data),
-  (error) => console.error('Error:', error)
+  (event) => console.log('Received:', event.data)
 )
-
-// 2. Sending a message
-messenger.post({ type: 'UPDATE', value: 100 })
 ```
 
-## Sending Messages
+## Methods
 
-### `post`
+### Action
 
-Sends a message to all listeners on the same channel.
+- `post(message: Message): this` — Sends a message to all listeners in the same channel.
+- `destroy(): this` — Closes the channel and stops listening for messages.
 
-**Parameters:**
-- `message: Message` — the data to send.
-
-**Returns:** `this` — for method chaining.
+### Configuration and Access
 
-```javascript
-messenger.post({ type: 'UPDATE', payload: { id: 123 } })
-```
-
-## Configuration & Access
-
-- `getChannel(): BroadcastChannel | undefined` — Returns the underlying `BroadcastChannel` instance (or `undefined` if not in DOM runtime).
-- `setCallback(callback: (event: MessageEvent<Message>) => void): this` — Updates or sets the callback function for receiving messages.
-- `setCallbackError(callbackError: (event: MessageEvent<Message>) => void): this` — Updates or sets the callback function for message errors.
+- `getChannel(): BroadcastChannel | undefined` — Returns the underlying `BroadcastChannel` instance.
+- `setCallback(callback: Function): this` — Updates the function for processing incoming messages.
+- `setCallbackError(callbackError: Function): this` — Updates the function for processing message errors.
 
 ## Examples
 
-### Synchronizing State Across Tabs
+### Syncing State Between Tabs
 
-```javascript
+```typescript
 import { BroadcastMessage } from '@dxtmisha/functional'
 
-// In Tab A and Tab B
-const authChannel = new BroadcastMessage('auth-status', (event) => {
+// In all application tabs
+const authChannel = new BroadcastMessage<string>('auth-status', (event) => {
   if (event.data === 'LOGOUT') {
     authModule.clearSession()
-    window.location.href = '/login'
+    window.location.reload()
   }
 })
 
-// When user logs out in Tab A
+// When a user logs out in one of the tabs
 function onLogout() {
   authChannel.post('LOGOUT')
 }
 ```
 
-### Simple Notification System with Error Handling
+### Updating Data Handler on the Fly
 
-```javascript
-const notifications = new BroadcastMessage(
-  'notifications',
-  (event) => showToast(event.data.message),
-  (error) => console.error('Failed to receive notification:', error)
-)
+```typescript
+const messenger = new BroadcastMessage('data-sync')
 
-// Update error handler later
-notifications.setCallbackError((error) => {
-  logToService(error)
+messenger.setCallback((event) => {
+  console.log('New data received:', event.data)
 })
 
-// Trigger notification from anywhere in the app
-notifications.post({ message: 'New message received!' })
+messenger.post({ id: 1, status: 'active' })
 ```

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

@@ -4,17 +4,17 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс BroadcastMessage
 
-Класс для работы с сообщениями между вкладками или окнами с использованием API `BroadcastChannel`. Предоставляет простой интерфейс для отправки и получения сообщений с поддержкой колбэков, обработки ошибок и проверкой среды выполнения.
+Класс для работы с сообщениями между различными контекстами браузера (вкладками, окнами, iframe) с использованием API `BroadcastChannel`. Предоставляет удобный интерфейс для отправки и получения данных с автоматическим управлением жизненным циклом канала и обработкой ошибок.
+
+Включает автоматическое префиксное именование для предотвращения конфликтов и интегрируется с `ErrorCenter` для мониторинга сбоев инициализации.
 
 ## Ключевые особенности
 
-- **Межконтекстное взаимодействие** — простая отправка сообщений между различными вкладками браузера, окнами или iframe одного и того же источника (origin).
-- **На основе колбэков** — регистрация функций обратного вызова для автоматической обработки входящих сообщений и ошибок.
-- **Учет среды выполнения** — автоматическая проверка наличия DOM перед инициализацией, что предотвращает ошибки в средах, отличных от браузера.
-- **Префиксы имен** — автоматическое добавление уникального префикса к именам каналов во избежание конфликтов с другими приложениями.
-- **Типизация** — поддержка универсальных типов (generics) TypeScript для полезной нагрузки сообщений.
-- **Интеграция с ErrorCenter** — централизованная отчетность об ошибках в случае сбоя инициализации `BroadcastChannel`.
-- **Прямой доступ** — предоставление доступа к базовому экземпляру `BroadcastChannel` при необходимости.
+- **Межконтекстное взаимодействие** — простая синхронизация данных между всеми окнами одного и того же источника (origin).
+- **На основе колбэков** — автоматическая обработка входящих сообщений и ошибок через регистрируемые функции обратного вызова.
+- **Безопасность выполнения** — встроенная проверка среды DOM предотвращает ошибки при серверном рендеринге (SSR).
+- **Изоляция каналов** — автоматическое добавление уникального префикса к именам каналов через `DataStorage`.
+- **Строгая типизация** — полная поддержка TypeScript дженериков для обеспечения целостности данных сообщения.
 
 ## Инициализация
 
@@ -26,80 +26,61 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 **Параметры:**
 - `name: string` — уникальное имя канала связи.
-- `callback?: (event: MessageEvent<Message>) => void` — функция обратного вызова, выполняемая при получении сообщения.
-- `callbackError?: (event: MessageEvent<Message>) => void` — функция обратного вызова, выполняемая при возникновении ошибки сообщения.
-- `errorCenter: ErrorCenterInstance` — экземпляр центра ошибок для вызова событий (по умолчанию: `ErrorCenter.getItem()`).
+- `callback?: (event: MessageEvent<Message>) => void` — функция обратного вызова при получении сообщения.
+- `callbackError?: (event: MessageEvent<Message>) => void` — функция обратного вызова при ошибке сообщения.
+- `errorCenter: ErrorCenterInstance` — экземпляр центра ошибок (по умолчанию: `ErrorCenter.getItem()`).
 
 ```typescript
-import { BroadcastMessage } from '@dxtmisha/functional'
+import { BroadcastMessage } from '@dxtmisha/functional-basic'
 
-// 1. Инициализация с обработкой входящих данных
-const messenger = new BroadcastMessage(
+const messenger = new BroadcastMessage<string>(
   'my-channel',
-  (event) => console.log('Получено:', event.data),
-  (error) => console.error('Ошибка:', error)
+  (event) => console.log('Получено:', event.data)
 )
-
-// 2. Отправка сообщения
-messenger.post({ type: 'UPDATE', value: 100 })
 ```
 
-## Отправка сообщений
+## Методы
 
-### `post`
+### Действие
 
-Отправляет сообщение всем слушателям в том же канале.
+- `post(message: Message): this` — Отправляет сообщение всем слушателям в том же канале.
+- `destroy(): this` — Закрывает канал и прекращает прослушивание сообщений.
 
-**Параметры:**
-- `message: Message` — данные для отправки.
-
-**Возвращает:** `this` — для цепочки вызовов.
+### Настройка и доступ
 
-```javascript
-messenger.post({ type: 'UPDATE', payload: { id: 123 } })
-```
-
-## Настройка и доступ
-
-- `getChannel(): BroadcastChannel | undefined` — Возвращает базовый экземпляр `BroadcastChannel` (или `undefined` вне среды браузера).
-- `setCallback(callback: (event: MessageEvent<Message>) => void): this` — Обновляет или устанавливает функцию обратного вызова для получения сообщений.
-- `setCallbackError(callbackError: (event: MessageEvent<Message>) => void): this` — Обновляет или устанавливает функцию обратного вызова для ошибок сообщений.
+- `getChannel(): BroadcastChannel | undefined` — Возвращает базовый экземпляр `BroadcastChannel`.
+- `setCallback(callback: Function): this` — Обновляет функцию обработки входящих сообщений.
+- `setCallbackError(callbackError: Function): this` — Обновляет функцию обработки ошибок.
 
 ## Примеры
 
 ### Синхронизация состояния между вкладками
 
-```javascript
+```typescript
 import { BroadcastMessage } from '@dxtmisha/functional'
 
-// Во вкладке А и вкладке Б
-const authChannel = new BroadcastMessage('auth-status', (event) => {
+// Во всех вкладках приложения
+const authChannel = new BroadcastMessage<string>('auth-status', (event) => {
   if (event.data === 'LOGOUT') {
     authModule.clearSession()
-    window.location.href = '/login'
+    window.location.reload()
   }
 })
 
-// При выходе пользователя из системы во вкладке А
+// При выходе пользователя в одной из вкладок
 function onLogout() {
   authChannel.post('LOGOUT')
 }
 ```
 
-### Простая система уведомлений с обработкой ошибок
+### Обновление обработчика на лету
 
-```javascript
-const notifications = new BroadcastMessage(
-  'notifications',
-  (event) => showToast(event.data.message),
-  (error) => console.error('Не удалось получить уведомление:', error)
-)
+```typescript
+const messenger = new BroadcastMessage('data-sync')
 
-// Обновление обработчика ошибок позже
-notifications.setCallbackError((error) => {
-  logToService(error)
+messenger.setCallback((event) => {
+  console.log('Данные получены:', event.data)
 })
 
-// Вызов уведомления из любой части приложения
-notifications.post({ message: 'Получено новое сообщение!' })
+messenger.post({ id: 1, status: 'active' })
 ```

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

@@ -1,105 +1,86 @@
 import {Meta} from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/functional-basic/Classes/BroadcastMessage - Truyền tin BroadcastChannel'/>
+<Meta title='@dxtmisha/vi/functional-basic/Classes/BroadcastMessage - Tin nhắn BroadcastChannel'/>
 
 # Lớp BroadcastMessage
 
-Một lớp để xử lý việc truyền tin giữa các tab hoặc cửa sổ khác nhau bằng cách sử dụng API `BroadcastChannel`. Nó cung cấp một giao diện đơn giản để gửi và nhận thông điệp với sự hỗ trợ của hàm callback, xử lý lỗi và khả năng nhận diện môi trường thực thi.
+Lớp để xử lý tin nhắn giữa các ngữ cảnh trình duyệt khác nhau (tab, cửa sổ, iframe) bằng cách sử dụng API `BroadcastChannel`. Nó cung cấp một giao diện thuận tiện để gửi và nhận dữ liệu với việc quản lý vòng đời kênh tự động và xử lý lỗi.
+
+Bao gồm tính năng đặt tên tiền tố tự động để ngăn chặn xung đột và tích hợp với `ErrorCenter` để theo dõi các lỗi khởi tạo.
 
 ## Các tính năng chính
 
-- **Giao tiếp đa ngữ cảnh** — dễ dàng gửi thông điệp giữa các tab trình duyệt, cửa sổ hoặc iframe khác nhau trên cùng một origin.
-- **Dựa trên Callback** — đăng ký các hàm callback để tự động xử lý các thông điệp đến và lỗi.
-- **Nhận diện môi trường** — tự động kiểm tra môi trường DOM trước khi khởi tạo, giúp ngăn chặn lỗi trong các môi trường không phải trình duyệt.
-- **Tiền tố tên kênh** — tự động thêm tiền tố duy nhất vào tên kênh để tránh xung đột với các ứng dụng khác.
-- **An toàn kiểu dữ liệu** — hỗ trợ Generic trong TypeScript để định nghĩa kiểu dữ liệu của thông điệp.
-- **Tích hợp ErrorCenter** — báo cáo lỗi tập trung khi `BroadcastChannel` không khởi tạo được.
-- **Truy cập trực tiếp** — cung cấp quyền truy cập vào thực thể `BroadcastChannel` gốc khi cần thiết.
+- **Giao tiếp đa ngữ cảnh** — đồng bộ hóa dữ liệu đơn giản giữa tất cả các cửa sổ của cùng một nguồn (origin).
+- **Dựa trên Callback** — tự động xử lý các tin nhắn đến và lỗi thông qua các hàm callback đã đăng ký.
+- **An toàn khi thực thi** — kiểm tra môi trường DOM tích hợp giúp ngăn chặn lỗi trong quá trình Server-Side Rendering (SSR).
+- **Cô lập kênh** — tự động thêm tiền tố duy nhất cho tên kênh thông qua `DataStorage`.
+- **Kiểu dữ liệu mạnh mẽ** — hỗ trợ đầy đủ TypeScript generics để đảm bảo tính toàn vẹn của dữ liệu tin nhắn.
 
 ## Khởi tạo
 
 Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `BroadcastMessage(name, callback, callbackError, errorCenter)`.
 
-### Generic Constraints
+### Ràng buộc Generic (Generic Constraints)
 
-- `Message = any` — kiểu dữ liệu của tải trọng thông điệp.
+- `Message = any` — kiểu của tải trọng tin nhắn.
 
 **Tham số:**
-- `name: string` — tên duy nhất của kênh truyền tin.
-- `callback?: (event: MessageEvent<Message>) => void` — hàm callback được thực thi khi nhận được thông điệp.
-- `callbackError?: (event: MessageEvent<Message>) => void` — hàm callback được thực thi khi xảy ra lỗi thông điệp.
-- `errorCenter: ErrorCenterInstance` — thực thể của trung tâm lỗi để kích hoạt các sự kiện (mặc định: `ErrorCenter.getItem()`).
+- `name: string` — tên kênh duy nhất.
+- `callback?: (event: MessageEvent<Message>) => void` — hàm callback được thực thi khi nhận được tin nhắn.
+- `callbackError?: (event: MessageEvent<Message>) => void` — hàm callback được thực thi khi xảy ra lỗi tin nhắn.
+- `errorCenter: ErrorCenterInstance` — thực thể trung tâm lỗi (mặc định: `ErrorCenter.getItem()`).
 
 ```typescript
-import { BroadcastMessage } from '@dxtmisha/functional'
+import { BroadcastMessage } from '@dxtmisha/functional-basic'
 
-// 1. Khởi tạo với việc xử lý dữ liệu đến
-const messenger = new BroadcastMessage(
+const messenger = new BroadcastMessage<string>(
   'my-channel',
-  (event) => console.log('Đã nhận:', event.data),
-  (error) => console.error('Lỗi:', error)
+  (event) => console.log('Nhận được:', event.data)
 )
-
-// 2. Gửi một thông điệp
-messenger.post({ type: 'UPDATE', value: 100 })
 ```
 
-## Gửi thông điệp
+## Các phương thức
 
-### `post`
+### Hành động
 
-Gửi một thông điệp đến tất cả các trình lắng nghe trên cùng một kênh.
+- `post(message: Message): this` — Gửi tin nhắn đến tất cả những người đang lắng nghe trong kênh đã cho.
+- `destroy(): this` — Đóng kênh và ngừng lắng nghe tin nhắn.
 
-**Tham số:**
-- `message: Message` — dữ liệu cần gửi.
-
-**Trả về:** `this` — để hỗ trợ gọi chuỗi phương thức (method chaining).
+### Cấu hình và Truy cập
 
-```javascript
-messenger.post({ type: 'UPDATE', payload: { id: 123 } })
-```
+- `getChannel(): BroadcastChannel | undefined` — Trả về thực thể `BroadcastChannel` cơ bản.
+- `setCallback(callback: Function): this` — Cập nhật hàm xử lý tin nhắn đến.
+- `setCallbackError(callbackError: Function): this` — Cập nhật hàm xử lý lỗi tin nhắn.
 
-## Cấu hình và Truy cập
+## Ví dụ
 
-- `getChannel(): BroadcastChannel | undefined` — Trả về thực thể `BroadcastChannel` gốc (hoặc `undefined` nếu ngoài môi trường DOM).
-- `setCallback(callback: (event: MessageEvent<Message>) => void): this` — Cập nhật hoặc thiết lập hàm callback để nhận thông điệp.
-- `setCallbackError(callbackError: (event: MessageEvent<Message>) => void): this` — Cập nhật hoặc thiết lập hàm callback cho các lỗi thông điệp.
+### Đồng bộ hóa trạng thái giữa các Tab
 
-## Các ví dụ điển hình
-
-### Đồng bộ hóa trạng thái giữa các tab
-
-```javascript
+```typescript
 import { BroadcastMessage } from '@dxtmisha/functional'
 
-// Trong Tab A và Tab B
-const authChannel = new BroadcastMessage('auth-status', (event) => {
+// Trong tất cả các tab của ứng dụng
+const authChannel = new BroadcastMessage<string>('auth-status', (event) => {
   if (event.data === 'LOGOUT') {
     authModule.clearSession()
-    window.location.href = '/login'
+    window.location.reload()
   }
 })
 
-// Khi người dùng đăng xuất ở Tab A
+// Khi người dùng đăng xuất ở một trong các tab
 function onLogout() {
   authChannel.post('LOGOUT')
 }
 ```
 
-### Hệ thống thông báo đơn giản với xử lý lỗi
+### Cập nhật trình xử lý dữ liệu tức thì
 
-```javascript
-const notifications = new BroadcastMessage(
-  'notifications',
-  (event) => showToast(event.data.message),
-  (error) => console.error('Không thể nhận thông báo:', error)
-)
+```typescript
+const messenger = new BroadcastMessage('data-sync')
 
-// Cập nhật trình xử lý lỗi sau này
-notifications.setCallbackError((error) => {
-  logToService(error)
+messenger.setCallback((event) => {
+  console.log('Dữ liệu mới nhận được:', event.data)
 })
 
-// Kích hoạt thông báo từ bất kỳ đâu trong ứng dụng
-notifications.post({ message: 'Đã nhận tin nhắn mới!' })
+messenger.post({ id: 1, status: 'active' })
 ```

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

@@ -4,6 +4,8 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Cache Class
 
+> **⚠️ Deprecated** — This class is obsolete and should not be used. / Этот класс устарел и не рекомендуется к использованию.
+
 A lightweight, memory-based caching mechanism. It provides an efficient way to execute expensive data-fetching functions only when necessary, relying on "comparison arrays" to trigger cache invalidation and recalculation.
 
 ## Key Features
@@ -26,9 +28,11 @@ const cache = new Cache()
 const user = cache.get('user', () => 'Admin', [1])
 ```
 
-## Data Retrieval
+## Methods
+
+### Action
 
-### `get`
+#### `get`
 
 Use the `get()` method to retrieve a cached value or calculate it if it doesn't exist or is stale.
 
@@ -53,7 +57,7 @@ const unchanged = cache.get('user', () => `User ${++counter}`, [1])
 const changed = cache.get('user', () => `User ${++counter}`, [2])
 ```
 
-### `getAsync`
+#### `getAsync`
 
 Functions identically to `get()`, but designed for async calls.
 
@@ -81,4 +85,3 @@ const u1Cached = await fetchUser(5)
 // Dependency `id` changed (5 !== 6), hits the network again
 const u2 = await fetchUser(6)
 ```
-

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

@@ -4,6 +4,8 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс Cache
 
+> **⚠️ Устарел** — Этот класс устарел и не рекомендуется к использованию.
+
 Легковесный механизм кэширования в памяти. Он предоставляет эффективный способ выполнения ресурсоемких функций получения данных только при необходимости, полагаясь на «массивы сравнения» для запуска инвалидации и пересчета кэша.
 
 ## Ключевые особенности
@@ -26,9 +28,11 @@ const cache = new Cache()
 const user = cache.get('user', () => 'Admin', [1])
 ```
 
-## Получение данных
+## Методы
+
+### Действие
 
-### `get`
+#### `get`
 
 Используйте метод `get()` для получения кэшированного значения или его вычисления, если оно не существует или устарело.
 
@@ -53,7 +57,7 @@ const unchanged = cache.get('user', () => `Пользователь ${++counter}
 const changed = cache.get('user', () => `Пользователь ${++counter}`, [2])
 ```
 
-### `getAsync`
+#### `getAsync`
 
 Работает идентично `get()`, но предназначен для асинхронных вызовов.
 
@@ -81,4 +85,3 @@ const u1Cached = await fetchUser(5)
 // Зависимость `id` изменилась (5 !== 6), снова идет в сеть
 const u2 = await fetchUser(6)
 ```
-

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

@@ -4,13 +4,15 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Lớp Cache
 
-Một cơ chế caching dựa trên lưu trữ bộ nhớ nhẹ. Chức năng này cung cấp cách làm hiệu quả để thực thi các tác vụ hay hàm tìm nạp dữ liệu tiêu tốn năng lượng hoạt động và thời gian chỉ khi thực sự cần thiết, phụ thuộc vào "mảng so sánh" (comparison array) để tiến hành invalidation cache cũng như việc tính toán ghi đè lại.
+> **⚠️ Đã lỗi thời** — Lớp này đã lỗi thời và không nên được sử dụng.
+
+Một cơ chế lưu trữ đệm trong bộ nhớ (memory-based) nhẹ nhàng. Nó cung cấp một cách hiệu quả để thực thi các hàm truy xuất dữ liệu tốn kém chỉ khi cần thiết, dựa trên "mảng so sánh" (comparison arrays) để kích hoạt việc hủy bỏ và tính toán lại bộ nhớ đệm.
 
 ## Các tính năng chính
 
-- **Thực thi trên nhu cầu (On-Demand Evaluation)** — các function chỉ chạy khi không tìm thấy bộ nhớ cache mong muốn do rỗng hoặc vô hiệu (invalidation).
-- **Vô hiệu qua phép so sánh mảng** — Cache module sẽ tự vô hiệu và tiến hành nạp lại hoàn toàn dữ liệu vào array nếu giá trị phần tử thuộc mảng nhận chỉ định không giống với lúc lưu. Chức năng khá giống dependency arrays ở `useEffect` hoặc `useMemo` của React.
-- **Hỗ trợ chạy Async** — quá trình đồng bộ hoạt động dựa vào cách kết nối của phương pháp `Promise`.
+- **Đánh giá theo yêu cầu** — các hàm chỉ được thực thi khi giá trị được lưu trong bộ nhớ đệm bị thiếu hoặc bị hủy bỏ.
+- **Hủy bỏ theo mảng so sánh** — tự động tính toán lại bộ nhớ đệm nếu mảng phụ thuộc được cung cấp thay đổi (tương tự như mảng phụ thuộc của `useMemo` hoặc `useEffect` trong React).
+- **Hỗ trợ không đồng bộ** — hoạt động liền mạch với việc truy xuất dữ liệu dựa trên `Promise`.
 
 ## Khởi tạo
 
@@ -26,43 +28,45 @@ const cache = new Cache()
 const user = cache.get('user', () => 'Admin', [1])
 ```
 
-## Lấy dữ liệu
+## Các phương thức
+
+### Hành động
 
-### `get`
+#### `get`
 
-Sử dụng phương thức `get()` kết nối trực tiếp với giá trị cache được gắn cố định hoặc thay mới ngay nếu dữ liệu hiện thuộc trạng thái lưu đã ngừng hoạt động/quá hạn/bị lỗi (stale block).
+Sử dụng phương thức `get()` để truy xuất một giá trị được lưu trong bộ nhớ đệm hoặc tính toán nó nếu nó không tồn tại hoặc đã cũ.
 
 **Tham số:**
-- `name: string` — mã định danh để nạp bộ nhớ đệm cache.
-- `callback: () => T` — đoạn code (function) định nghĩa cho mảng trả về (value computation).
-- `comparison?: any[]` — thiết lập phụ array lưu trữ độ gắn kết. Nếu nhận thấy biến bên mảng khác hoàn toàn sau bước thực hiện lấy cache gần nhất thì class tự reset tính hợp lệ và cho hàm `callback` rà lại quá trình khởi tạo một lần nữa.
+- `name: string` — một mã định danh duy nhất cho mục nhập bộ nhớ đệm.
+- `callback: () => T` — hàm tính toán giá trị.
+- `comparison?: any[]` — mảng phụ thuộc tùy chọn. Nếu bất kỳ giá trị nào trong mảng này thay đổi so với lần gọi cuối cùng, bộ nhớ đệm sẽ bị hủy và `callback` sẽ chạy lại.
 
-**Trả về:** `T` — dữ liệu cache.
+**Trả về:** `T` — giá trị đã lưu đệm hoặc giá trị mới được tính toán.
 
 ```javascript
 let counter = 0
 
-// Tính và thiết lập cache nhận: "User 1"
+// Sẽ đánh giá và lưu trữ "User 1"
 const user1 = cache.get('user', () => `User ${++counter}`, [1])
 
-// KHÔNG CHẠY CODE, chỉ kéo cache được ghi từ "User 1"
+// KHÔNG đánh giá lại, trả về "User 1" đã lưu đệm
 const unchanged = cache.get('user', () => `User ${++counter}`, [1])
 
-// Mảng gắn kết thay đổi từ [1] sang [2]
-// Xóa cache và nạp vào: "User 2"
+// Mảng phụ thuộc thay đổi từ [1] thành [2]
+// Sẽ đánh giá lại và lưu trữ "User 2"
 const changed = cache.get('user', () => `User ${++counter}`, [2])
 ```
 
-### `getAsync`
+#### `getAsync`
 
-Tương tự như `get()` nhưng cấu hình định hướng đến Async calls.
+Hoạt động tương tự như `get()`, nhưng được thiết kế cho các cuộc gọi không đồng bộ.
 
 **Tham số:**
-- `name: string` — mã định danh bộ nhớ.
-- `callback: () => Promise<T>` — hàm bất đồng bộ trả về kết quả.
-- `comparison?: any[]` — danh sách các đối tượng kèm theo.
+- `name: string` — một mã định danh duy nhất cho mục nhập bộ nhớ đệm.
+- `callback: () => Promise<T>` — hàm không đồng bộ tính toán giá trị.
+- `comparison?: any[]` — mảng phụ thuộc tùy chọn.
 
-**Trả về:** `Promise<T>` — dữ liệu `Promise` được tạo mới hoặc lấy từ cache.
+**Trả về:** `Promise<T>` — giá trị không đồng bộ đã lưu đệm hoặc giá trị mới được tính toán.
 
 ```javascript
 async function fetchUser(id) {
@@ -72,13 +76,12 @@ async function fetchUser(id) {
   }, [id])
 }
 
-// Bắn thông tin vào luồng network ban đầu
+// Cuộc gọi đầu tiên truy cập mạng
 const u1 = await fetchUser(5)
 
-// Chạy lại hàm cũ gọi trực tiếp từ cache đã tạo
+// Cuộc gọi thứ hai trả về dữ liệu đã lưu đệm ngay lập tức (không truy cập mạng)
 const u1Cached = await fetchUser(5)
 
-// Tham số gắn kết biến đổi `id` đã chạy (5 !== 6), bắn luồng lên node mới
+// Phụ thuộc `id` thay đổi (5 !== 6), truy cập mạng một lần nữa
 const u2 = await fetchUser(6)
 ```
-