@qor/helpers
@qor/helpers
Утилиты форматирования и преобразования данных.
Модуль @qor/helpers предоставляет набор утилит для форматирования и преобразования данных, специфичных для Казахстана.
Установка
Terminal
pnpm add @qor/helpers
nuxt.config.ts
export default defineNuxtConfig({
modules: ['@qor/helpers'],
})
Auto-imports
Все утилиты автоматически доступны в компонентах без импорта:
<template>
<p>{{ formatCurrency(15000) }}</p>
</template>
Утилиты
Форматирование
| Функция | Описание | Пример |
|---|---|---|
formatCurrency | Форматирование суммы в тенге | formatCurrency(15000) → "15 000 ₸" |
formatPhone | Форматирование телефона | formatPhone('77001234567') → "+7 700 123 45 67" |
formatName | Форматирование ФИО | formatName('Иван', 'Иванов') → "Иван Иванов" |
Даты
| Функция | Описание |
|---|---|
DATE_FORMATS | Константы форматов дат для dayjs (DISPLAY, API, DATETIME и др.) |
parseServerTime | Парсинг UTC времени из API с учётом таймзоны |
Преобразование данных
| Функция | Описание |
|---|---|
toQueryParams | Конвертация объекта в URLSearchParams с поддержкой массивов |
toSelectOptions | Конвертация массива объектов в опции для select |
convertToFormData | Рекурсивная конвертация объекта в FormData |
getNestedValue | Получение вложенного значения по пути ('user.address.city') |
getQueryValue | Безопасное получение значения из query параметров |
Утилиты
| Функция | Описание |
|---|---|
downloadBlob | Скачивание Blob как файла |
generateRandomID | Генерация случайного ID из букв |
generateUUID | Генерация UUID v4 |