@dxtmisha/wiki 0.39.6 → 0.39.8

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

@@ -4,76 +4,119 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # GeoFlag Class
 
-A class for working with country flags. Provides a convenient interface for retrieving flag icons, localized country and language names based on a country code or locale. It uses `Geo` and `GeoIntl` to resolve localized names.
+A class for working with country flags and geographic information. It provides a convenient interface for retrieving flag icons, localized country names, and languages. It uses the `Geo` and `GeoIntl` singletons to correctly resolve data based on the current locale.
 
 ## Key Features
 
-- **Flag Dictionary** — A built-in static `flags` dictionary mapping ISO 3166-1 alpha-2 country codes to icon names.
-- **Localized Names** — Returns country and language names according to the current UI locale.
-- **National Names** — A dedicated `getNational` method returns country names in their own language.
-- **Flexible Filtering** — List methods support filtering by an array of codes.
+- **Flag Dictionary** — built-in static `flags` list mapping ISO 3166-1 alpha-2 codes to icon names.
+- **Localized Data** — automatic translation of country and language names into the current interface language.
+- **National Support** — the ability to retrieve country names in their "native" language (e.g., "Japan" and "日本" simultaneously).
+- **Scalability** — support for filtering and retrieving full lists for country selectors.
 
 ## Initialization
 
-Creates a new `GeoFlag` instance with an optional country or locale code.
+To create an instance, use the `GeoFlag(code)` constructor.
 
 **Parameters:**
-- `code?: string` — Country or locale code (e.g., `'US'`, `'en-US'`). Defaults to the current locale from `Geo`.
+- `code?: string` — country or locale code (e.g., `'US'`, `'en-US'`). If not specified, the current locale from the `Geo` system is used.
 
 ```javascript
 import { GeoFlag } from '@dxtmisha/functional-basic'
 
-// Create with the current locale
+// With current locale
 const flag = new GeoFlag()
 
-// Create for a specific country
+// For a specific country
 const usFlag = new GeoFlag('en-US')
 ```
 
 ## Methods
 
 ### Data Retrieval
+- `get(code?: string): GeoFlagItem | undefined` — Returns a full data object about a country.
+- `getFlag(code?: string): string | undefined` — Returns only the flag icon identifier (e.g., `'f-us'`).
 
-- `get(code?: string): GeoFlagItem | undefined` — Returns a full data object for a country: language, country code, standard, and flag icon name. If no code is specified, uses the constructor's code.
-- `getFlag(code?: string): string | undefined` — Returns only the icon name for a given country's flag.
-- `getList(codes?: string[]): GeoFlagItem[]` — Returns an array of flag data objects. If `codes` is not provided, returns all countries from the dictionary.
-- `getNational(codes?: string[]): GeoFlagNational[]` — Similar to `getList`, but additionally contains country names in the country's own language.
+### Lists
+- `getList(codes?: string[]): GeoFlagItem[]` — Returns an array of country data.
+- `getNational(codes?: string[]): GeoFlagNational[]` — Returns a list of countries with national names.
 
-### Data Mutation
+### Configuration
+- `setCode(code: string): this` — Changes the base locale for the current instance.
 
-- `setCode(code: string): this` — Changes the country code for the current instance.
+## List Methods
 
-## Examples
+The main difference between the methods lies in the language in which the country and language names are returned:
 
-### Displaying a Flag for the Current Country
-```javascript
-import { GeoFlag } from '@dxtmisha/functional-basic'
+*   **`getList`** — returns names only in the language set in the class instance (e.g., everything in English).
+*   **`getNational`** — returns names in your interface language + adds original names in the country's own language (e.g., "Japan" and "日本").
 
-const flag = new GeoFlag()
-const item = flag.get()
+### Example of the difference in result:
 
-console.log(item?.icon)    // 'f-us'
-console.log(item?.country) // 'United States'
+```javascript
+const geo = new GeoFlag('en-US') // English language is set
+
+// 1. getList returns only the translation
+const list = geo.getList(['JP']) 
+/* 
+[{ country: 'Japan', ... }] 
+*/
+
+// 2. getNational returns the translation + original name
+const national = geo.getNational(['JP']) 
+/* 
+[{ 
+  country: 'Japan', 
+  nationalCountry: '日本', 
+  ... 
+}] 
+*/
 ```
 
-### List of All Countries with Flags
-```javascript
-const flag = new GeoFlag('en-US')
-const countries = flag.getList()
+## Types
 
