@maz-ui/utils

Lightweight, tree-shakeable utility functions and TypeScript helpers for Vue, Nuxt and any JavaScript/TypeScript project.

@maz-ui/utils ships the runtime helpers and TypeScript type utilities that power maz-ui internally, packaged as a standalone, framework-agnostic library. No Vue dependency, no global side effects — just import what you need.

Installation

pnpm

pnpm add @maz-ui/utils

npm

npm install @maz-ui/utils

yarn

yarn add @maz-ui/utils

Basic usage

import { debounce, formatCurrency, sleep } from '@maz-ui/utils'

const debounced = debounce(() => console.log('typed'), 300)

const price = formatCurrency(1999.9, 'fr-FR', { currency: 'EUR' })

await sleep(500)

What's inside

Strings

• camelCase
• capitalize
• kebabCase
• normalizeString
• pascalCase
• snakeCase
• upperFirst

Numbers & Currency

• formatCurrency
• formatNumber

Dates

• formatDate

Timing

• debounce
• debounceCallback
• debounceId
• IdleTimeout
• sleep
• throttle
• throttleId

Browser & DOM

• cookie
• getBrowserLocale
• isClient
• isIos
• isServer
• isStandaloneMode
• preventIosInputZoom
• ScriptLoader
• Swipe
• TextareaAutogrow
• UserVisibility

Country & Flags

• countryCodeToUnicodeFlag
• fetchLocaleIp
• getCountryFlagUrl

Validation & Comparison

• checkAvailability
• isEqual
• truthyFilter

Formatting & Errors

• formatJson
• formatPhoneNumber
• getErrorMessage

TypeScript Helpers

• DeepKeyOf
• DeepPartial
• DeepRequired
• FlattenObjectKeys
• GenericInstanceType
• InferMaybeRef

Tree-shaking

The package is published with "sideEffects": false. Named imports — import { sleep } from '@maz-ui/utils' — are statically analysed by Vite, Rollup, esbuild and webpack: any helper you don't reference is dropped from your bundle.

For granular bundling you can also import a single helper through its dedicated subpath:

import { sleep } from '@maz-ui/utils/helpers/sleep'

TypeScript helpers

Beyond runtime utilities, @maz-ui/utils also exports a set of generic type helpers (DeepPartial, DeepKeyOf, FlattenObjectKeys, …) under @maz-ui/utils/ts-helpers. See the TypeScript Helpers section in the sidebar.