@kodatec/brasil-utils 1.0.0

package/README.md

@@ -0,0 +1,157 @@
+# @kodatec/brasil-utils
+
+Utilitarios para dados brasileiros: formatacao, validacao e mascaras de CPF, CNPJ, CEP, telefone, moeda e mais.
+
+- TypeScript com tipos inclusos
+- ESM e CommonJS
+- Zero dependencias em runtime
+- Configuracoes de mascara compativeis com IMask
+
+## Instalacao
+
+```bash
+npm install @kodatec/brasil-utils
+```
+
+## Uso
+
+```ts
+import {
+  validarCPF,
+  formataCpf,
+  maskCpf,
+  getUfs,
+} from '@kodatec/brasil-utils'
+```
+
+## API
+
+### Validacao
+
+| Funcao | Descricao |
+|---|---|
+| `validarCPF(cpf)` | Valida CPF (aceita com ou sem mascara) |
+| `validarCNPJ(cnpj)` | Valida CNPJ (aceita com ou sem mascara) |
+| `isValidDate(dateString)` | Valida data no formato `DD/MM/YYYY` |
+| `isValidDateMesAno(dateString)` | Valida mes/ano no formato `MM/YYYY` |
+
+```ts
+validarCPF('123.456.789-09') // true | false
+validarCNPJ('11.222.333/0001-81') // true | false
+isValidDate('31/12/2025') // true
+isValidDateMesAno('13/2025') // false
+```
+
+### Formatacao
+
+#### Documentos
+
+| Funcao | Descricao |
+|---|---|
+| `formataCpf(cpf, mascarar?)` | Formata CPF. `mascarar=true` (padrao) oculta digitos: `***.456.789-**` |
+| `formataCnpj(cnpj, mascarar?)` | Formata CNPJ. `mascarar=false` (padrao) exibe completo |
+| `formataNis(nis)` | Formata NIS/PIS/PASEP: `123.45678.90-1` |
+| `formataCep(cep)` | Formata CEP: `12345-678` |
+| `formataTelefone(telefone)` | Formata telefone fixo ou celular: `(11) 99999-9999` |
+
+```ts
+formataCpf('12345678909')        // '***.$2.$3-**'
+formataCpf('12345678909', false) // '123.456.789-09'
+formataCnpj('11222333000181')    // '11.222.333/0001-81'
+formataTelefone('11999998888')   // '(11) 99999-8888'
+```
+
+#### Moeda
+
+| Funcao | Descricao |
+|---|---|
+| `formataMoedaReais(valor)` | Formata numero para moeda BRL: `R$ 1.234,56` |
+
+```ts
+formataMoedaReais(1234.5) // 'R$ 1.234,50'
+```
+
+#### Nomes
+
+| Funcao | Descricao |
+|---|---|
+| `formataNome(nome)` | Primeiro + ultimo nome: `Alex Furtunato` |
+| `formataNomePessoal(nome)` | Nome completo com preposicoes em minusculo: `Alex Fabiano de Araujo Furtunato` |
+
+```ts
+formataNome('ALEX FABIANO DE ARAÚJO FURTUNATO')
+// 'Alex Furtunato'
+
+formataNomePessoal('ALEX FABIANO DE ARAÚJO FURTUNATO')
+// 'Alex Fabiano de Araújo Furtunato'
+```
+
+#### Datas
+
+| Funcao | Descricao |
+|---|---|
+| `formataDataRetirandoHora(datastr)` | `"2025-05-21T17:57:10"` → `"21/05/2025"` |
+| `formataDataFromDb(datastr)` | `"2025-05-21"` → `"21/05/2025"` |
+| `formataDataHoraFromDb(datastr)` | Data e hora do banco para `pt-BR` |
+| `formataDiaMesFromDb(datastr)` | `"21/05"` |
+| `formataDataInt(datastr)` | `7022025` → `"07/02/2025"` |
+| `mudaFormatoDataSep(datastr)` | Alterna entre `DD/MM/YYYY` e `YYYY-MM-DD` |
+| `converterParaDataIso(dataString)` | `DD/MM/YYYY` → `YYYY/MM/DD` |
+| `mudaFormatoMesAno(datastr)` | Alterna entre `MM/YYYY` e `YYYY-MM` |
+| `formataDataMesReferencia(data)` | `"2025-05"` → `"05/2025"` |
+| `formatarDataExtrato(data)` | Inteiro para data formatada |
+
+#### Arquivo
+
+| Funcao | Descricao |
+|---|---|
+| `formataTamanhoArquivo(bytes)` | `1024` → `"1 KB"` |
+
+### Normalizacao
+
+| Funcao | Descricao |
+|---|---|
+| `removeAcentos(texto)` | Remove acentos: `"Sao Paulo"` → `"Sao Paulo"` |
+| `removeMascara(valor)` | Remove tudo exceto digitos |
+| `removerPontuacao(valor)` | Remove pontuacao de documentos, preserva nomes |
+
+```ts
+removeAcentos('São Paulo') // 'Sao Paulo'
+removeMascara('123.456.789-09') // '12345678909'
+removerPontuacao('123.456.789-09') // '12345678909'
+removerPontuacao('João da Silva') // 'João da Silva' (mantém)
+```
+
+### Mascaras (IMask)
+
+Configuracoes prontas para uso com [IMask](https://imask.js.org/):
+
+| Constante | Mascara |
+|---|---|
+| `maskCpf` | `000.000.000-00` |
+| `maskCnpj` | `00.000.000/0000-00` |
+| `maskCpfCnpj` | Dinamica: CPF ou CNPJ conforme digitacao |
+| `maskCep` | `00000-000` |
+| `maskTelefone` | Dinamica: fixo `(00) 0000-0000` ou celular `(00) 00000-0000` |
+| `maskNis` | `000.00000.00-0` |
+| `maskMoeda` | Numero com separador de milhar `.` e decimal `,` |
+| `maskData` | `00/00/0000` |
+| `maskMesAno` | `00/0000` |
+
+```ts
+import IMask from 'imask'
+import { maskCpf } from '@kodatec/brasil-utils'
+
+IMask(element, maskCpf)
+```
+
+### Constantes
+
+| Funcao | Descricao |
+|---|---|
+| `getUfs()` | Lista das 27 UFs brasileiras `{ sigla, nome }` |
+| `localePtBr()` | Traducao pt-BR para PrimeVue/PrimeReact |
+
+## Licenca
+
+MIT

package/dist/brasil-utils.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function c(){return[{sigla:"AC",nome:"Acre"},{sigla:"AL",nome:"Alagoas"},{sigla:"AP",nome:"Amapá"},{sigla:"AM",nome:"Amazonas"},{sigla:"BA",nome:"Bahia"},{sigla:"CE",nome:"Ceará"},{sigla:"DF",nome:"Distrito Federal"},{sigla:"ES",nome:"Espírito Santo"},{sigla:"GO",nome:"Goiás"},{sigla:"MA",nome:"Maranhão"},{sigla:"MT",nome:"Mato Grosso"},{sigla:"MS",nome:"Mato Grosso do Sul"},{sigla:"MG",nome:"Minas Gerais"},{sigla:"PA",nome:"Pará"},{sigla:"PB",nome:"Paraíba"},{sigla:"PR",nome:"Paraná"},{sigla:"PE",nome:"Pernambuco"},{sigla:"PI",nome:"Piauí"},{sigla:"RJ",nome:"Rio de Janeiro"},{sigla:"RN",nome:"Rio Grande do Norte"},{sigla:"RS",nome:"Rio Grande do Sul"},{sigla:"RO",nome:"Rondônia"},{sigla:"RR",nome:"Roraima"},{sigla:"SC",nome:"Santa Catarina"},{sigla:"SP",nome:"São Paulo"},{sigla:"SE",nome:"Sergipe"},{sigla:"TO",nome:"Tocantins"}]}function d(){return{startsWith:"Começa com",contains:"Contém",notContains:"Não contém",endsWith:"Termina com",equals:"Igual",notEquals:"Diferente",noFilter:"Sem Filtro",filter:"Filtro",lt:"Menor que",lte:"Menor ou igual a",gt:"Maior que",gte:"Maior ou igual a",dateIs:"Data é",dateIsNot:"Data não é",dateBefore:"Data antes de",dateAfter:"Data depois de",custom:"Personalizado",clear:"Limpar",apply:"Aplicar",matchAll:"Corresponder Todos",matchAny:"Corresponder Qualquer",addRule:"Adicionar Regra",removeRule:"Remover Regra",accept:"Sim",reject:"Não",choose:"Escolher",upload:"Enviar",cancel:"Cancelar",completed:"Concluído",pending:"Pendente",fileSizeTypes:["B","KB","MB","GB","TB","PB","EB","ZB","YB"],dayNames:["Domingo","Segunda-feira","Terça-feira","Quarta-feira","Quinta-feira","Sexta-feira","Sábado"],dayNamesShort:["Dom","Seg","Ter","Qua","Qui","Sex","Sáb"],dayNamesMin:["D","S","T","Q","Q","S","S"],monthNames:["Janeiro","Fevereiro","Março","Abril","Maio","Junho","Julho","Agosto","Setembro","Outubro","Novembro","Dezembro"],monthNamesShort:["Jan","Fev","Mar","Abr","Mai","Jun","Jul","Ago","Set","Out","Nov","Dez"],chooseYear:"Escolher Ano",chooseMonth:"Escolher Mês",chooseDate:"Escolher Data",prevDecade:"Década Anterior",nextDecade:"Próxima Década",prevYear:"Ano Anterior",nextYear:"Próximo Ano",prevMonth:"Mês Anterior",nextMonth:"Próximo Mês",prevHour:"Hora Anterior",nextHour:"Próxima Hora",prevMinute:"Minuto Anterior",nextMinute:"Próximo Minuto",prevSecond:"Segundo Anterior",nextSecond:"Próximo Segundo",am:"AM",pm:"PM",today:"Hoje",now:"Agora",weekHeader:"Sem",firstDayOfWeek:0,showMonthAfterYear:!1,dateFormat:"dd/MM/yy",weak:"Fraco",medium:"Médio",strong:"Forte",passwordPrompt:"Digite uma senha",emptyFilterMessage:"Nenhum resultado encontrado",searchMessage:"Existem {0} resultados disponíveis",selectionMessage:"{0} itens selecionados",emptySelectionMessage:"Nenhum item selecionado",emptySearchMessage:"Nenhum resultado encontrado",emptyMessage:"Nenhuma opção disponível",aria:{trueLabel:"Verdadeiro",falseLabel:"Falso",nullLabel:"Não Selecionado",star:"1 estrela",stars:"{star} estrelas",selectAll:"Todos os itens selecionados",unselectAll:"Todos os itens desmarcados",close:"Fechar",previous:"Anterior",next:"Próximo",navigation:"Navegação",scrollTop:"Rolar para o Topo",moveTop:"Mover para o Topo",moveUp:"Mover para Cima",moveDown:"Mover para Baixo",moveBottom:"Mover para o Final",moveToTarget:"Mover para o Destino",moveToSource:"Mover para a Origem",moveAllToTarget:"Mover Todos para o Destino",moveAllToSource:"Mover Todos para a Origem",pageLabel:"Página {page}",firstPageLabel:"Primeira Página",lastPageLabel:"Última Página",nextPageLabel:"Próxima Página",previousPageLabel:"Página Anterior",rowsPerPageLabel:"Linhas por página",jumpToPageDropdownLabel:"Ir para a Página",jumpToPageInputLabel:"Ir para a Página",selectRow:"Linha Selecionada",unselectRow:"Linha Desmarcada",expandRow:"Expandir Linha",collapseRow:"Recolher Linha",showFilterMenu:"Mostrar Menu de Filtro",hideFilterMenu:"Esconder Menu de Filtro",filterOperator:"Operador de Filtro",filterConstraint:"Restrição de Filtro",editRow:"Editar Linha",saveEdit:"Salvar Edição",cancelEdit:"Cancelar Edição",listView:"Visualização de Lista",gridView:"Visualização de Grade",slide:"Deslizar",slideNumber:"Slide {slideNumber}",zoomImage:"Ampliar Imagem",zoomIn:"Ampliar",zoomOut:"Reduzir",rotateRight:"Rotacionar para a Direita",rotateLeft:"Rotacionar para a Esquerda"}}}function g(e,a=!0){return e?a?e.replace(/(\d{3})(\d{3})(\d{3})(\d{2})/,"***.$2.$3-**"):e.replace(/(\d{3})(\d{3})(\d{3})(\d{2})/,"$1.$2.$3-$4"):""}function p(e,a=!1){return e?a?e.replace(/(\d{2})(\d{3})(\d{3})(\d{4})(\d{2})/,"**.$2.$3/$4-**"):e.replace(/(\d{2})(\d{3})(\d{3})(\d{4})(\d{2})/,"$1.$2.$3/$4-$5"):""}function f(e){return e?e.replace(/(\d{3})(\d{5})(\d{2})(\d{1})/,"$1.$2.$3-$4"):""}function h(e){return e?e.replace(/(\d{5})(\d{3})/,"$1-$2"):""}function M(e){return e?e.length===10?e.replace(/(\d{2})(\d{4})(\d{4})/,"($1) $2-$3"):e.length===11?e.replace(/(\d{2})(\d{5})(\d{4})/,"($1) $2-$3"):e:""}function D(e){return new Intl.NumberFormat("pt-BR",{style:"currency",currency:"BRL"}).format(e)}const S=["da","de","do","das","dos","e"];function i(e){return e.charAt(0).toUpperCase()+e.slice(1).toLowerCase()}function P(e){if(!e)return"";const a=e.split(" ");return a.length>=2?`${i(a[0])} ${i(a[a.length-1])}`:i(a[0])}function $(e){return e?e.split(" ").map(o=>S.includes(o.toLowerCase())?o.toLowerCase():i(o)).join(" "):""}function A(e){if(!e)return"";const a=new Date(e),o=String(a.getDate()).padStart(2,"0"),t=String(a.getMonth()+1).padStart(2,"0"),r=a.getFullYear();return`${o}/${t}/${r}`}function v(e){return new Date(e+"T00:00:00").toLocaleDateString("pt-BR")}function b(e){return new Date(e+"Z").toLocaleString("pt-BR")}function C(e){const a=new Date(e+"Z"),o=String(a.getDate()).padStart(2,"0"),t=String(a.getMonth()+1).padStart(2,"0");return`${o}/${t}`}function R(e){if(!e)return"";const a=e.toString(),o=a.length===7?"0"+a.substring(0,1):a.substring(0,2),t=a.length===7?a.substring(1,3):a.substring(2,4),r=a.substring(a.length-4);return`${o}/${t}/${r}`}function F(e){if(!e)return"";if(e.includes("/")){const a=e.split("/");return`${a[2]}-${a[1]}-${a[0]}`}if(e.includes("-")){const a=e.split("-");return`${a[2]}/${a[1]}/${a[0]}`}return e}function T(e){const[a,o,t]=e.split("/");return`${t}/${o}/${a}`}function N(e){if(!e)return"";if(e.includes("/")){const a=e.split("/");return`${a[1]}-${a[0]}`}if(e.includes("-")){const a=e.split("-");return`${a[1]}/${a[0]}`}return e}function k(e){if(!e)return"";const a=e.split("-");return a.length===3?`${a[1]}/${a[0]}`:a.length===2?`${a[0]}/${a[1]}`:""}function w(e){if(!e)return"";const a=e.toString(),o=a.length===7?"0"+a[0]:a.substring(0,2),t=a.length===7?a.substring(1,3):a.substring(2,4),r=a.slice(-4);return`${o}/${t}/${r}`}function B(e){const a=["Bytes","KB","MB","GB","TB"];if(e===0)return"0 Byte";const o=Math.floor(Math.log(e)/Math.log(1024));return Math.round(e/Math.pow(1024,o))+" "+a[o]}function L(e){if(e=e.replace(/[^\d]+/g,""),e.length!==11||/^(\d)\1+$/.test(e))return!1;let a=0;for(let t=0;t<9;t++)a+=parseInt(e.charAt(t))*(10-t);let o=a*10%11;if((o===10||o===11)&&(o=0),o!==parseInt(e.charAt(9)))return!1;a=0;for(let t=0;t<10;t++)a+=parseInt(e.charAt(t))*(11-t);return o=a*10%11,(o===10||o===11)&&(o=0),o===parseInt(e.charAt(10))}function x(e){if(e=e.replace(/[^\d]+/g,""),e.length!==14||/^(\d)\1+$/.test(e))return!1;const a=(u,s)=>{let l=0;for(let n=0;n<s.length;n++)l+=parseInt(u[n])*s[n];const m=l%11;return m<2?0:11-m},o=e.slice(0,12),t=a(o,[5,4,3,2,9,8,7,6,5,4,3,2]),r=a(o+t,[6,5,4,3,2,9,8,7,6,5,4,3,2]);return e===o+t+""+r}function E(e){const[a,o,t]=e.split("/").map(Number),r=new Date(t,o-1,a);return r.getFullYear()===t&&r.getMonth()+1===o&&r.getDate()===a}function I(e){const[a,o]=e.split("/").map(Number),t=new Date(o,a-1,1);return isNaN(t.getTime())?!1:t.getMonth()+1===a&&t.getFullYear()===o}function y(e){return e.normalize("NFD").replace(/[\u0300-\u036f]/g,"").replace(/ç/g,"c").replace(/Ç/g,"C")}function z(e){return e?e.replace(/[^0-9]/g,""):""}function O(e){if(!e)return e;const a=e.trim(),o=(a.match(/\d/g)||[]).length,t=(a.match(/[a-zA-ZÀ-ÿ]/g)||[]).length;return o>t?e.replace(/\s+/g,"").replace(/[.\-/]/g,""):e}const G={mask:"000.000.000-00"},H={mask:"00.000.000/0000-00"},J={mask:[{mask:"000.000.000-00"},{mask:"00.000.000/0000-00"}],dispatch:(e,a)=>a.value.replace(/\D/g,"").length<=11?0:1},V={mask:"00000-000"},q={mask:[{mask:"(00) 0000-0000"},{mask:"(00) 00000-0000"}],dispatch:(e,a)=>a.value.replace(/\D/g,"").length<=10?0:1},Y={mask:"000.00000.00-0"},Q={mask:Number,scale:2,thousandsSeparator:".",padFractionalZeros:!0,normalizeZeros:!0,radix:",",mapToRadix:["."],min:0},Z={mask:"00/00/0000"},j={mask:"00/0000"};exports.converterParaDataIso=T;exports.formataCep=h;exports.formataCnpj=p;exports.formataCpf=g;exports.formataDataFromDb=v;exports.formataDataHoraFromDb=b;exports.formataDataInt=R;exports.formataDataMesReferencia=k;exports.formataDataRetirandoHora=A;exports.formataDiaMesFromDb=C;exports.formataMoedaReais=D;exports.formataNis=f;exports.formataNome=P;exports.formataNomePessoal=$;exports.formataTamanhoArquivo=B;exports.formataTelefone=M;exports.formatarDataExtrato=w;exports.getUfs=c;exports.isValidDate=E;exports.isValidDateMesAno=I;exports.localePtBr=d;exports.maskCep=V;exports.maskCnpj=H;exports.maskCpf=G;exports.maskCpfCnpj=J;exports.maskData=Z;exports.maskMesAno=j;exports.maskMoeda=Q;exports.maskNis=Y;exports.maskTelefone=q;exports.mudaFormatoDataSep=F;exports.mudaFormatoMesAno=N;exports.removeAcentos=y;exports.removeMascara=z;exports.removerPontuacao=O;exports.validarCNPJ=x;exports.validarCPF=L;

package/dist/brasil-utils.js

@@ -0,0 +1,366 @@
+function d() {
+  return [
+    { sigla: "AC", nome: "Acre" },
+    { sigla: "AL", nome: "Alagoas" },
+    { sigla: "AP", nome: "Amapá" },
+    { sigla: "AM", nome: "Amazonas" },
+    { sigla: "BA", nome: "Bahia" },
+    { sigla: "CE", nome: "Ceará" },
+    { sigla: "DF", nome: "Distrito Federal" },
+    { sigla: "ES", nome: "Espírito Santo" },
+    { sigla: "GO", nome: "Goiás" },
+    { sigla: "MA", nome: "Maranhão" },
+    { sigla: "MT", nome: "Mato Grosso" },
+    { sigla: "MS", nome: "Mato Grosso do Sul" },
+    { sigla: "MG", nome: "Minas Gerais" },
+    { sigla: "PA", nome: "Pará" },
+    { sigla: "PB", nome: "Paraíba" },
+    { sigla: "PR", nome: "Paraná" },
+    { sigla: "PE", nome: "Pernambuco" },
+    { sigla: "PI", nome: "Piauí" },
+    { sigla: "RJ", nome: "Rio de Janeiro" },
+    { sigla: "RN", nome: "Rio Grande do Norte" },
+    { sigla: "RS", nome: "Rio Grande do Sul" },
+    { sigla: "RO", nome: "Rondônia" },
+    { sigla: "RR", nome: "Roraima" },
+    { sigla: "SC", nome: "Santa Catarina" },
+    { sigla: "SP", nome: "São Paulo" },
+    { sigla: "SE", nome: "Sergipe" },
+    { sigla: "TO", nome: "Tocantins" }
+  ];
+}
+function g() {
+  return {
+    startsWith: "Começa com",
+    contains: "Contém",
+    notContains: "Não contém",
+    endsWith: "Termina com",
+    equals: "Igual",
+    notEquals: "Diferente",
+    noFilter: "Sem Filtro",
+    filter: "Filtro",
+    lt: "Menor que",
+    lte: "Menor ou igual a",
+    gt: "Maior que",
+    gte: "Maior ou igual a",
+    dateIs: "Data é",
+    dateIsNot: "Data não é",
+    dateBefore: "Data antes de",
+    dateAfter: "Data depois de",
+    custom: "Personalizado",
+    clear: "Limpar",
+    apply: "Aplicar",
+    matchAll: "Corresponder Todos",
+    matchAny: "Corresponder Qualquer",
+    addRule: "Adicionar Regra",
+    removeRule: "Remover Regra",
+    accept: "Sim",
+    reject: "Não",
+    choose: "Escolher",
+    upload: "Enviar",
+    cancel: "Cancelar",
+    completed: "Concluído",
+    pending: "Pendente",
+    fileSizeTypes: ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"],
+    dayNames: ["Domingo", "Segunda-feira", "Terça-feira", "Quarta-feira", "Quinta-feira", "Sexta-feira", "Sábado"],
+    dayNamesShort: ["Dom", "Seg", "Ter", "Qua", "Qui", "Sex", "Sáb"],
+    dayNamesMin: ["D", "S", "T", "Q", "Q", "S", "S"],
+    monthNames: ["Janeiro", "Fevereiro", "Março", "Abril", "Maio", "Junho", "Julho", "Agosto", "Setembro", "Outubro", "Novembro", "Dezembro"],
+    monthNamesShort: ["Jan", "Fev", "Mar", "Abr", "Mai", "Jun", "Jul", "Ago", "Set", "Out", "Nov", "Dez"],
+    chooseYear: "Escolher Ano",
+    chooseMonth: "Escolher Mês",
+    chooseDate: "Escolher Data",
+    prevDecade: "Década Anterior",
+    nextDecade: "Próxima Década",
+    prevYear: "Ano Anterior",
+    nextYear: "Próximo Ano",
+    prevMonth: "Mês Anterior",
+    nextMonth: "Próximo Mês",
+    prevHour: "Hora Anterior",
+    nextHour: "Próxima Hora",
+    prevMinute: "Minuto Anterior",
+    nextMinute: "Próximo Minuto",
+    prevSecond: "Segundo Anterior",
+    nextSecond: "Próximo Segundo",
+    am: "AM",
+    pm: "PM",
+    today: "Hoje",
+    now: "Agora",
+    weekHeader: "Sem",
+    firstDayOfWeek: 0,
+    showMonthAfterYear: !1,
+    dateFormat: "dd/MM/yy",
+    weak: "Fraco",
+    medium: "Médio",
+    strong: "Forte",
+    passwordPrompt: "Digite uma senha",
+    emptyFilterMessage: "Nenhum resultado encontrado",
+    searchMessage: "Existem {0} resultados disponíveis",
+    selectionMessage: "{0} itens selecionados",
+    emptySelectionMessage: "Nenhum item selecionado",
+    emptySearchMessage: "Nenhum resultado encontrado",
+    emptyMessage: "Nenhuma opção disponível",
+    aria: {
+      trueLabel: "Verdadeiro",
+      falseLabel: "Falso",
+      nullLabel: "Não Selecionado",
+      star: "1 estrela",
+      stars: "{star} estrelas",
+      selectAll: "Todos os itens selecionados",
+      unselectAll: "Todos os itens desmarcados",
+      close: "Fechar",
+      previous: "Anterior",
+      next: "Próximo",
+      navigation: "Navegação",
+      scrollTop: "Rolar para o Topo",
+      moveTop: "Mover para o Topo",
+      moveUp: "Mover para Cima",
+      moveDown: "Mover para Baixo",
+      moveBottom: "Mover para o Final",
+      moveToTarget: "Mover para o Destino",
+      moveToSource: "Mover para a Origem",
+      moveAllToTarget: "Mover Todos para o Destino",
+      moveAllToSource: "Mover Todos para a Origem",
+      pageLabel: "Página {page}",
+      firstPageLabel: "Primeira Página",
+      lastPageLabel: "Última Página",
+      nextPageLabel: "Próxima Página",
+      previousPageLabel: "Página Anterior",
+      rowsPerPageLabel: "Linhas por página",
+      jumpToPageDropdownLabel: "Ir para a Página",
+      jumpToPageInputLabel: "Ir para a Página",
+      selectRow: "Linha Selecionada",
+      unselectRow: "Linha Desmarcada",
+      expandRow: "Expandir Linha",
+      collapseRow: "Recolher Linha",
+      showFilterMenu: "Mostrar Menu de Filtro",
+      hideFilterMenu: "Esconder Menu de Filtro",
+      filterOperator: "Operador de Filtro",
+      filterConstraint: "Restrição de Filtro",
+      editRow: "Editar Linha",
+      saveEdit: "Salvar Edição",
+      cancelEdit: "Cancelar Edição",
+      listView: "Visualização de Lista",
+      gridView: "Visualização de Grade",
+      slide: "Deslizar",
+      slideNumber: "Slide {slideNumber}",
+      zoomImage: "Ampliar Imagem",
+      zoomIn: "Ampliar",
+      zoomOut: "Reduzir",
+      rotateRight: "Rotacionar para a Direita",
+      rotateLeft: "Rotacionar para a Esquerda"
+    }
+  };
+}
+function p(e, a = !0) {
+  return e ? a ? e.replace(/(\d{3})(\d{3})(\d{3})(\d{2})/, "***.$2.$3-**") : e.replace(/(\d{3})(\d{3})(\d{3})(\d{2})/, "$1.$2.$3-$4") : "";
+}
+function f(e, a = !1) {
+  return e ? a ? e.replace(/(\d{2})(\d{3})(\d{3})(\d{4})(\d{2})/, "**.$2.$3/$4-**") : e.replace(/(\d{2})(\d{3})(\d{3})(\d{4})(\d{2})/, "$1.$2.$3/$4-$5") : "";
+}
+function h(e) {
+  return e ? e.replace(/(\d{3})(\d{5})(\d{2})(\d{1})/, "$1.$2.$3-$4") : "";
+}
+function M(e) {
+  return e ? e.replace(/(\d{5})(\d{3})/, "$1-$2") : "";
+}
+function $(e) {
+  return e ? e.length === 10 ? e.replace(/(\d{2})(\d{4})(\d{4})/, "($1) $2-$3") : e.length === 11 ? e.replace(/(\d{2})(\d{5})(\d{4})/, "($1) $2-$3") : e : "";
+}
+function S(e) {
+  return new Intl.NumberFormat("pt-BR", {
+    style: "currency",
+    currency: "BRL"
+  }).format(e);
+}
+const c = ["da", "de", "do", "das", "dos", "e"];
+function i(e) {
+  return e.charAt(0).toUpperCase() + e.slice(1).toLowerCase();
+}
+function D(e) {
+  if (!e) return "";
+  const a = e.split(" ");
+  return a.length >= 2 ? `${i(a[0])} ${i(a[a.length - 1])}` : i(a[0]);
+}
+function A(e) {
+  return e ? e.split(" ").map(
+    (t) => c.includes(t.toLowerCase()) ? t.toLowerCase() : i(t)
+  ).join(" ") : "";
+}
+function P(e) {
+  if (!e) return "";
+  const a = new Date(e), t = String(a.getDate()).padStart(2, "0"), r = String(a.getMonth() + 1).padStart(2, "0"), o = a.getFullYear();
+  return `${t}/${r}/${o}`;
+}
+function v(e) {
+  return (/* @__PURE__ */ new Date(e + "T00:00:00")).toLocaleDateString("pt-BR");
+}
+function R(e) {
+  return (/* @__PURE__ */ new Date(e + "Z")).toLocaleString("pt-BR");
+}
+function b(e) {
+  const a = /* @__PURE__ */ new Date(e + "Z"), t = String(a.getDate()).padStart(2, "0"), r = String(a.getMonth() + 1).padStart(2, "0");
+  return `${t}/${r}`;
+}
+function T(e) {
+  if (!e) return "";
+  const a = e.toString(), t = a.length === 7 ? "0" + a.substring(0, 1) : a.substring(0, 2), r = a.length === 7 ? a.substring(1, 3) : a.substring(2, 4), o = a.substring(a.length - 4);
+  return `${t}/${r}/${o}`;
+}
+function F(e) {
+  if (!e) return "";
+  if (e.includes("/")) {
+    const a = e.split("/");
+    return `${a[2]}-${a[1]}-${a[0]}`;
+  }
+  if (e.includes("-")) {
+    const a = e.split("-");
+    return `${a[2]}/${a[1]}/${a[0]}`;
+  }
+  return e;
+}
+function N(e) {
+  const [a, t, r] = e.split("/");
+  return `${r}/${t}/${a}`;
+}
+function C(e) {
+  if (!e) return "";
+  if (e.includes("/")) {
+    const a = e.split("/");
+    return `${a[1]}-${a[0]}`;
+  }
+  if (e.includes("-")) {
+    const a = e.split("-");
+    return `${a[1]}/${a[0]}`;
+  }
+  return e;
+}
+function w(e) {
+  if (!e) return "";
+  const a = e.split("-");
+  return a.length === 3 ? `${a[1]}/${a[0]}` : a.length === 2 ? `${a[0]}/${a[1]}` : "";
+}
+function L(e) {
+  if (!e) return "";
+  const a = e.toString(), t = a.length === 7 ? "0" + a[0] : a.substring(0, 2), r = a.length === 7 ? a.substring(1, 3) : a.substring(2, 4), o = a.slice(-4);
+  return `${t}/${r}/${o}`;
+}
+function x(e) {
+  const a = ["Bytes", "KB", "MB", "GB", "TB"];
+  if (e === 0) return "0 Byte";
+  const t = Math.floor(Math.log(e) / Math.log(1024));
+  return Math.round(e / Math.pow(1024, t)) + " " + a[t];
+}
+function B(e) {
+  if (e = e.replace(/[^\d]+/g, ""), e.length !== 11 || /^(\d)\1+$/.test(e)) return !1;
+  let a = 0;
+  for (let r = 0; r < 9; r++) a += parseInt(e.charAt(r)) * (10 - r);
+  let t = a * 10 % 11;
+  if ((t === 10 || t === 11) && (t = 0), t !== parseInt(e.charAt(9))) return !1;
+  a = 0;
+  for (let r = 0; r < 10; r++) a += parseInt(e.charAt(r)) * (11 - r);
+  return t = a * 10 % 11, (t === 10 || t === 11) && (t = 0), t === parseInt(e.charAt(10));
+}
+function k(e) {
+  if (e = e.replace(/[^\d]+/g, ""), e.length !== 14 || /^(\d)\1+$/.test(e)) return !1;
+  const a = (m, s) => {
+    let l = 0;
+    for (let n = 0; n < s.length; n++)
+      l += parseInt(m[n]) * s[n];
+    const u = l % 11;
+    return u < 2 ? 0 : 11 - u;
+  }, t = e.slice(0, 12), r = a(t, [5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2]), o = a(t + r, [6, 5, 4, 3, 2, 9, 8, 7, 6, 5, 4, 3, 2]);
+  return e === t + r + "" + o;
+}
+function E(e) {
+  const [a, t, r] = e.split("/").map(Number), o = new Date(r, t - 1, a);
+  return o.getFullYear() === r && o.getMonth() + 1 === t && o.getDate() === a;
+}
+function I(e) {
+  const [a, t] = e.split("/").map(Number), r = new Date(t, a - 1, 1);
+  return isNaN(r.getTime()) ? !1 : r.getMonth() + 1 === a && r.getFullYear() === t;
+}
+function y(e) {
+  return e.normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/ç/g, "c").replace(/Ç/g, "C");
+}
+function z(e) {
+  return e ? e.replace(/[^0-9]/g, "") : "";
+}
+function O(e) {
+  if (!e) return e;
+  const a = e.trim(), t = (a.match(/\d/g) || []).length, r = (a.match(/[a-zA-ZÀ-ÿ]/g) || []).length;
+  return t > r ? e.replace(/\s+/g, "").replace(/[.\-/]/g, "") : e;
+}
+const G = {
+  mask: "000.000.000-00"
+}, J = {
+  mask: "00.000.000/0000-00"
+}, H = {
+  mask: [
+    { mask: "000.000.000-00" },
+    { mask: "00.000.000/0000-00" }
+  ],
+  dispatch: (e, a) => a.value.replace(/\D/g, "").length <= 11 ? 0 : 1
+}, Y = {
+  mask: "00000-000"
+}, q = {
+  mask: [
+    { mask: "(00) 0000-0000" },
+    { mask: "(00) 00000-0000" }
+  ],
+  dispatch: (e, a) => a.value.replace(/\D/g, "").length <= 10 ? 0 : 1
+}, Q = {
+  mask: "000.00000.00-0"
+}, V = {
+  mask: Number,
+  scale: 2,
+  thousandsSeparator: ".",
+  padFractionalZeros: !0,
+  normalizeZeros: !0,
+  radix: ",",
+  mapToRadix: ["."],
+  min: 0
+}, Z = {
+  mask: "00/00/0000"
+}, U = {
+  mask: "00/0000"
+};
+export {
+  N as converterParaDataIso,
+  M as formataCep,
+  f as formataCnpj,
+  p as formataCpf,
+  v as formataDataFromDb,
+  R as formataDataHoraFromDb,
+  T as formataDataInt,
+  w as formataDataMesReferencia,
+  P as formataDataRetirandoHora,
+  b as formataDiaMesFromDb,
+  S as formataMoedaReais,
+  h as formataNis,
+  D as formataNome,
+  A as formataNomePessoal,
+  x as formataTamanhoArquivo,
+  $ as formataTelefone,
+  L as formatarDataExtrato,
+  d as getUfs,
+  E as isValidDate,
+  I as isValidDateMesAno,
+  g as localePtBr,
+  Y as maskCep,
+  J as maskCnpj,
+  G as maskCpf,
+  H as maskCpfCnpj,
+  Z as maskData,
+  U as maskMesAno,
+  V as maskMoeda,
+  Q as maskNis,
+  q as maskTelefone,
+  F as mudaFormatoDataSep,
+  C as mudaFormatoMesAno,
+  y as removeAcentos,
+  z as removeMascara,
+  O as removerPontuacao,
+  k as validarCNPJ,
+  B as validarCPF
+};