-countries.forEach(item => {
-  console.log(`${item.icon}: ${item.country}`)
-})
-// 'f-fr: France', 'f-de: Germany', ...
-```
+### `GeoFlagItem`
+Basic flag information object.
+- `country`: string — Localized country name.
+- `language`: string — Localized language name.
+- `standard`: string — Full locale standard (e.g., `en-US`).
+- `icon`: string — Flag icon name (prefix `f-`).
+- `label`: string — Display label (matches `country` by default).
+- `value`: string — Country code (ISO alpha-2).
 
-### List with National Names
-```javascript
-// Returns the country name in both your language and the country's own language
-const national = new GeoFlag('en-US').getNational(['FR', 'JP', 'RU'])
+### `GeoFlagNational`
+Extends `GeoFlagItem` with additional fields:
+- `nationalCountry`: string — Country name in its native language.
+- `nationalLanguage`: string — Language name in its native language.
+- `description`: string — Brief description (duplicates `nationalCountry`).
 
-national.forEach(item => {
-  console.log(`${item.country} (${item.nationalCountry})`)
-})
-// France (France), Japan (日本), Russia (Россия)
+## Examples
+
+### List of Popular Countries with National Names
+```javascript
+const geo = new GeoFlag('en-US')
+const list = geo.getNational(['US', 'CN', 'JP'])
+
+/* 
+Result:
+[
+  { 
+    country: 'United States', 
+    nationalCountry: 'United States', 
+    icon: 'f-us', 
+    ... 
+  },
+  { 
+    country: 'China', 
+    nationalCountry: '中国', 
+    icon: 'f-cn', 
+    ... 
+  },
+  { 
+    country: 'Japan', 
+    nationalCountry: '日本', 
+    icon: 'f-jp', 
+    ... 
+  }
+]
+*/
 ```

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

@@ -4,76 +4,119 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 # Класс GeoFlag
 
-Класс для работы с флагами стран. Предоставляет удобный интерфейс для получения иконок флагов, отображаемых имен стран и языков на основе кода страны или локали. Использует `Geo` и `GeoIntl` для разрешения локализованных наименований.
+Класс для работы с флагами стран и географической информацией. Он предоставляет удобный интерфейс для получения иконок флагов, локализованных названий стран и языков. Использует синглтоны `Geo` и `GeoIntl` для корректного разрешения данных в зависимости от текущей локали.
 
 ## Ключевые особенности
 
-- **Словарь флагов** — встроенный статический словарь `flags`, связывающий коды стран (ISO 3166-1 alpha-2) с именами иконок.
-- **Локализованные имена** — возвращает название страны и языка в соответствии с текущей локалью интерфейса.
-- **Национальные имена** — отдельный метод `getNational` возвращает названия стран на их собственном языке.
-- **Гибкая фильтрация** — методы списков поддерживают фильтрацию по массиву кодов.
+- **Словарь флагов** — встроенный статический список `flags`, связывающий коды ISO 3166-1 alpha-2 с именами иконок.
+- **Локализованные данные** — автоматический перевод названий стран и языков на язык текущего интерфейса.
+- **Национальная поддержка** — возможность получения названий стран на их «родном» языке (например, «Япония» и «日本» одновременно).
+- **Масштабируемость** — поддержка фильтрации и получения полных списков для селекторов стран.
 
 ## Инициализация
 
-Создает новый экземпляр `GeoFlag` с опциональным кодом страны или локали.
+Для создания экземпляра используйте конструктор `GeoFlag(code)`.
 
 **Параметры:**
-- `code?: string` — код страны или локали (например, `'RU'`, `'ru-RU'`). По умолчанию используется текущая локаль из `Geo`.
+- `code?: string` — код страны или локали (например, `'RU'`, `'en-US'`). Если не указан, используется текущая локаль из системы `Geo`.
 
 ```javascript
 import { GeoFlag } from '@dxtmisha/functional-basic'
 
-// Создание с текущей локалью
+// С текущей локалью
 const flag = new GeoFlag()
 
-// Создание для конкретной страны
+// Для конкретной страны
 const ruFlag = new GeoFlag('ru-RU')
 ```
 
 ## Методы
 
 ### Получение данных
+- `get(code?: string): GeoFlagItem | undefined` — Возвращает полный объект данных о стране.
+- `getFlag(code?: string): string | undefined` — Возвращает только идентификатор иконки флага (например, `'f-ru'`).
 
