@dxtmisha/wiki 0.24.3 → 0.39.1

package/src/media/functional/functional-basic/functions/isEnter/isEnter.vi.mdx

@@ -0,0 +1,30 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Functions/isEnter - Kiểm tra nhấn phím Enter hoặc Space'/>
+
+# `isEnter`
+
+Kiểm tra xem phím được nhấn có phải là `Enter` hoặc `Space` hay không. Hàm này hữu ích để xử lý các sự kiện bàn phím khi bạn cần phản ứng với việc xác nhận hành động hoặc kích hoạt phần tử, đồng thời hỗ trợ khả năng truy cập (a11y) và các trình duyệt cũ.
+
+**Tham số:**
+- `event: KeyboardEvent` — đối tượng sự kiện bàn phím.
+
+**Trả về:**
+`boolean` — `true` nếu phím `Enter` hoặc `Space` được nhấn, ngược lại là `false`.
+
+**Các thuộc tính sự kiện được hỗ trợ:**
+Hàm kiểm tra các thuộc tính sự kiện sau để đảm bảo khả năng tương thích tối đa:
+- `code`: `'Enter'`, `'Space'`
+- `key`: `'Enter'`, `' '`, `'Spacebar'`
+- `keyCode`: `13`, `32`
+
+```typescript
+import { isEnter } from '@dxtmisha/functional-basic'
+
+const onKeyDown = (event: KeyboardEvent) => {
+  if (isEnter(event)) {
+    console.log('Đã nhấn Enter hoặc Space')
+    // Thực hiện hành động
+  }
+}
+```

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

