@dxtmisha/wiki 0.39.1 → 0.39.3

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

@@ -1,305 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Classes/BroadcastMessage'/>
-
-# Класс BroadcastMessage
-
-Класс для работы с сообщениями BroadcastChannel между вкладками/окнами браузера. Обеспечивает коммуникацию в реальном времени между различными контекстами одного источника с автоматическим именованием каналов и обработкой сообщений.
-
-## Основные возможности
-
-- **Межвкладочная коммуникация** — отправка и получение сообщений между вкладками и окнами браузера
-- **Автоматическое именование каналов** — уникальные имена каналов для каждого экземпляра браузера, сохраняемые в localStorage
-- **Типобезопасная передача сообщений** — полная поддержка TypeScript с генерик-типами сообщений
-- **Обработка через callback** — гибкая обработка сообщений через callback-функции
-- **Обработка ошибок** — корректная обработка ошибок с логированием в консоль
-- **Безопасность SSR** — автоматическое определение окружения DOM runtime
-
-## Основное использование
-
-### Конструктор
-
-Создаёт новый экземпляр BroadcastMessage с указанным именем канала и опциональным callback.
-
-**Параметры:**
-- `name: string` — идентификатор имени канала
-- `callback?: (event: MessageEvent<Message>) => void` — опциональный callback для получаемых сообщений
-
-```javascript
-import { BroadcastMessage } from '@dxtmisha/functional'
-
-// Создание канала с callback
-const channel = new BroadcastMessage('user-updates', (event) => {
-  console.log('Получено сообщение:', event.data)
-})
-
-// Создание канала без callback (можно установить позже)
-const notifications = new BroadcastMessage('notifications')
-```
-
-### `post`
-
-Отправляет сообщение всем подключённым вкладкам/окнам на том же канале.
-
-**Параметры:**
-- `message: Message` — сообщение для отправки
-
-**Возвращает:** `this` — для цепочки вызовов
-
-```javascript
-import { BroadcastMessage } from '@dxtmisha/functional'
-
-const userChannel = new BroadcastMessage('user-updates')
-
-// Отправка простого сообщения
-userChannel.post({ type: 'login', userId: 123 })
-
-// Цепочка вызовов
-userChannel
-  .post({ type: 'status', value: 'online' })
-  .post({ type: 'activity', timestamp: Date.now() })
-```
-
-### `setCallback`
-
-Устанавливает или обновляет callback-функцию для обработки получаемых сообщений.
-
-**Параметры:**
-- `callback: (event: MessageEvent<Message>) => void` — callback-функция
-
-**Возвращает:** `this` — для цепочки вызовов
-
-```javascript
-import { BroadcastMessage } from '@dxtmisha/functional'
-
-const channel = new BroadcastMessage('app-events')
-
-// Установка callback позже
-channel.setCallback((event) => {
-  console.log('Получено событие:', event.data)
-})
-
-// Обновление callback
-channel.setCallback((event) => {
-  if (event.data.type === 'refresh') {
-    location.reload()
-  }
-})
-```
-
-## Расширенные примеры
-
-### Синхронизация состояния между вкладками
-
-```javascript
-import { BroadcastMessage } from '@dxtmisha/functional'
-import { ref } from 'vue'
-
-// Создание реактивного состояния
-const userStatus = ref('offline')
-
-// Создание канала broadcast
-const statusChannel = new BroadcastMessage('user-status', (event) => {
-  // Обновление локального состояния при изменениях из других вкладок
-  userStatus.value = event.data.status
-  console.log('Статус обновлён из другой вкладки:', event.data.status)
-})
-
-// Функция для обновления статуса и оповещения других вкладок
-function updateStatus(newStatus) {
-  userStatus.value = newStatus
-  statusChannel.post({ status: newStatus, timestamp: Date.now() })
-}
-
-// Использование
-updateStatus('online')  // Обновляет эту вкладку и уведомляет другие
-```
-
-### Корзина покупок в нескольких вкладках
-
-```javascript
-import { BroadcastMessage } from '@dxtmisha/functional'
-
-// Определение типов сообщений
-interface CartMessage {
-  action: 'add' | 'remove' | 'clear'
-  productId?: number
-  quantity?: number
-}
-
-// Создание канала с типизированными сообщениями
-const cartChannel = new BroadcastMessage<CartMessage>('shopping-cart')
-
-// Настройка обработчика сообщений
-cartChannel.setCallback((event) => {
-  const { action, productId, quantity } = event.data
-
-  switch (action) {
-    case 'add':
-      console.log(`Добавление ${quantity} товара ${productId}`)
-      addToCart(productId, quantity)
-      break
-    case 'remove':
-      console.log(`Удаление товара ${productId}`)
-      removeFromCart(productId)
-      break
-    case 'clear':
-      console.log('Очистка корзины')
-      clearCart()
-      break
-  }
-})
-
-// Трансляция обновлений корзины
-function addProduct(productId, quantity) {
-  addToCart(productId, quantity)
-  cartChannel.post({ action: 'add', productId, quantity })
-}
-```
-
-### Синхронизация состояния аутентификации
-
-```javascript
-import { BroadcastMessage } from '@dxtmisha/functional'
-
-interface AuthMessage {
-  type: 'login' | 'logout' | 'token-refresh'
-  userId?: number
-  token?: string
-}
-
-const authChannel = new BroadcastMessage<AuthMessage>('auth-events', (event) => {
-  switch (event.data.type) {
-    case 'login':
-      console.log('Пользователь вошёл:', event.data.userId)
-      location.reload()
-      break
-
-    case 'logout':
-      console.log('Пользователь вышел, перенаправление...')
-      localStorage.removeItem('auth-token')
-      window.location.href = '/login'
-      break
-
-    case 'token-refresh':
-      console.log('Токен обновлён')
-      localStorage.setItem('auth-token', event.data.token)
-      break
-  }
-})
-
-// Трансляция входа
-function handleLogin(userId, token) {
-  localStorage.setItem('auth-token', token)
-  authChannel.post({ type: 'login', userId, token })
-}
-
-// Трансляция выхода
-function handleLogout() {
-  localStorage.removeItem('auth-token')
-  authChannel.post({ type: 'logout' })
-}
-```
-
-### Уведомления в реальном времени
-
-```javascript
-import { BroadcastMessage } from '@dxtmisha/functional'
-
-interface Notification {
-  id: string
-  title: string
-  message: string
-  type: 'info' | 'warning' | 'error' | 'success'
-  timestamp: number
-}
-
-const notificationChannel = new BroadcastMessage<Notification>('notifications')
-
-// Настройка обработчика уведомлений
-notificationChannel.setCallback((event) => {
-  const notification = event.data
-
-  showNotification(notification.title, notification.message, notification.type)
-
-  if (notification.type === 'error') {
-    playErrorSound()
-  }
-})
-
-// Отправка уведомления всем вкладкам
-function broadcastNotification(title, message, type = 'info') {
-  const notification = {
-    id: crypto.randomUUID(),
-    title,
-    message,
-    type,
-    timestamp: Date.now()
-  }
-
-  notificationChannel.post(notification)
-}
-
-// Использование
-broadcastNotification('Новое сообщение', 'У вас новое сообщение от Ивана', 'info')
-```
-
-## Детали реализации
-
-### Уникальное именование каналов
-
-Каждый экземпляр браузера генерирует уникальный идентификатор, сохраняемый в localStorage (`__broadcast-name`). Это гарантирует изоляцию каналов между различными экземплярами браузера, при этом позволяя коммуникацию внутри одного экземпляра между вкладками.
-
-```javascript
-// Формат имени канала: name_{случайные_7_цифр}__ваше-имя-канала
-// Пример: name_1234567__user-updates
-```
-
-### Обработка ошибок
-
-BroadcastMessage корректно обрабатывает ошибки и логирует их в консоль:
-
-```javascript
-const channel = new BroadcastMessage('my-channel')
-// Если BroadcastChannel не поддерживается или инициализация не удалась,
-// ошибка логируется: "BroadcastMessage my-channel: [детали ошибки]"
-```
-
-### Совместимость с SSR
-
-Класс автоматически определяет окружение DOM runtime с помощью `isDomRuntime()`, что делает его безопасным для использования в контекстах SSR/SSG, где BroadcastChannel API недоступен.
-
-## Типобезопасность
-
-```typescript
-import { BroadcastMessage } from '@dxtmisha/functional'
-
-// Определение структуры сообщения
-interface UserUpdate {
-  userId: number
-  action: 'online' | 'offline' | 'typing'
-  timestamp: number
-}
-
-// Создание типизированного канала
-const channel = new BroadcastMessage<UserUpdate>('users')
-
-// TypeScript обеспечивает типобезопасность
-channel.post({
-  userId: 123,
-  action: 'online',
-  timestamp: Date.now()
-}) // ✓ Валидно
-
-channel.post({ invalid: 'data' }) // ✗ Ошибка TypeScript
-```
-
-## Совместимость с браузерами
-
-BroadcastChannel API поддерживается в:
-- Chrome/Edge 54+
-- Firefox 38+
-- Safari 15.4+
-- Opera 41+
-
-Для старых браузеров рассмотрите использование полифилла или механизма запасного варианта.

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