-- `get(code?: string): GeoFlagItem | undefined` — Возвращает полный объект данных о стране: языке, коде страны, стандарте, иконке флага. Если код не указан, используется код из конструктора.
-- `getFlag(code?: string): string | undefined` — Возвращает только имя иконки флага для указанной страны.
-- `getList(codes?: string[]): GeoFlagItem[]` — Возвращает массив объектов с данными о флагах. Если `codes` не передан, возвращает все страны из словаря.
-- `getNational(codes?: string[]): GeoFlagNational[]` — Аналог `getList`, но дополнительно содержит названия на национальном языке страны.
+### Списки
+- `getList(codes?: string[]): GeoFlagItem[]` — Возвращает массив данных о странах.
+- `getNational(codes?: string[]): GeoFlagNational[]` — Возвращает список стран с национальными названиями.
 
-### Изменение данных
+### Настройка
+- `setCode(code: string): this` — Изменяет базовую локаль для текущего экземпляра.
 
-- `setCode(code: string): this` — Изменяет код страны для текущего экземпляра.
+## Методы работы со списками
 
-## Примеры
+Основное различие между методами заключается в языке, на котором возвращаются названия стран и языков:
 
-### Отображение флага для текущей страны
-```javascript
-import { GeoFlag } from '@dxtmisha/functional-basic'
+*   **`getList`** — возвращает названия только на том языке, который установлен в экземпляре класса (например, всё на русском).
+*   **`getNational`** — возвращает названия на языке вашего интерфейса + добавляет оригинальные названия на языке самой страны (например, «Япония» и «日本»).
 
-const flag = new GeoFlag()
-const item = flag.get()
+### Пример разницы в результате:
 
-console.log(item?.icon)    // 'f-ru'
-console.log(item?.country) // 'Россия'
+```javascript
+const geo = new GeoFlag('ru-RU') // Установлен русский язык
+
+// 1. getList возвращает только перевод
+const list = geo.getList(['JP']) 
+/* 
+[{ country: 'Япония', ... }] 
+*/
+
+// 2. getNational возвращает перевод + оригинальное название
+const national = geo.getNational(['JP']) 
+/* 
+[{ 
+  country: 'Япония', 
+  nationalCountry: '日本', 
+  ... 
+}] 
+*/
 ```
 
-### Список всех стран с флагами
-```javascript
-const flag = new GeoFlag('ru-RU')
-const countries = flag.getList()
+## Типы
 
-countries.forEach(item => {
-  console.log(`${item.icon}: ${item.country}`)
-})
-// 'f-us: США', 'f-fr: Франция', ...
-```
+### `GeoFlagItem`
+Базовый объект информации о флаге.
+- `country`: string — Локализованное название страны.
+- `language`: string — Локализованное название языка.
+- `standard`: string — Полный стандарт локали (например, `ru-RU`).
+- `icon`: string — Имя иконки флага (префикс `f-`).
+- `label`: string — Метка для отображения (по умолчанию совпадает с `country`).
+- `value`: string — Код страны (ISO alpha-2).
 
-### Список с национальными наименованиями
-```javascript
-// Вернет название страны как на вашем языке, так и на языке самой страны
-const national = new GeoFlag('ru-RU').getNational(['US', 'FR', 'JP'])
+### `GeoFlagNational`
+Расширяет `GeoFlagItem` дополнительными полями:
+- `nationalCountry`: string — Название страны на её родном языке.
+- `nationalLanguage`: string — Название языка на родном языке.
+- `description`: string — Краткое описание (дублирует `nationalCountry`).
 
-national.forEach(item => {
-  console.log(`${item.country} (${item.nationalCountry})`)
-})
-// США (United States), Франция (France), Япония (日本)
+## Примеры
+
+### Список популярных стран с национальными именами
+```javascript
+const geo = new GeoFlag('ru-RU')
+const list = geo.getNational(['RU', 'CN', 'JP'])
+
+/* 
+Результат:
+[
+  { 
+    country: 'Россия', 
+    nationalCountry: 'Россия', 
+    icon: 'f-ru', 
+    ... 
+  },
+  { 
+    country: 'Китай', 
+    nationalCountry: '中国', 
+    icon: 'f-cn', 
+    ... 
+  },
+  { 
+    country: 'Япония', 
+    nationalCountry: '日本', 
+    icon: 'f-jp', 
+    ... 
+  }
+]
+*/
 ```

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

