@dxtmisha/wiki 0.39.7 → 0.39.8

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

@@ -2,122 +2,70 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/en/functional-basic/Classes/ErrorCenterInstance - Error Instance'/>
 
-# ErrorCenterInstance
+# ErrorCenterInstance Class
 
-A class for managing error storage and handling within a specific instance. It provides the core logic for maintaining a registry of error causes and orchestrating their notification through a handler manager.
-
-While `ErrorCenter` provides a global static bridge, `ErrorCenterInstance` can be used directly for isolated error tracking or custom error management systems.
+`ErrorCenterInstance` is the main engine of the error system. It combines an error registry and a handler manager. You can create independent instances of this class for different parts of the application to isolate their error processing logic.
 
 ## Key Features
 
-- **Isolated Storage** — Maintain a local list of error causes separate from the global state.
-- **Data Merging** — Automatically supplements triggered errors with pre-registered label and message data.
-- **Handler Delegation** — Uses a dedicated `ErrorCenterHandler` to manage and execute callbacks.
-- **Predefined Causes** — Can be initialized with a list of default error causes.
-- **Chainable Methods** — Supports fluent configuration for adding causes and handlers.
-
-## Check Methods
-
-- `has(code: string, group?: string): boolean` — Checks if a cause exists in the instance's registry.
-- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Retrieves the stored error cause object.
-
-## Configuration
-
-- `add(cause: ErrorCenterCauseItem): this` — Adds a single error cause to the storage.
-- `addList(causes: ErrorCenterCauseList): this` — Adds multiple error causes.
-- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Registers a callback for a specific error group.
-- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Registers a collection of handlers.
-
-## Action Methods
+- **Isolated Storage** — maintaining a local list of error causes.
+- **Intelligent Merging** — automatic supplementation of error data based on a priority system.
+- **Handling Delegation** — using `ErrorCenterHandler` to trigger callback functions.
+- **Chainable API** — support for call chaining for configuration.
 
-### `on`
+## Initialization
 
-Triggers error handling. It looks up the pre-registered data for the provided error code, merges it with the input `cause`, and passes it to the internal handler.
+To create an instance, use the constructor `ErrorCenterInstance(causes, handler)`.
 
 **Parameters:**
-- `cause: ErrorCenterCauseItem` — The error information to trigger.
-
-**Returns:** `this`
-
-## Types
-
-### `ErrorCenterCauseItem`
-
-The main object used to define an error cause in this instance.
+- `causes?: ErrorCenterCauseList` — initial list of error causes.
+- `handler?: ErrorCenterHandler` — handler instance (if not specified, a new one is created).
 
-- `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.
-
-## Guide: Managing Errors and Listeners
-
-Using the `ErrorCenterInstance` involves three main steps: defining error causes, setting up listeners (handlers), and triggering the errors.
-
-### 1. Adding Error Causes
-
-Error causes act as a dictionary for your application. By pre-registering them, you ensure that consistent labels and messages are used throughout your platform.
-
-```javascript
+```typescript
 import { ErrorCenterInstance } from '@dxtmisha/functional-basic'
 
-const myErrorCenter = new ErrorCenterInstance()
-
-// Register a single error cause
-myErrorCenter.add({
-  group: 'auth',
-  code: 'token_expired',
-  label: 'Session Expired',
-  message: 'Your login session has expired. Please log in again.'
-})
-
-// Register multiple causes at once
-myErrorCenter.addList([
-  { group: 'api', code: '404', label: 'Not Found', message: 'The requested data does not exist.' },
-  { group: 'api', code: '500', label: 'Server Error', message: 'Something went wrong on the server.' }
+const myErrorCenter = new ErrorCenterInstance([
+  { group: 'api', code: '404', label: 'Not Found' }
 ])
 ```
 
-### 2. Adding Listeners
+## Methods
 
-Listeners (handlers) are callback functions that execute when a specific error occurs. You assign listeners to a specific `group` so they only react to relevant errors.
+### Action
+- `on(cause: ErrorCenterCauseItem): this` — Starts the processing. Merges data from the registry with input data and passes it to the handler.
 
