@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