package/dist/constants/index.d.ts

@@ -0,0 +1,4 @@
+export { getUfs } from './ufs';
+export type { UF } from './ufs';
+export { localePtBr } from './locale';
+export type { LocalePtBr } from './locale';

package/dist/constants/locale.d.ts

@@ -0,0 +1,73 @@
+export interface LocalePtBr {
+    startsWith: string;
+    contains: string;
+    notContains: string;
+    endsWith: string;
+    equals: string;
+    notEquals: string;
+    noFilter: string;
+    filter: string;
+    lt: string;
+    lte: string;
+    gt: string;
+    gte: string;
+    dateIs: string;
+    dateIsNot: string;
+    dateBefore: string;
+    dateAfter: string;
+    custom: string;
+    clear: string;
+    apply: string;
+    matchAll: string;
+    matchAny: string;
+    addRule: string;
+    removeRule: string;
+    accept: string;
+    reject: string;
+    choose: string;
+    upload: string;
+    cancel: string;
+    completed: string;
+    pending: string;
+    fileSizeTypes: string[];
+    dayNames: string[];
+    dayNamesShort: string[];
+    dayNamesMin: string[];
+    monthNames: string[];
+    monthNamesShort: string[];
+    chooseYear: string;
+    chooseMonth: string;
+    chooseDate: string;
+    prevDecade: string;
+    nextDecade: string;
+    prevYear: string;
+    nextYear: string;
+    prevMonth: string;
+    nextMonth: string;
+    prevHour: string;
+    nextHour: string;
+    prevMinute: string;
+    nextMinute: string;
+    prevSecond: string;
+    nextSecond: string;
+    am: string;
+    pm: string;
+    today: string;
+    now: string;
+    weekHeader: string;
+    firstDayOfWeek: number;
+    showMonthAfterYear: boolean;
+    dateFormat: string;
+    weak: string;
+    medium: string;
+    strong: string;
+    passwordPrompt: string;
+    emptyFilterMessage: string;
+    searchMessage: string;
+    selectionMessage: string;
+    emptySelectionMessage: string;
+    emptySearchMessage: string;
+    emptyMessage: string;
+    aria: Record<string, string>;
+}
+export declare function localePtBr(): LocalePtBr;