@@ -1,154 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Classes/Cache'/>
-
-# Класс Cache
-
-Высокоуровневый класс для управления множественными кешированными значениями с использованием экземпляров CacheItem внутри. Предоставляет простой интерфейс для кеширования с автоматическим созданием и управлением CacheItem, интеллектуальной инвалидацией на основе сравнения и синхронными/асинхронными операциями.
-
-## Основные возможности
-
-- **Управление множественными кешами** — управляет коллекцией именованных записей кеша с использованием экземпляров CacheItem
-- **Автоматическое создание CacheItem** — создаёт и управляет экземплярами CacheItem внутренне для каждого имени кеша
-- **Инвалидация на основе сравнения** — автоматическая инвалидация кеша при изменении параметров сравнения
-- **Синхронный и асинхронный режимы** — как синхронное, так и асинхронное получение данных
-- **Типобезопасность** — полная поддержка TypeScript с дженериками для каждой записи кеша
-- **Эффективное использование памяти** — переиспользует экземпляры CacheItem для одинаковых имён кеша
-- **Простой интерфейс** — абстрагирует сложность CacheItem за удобными методами
-
-## Основное использование
-
-### `get`
-
-Синхронно получает кешированные данные или выполняет callback для генерации и кеширования новых данных.
-
-**Параметры:**
-- `name: string` — уникальное имя/ключ кеша для этой записи кеша
-- `callback: () => T` — функция для выполнения при промахе кеша или инвалидации
-- `comparison?: any[]` — массив значений для сравнения при инвалидации кеша (опционально)
-
-**Возвращает:** `T` — кешированные данные или результат выполнения callback
-
-```javascript
-import { Cache } from '@dxtmisha/functional'
-
-const cache = new Cache()
-
-// Простое кеширование без сравнения
-const userData = cache.get('user-profile', () => {
-  console.log('Вычисление профиля пользователя...')
-  return { id: 1, name: 'Иван Иванов', email: 'ivan@example.com', computed: Date.now() }
-})
-
-// Последующие вызовы возвращают кешированные данные без выполнения callback
-const cachedData = cache.get('user-profile', () => {
-  console.log('Это не выполнится')
-  return { id: 1, name: 'Иван Иванов', email: 'ivan@example.com', computed: Date.now() }
-})
-// Возвращает точно тот же кешированный объект
-
-// Другое имя кеша создаёт отдельный CacheItem
-const settingsData = cache.get('user-settings', () => {
-  console.log('Загрузка настроек пользователя...')
-  return { theme: 'dark', language: 'ru' }
-})
-```
-
-### `getAsync`
-
-Асинхронно получает кешированные данные или выполняет асинхронный callback для генерации новых данных.
-
-**Параметры:**
-- `name: string` — уникальное имя/ключ кеша для этой записи кеша
-- `callback: () => T | Promise<T>` — функция для выполнения при промахе кеша или инвалидации
-- `comparison?: any[]` — массив значений для сравнения при инвалидации кеша (опционально)
-
-**Возвращает:** `Promise<T>` — промис, разрешающийся в кешированные данные или результат callback
-
-```javascript
-// Асинхронное кеширование с API вызовами
-const userData = await cache.getAsync('api-user-1', async () => {
-  console.log('Запрос к API...')
-  const response = await fetch('/api/user/1')
-  return await response.json()
-})
-
-// Кешируется при последующих вызовах (переиспользуется тот же экземпляр CacheItem)
-const cachedUser = await cache.getAsync('api-user-1', async () => {
-  console.log('Это не выполнится')
-  return await fetch('/api/user/1').then(r => r.json())
-})
-// Возвращает кешированные данные без API вызова
-
-// Другое имя кеша создаёт новый CacheItem
-const userPosts = await cache.getAsync('api-user-posts-1', async () => {
-  console.log('Получение постов пользователя...')
-  const response = await fetch('/api/user/1/posts')
-  return await response.json()
-})
-```
-
-## Инвалидация кеша с помощью сравнения
-
-Каждая именованная запись кеша поддерживает свой собственный CacheItem с независимой инвалидацией:
-
-```javascript
-const cache = new Cache()
-
-// Кеш данных пользователя с отслеживанием зависимостей
-let userId = 1
-let includeProfile = true
-
-const getUserData = (id, withProfile) => cache.get(
-  'user-data', // Одно имя кеша переиспользует тот же CacheItem
-  () => {
-    console.log(`Загрузка пользователя ${id}, профиль: ${withProfile}`)
-    return {
-      id,
-      name: `Пользователь ${id}`,
-      profile: withProfile ? { bio: 'Биография пользователя', avatar: 'avatar.jpg' } : null
-    }
-  },
-  [id, withProfile] // CacheItem инвалидируется при изменении любого значения
-)
-
-console.log(getUserData(1, true)) // Создаёт CacheItem, выполняет callback
-console.log(getUserData(1, true)) // Переиспользует тот же CacheItem, возвращает кешированные данные
-
-// Изменение зависимости - тот же CacheItem инвалидируется и перегенерируется
-userId = 2
-console.log(getUserData(2, true)) // Тот же CacheItem, инвалидирован, выполняет callback
-
-// Другое имя кеша создаёт отдельный CacheItem
-const getUserSettings = (id) => cache.get(
-  'user-settings', // Другое имя = другой CacheItem
-  () => {
-    console.log(`Загрузка настроек для пользователя ${id}`)
-    return { theme: 'dark', notifications: true }
-  },
-  [id]
-)
-
-console.log(getUserSettings(1)) // Создаёт новый экземпляр CacheItem
-```
-
-## Внутреннее управление CacheItem
-
-Класс Cache автоматически управляет жизненным циклом CacheItem:
-
-```javascript
-const cache = new Cache()
-
-// Каждое уникальное имя кеша получает свой экземпляр CacheItem
-cache.get('cache-1', () => 'data-1') // Создаёт CacheItem внутренне
-cache.get('cache-2', () => 'data-2') // Создаёт другой CacheItem
-cache.get('cache-1', () => 'data-1-updated') // Переиспользует существующий CacheItem
-
-// Экземпляры Cache полностью изолированы
-const cache2 = new Cache()
-cache2.get('cache-1', () => 'different-data') // Независимый CacheItem в cache2
-
-// Проверка изоляции
-console.log(cache.get('cache-1', () => 'fallback')) // 'data-1'
-console.log(cache2.get('cache-1', () => 'fallback')) // 'different-data'
-```

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

