Skip to content

v3.0.0 [Jul 31, 2026]

Latest

Choose a tag to compare

@theuves theuves released this 31 Jul 14:13
· 31 commits to master since this release

Changelog

Alterações incompatíveis

  • A versão mínima do Node.js agora é 22.20.0.
  • A importação via CommonJS agora retorna diretamente a função principal: const extenso = require('extenso').
  • Opções inválidas ou desconhecidas agora geram erros explícitos em vez de serem silenciosamente ignoradas.

Novos Recursos

  • Adicionado suporte a números ordinais (#208).
  • Adicionado suporte a números abreviados por meio do modo abbreviated (#210).
  • Adicionado suporte a moedas personalizadas (#209).
  • Adicionada detecção automática de moedas por código ou símbolo (#111).
  • Adicionada a opção gender para flexão de gênero, incluindo grupos de milhares (#207).
  • Adicionada a opção removeAccents para retornar o texto sem acentos (#212).
  • Adicionado suporte completo a valores do tipo bigint.
  • Adicionado suporte a números em notação científica.
  • Adicionadas builds para CommonJS, ES Modules e UMD.
  • Adicionadas declarações TypeScript geradas diretamente a partir do código-fonte.
  • Exportados os tipos públicos utilizados na configuração da biblioteca.
  • Adicionado suporte às moedas BRL, EUR, USD, AOA, CVE, MZN, MOP, STN e XOF.
  • Adicionado suporte aos modos number, currency, digit e abbreviated.

Correções

  • Corrigido o tratamento de zero negativo, incluindo -0 e -0.00.
  • Corrigida a normalização de casas decimais compostas somente por zeros.
  • Corrigida a preservação de zeros no modo digit.
  • Corrigida a interpretação de casas decimais independentemente do idioma configurado.
  • Corrigida a flexão de gênero em valores monetários.
  • Corrigido o singular da subunidade da Pataca macaense.
  • Corrigidos os limites máximos das escalas curta e longa.
  • Corrigido o limite de números ordinais na escala longa.
  • Corrigida a detecção de moedas em diferentes posições do valor informado.
  • Corrigida a distribuição do pacote para consumidores CommonJS, ESM e TypeScript.
  • Reforçada a validação de entradas e de todas as opções públicas.

Qualidade e Segurança

  • Reorganizada e simplificada a estrutura interna do código-fonte.
  • Atualizadas as ferramentas de testes, cobertura, lint e compilação.
  • Adicionados testes de consumo real do pacote em CommonJS, ESM e TypeScript.
  • Adicionados 113 testes automatizados.
  • Alcançada cobertura de 100% em linhas, funções, instruções e branches.
  • Removidas dependências de execução.
  • Auditoria de segurança concluída sem vulnerabilidades conhecidas.
  • Atualizada a integração contínua para Node.js 22 e 24.
  • Atualizada e sincronizada a documentação em português e inglês.

Agradecimentos

Agradecemos a todos que contribuíram para este projeto.

Esta versão representa uma modernização completa da biblioteca, com uma API mais segura, novos recursos, maior compatibilidade entre ambientes e cobertura integral de testes.


Changelog completo: 2.1.0…v3.0.0