package/dist/constants/ufs.d.ts

@@ -0,0 +1,5 @@
+export interface UF {
+    sigla: string;
+    nome: string;
+}
+export declare function getUfs(): UF[];

package/dist/format/arquivo.d.ts

@@ -0,0 +1 @@
+export declare function formataTamanhoArquivo(bytes: number): string;

package/dist/format/cep.d.ts

@@ -0,0 +1 @@
+export declare function formataCep(cep: string): string;

package/dist/format/cnpj.d.ts

@@ -0,0 +1 @@
+export declare function formataCnpj(cnpj: string, mascarar?: boolean): string;

package/dist/format/cpf.d.ts

@@ -0,0 +1 @@
+export declare function formataCpf(cpf: string, mascarar?: boolean): string;

package/dist/format/data.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Formata data removendo hora.
+ * Entrada: "2025-05-21T17:57:10.058390" ou "2025-05-21"
+ * Saída: "21/05/2025"
+ */
+export declare function formataDataRetirandoHora(datastr: string): string;
+/**
+ * Formata data vinda do banco (sem hora).
+ * Entrada: "2025-05-21"
+ * Saída: "21/05/2025"
+ */
+export declare function formataDataFromDb(datastr: string): string;
+/**
+ * Formata data e hora vinda do banco.
+ */
+export declare function formataDataHoraFromDb(datastr: string): string;
+/**
+ * Formata dia/mês vindo do banco.
+ * Saída: "21/05"
+ */
+export declare function formataDiaMesFromDb(datastr: string): string;
+/**
+ * Formata data de inteiro para string.
+ * Entrada: 7022025 -> "07/02/2025"
+ * Entrada: 10032025 -> "10/03/2025"
+ */
+export declare function formataDataInt(datastr: number): string;
+/**
+ * Alterna formato de data entre DD/MM/YYYY e YYYY-MM-DD.
+ */
+export declare function mudaFormatoDataSep(datastr: string): string;
+/**
+ * Converte data DD/MM/YYYY para formato ISO YYYY/MM/DD.
+ */
+export declare function converterParaDataIso(dataString: string): string;
+/**
+ * Alterna formato mês/ano entre MM/YYYY e YYYY-MM.
+ */
+export declare function mudaFormatoMesAno(datastr: string): string;
+/**
+ * Recebe data "yyyy-mm-dd" e retorna mês de referência "mm/yyyy".
+ */
+export declare function formataDataMesReferencia(data: string): string;
+/**
+ * Formata data de extrato (inteiro para string).
+ * Entrada: 7022025 -> "07/02/2025"
+ */
+export declare function formatarDataExtrato(data: number): string;

