@dxtmisha/wiki 0.39.6 → 0.39.8

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'
+});
 ```

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

@@ -2,94 +2,125 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 <Meta title='@dxtmisha/ru/functional-basic/Classes/ErrorCenter - Управление ошибками'/>
 
-# ErrorCenter
+# Класс ErrorCenter
 
-Статическая обертка для `ErrorCenterInstance`, предоставляющая централизованное управление хранением, извлечением и обработкой ошибок. Он выступает в роли глобального реестра причин ошибок и предоставляет механизм для регистрации и вызова пользовательских обработчиков для различных групп ошибок.
+`ErrorCenter` — это центральный инструмент для управления всеми ошибками в приложении. Он позволяет в одном месте регистрировать возможные причины ошибок, настраивать реакцию на них (например, показ уведомлений) и вызывать их из любой части кода.
 
-Класс следует паттерну "Статического моста", делегируя все операции синглтон-экземпляру, сохраняя при этом чистый, глобально доступный API.
+Класс работает как статическая обертка (Static Bridge), направляя все запросы к единственному экземпляру `ErrorCenterInstance`.
 
-## Ключевые особенности
+## Методы
 
-- **Статический доступ** — глобальный статус к управлению ошибками без необходимости ручного создания экземпляров.
-- **Централизованный реестр** — хранит стандартизированные причины ошибок для единообразной обратной связи.
-- **Групповая обработка** — позволяет регистрировать несколько функций обратного вызова для конкретных категорий.
-- **Chainable API** — методы добавления причин и обработчиков поддерживают цепочки вызовов.
-- **Предустановленные значения** — по умолчанию настроен стандартными сетевыми ошибками (`timeout`, `offline`, `notFound` и т.д.).
+### Действие
+- `on(cause: ErrorCenterCauseItem): void` — Запускает процесс обработки. Ищет данные в реестре, объединяет их и вызывает нужные функции обратного вызова.
 
-## Методы проверки
+### Проверка
+- `has(code: string, group?: string): boolean` — Проверяет, зарегистрирована ли ошибка.
+- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Возвращает данные ошибки из реестра.
 
-- `has(code: string, group?: string): boolean` — Проверяет наличие причины ошибки в реестре.
-- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Извлекает полный объект причины ошибки.
+### Конфигурация
+- `add(cause: ErrorCenterCauseItem): void` — Добавляет одну причину ошибки.
+- `addList(causes: ErrorCenterCauseList): void` — Добавляет список ошибок (массовая регистрация).
+- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): void` — Регистрирует реакцию на группу ошибок.
+- `addHandlerList(handlers: ErrorCenterHandlerList): void` — Пакетная регистрация нескольких обработчиков.
 
-## Получение инстанса
-
-- `getItem(): ErrorCenterInstance` — Возвращает базовый экземпляр, используемый оберткой.
-
-## Конфигурация
-
-- `add(cause: ErrorCenterCauseItem): this` — Добавляет одну причину ошибки в хранилище.
-- `addList(causes: ErrorCenterCauseList): this` — Добавляет список причин ошибок в реестр.
-- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Регистрирует функцию обратного вызова для группы.
-- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Регистрирует набор обработчиков.
-
-## Методы действий
-
-### `on`
-
-Запускает обработку указанной ошибки. Метод ищет предварительно зарегистрированные данные для указанного кода ошибки, объединяет их с входной причиной (`cause`), выполняет все зарегистрированные обработчики для этой группы и выводит ошибку в консоль.
-
-**Параметры:**
-- `cause: ErrorCenterCauseItem` — Причина для запуска. Код и группа обязательны, если причина была зарегистрирована ранее через `add()`.
-
-**Возвращает:** `this`
+### Вспомогательные
+- `getItem(): ErrorCenterInstance` — Возвращает внутренний экземпляр класса.
 
 ## Типы
 
-### `ErrorCenterCauseItem`
-
-Основной объект, используемый для определения причины ошибки.
+#### `ErrorCenterGroup`
+Имя группы (например, 'api', 'auth') или `undefined` для общего обработчика.
 
-- `group?: ErrorCenterGroup` — категория/группа, к которой относится ошибка.
-- `code: string` — уникальный идентификатор ошибки.
-- `label?: string` — понятное человеку название ошибки.
-- `message?: string` — подробное описание ошибки.
-- `details?: any` — необязательный объект для дополнительных данных.
+#### `ErrorCenterCauseItem`
+Объект, описывающий ошибку: `group`, `code` (обязательно), `priority`, `label`, `message`, `details`.
 
-### `ErrorCenterGroup`
+## Руководство по работе
 
