@dxtmisha/wiki 0.39.7 → 0.56.0

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

@@ -6,23 +6,31 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 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.
 
+> `DataStorage` là một **lớp phụ trợ**, được thiết kế để tương tác cấp thấp với bộ nhớ trình duyệt. Trong hầu hết các trường hợp, bạn nên sử dụng các lớp cấp cao hơn như `Cookie` hoặc `Api` cho các nhu cầu dữ liệu cụ thể.
+
 ## 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.
+- **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.
+- **Hỗ trợ SSR** — sử dụng cơ chế cách ly theo từng request trong quá trình render phía server để ngăn chặn rò rỉ dữ liệu giữa các phiên làm việc song song.
 
 ## Khởi tạo
 
 Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `DataStorage(name, isSession)`.
 
+### Ràng buộc Generic (Generic Constraints)
+
+Lớp hỗ trợ generic sau để đảm bảo kiểm soát kiểu dữ liệu nghiêm ngặt cho giá trị được lưu trữ:
+- `T` — Kiểu dữ liệu của giá trị được lưu trữ.
+
 **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'
+import { DataStorage } from '@dxtmisha/functional-basic'
 
 // 1. Tạo một thực thể cho localStorage
 const settings = new DataStorage('settings')
@@ -31,25 +39,31 @@ const settings = new DataStorage('settings')
 const session = new DataStorage('user_session', true)
 ```
 
-## Cách sử dụng Cơ bản
+## Các phương thức
 
-## Cấu hình toàn cục
+### Truy cập Bộ lưu trữ
 
-- `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`.
+- `get(defaultValue?: T | (() => T), cache?: number): T | undefined` — Truy xuất giá trị hiện được lưu trữ. Nếu thời gian cache được cung cấp, nó sẽ trả về `undefined` nếu dữ liệu đã quá hạn.
+- `set(value?: T | (() => T)): T | undefined` — Thiết lập hoặc cập nhật giá trị trong cơ chế lưu trữ. Truyền `undefined` sẽ xóa mục đó.
+- `remove(): this` — Xóa khóa tương ứng khỏi môi trường lưu trữ và thực thể trong bộ nhớ.
+- `update(): this` — Buộc thực thể bộ nhớ phải đồng bộ hóa với dữ liệu thô hiện tại bên trong các Storage API vật lý.
 
-## Quản lý dữ liệu
+### Cấu hình
 
-### `get`
+- `static setPrefix(newPrefix: string): void` — Thay đổi tiền tố toàn cục áp dụng cho các thực thể mới. Tiền tố mặc định là `ui-storage`.
 
-Truy xuất cấu hình đã phân tích hiện tại được lưu lại từ trước.
+## SSR và Hydration
 
-**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ữ.
+Lớp `DataStorage` hoàn toàn tương thích với Server-Side Rendering (SSR). Nó sử dụng một registry đặc biệt để cách ly các instance giữa các HTTP request khác nhau trên server.
 
-**Trả về:** `T | undefined` — giá trị được lưu trữ hoặc `undefined`.
+> Để tránh lỗi hydration (khi HTML render từ server khác với client), bạn nên gọi phương thức `get()` bên trong `useEffect` hoặc các hook chỉ chạy ở client. Trên server, `get()` sẽ luôn trả về `undefined` (hoặc `defaultValue`) vì `localStorage` không khả dụng.
 
+## Ví dụ
+
+### Sử dụng Giá trị Mặc định và Cache
 ```javascript
+const settings = new DataStorage('user_settings')
+
 // Lấy dữ liệu, trả về object rỗng nếu không tìm thấy
 const currentSettings = settings.get({})
 
@@ -57,20 +71,11 @@ const currentSettings = settings.get({})
 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ữ.
-
+### Đồng bộ hóa Thủ công
 ```javascript
-settings.set({ theme: 'dark', notifications: true })
-```
-
-## Các phương thức bổ sung
+const storage = new DataStorage('shared_data')
 
-- `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ý.
+// ... dữ liệu có thể đã thay đổi trong một tab khác hoặc phần khác của ứng dụng
+storage.update() // Đồng bộ hóa bộ nhớ với ổ đĩa
+console.log(storage.get())
+```

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

@@ -46,7 +46,7 @@ const fromTs = new Datetime(1710460800000)
 - `getHoursType(): GeoHours` — Determines the hour format (12 or 24) for the current locale.
 - `getHour24(): boolean` — Returns the current setting for displaying the 24-hour format.
 - `getTimeZoneOffset(): number` — Returns the time zone offset in minutes.
