@dxtmisha/wiki 0.25.1 → 0.39.2

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

@@ -1,157 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Classes/Global'/>
-
-# Класс Global
-
-Статический класс для управления глобальными данными приложения. Предоставляет простой и безопасный способ хранения и получения глобальных конфигураций, настроек и данных с защитой от повторной инициализации.
-
-## Основные возможности
-
-- **Единоразовая инициализация** — данные можно добавить только один раз для предотвращения случайного перезаписывания
-- **Типобезопасное получение данных** — поддержка дженериков TypeScript для типизированного доступа
-- **Глобальное хранилище** — централизованное место для хранения конфигураций приложения
-- **Простой API** — всего два метода для работы с глобальными данными
-- **Защита от конфликтов** — предотвращает повторную инициализацию глобальных данных
-- **Память эффективность** — использует простое копирование объекта без глубокого клонирования
-
-## Статические методы
-
-### `add`
-
-Добавляет глобальные данные. Метод работает только один раз для предотвращения случайного перезаписывания.
-
-**Параметры:**
-- `data: Record<string, any>` — объект с глобальными данными
-
-**Возвращает:** `void`
-
-```javascript
-import { Global } from '@dxtmisha/functional'
-
-// Инициализация глобальных данных (выполняется один раз)
-Global.add({
-  apiUrl: 'https://api.example.com',
-  appName: 'MyApplication',
-  version: '1.0.0',
-  features: {
-    darkMode: true,
-    notifications: false
-  },
-  maxRetries: 3
-})
-
-// Попытка повторной инициализации будет проигнорирована
-Global.add({
-  apiUrl: 'https://different-api.com' // Это не перезапишет данные
-})
-```
-
-### `get`
-
-Возвращает значение по его имени с поддержкой типизации.
-
-**Параметры:**
-- `name: string` — название свойства для получения
-
-**Возвращает:** `R` — значение указанного типа или undefined
-
-```javascript
-// Получение данных с автоматическим выводом типов
-const apiUrl = Global.get('apiUrl')
-console.log(apiUrl) // 'https://api.example.com'
-
-// Получение с явным указанием типа
-const features = Global.get<{ darkMode: boolean; notifications: boolean }>('features')
-console.log(features.darkMode) // true
-
-// Получение примитивных типов
-const maxRetries = Global.get<number>('maxRetries')
-console.log(maxRetries) // 3
-
-// Получение несуществующего свойства
-const nonExistent = Global.get('nonExistent')
-console.log(nonExistent) // undefined
-```
-
-## Практические примеры
-
-### Конфигурация приложения
-
-```javascript
-class AppConfig {
-  static initialize() {
-    Global.add({
-      api: {
-        baseUrl: process.env.API_BASE_URL || 'https://api.myapp.com',
-        timeout: 10000,
-        retries: 3
-      },
-      ui: {
-        theme: 'light',
-        language: 'ru',
-        animations: true
-      },
-      features: {
-        newDashboard: true,
-        advancedSearch: false
-      },
-      app: {
-        name: 'MyApplication',
-        version: '2.1.0',
-        environment: process.env.NODE_ENV || 'production'
-      }
-    })
-  }
-
-  static getApiConfig() {
-    return Global.get('api')
-  }
-
-  static isFeatureEnabled(featureName) {
-    const features = Global.get('features')
-    return features ? features[featureName] || false : false
-  }
-}
-
-// Использование
-AppConfig.initialize()
-const apiConfig = AppConfig.getApiConfig()
-console.log(`API URL: ${apiConfig.baseUrl}`)
-```
-
-### Система констант
-
-```javascript
-const AppConstants = {
-  setup() {
-    Global.add({
-      constants: {
-        limits: {
-          maxFileSize: 10 * 1024 * 1024, // 10MB
-          sessionTimeout: 30 * 60 * 1000 // 30 минут
-        },
-        endpoints: {
-          auth: '/api/auth',
-          users: '/api/users'
-        },
-        patterns: {
-          email: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
-          phone: /^\+?[\d\s\-\(\)]+$/
-        }
-      }
-    })
-  },
-
-  validateEmail(email) {
-    const patterns = Global.get('constants')?.patterns
-    return patterns ? patterns.email.test(email) : false
-  }
-}
-
-// Использование
-AppConstants.setup()
-console.log(AppConstants.validateEmail('user@example.com')) // true
-```
-
-Класс Global предоставляет простой и надежный способ управления глобальными данными приложения, обеспечивая централизованное хранение конфигураций с защитой от случайного перезаписывания.

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