package/dist/format/index.d.ts

@@ -0,0 +1,9 @@
+export { formataCpf } from './cpf';
+export { formataCnpj } from './cnpj';
+export { formataNis } from './nis';
+export { formataCep } from './cep';
+export { formataTelefone } from './telefone';
+export { formataMoedaReais } from './moeda';
+export { formataNome, formataNomePessoal } from './nome';
+export { formataDataRetirandoHora, formataDataFromDb, formataDataHoraFromDb, formataDiaMesFromDb, formataDataInt, mudaFormatoDataSep, converterParaDataIso, mudaFormatoMesAno, formataDataMesReferencia, formatarDataExtrato, } from './data';
+export { formataTamanhoArquivo } from './arquivo';

package/dist/format/moeda.d.ts

@@ -0,0 +1 @@
+export declare function formataMoedaReais(valor: number): string;

package/dist/format/nis.d.ts

@@ -0,0 +1 @@
+export declare function formataNis(nis: string): string;

package/dist/format/nome.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Formata nome exibindo apenas primeiro e último nome.
+ * Ex: "ALEX FABIANO DE ARAÚJO FURTUNATO" -> "Alex Furtunato"
+ */
+export declare function formataNome(nome: string): string;
+/**
+ * Formata nome completo respeitando preposições.
+ * Ex: "ALEX FABIANO DE ARAÚJO FURTUNATO" -> "Alex Fabiano de Araújo Furtunato"
+ */
+export declare function formataNomePessoal(nome: string): string;