-- `getTimeZone(style?: GeoTimeZoneStyle): string` — Returns the time zone (supports `minute`, `hour`, `RFC` styles).
+- `getTimeZone(style?: GeoTimeZoneStyle): string` — Returns the time zone (supports `minute`, `hour`, `RFC` styles; default format with colon).
 - `getFirstDayCode(): GeoFirstDay` — Returns the code for the first day of the week (0 for Sunday, 1 for Monday, 6 for Saturday).
 
 ### Value Retrieval
@@ -57,7 +57,7 @@ const fromTs = new Datetime(1710460800000)
 - `getHour(): number` — Returns the hours.
 - `getMinute(): number` — Returns the minutes.
 - `getSecond(): number` — Returns the seconds.
-- `getMaxDay(): number` — Returns the number of days in the current month.
+- `getMaxDay(): number` — Returns the number of the last day of the current month (28-31).
 
 ### Value Setting
 
@@ -92,7 +92,7 @@ Modify the current `Datetime` object.
 - `moveWeekdayFirst(): this` — Move to the first day of the current week.
 - `moveWeekdayLast(): this` — Move to the last day of the current week.
 - `moveWeekdayFirstByMonth(): this` — Move to the first day of the first week of the month.
-- `moveWeekdayLastByMonth(): this` — Move to the first day of the first full week of the next month.
+- `moveWeekdayLastByMonth(): this` — Move to the last day of the last week of the current month.
 - `moveWeekdayNext(): this` — Shift one week forward.
 - `moveWeekdayPrevious(): this` — Shift one week backward.
 - `moveDayFirst(): this` — Move to the first day of the current month.
@@ -113,7 +113,7 @@ Create copies of the data.
 - `cloneWeekdayFirst(): Datetime` — Copy set to the beginning of the current week.
 - `cloneWeekdayLast(): Datetime` — Copy set to the end of the current week.
 - `cloneWeekdayFirstByMonth(): Datetime` — Copy to the beginning of the first week of the month.
-- `cloneWeekdayLastByMonth(): Datetime` — Copy to the beginning of the last week of the month.
+- `cloneWeekdayLastByMonth(): Datetime` — Copy to the end of the last week of the month.
 - `cloneWeekdayNext(): Datetime` — Copy with a shift of one week forward.
 - `cloneWeekdayPrevious(): Datetime` — Copy with a shift of one week backward.
 - `cloneDayFirst(): Datetime` — Copy to the first day of the current month.