-```javascript
-// Add a listener specifically for the "auth" group
-myErrorCenter.addHandler('auth', (cause) => {
-  // E.g., redirect to login or show an alert
-  console.log(`[AUTH ERROR] ${cause.label}: ${cause.message}`)
-})
+### Verification
+- `has(code: string, group?: string): boolean` — Search in the local registry.
+- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Retrieve data from the registry.
 
-// Add a listener for the "api" group
-myErrorCenter.addHandler('api', (cause) => {
-  // E.g., show a toast notification
-  console.error(`[API ERROR ${cause.code}] ${cause.message}`)
-})
+### Configuration
+- `add(cause: ErrorCenterCauseItem): this` — Add an error to the local registry.
+- `addList(causes: ErrorCenterCauseList): this` — Batch addition of errors.
+- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Register a reaction to a group.
+- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Batch registration of reactions.
 
-// Add a global fallback listener (catches errors without a specific group handler)
-myErrorCenter.addHandler(undefined, (cause) => {
-  console.warn(`[UNKNOWN ERROR]`, cause)
-})
-```
+## Types
+
+#### `ErrorCenterCauseItem`
+Object describing a specific error.
+- `group?: ErrorCenterGroup` — error group (e.g., 'api').
+- `code: string` — unique error code.
+- `priority?: number` — priority level (default `500`). Used during data merging.
+- `label?: string` — error title.
+- `message?: string` — error description.
+- `details?: any` — additional data.
 
-### 3. Triggering Errors
+#### `ErrorCenterHandlerCallback`
+- `(cause: ErrorCenterCauseItem) => void` — processing function.
 
-When an error occurs in your application, you trigger the handling process using the `on` method. You only need to provide the `code` and the `group`. The `ErrorCenterInstance` will automatically merge this with the pre-registered `label` and `message` before passing it to the listeners.
+## Examples
 
-```javascript
-// Trigger an authentication error
-// The listeners for "auth" will receive the full ErrorCenterCauseItem
-myErrorCenter.on({
-  group: 'auth',
-  code: 'token_expired'
-})
+### Initialization with a Dictionary
+```typescript
+const myEC = new ErrorCenterInstance([
+  { group: 'db', code: 'connection_lost', label: 'DB Unavailable' }
+]);
 