package/dist/format/telefone.d.ts

@@ -0,0 +1 @@
+export declare function formataTelefone(telefone: string): string;

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { getUfs, localePtBr } from './constants/index';
+export type { UF, LocalePtBr } from './constants/index';
+export { formataCpf, formataCnpj, formataNis, formataCep, formataTelefone, formataMoedaReais, formataNome, formataNomePessoal, formataDataRetirandoHora, formataDataFromDb, formataDataHoraFromDb, formataDiaMesFromDb, formataDataInt, mudaFormatoDataSep, converterParaDataIso, mudaFormatoMesAno, formataDataMesReferencia, formatarDataExtrato, formataTamanhoArquivo, } from './format/index';
+export { validarCPF, validarCNPJ, isValidDate, isValidDateMesAno, } from './validate/index';
+export { removeAcentos, removeMascara, removerPontuacao, } from './normalize/index';
+export { maskCpf, maskCnpj, maskCpfCnpj, maskCep, maskTelefone, maskNis, maskMoeda, maskData, maskMesAno, } from './mask/index';
+export type { MaskConfig } from './mask/index';

package/dist/mask/index.d.ts

@@ -0,0 +1,2 @@
+export { maskCpf, maskCnpj, maskCpfCnpj, maskCep, maskTelefone, maskNis, maskMoeda, maskData, maskMesAno, } from './masks';
+export type { MaskConfig } from './masks';

