@dxtmisha/wiki 0.25.1 → 0.39.2

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

@@ -1,420 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Conversions'/>
-
-# Функции преобразования
-
-Набор функций для преобразования значений между различными типами данных.
-
-## `anyToString`
-
-Преобразует любое значение в строку с интеллектуальной обработкой различных типов данных.
-
-**Параметры:**
-- `value: V` — значение для преобразования в строку
-
-```javascript
-import { anyToString } from '@dxtmisha/functional'
-
-anyToString('  hello  ') // 'hello'
-anyToString(true) // '1'
-anyToString([1, 2, 3]) // '1,2,3'
-anyToString({ name: 'John' }) // '{"name":"John"}'
-```
-
-## `applyTemplate`
-
-Применяет шаблон к тексту, заменяя ключи на значения из объекта замены. Поддерживает три формата: квадратные скобки `[key]`, позиционные параметры `%d`, `%e`, `%f` и теги с содержимым `[tag]content[/tag]`.
-
-**Параметры:**
-- `text: string` — текст с шаблоном, содержащим ключи в квадратных скобках `[key]`, позиционные параметры `%d`, `%e` и т.д., или теги с содержимым `[tag]content[/tag]`
-- `replacement: Record<string, string | number> | string[]` — объект или массив для замены ключей
-
-```javascript
-import { applyTemplate } from '@dxtmisha/functional'
-
-// Замена по ключам в квадратных скобках
-applyTemplate('Привет, [name]!', { name: 'Анна' }) // 'Привет, Анна!'
-applyTemplate('[item] - [price]', { item: 'Телефон', price: 15000 })
-
-// Позиционные параметры
-applyTemplate('Заказ %d на %e руб', ['#123', '1500']) // 'Заказ #123 на 1500 руб'
-
-// Теги с содержимым ([content] заменяется на содержимое тега)
-applyTemplate('Это [bold]жирный текст[/bold]', { bold: '<b>[content]</b>' }) // 'Это <b>жирный текст</b>'
-applyTemplate('Text with [red]colored[/red] word', { red: '<span style="color:red">[content]</span>' })
-```
-
-## `blobToBase64`
-
-Преобразует Blob в строку Base64 (data URL).
-
-**Параметры:**
-- `blob: Blob` — Blob объект для преобразования
-
-```javascript
-import { blobToBase64 } from '@dxtmisha/functional'
-
-const blob = new Blob(['Hello World'], { type: 'text/plain' })
-const base64 = await blobToBase64(blob)
-// 'data:text/plain;base64,SGVsbG8gV29ybGQ='
-
-// Использование с изображением
-const imageBlob = new Blob([imageData], { type: 'image/png' })
-const imageBase64 = await blobToBase64(imageBlob)
-// 'data:image/png;base64,iVBORw0KGgo...'
-```
-
-
-## `encodeAttribute`
-
-Кодирует специальные символы в строке для безопасного использования в HTML-атрибутах. Преобразует символы `&`, `<`, `>`, `"`, `'` в соответствующие HTML-сущности для предотвращения XSS-атак и корректного отображения.
-
-**Параметры:**
-- `text: string` — текст для кодирования
-
-```javascript
-import { encodeAttribute } from '@dxtmisha/functional'
-
-encodeAttribute('Hello & "World"') // 'Hello &amp; &quot;World&quot;'
-encodeAttribute('<script>alert("XSS")</script>') // '&lt;script&gt;alert(&quot;XSS&quot;)&lt;/script&gt;'
-encodeAttribute("It's a test") // 'It&#39;s a test'
-```
-
-## `replaceRecursive`
-
-Рекурсивно заменяет значения в объекте или массиве.
-
-**Параметры:**
-- `data: any` — объект или массив для обработки
-- `search: any` — искомое значение
-- `replace: any` — значение для замены
-
-```javascript
-import { replaceRecursive } from '@dxtmisha/functional'
-
-replaceRecursive({a: 'old', b: {c: 'old'}}, 'old', 'new') // {a: 'new', b: {c: 'new'}}
-replaceRecursive(['old', {x: 'old'}], 'old', 'new') // ['new', {x: 'new'}]
-```
-
-## `replaceTemplate`
-
-Заменяет шаблонные значения в строке на основе объекта замены. Использует формат `[ключ]` для поиска и замены. Поддерживает как строковые значения, так и функции.
-
-**Параметры:**
-- `value: string` — строка шаблона с ключами в формате `[ключ]`
-- `replaces: Record<string, string | FunctionReturn<string>>` — объект с данными для замены (значения могут быть строками или функциями)
-
-```javascript
-import { replaceTemplate } from '@dxtmisha/functional'
-
-replaceTemplate('Hello [name]!', {name: 'World'}) // 'Hello World!'
-replaceTemplate('[x] + [y] = [sum]', {x: '2', y: '3', sum: '5'}) // '2 + 3 = 5'
-replaceTemplate('User [id]: [name]', {id: '123', name: 'John'}) // 'User 123: John'
-replaceTemplate('Time: [time]', {time: () => new Date().toLocaleString()}) // с функцией
-```
-
-## `resizeImageByMax`
-
-Изменяет размер изображения, чтобы оно соответствовало ограничению максимального размера.
-
-**Параметры:**
-- `image: HTMLImageElement | string` — элемент изображения или URL
-- `maxSize: number` — максимальный размер ширины или высоты
-- `type: 'auto' | 'width' | 'height'` — тип изменения размера (по умолчанию 'auto')
-- `typeData?: string` — тип данных результирующего изображения (например, 'image/png', 'image/jpeg')
-
-```javascript
-import { resizeImageByMax } from '@dxtmisha/functional'
-
-// Автоматическое масштабирование (по большей стороне)
-const image = document.querySelector('img')
-const resized = resizeImageByMax(image, 800) // data URL
-// Изображение 1200x800 станет 800x533
-
-// Масштабирование по ширине
-resizeImageByMax(image, 600, 'width')
-// Ширина будет 600px, высота пропорциональна
-
-// Масштабирование по высоте
-resizeImageByMax(image, 400, 'height')
-// Высота будет 400px, ширина пропорциональна
-
-// С указанием типа данных
-resizeImageByMax(image, 1024, 'auto', 'image/jpeg')
-// Возвращает JPEG data URL
-```
-
-## `secondToTime`
-
-Преобразует секунды в формат времени (часы:минуты:секунды).
-
-**Параметры:**
-- `seconds: number` — количество секунд
-
-```javascript
-import { secondToTime } from '@dxtmisha/functional'
-
-secondToTime(3661) // '01:01:01'
-secondToTime(125) // '00:02:05'
-secondToTime(45) // '00:00:45'
-```
-
-## `strFill`
-
-Заполняет строку указанным символом до нужной длины.
-
-**Параметры:**
-- `value: string | number` — исходное значение
-- `length: number` — целевая длина
-- `fill: string` — символ заполнения (по умолчанию '0')
-- `start: boolean` — заполнять в начале (по умолчанию true)
-
-```javascript
-import { strFill } from '@dxtmisha/functional'
-
-strFill('5', 3) // '005'
-strFill('hello', 8, '*', false) // 'hello***'
-strFill(42, 4) // '0042'
-```
-
-## `toArray`
-
-Преобразует значение в массив.
-
-**Параметры:**
-- `value: any` — значение для преобразования
-
-```javascript
-import { toArray } from '@dxtmisha/functional'
-
-toArray('hello') // ['hello']
-toArray([1, 2]) // [1, 2]
-toArray(null) // [null]
-```
-
-## `toBind`
-
-Объединяет два объекта со свойствами, с умной обработкой классов и стилей. При слиянии объектов классы и стили объединяются в массивы, а не перезаписываются.
-
-**Параметры:**
-- `extra: ItemList` — дополнительные свойства (базовый объект)
-- `value: ItemList` — входные свойства для объединения
-
-**Возвращает:**
-Объединённый объект свойств с правильно обработанными классами и стилями.
-
-**Особенности:**
-- Обычные свойства перезаписываются (приоритет у `value`)
-- Классы (`class`) объединяются в массив `[extraClass, valueClass]`
-- Стили (`style`) объединяются в массив `[extraStyle, valueStyle]`
-- Позволяет создавать составные объекты свойств для компонентов
-
-```javascript
-import { toBind } from '@dxtmisha/functional'
-
-// Обычное объединение свойств
-toBind({id: 'base', disabled: false}, {id: 'new', type: 'button'})
-// Результат: {id: 'new', disabled: false, type: 'button'}
-
-// Умное объединение классов
-toBind({class: 'btn'}, {class: 'primary'})
-// Результат: {class: ['btn', 'primary']}
-
-// Умное объединение стилей
-toBind(
-  {style: {color: 'red', fontSize: '14px'}},
-  {style: {color: 'blue', margin: '10px'}}
-)
-// Результат: {style: [{color: 'red', fontSize: '14px'}, {color: 'blue', margin: '10px'}]}
-
-// Комплексное объединение
-toBind(
-  {class: 'btn', style: {padding: '10px'}, disabled: false},
-  {class: 'primary', style: {color: 'white'}, type: 'button'}
-)
-// Результат: {
-//   class: ['btn', 'primary'],
-//   style: [{padding: '10px'}, {color: 'white'}],
-//   disabled: false,
-//   type: 'button'
-// }
-```
-
-## `toBinds`
-
-Объединяет несколько объектов со свойствами, последовательно применяя `toBind` к каждому. Умно обрабатывает классы и стили, создавая составные объекты свойств.
-
-**Параметры:**
-- `...values: (ItemList | undefined)[]` — список объектов свойств для объединения
-
-**Возвращает:**
-Итоговый объединённый объект со всеми свойствами, классами и стилями.
-
-```javascript
-import { toBinds } from '@dxtmisha/functional'
-
-// Объединение нескольких объектов
-toBinds(
-  {class: 'btn', disabled: false},
-  {class: 'primary', type: 'button'},
-  {class: 'large', id: 'submit-btn'}
-)
-// Результат: {
-//   class: ['btn', 'primary', 'large'],
-//   disabled: false,
-//   type: 'button',
-//   id: 'submit-btn'
-// }
-
-// С undefined значениями (игнорируются)
-toBinds(
-  {class: 'base'},
-  undefined,
-  {style: {color: 'red'}},
-  null,
-  {class: 'modifier'}
-)
-// Результат: {class: ['base', 'modifier'], style: {color: 'red'}}
-
-// Объединение стилей
-toBinds(
-  {style: {padding: '10px'}},
-  {style: {margin: '5px'}},
-  {style: {color: 'blue'}}
-)
-// Результат: {style: [{padding: '10px'}, {margin: '5px'}, {color: 'blue'}]}
-```
-
-## `toCamelCase`
-
-Преобразует строку в camelCase.
-
-**Параметры:**
-- `value: string` — строка для преобразования
-
-```javascript
-import { toCamelCase } from '@dxtmisha/functional'
-
-toCamelCase('hello-world') // 'helloWorld'
-toCamelCase('hello_world') // 'helloWorld'
-toCamelCase('hello world') // 'helloWorld'
-```
-
-## `toCamelCaseFirst`
-
-Преобразует строку в PascalCase (первая буква заглавная).
-
-**Параметры:**
-- `value: string` — строка для преобразования
-
-```javascript
-import { toCamelCaseFirst } from '@dxtmisha/functional'
-
-toCamelCaseFirst('hello-world') // 'HelloWorld'
-toCamelCaseFirst('component_name') // 'ComponentName'
-```
-
-## `toDate`
-
-Преобразует значение в объект Date.
-
-**Параметры:**
-- `value: any` — значение для преобразования
-
-```javascript
-import { toDate } from '@dxtmisha/functional'
-
-toDate('2023-01-01') // Date object
-toDate(1672531200000) // Date object
-toDate(new Date()) // Date object
-```
-
-## `toKebabCase`
-
-Преобразует строку в kebab-case.
-
-**Параметры:**
-- `value: string` — строка для преобразования
-
-```javascript
-import { toKebabCase } from '@dxtmisha/functional'
-
-toKebabCase('HelloWorld') // 'hello-world'
-toKebabCase('helloWorld') // 'hello-world'
-toKebabCase('hello_world') // 'hello-world'
-```
-
-## `toNumber`
-
-Преобразует значение в число.
-
-**Параметры:**
-- `value: any` — значение для преобразования
-
-```javascript
-import { toNumber } from '@dxtmisha/functional'
-
-toNumber('42') // 42
-toNumber('3.14') // 3.14
-toNumber('abc') // 0
-```
-
-## `toNumberByMax`
-
-Преобразует значение в число с ограничением максимального значения.
-
-**Параметры:**
-- `value: any` — значение для преобразования
-- `max: number` — максимальное значение
-
-```javascript
-import { toNumberByMax } from '@dxtmisha/functional'
-
-toNumberByMax('100', 50) // 50
-toNumberByMax('25', 50) // 25
-```
-
-## `toPercent`
-
-Преобразует число в процентное значение.
-
-**Параметры:**
-- `value: number` — число от 0 до 1
-
-```javascript
-import { toPercent } from '@dxtmisha/functional'
-
-toPercent(0.5) // 50
-toPercent(0.25) // 25
-toPercent(1) // 100
-```
-
-## `toPercentBy100`
-
-Преобразует число в процентное значение (для чисел от 0 до 100).
-
-**Параметры:**
-- `value: number` — число от 0 до 100
-
-```javascript
-import { toPercentBy100 } from '@dxtmisha/functional'
-
-toPercentBy100(50) // '50%'
-toPercentBy100(25.5) // '25.5%'
-```
-
-## `transformation`
-
-Применяет функцию преобразования к значению.
-
-**Параметры:**
-- `value: any` — исходное значение
-- `callback: Function` — функция преобразования
-
-```javascript
-import { transformation } from '@dxtmisha/functional'
-
-transformation('hello', s => s.toUpperCase()) // 'HELLO'
-transformation(5, n => n * 2) // 10
-```

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