-// Trigger an unregistered error (will fallback to the undefined group listener)
-myErrorCenter.on({
-  group: 'database',
-  code: 'connection_lost',
-  message: 'Lost connection to DB.' // You can pass inline data as well
-})
+myEC.addHandler('db', (cause) => alert(cause.label));
+myEC.on({ group: 'db', code: 'connection_lost' });
 ```

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

@@ -2,122 +2,70 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/functional-basic/Classes/ErrorCenterInstance - Экземпляр ошибок'/>
 
-# ErrorCenterInstance
+# Класс ErrorCenterInstance
 
-Класс для управления хранилищем ошибок и их обработкой внутри конкретного экземпляра. Он обеспечивает основную логику для ведения реестра причин ошибок и организации уведомлений о них через менеджер обработчиков.
-
-Хотя `ErrorCenter` предоставляет глобальный статический мост, `ErrorCenterInstance` можно использовать напрямую для изолированного отслеживания ошибок или создания пользовательских систем управления.
+`ErrorCenterInstance` — это основной движок системы ошибок. Он объединяет в себе реестр причин и менеджер обработчиков. Вы можете создавать независимые экземпляры этого класса для разных частей приложения, чтобы изолировать их логику обработки ошибок.
 
 ## Ключевые особенности
 
-- **Изолированное хранилище** — Ведение локального списка причин ошибок отдельно от глобального состояния.
-- **Объединение данных** — Автоматически дополняет возникающие ошибки данными о заголовках и сообщениях из реестра.
-- **Делегирование обработки** — Использует выделенный `ErrorCenterHandler` для выполнения функций обратного вызова.
-- **Предопределенные причины** — Может быть инициализирован со списком причин ошибок по умолчанию.
-- **Chainable API** — Поддерживает удобную конфигурацию для добавления причин и обработчиков.
-
-## Методы проверки
-
-- `has(code: string, group?: string): boolean` — Проверяет, существует ли причина с конкретным кодом в реестре.
-- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Извлекает сохраненный объект причины ошибки.
-
-## Конфигурация
-
-- `add(cause: ErrorCenterCauseItem): this` — Добавляет одну причину ошибки в хранилище экземпляра.
-- `addList(causes: ErrorCenterCauseList): this` — Добавляет список причин ошибок.
-- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Регистрирует обработчик для конкретной группы.
-- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Регистрирует список обработчиков.
-
-## Методы действий
+- **Изолированное хранилище** — ведение локального списка причин ошибок.
+- **Интеллектуальное слияние** — автоматическое дополнение данных ошибки на основе системы приоритетов.
+- **Делегирование обработки** — использование `ErrorCenterHandler` для вызова функций обратного вызова.
+- **Chainable API** — поддержка цепочки вызовов для конфигурации.
 
-### `on`
+## Инициализация
 
-Запускает обработку ошибки. Метод ищет предварительно зарегистрированные данные для указанного кода ошибки, объединяет их с входной причиной (`cause`) и передает внутреннему обработчику.
+Для создания экземпляра используйте конструктор `ErrorCenterInstance(causes, handler)`.
 
 **Параметры:**
-- `cause: ErrorCenterCauseItem` — Информация об ошибке для запуска.
-
-**Возвращает:** `this`
-
-## Типы
-
-### `ErrorCenterCauseItem`
-
-Основной объект, используемый для определения причины ошибки в этом экземпляре.
+- `causes?: ErrorCenterCauseList` — начальный список причин ошибок.
+- `handler?: ErrorCenterHandler` — экземпляр обработчика (если не указан, создается новый).
 
-- `group?: ErrorCenterGroup` — категория/группа, к которой относится ошибка.
-- `code: string` — уникальный идентификатор ошибки.
-- `label?: string` — понятное человеку название ошибки.
-- `message?: string` — подробное описание ошибки.
-- `details?: any` — необязательный объект для дополнительных данных.
-
-## Руководство: Управление причинами ошибок и обработчиками
-
-Использование `ErrorCenterInstance` включает три основных шага: определение причин ошибок, настройка слушателей (обработчиков) и вызов ошибок.
-
-### 1. Добавление причин ошибок
-
-Причины ошибок действуют как словарь для вашего приложения. Предварительно регистрируя их, вы обеспечиваете единообразие заголовков и сообщений по всей платформе.
-
-```javascript
+```typescript
 import { ErrorCenterInstance } from '@dxtmisha/functional-basic'
 
-const myErrorCenter = new ErrorCenterInstance()
-
-// Регистрация одной причины ошибки
-myErrorCenter.add({
-  group: 'auth',
-  code: 'token_expired',
-  label: 'Сессия истекла',
-  message: 'Срок действия вашей сессии истек. Пожалуйста, войдите снова.'
-})
-
-// Регистрация нескольких причин сразу
-myErrorCenter.addList([
-  { group: 'api', code: '404', label: 'Не найдено', message: 'Запрошенные данные не существуют.' },
-  { group: 'api', code: '500', label: 'Ошибка сервера', message: 'На сервере что-то пошло не так.' }
+const myErrorCenter = new ErrorCenterInstance([
+  { group: 'api', code: '404', label: 'Не найдено' }
 ])
 ```
 
-### 2. Добавление слушателей
+## Методы
 
-Слушатели (обработчики) — это функции обратного вызова, которые выполняются при возникновении определенной ошибки. Вы назначаете слушателей для конкретной группы (`group`), чтобы они реагировали только на соответствующие ошибки.
+### Действие
+- `on(cause: ErrorCenterCauseItem): this` — Запускает процесс обработки. Склеивает данные из реестра с входными данными и передает их обработчику.
 