package/dist/mask/masks.d.ts

@@ -0,0 +1,13 @@
+export interface MaskConfig {
+    mask: string | NumberConstructor;
+    [key: string]: unknown;
+}
+export declare const maskCpf: MaskConfig;
+export declare const maskCnpj: MaskConfig;
+export declare const maskCpfCnpj: MaskConfig;
+export declare const maskCep: MaskConfig;
+export declare const maskTelefone: MaskConfig;
+export declare const maskNis: MaskConfig;
+export declare const maskMoeda: MaskConfig;
+export declare const maskData: MaskConfig;
+export declare const maskMesAno: MaskConfig;

package/dist/normalize/documento.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Remove máscara de telefone, CPF e CNPJ, deixando apenas dígitos.
+ */
+export declare function removeMascara(valor: string): string;
+/**
+ * Remove pontuação de documentos inteligentemente:
+ * - Se o valor tem mais dígitos que letras (documento), remove pontuação.
+ * - Se tem mais letras (nome), mantém como está.
+ */
+export declare function removerPontuacao(valor: string): string;

package/dist/normalize/index.d.ts

@@ -0,0 +1,2 @@
+export { removeAcentos } from './texto';
+export { removeMascara, removerPontuacao } from './documento';

package/dist/normalize/texto.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Remove acentos de um texto.
+ * Ex: "São Paulo" -> "Sao Paulo"
+ */
+export declare function removeAcentos(texto: string): string;

