@dxtmisha/wiki 0.39.7 → 0.39.8

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

@@ -21,8 +21,8 @@ import {Meta} from '@storybook/addon-docs/blocks'
 ### Ограничения дженериков (Generic Constraints)
 
 - `Options extends FormattersOptionsList` — тип параметров форматирования.
-- `List extends FormattersList<FormattersListItem> | FormattersListItem` — тип входных данных (массив или один элемент).
-- `Item extends (List extends any[] ? List[number] : List)` — тип одного элемента в списке.
+- `List extends FormattersListProp` — тип входных данных (массив или один элемент).
+- `Item extends FormattersItemProp<List>` — тип одного элемента в списке.
 
 **Параметры:**
 - `options: Options` — параметры форматирования для каждого столбца/свойства.
@@ -44,31 +44,17 @@ const options = {
   user: {
     type: 'name',
     options: { lastPropName: 'surname', firstPropName: 'name' }
-  },
-  weight: { 
-    type: 'unit', 
-    options: { unit: 'kilogram' } 
-  },
-  count: { 
-    type: 'plural', 
-    options: { words: 'яблоко|яблока|яблок' } 
-  },
-  status: {
-    transformation: (value: number) => value === 1 ? 'Активен' : 'Неактивен'
   }
 }
 
-// 2. Исходные данные (может быть массивом или одним объектом)
+// 2. Исходные данные
 const data = [
   {
     price: 100,
     currency: 'RUB',
     created: '2024-03-07T12:00:00',
     name: 'Иван',
-    surname: 'Иванов',
-    weight: 75,
-    count: 5,
-    status: 1
+    surname: 'Иванов'
   }
 ]
 