@@ -1,150 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Classes/Hash'/>
-
-# Класс Hash
-
-Статический класс для работы с данными в URL hash с автоматической синхронизацией браузера. Обеспечивает сохранение состояния приложения в URL, систему наблюдения за изменениями и автоматическое преобразование типов данных.
-
-## Основные возможности
-
-- **Синхронизация с URL** — автоматическое обновление hash части URL браузера
-- **Система наблюдения** — колбэки на изменения конкретных переменных
-- **Преобразование типов** — автоматическое преобразование строк в нужные типы
-- **Защита от циклов** — предотвращение бесконечных обновлений URL
-- **Поддержка функций** — значения по умолчанию через функции
-- **Парсинг URL** — автоматический разбор существующих hash параметров
-- **TypeScript поддержка** — типобезопасность с дженериками
-- **Персистентность** — сохранение данных между перезагрузками страницы
-
-## Методы управления данными
-
-### `get`
-
-Получает значение переменной из hash.
-
-**Параметры:**
-- `name: string` — название переменной
-- `defaultValue?: T | (() => T)` — значение по умолчанию или функция
-
-**Возвращает:** `T` — значение переменной
-
-```javascript
-import { Hash } from '@dxtmisha/functional'
-
-// Простое получение
-const userId = Hash.get('userId', '12345')
-
-// С функцией по умолчанию
-const timestamp = Hash.get('timestamp', () => Date.now())
-
-// Типизированное получение
-const settings = Hash.get<{theme: string}>('settings', {theme: 'dark'})
-```
-
-### `set`
-
-Устанавливает значение переменной в hash.
-
-**Параметры:**
-- `name: string` — название переменной
-- `callback: T | (() => T)` — новое значение или функция
-
-```javascript
-// Простая установка
-Hash.set('userId', '12345')
-
-// Установка объекта
-Hash.set('settings', { theme: 'dark', lang: 'ru' })
-
-// С функцией
-Hash.set('counter', () => Math.random())
-
-// Удаление
-Hash.set('temp', undefined)
-```
-
-### `addWatch`
-
-Добавляет наблюдатель за изменениями переменной.
-
-**Параметры:**
-- `name: string` — название переменной
-- `callback: (value: T) => void` — функция обратного вызова
-
-```javascript
-// Наблюдение за темой
-Hash.addWatch('theme', (theme) => {
-  document.body.className = `theme-${theme}`
-})
-
-// Наблюдение за пользователем
-Hash.addWatch('userId', (userId) => {
-  if (userId) loadUserData(userId)
-})
-```
-
-### `reload`
-
-Принудительно обновляет данные из текущего URL hash.
-
-```javascript
-// После программного изменения location.hash
-location.hash = '#param:value'
-Hash.reload()
-
-// При инициализации приложения
-Hash.reload()
-const currentPage = Hash.get('page', 'home')
-```
-
-## Практические примеры
-
-### Управление состоянием
-
-```javascript
-// Инициализация
-Hash.reload()
-
-// Установка наблюдателей
-Hash.addWatch('page', (page) => navigateTo(page))
-Hash.addWatch('filters', (filters) => applyFilters(filters))
-
-// Программное изменение
-Hash.set('page', 'products')
-Hash.set('filters', { category: 'electronics' })
-```
-
-### Сохранение формы
-
-```javascript
-// Восстановление состояния формы
-const formData = Hash.get('formData', {})
-restoreForm(formData)
-
-// Сохранение при изменении
-form.addEventListener('input', () => {
-  Hash.set('formData', getFormData(form))
-})
-```
-
-### Навигация
-
-```javascript
-class Router {
-  constructor() {
-    Hash.addWatch('route', (route) => this.navigate(route))
-    Hash.reload()
-  }
-
-  navigate(route) {
-    loadPage(route || 'home')
-  }
-
-  go(route) {
-    Hash.set('route', route)
-  }
-}
-```
-
-Класс Hash обеспечивает простую и надежную синхронизацию состояния JavaScript приложения с URL браузера, поддерживая закладки и кнопки назад/вперед.

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