@@ -45,6 +45,42 @@ applyTemplate('Это [bold]жирный текст[/bold]', { bold: '<b>[conten
 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`
 
 Рекурсивно заменяет значения в объекте или массиве.
@@ -78,6 +114,37 @@ replaceTemplate('User [id]: [name]', {id: '123', name: 'John'}) // 'User 123: Jo
 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`
 
 Преобразует секунды в формат времени (часы:минуты:секунды).

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

@@ -37,6 +37,31 @@ const copy = copyObject(original)
 copy.data.age = 25 // original.data.age остается 30
 ```
 
+## `copyObjectLite`
+
+Создает поверхностную копию простого объекта. Если передан параметр `source`, создаёт новый объект и объединяет `value` и `source`.
+
+**Параметры:**
+- `value: T` — объект для копирования
+- `source?: any` — дополнительные свойства для копирования (опционально)
+
+```javascript
+import { copyObjectLite } from '@dxtmisha/functional'
+
+const original = { name: 'John', age: 30 }
+const copy = copyObjectLite(original) // { name: 'John', age: 30 }
+
+// С дополнительными свойствами
+const extended = copyObjectLite(original, { city: 'Moscow' })
+// { name: 'John', age: 30, city: 'Moscow' }
+
+// Переопределение свойств
+const overridden = copyObjectLite(original, { age: 25 })
+// { name: 'John', age: 25 }
+```
+
+**Примечание:** Это поверхностная копия — вложенные объекты сохраняют ссылки на исходные. Для глубокого клонирования используйте `copyObject`, `structuredClone` или `_.cloneDeep`.
+
 ## `forEach`
 
 Универсальная функция итерации для массивов, объектов и Map.

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

@@ -68,7 +68,7 @@ const staticDatetime = new DatetimeRef('2024-01-15', 'date', 'ru-RU')
 
 ```javascript
 const yearValue = datetime.getYear()
-// Автоматически обновляется при изменении д��ты
+// Автоматически обновляется при изменении даты
 ```
 
 ### `getMonth`
@@ -228,7 +228,7 @@ const withoutTz = datetime.standard(false)
 
 ### Vue компонент с реактивной датой
 
-```vue
+```html
 <template>
   <div>
     <span>{{ datetime.getYear() }}/{{ datetime.getMonth() + 1 }}/{{ datetime.getDay() }}</span>

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

@@ -259,7 +259,7 @@ const eventRef = new EventRef(buttonRef, containerRef, 'click')
 
 ### Vue компонент с реактивными событиями
 
-```vue
+```html
 <template>
   <button ref="buttonEl">Нажми меня</button>
   <input ref="inputEl" placeholder="Введите...">

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

@@ -6,6 +6,62 @@ import {Meta} from '@storybook/addon-docs/blocks'
 
 Набор функций для универсального выполнения синхронных и асинхронных операций.
 
+## `computedByLanguage`
+
+Создает реактивное вычисляемое свойство, значение которого зависит от текущего языка и заданных условий.
+
+**Параметры:**
+- `getter: ComputedGetter<R>` — функция, возвращающая основное значение в зависимости от языка
+- `getterNone: R | (() => R)` — альтернативное значение, если условия не выполнены или getter вернул undefined (по умолчанию undefined)
+- `conditions: () => boolean` — условие для вызова основного getter (опционально)
+- `debugOptions: DebuggerOptions` — опции отладки Vue (опционально)
+
+```javascript
+import { computedByLanguage } from '@dxtmisha/functional'
+import { ref } from 'vue'
+
+// Простой пример с переводами
+const title = computedByLanguage(
+  () => {
+    const lang = GeoRef.get().value
+    return lang === 'ru' ? 'Заголовок' : 'Title'
+  },
+  'Default Title'
+)
+
+// С условием
+const description = computedByLanguage(
+  () => {
+    const lang = GeoRef.get().value
+    const translations = {
+      ru: 'Описание на русском',
+      en: 'Description in English'
+    }
+    return translations[lang]
+  },
+  () => 'Описание по умолчанию',
+  () => showDescription.value // условие показа
+)
+
+// Использование в компоненте
+export default {
+  setup() {
+    const showText = ref(true)
+
+    const greeting = computedByLanguage(
+      () => {
+        const lang = GeoRef.get().value
+        return lang === 'ru' ? 'Привет, мир!' : 'Hello, world!'
+      },
+      'Greeting',
+      () => showText.value
+    )
+
+    return { greeting }
+  }
+}
+```
+
 ## `executeFunction`
 
 Выполняет функцию и возвращает её результат, или возвращает входные данные, если это не функция.
@@ -148,3 +204,5 @@ export default {
   }
 }
 ```
+
+

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

@@ -162,7 +162,7 @@ countryCode.value = 'en-US'
 
 ### Vue компонент с флагами стран
 
-```vue
+```html
 <template>
   <div class="country-selector">
     <div class="current-country">

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

@@ -69,7 +69,7 @@ intl.getLocation() // 'ru-RU'
 
 Возвращает первый день недели для текущей локали.
 
-**Возвращает:** `string` — код первого дня ('Su' для во��кресенья, 'Mo' для понедельника)
+**Возвращает:** `string` — код первого дня ('Su' для воскресенья, 'Mo' для понедельника)
 
 ```javascript
 const intl = new GeoIntl('ru-RU')
@@ -517,7 +517,7 @@ intl.relative(yesterday, { numeric: 'always' }) // '1 день назад'
 - `todayValue?: Date` — базовая дата для сравнения (опционально)
 - `relativeOptions?: string | Intl.RelativeTimeFormatOptions` — опции относительного времени (опционально)
 - `dateOptions?: string | Intl.DateTimeFormatOptions` — опции обычной даты (опционально)
-- `type?: GeoDate` — тип форматиро��ания даты (опционально)
+- `type?: GeoDate` — тип форматирования даты (опционально)
 - `hour24?: boolean` — использовать 24-часовой формат (опционально)
 
 **Возвращает:** `string` — отформатированное относительное время или дата

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

@@ -291,7 +291,7 @@ const daysList = intl.weekdays('long')
 
 ### Vue компонент с локализацией
 
-```vue
+```html
 <template>
   <div class="localized-content">
     <h2>{{ intl.countryName('RU') }}</h2>

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

@@ -141,7 +141,7 @@ const flag = new GeoFlagRef() // будет использовать de-DE
 
 ### Vue компонент с глобальной геолокацией
 
-```vue
+```html
 <template>
   <div class="geo-info">
     <h2>Текущая локация</h2>
@@ -202,7 +202,7 @@ GeoRef.set(userLocale)
 
 ### Глобальный провайдер локали
 
-```vue
+```html
 <!-- App.vue -->
 <template>
   <div class="app">

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

@@ -534,4 +534,4 @@ function createListFromInput<T extends ListDataBasic>(
 }
 ```
 
-Эти типы списков обеспечивают полную типизацию для создан��я интерактивных списков, меню, навигации и других компонентов с поддержкой выбора, поиска и группировки элементов.
+Эти типы списков обеспечивают полную типизацию для создания интерактивных списков, меню, навигации и других компонентов с поддержкой выбора, поиска и группировки элементов.