-```javascript
-// Добавление слушателя специально для группы "auth"
-myErrorCenter.addHandler('auth', (cause) => {
-  // Например, перенаправление на страницу входа или показ уведомления
-  console.log(`[ОШИБКА АВТОРИЗАЦИИ] ${cause.label}: ${cause.message}`)
-})
+### Проверка
+- `has(code: string, group?: string): boolean` — Поиск в локальном реестре.
+- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Получение данных из реестра.
 
-// Добавление слушателя для группы "api"
-myErrorCenter.addHandler('api', (cause) => {
-  // Например, показ всплывающего уведомления
-  console.error(`[ОШИБКА API ${cause.code}] ${cause.message}`)
-})
+### Конфигурация
+- `add(cause: ErrorCenterCauseItem): this` — Добавление ошибки в локальный реестр.
+- `addList(causes: ErrorCenterCauseList): this` — Пакетное добавление ошибок.
+- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Регистрация реакции на группу.
+- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Пакетная регистрация реакций.
 
-// Добавление глобального запасного слушателя (перехватывает ошибки без специфического обработчика)
-myErrorCenter.addHandler(undefined, (cause) => {
-  console.warn(`[НЕИЗВЕСТНАЯ ОШИБКА]`, cause)
-})
-```
+## Типы
+
+#### `ErrorCenterCauseItem`
+Объект, описывающий конкретную ошибку.
+- `group?: ErrorCenterGroup` — группа ошибки (например, 'api').
+- `code: string` — уникальный код ошибки.
+- `priority?: number` — уровень приоритета (по умолчанию `500`). Используется при слиянии данных.
+- `label?: string` — заголовок ошибки.
+- `message?: string` — описание ошибки.
+- `details?: any` — дополнительные данные.
 
-### 3. Вызов ошибок
+#### `ErrorCenterHandlerCallback`
+- `(cause: ErrorCenterCauseItem) => void` — функция обработки.
 
-Когда в вашем приложении происходит ошибка, вы запускаете процесс обработки с помощью метода `on`. Вам нужно указать только код (`code`) и группу (`group`). `ErrorCenterInstance` автоматически объединит это с предварительно зарегистрированными данными (`label` и `message`) перед передачей слушателям.
+## Примеры
 
-```javascript
-// Запуск ошибки авторизации
-// Слушатели для "auth" получат полный объект ErrorCenterCauseItem
-myErrorCenter.on({
-  group: 'auth',
-  code: 'token_expired'
-})
+### Инициализация со словарем
+```typescript
+const myEC = new ErrorCenterInstance([
+  { group: 'db', code: 'connection_lost', label: 'БД недоступна' }
+]);
 