@@ -1,186 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Classes/CacheItem'/>
-
-# Класс CacheItem
-
-Низкоуровневый класс для управления одним кешированным значением с автоматической инвалидацией на основе данных сравнения. Этот класс используется внутри класса Cache, но также может использоваться напрямую для точного контроля кеша.
-
-## Основные возможности
-
-- **Кеширование одного значения** — управляет одним кешированным значением с интеллектуальной инвалидацией
-- **Инвалидация на основе сравнения** — автоматически инвалидирует кеш при изменении данных сравнения
-- **Отслеживание предыдущего значения** — сохраняет ссылку на старое кешированное значение во время обновлений
-- **Поддержка синхронного и асинхронного режимов** — выполнение как синхронных, так и асинхронных callback
-- **Типобезопасность** — полная поддержка TypeScript с дженериками
-- **Эффективное использование памяти** — минимальные накладные расходы для хранения одного значения
-
-## Конструктор
-
-### `constructor`
-
-Создаёт новый экземпляр CacheItem с предоставленной callback функцией.
-
-**Параметры:**
-- `callback: () => T` — функция для выполнения когда кеш нужно сгенерировать или обновить
-
-```javascript
-import { CacheItem } from '@dxtmisha/functional'
-
-// Простой элемент кеша для дорогих вычислений
-const expensiveComputation = new CacheItem(() => {
-  console.log('Выполнение дорогих вычислений...')
-  return Math.random() * 1000
-})
-
-// Элемент кеша для API данных
-const apiData = new CacheItem(() => {
-  console.log('Получение из API...')
-  return fetch('/api/data').then(r => r.json())
-})
-```
-
-## Методы получения данных
-
-### `getCache`
-
-Получает кешированные данные или выполняет callback для генерации новых данных если кеш недействителен.
-
-**Параметры:**
-- `comparison: any[]` — массив значений, используемых для сравнения при инвалидации кеша
-
-**Возвращает:** `T` — кешированные данные или результат выполнения callback
-
-```javascript
-const userCache = new CacheItem(() => {
-  console.log('Загрузка данных пользователя...')
-  return { id: 1, name: 'Иван Иванов', role: 'admin' }
-})
-
-let userId = 1
-let userRole = 'admin'
-
-// Первый вызов - выполняет callback
-const user1 = userCache.getCache([userId, userRole])
-console.log(user1) // Лог: "Загрузка данных пользователя..." затем возвращает объект пользователя
-
-// Второй вызов с тем же сравнением - возвращает кешированные данные
-const user1Cached = userCache.getCache([userId, userRole])
-console.log(user1Cached) // Возвращает кешированные данные без логирования
-
-// Изменение данных сравнения - кеш инвалидирован
-userId = 2
-const user2 = userCache.getCache([userId, userRole])
-console.log(user2) // Лог: "Загрузка данных пользователя..." затем возвращает новый объект пользователя
-```
-
-### `getCacheAsync`
-
-Асинхронно получает кешированные данные или выполняет асинхронный callback для генерации новых данных.
-
-**Параметры:**
-- `comparison: any[]` — массив значений, используемых для сравнения при инвалидации кеша
-
-**Возвращает:** `Promise<T>` — промис, разрешающийся в кешированные данные или результат callback
-
-```javascript
-const apiCache = new CacheItem(async () => {
-  console.log('Получение пользователя из API...')
-  const response = await fetch('/api/user/1')
-  return await response.json()
-})
-
-// Первый вызов - выполняет асинхронный callback
-const user = await apiCache.getCacheAsync([])
-console.log(user) // Лог: "Получение пользователя из API..." затем возвращает данные пользователя
-
-// Второй вызов - возвращает кешированные данные
-const userCached = await apiCache.getCacheAsync([])
-console.log(userCached) // Возвращает кешированные данные без API вызова
-```
-
-### `getCacheOld`
-
-Возвращает предыдущее кешированное значение (до последнего обновления).
-
-**Возвращает:** `T | undefined` — предыдущее кешированное значение или undefined если нет предыдущего значения
-
-```javascript
-const dataCache = new CacheItem(() => ({ timestamp: Date.now() }))
-
-// Получить начальные данные
-const data1 = dataCache.getCache(['v1'])
-console.log(dataCache.getCacheOld()) // undefined (нет предыдущего значения)
-
-// Обновить кеш с новым сравнением
-const data2 = dataCache.getCache(['v2'])
-console.log(dataCache.getCacheOld()) // Возвращает data1 (предыдущее значение)
-
-// Обновить снова
-const data3 = dataCache.getCache(['v3'])
-console.log(dataCache.getCacheOld()) // Возвращает data2 (предыдущее значение)
-```
-
-## Практические примеры
-
-### Кеширование вычислений
-
-```javascript
-const expensiveCache = new CacheItem(() => {
-  console.log('Выполнение дорогих вычислений...')
-  return Array.from({length: 1000000}, (_, i) => i * i).reduce((a, b) => a + b)
-})
-
-let factor = 1
-let data = [1, 2, 3]
-
-// Первый вызов
-const result1 = expensiveCache.getCache([factor, data])
-console.log('Результат:', result1)
-
-// Кешированный вызов
-const result2 = expensiveCache.getCache([factor, data])
-console.log('Кешированный:', result2) // Без пересчета
-```
-
-### Валидация с историей
-
-```javascript
-const validationCache = new CacheItem(() => {
-  const errors = []
-  if (!this.value) errors.push('Поле обязательно')
-  if (this.value.length < 3) errors.push('Минимум 3 символа')
-  return { isValid: errors.length === 0, errors }
-})
-
-function validateField(value) {
-  this.value = value
-  const current = validationCache.getCache([value])
-  const previous = validationCache.getCacheOld()
-
-  return { current, previous, hasChanged: previous && current !== previous }
-}
-
-// Использование
-console.log(validateField('ab')) // Показывает ошибки
-console.log(validateField('abc')) // Валидный результат
-```
-
-### Асинхронные данные
-
-```javascript
-const apiCache = new CacheItem(async () => {
-  const response = await fetch('/api/data')
-  return response.json()
-})
-
-async function getData(userId) {
-  return await apiCache.getCacheAsync([userId])
-}
-
-// Использование
-const data = await getData(1) // API вызов
-const cached = await getData(1) // Кешированные данные
-```
-
-Класс CacheItem предоставляет низкоуровневый контроль над кешированием одного значения с мощными возможностями инвалидации и отслеживания истории изменений.