@@ -1,79 +1,122 @@
 import {Meta} from '@storybook/addon-docs/blocks'
 
-<Meta title='@dxtmisha/vi/functional-basic/Classes/GeoFlag - Cờ Quốc gia'/>
+<Meta title='@dxtmisha/vi/functional-basic/Classes/GeoFlag - Cờ các quốc gia'/>
 
 # Lớp GeoFlag
 
-Một lớp dành cho việc làm việc với cờ quốc gia. Cung cấp giao diện thuận tiện để truy xuất biểu tượng cờ, tên quốc gia và ngôn ngữ đã được bản địa hóa dựa trên mã quốc gia hoặc ngôn ngữ. Sử dụng `Geo` và `GeoIntl` để phân giải các tên gọi đã được bản địa hóa.
+Một lớp để làm việc với cờ các quốc gia và thông tin địa lý. Nó cung cấp một giao diện thuận tiện để lấy các biểu tượng cờ, tên quốc gia và ngôn ngữ đã được bản địa hóa. Nó sử dụng các singleton `Geo` và `GeoIntl` để giải quyết dữ liệu một cách chính xác dựa trên ngôn ngữ hiện tại.
 
-## Tính năng chính
+## Các tính năng chính
 
-- **Từ điển cờ** — Từ điển tĩnh (`flags`) tích hợp sẵn, ánh xạ mã quốc gia ISO 3166-1 alpha-2 tới tên biểu tượng.
-- **Tên gọi đã bản địa hóa** — Trả về tên quốc gia và ngôn ngữ theo ngôn ngữ giao diện hiện tại.
-- **Tên gọi dân tộc** — Phương thức `getNational` trả về tên quốc gia theo ngôn ngữ của chính nước đó.
-- **Lọc linh hoạt** — Các phương thức danh sách hỗ trợ lọc theo mảng mã quốc gia.
+- **Từ điển cờ** — danh sách `flags` tĩnh tích hợp ánh xạ mã ISO 3166-1 alpha-2 với tên biểu tượng.
+- **Dữ liệu được bản địa hóa** — tự động dịch tên quốc gia và ngôn ngữ sang ngôn ngữ giao diện hiện tại.
+- **Hỗ trợ quốc gia** — khả năng lấy tên quốc gia bằng ngôn ngữ "gốc" của họ (ví dụ: "Nhật Bản" và "日本" đồng thời).
+- **Khả năng mở rộng** — hỗ trợ lọc và lấy danh sách đầy đủ cho các bộ chọn quốc gia.
 
 ## Khởi tạo
 
-Tạo một thực thể `GeoFlag` mới với mã quốc gia hoặc ngôn ngữ tùy chọn.
+Để tạo một thực thể, hãy sử dụng constructor `GeoFlag(code)`.
 
 **Tham số:**
-- `code?: string` — Mã quốc gia hoặc ngôn ngữ (ví dụ: `'VN'`, `'vi-VN'`). Mặc định sử dụng ngôn ngữ hiện tại từ `Geo`.
+- `code?: string` — mã quốc gia hoặc ngôn ngữ (ví dụ: `'VN'`, `'vi-VN'`). Nếu không được chỉ định, ngôn ngữ hiện tại từ hệ thống `Geo` sẽ được sử dụng.
 
 ```javascript
 import { GeoFlag } from '@dxtmisha/functional-basic'
 
-// Tạo với ngôn ngữ hiện tại
+// Với ngôn ngữ hiện tại
 const flag = new GeoFlag()
 
-// Tạo cho một quốc gia cụ thể
+// Cho một quốc gia cụ thể
 const vnFlag = new GeoFlag('vi-VN')
 ```
 
-## Phương thức
+## Các phương thức
 
-### Truy xuất dữ liệu
+### Lấy dữ liệu
+- `get(code?: string): GeoFlagItem | undefined` — Trả về một đối tượng dữ liệu đầy đủ về một quốc gia.
+- `getFlag(code?: string): string | undefined` — Trả về chỉ định danh biểu tượng cờ (ví dụ: `'f-vn'`).
 