@@ -159,6 +159,38 @@ dt.standard() // "2024-03-15T00:00:00+03:00"
 dt.standard(false) // "2024-03-15T00:00:00"
 ```
 
+## SSR and Hydration
+
+> **Warning (SSR):** Creating a `Datetime` instance without a specific date (using the current time) for rendering in SSR may lead to hydration mismatches because the time or time zone on the server may differ from the time on the client.
+
+### Recommended Practices
+
+When using `Datetime` in SSR environments:
+
+1. **Always provide specific dates**: Pass explicit dates to the constructor instead of relying on the current time.
+
+2. **Use server-side date initialization**: Initialize dates on the server with specific values to ensure consistency.
+
+3. **Client-side only for dynamic dates**: For dates that need to show the current time, initialize them only on the client side (e.g., in `useEffect`).
+
+4. **Consider timezone differences**: Be aware that server and client timezones may differ, affecting date calculations and formatting.
+
+### Example of Safe SSR Usage
+
+```javascript
+// ✅ Good: Specific date for SSR
+const serverDate = new Datetime('2024-03-15')
+
+// ✅ Good: Initialize on client for current time
+useEffect(() => {
+  const now = new Datetime()
+  setCurrentTime(now.locale('datetime'))
+}, [])
+
+// ❌ Avoid: Current time in SSR
+const now = new Datetime() // May cause hydration mismatch
+```
+
 ## Usage Examples
 
 ### Working with Intervals and Navigation

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

@@ -46,7 +46,7 @@ const fromTs = new Datetime(1710460800000)
 - `getHoursType(): GeoHours` — Определяет формат часов (12 или 24) для текущей локали.
 - `getHour24(): boolean` — Возвращает текущую настройку отображения 24-часового формата.
 - `getTimeZoneOffset(): number` — Возвращает смещение часового пояса в минутах.
-- `getTimeZone(style?: GeoTimeZoneStyle): string` — Возвращает часовой пояс (поддерживает стили `minute`, `hour`, `RFC`).
+- `getTimeZone(style?: GeoTimeZoneStyle): string` — Возвращает часовой пояс (поддерживает стили `minute`, `hour`, `RFC`; по умолчанию формат с двоеточием).
 - `getFirstDayCode(): GeoFirstDay` — Возвращает код первого дня недели (0 для воскресенья, 1 для понедельника, 6 для субботы).
 
 ### Получение значений
@@ -57,7 +57,7 @@ const fromTs = new Datetime(1710460800000)
 - `getHour(): number` — Возвращает часы.
 - `getMinute(): number` — Возвращает минуты.
 - `getSecond(): number` — Возвращает секунды.
-- `getMaxDay(): number` — Возвращает количество дней в текущем месяце.
+- `getMaxDay(): number` — Возвращает число последнего дня текущего месяца (28-31).
 
 ### Установка значений
 
@@ -92,7 +92,7 @@ const fromTs = new Datetime(1710460800000)
 - `moveWeekdayFirst(): this` — Переход к первому дню текущей недели.
 - `moveWeekdayLast(): this` — Переход к последнему дню текущей недели.
 - `moveWeekdayFirstByMonth(): this` — Переход к первому дню первой недели месяца.
-- `moveWeekdayLastByMonth(): this` — Переход к первому дню первой полной недели следующего месяца.
+- `moveWeekdayLastByMonth(): this` — Переход к последнему дню последней недели текущего месяца.
 - `moveWeekdayNext(): this` — Смещение на одну неделю вперед.
 - `moveWeekdayPrevious(): this` — Смещение на одну неделю назад.
 - `moveDayFirst(): this` — Переход к первому числу текущего месяца.
@@ -113,7 +113,7 @@ const fromTs = new Datetime(1710460800000)
 - `cloneWeekdayFirst(): Datetime` — Копия, установленная на начало текущей недели.
 - `cloneWeekdayLast(): Datetime` — Копия, установленная на конец текущей недели.
 - `cloneWeekdayFirstByMonth(): Datetime` — Копия на начало первой недели месяца.
-- `cloneWeekdayLastByMonth(): Datetime` — Копия на начало последней недели месяца.
+- `cloneWeekdayLastByMonth(): Datetime` — Копия на конец последней недели месяца.
 - `cloneWeekdayNext(): Datetime` — Копия со сдвигом на неделю вперед.
 - `cloneWeekdayPrevious(): Datetime` — Копия со сдвигом на неделю назад.
 - `cloneDayFirst(): Datetime` — Копия на первое число текущего месяца.
@@ -159,6 +159,38 @@ dt.standard() // "2024-03-15T00:00:00+03:00"
 dt.standard(false) // "2024-03-15T00:00:00"
 ```
 
+## SSR и Гидратация
+
+> **Внимание (SSR):** Создание экземпляра `Datetime` без указания конкретной даты (использование текущего времени) для отрисовки в SSR может привести к ошибкам гидратации, так как время или часовой пояс сервера могут отличаться от времени на стороне клиента.
+
+### Рекомендуемые практики
+
+При использовании `Datetime` в SSR-окружениях:
+
+1. **Всегда указывайте конкретные даты**: Передавайте явные даты в конструктор вместо использования текущего времени.
+
+2. **Используйте инициализацию даты на сервере**: Инициализируйте даты на сервере с конкретными значениями для обеспечения согласованности.
+
+3. **Только клиентская инициализация для динамических дат**: Для дат, которые должны показывать текущее время, инициализируйте их только на стороне клиента (например, в `useEffect`).
+
+4. **Учитывайте различия часовых поясов**: Помните, что часовые пояса сервера и клиента могут отличаться, что влияет на вычисления и форматирование дат.
+
+### Пример безопасного использования в SSR
+
+```javascript
+// ✅ Хорошо: Конкретная дата для SSR
+const serverDate = new Datetime('2024-03-15')
+
+// ✅ Хорошо: Инициализация на клиенте для текущего времени
+useEffect(() => {
+  const now = new Datetime()
+  setCurrentTime(now.locale('datetime'))
+}, [])
+
+// ❌ Избегайте: Текущее время в SSR
+const now = new Datetime() // Может вызвать ошибку гидратации
+```
+
 ## Примеры использования
 
 ### Работа с интервалами и навигацией

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