-// Запуск незарегистрированной ошибки (сработает обработчик группы undefined)
-myErrorCenter.on({
-  group: 'database',
-  code: 'connection_lost',
-  message: 'Потеряно соединение с БД.' // Данные можно передавать "на лету"
-})
+myEC.addHandler('db', (cause) => alert(cause.label));
+myEC.on({ group: 'db', code: 'connection_lost' });
 ```

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

@@ -2,122 +2,70 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/vi/functional-basic/Classes/ErrorCenterInstance - Thực thể lỗi'/>
 
-# ErrorCenterInstance
+# Lớp ErrorCenterInstance
 
-Một lớp để quản lý việc lưu trữ và xử lý lỗi trong một thực thể (instance) cụ thể. Nó cung cấp logic cốt lõi để duy trì một danh mục các nguyên nhân gây lỗi và điều phối các thông báo thông qua một trình quản lý xử lý.
-
-Trong khi `ErrorCenter` cung cấp một lớp tĩnh toàn cục, `ErrorCenterInstance` có thể được sử dụng trực tiếp để theo dõi lỗi tách biệt hoặc các hệ thống quản lý lỗi tùy chỉnh.
+`ErrorCenterInstance` là động cơ chính của hệ thống lỗi. Nó kết hợp một sổ đăng ký nguyên nhân và một trình quản lý xử lý. Bạn có thể tạo các thực thể độc lập của lớp này cho các phần khác nhau của ứng dụng để cô lập logic xử lý lỗi của chúng.
 
 ## Các tính năng chính
 
-- **Lưu trữ tách biệt** — Duy trì danh sách các nguyên nhân lỗi cục bộ riêng biệt với trạng thái toàn cầu.
-- **Hợp nhất dữ liệu** — Tự động bổ sung thông tin nhãn và thông báo đã đăng ký cho các lỗi được kích hoạt.
-- **Ủy quyền xử lý** — Sử dụng một `ErrorCenterHandler` riêng để thực thi các hàm gọi lại.
-- **Nguyên nhân định nghĩa trước** — Có thể được khởi tạo với một danh sách các nguyên nhân lỗi mặc định.
-- **Chainable API** — Hỗ trợ cấu hình linh hoạt để thêm nguyên nhân và trình xử lý.
-
-## Các phương thức kiểm tra
-
-- `has(code: string, group?: string): boolean` — Kiểm tra xem một nguyên nhân lỗi có tồn tại trong bộ lưu trữ không.
-- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Truy xuất đối tượng nguyên nhân lỗi đã lưu trữ.
-
-## Cấu hình
-
-- `add(cause: ErrorCenterCauseItem): this` — Thêm một nguyên nhân lỗi duy nhất vào bộ lưu trữ.
-- `addList(causes: ErrorCenterCauseList): this` — Thêm một danh sách các nguyên nhân lỗi.
-- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Đăng ký một trình xử lý cho nhóm cụ thể.
-- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Đăng ký một loạt các trình xử lý.
-
-## Các phương thức hành động
+- **Kho lưu trữ cô lập** — duy trì một danh sách cục bộ các nguyên nhân lỗi.
+- **Hợp nhất thông minh** — tự động bổ sung dữ liệu lỗi dựa trên hệ thống ưu tiên.
+- **Ủy quyền xử lý** — sử dụng `ErrorCenterHandler` để kích hoạt các hàm callback.
+- **API nối chuỗi** — hỗ trợ nối chuỗi cuộc gọi để cấu hình.
 
-### `on`
+## Khởi tạo
 
-Kích hoạt xử lý lỗi. Nó tìm kiếm dữ liệu đã đăng ký cho mã lỗi đầu vào, hợp nhất dữ liệu đó với nguyên nhân `cause`, và chuyển nó cho trình xử lý nội bộ.
+Để tạo một thực thể, sử dụng constructor `ErrorCenterInstance(causes, handler)`.
 
 **Tham số:**
-- `cause: ErrorCenterCauseItem` — Thông tin lỗi cần kích hoạt.
-
-**Trả về:** `this`
-
-## Các kiểu dữ liệu
-
-### `ErrorCenterCauseItem`
-
-Đối tượng chính được sử dụng để xác định nguyên nhân gây lỗi trong thực thể này.
+- `causes?: ErrorCenterCauseList` — danh sách nguyên nhân lỗi ban đầu.
+- `handler?: ErrorCenterHandler` — thực thể trình xử lý (nếu không được chỉ định, một thực thể mới sẽ được tạo).
 
-- `group?: ErrorCenterGroup` — danh mục/nhóm mà lỗi thuộc về.
-- `code: string` — mã định danh duy nhất cho lỗi.
-- `label?: string` — tên lỗi dễ đọc cho người dùng.
-- `message?: string` — mô tả chi tiết về lỗi.
-- `details?: any` — đối tượng tùy chọn cho các dữ liệu bổ sung.
-
-## Hướng dẫn: Quản lý nguyên nhân lỗi và bộ lắng nghe
-
-Sử dụng `ErrorCenterInstance` bao gồm ba bước chính: định nghĩa các nguyên nhân gây lỗi, thiết lập bộ lắng nghe (trình xử lý), và kích hoạt lỗi.
-
-### 1. Thêm nguyên nhân lỗi
-
-Các nguyên nhân gây lỗi hoạt động như một từ điển cho ứng dụng của bạn. Bằng cách đăng ký trước chúng, bạn đảm bảo rằng các nhãn và thông báo nhất quán được sử dụng trên toàn bộ nền tảng.
-
-```javascript
+```typescript
 import { ErrorCenterInstance } from '@dxtmisha/functional-basic'
 
-const myErrorCenter = new ErrorCenterInstance()
-
-// Đăng ký một nguyên nhân lỗi duy nhất
-myErrorCenter.add({
-  group: 'auth',
-  code: 'token_expired',
-  label: 'Phiên hết hạn',
-  message: 'Phiên đăng nhập của bạn đã hết hạn. Vui lòng đăng nhập lại.'
-})
-
-// Đăng ký nhiều nguyên nhân cùng lúc
-myErrorCenter.addList([
-  { group: 'api', code: '404', label: 'Không tìm thấy', message: 'Dữ liệu được yêu cầu không tồn tại.' },
-  { group: 'api', code: '500', label: 'Lỗi máy chủ', message: 'Đã có lỗi xảy ra trên máy chủ.' }
+const myErrorCenter = new ErrorCenterInstance([
+  { group: 'api', code: '404', label: 'Không tìm thấy' }
 ])
 ```
 
-### 2. Thêm bộ lắng nghe
+## Các phương thức
 
