🧩 Sobre o pacote

@wjunin/input-utils-pro é um conjunto completo de utilitários avançados para entradas de dados em projetos brasileiros, incluindo:

• Validações completas:
  • CPF, CNPJ, PIS
  • RG por estado (formatos oficiais)
  • Placas Mercosul e modelos antigos
  • Cartão de crédito (Luhn)
• Bloqueio inteligente de digitação
• Máscaras automáticas configuráveis
• Integração com jQuery Validate
• UMD, ESM e versão minificada
• Testes unitários com QUnit

Ideal para formulários modernos, aplicações MVC, sistemas corporativos ou projetos SPA com jQuery/Bootstrap.

📦 Instalação

Via NPM

npm install @wjunin/input-utils-pro

VIA CDN (jsDelivr)
<script src="https://cdn.jsdelivr.net/npm/@wjunin/input-utils-pro/dist/input-utils.min.js"></script>

VIA CDN(unpkg)
<script src="https://unpkg.com/@wjunin/input-utils-pro/dist/input-utils.min.js"></script>


🚀 Como usar

1. Via UMD
<script src="input-utils.min.js"></script>
<script>
   InputUtils.validateCPF("123.456.789-09");
</script>

2. Via ES Modules
import { validateCPF, maskCPF } from "@wjunin/input-utils-pro";

console.log(validateCPF("123.456.789-09"));

3. Via jQuery
$("#cpf").on("input", function(){
    InputUtils.applyMaskCPF(this);
});

🎯 Exemplos de Uso
*Validação de CPF
InputUtils.validateCPF("123.456.789-09");
*Validação de CNPJ
InputUtils.validateCNPJ("12.345.678/0001-90");
*Validação de PIS
InputUtils.validatePIS("123.45678.90-1");
*Validação de RG por estado
InputUtils.validateRG("12.345.678-9", "SP");
*Validação de Placas
InputUtils.validatePlate("BRA2E19");
InputUtils.validatePlate("ABC-1234");
*Luhn (cartão)
InputUtils.validateLuhn("4539578763621486");


📝 Máscaras
InputUtils.applyMaskCPF(input);
InputUtils.applyMaskCNPJ(input);
InputUtils.applyMaskRG(input, "SP");
InputUtils.applyMaskPIS(input);
InputUtils.applyMaskPlate(input);


🔐 Bloqueio de digitação
*Apenas números
InputUtils.allowOnlyNumbers("#campo");
*Apenas letras
InputUtils.allowOnlyLetters("#nome");
*Regex customizado
InputUtils.allowPattern("#campo", /^[A-Z0-9]+$/);

🧩 jQuery Validate
$.validator.addMethod("cpf", v => InputUtils.validateCPF(v));

$("#form").validate({
   rules: { cpf: { cpf: true } },
   messages: { cpf: "Informe um CPF válido." }
});

🧪 Testes Unitários
test/test-build.html
Testa:
1º CPF
2º CNPJ
3º PIS
4º RG
5º Placas
6º Luhn

💼 Sobre o Autor

Wander Luz dos Santos Junior (wjunin)
Desenvolvedor Full Stack C#, especialista em validações, automações e ferramentas de produtividade.

📧 E-mail: [email protected]
💼 LinkedIn: https://linkedin.com/in/wander-luz-dos-santos-junior-445004103

🐙 GitHub: https://github.com/wjunin