@dxtmisha/wiki 0.25.1 → 0.39.2

package/src/media/functional/ru/geo.mdx

@@ -1,346 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Classes/Geo'/>
-
-# Класс Geo
-
-Статический класс для работы с географическими данными. Предоставляет методы для определения текущего местоположения, работы с кодами стран и языков, и управления часовыми поясами с автоматическим определением через браузер и кешированием в localStorage.
-
-## Основные возможности
-
-- **Автоматическое определение местоположения** — определяет текущую страну и язык на основе данных браузера
-- **Обработка кодов стран и языков** — поддерживает формат `язык-страна` (например, `ru-RU`, `en-US`)
-- **Управление часовыми поясами** — получение и установка часовых поясов
-- **Кеширование в localStorage** — сохраняет выбранное пользователем местоположение
-- **Поддержка альтернативных кодов** — работает с различными вариантами кодов стран и языков
-- **Полная база данных стран** — доступ к полному списку стран с их данными
-- **Гибкий парсинг кодов** — обрабатывает полные коды, коды стран или языков отдельно
-
-## Методы получения данных
-
-### `get`
-
-Возвращает полную информацию о текущей стране.
-
-**Возвращает:** `GeoItemFull` — объект с полными географическими данными
-
-```javascript
-import { Geo } from '@dxtmisha/functional'
-
-const currentGeo = Geo.get()
-console.log(currentGeo)
-// {
-//   country: 'RU',
-//   language: 'ru',
-//   standard: 'ru-RU',
-//   firstDay: 'Mo',
-//   countryAlternative: ['Россия', 'Russia'],
-//   languageAlternative: ['русский', 'russian']
-// }
-```
-
-### `getCountry`
-
-Возвращает код текущей страны.
-
-**Возвращает:** `string` — ISO код страны (например, 'RU', 'US', 'GB')
-
-```javascript
-const country = Geo.getCountry()
-console.log(country) // 'RU'
-```
-
-### `getLanguage`
-
-Возвращает код текущего языка.
-
-**Возвращает:** `string` — ISO код языка (например, 'ru', 'en', 'fr')
-
-```javascript
-const language = Geo.getLanguage()
-console.log(language) // 'ru'
-```
-
-### `getStandard`
-
-Возвращает полный формат согласно стандарту (язык-страна).
-
-**Возвращает:** `string` — стандартный формат локали
-
-```javascript
-const standard = Geo.getStandard()
-console.log(standard) // 'ru-RU'
-```
-
-### `getFirstDay`
-
-Возвращает первый день недели для текущего местоположения.
-
-**Возвращает:** `string` — код первого дня ('Su' для воскресенья, 'Mo' для понедельника)
-
-```javascript
-const firstDay = Geo.getFirstDay()
-console.log(firstDay) // 'Mo' (Россия/Европа) или 'Su' (США)
-```
-
-### `getLocation`
-
-Возвращает полный формат текущего местоположения.
-
-**Возвращает:** `string` — текущее местоположение в формате язык-страна
-
-```javascript
-const location = Geo.getLocation()
-console.log(location) // 'ru-RU'
-```
-
-### `getItem`
-
-Возвращает обработанные данные с включённым текущим языком.
-
-**Возвращает:** `GeoItemFull` — географические данные с актуальным языком
-
-```javascript
-const item = Geo.getItem()
-console.log(item)
-// Включает все данные плюс актуальный язык из браузера/настроек
-```
-
-### `getList`
-
-Возвращает полный список доступных стран.
-
-**Возвращает:** `GeoItem[]` — массив всех поддерживаемых стран
-
-```javascript
-const allCountries = Geo.getList()
-console.log(allCountries.length) // 200+ стран
-console.log(allCountries[0])
-// { country: 'AD', language: 'ca', standard: 'ca-AD', firstDay: 'Mo', ... }
-```
-
-## Методы поиска данных
-
-### `getByCode`
-
-Возвращает данные страны по её коду (полному, стране или языку).
-
-**Параметры:**
-- `code?: string` — код страны в различных форматах (опционально)
-
-**Возвращает:** `GeoItemFull` — географические данные для указанного кода
-
-```javascript
-// Полный код
-const dataFull = Geo.getByCode('ru-RU')
-console.log(dataFull.country) // 'RU'
-
-// Только код страны
-const dataCountry = Geo.getByCode('GB')
-console.log(dataCountry.language) // 'en'
-
-// Только код языка
-const dataLanguage = Geo.getByCode('fr')
-console.log(dataLanguage.country) // 'FR'
-
-// Запасной вариант при неверном коде
-const dataDefault = Geo.getByCode('invalid')
-console.log(dataDefault) // Первая страна из списка
-```
-
-### `getByCodeFull`
-
-Возвращает данные страны по полному коду язык-страна.
-
-**Параметры:**
-- `code: string` — строка в формате язык-страна
-
-**Возвращает:** `GeoItem | undefined` — данные страны или undefined если не найдено
-
-```javascript
-const data = Geo.getByCodeFull('ru-RU')
-if (data) {
-  console.log(data.country) // 'RU'
-  console.log(data.language) // 'ru'
-}
-
-// Также поддерживает обратный формат
-const dataReverse = Geo.getByCodeFull('GB-en')
-console.log(dataReverse?.country) // 'GB'
-```
-
-### `getByCountry`
-
-Возвращает данные страны по коду страны.
-
-**Параметры:**
-- `country: string` — ISO код страны
-
-**Возвращает:** `GeoItem | undefined` — данные страны или undefined если не найдено
-
-```javascript
-const data = Geo.getByCountry('DE')
-if (data) {
-  console.log(data.language) // 'de'
-  console.log(data.standard) // 'de-DE'
-}
-```
-
-### `getByLanguage`
-
-Возвращает данные страны по коду языка.
-
-**Параметры:**
-- `language: string` — ISO код языка
-
-**Возвращает:** `GeoItem | undefined` — данные страны или undefined если не найдено
-
-```javascript
-const data = Geo.getByLanguage('es')
-if (data) {
-  console.log(data.country) // 'ES'
-  console.log(data.standard) // 'es-ES'
-}
-```
-
-## Методы конфигурации
-
-### `set`
-
-Устанавливает новое местоположение и сохраняет его в localStorage.
-
-**Параметры:**
-- `code?: string` — код местоположения в различных форматах (опционально)
-
-**Возвращает:** `Geo` — ссылка на класс для цепочки вызовов
-
-```javascript
-// Установка полным кодом
-Geo.set('fr-FR')
-
-// Установка кодом страны
-Geo.set('IT')
-
-// Установка кодом языка
-Geo.set('ja')
-
-// Цепочка вызовов
-Geo.set('de-DE').setTimezone(-60)
-```
-
-### `setTimezone`
-
-Устанавливает смещение часового пояса.
-
-**Параметры:**
-- `timezone: number` — смещение часового пояса в минутах
-
-**Возвращает:** `Geo` — ссылка на класс для цепочки вызовов
-
-```javascript
-// Установка UTC+3 (московское время)
-Geo.setTimezone(-180)
-
-// Установка UTC-5 (нью-йоркское время)
-Geo.setTimezone(300)
-
-// Цепочка вызовов
-Geo.setTimezone(-60).set('de-DE')
-```
-
-## Утилитарные методы
-
-### `toCountry`
-
-Преобразует код страны в формат верхнего регистра.
-
-**Параметры:**
-- `country: string` — код страны в любом регистре
-
-**Возвращает:** `string` — код страны в верхнем регистре
-
-```javascript
-const country = Geo.toCountry('ru')
-console.log(country) // 'RU'
-```
-
-### `toLanguage`
-
-Преобразует код языка в формат нижнего регистра.
-
-**Параметры:**
-- `language: string` — код языка в любом регистре
-
-**Возвращает:** `string` — код языка в нижнем регистре
-
-```javascript
-const language = Geo.toLanguage('EN')
-console.log(language) // 'en'
-```
-
-### `toFull`
-
-Преобразует базовый географический элемент в полный формат с дополнительными данными.
-
-**Параметры:**
-- `item: GeoItem` — базовый географический элемент
-
-**Возвращает:** `GeoItemFull` — расширенные географические данные
-
-```javascript
-const basicItem = { country: 'RU', language: 'ru', standard: 'ru-RU', firstDay: 'Mo' }
-const fullItem = Geo.toFull(basicItem)
-console.log(fullItem.countryAlternative) // ['Россия', 'Russia', ...]
-```
-
-## Примеры
-
-### Базовое использование
-
-```javascript
-import { Geo } from '@dxtmisha/functional'
-
-// Получить информацию о текущем местоположении
-console.log('Текущая страна:', Geo.getCountry())
-console.log('Текущий язык:', Geo.getLanguage())
-console.log('Полное местоположение:', Geo.getLocation())
-console.log('Первый день недели:', Geo.getFirstDay())
-```
-
-### Установка пользовательского местоположения
-
-```javascript
-// Установить местоположение на Германию
-Geo.set('de-DE')
-
-console.log('Новая страна:', Geo.getCountry()) // 'DE'
-console.log('Новый язык:', Geo.getLanguage()) // 'de'
-console.log('Первый день:', Geo.getFirstDay()) // 'Mo'
-```
-
-### Работа с данными стран
-
-```javascript
-// Найти страну по разным кодам
-const russiaByFull = Geo.getByCode('ru-RU')
-const russiaByCountry = Geo.getByCode('RU')
-const russiaByLanguage = Geo.getByCode('ru')
-
-console.log('Все возвращают Россию:', russiaByFull.country) // 'RU'
-```
-
-### Создание селектора стран
-
-```javascript
-// Получить все страны для выпадающего списка
-const countries = Geo.getList()
-
-const countryOptions = countries.map(country => ({
-  value: country.standard,
-  label: `${country.language}-${country.country}`,
-  country: country.country,
-  language: country.language
-}))
-
-console.log('Всего стран:', countryOptions.length)
-```