@@ -46,7 +46,7 @@ const fromTs = new Datetime(1710460800000)
 - `getHoursType(): GeoHours` — Xác định định dạng giờ (12 hoặc 24) cho địa phương hiện tại.
 - `getHour24(): boolean` — Trả về thiết lập hiện tại cho việc hiển thị định dạng 24 giờ.
 - `getTimeZoneOffset(): number` — Trả về độ lệch múi giờ tính bằng phút.
-- `getTimeZone(style?: GeoTimeZoneStyle): string` — Trả về múi giờ (hỗ trợ các kiểu `minute`, `hour`, `RFC`).
+- `getTimeZone(style?: GeoTimeZoneStyle): string` — Trả về múi giờ (hỗ trợ các kiểu `minute`, `hour`, `RFC`; định dạng mặc định với dấu hai chấm).
 - `getFirstDayCode(): GeoFirstDay` — Trả về mã cho ngày đầu tiên của tuần (0 cho Chủ Nhật, 1 cho Thứ Hai, 6 cho Thứ Bảy).
 
 ### Lấy giá trị
@@ -57,7 +57,7 @@ const fromTs = new Datetime(1710460800000)
 - `getHour(): number` — Trả về giờ.
 - `getMinute(): number` — Trả về phút.
 - `getSecond(): number` — Trả về giây.
-- `getMaxDay(): number` — Trả về số ngày trong tháng hiện tại.
+- `getMaxDay(): number` — Trả về số của ngày cuối cùng trong tháng hiện tại (28-31).
 
 ### Thiết lập giá trị
 
@@ -92,7 +92,7 @@ Thay đổi đối tượng `Datetime` hiện tại.
 - `moveWeekdayFirst(): this` — Chuyển đến ngày đầu tiên của tuần hiện tại.
 - `moveWeekdayLast(): this` — Chuyển đến ngày cuối cùng của tuần hiện tại.
 - `moveWeekdayFirstByMonth(): this` — Chuyển đến ngày đầu tiên của tuần đầu tiên trong tháng.
-- `moveWeekdayLastByMonth(): this` — Chuyển đến ngày đầu tiên của tuần đầy đủ đầu tiên của tháng tiếp theo.
+- `moveWeekdayLastByMonth(): this` — Chuyển đến ngày cuối cùng của tuần cuối cùng trong tháng hiện tại.
 - `moveWeekdayNext(): this` — Dịch chuyển một tuần về phía trước.
 - `moveWeekdayPrevious(): this` — Dịch chuyển một tuần về phía sau.
 - `moveDayFirst(): this` — Chuyển đến ngày đầu tiên của tháng hiện tại.
@@ -113,7 +113,7 @@ Tạo bản sao của dữ liệu.
 - `cloneWeekdayFirst(): Datetime` — Sao chép được thiết lập vào đầu tuần hiện tại.
 - `cloneWeekdayLast(): Datetime` — Sao chép được thiết lập vào cuối tuần hiện tại.
 - `cloneWeekdayFirstByMonth(): Datetime` — Sao chép đến đầu tuần đầu tiên của tháng.
-- `cloneWeekdayLastByMonth(): Datetime` — Sao chép đến đầu tuần cuối cùng của tháng.
+- `cloneWeekdayLastByMonth(): Datetime` — Sao chép đến cuối tuần cuối cùng của tháng.
 - `cloneWeekdayNext(): Datetime` — Sao chép với việc dịch chuyển một tuần về phía trước.
 - `cloneWeekdayPrevious(): Datetime` — Sao chép với việc dịch chuyển một tuần về phía sau.
 - `cloneDayFirst(): Datetime` — Sao chép đến ngày đầu tiên của tháng hiện tại.