-- `get(code?: string): GeoFlagItem | undefined` — Trả về đối tượng dữ liệu đầy đủ về một quốc gia: ngôn ngữ, mã quốc gia, tiêu chuẩn và tên biểu tượng cờ. Nếu không có mã, sử dụng mã từ constructor.
-- `getFlag(code?: string): string | undefined` — Chỉ trả về tên biểu tượng cờ của quốc gia được chỉ định.
-- `getList(codes?: string[]): GeoFlagItem[]` — Trả về mảng các đối tượng dữ liệu cờ. Nếu `codes` không được cung cấp, trả về tất cả các quốc gia từ từ điển.
-- `getNational(codes?: string[]): GeoFlagNational[]` — Tương tự `getList`, nhưng bổ sung tên quốc gia theo ngôn ngữ của chính nước đó.
+### Danh sách
+- `getList(codes?: string[]): GeoFlagItem[]` — Trả về một mảng dữ liệu quốc gia.
+- `getNational(codes?: string[]): GeoFlagNational[]` — Trả về danh sách các quốc gia với tên quốc gia gốc.
 
-### Thay đổi dữ liệu
+### Cấu hình
+- `setCode(code: string): this` — Thay đổi ngôn ngữ cơ sở cho thực thể hiện tại.
 
-- `setCode(code: string): this` — Thay đổi mã quốc gia cho thực thể hiện tại.
+## Các phương thức danh sách
 
-## Ví dụ
+Sự khác biệt chính giữa các phương thức nằm ở ngôn ngữ mà tên quốc gia và ngôn ngữ được trả về:
 
-### Hiển thị cờ cho quốc gia hiện tại
-```javascript
-import { GeoFlag } from '@dxtmisha/functional-basic'
+*   **`getList`** — trả về tên chỉ bằng ngôn ngữ được thiết lập trong thực thể lớp (ví dụ: tất cả bằng tiếng Việt).
+*   **`getNational`** — trả về tên bằng ngôn ngữ giao diện của bạn + thêm tên gốc bằng ngôn ngữ của chính quốc gia đó (ví dụ: "Nhật Bản" và "日本").
 
-const flag = new GeoFlag()
-const item = flag.get()
+### Ví dụ về sự khác biệt trong kết quả:
 
-console.log(item?.icon)    // 'f-vn'
-console.log(item?.country) // 'Việt Nam'
+```javascript
+const geo = new GeoFlag('vi-VN') // Ngôn ngữ tiếng Việt được thiết lập
+
+// 1. getList chỉ trả về bản dịch
+const list = geo.getList(['JP']) 
+/* 
+[{ country: 'Nhật Bản', ... }] 
+*/
+
+// 2. getNational trả về bản dịch + tên gốc
+const national = geo.getNational(['JP']) 
+/* 
+[{ 
+  country: 'Nhật Bản', 
+  nationalCountry: '日本', 
+  ... 
+}] 
+*/
 ```
 
-### Danh sách tất cả quốc gia với cờ
-```javascript
-const flag = new GeoFlag('vi-VN')
-const countries = flag.getList()
+## Các kiểu dữ liệu
 
-countries.forEach(item => {
-  console.log(`${item.icon}: ${item.country}`)
-})
-// 'f-us: Hoa Kỳ', 'f-fr: Pháp', ...
-```
+### `GeoFlagItem`
+Đối tượng thông tin cờ cơ bản.
+- `country`: string — Tên quốc gia đã được bản địa hóa.
+- `language`: string — Tên ngôn ngữ đã được bản địa hóa.
+- `standard`: string — Tiêu chuẩn ngôn ngữ đầy đủ (ví dụ: `vi-VN`).
+- `icon`: string — Tên biểu tượng cờ (tiền tố `f-`).
+- `label`: string — Nhãn hiển thị (mặc định khớp với `country`).
+- `value`: string — Mã quốc gia (ISO alpha-2).
 
-### Danh sách với tên gọi dân tộc
-```javascript
-// Trả về tên quốc gia bằng cả ngôn ngữ của bạn và ngôn ngữ của chính nước đó
-const national = new GeoFlag('vi-VN').getNational(['US', 'JP', 'RU'])
+### `GeoFlagNational`
+Mở rộng `GeoFlagItem` với các trường bổ sung:
+- `nationalCountry`: string — Tên quốc gia bằng ngôn ngữ gốc.
+- `nationalLanguage`: string — Tên ngôn ngữ bằng ngôn ngữ gốc.
+- `description`: string — Mô tả ngắn gọn (sao chép `nationalCountry`).
 
