mask-utils-ccg

🚀 Biblioteca de máscaras para JavaScript e TypeScript, ideal para formatação de números, datas, CPF, CNPJ, telefones e muito mais.

🔗 NPM: mask-utils-ccg

📦 Instalação

Você pode instalar o pacote via npm ou yarn:

Usando npm:

npm install mask-utils-ccg

Usando yarn:

yarn add mask-utils-ccg

🚀 Uso

Importação

JavaScript (CommonJS)

const { maskCPF, maskCNPJ, maskPhone, maskDate, maskCEP, maskRG, maskCreditCard, maskTime, validateCPF } = require('mask-utils-ccg');

TypeScript (ES Modules)

import { maskCPF, maskCNPJ, maskPhone, maskDate, maskCEP, maskRG, maskCreditCard, maskTime, validateCPF } from 'mask-utils-ccg';

Exemplos de Uso

📌 Máscara para CPF

maskCPF("12345678900"); // Saída: "123.456.789-00"

📌 Máscara para CNPJ

maskCNPJ("12345678000195"); // Saída: "12.345.678/0001-95"

📌 Máscara para Telefone

maskPhone("62987654321"); // Saída: "(62) 98765-4321"

📌 Máscara para CEP

maskCEP("72840000"); // Saída: "72.840-000"

📌 Máscara para RG

maskRG("123456789"); // Saída: "12.345.678-9"

📌 Máscara para Cartão de Crédito

maskCreditCard("1234567812345678"); // Saída: "1234 5678 1234 5678"

📌 Máscara para Data (DD/MM/YYYY)

maskDate("20250201"); // Saída: "01/02/2025"

📌 Máscara para Hora (HH:MM)

maskTime("1530"); // Saída: "15:30"

📌 Validação de CPF

validateCPF("12345678900"); // Saída: false
validateCPF("123.456.789-09"); // Saída: true

📚 Lista de Máscaras e Funções Disponíveis

| Função | Descrição | Exemplo de Entrada | Exemplo de Saída | |-------------------|------------------------------------------|---------------------|-----------------------| | maskCPF | Aplica máscara de CPF | "12345678900" | "123.456.789-00" | | maskCNPJ | Aplica máscara de CNPJ | "12345678000195" | "12.345.678/0001-95"| | maskPhone | Aplica máscara de telefone | "62987654321" | "(62) 98765-4321" | | maskCEP | Aplica máscara de CEP | "72840000" | "72.840-000" | | maskRG | Aplica máscara de RG | "123456789" | "12.345.678-9" | | maskCreditCard | Aplica máscara de cartão de crédito | "1234567812345678"| "1234 5678 1234 5678"| | maskDate | Aplica máscara de data (DD/MM/YYYY) | "20250201" | "01/02/2025" | | maskTime | Aplica máscara de hora (HH:MM) | "1530" | "15:30" | | validateCPF | Valida um CPF (verifica se é válido) | "12345678900" | false |

💻 Desenvolvimento

Se quiser contribuir com melhorias ou adicionar novas máscaras, siga os passos abaixo:

1. Clone o repositório:

   git clone https://github.com/MichaelDouglasCA/mask-utils-ccg.git

2. Instale as dependências:

   npm install

3. Faça as alterações e rode os testes:

   npm test

4. Crie um Pull Request.

📜 Licença

Este projeto está sob a licença MIT. Sinta-se livre para usá-lo e contribuir! 😃

Desenvolvido por Michael Douglas 🚀