Repository navigation
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
genderpara flexão de gênero, incluindo grupos de milhares (#207). - Adicionada a opção
removeAccentspara 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,digiteabbreviated.
Correções
- Corrigido o tratamento de zero negativo, incluindo
-0e-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