@br-validators/vue

@br-validators/vue

Vue 3 composables that delegate validation and formatting to @br-validators/core v1.10.0.

Install

pnpm add @br-validators/vue @br-validators/core vue

Peer dependencies: vue ^3.5.0, @br-validators/core

Generic composable

<script setup lang="ts">
import { useBrValidator } from '@br-validators/vue';

const cpf = useBrValidator('cpf');
</script>

<template>
  <input v-model="cpf.value" />
  <p v-if="cpf.error">{{ cpf.error }}</p>
  <p v-else-if="cpf.isValid">Formatted: {{ cpf.formatted }}</p>
</template>

Named composables (v1)

Composable	Core delegate
useCpf()	validateCpf / formatCpf
useCnpj()	validateCnpj / formatCnpj
useCep()	validateCep / formatCep
useTelefone()	validateTelefone / formatTelefone
usePix()	validatePixKey / formatPixKey
useInscricaoEstadual({ uf })	validateInscricaoEstadual / formatInscricaoEstadual

Each composable exposes reactive value, error, formatted, isValid, and validate().

Inscrição Estadual with UF ref

import { ref } from 'vue';
import { useInscricaoEstadual } from '@br-validators/vue';

const uf = ref<'SP' | 'RJ'>('SP');
const ie = useInscricaoEstadual({ uf });

PIX type constraint

import { usePix } from '@br-validators/vue';

const pix = usePix({ pixType: 'email' });

Invalid values surface the same message string returned by core validate*.

Official algorithm sources: docs/OFFICIAL-SOURCES.md.

License

MIT