-Bộ lắng nghe (trình xử lý) là các hàm callback thực thi khi một lỗi cụ thể xảy ra. Bạn gán các bộ lắng nghe cho một nhóm (`group`) cụ thể để chúng chỉ phản ứng với các lỗi liên quan.
+### Hành động
+- `on(cause: ErrorCenterCauseItem): this` — Bắt đầu quá trình xử lý. Hợp nhất dữ liệu từ sổ đăng ký với dữ liệu đầu vào và chuyển nó cho trình xử lý.
 
-```javascript
-// Thêm bộ lắng nghe dành riêng cho nhóm "auth"
-myErrorCenter.addHandler('auth', (cause) => {
-  // Ví dụ: chuyển hướng đến trang đăng nhập hoặc hiển thị thông báo cảnh báo
-  console.log(`[LỖI XÁC THỰC] ${cause.label}: ${cause.message}`)
-})
+### Xác minh
+- `has(code: string, group?: string): boolean` — Tìm kiếm trong sổ đăng ký cục bộ.
+- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Truy xuất dữ liệu từ sổ đăng ký.
 
-// Thêm bộ lắng nghe cho nhóm "api"
-myErrorCenter.addHandler('api', (cause) => {
-  // Ví dụ: hiển thị thông báo dạng toast
-  console.error(`[LỖI API ${cause.code}] ${cause.message}`)
-})
+### Cấu hình
+- `add(cause: ErrorCenterCauseItem): this` — Thêm một lỗi vào sổ đăng ký cục bộ.
+- `addList(causes: ErrorCenterCauseList): this` — Thêm lỗi hàng loạt.
+- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Đăng ký một phản ứng cho nhóm.
+- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Đăng ký hàng loạt các phản ứng.
 
-// Thêm bộ lắng nghe dự phòng toàn cục (bắt các lỗi không có trình xử lý cụ thể)
-myErrorCenter.addHandler(undefined, (cause) => {
-  console.warn(`[LỖI KHÔNG XÁC ĐỊNH]`, cause)
-})
-```
+## Các kiểu dữ liệu
+
+#### `ErrorCenterCauseItem`
+Đối tượng mô tả một lỗi cụ thể.
+- `group?: ErrorCenterGroup` — nhóm lỗi (ví dụ: 'api').
+- `code: string` — mã lỗi duy nhất.
+- `priority?: number` — mức độ ưu tiên (mặc định `500`). Được sử dụng trong quá trình hợp nhất dữ liệu.
+- `label?: string` — tiêu đề lỗi.
+- `message?: string` — mô tả lỗi.
+- `details?: any` — dữ liệu bổ sung.
 
-### 3. Kích hoạt lỗi
+#### `ErrorCenterHandlerCallback`
+- `(cause: ErrorCenterCauseItem) => void` — hàm xử lý.
 
-Khi một lỗi xảy ra trong ứng dụng của bạn, bạn kích hoạt quá trình xử lý bằng cách sử dụng phương thức `on`. Bạn chỉ cần cung cấp mã (`code`) và nhóm (`group`). `ErrorCenterInstance` sẽ tự động hợp nhất yêu cầu này với nhãn (`label`) và thông báo (`message`) đã đăng ký trước đó rồi mới truyền đến các bộ lắng nghe.
+## Ví dụ
 
-```javascript
-// Kích hoạt lỗi xác thực
-// Các bộ lắng nghe cho "auth" sẽ nhận được toàn bộ đối tượng ErrorCenterCauseItem
-myErrorCenter.on({
-  group: 'auth',
-  code: 'token_expired'
-})
+### Khởi tạo với một từ điển
+```typescript
+const myEC = new ErrorCenterInstance([
+  { group: 'db', code: 'connection_lost', label: 'DB không khả dụng' }
+]);
 
-// Kích hoạt một lỗi chưa đăng ký (sẽ rơi vào bộ lắng nghe của nhóm undefined)
-myErrorCenter.on({
-  group: 'database',
-  code: 'connection_lost',
-  message: 'Mất kết nối với CSDL.' // Bạn cũng có thể truyền dữ liệu trực tiếp
-})
+myEC.addHandler('db', (cause) => alert(cause.label));
+myEC.on({ group: 'db', code: 'connection_lost' });
 ```