@@ -1,283 +0,0 @@
-import {Meta} from '@storybook/addon-docs/blocks'
-
-<Meta title='@dxtmisha/functional/ru/Classes/Cookie'/>
-
-# Класс Cookie
-
-Класс для работы с браузерными cookie с автоматической сериализацией, singleton паттерном и интеграцией с CookieBlock для соблюдения приватности. Предоставляет типобезопасные операции с cookie с настраиваемыми опциями как max-age, SameSite и пользовательские атрибуты.
-
-## Основные возможности
-
-- **Типобезопасное управление cookie** — полная поддержка TypeScript с дженериками для данных cookie
-- **Автоматическая сериализация** — обрабатывает JSON сериализацию/десериализацию сложных данных
-- **Singleton паттерн** — переиспользует экземпляры для одинаковых имён cookie
-- **Соблюдение приватности** — интегрируется с CookieBlock для учёта пользовательских настроек cookie
-- **Настраиваемые опции** — поддерживает max-age, SameSite и пользовательские атрибуты cookie
-- **Поддержка функций как значений** — принимает функции как значения для динамической генерации cookie
-- **Совместимость с браузерами** — безопасное использование с серверным рендерингом
-- **Автоматическая инициализация** — читает существующие cookie при загрузке класса
-
-## Конструктор
-
-### `constructor`
-
-Создаёт экземпляр Cookie для указанного имени cookie. Использует singleton паттерн.
-
-**Параметры:**
-- `name: string` — имя cookie
-
-```javascript
-import { Cookie } from '@dxtmisha/functional'
-
-// Создать экземпляры cookie
-const userTheme = new Cookie('user-theme')
-const sessionToken = new Cookie('session-token')
-
-// Поведение singleton
-const sameInstance = new Cookie('user-theme')
-console.log(userTheme === sameInstance) // true
-```
-
-## Операции с данными
-
-### `get`
-
-Получает значение cookie с опциональным значением по умолчанию и опциями cookie.
-
-**Параметры:**
-- `defaultValue?: T | string | (() => (T | string))` — значение по умолчанию или функция, если cookie не существует (опционально)
-- `options?: CookieOptions` — опции cookie для установки значения по умолчанию (опционально)
-
-**Возвращает:** `T | string | undefined` — значение cookie, значение по умолчанию или undefined
-
-```javascript
-const themeCookie = new Cookie('theme')
-
-// Получить существующий cookie
-const currentTheme = themeCookie.get()
-console.log(currentTheme) // undefined если не установлен, или сохранённое значение
-
-// Получить со значением по умолчанию
-const theme = themeCookie.get('light')
-console.log(theme) // 'light' если cookie не существует, устанавливает и возвращает значение по умолчанию
-
-// Получить с функцией по умолчанию
-const settings = new Cookie('settings')
-const config = settings.get(() => ({
-  theme: 'dark',
-  language: 'ru',
-  notifications: true
-}))
-
-// Получить с опциями для установки по умолчанию
-const preferences = new Cookie('preferences')
-const prefs = preferences.get(
-  { sidebar: true, tooltips: false },
-  { age: 30 * 24 * 60 * 60 } // 30 дней
-)
-```
-
-### `set`
-
-Обновляет данные cookie с опциональной конфигурацией.
-
-**Параметры:**
-- `value?: T | string | (() => (T | string))` — значение для сохранения или функция, возвращающая значение (опционально)
-- `options?: CookieOptions` — опции конфигурации cookie (опционально)
-
-**Возвращает:** `void`
-
-```javascript
-const userCookie = new Cookie('user-data')
-
-// Установить простое значение
-userCookie.set('ivan_petrov')
-
-// Установить объект (автоматически сериализуется)
-userCookie.set({
-  id: 1,
-  name: 'Иван Петров',
-  preferences: { theme: 'dark' }
-})
-
-// Установить с функцией
-userCookie.set(() => ({
-  sessionId: Math.random().toString(36),
-  timestamp: Date.now()
-}))
-
-// Установить с опциями
-userCookie.set('important-data', {
-  age: 365 * 24 * 60 * 60, // 1 год в секундах
-  sameSite: 'strict',
-  arguments: ['Secure', 'HttpOnly']
-})
-```
-
-### `remove`
-
-Удаляет cookie, устанавливая пустое значение.
-
-```javascript
-userCookie.remove()
-// Эквивалентно: userCookie.set('')
-```
-
-## Опции Cookie
-
-### Интерфейс `CookieOptions`
-
-```typescript
-interface CookieOptions {
-  /** Cookie max-age в секундах (по умолчанию: 7 дней) */
-  age?: number
-
-  /** Атрибут SameSite: 'strict' | 'lax' (по умолчанию: 'strict') */
-  sameSite?: 'strict' | 'lax'
-
-  /** Дополнительные атрибуты cookie */
-  arguments?: string[]
-}
-```
-
-### Примеры опций
-
-```javascript
-const secureCookie = new Cookie('secure-data')
-
-// Базовые опции
-secureCookie.set('sensitive-data', {
-  age: 60 * 60, // 1 час
-  sameSite: 'strict'
-})
-
-// Продвинутые опции с пользовательскими атрибутами
-secureCookie.set('auth-token', {
-  age: 24 * 60 * 60, // 24 часа
-  sameSite: 'lax',
-  arguments: ['Secure', 'HttpOnly', 'Path=/api']
-})
-
-// Долгосрочное хранение
-const rememberMeCookie = new Cookie('remember-me')
-rememberMeCookie.set(true, {
-  age: 365 * 24 * 60 * 60 // 1 год
-})
-```
-
-## Практические примеры
-
-### Аутентификация пользователя
-
-```javascript
-class AuthManager {
-  constructor() {
-    this.tokenCookie = new Cookie('auth-token')
-    this.userCookie = new Cookie('user-data')
-  }
-
-  login(credentials) {
-    const authResponse = {
-      token: 'jwt-token-here',
-      user: { id: 1, name: 'Иван Петров', role: 'admin' },
-      expiresIn: 24 * 60 * 60 // 24 часа
-    }
-
-    this.tokenCookie.set(authResponse.token, {
-      age: authResponse.expiresIn,
-      sameSite: 'strict'
-    })
-
-    this.userCookie.set(authResponse.user, {
-      age: authResponse.expiresIn
-    })
-
-    return authResponse
-  }
-
-  getCurrentUser() {
-    return this.userCookie.get()
-  }
-
-  isAuthenticated() {
-    return !!(this.tokenCookie.get() && this.userCookie.get())
-  }
-
-  logout() {
-    this.tokenCookie.remove()
-    this.userCookie.remove()
-  }
-}
-
-// Использование
-const auth = new AuthManager()
-auth.login({ username: 'ivan', password: 'secret' })
-console.log('Аутентифицирован:', auth.isAuthenticated())
-```
-
-### Корзина покупок
-
-```javascript
-class ShoppingCart {
-  constructor() {
-    this.cartCookie = new Cookie('shopping-cart')
-  }
-
-  getItems() {
-    return this.cartCookie.get([])
-  }
-
-  addItem(product, quantity = 1) {
-    const items = this.getItems()
-    const existingIndex = items.findIndex(item => item.id === product.id)
-
-    if (existingIndex >= 0) {
-      items[existingIndex].quantity += quantity
-    } else {
-      items.push({ ...product, quantity })
-    }
-
-    this.cartCookie.set(items, { age: 30 * 24 * 60 * 60 }) // 30 дней
-    return items
-  }
-
-  getTotalPrice() {
-    return this.getItems().reduce((total, item) =>
-      total + (item.price * item.quantity), 0
-    )
-  }
-
-  clear() {
-    this.cartCookie.remove()
-  }
-}
-
-// Использование
-const cart = new ShoppingCart()
-cart.addItem({ id: 1, name: 'Ноутбук', price: 79999.99 })
-console.log('Общая цена:', cart.getTotalPrice())
-```
-
-### Настройки пользователя
-
-```javascript
-const userSettings = new Cookie('user-settings')
-
-// Получение настроек с значениями по умолчанию
-const settings = userSettings.get({
-  theme: 'light',
-  language: 'ru',
-  notifications: true
-})
-
-// Обновление настроек
-function updateTheme(newTheme) {
-  const current = userSettings.get()
-  userSettings.set({ ...current, theme: newTheme })
-}
-
-updateTheme('dark')
-console.log('Тема:', userSettings.get().theme)
-```
-
-Класс Cookie предоставляет мощный, соответствующий приватности способ управления браузерными cookie с автоматической сериализацией и гибкими опциями конфигурации, делая его идеальным для современных веб-приложений.