@@ -159,6 +159,38 @@ dt.standard() // "2024-03-15T00:00:00+03:00"
 dt.standard(false) // "2024-03-15T00:00:00"
 ```
 
+## SSR và Hydration
+
+> **Cảnh báo (SSR):** Việc tạo một thực thể `Datetime` mà không có ngày cụ thể (sử dụng thời gian hiện tại) để render trong SSR có thể dẫn đến lỗi hydration mismatch vì thời gian hoặc múi giờ trên máy chủ có thể khác với thời gian trên máy khách.
+
+### Thực tiễn khuyến nghị
+
+Khi sử dụng `Datetime` trong môi trường SSR:
+
+1. **Luôn cung cấp ngày cụ thể**: Truyền ngày cụ thể vào hàm khởi tạo thay vì sử dụng thời gian hiện tại.
+
+2. **Sử dụng khởi tạo ngày ở phía máy chủ**: Khởi tạo ngày ở máy chủ với các giá trị cụ thể để đảm bảo tính nhất quán.
+
+3. **Chỉ khởi tạo ở phía máy khách cho ngày động**: Đối với ngày cần hiển thị thời gian hiện tại, chỉ khởi tạo ở phía máy khách (ví dụ: trong `useEffect`).
+
+4. **Cân nhắc sự khác biệt múi giờ**: Lưu ý rằng múi giờ máy chủ và máy khách có thể khác nhau, ảnh hưởng đến tính toán và định dạng ngày.
+
+### Ví dụ về sử dụng an toàn trong SSR
+
+```javascript
+// ✅ Tốt: Ngày cụ thể cho SSR
+const serverDate = new Datetime('2024-03-15')
+
+// ✅ Tốt: Khởi tạo ở máy khách cho thời gian hiện tại
+useEffect(() => {
+  const now = new Datetime()
+  setCurrentTime(now.locale('datetime'))
+}, [])
+
+// ❌ Tránh: Thời gian hiện tại trong SSR
+const now = new Datetime() // Có thể gây lỗi hydration
+```
+
 ## Ví dụ sử dụng
 
 ### Làm việc với Khoảng thời gian và Điều hướng

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

@@ -2,94 +2,125 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/en/functional-basic/Classes/ErrorCenter - Error Management'/>
 
-# ErrorCenter
+# ErrorCenter Class
 
-A static wrapper for `ErrorCenterInstance` providing centralized management for error storage, retrieval, and event-based handling. It acts as a global registry for error causes and provides a mechanism to register and trigger custom handlers for different error groups.
+`ErrorCenter` is the central tool for managing all errors in the application. It allows you to register possible error causes in one place, configure the reaction to them (e.g., showing notifications), and trigger them from any part of the code.
 
-The class follows the "Static Bridge" pattern, delegating all operations to a singleton instance while maintaining a clean, globally accessible API.
+The class acts as a static bridge (Static Bridge), directing all requests to a single `ErrorCenterInstance`.
 
-## Key Features
+## Methods
 
-- **Static Access** — Global access to error management without the need for manual instantiation.
-- **Centralized Registry** — Stores standardized error causes (labels and messages) for consistent UI feedback.
-- **Group-Based Handling** — Allows registering multiple callbacks for specific error categories.
-- **Chainable API** — Methods for adding causes and handlers support fluent interface design.
-- **Predefined Defaults** — Comes pre-configured with standard network error causes (`timeout`, `offline`, `notFound`, etc.).
+### Action
+- `on(cause: ErrorCenterCauseItem): void` — Starts the processing. Searches the registry, merges data, and calls the appropriate callbacks.
 
-## Check Methods
+### Verification
+- `has(code: string, group?: string): boolean` — Checks if an error is registered.
+- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Returns error data from the registry.
 
-- `has(code: string, group?: string): boolean` — Checks if an error cause exists in the registry.
-- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Retrieves the full error cause object.
+### Configuration
+- `add(cause: ErrorCenterCauseItem): void` — Adds a single error cause.
+- `addList(causes: ErrorCenterCauseList): void` — Adds a list of errors (batch registration).
+- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): void` — Registers a reaction to a group of errors.
+- `addHandlerList(handlers: ErrorCenterHandlerList): void` — Batch registration of several handlers.
 
-## Instance Retrieval
-
-- `getItem(): ErrorCenterInstance` — Returns the underlying instance used by the static wrapper.
-
-## Configuration
-
-- `add(cause: ErrorCenterCauseItem): this` — Adds a single error cause to the global storage.
-- `addList(causes: ErrorCenterCauseList): this` — Adds multiple error causes to the registry at once.
-- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Registers a callback function for a specific group.
-- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Registers a batch of handlers.
-
-## Action Methods
-
-### `on`
-
-Triggers error handling for the specified cause. It merges the provided cause with stored data (if any), executes all registered handlers for the group, and logs the error to the console.
-
-**Parameters:**
-- `cause: ErrorCenterCauseItem` — The cause to trigger. Only `code` and `group` are required if the cause was previously registered via `add()`.
-
-**Returns:** `this`
+### Auxiliary
+- `getItem(): ErrorCenterInstance` — Returns the internal instance of the class.
 
 ## Types
 