package/src/media/functional/ru/geoFlag.mdx

@@ -1,304 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Classes/GeoFlag'/>
-
-# Класс GeoFlag
-
-Класс для работы с флагами стран, предоставляющий методы для получения информации о флагах, странах и языках на основе географических кодов. Интегрируется с системой геолокации и поддерживает локализованные названия стран и языков.
-
-## Основные возможности
-
-- **Полная база флагов** — содержит флаги для всех стран мира (200+ стран)
-- **Локализованные названия** — получение названий стран и языков на текущем языке
-- **Национальные названия** — получение названий на языке самой страны
-- **Гибкие списки** — создание списков флагов по определённым критериям
-- **Интеграция с Geo** — использует географическую систему для получения данных
-- **Типобезопасность** — полная поддержка TypeScript с типизированными интерфейсами
-- **Иконочная система** — предоставляет имена иконок для флагов
-
-## Константы
-
-### `GEO_FLAG_ICON_NAME`
-
-Базовое имя для иконок флагов.
-
-```javascript
-import { GEO_FLAG_ICON_NAME } from '@dxtmisha/functional'
-
-console.log(GEO_FLAG_ICON_NAME) // '@flag'
-```
-
-## Статические свойства
-
-### `flags`
-
-Статический объект, содержащий соответствие кодов стран именам иконок флагов.
-
-```javascript
-import { GeoFlag } from '@dxtmisha/functional'
-
-console.log(GeoFlag.flags.RU) // '@flag-ru'
-console.log(GeoFlag.flags.US) // '@flag-us'
-console.log(GeoFlag.flags.DE) // '@flag-de'
-
-// Получение всех доступных кодов стран
-const countryCodes = Object.keys(GeoFlag.flags)
-console.log(countryCodes.length) // 200+ стран
-```
-
-## Конструктор
-
-### `constructor`
-
-Создаёт экземпляр GeoFlag с указанным кодом локали.
-
-**Параметры:**
-- `code?: string` — код страны и языка (по умолчанию из Geo.getLocation())
-
-```javascript
-import { GeoFlag } from '@dxtmisha/functional'
-
-// Создание с текущей локалью
-const geoFlag = new GeoFlag()
-
-// Создание с определённой локалью
-const ruFlag = new GeoFlag('ru-RU')
-const usFlag = new GeoFlag('en-US')
-const deFlag = new GeoFlag('de-DE')
-```
-
-## Методы экземпляра
-
-### `get`
-
-Возвращает информацию о стране и её флаге.
-
-**Параметры:**
-- `code?: string` — код страны (опционально, по умолчанию используется код экземпляра)
-
-**Возвращает:** `GeoFlagItem | undefined` — объект с информацией о флаге или undefined
-
-```javascript
-const geoFlag = new GeoFlag('ru-RU')
-
-// Получение информации о России
-const russiaInfo = geoFlag.get('RU')
-console.log(russiaInfo)
-// {
-//   language: 'русский',
-//   country: 'Россия',
-//   standard: 'ru-RU',
-//   icon: '@flag-ru',
-//   label: 'Россия',
-//   value: 'RU'
-// }
-
-// Получение информации о США на русском языке
-const usaInfo = geoFlag.get('US')
-console.log(usaInfo)
-// {
-//   language: 'английский',
-//   country: 'Соединённые Штаты',
-//   standard: 'en-US',
-//   icon: '@flag-us',
-//   label: 'Соединённые Штаты',
-//   value: 'US'
-// }
-
-// Получение информации о текущей локали
-const currentInfo = geoFlag.get()
-console.log(currentInfo?.country) // Название страны на текущем языке
-```
-
-### `getFlag`
-
-Получение ссылки на иконку флага.
-
-**Параметры:**
-- `code?: string` — код страны (опционально)
-
-**Возвращает:** `string | undefined` — имя иконки флага или undefined
-
-```javascript
-const geoFlag = new GeoFlag()
-
-// Получение иконки флага России
-const russiaFlag = geoFlag.getFlag('RU')
-console.log(russiaFlag) // '@flag-ru'
-
-// Получение иконки флага Германии
-const germanyFlag = geoFlag.getFlag('DE')
-console.log(germanyFlag) // '@flag-de'
-
-// Получение флага для несуществующей страны
-const unknownFlag = geoFlag.getFlag('XX')
-console.log(unknownFlag) // undefined
-```
-
-### `getList`
-
-Получение списка стран по массиву кодов.
-
-**Параметры:**
-- `codes?: string[]` — массив кодов стран (опционально, по умолчанию все страны)
-
-**Возвращает:** `GeoFlagItem[]` — массив объектов с информацией о флагах
-
-```javascript
-const geoFlag = new GeoFlag('ru-RU')
-
-// Получение списка европейских стран
-const europeanCountries = geoFlag.getList(['RU', 'DE', 'FR', 'IT', 'ES'])
-console.log(europeanCountries)
-// [
-//   { language: 'русский', country: 'Россия', icon: '@flag-ru', ... },
-//   { language: 'немецкий', country: 'Германия', icon: '@flag-de', ... },
-//   { language: 'французский', country: 'Франция', icon: '@flag-fr', ... },
-//   ...
-// ]
-
-// Получение всех доступных стран
-const allCountries = geoFlag.getList()
-console.log(allCountries.length) // 200+ стран
-
-// Получение стран СНГ
-const cisCountries = geoFlag.getList(['RU', 'BY', 'KZ', 'UA', 'UZ', 'KG', 'TJ', 'AM', 'AZ', 'GE', 'MD'])
-```
-
-### `getNational`
-
-Получение списка стран с названиями на национальных языках.
-
-**Параметры:**
-- `codes?: string[]` — массив кодов стран (опционально)
-
-**Возвращает:** `GeoFlagNational[]` — массив объектов с национальными названиями
-
-```javascript
-const geoFlag = new GeoFlag('en-US')
-
-// Получение списка с национальными названиями
-const nationalNames = geoFlag.getNational(['RU', 'DE', 'FR', 'JP'])
-console.log(nationalNames)
-// [
-//   {
-//     language: 'Russian',           // на английском (текущий язык)
-//     country: 'Russia',             // на английском (текущий язык)
-//     standard: 'ru-RU',
-//     icon: '@flag-ru',
-//     nationalLanguage: 'русский',   // на русском (национальный язык)
-//     nationalCountry: 'Россия',     // на русском (национальный язык)
-//     description: 'Россия'          // национальное название
-//   },
-//   {
-//     language: 'German',
-//     country: 'Germany',
-//     standard: 'de-DE',
-//     icon: '@flag-de',
-//     nationalLanguage: 'Deutsch',
-//     nationalCountry: 'Deutschland',
-//     description: 'Deutschland'
-//   },
-//   ...
-// ]
-```
-
-### `setCode`
-
-Изменение локали экземпляра.
-
-**Параметры:**
-- `code: string` — новый код страны и языка
-
-**Возвращает:** `this` — для цепочки вызовов
-
-```javascript
-const geoFlag = new GeoFlag('en-US')
-
-// Получение информации на английском
-let info = geoFlag.get('RU')
-console.log(info?.country) // 'Russia'
-
-// Смена локали на русскую
-geoFlag.setCode('ru-RU')
-
-// Получение той же информации на русском
-info = geoFlag.get('RU')
-console.log(info?.country) // 'Россия'
-```
-
-## Практические примеры
-
-### Компонент выбора страны
-
-```javascript
-class CountrySelector {
-  constructor(targetElement, options = {}) {
-    this.geoFlag = new GeoFlag(options.locale || 'ru-RU')
-    this.element = targetElement
-    this.onSelect = options.onSelect || (() => {})
-    this.render()
-  }
-
-  render() {
-    const countries = this.geoFlag.getList()
-    this.element.innerHTML = countries.map(country => `
-      <div data-code="${country.value}">${country.country}</div>
-    `).join('')
-
-    this.element.addEventListener('click', (e) => {
-      const code = e.target.dataset.code
-      if (code) this.onSelect(this.geoFlag.get(code))
-    })
-  }
-}
-
-// Использование
-new CountrySelector(document.getElementById('selector'), {
-  locale: 'ru-RU',
-  onSelect: (country) => console.log('Выбрана:', country.country)
-})
-```
-
-### Многоязычная информация
-
-```javascript
-const guide = {
-  getCountryInfo(code) {
-    const locales = ['ru-RU', 'en-US', 'de-DE']
-    return locales.reduce((acc, locale) => {
-      acc[locale] = new GeoFlag(locale).get(code)
-      return acc
-    }, {})
-  }
-}
-
-// Использование
-const info = guide.getCountryInfo('DE')
-console.log(info['ru-RU'].country) // 'Германия'
-console.log(info['en-US'].country) // 'Germany'
-```
-
-### Статистика по странам
-
-```javascript
-const stats = {
-  getLanguageStats() {
-    const countries = new GeoFlag().getList()
-    const langStats = {}
-
-    countries.forEach(country => {
-      const lang = country.language
-      langStats[lang] = (langStats[lang] || 0) + 1
-    })
-
-    return Object.entries(langStats)
-      .sort(([,a], [,b]) => b - a)
-      .slice(0, 10)
-  }
-}
-
-console.log(stats.getLanguageStats()) // Топ-10 языков
-```
-
-Класс GeoFlag предоставляет мощный инструмент для работы с флагами и информацией о странах, поддерживая локализацию, типобезопасность и гибкие возможности для создания международных приложений.