-national.forEach(item => {
-  console.log(`${item.country} (${item.nationalCountry})`)
-})
-// Hoa Kỳ (United States), Nhật Bản (日本), Nga (Россия)
+## Ví dụ
+
+### Danh sách các quốc gia phổ biến với tên quốc gia gốc
+```javascript
+const geo = new GeoFlag('vi-VN')
+const list = geo.getNational(['VN', 'CN', 'JP'])
+
+/* 
+Kết quả:
+[
+  { 
+    country: 'Việt Nam', 
+    nationalCountry: 'Việt Nam', 
+    icon: 'f-vn', 
+    ... 
+  },
+  { 
+    country: 'Trung Quốc', 
+    nationalCountry: '中国', 
+    icon: 'f-cn', 
+    ... 
+  },
+  { 
+    country: 'Nhật Bản', 
+    nationalCountry: '日本', 
+    icon: 'f-jp', 
+    ... 
+  }
+]
+*/
 ```

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

@@ -0,0 +1,81 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/GeoInstance - Geographic Data Instance'/>
+
+# GeoInstance Class
+
+An instance-based class for managing geographical data. It handles language codes (ISO 639-1), country codes (ISO 3166-1 alpha-2), time zones, and localization. Unlike the static `Geo` class, `GeoInstance` allows creating independent objects with their own state, which is particularly useful for request isolation in SSR or multi-context environments.
+
+## Key Features
+
+- **Object-Oriented** — allows creating multiple instances with different configurations.
+- **Auto-Detection** — intelligently identifies the locale via storage or environment defaults during initialization.
+- **Media Database Integration** — provides access to a comprehensive database of countries and languages from the `@dxtmisha/media` library.
+- **Dynamic Time Management** — instance-level setting and retrieval of time zone offsets.
+
+## Basic Usage
+
+You can create a new instance of the class to manage a specific geographic context.
+
+```javascript
+import { GeoInstance } from '@dxtmisha/functional-basic'
+
+const geo = new GeoInstance()
+
+// Get the current language code
+console.log(geo.getLanguage()) // e.g., 'en'
+
+// Set a new locale for this instance
+geo.set('fr-FR')
+
+// Get the formatted time zone
+console.log(geo.getTimezoneFormat()) // e.g., '+00:00'
+```
+
+## Methods
+
+### Information
+
+- `get(): GeoItemFull` — Returns the full data object for the current country and language.
+- `getItem(): GeoItemFull` — Returns a copy of the current settings object, accounting for the dynamic language.
+- `getCountry(): string` — Returns the 2-letter code of the current country (uppercase).
+- `getLanguage(): string` — Returns the 2-letter code of the current language (lowercase).
+- `getStandard(): string` — Returns the combined locale string based on current settings (e.g., `'en-VN'`).
+- `getLocation(): string` — Returns the currently set raw locale string.
+- `getFirstDay(): string` — Returns the code for the first day of the week (e.g., `'Mo'`).
+- `getTimezone(): number` — Returns the time zone offset in minutes.
+- `getTimezoneFormat(): string` — Returns the time zone offset in string format (e.g., `'+03:00'`).
+
+### Selection
+
+- `getList(): GeoItem[]` — Returns the full list of available countries and languages.
+- `find(code: string): GeoItemFull` — An alias for the `getByCode` method.
+- `getByCode(code?: string): GeoItemFull` — Searches for data by code. **Priority: Language first**, then Country. If `en-VN` is provided, it will return the record for English (`en-US`).
+- `getByCodeFull(code: string): GeoItem | undefined` — Searches for an exact match by full locale code (e.g., `ru-RU`).
+- `getByCountry(country: string): GeoItem | undefined` — Searches for data specifically by country code.
+- `getByLanguage(language: string): GeoItem | undefined` — Searches for data specifically by language code.
+
+### Configuration
+
+- `set(code: string, save?: boolean): void` — Sets the locale for the current instance.
+- `setTimezone(timezone: number): void` — Sets a custom time zone offset in minutes.
+
+### Auxiliary
+
+- `toStandard(item: GeoItem): string` — Generates a standard `'language-country'` string from a `GeoItem` object.
+
+## Examples
+
+### Isolated Contexts
+```javascript
+import { GeoInstance } from '@dxtmisha/functional-basic'
+
+const geoEN = new GeoInstance()
+geoEN.set('en-US')
+
+const geoRU = new GeoInstance()
+geoRU.set('ru-RU')
+
+console.log(geoEN.getLanguage()) // 'en'
+console.log(geoRU.getLanguage()) // 'ru'
+```