package/dist/validate/cnpj.d.ts

@@ -0,0 +1 @@
+export declare function validarCNPJ(cnpj: string): boolean;

package/dist/validate/cpf.d.ts

@@ -0,0 +1 @@
+export declare function validarCPF(cpf: string): boolean;

package/dist/validate/data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Valida data no formato DD/MM/YYYY.
+ */
+export declare function isValidDate(dateString: string): boolean;
+/**
+ * Valida mês/ano no formato MM/YYYY.
+ */
+export declare function isValidDateMesAno(dateString: string): boolean;

package/dist/validate/index.d.ts

@@ -0,0 +1,3 @@
+export { validarCPF } from './cpf';
+export { validarCNPJ } from './cnpj';
+export { isValidDate, isValidDateMesAno } from './data';

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@kodatec/brasil-utils",
+  "version": "1.0.0",
+  "type": "module",
+  "author": {
+    "name": "Neemias Renan"
+  },
+  "description": "Utilitários para dados brasileiros: formatação, validação e máscaras de CPF, CNPJ, CEP, telefone, moeda e mais.",
+  "main": "./dist/brasil-utils.cjs",
+  "module": "./dist/brasil-utils.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/brasil-utils.js",
+      "require": "./dist/brasil-utils.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "preview": "vite preview",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "brasil",
+    "brazil",
+    "cpf",
+    "cnpj",
+    "cep",
+    "telefone",
+    "moeda",
+    "brl",
+    "validacao",
+    "formatacao",
+    "mascara",
+    "imask",
+    "uf",
+    "utils"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "vite": "^7.2.4",
+    "vite-plugin-dts": "^4.5.0"
+  }
+}