@@ -1,211 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Classes/Icons'/>
-
-# Класс Icons
-
-Статический класс для управления иконками с поддержкой асинхронной загрузки, глобального кеширования и автоматической генерации путей. Обеспечивает централизованное хранение и оптимизированную загрузку SVG иконок.
-
-## Основные возможности
-
-- **Глобальное кеширование** — автоматическое сохранение в window для переиспользования
-- **Асинхронная загрузка** — поддержка Promise и ленивой загрузки иконок
-- **Режим ожидания** — автоматическое ожидание загрузки с таймаутом
-- **Автоматические пути** — генерация SVG путей по названию с префиксом @
-- **Пакетное добавление** — массовое добавление иконок из объекта
-- **Глобальные URL** — поддержка CDN и различных окружений
-- **Проверка существования** — быстрая проверка наличия иконок
-- **Список иконок** — получение всех зарегистрированных названий
-
-## Методы проверки и получения
-
-### `is`
-
-Проверяет наличие иконки в коллекции.
-
-**Параметры:**
-- `index: string` — название иконки
-
-**Возвращает:** `boolean` — true если иконка существует
-
-```javascript
-if (Icons.is('user')) {
-  // иконка доступна
-}
-```
-
-### `get`
-
-Возвращает содержимое иконки с поддержкой асинхронной загрузки.
-
-**Параметры:**
-- `index: string` — название иконки
-- `url?: string` — альтернативный путь хранения
-- `wait?: number` — время ожидания в мс (по умолчанию 180000)
-
-**Возвращает:** `Promise<string>` — содержимое иконки
-
-```javascript
-// Простое получение
-const icon = await Icons.get('user')
-
-// С альтернативным URL
-const customIcon = await Icons.get('custom', '/assets/')
-
-// Автоматический путь
-const arrowIcon = await Icons.get('@arrow-left') // → /icons/arrow-left.svg
-```
-
-### `getNameList`
-
-Возвращает список всех зарегистрированных иконок.
-
-**Возвращает:** `string[]` — массив названий иконок
-
-```javascript
-const iconNames = Icons.getNameList()
-console.log(iconNames) // ['user', 'home', 'settings']
-```
-
-### `getUrlGlobal`
-
-Возвращает глобальный URL для иконок.
-
-**Возвращает:** `string` — базовый URL
-
-```javascript
-const globalUrl = Icons.getUrlGlobal()
-console.log(globalUrl) // '/icons/' или полный CDN URL
-```
-
-## Методы добавления
-
-### `add`
-
-Добавляет иконку в коллекцию.
-
-**Параметры:**
-- `index: string` — название иконки
-- `file: IconsItem` — путь к файлу или Promise с содержимым
-
-```javascript
-// Простое добавление
-Icons.add('user', '/icons/user.svg')
-
-// SVG содержимое
-Icons.add('custom', '<svg>...</svg>')
-
-// Асинхронная загрузка
-Icons.add('async', fetch('/api/icon.svg').then(r => r.text()))
-```
-
-### `addLoad`
-
-Добавляет иконку в режиме загрузки.
-
-**Параметры:**
-- `index: string` — название иконки
-
-```javascript
-Icons.addLoad('processing')
-// Иконка будет ожидать загрузки при вызове get()
-```
-
-### `addGlobal`
-
-Добавляет глобальную иконку.
-
-**Параметры:**
-- `index: string` — название иконки
-- `file: string` — относительный путь к файлу
-
-```javascript
-Icons.addGlobal('logo', 'brand/logo.svg')
-// Использует getUrlGlobal() + file
-```
-
-### `addByList`
-
-Добавляет иконки из объекта.
-
-**Параметры:**
-- `list: Record<string, IconsItem>` — объект с иконками
-
-```javascript
-const uiIcons = {
-  'arrow-up': '/icons/arrow-up.svg',
-  'arrow-down': '/icons/arrow-down.svg'
-}
-Icons.addByList(uiIcons)
-```
-
-## Методы конфигурации
-
-### `setUrl`
-
-Изменяет базовый путь к файлам иконок.
-
-**Параметры:**
-- `url: string` — новый базовый путь
-
-```javascript
-// Для разработки
-Icons.setUrl('/dev-icons/')
-
-// Для продакшена
-Icons.setUrl('https://cdn.example.com/icons/')
-```
-
-## Практические примеры
-
-### Инициализация иконок
-
-```javascript
-// Настройка базового URL
-Icons.setUrl('/assets/icons/')
-
-// Добавление основных иконок
-Icons.addByList({
-  'user': 'user.svg',
-  'home': 'home.svg',
-  'settings': 'settings.svg'
-})
-
-// Добавление темных иконок
-Icons.addByList({
-  'user-dark': 'dark/user.svg',
-  'home-dark': 'dark/home.svg'
-})
-```
-
-### Динамическая загрузка
-
-```javascript
-async function loadIcon(name) {
-  if (!Icons.is(name)) {
-    Icons.addLoad(name)
-  }
-  return await Icons.get(name)
-}
-
-// Использование
-const userIcon = await loadIcon('user')
-document.getElementById('icon').innerHTML = userIcon
-```
-
-### Компонент иконки
-
-```javascript
-class IconComponent {
-  async render(iconName) {
-    try {
-      const iconContent = await Icons.get(iconName)
-      return `<span class="icon">${iconContent}</span>`
-    } catch (error) {
-      return `<span class="icon-error">❌</span>`
-    }
-  }
-}
-```
-
-Класс Icons обеспечивает эффективное управление иконками с автоматическим кешированием, асинхронной загрузкой и гибкой конфигурацией путей для различных окружений.