-Простое определение типа для категорий ошибок: `string | undefined`.
-
-## Стандартные причины ошибок
+### Шаг 1: Регистрация (Registry)
+Составьте словарь ошибок, чтобы хранить тексты отдельно от кода.
+```typescript
+ErrorCenter.add({
+  group: 'auth',
+  code: 'LOGIN_FAILED',
+  label: 'Ошибка входа',
+  message: 'Неверный пароль.'
+})
+```
 
-`ErrorCenter` автоматически наполняется следующими стандартными сетевыми причинами:
+### Шаг 2: Подписка (Handlers)
+Укажите, как приложение должно реагировать на группу ошибок.
+```typescript
+ErrorCenter.addHandler('auth', (cause) => {
+  alert(cause.message);
+});
+```
 
-- `unknown` — **Неизвестная ошибка**: Произошла непредвиденная ошибка. Пожалуйста, попробуйте еще раз.
-- `timeout` — **Тайм-аут запроса**: Запрос занял слишком много времени. Пожалуйста, проверьте соединение.
-- `offline` — **Нет соединения**: Вы находитесь в автономном режиме. Пожалуйста, проверьте интернет-соединение.
-- `notFound` — **Не найдено**: Запрошенный ресурс не найден.
-- `server` — **Ошибка сервера**: Произошла внутренняя ошибка сервера.
+### Шаг 3: Вызов (Execution)
+Вызовите ошибку по её коду и группе.
+```typescript
+ErrorCenter.on({ group: 'auth', code: 'LOGIN_FAILED' });
+```
 
-## Пример использования
+## Стандартные причины ошибок
 
-```javascript
+Класс уже содержит готовые описания для частых ситуаций.
+
+#### Группа API (`api`)
+Используется для ошибок сетевых запросов.
+- **forbidden** — Доступ запрещен (403).
+- **notFound** — Ресурс не найден (404).
+- **offline** — Нет интернет-соединения.
+- **server** — Внутренняя ошибка сервера (500).
+- **timeout** — Тайм-аут запроса.
+- **unauthorized** — Ошибка авторизации (401).
+- **unknown** — Неизвестная ошибка.
+- **cacheClear**, **cacheGet**, **cacheRemove**, **cacheSet** — Ошибки при работе с кэшем.
+
+#### Группа Intl (`intl`)
+Ошибки при форматировании данных (даты, числа и т.д.).
+- **datetime**, **display**, **number**, **plural**, **relative**.
+- **invalid** — Невалидная дата или неверный формат.
+
+#### Группа Storage (`storage`)
+Ошибки при работе с локальным или серверным хранилищем.
+- **context** — Отсутствует контекст.
+- **error** — Общий сбой записи/чтения.
+
+#### Прочие группы
+Для данных групп предусмотрен универсальный код ошибки `error`. Вызов осуществляется через `ErrorCenter.on({ group: 'название_группы', code: 'error' })`.
+- **broadcast** — Ошибки при обмене данными между вкладками браузера.
+- **hydration** — Ошибка при синхронизации данных между сервером и клиентом.
+- **share** — Ошибка при попытке поделиться контентом (Sharing API).
+- **transformation** — Ошибка при преобразовании или парсинге данных.
+
+## Примеры
+
+### Интеграция с системой уведомлений
+```typescript
 import { ErrorCenter } from '@dxtmisha/functional-basic'
 
-// 1. Настройка глобальных обработчиков
+// Настраиваем один раз при старте приложения
 ErrorCenter.addHandler('api', (cause) => {
-  notification.error({
-    title: cause.label,
-    message: cause.message
-  })
-})
-
-// 2. Регистрация специфических причин ошибок
-ErrorCenter.add({
-  group: 'auth',
-  code: 'token_expired',
-  label: 'Сессия истекла',
-  message: 'Ваша сессия истекла. Пожалуйста, войдите снова.'
-})
+  Toast.show(cause.label || 'Ошибка', cause.message);
+});
+
+// Используем в любом сервисе
+async function loadData() {
+  try {
+    const data = await fetch('/api');
+  } catch (e) {
+    ErrorCenter.on({ group: 'api', code: 'server', details: e });
+  }
+}
+```
 
-// 3. Вызов ошибки через реестр
-ErrorCenter.on({ group: 'auth', code: 'token_expired' })
+### Работа с кастомными группами
+```typescript
+// Регистрация на лету
+ErrorCenter.on({
+  group: 'upload',
+  code: 'SIZE_LIMIT',
+  label: 'Файл слишком велик',
+  message: 'Максимум 5МБ'
+});
 ```