@@ -76,93 +62,95 @@ const data = [
 const formatter = new Formatters(options, data)
 ```
 
-## Обработка данных
+## Методы
 
-### `to`
+### Обработка
+- `to(): FormattersReturn<List, Options>` — Обрабатывает данные и возвращает результат. Если на вход был массив, возвращает новый массив обогащенных элементов. Если был один элемент — один объект. Добавляет свойства с суффиксом `Format`.
 
-Обрабатывает данные и возвращает результат. Если на вход был передан массив, метод возвращает новый массив обогащенных элементов. Если был один элемент — возвращает один обогащенный элемент.
+### Настройка
+- `setList(list?: List): this` — Обновляет данные для форматирования. Поддерживает чейнинг.
 
-**Возвращает:** `FormattersListColumns<Item, Options> | FormattersListColumnItem<Item, Options>` — обогащенные данные с дополнительными свойствами `*Format`.
+### Информация
+- `is(): boolean` — Проверяет, установлены ли данные для обработки.
+- `isArray(): boolean` — Являются ли текущие данные массивом.
+- `length(): number` — Возвращает количество записей в списке.
+- `getList(): FormattersList<Item>` — Возвращает текущий список в виде массива.
+- `getOptions(): Options` — Возвращает текущую конфигурацию форматирования.
+
+## Типы и параметры форматирования
+
+Конфигурация `FormattersOptionsList` — это словарь, где ключи соответствуют именам свойств в данных (поддерживается точечная нотация `path.to.prop`), а значения — объекту `FormattersOptionsItem`.
+
+### Общая структура `FormattersOptionsItem`
+- `type?: FormattersType` — Тип форматировщика.
+- `transformation?: (value, item, options) => string` — Кастомная функция преобразования.
+- `options?: Options` — Объект параметров, структура которого зависит от выбранного `type`.
+
+### Подробное описание типов
+
+#### 1. Валюта (`currency`)
+Используется для локализованного отображения денежных значений.
+- `currencyPropName?: string` — Имя свойства в элементе, из которого берется код валюты (по умолчанию `currency`).
+- `options?: string | Intl.NumberFormatOptions` — Можно передать фиксированный код (например, `'USD'`) или объект настроек `Intl.NumberFormat`.
+- `numberOnly?: boolean` — Если `true`, возвращает только отформатированное число без символа валюты.
+
+#### 2. Дата (`date`)
+Форматирование дат и времени через `GeoIntl`.
+- `type?: GeoDate` — Предустановленный формат:
+    - `full` — Полная дата и время.
+    - `datetime` — Дата и время (без секунд).
+    - `date` — Только дата.
+    - `time` — Только время.
+    - `year-month`, `year`, `month`, `day`, `day-month`, `hour-minute`.
+- `options?: Intl.DateTimeFormatOptions` — Стандартные параметры `Intl` (например, `month: 'long'`).
+- `hour24?: boolean` — Если `true`, принудительно включает 24-часовой режим.
+
+#### 3. Имя (`name`)
+Склеивает ФИО в правильном порядке.
+- `lastPropName?: string` — Поле для фамилии (по умолчанию `lastName`).
+- `firstPropName?: string` — Поле для имени (по умолчанию `firstName`).
+- `surname?: string` — Поле для отчества (по умолчанию `surname`).
+- `short?: boolean` — Если `true`, выводит фамилию и инициалы (например, «Иванов И. И.»).
+
+#### 4. Число (`number`)
+Обычное форматирование чисел с разделением разрядов.
+- `options?: Intl.NumberFormatOptions` — Параметры `Intl` (количество знаков после запятой, стиль и т.д.).
+
+#### 5. Множественное число (`plural`)
+Выбор правильной формы слова в зависимости от числа.
+- `words: string` — Формы слова через разделитель `|`.
+    - Для русского: `"яблоко|яблока|яблок"`.
+    - Для английского: `"apple|apples"`.
+- `options?: Intl.PluralRulesOptions` — Настройки правил плюрализации.
+- `optionsNumber?: Intl.NumberFormatOptions` — Настройки форматирования самого числа, которое выводится перед словом.
+
+#### 6. Единица измерения (`unit`)
+Добавление единиц измерения (км, кг, л).
+- `unit: string` — Код единицы измерения (например, `'kilometer'`, `'kilogram'`, `'liter'`).
+- `options?: Intl.NumberFormatOptions` — Параметры форматирования числовой части.
+
+## Примеры
+
+### Использование точечной нотации (Dot Notation)
+```typescript
+const options = {
+  'user.profile.age': { type: 'number' }
+}
+const data = { user: { profile: { age: 25 } } }
+const formatter = new Formatters(options, data)
 
-```javascript
 const result = formatter.to()
-/*
-Результат (если массив): [
-  { 
-    id: 101, 
-    price: 100, 
-    currency: 'RUB', 
-    priceFormat: '100,00 ₽', 
-    status: 1, 
-    statusFormat: 'Активен',
-    ... 
-  }
-]
-
-Результат (если один объект): { 
-  price: 100, 
-  priceFormat: '100,00 ₽', 
-  ... 
-}
-*/
+// result.userProfileAgeFormat === "25"
 ```
 
-## Получение и управление данными
-
-- `is(): boolean` — Проверяет, установлен ли список/элемент.
-- `isArray(): boolean` — Проверяет, являются ли текущие данные массивом.
-- `length(): number` — Возвращает количество записей в списке.
-- `getList(): Item[]` — Возвращает текущий список данных в виде массива.
-- `getOptions(): Options` — Возвращает текущую карту конфигурации форматирования.
-- `setList(list?: List): this` — Обновляет данные для форматирования и возвращает экземпляр класса для цепочки вызовов.
-
-## Структура конфигурации
-
-Объект конфигурации, передаваемый в конструктор, представляет собой карту, где каждый ключ соответствует имени свойства в ваших данных. Каждое значение должно соответствовать структуре `FormattersOptionsItem`.
-
-### Основная структура элемента
-
+### Кастомная трансформация
 ```typescript
-{
-  // 1. Укажите тип форматирования
-  type: 'currency' | 'date' | 'name' | 'number' | 'plural' | 'unit',
-
-  // 2. Передайте параметры, специфичные для типа, здесь
-  options: { ... },
-
-  // 3. Или используйте собственную функцию (перекрывает логику типа)
-  transformation: (value, item, options) => string
+const options = {
+  status: {
+    // Пользовательская функция имеет приоритет над type
+    transformation: (value, item) => {
+       return value === 'active' ? `✅ ${item.name} в сети` : '❌ Оффлайн'
+    }
+  }
 }
 ```
-
-## Специфичные параметры
-
-Ниже приведены параметры, доступные внутри свойства **`options`** для каждого типа.
-
-### Валюта (`currency`)
-- `currencyPropName?: string` — Свойство в элементе, содержащее код валюты (по умолчанию `item.currency`).
-- `options?: string | Intl.NumberFormatOptions` — Фиксированный код валюты или полные параметры `Intl`.
-- `numberOnly?: boolean` — Если `true`, возвращает только отформатированное число без символа.
-
-### Дата (`date`)
-- `type?: GeoDate` — Предустановленный тип: `full`, `datetime`, `date`, `year-month`, `year`, `month`, `day`, `day-month`, `time`, `hour-minute`, `hour`, `minute`, `second`.
-- `options?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions` — Дополнительные параметры `Intl` или стиль месяца.
-- `hour24?: boolean` — Принудительно использует 24-часовой формат, если `true`.
-
-### Имя (`name`)
-- `lastPropName?: string` — Поле для фамилии (по умолчанию: `lastName`).
-- `firstPropName?: string` — Поле для имени (по умолчанию: `firstName`).
-- `surname?: string` — Поле для отчества (по умолчанию: `surname`).
-- `short?: boolean` — Использовать ли краткий формат (инициалы).
-
-### Число (`number`)
-- `options?: Intl.NumberFormatOptions` — Стандартные параметры чисел `Intl`.
-
-### Множественное число (`plural`)
-- `words: string` — Формы слов, разделенные `|` (например, `"яблоко|яблока|яблок"`).
-- `options?: Intl.PluralRulesOptions` — Настройки правил множественного числа.
-- `optionsNumber?: Intl.NumberFormatOptions` — Форматирование самого числа.
-
-### Единица измерения (`unit`)
-- `unit: string | Intl.NumberFormatOptions` — Единица измерения для отображения (например, `'kilometer'`, `'kilogram'`).
-

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

@@ -4,34 +4,34 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Lớp Formatters
 
-Một lớp chuyên dụng để định dạng danh sách dữ liệu dựa trên cấu hình được cung cấp. Nó đóng vai trò như một cầu nối giữa dữ liệu thô và các chuỗi văn bản đã được địa phương hóa, dễ đọc, tận dụng cơ chế singleton `GeoIntl` để đảm bảo tính nhất quán trong định dạng trên các ngôn ngữ khác nhau.
+Một lớp chuyên dụng để định dạng danh sách dữ liệu dựa trên cấu hình được cung cấp. Nó đóng vai trò là cầu nối giữa dữ liệu thô và các chuỗi đã được bản địa hóa, dễ đọc, sử dụng singleton `GeoIntl` để định dạng nhất quán trên các ngôn ngữ khác nhau.
 
-## Tính năng chính
+## Các tính năng chính
 
-- **Cấu hình khai báo** — Định nghĩa các quy tắc định dạng một lần và áp dụng chúng cho toàn bộ tập dữ liệu.
-- **Hỗ trợ nhiều kiểu dữ liệu** — Hỗ trợ tích hợp cho tiền tệ, ngày tháng, tên, số, số nhiều và các đơn vị đo lường.
-- **Biến đổi tùy chỉnh** — Khả năng cung cấp các hàm riêng cho các nhu cầu định dạng đặc thù.
-- **An toàn kiểu dữ liệu (Type Safety)** — Hỗ trợ đầy đủ TypeScript cho các mục dữ liệu, các tùy chọn và danh sách kết quả đã được định dạng.
-- **Tự động tạo khóa (Key Generation)** — Tự động thêm các giá trị đã định dạng vào các mục với hậu tố `Format` (ví dụ: `price` trở thành `priceFormat`).
+- **Cấu hình khai báo** — Xác định các quy tắc định dạng một lần và áp dụng chúng cho toàn bộ tập dữ liệu.
+- **Hỗ trợ nhiều loại** — Hỗ trợ tích hợp cho tiền tệ, ngày tháng, tên, số, số nhiều và đơn vị đo lường.
+- **Chuyển đổi tùy chỉnh** — Khả năng cung cấp các hàm riêng của bạn cho các nhu cầu định dạng duy nhất.
+- **Typing** — Hỗ trợ TypeScript đầy đủ cho các mục, tham số và danh sách đã định dạng kết quả.
+- **Tự động tạo khóa** — Tự động thêm các giá trị đã định dạng vào các mục với hậu tố `Format` (ví dụ: `price` trở thành `priceFormat`).
 
 ## Khởi tạo
 
-Để khởi tạo đối tượng, hãy gọi hàm khởi tạo `Formatters(options, list)`.
+Để khởi tạo đối tượng, hãy gọi constructor `Formatters(options, list)`.
 
-### Ràng buộc Generic (Generic Constraints)
+### Các ràng buộc Generic (Generic Constraints)
 
-- `Options extends FormattersOptionsList` — kiểu của các tùy chọn định dạng.
-- `List extends FormattersList<FormattersListItem> | FormattersListItem` — kiểu dữ liệu đầu vào (mảng hoặc một mục duy nhất).
-- `Item extends (List extends any[] ? List[number] : List)` — kiểu của một mục duy nhất trong danh sách.
+- `Options extends FormattersOptionsList` — kiểu tham số định dạng.
+- `List extends FormattersListProp` — kiểu dữ liệu đầu vào (mảng hoặc một mục).
+- `Item extends FormattersItemProp<List>` — kiểu của một mục duy nhất trong danh sách.
 
 **Tham số:**
-- `options: Options` — tùy chọn định dạng cho mỗi cột/thuộc tính.
-- `list?: List` — danh sách hoặc mục dữ liệu ban đầu để định dạng.
+- `options: Options` — tham số định dạng cho mỗi cột/thuộc tính.
+- `list?: List` — danh sách dữ liệu ban đầu để định dạng.
 
 ```typescript
 import { Formatters } from '@dxtmisha/functional-basic'
 
-// 1. Xác định các tùy chọn định dạng
+// 1. Xác định các tham số định dạng
 const options = {
   price: { 
     type: 'currency', 
@@ -44,31 +44,17 @@ const options = {
   user: {
     type: 'name',
     options: { lastPropName: 'surname', firstPropName: 'name' }
-  },
-  weight: { 
-    type: 'unit', 
-    options: { unit: 'kilogram' } 
-  },
-  count: { 
-    type: 'plural', 
-    options: { words: 'quả táo|quả táo' } 
-  },
-  status: {
-    transformation: (value: number) => value === 1 ? 'Đang hoạt động' : 'Ngừng hoạt động'
   }
 }
 
-// 2. Dữ liệu ban đầu (có thể là một mảng hoặc một đối tượng duy nhất)
+// 2. Dữ liệu thô
 const data = [
   {
     price: 100,
     currency: 'VND',
     created: '2024-03-07T12:00:00',
-    name: 'Thanh',
-    surname: 'Nguyễn',
-    weight: 75,
-    count: 5,
-    status: 1
+    name: 'An',
+    surname: 'Nguyễn'
   }
 ]
 
@@ -76,93 +62,95 @@ const data = [
 const formatter = new Formatters(options, data)
 ```
 
-## Xử lý dữ liệu
-
-### `to`
+## Các phương thức
 
-Xử lý dữ liệu và trả về kết quả. Nếu đầu vào là một mảng, nó sẽ trả về một mảng mới gồm các mục đã được bổ sung dữ liệu. Nếu đầu vào là một mục duy nhất, nó sẽ trả về chính mục đó với các trường đã định dạng.
+### Xử lý
+- `to(): FormattersReturn<List, Options>` — Xử lý dữ liệu và trả về kết quả. Nếu đầu vào là một mảng, trả về một mảng mới gồm các mục đã được làm giàu. Nếu là một mục duy nhất — một đối tượng duy nhất. Thêm các thuộc tính với hậu tố `Format`.
 
-**Trả về:** `FormattersListColumns<Item, Options> | FormattersListColumnItem<Item, Options>` — dữ liệu đã được bổ sung các thuộc tính `*Format`.
-
-```javascript
-const result = formatter.to()
-/*
-Kết quả (nếu là mảng): [
-  { 
-    id: 101, 
-    price: 100, 
-    currency: 'VND', 
-    priceFormat: '100.000 ₫', 
-    status: 1, 
-    statusFormat: 'Đang hoạt động',
-    ... 
-  }
-]
+### Cấu hình
+- `setList(list?: List): this` — Cập nhật dữ liệu để định dạng. Hỗ trợ nối chuỗi.
 
-Kết quả (nếu là một mục duy nhất): { 
-  price: 100, 
-  priceFormat: '100.000 ₫', 
-  ... 
-}
-*/
-```
-
-## Truy xuất và quản lý dữ liệu
-
-- `is(): boolean` — Kiểm tra xem danh sách/mục đã được thiết lập chưa.
-- `isArray(): boolean` — Kiểm tra xem dữ liệu hiện tại có phải là một mảng không.
+### Thông tin
+- `is(): boolean` — Kiểm tra xem dữ liệu đã được thiết lập để xử lý hay chưa.
+- `isArray(): boolean` — Liệu dữ liệu hiện tại có phải là một mảng hay không.
 - `length(): number` — Trả về số lượng bản ghi trong danh sách.
-- `getList(): Item[]` — Trả về danh sách dữ liệu hiện tại dưới dạng mảng.
+- `getList(): FormattersList<Item>` — Trả về danh sách hiện tại dưới dạng mảng.
 - `getOptions(): Options` — Trả về cấu hình định dạng hiện tại.
-- `setList(list?: List): this` — Cập nhật dữ liệu cần định dạng và trả về thực thể để gọi chuỗi lệnh.
-
-## Cấu trúc cấu hình
-
-Đối tượng cấu hình được truyền vào hàm khởi tạo là một bản đồ (map), nơi mỗi khóa tương ứng với tên một thuộc tính trong dữ liệu của bạn. Mỗi giá trị phải tuân theo cấu trúc `FormattersOptionsItem`.
-
-### Cấu trúc mục chính
 
+## Các loại định dạng và Tham số
+
+Cấu hình `FormattersOptionsList` là một từ điển trong đó các khóa tương ứng với tên thuộc tính trong dữ liệu (hỗ trợ ký hiệu chấm `path.to.prop`) và các giá trị là đối tượng `FormattersOptionsItem`.
+
+### Cấu trúc chung của `FormattersOptionsItem`
+- `type?: FormattersType` — Loại định dạng.
+- `transformation?: (value, item, options) => string` — Hàm chuyển đổi tùy chỉnh.
+- `options?: Options` — Đối tượng tham số, cấu trúc phụ thuộc vào `type` đã chọn.
+
+### Mô tả chi tiết các loại
+
+#### 1. Tiền tệ (`currency`)
+Được sử dụng để hiển thị các giá trị tiền tệ đã được bản địa hóa.
+- `currencyPropName?: string` — Tên thuộc tính trong mục chứa mã tiền tệ (mặc định là `currency`).
+- `options?: string | Intl.NumberFormatOptions` — Bạn có thể truyền một mã cố định (ví dụ: `'VND'`) hoặc một đối tượng cài đặt `Intl.NumberFormat`.
+- `numberOnly?: boolean` — Nếu `true`, chỉ trả về số đã định dạng mà không có biểu tượng tiền tệ.
+
+#### 2. Ngày tháng (`date`)
+Định dạng ngày và giờ thông qua `GeoIntl`.
+- `type?: GeoDate` — Định dạng đặt trước:
+    - `full` — Ngày và giờ đầy đủ.
+    - `datetime` — Ngày và giờ (không có giây).
+    - `date` — Chỉ ngày.
+    - `time` — Chỉ giờ.
+    - `year-month`, `year`, `month`, `day`, `day-month`, `hour-minute`.
+- `options?: Intl.DateTimeFormatOptions` — Các tham số `Intl` tiêu chuẩn (ví dụ: `month: 'long'`).
+- `hour24?: boolean` — Nếu `true`, buộc sử dụng chế độ 24 giờ.
+
+#### 3. Tên (`name`)
+Kết hợp các phần của tên đầy đủ theo đúng thứ tự.
+- `lastPropName?: string` — Trường cho họ (mặc định là `lastName`).
+- `firstPropName?: string` — Trường cho tên (mặc định là `firstName`).
+- `surname?: string` — Trường cho tên đệm (mặc định là `surname`).
+- `short?: boolean` — Nếu `true`, xuất họ và chữ cái đầu (ví dụ: "Nguyễn A.").
+
+#### 4. Số (`number`)
+Định dạng số tiêu chuẩn với phân tách chữ số.
+- `options?: Intl.NumberFormatOptions` — Các tham số `Intl` (số chữ số thập phân, kiểu dáng, v.v.).
+
+#### 5. Số nhiều (`plural`)
+Chọn dạng từ đúng tùy thuộc vào số lượng.
+- `words: string` — Các dạng từ thông qua dấu phân cách `|`.
+    - Cho tiếng Việt: `"quả táo|những quả táo"`.
+    - Cho tiếng Anh: `"apple|apples"`.
+- `options?: Intl.PluralRulesOptions` — Cài đặt quy tắc số nhiều.
+- `optionsNumber?: Intl.NumberFormatOptions` — Cài đặt định dạng cho chính con số được xuất trước từ.
+
+#### 6. Đơn vị đo lường (`unit`)
+Thêm các đơn vị đo lường (km, kg, l).
+- `unit: string` — Mã đơn vị đo lường (ví dụ: `'kilometer'`, `'kilogram'`, `'liter'`).
+- `options?: Intl.NumberFormatOptions` — Tham số định dạng cho phần số.
+
+## Ví dụ
+
+### Sử dụng Dot Notation
 ```typescript
-{
-  // 1. Chỉ định kiểu định dạng
-  type: 'currency' | 'date' | 'name' | 'number' | 'plural' | 'unit',
+const options = {
+  'user.profile.age': { type: 'number' }
+}
+const data = { user: { profile: { age: 25 } } }
+const formatter = new Formatters(options, data)
 
-  // 2. Truyền các tham số dành riêng cho kiểu tại đây
-  options: { ... },
+const result = formatter.to()
+// result.userProfileAgeFormat === "25"
+```
 
-  // 3. Hoặc sử dụng một hàm tùy chỉnh (ghi đè logic của kiểu)
-  transformation: (value, item, options) => string
+### Chuyển đổi tùy chỉnh
+```typescript
+const options = {
+  status: {
+    // Hàm tùy chỉnh có ưu tiên cao hơn type
+    transformation: (value, item) => {
+       return value === 'active' ? `✅ ${item.name} đang trực tuyến` : '❌ Ngoại tuyến'
+    }
+  }
 }
 ```
-
-## Các tham số cụ thể
-
-Dưới đây là các tham số có sẵn bên trong thuộc tính **`options`** cho từng kiểu.
-
-### Tiền tệ (`currency`)
-- `currencyPropName?: string` — Thuộc tính trong mục chứa mã tiền tệ (mặc định là `item.currency`).
-- `options?: string | Intl.NumberFormatOptions` — Mã tiền tệ cố định hoặc các tùy chọn `Intl` đầy đủ.
-- `numberOnly?: boolean` — Nếu là `true`, chỉ trả về số đã định dạng mà không có ký hiệu tiền tệ.
-
-### Ngày tháng (`date`)
-- `type?: GeoDate` — Kiểu thiết lập sẵn: `full`, `datetime`, `date`, `year-month`, `year`, `month`, `day`, `day-month`, `time`, `hour-minute`, `hour`, `minute`, `second`.
-- `options?: Intl.DateTimeFormatOptions['month'] | Intl.DateTimeFormatOptions` — Các tùy chọn ngày tháng tiêu chuẩn của `Intl` hoặc kiểu tháng.
-- `hour24?: boolean` — Kết quả định dạng bắt buộc sử dụng định dạng 24 giờ nếu là `true`.
-
-### Tên (`name`)
-- `lastPropName?: string` — Trường cho họ (mặc định: `lastName`).
-- `firstPropName?: string` — Trường cho tên (mặc định: `firstName`).
-- `surname?: string` — Trường cho tên đệm (mặc định: `surname`).
-- `short?: boolean` — Có sử dụng định dạng rút gọn (viết tắt) hay không.
-
-### Số (`number`)
-- `options?: Intl.NumberFormatOptions` — Các tùy chọn số tiêu chuẩn của `Intl`.
-
-### Số nhiều (`plural`)
-- `words: string` — Các dạng từ cách nhau bởi `|` (ví dụ: `"quả táo|quả táo"`).
-- `options?: Intl.PluralRulesOptions` — Các thiết lập quy tắc số nhiều.
-- `optionsNumber?: Intl.NumberFormatOptions` — Định dạng cho chính con số đó.
-
-### Đơn vị (`unit`)
-- `unit: string | Intl.NumberFormatOptions` — Đơn vị cần hiển thị (ví dụ: `'kilometer'`, `'kilogram'`).
-

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

@@ -8,11 +8,11 @@ A static utility class for centralized management of the application's geographi
 
 ## Key Features
 
-- **Auto-Detection** — intelligently identifies the user's locale via `navigator.language` or HTML attributes if not explicitly defined.
+- **Auto-Detection** — intelligently identifies the user's locale via storage or environment defaults.
 - **Persistence** — utilizes `DataStorage` to save and restore user-selected language and country preferences.
 - **Media Database Integration** — provides access to a comprehensive database of countries and languages from the `@dxtmisha/media` library.
-- **Global Time Management** — centralized setting and retrieval of time zone offsets for correct date handling.
-- **Static Access** — all methods are static, eliminating the need for instantiation (`new Geo()`).
+- **Global Time Management** — centralized setting and retrieval of time zone offsets.
+- **Static Access** — all methods are static, providing a convenient global interface without manual instantiation.
 
 ## Basic Usage
 

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

@@ -8,11 +8,11 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 ## Ключевые особенности
 
-- **Автоматическое определение** — интеллектуально определяет локаль пользователя через `navigator.language` или настройки HTML, если они не заданы явно.
-- **Персистентность** — использует `DataStorage` для сохранения и восстановления выбранных пользователем предпочтений языка и страны.
-- **Интеграция с медиа-базой** — предоставляет доступ к полной базе данных стран и языков из библиотеки `@dxtmisha/media`.
-- **Глобальное управление временем** — централизованная установка и получение смещения часового пояса для корректной работы с датами.
-- **Статический доступ** — все методы класса статические, что исключает необходимость создания экземпляров (`new Geo()`).
+- **Автоматическое определение** — интеллектуально определяет локаль через хранилище или настройки окружения.
+- **Персистентность** — использует `DataStorage` для сохранения и восстановления предпочтений пользователя.
+- **Интеграция с медиа-базой** — предоставляет доступ к базе данных стран и языков из библиотеки `@dxtmisha/media`.
+- **Глобальное управление временем** — централизованная установка и получение смещения часового пояса.
+- **Статический доступ** — удобный глобальный интерфейс без необходимости ручного создания экземпляров.
 
 ## Базовое использование
 

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

@@ -8,11 +8,11 @@ Một lớp tiện ích tĩnh (static class) để quản lý tập trung dữ l
 
 ## Tính năng chính
 
-- **Tự động phát hiện** — xác định thông minh địa phương (locale) của người dùng thông qua `navigator.language` hoặc các thuộc tính HTML nếu không được xác định rõ ràng.
-- **Lưu trữ lâu dài** — sử dụng `DataStorage` để lưu và khôi phục các tùy chọn ngôn ngữ và quốc gia do người dùng chọn.
-- **Tích hợp cơ sở dữ liệu truyền thông** — cung cấp quyền truy cập vào cơ sở dữ liệu toàn diện về các quốc gia và ngôn ngữ từ thư viện `@dxtmisha/media`.
-- **Quản lý thời gian toàn cầu** — thiết lập và truy xuất tập trung các độ lệch múi giờ để xử lý ngày tháng chính xác.
-- **Truy cập tĩnh** — tất cả các phương thức đều là tĩnh, loại bỏ nhu cầu khởi tạo (`new Geo()`).
+- **Tự động phát hiện** — xác định thông minh địa phương (locale) thông qua bộ nhớ hoặc mặc định của môi trường.
+- **Lưu trữ lâu dài** — sử dụng `DataStorage` để lưu và khôi phục các tùy chọn của người dùng.
+- **Tích hợp cơ sở dữ liệu truyền thông** — cung cấp quyền truy cập vào cơ sở dữ liệu quốc gia và ngôn ngữ từ thư viện `@dxtmisha/media`.
+- **Quản lý thời gian toàn cầu** — thiết lập và truy xuất tập trung các độ lệch múi giờ.
+- **Truy cập tĩnh** — cung cấp giao diện toàn cầu thuận tiện mà không cần khởi tạo thủ công.
 
 ## Cách sử dụng cơ bản