-### `ErrorCenterCauseItem`
-
-The main object used to define an error cause.
+#### `ErrorCenterGroup`
+Group name (e.g., 'api', 'auth') or `undefined` for a general handler.
 
-- `group?: ErrorCenterGroup` — The category/group the error belongs to.
-- `code: string` — Unique identifier for the error.
-- `label?: string` — Human-readable name of the error.
-- `message?: string` — Detailed description of the error.
-- `details?: any` — Optional object for additional context or technical data.
+#### `ErrorCenterCauseItem`
+Object describing an error: `group`, `code` (required), `priority`, `label`, `message`, `details`.
 
-### `ErrorCenterGroup`
+## Usage Guide
 
-A simple type definition for categorizing errors: `string | undefined`.
-
-## Default Error Causes
-
-The `ErrorCenter` is automatically populated with these standard network-related causes:
+### Step 1: Registration (Registry)
+Create an error dictionary to store texts separately from the code.
+```typescript
+ErrorCenter.add({
+  group: 'auth',
+  code: 'LOGIN_FAILED',
+  label: 'Login Failed',
+  message: 'Invalid password.'
+})
+```
 
-- `unknown` — **Unknown Error**: An unexpected error occurred. Please try again.
-- `timeout` — **Request Timeout**: The request took too long. Please check your connection.
-- `offline` — **No Connection**: You are offline. Please check your internet connection.
-- `notFound` — **Not Found**: The requested resource could not be found.
-- `server` — **Server Error**: Internal server error occurred.
+### Step 2: Subscription (Handlers)
+Specify how the application should react to an error group.
+```typescript
+ErrorCenter.addHandler('auth', (cause) => {
+  alert(cause.message);
+});
+```
 
-## Usage Example
+### Step 3: Execution (Execution)
+Trigger the error by its code and group.
+```typescript
+ErrorCenter.on({ group: 'auth', code: 'LOGIN_FAILED' });
+```
 
-```javascript
+## Standard Error Causes
+
+The class already contains pre-defined descriptions for common situations.
+
+#### API Group (`api`)
+Used for network request errors.
+- **forbidden** — Forbidden (403).
+- **notFound** — Resource not found (404).
+- **offline** — No internet connection.
+- **server** — Internal server error (500).
+- **timeout** — Request timeout.
+- **unauthorized** — Authorization error (401).
+- **unknown** — Unknown error.
+- **cacheClear**, **cacheGet**, **cacheRemove**, **cacheSet** — Cache errors.
+
+#### Intl Group (`intl`)
+Errors during data formatting (dates, numbers, etc.).
+- **datetime**, **display**, **number**, **plural**, **relative**.
+- **invalid** — Invalid date or incorrect format.
+
+#### Storage Group (`storage`)
+Errors during interaction with local or server storage.
+- **context** — Missing context.
+- **error** — General read/write failure.
+
+#### Other Groups
+These groups use a universal error code `error`. Triggering is done via `ErrorCenter.on({ group: 'group_name', code: 'error' })`.
+- **broadcast** — Errors in data exchange between browser tabs.
+- **hydration** — Error during data synchronization between server and client.
+- **share** — Error when trying to share content (Sharing API).
+- **transformation** — Error during data transformation or parsing.
+
+## Examples
+
+### Integration with Notification System
+```typescript
 import { ErrorCenter } from '@dxtmisha/functional-basic'
 
-// 1. Configure global handlers
+// Set up once at app startup
 ErrorCenter.addHandler('api', (cause) => {
-  notification.error({
-    title: cause.label,
-    message: cause.message
-  })
-})
-
-// 2. Register specific error causes
-ErrorCenter.add({
-  group: 'auth',
-  code: 'token_expired',
-  label: 'Session Expired',
-  message: 'Your session has timed out. Please log in again.'
-})
+  Toast.show(cause.label || 'Error', cause.message);
+});
+
+// Use in any service
+async function loadData() {
+  try {
+    const data = await fetch('/api');
+  } catch (e) {
+    ErrorCenter.on({ group: 'api', code: 'server', details: e });
+  }
+}
+```
 
-// 3. Trigger errors via code and group
-ErrorCenter.on({ group: 'auth', code: 'token_expired' })
+### Working with Custom Groups
+```typescript
+// On-the-fly registration
+ErrorCenter.on({
+  group: 'upload',
+  code: 'SIZE_LIMIT',
+  label: 'File Too Large',
+  message: 'Max 5MB'
+});
 ```